VTPRINTCAP(5)

NAME
vtprintcap - database of terminal printer control codes

SYNOPSIS
/etc/vtprintcap

DESCRIPTION
vtprintcap is a simple flat file database containing a list of the names of various terminals and the codes those terminals use to start and stop an attached printer (media hard copy). This database is used by vtprint(1) and related programs.

Each entry is composed of three lines. The first line is a comma-delimited list of names which may be used to reference this entry. The second line the sequence of characters used by the terminal to turn on an attached hard copy device and redirect output to that device. The third line contains the sequence of characters used to turn the device off and restore normal output to the screen.

An entry must have all three lines to be considered valid. Currently no comment lines are permitted to exist between these lines: such lines would be interpreted as the printer control codes themselves!

The rules for selecting a terminal name are simple: you must follow the same rules as for /etc/termcap(5) names. Terminal names should be entered in /etc/vtprintcap with exactly the same names as are in /etc/termcap.

The control code strings in the second and third lines of an entry are governed as follows: ANSI C style escapes for character constants (e.g. \n for newline) are permitted, constant strings are permitted, and quotes may be used to as delimiters in the string. (This is useful if you wish you use a digit immediately following a numeric escape. For example, ESC-5 should be represented as \033"5" to avoid confusion in with \335. In general, the rules outlined for ANSI constant escaping are enforced.

Additionally, /etc/vtprintcap may contain comment lines, which are indicated by placing a hash mark (#) in the first column of the line. Remember however that entries must not be broken up by comment lines!

EXAMPLE
Here is a sample entry common to DEC vt100 and vt102 terminals:

    # Sample vtprintcap entry for vt100 & vt102 terminals
    vt100, vt102
    \033[5i
    \033[4i

This entry would be used whenever the user's TERM environment variable was set to "vt102" or "vt100", using ESC [5i and ESC [4i as the printer control codes to turn a printer on and off, respectively.

DISTRIBUTION
vtprintcap is part of the vtprint package, which can be obtained by anonymous ftp at ftp.sdsu.edu in the /pub/vtprint directory. Please read the INDEX and README files before downloading.

If you do not have ftp availability, then you can request a uuencoded copy of vtprint be sent to you via e-mail from the author. The author is also willing to make other arrangements as needed, within certain limitations.

FILES
/etc/termcap
/etc/vtprintcap

BUGS
vtprintcap handling code currently could get confused if a printer control code is exactly the same as the name of a terminal, or contained the name of a terminal delimited by commas. As this is very unlikely to every occur, it shouldn't be a problem.

SEE ALSO
termcap(5) vtprint(1)