[unix-history] / usr / share / man / cat5 / printcap.0



PRINTCAP(5)		      1986		      PRINTCAP(5)


N\bNA\bAM\bME\bE
     printcap - printer capability data base

S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
     /etc/printcap

D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
     _\bP_\br_\bi_\bn_\bt_\bc_\ba_\bp is a simplified version of the _\bt_\be_\br_\bm_\bc_\ba_\bp(5) data base
     used   to	describe  line	printers.   The  spooling  system
     accesses the _\bp_\br_\bi_\bn_\bt_\bc_\ba_\bp file every time it is  used,  allowing
     dynamic  addition	and  deletion of printers.  Each entry in
     the data base is used to describe one  printer.   This  data
     base may not be substituted for, as is possible for _\bt_\be_\br_\bm_\bc_\ba_\bp,
     because it may allow accounting to be bypassed.

     The default printer is normally _\bl_\bp, though  the  environment
     variable  PRINTER may be used to override this.  Each spool-
     ing utility supports an option, -\b-P\bP_\bp_\br_\bi_\bn_\bt_\be_\br, to allow explicit
     naming of a destination printer.

     Refer to the _\b4._\b3_\bB_\bS_\bD _\bL_\bi_\bn_\be _\bP_\br_\bi_\bn_\bt_\be_\br _\bS_\bp_\bo_\bo_\bl_\be_\br _\bM_\ba_\bn_\bu_\ba_\bl for  a  com-
     plete  discussion	on  how  setup	the  database for a given
     printer.

C\bCA\bAP\bPA\bAB\bBI\bIL\bLI\bIT\bTI\bIE\bES\bS
     Refer to _\bt_\be_\br_\bm_\bc_\ba_\bp(5) for a description of the file layout.

     N\bNa\bam\bme\be   T\bTy\byp\bpe\be  D\bDe\bef\bfa\bau\bul\blt\bt	      D\bDe\bes\bsc\bcr\bri\bip\bpt\bti\bio\bon\bn
     af     str   NULL		      name of accounting file
     br     num   none		      if lp is a tty, set the baud rate (ioctl call)
     cf     str   NULL		      cifplot data filter
     df     str   NULL		      tex data filter (DVI format)
     fc     num   0		      if lp is a tty, clear flag bits (sgtty.h)
     ff     str   ``\f''	      string to send for a form feed
     fo     bool  false               print a form feed when device is opened
     fs     num   0		      like `fc' but set bits
     gf     str   NULL		      graph data filter (plot (3X) format)
     hl     bool  false               print the burst header page last
     ic     bool  false               driver supports (non standard) ioctl to indent printout
     if     str   NULL		      name of text filter which does accounting
     lf     str   ``/dev/console''    error logging file name
     lo     str   ``lock''	      name of lock file
     lp     str   ``/dev/lp''	      device name to open for output
     mx     num   1000		      maximum file size (in BUFSIZ blocks), zero = unlimited
     nd     str   NULL		      next directory for list of queues (unimplemented)
     nf     str   NULL		      ditroff data filter (device independent troff)
     of     str   NULL		      name of output filtering program
     pc     num   200		      price per foot or page in hundredths of cents
     pl     num   66		      page length (in lines)
     pw     num   132		      page width (in characters)
     px     num   0		      page width in pixels (horizontal)
     py     num   0		      page length in pixels (vertical)


Printed 7/27/90                May				1


PRINTCAP(5)		      1986		      PRINTCAP(5)


     rf     str   NULL		      filter for printing FORTRAN style text files
     rg     str   NULL		      restricted group. Only members of group allowed access
     rm     str   NULL		      machine name for remote printer
     rp     str   ``lp''	      remote printer name argument
     rs     bool  false               restrict remote users to those with local accounts
     rw     bool  false               open the printer device for reading and writing
     sb     bool  false               short banner (one line only)
     sc     bool  false               suppress multiple copies
     sd     str   ``/usr/spool/lpd''  spool directory
     sf     bool  false               suppress form feeds
     sh     bool  false               suppress printing of burst page header
     st     str   ``status''	      status file name
     tf     str   NULL		      troff data filter (cat phototypesetter)
     tr     str   NULL		      trailer string to print when queue empties
     vf     str   NULL		      raster image filter
     xc     num   0		      if lp is a tty, clear local mode bits (tty (4))
     xs     num   0		      like `xc' but set bits

     If the local line printer driver supports	indentation,  the
     daemon must understand how to invoke it.

