tic(1M)

tic -- terminfo compiler

Synopsis

tic [-v[n]] [-c] file

Description

The command tic translates a terminfo file from the source format into the compiled format. The results are placed in the directory /usr/share/lib/terminfo. The compiled format is necessary for use with the library routines in Section 3curses manual pages in Section 3curses manual pages.

-vn: specifies that (verbose) output be written to standard error trace information showing tic's progress. The optional integer n is a number from 1 to 10, inclusive, indicating the desired level of detail of information. If n is omitted, the default level is 1. If n is specified and greater than 1, the level of detail is increased.
-c: specifies to check only file for errors. Errors in use= links are not detected.
file: contains one or more terminfo terminal descriptions in source format (see terminfo(4)). Each description in the file describes the capabilities of a particular terminal. When a use=entry-name field is discovered in a terminal entry currently being compiled, tic reads in the binary from /usr/share/lib/terminfo to complete the entry. (Entries created from file will be used first. If the environment variable TERMINFO is set, that directory is searched instead of /usr/share/lib/terminfo.) tic duplicates the capabilities in entry-name for the current entry, with the exception of those capabilities that explicitly are defined in the current entry.

If the environment variable TERMINFO is set, the compiled results are placed there instead of /usr/share/lib/terminfo.

Total compiled entries cannot exceed 4096 bytes. The name field cannot exceed 128 bytes. Terminal names exceeding 14 characters will be truncated to 14 characters and a warning message will be printed.

International functions

tic can translate a terminfo(4) file including variables for international functionality from the source format to the compiled format.

tic also recognizes the environment variable TERMINFO with a value that includes characters from the supplementary code sets as the path name for the compiled result.

Entry names in terminfo(4) files must be in single-byte characters, since the compiled result will be placed in a directory named using the first byte of the entry name.

Files

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

Compatibility

This command accepts source descriptions and produces compiled descriptions in the enhanced terminfo format specified by The Single UNIX Specification, Version 2; see terminfo(4). Earlier versions of this command used the older terminfo format described on oldterminfo(4).

References

captoinfo(1M), Intro(3curses), infocmp(1M), terminfo(4)

Notices

When an entry, for example, entry_name_1, contains a use=entry_name_2 field, any canceled capabilities in entry_name_2 must also appear in entry_name_1 before use= for these capabilities to be canceled in entry_name_1.