Linux Command


tput [-Ttype] longname


The tput utility uses the terminfo database to make the values of ter-
minal-dependent capabilities and information available to the shell
(see sh(1)), to initialize or reset the terminal, or return the long
name of the requested terminal type. The result depends upon the capa-
bility’s type:

tput writes the string to the standard output. No trailing
newline is supplied.

tput writes the decimal value to the standard output, with
a trailing newline.

tput simply sets the exit code (0 for TRUE if the terminal
has the capability, 1 for FALSE if it does not), and writes
nothing to the standard output.

Before using a value returned on the standard output, the application
should test the exit code (e.g., $?, see sh(1)) to be sure it is 0.
(See the EXIT CODES and DIAGNOSTICS sections.) For a complete list of
capabilities and the capname associated with each, see terminfo(5).

-Ttype indicates the type of terminal. Normally this option is unnec-
essary, because the default is taken from the environment vari-
able TERM. If -T is specified, then the shell variables LINES
and COLUMNS will be ignored,and the operating system will not be
queried for the actual screen size.

indicates the capability from the terminfo database. When term-
cap support is compiled in, the termcap name for the capability
is also accepted.

parms If the capability is a string that takes parameters, the argu-
ments parms will be instantiated into the string.

Most parameters are numbers. Only a few terminfo capabilities
require string parameters; tput uses a table to decide which to
pass as strings. Normally tput uses tparm (3X) to perform the
substitution. If no parameters are given for the capability,
tput writes the string without performing the substitution.

-S allows more than one capability per invocation of tput. The
capabilities must be passed to tput from the standard input
instead of from the command line (see example). Only one cap-
name is allowed per line. The -S option changes the meaning of
the 0 and 1 boolean and string exit codes (see the EXIT CODES

Again, tput uses a table and the presence of parameters in its
input to decide whether to use tparm (3X), and how to interpret
the parameters.

-V reports the version of ncurses which was used in this program,
and exits.

init If the terminfo database is present and an entry for the user’s
terminal exists (see -Ttype, above), the following will occur:

(1) if present, the terminal’s initialization strings will be
output as detailed in the terminfo(5) section on Tabs and

(2) any delays (e.g., newline) specified in the entry will be
set in the tty driver,

(3) tabs expansion will be turned on or off according to the
specification in the entry, and

(4) if tabs are not expanded, standard tabs will be set
(every 8 spaces).

If an entry does not contain the information needed for any of
the four above activities, that activity will silently be

reset Instead of putting out initialization strings, the terminal’s
reset strings will be output if present (rs1, rs2, rs3, rf). If
the reset strings are not present, but initialization strings
are, the initialization strings will be output. Otherwise,
reset acts identically to init.

If the terminfo database is present and an entry for the user’s
terminal exists (see -Ttype above), then the long name of the
terminal will be put out. The long name is the last name in the
first line of the terminal’s description in the terminfo
database [see term(5)].

If tput is invoked by a link named reset, this has the same effect as
tput reset. See tset for comparison, which has similar behavior.

Share your experience or ask a question