F\bFI\bIL\bLT\bTE\bER\bRS\bS
     The _\bl_\bp_\bd(8) daemon creates a pipeline of _\bf_\bi_\bl_\bt_\be_\br_\bs  to  process
     files  for  various  printer  types.   The  filters selected
     depend on the flags passed to _\bl_\bp_\br(1).  The pipeline  set  up
     is:

	  -p   pr | if	 regular text + _\bp_\br(1)
	  none if	 regular text
	  -c   cf	 cifplot
	  -d   df	 DVI (tex)
	  -g   gf	 _\bp_\bl_\bo_\bt(3)
	  -n   nf	 ditroff
	  -f   rf	 Fortran
	  -t   tf	 troff
	  -v   vf	 raster image

     The i\bif\bf filter is invoked with arguments:

	  _\bi_\bf [ -\b-c\bc ] -\b-w\bwwidth -\b-l\bllength -\b-i\biindent -\b-n\bn  login  -\b-h\bh  host
     acct-file

     The -\b-c\bc flag is passed only if  the  -\b-l\bl  flag  (pass  control
     characters literally) is specified to _\bl_\bp_\br.  _\bW_\bi_\bd_\bt_\bh and _\bl_\be_\bn_\bg_\bt_\bh
     specify the page width and length (from p\bpw\bw  and  p\bpl\bl  respec-
     tively) in characters.  The -\b-n\bn and -\b-h\bh parameters specify the
     login name and host name of the owner  of	the  job  respec-
     tively.  _\bA_\bc_\bc_\bt-_\bf_\bi_\bl_\be is passed from the a\baf\bf _\bp_\br_\bi_\bn_\bt_\bc_\ba_\bp entry.

     If no i\bif\bf is specified, o\bof\bf is used instead, with the distinc-
     tion  that  o\bof\bf  is  opened only once, while i\bif\bf is opened for
     every  individual	job.   Thus,  i\bif\bf  is  better  suited   to


Printed 7/27/90                May				2


PRINTCAP(5)		      1986		      PRINTCAP(5)


     performing  accounting.   The o\bof\bf is only given the _\bw_\bi_\bd_\bt_\bh and
     _\bl_\be_\bn_\bg_\bt_\bh flags.

     All other filters are called as:

	  _\bf_\bi_\bl_\bt_\be_\br -\b-x\bxwidth -\b-y\bylength -\b-n\bn login -\b-h\bh host acct-file

     where _\bw_\bi_\bd_\bt_\bh and _\bl_\be_\bn_\bg_\bt_\bh are represented in pixels,	specified
     by the p\bpx\bx and p\bpy\by entries respectively.

     All filters take _\bs_\bt_\bd_\bi_\bn as the file, _\bs_\bt_\bd_\bo_\bu_\bt as  the  printer,
     may  log  either  to _\bs_\bt_\bd_\be_\br_\br or using _\bs_\by_\bs_\bl_\bo_\bg(3), and must not
     ignore SIGINT.

L\bLO\bOG\bGG\bGI\bIN\bNG\bG
     Error messages generated by the line printer programs  them-
     selves  (that  is, the _\bl_\bp* programs) are logged by _\bs_\by_\bs_\bl_\bo_\bg(3)
     using the _\bL_\bP_\bR facility.  Messages printed on _\bs_\bt_\bd_\be_\br_\br  of  one
     of  the  filters are sent to the corresponding l\blf\bf file.  The
     filters may, of course, use _\bs_\by_\bs_\bl_\bo_\bg themselves.

     Error messages sent to the console have  a  carriage  return
     and  a  line  feed appended to them, rather than just a line
     feed.

S\bSE\bEE\bE A\bAL\bLS\bSO\bO
     termcap(5), lpc(8), lpd(8), pac(8), lpr(1), lpq(1), lprm(1)
     _\b4._\b3_\bB_\bS_\bD _\bL_\bi_\bn_\be _\bP_\br_\bi_\bn_\bt_\be_\br _\bS_\bp_\bo_\bo_\bl_\be_\br _\bM_\ba_\bn_\bu_\ba_\bl


