usr.bin/tput/tput.1

   1 .\"     $NetBSD: tput.1,v 1.12 2003/08/07 11:16:45 agc Exp $
   2 .\"
   3 .\" Copyright (c) 1989, 1990, 1993
   4 .\"     The Regents of the University of California.  All rights reserved.
   5 .\"
   6 .\" Redistribution and use in source and binary forms, with or without
   7 .\" modification, are permitted provided that the following conditions
   8 .\" are met:
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\" 2. Redistributions in binary form must reproduce the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer in the
  13 .\"    documentation and/or other materials provided with the distribution.
  14 .\" 3. Neither the name of the University nor the names of its contributors
  15 .\"    may be used to endorse or promote products derived from this software
  16 .\"    without specific prior written permission.
  17 .\"
  18 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  19 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  20 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  21 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  22 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  23 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  24 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  25 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  26 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  27 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  28 .\" SUCH DAMAGE.
  29 .\"
  30 .\"     @(#)tput.1      8.2 (Berkeley) 3/19/94
  31 .\"
  32 .Dd March 29, 2004
  33 .Dt TPUT 1
  34 .Os
  35 .Sh NAME
  36 .Nm tput ,
  37 .Nm clear
  38 .Nd terminal capability interface
  39 .Sh SYNOPSIS
  40 .Nm
  41 .Op Fl T Ar term
  42 .Ar attribute
  43 .Op Ar attribute-args
  44 .Ar ...
  45 .Sh DESCRIPTION
  46 .Nm
  47 makes terminal-dependent information available to users or shell
  48 applications.
  49 The options are as follows:
  50 .Bl -tag -width Ds
  51 .It Fl T
  52 The terminal name as specified in the
  53 .Xr termcap 5
  54 database, for example,
  55 .Dq vt100
  56 or
  57 .Dq xterm .
  58 If not specified,
  59 .Nm
  60 retrieves the
  61 .Dq Ev TERM
  62 variable from the environment.
  63 .El
  64 .Pp
  65 .Nm
  66 outputs a string if the
  67 .Ar attribute
  68 is of type string; a number if it is of type integer.
  69 Otherwise,
  70 .Nm
  71 exits 0 if the terminal has the capability and 1 if it does not,
  72 without further action.
  73 .Pp
  74 If the
  75 .Ar attribute
  76 is of type string, and takes arguments (e.g. cursor movement,
  77 the termcap
  78 .Dq cm
  79 sequence) the arguments are taken from the command line immediately
  80 following the attribute.
  81 .Pp
  82 The following special attributes are available:
  83 .Bl -tag -width Ar
  84 .It clear
  85 Clear the screen (the
  86 .Xr termcap 5
  87 .Dq cl
  88 sequence).
  89 .It init
  90 Initialize the terminal (the
  91 .Xr termcap 5
  92 .Dq is
  93 sequence).
  94 .It longname
  95 Print the descriptive name of the user's terminal type.
  96 .It reset
  97 Reset the terminal (the
  98 .Xr termcap 5
  99 .Dq rs
 100 sequence).
 101 .El
 102 .Sh EXIT STATUS
 103 The exit status of
 104 .Nm
 105 is based on the last attribute specified.
 106 If the attribute is of type string or of type integer,
 107 .Nm
 108 exits 0 if the attribute is defined for this terminal type and 1
 109 if it is not.
 110 If the attribute is of type boolean,
 111 .Nm
 112 exits 0 if the terminal has this attribute, and 1 if it does not.
 113 .Nm
 114 exits 2 if any error occurred.
 115 .Sh EXAMPLES
 116 .Bl -tag -width "tput cm 6 11 DC 6" -compact
 117 .It Li "tput cl cm 5 10"
 118 clear the screen and goto line 5 column 10
 119 .Pp
 120 .It Li "tput cm 6 11 DC 6"
 121 goto line 6 column 11 and delete 6 characters
 122 .El
 123 .Sh SEE ALSO
 124 .Xr termcap 3 ,
 125 .Xr termcap 5
 126 .Sh HISTORY
 127 The
 128 .Nm
 129 command appears in
 130 .Bx 4.4 .
 131 .Sh BUGS
 132 .Nm
 133 can't really distinguish between different types of attributes.
 134 .Pp
 135 Not all termcap entries contain the reset sequence, so using the init
 136 sequence may be more useful.