NAME

tput − query terminfo database

SYNOPSIS

tput [−T type] 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 produces 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 −Thp2623 cols
Print the number of columns for the hp2623 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. 

DIAGNOSTICS

tput prints error messages and returns the following error codes on error:

−1 Usage error. 

−2 Bad terminal type. 

−3 Bad capability name. 

In addition, if a capability name is requested for a terminal that has no value for that capability name (such as tput −Thp2623 vt), −1 is printed. 

FILES

/usr/lib/terminfo/?/* terminfo data base

/usr/include/curses.h definition files

/usr/include/term.h

SEE ALSO

stty(1), terminfo(4). 

STANDARDS CONFORMANCE

tput: SVID2

Hewlett-Packard Company  —  HP-UX Release 8.05: June 1991