Printed 7/27/90                May				3
Commit	Line	Data
3922de1d C	1
	2
	3
	4	PRINTCAP(5) 1986 PRINTCAP(5)
	5
	6
	7
	8	N\bNA\bAM\bME\bE
	9	printcap - printer capability data base
	10
	11	S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
	12	/etc/printcap
	13
	14	D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
	15	_\bP_\br_\bi_\bn_\bt_\bc_\ba_\bp is a simplified version of the _\bt_\be_\br_\bm_\bc_\ba_\bp(5) data base
	16	used to describe line printers. The spooling system
	17	accesses the _\bp_\br_\bi_\bn_\bt_\bc_\ba_\bp file every time it is used, allowing
	18	dynamic addition and deletion of printers. Each entry in
	19	the data base is used to describe one printer. This data
	20	base may not be substituted for, as is possible for _\bt_\be_\br_\bm_\bc_\ba_\bp,
	21	because it may allow accounting to be bypassed.
	22
	23	The default printer is normally _\bl_\bp, though the environment
	24	variable PRINTER may be used to override this. Each spool-
	25	ing utility supports an option, -\b-P\bP_\bp_\br_\bi_\bn_\bt_\be_\br, to allow explicit
	26	naming of a destination printer.
	27
	28	Refer to the _\b4._\b3_\bB_\bS_\bD _\bL_\bi_\bn_\be _\bP_\br_\bi_\bn_\bt_\be_\br _\bS_\bp_\bo_\bo_\bl_\be_\br _\bM_\ba_\bn_\bu_\ba_\bl for a com-
	29	plete discussion on how setup the database for a given
	30	printer.
	31
	32	C\bCA\bAP\bPA\bAB\bBI\bIL\bLI\bIT\bTI\bIE\bES\bS
	33	Refer to _\bt_\be_\br_\bm_\bc_\ba_\bp(5) for a description of the file layout.
	34
	35	N\bNa\bam\bme\be T\bTy\byp\bpe\be D\bDe\bef\bfa\bau\bul\blt\bt D\bDe\bes\bsc\bcr\bri\bip\bpt\bti\bio\bon\bn
	36	af str NULL name of accounting file
	37	br num none if lp is a tty, set the baud rate (ioctl call)
	38	cf str NULL cifplot data filter
	39	df str NULL tex data filter (DVI format)
	40	fc num 0 if lp is a tty, clear flag bits (sgtty.h)
	41	ff str ``\f'' string to send for a form feed
	42	fo bool false print a form feed when device is opened
	43	fs num 0 like `fc' but set bits
	44	gf str NULL graph data filter (plot (3X) format)
	45	hl bool false print the burst header page last
	46	ic bool false driver supports (non standard) ioctl to indent printout
	47	if str NULL name of text filter which does accounting
	48	lf str ``/dev/console'' error logging file name
	49	lo str ``lock'' name of lock file
	50	lp str ``/dev/lp'' device name to open for output
	51	mx num 1000 maximum file size (in BUFSIZ blocks), zero = unlimited
	52	nd str NULL next directory for list of queues (unimplemented)
	53	nf str NULL ditroff data filter (device independent troff)
	54	of str NULL name of output filtering program
	55	pc num 200 price per foot or page in hundredths of cents
	56	pl num 66 page length (in lines)
	57	pw num 132 page width (in characters)
	58	px num 0 page width in pixels (horizontal)
	59	py num 0 page length in pixels (vertical)
	60
	61
	62
	63	Printed 7/27/90 May 1
	64
65
66
67
68
69
70	PRINTCAP(5) 1986 PRINTCAP(5)
71
72
73
74	rf str NULL filter for printing FORTRAN style text files
75	rg str NULL restricted group. Only members of group allowed access
76	rm str NULL machine name for remote printer
77	rp str ``lp'' remote printer name argument
78	rs bool false restrict remote users to those with local accounts
79	rw bool false open the printer device for reading and writing
80	sb bool false short banner (one line only)
81	sc bool false suppress multiple copies
82	sd str ``/usr/spool/lpd'' spool directory
83	sf bool false suppress form feeds
84	sh bool false suppress printing of burst page header
85	st str ``status'' status file name
86	tf str NULL troff data filter (cat phototypesetter)
87	tr str NULL trailer string to print when queue empties
88	vf str NULL raster image filter
89	xc num 0 if lp is a tty, clear local mode bits (tty (4))
90	xs num 0 like `xc' but set bits
91
92	If the local line printer driver supports indentation, the
93	daemon must understand how to invoke it.
94
95	F\bFI\bIL\bLT\bTE\bER\bRS\bS
96	The _\bl_\bp_\bd(8) daemon creates a pipeline of _\bf_\bi_\bl_\bt_\be_\br_\bs to process
97	files for various printer types. The filters selected
98	depend on the flags passed to _\bl_\bp_\br(1). The pipeline set up
99	is:
100
101	-p pr \| if regular text + _\bp_\br(1)
102	none if regular text
103	-c cf cifplot
104	-d df DVI (tex)
105	-g gf _\bp_\bl_\bo_\bt(3)
106	-n nf ditroff
107	-f rf Fortran
108	-t tf troff
109	-v vf raster image
110
111	The i\bif\bf filter is invoked with arguments:
112
113	_\bi_\bf [ -\b-c\bc ] -\b-w\bwwidth -\b-l\bllength -\b-i\biindent -\b-n\bn login -\b-h\bh host
114	acct-file
115
116	The -\b-c\bc flag is passed only if the -\b-l\bl flag (pass control
117	characters literally) is specified to _\bl_\bp_\br. _\bW_\bi_\bd_\bt_\bh and _\bl_\be_\bn_\bg_\bt_\bh
118	specify the page width and length (from p\bpw\bw and p\bpl\bl respec-
119	tively) in characters. The -\b-n\bn and -\b-h\bh parameters specify the
120	login name and host name of the owner of the job respec-
121	tively. _\bA_\bc_\bc_\bt-_\bf_\bi_\bl_\be is passed from the a\baf\bf _\bp_\br_\bi_\bn_\bt_\bc_\ba_\bp entry.
122
123	If no i\bif\bf is specified, o\bof\bf is used instead, with the distinc-
124	tion that o\bof\bf is opened only once, while i\bif\bf is opened for
125	every individual job. Thus, i\bif\bf is better suited to
126
127
128
129	Printed 7/27/90 May 2
130
131
132
133
134
135
136	PRINTCAP(5) 1986 PRINTCAP(5)
137
138
139
140	performing accounting. The o\bof\bf is only given the _\bw_\bi_\bd_\bt_\bh and
141	_\bl_\be_\bn_\bg_\bt_\bh flags.
142
143	All other filters are called as:
144
145	_\bf_\bi_\bl_\bt_\be_\br -\b-x\bxwidth -\b-y\bylength -\b-n\bn login -\b-h\bh host acct-file
146
147	where _\bw_\bi_\bd_\bt_\bh and _\bl_\be_\bn_\bg_\bt_\bh are represented in pixels, specified
148	by the p\bpx\bx and p\bpy\by entries respectively.
149
150	All filters take _\bs_\bt_\bd_\bi_\bn as the file, _\bs_\bt_\bd_\bo_\bu_\bt as the printer,
151	may log either to _\bs_\bt_\bd_\be_\br_\br or using _\bs_\by_\bs_\bl_\bo_\bg(3), and must not
152	ignore SIGINT.
153
154	L\bLO\bOG\bGG\bGI\bIN\bNG\bG
155	Error messages generated by the line printer programs them-
156	selves (that is, the _\bl_\bp* programs) are logged by _\bs_\by_\bs_\bl_\bo_\bg(3)
157	using the _\bL_\bP_\bR facility. Messages printed on _\bs_\bt_\bd_\be_\br_\br of one
158	of the filters are sent to the corresponding l\blf\bf file. The
159	filters may, of course, use _\bs_\by_\bs_\bl_\bo_\bg themselves.
160
161	Error messages sent to the console have a carriage return
162	and a line feed appended to them, rather than just a line
163	feed.
164
165	S\bSE\bEE\bE A\bAL\bLS\bSO\bO
166	termcap(5), lpc(8), lpd(8), pac(8), lpr(1), lpq(1), lprm(1)
167	_\b4._\b3_\bB_\bS_\bD _\bL_\bi_\bn_\be _\bP_\br_\bi_\bn_\bt_\be_\br _\bS_\bp_\bo_\bo_\bl_\be_\br _\bM_\ba_\bn_\bu_\ba_\bl
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195	Printed 7/27/90 May 3
196
197
198