unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (4.4BSD-Lite2)
Page:
Section:
Apropos / Subsearch:
optional field

TPUT(1)                      BSD Reference Manual                      TPUT(1)

NAME
     tput - terminal capability interface

SYNOPSIS
     tput [-T term] attribute

DESCRIPTION
     Tput makes terminal-dependent information available to users or shell ap-
     plications.  The options are as follows:

     -T      The terminal name as specified in the termcap database, for exam-
             ple, ``vt100'' or ``xterm''.  If not specified, tput retrieves
             the ``TERM'' variable from the environment.

     Tput outputs a string if the attribute is of type string; a number if it
     is of type integer.  Otherwise, tput exits 0 if the terminal has the ca-
     pability and 1 if it does not, without further action.

     If the attribute is of type string, and takes arguments (e.g. cursor
     movement, the termcap ``cm'' sequence) the arguments are taken from the
     command line immediately following the attribute.

     The following special attributes are available:

     clear         Clear the screen (the termcap ``cl'' sequence).

     init          Initialize the terminal (the termcap ``is'' sequence).

     longname      Print the descriptive name of the user's terminal type.

     reset         Reset the terminal (the termcap ``rs'' sequence).

DIAGNOSTICS
     The exit value of tput is based on the last attribute specified.  If the
     attribute is of type string or of type integer, tput exits 0 if the at-
     tribute is defined for this terminal type and 1 if it is not.  If the at-
     tribute is of type boolean, tput exits 0 if the terminal has this at-
     tribute, and 1 if it does not.  Tput exits 2 if any error occurred.

SEE ALSO
     termcap(3),  termcap(5)

BUGS
     Tput can't really distinguish between different types of attributes.

HISTORY
     The tput command appears in 4.4BSD.

4.4BSD                          March 19, 1994                               1