term(4) — sys5 — Apollo Domain/IX SR9.5



TERM(4)                  DOMAIN/IX SYS5                   TERM(4)



NAME
     term - format of compiled term file.

DESCRIPTION
     Compiled terminfo descriptions are placed in the directory
     /usr/lib/terminfo.  In order to avoid a linear search of a
     huge DOMAIN/IX system directory, a two-level scheme is used:
     /usr/lib/terminfo/c/name where name is the name of the ter-
     minal, and c is the first character of name.  Thus, act4 can
     be found in the file /usr/lib/terminfo/a/act4.  Synonyms for
     the same terminal are implemented by multiple links to the
     same compiled file.

     The format has been chosen so that it will be the same on
     all hardware.  An 8 bit (or larger) byte is assumed, but no
     assumptions about byte ordering or sign extension are made.

     The compiled file is created with the compile program, and
     read by the routine setupterm.  Both of these pieces of
     software are part of curses(3X).  The file is divided into
     six parts: the header, terminal names, Boolean flags,
     numbers, strings, and string table.

     The header section begins the file.  This section contains
     six short integers in the format described below.  These
     integers are (1) the magic number (octal 0432); (2) the
     size, in bytes, of the names section; (3) the number of
     bytes in the Boolean section; (4) the number of short
     integers in the numbers section; (5) the number of offsets
     (short integers) in the strings section; (6) the size, in
     bytes, of the string table.

     Short integers are stored in two 8-bit bytes.  The first
     byte contains the least significant 8 bits of the value, and
     the second byte contains the most significant 8 bits.
     (Thus, the value represented is 256*second+first.) The value
     -1 is represented by 0377, 0377, other negative value are
     illegal.  The -1 generally means that a capability is miss-
     ing from this terminal.  Machines where this does not
     correspond to the hardware read the integers as two bytes
     and compute the result.

     The terminal names section comes next.  It contains the
     first line of the terminfo description, listing the various
     names for the terminal, separated by the pipe (|) character.
     The section is terminated with an ASCII NUL character.







Printed 12/4/86                                            TERM-1



TERM(4)                  DOMAIN/IX SYS5                   TERM(4)



     The Boolean flags have one byte for each flag.  This byte is
     either 0 or 1 as the flag is present or absent.  The capa-
     bilities are in the same order as the file <term.h>.

     Between the Boolean section and the number section, a null
     byte will be inserted, if necessary, to ensure that the
     number section begins on an even byte.  All short integers
     are aligned on a short word boundary.

     The numbers section is similar to the flags section.  Each
     capability takes up two bytes, and is stored as a short
     integer.  If the value represented is -1, the capability is
     taken to be missing.

     The strings section is also similar.  Each capability is
     stored as a short integer, in the format above.  A value of
     -1 means the capability is missing.  Otherwise, the value is
     taken as an offset from the beginning of the string table.
     Special characters in ^X or \c notation are stored in their
     interpreted form, not the printing representation.  Padding
     information $<nn> and parameter information %x are stored
     intact in uninterpreted form.

     The final section is the string table.  It contains all the
     values of string capabilities referenced in the string sec-
     tion.  Each string is null terminated.

     Note that it is possible for setupterm to expect a different
     set of capabilities than are actually present in the file.
     Either the database may have been updated since setupterm
     has been recompiled (resulting in extra unrecognized entries
     in the file) or the program may have been recompiled more
     recently than the database was updated (resulting in missing
     entries).  The routine setupterm must be prepared for both
     possibilities, which is why the numbers and sizes are
     included.  Also, new capabilities must always be added at
     the end of the lists of Boolean, number, and string capabil-
     ities.

NOTES
     Total compiled entries cannot exceed 4096 bytes.  The name
     field cannot exceed 128 bytes.

FILES
     /usr/lib/terminfo/*/*
                    compiled terminal capability data base







TERM-2                                            Printed 12/4/86



TERM(4)                  DOMAIN/IX SYS5                   TERM(4)



RELATED INFORMATION
     curses(3X), terminfo(4)



















































Printed 12/4/86                                            TERM-3

Museum

Related Articles