infocmp man page on Solaris

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
Solaris logo
[printable version]

infocmp(1M)		System Administration Commands		   infocmp(1M)

NAME
       infocmp - compare or print out terminfo descriptions

SYNOPSIS
       /usr/bin/infocmp	 [-d] [-c] [-n] [-I] [-L] [-C] [-r] [-u] [-s | d | i |
       l | c]	[-v]  [-V]  [-1]  [-w width]  [-A   directory]	[-B directory]
       [termname...]

DESCRIPTION
       infocmp	compares  a binary terminfo entry with other terminfo entries,
       rewrites a terminfo description to take advantage of the use=  terminfo
       field, or prints out a terminfo description from the binary file ( term
       ) in a variety of formats.  It  displays	 boolean  fields  first,  then
       numeric fields, followed by the string fields. If no options are speci‐
       fied and zero, or one termname is specified, the -I option is  assumed.
       If more than one termname is specified, the -d option is assumed.

OPTIONS
       The  -d , -c , and -n options can be used for comparisons. infocmp com‐
       pares the terminfo description of the first terminal termname with each
       of  the	descriptions  given  by	 the  entries for the other terminal's
       termname. If a capability is defined for only one of the terminals, the
       value returned will depend on the type of the capability: F for boolean
       variables, −1 for integer variables, and NULL for string variables.

       -d	Produce a list of each capability that	is  different  between
		two  entries.  This  option  is	 useful to show the difference
		between two entries, created by different people, for the same
		or similar terminals.

       -c	Produce	 a  list of each capability that is common between two
		entries. Capabilities that  are	 not  set  are	ignored.  This
		option can be used as a quick check to see if the -u option is
		worth using.

       -n	Produce a list of each capability that is in neither entry. If
		no  termname  is  given, the environment variable TERM will be
		used for both of the termnames. This can be used  as  a	 quick
		check to see if anything was left out of a description.

       The  -I	,  -L  , and -C options will produce a source listing for each
       terminal named.

       -I	Use the terminfo names.

       -L	Use the long C variable name listed in < term.h >.

       -C	Use the termcap names. The source produced by  the  -C	option
		may  be	 used  directly as a termcap entry, but not all of the
		parameterized strings may be changed to	 the  termcap  format.
		infocmp	 will  attempt	to  convert  most of the parameterized
		information, but anything not converted will be plainly marked
		in  the	 output	 and  commented out. These should be edited by
		hand.

       -r	When using -C , put out all capabilities in termcap form.

       If no termname is given, the environment variable TERM will be used for
       the terminal name.

       All  padding  information  for  strings	will be collected together and
       placed at the beginning of the string where termcap expects it.	Manda‐
       tory  padding  (padding	information  with  a trailing '/') will become
       optional.

       All termcap variables no longer supported by terminfo , but are	deriv‐
       able  from  other  terminfo variables, will be displayed.  Not all ter‐
       minfo capabilities will be translated; only those variables which  were
       part  of	 termcap  will normally be displayed. Specifying the -r option
       will take off this restriction, allowing all capabilities  to  be  dis‐
       played in termcap form.

       Note that because padding is collected to the beginning of the capabil‐
       ity, not all capabilities are displayed. Mandatory padding is not  sup‐
       ported.	Because	 termcap strings are not as flexible, it is not always
       possible to convert a terminfo string  capability  into	an  equivalent
       termcap	format.	 A subsequent conversion of the termcap file back into
       terminfo format will not necessarily reproduce  the  original  terminfo
       source.

       Some  common  terminfo  parameter sequences, their termcap equivalents,
       and some terminal types which commonly have such sequences, are:

       terminfo	    termcap	 Representative Terminals
       %p1%c	 %.   adm
       %p1%d	 %d   hp, ANSI standard, vt100
       %p1%'x'%+%c    %+x  concept
       %i   %i	 ANSI standard, vt100
       %p1%?%'x'%>%t%p1%'y'%+%; %>xy concept
       %p2 is printed before %p1     %r	  hp

       -u	Produce a terminfo source description of  the  first  terminal
		termname  which	 is  relative  to  the sum of the descriptions
		given by the entries for the other  terminals'	termnames.  It
		does  this  by	analyzing  the	differences  between the first
		termname and the other termnames and producing	a  description
		with  use=  fields for the other terminals. In this manner, it
		is possible to retrofit generic	 terminfo entries into a  ter‐
		minal's	 description.  Or, if two similar terminals exist, but
		were coded at different times, or by different people so  that
		each  description  is  a  full description, using infocmp will
		show what can be done to change one description to be relative
		to the other.

       A capability is displayed with an at-sign (@) if it no longer exists in
       the first termname, but one of the other termname  entries  contains  a
       value  for  it.	A  capability's value is displayed if the value in the
       first termname is not found in any of the other termname entries, or if
       the  first of the other termname entries that has this capability gives
       a different value for that capability.

       The order of the other termname entries is significant. Since the  ter‐
       minfo compiler tic does a left-to-right scan of the capabilities, spec‐
       ifying two use= entries that contain differing  entries	for  the  same
       capabilities  will produce different results, depending on the order in
       which the entries are given. infocmp will flag any such inconsistencies
       between the other termname entries as they are found.

       Alternatively,  specifying  a  capability  after a use= entry that con‐
       tains, it will cause the second	specification  to  be  ignored.	 Using
       infocmp	to  recreate  a description can be a useful check to make sure
       that everything was specified correctly in the original source descrip‐
       tion.

       Another	error  that  does not cause incorrect compiled files, but will
       slow down the compilation time, is specifying superfluous  use= fields.
       infocmp will flag any superfluous  use= fields.

       -s	       Sorts  the  fields  within  each	 type according to the
		       argument below:

		       d	Leave fields in the order that they are stored
				in the terminfo database.

		       i	Sort by terminfo name.

		       l	Sort by the long C variable name.

		       c	Sort by the termcap name.

		       If  the	-s  option is not given, the fields are sorted
		       alphabetically by the terminfo name within  each	 type,
		       except  in  the case of the -C or the -L options, which
		       cause the sorting to be done by the termcap name or the
		       long C variable name, respectively.

       -v	       Print  out tracing information on standard error as the
		       program runs.

       -V	       Print out the version of the program in use on standard
		       error and exit.

       −1	       Print  the  fields one to a line. Otherwise, the fields
		       are printed several to a line to a maximum width of  60
		       characters.

       -wwidth	       Changes the output to width characters.

       The  location of the compiled terminfo database is taken from the envi‐
       ronment variable TERMINFO. If the variable is not defined, or the  ter‐
       minal is not found in that location, the system terminfo database, usu‐
       ally in /usr/share/lib/terminfo, is used.  The options -A and -B may be
       used to override this location.

       -A directory    Set TERMINFO for the first termname.

       -B directory    Set  TERMINFO for the other termnames. With this, it is
		       possible to compare descriptions for  a	terminal  with
		       the  same name located in two different databases. This
		       is useful for comparing descriptions for the same  ter‐
		       minal created by different people.

FILES
       /usr/share/lib/terminfo/?/*     Compiled terminal description database.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Availability		     │SUNWcsu			   │
       └─────────────────────────────┴─────────────────────────────┘

SEE ALSO
       captoinfo(1M), tic(1M), curses(3CURSES), terminfo(4), attributes(5)

SunOS 5.10			  5 Jul 1990			   infocmp(1M)
[top]

List of man pages available for Solaris

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net