


      TPUT(1)                     (UNIX 5.2)                    TPUT(1)



      NAME
           tput - query terminfo database

      SYNTAX
           tput [ -Ttype ] capname

      DESCRIPTION
           Tput uses the terminfo(4) database to make terminal-
           dependent capabilities and information available to the
           shell.  Tput outputs a string if the attribute (capability
           name) is of type string, or an integer if the attribute is
           of type integer.  If the attribute is of type boolean, tput
           simply sets the exit code (0 for TRUE, 1 for FALSE), and
           does no output.

           -Ttype     indicates the type of terminal.  Normally this
                      flag is unnecessary, as the default is taken from
                      the environment variable $TERM.
           Capname    indicates the attribute from the terminfo
                      database.  See terminfo(4).
      EXAMPLES
           tput clear        Echo clear-screen sequence for the current
                             terminal.
           tput cols         Print the number of columns for the
                             current terminal.
           tput -T450 cols   Print the number of columns for the 450
                             terminal.
           bold=`tput smso`  Set shell variable "bold" to stand-out
                             mode sequence for current terminal.  This
                             might be followed by a prompt:
                             echo "${bold}Please type in your name: \c"
           tput hc           Set exit code to indicate if current
                             terminal is a hardcopy terminal.
      FILES
           /etc/term/?/*            Terminal descriptor files
           /usr/include/term.h      Definition files
           /usr/include/curses.h
      DIAGNOSTICS
           Tput prints error messages and returns the following error
           codes on error:
           -1             Usage error.
           -2             Bad terminal type.
           -3             Bad capname.

           In addition, if a capname is requested for a terminal that
           has no value for that capname (e.g., tput -T450 lines), -1
           is printed.
      SEE ALSO
           stty(1), terminfo(4).






      Page 1                                          (73 A2 02MT REV1)



