vtprintcap(5) [debian man page]
VTPRINTCAP(5) File Formats Manual 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. for newline) are permitted, constant strings are permitted, and quotes may be used to as delimiters in the string. (This is use- ful if you wish you use a digit immediately following a numeric escape. For example, ESC-5 should be represented as 33"5" to avoid confu- sion 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 33[5i 33[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) vtprint v2.0.2 25 October 1994 VTPRINTCAP(5)
Check Out this Related Man Page
VTPRTOFF(1) General Commands Manual VTPRTOFF(1) NAME
vtprtoff,vtprton - turn off or on printer attached to local terminal SYNOPSIS
vtprtoff [ -dDeEhlqQNtvw ] [ -L vtprintcap ] [ -T termtype ] [ -V device ] vtprton [ -dDeEhlqQNtvw ] [ -L vtprintcap ] [ -T termtype ] [ -V device ] DESCRIPTION
vtprtoff is a simple program that turns off (or on) redirection of ASCII text to a printer connected to a terminal or terminal emulator. It uses terminal escape sequences to achieve this end. OPTIONS
-d Use the tty device file instead of stdout for output. This is defined as /dev/tty on this system. (This is operating system spe- cific and may vary from system to system.) -D Use the stdout stream for output, rather than a tty device file. -e Forces vtprtoff to ignore the TERM environment variable and use the builtin control codes instead. -E Undoes the effect of the -e option, which allows vtprtoff to attempt to find an entry in /etc/vtprintcap for the TERM value and use the corresponding control codes. -h Print out a simple usage message. -l Print out the license agreement. -L vtprintcap Specifies an alternate file to use instead of /etc/vtprintcap. -q Quiet mode. Suppress various status messages from being displayed. -Q Cancels the effect of the -q option, allowing normal progress reporting to occur. -t Force the use of the TERM variable to perform a look up of the control sequences to be used in /etc/vtprintcap. If an entry in that file can't be found, vtprtoff will abort with an error. -T termtype Use the value of termtype instead of the value of the TERM environment variable when performing lookups in /etc/vtprintcap. -v Display version information. -V device Specifies an alternate device file instead of /dev/tty to use. -w Display important warranty waiver information. NO WARRANTY! ENVIRONMENT
TERM the type of the terminal vtprtoff will assume is being used. VTPRINT string of options to be used by vtprtoff. AUTHOR
vtprtoff was written by Garrett D'Amore, on June 5, 1994 and last modified on October 25, 1994. It is heavily derived from a similar pro- gram, called lprint, by the same author. He can be reached via Internet e-mail at garrett@sciences.sdsu.edu. DISTRIBUTION
The latest version of vtprtoff is available as part of the vtprint package, and 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. COPYRIGHT
vtprtoff is copyrighted 1994, by Garrett D'Amore. It may be freely redistributed or modified, so long as this and any other copyright notices are included in their original form with the program. The user is granted the right to use this program without limitation. DISCLAIMER
vtprtoff is provided WITHOUT WARRANTY. The user agrees to indemnify the author from any claims of damage or loss arising from the use of or inability to use this program. In other words, USE AT YOUR OWN RISK! FILES
/etc/vtprintcap SEE ALSO
lpr(1), vtprint(1), vtprintcap(5) vtprint v2.0.2 25 October 1994 VTPRTOFF(1)