tput - terminal capability interface
tput [-T term] attribute [attribute-args] ...
tput [-T term] -S
The tput utility makes terminal-dependent information available to users
or shell applications.
The options are as follows:
-T The terminal name as found in the terminfo database;
``vt100'' or ``xterm''. If not specified, tput retrieves the
TERM variable from the environment.
-S The attributes are read from stdin instead of the
tput outputs a string if the attribute is of type string or
a number if
it is of type integer. If the attribute is of type boolean,
tput exits 0
if the terminal has the capability or 1 if it does not.
should be a string defined in either terminfo(5) or termcap(5).
If the attribute is of type string and takes arguments
movement, the terminfo ``cup'' sequence) the arguments are
taken from the
command line immediately following the attribute.
The following special attributes are available:
clear Clear the screen (the terminfo ``clear'' sequence).
init Print the terminfo initialization strings for
longname Print the descriptive name of the user's terminal type.
reset Reset the terminal (using the terminfo reset
tput clear cup 5 10 clear the screen and goto line 5 column
tput cup 6 11 dch 6 goto line 6 column 11 and delete 6
The exit value of tput is based on the last attribute specified. If the
attribute is of type string or of type integer the exit value is as follows:
0 The requested string was written successfully.
2 Usage error.
3 Unknown terminal type.
4 Unknown attribute name.
>4 An error occurred.
If the attribute is of type boolean, tput exits with a value
of 0 if the
terminal has this attribute or 1 if it does not.
The tput utility appeared in 4.4BSD.
tput can't really distinguish between different types of attributes.
OpenBSD 3.6 June 29, 1999
[ Back ]