diff options
| -rw-r--r-- | share/man/man5/Makefile | 2 | ||||
| -rw-r--r-- | share/man/man5/printcap.5 | 358 |
2 files changed, 1 insertions, 359 deletions
diff --git a/share/man/man5/Makefile b/share/man/man5/Makefile index e014c58..149f26e 100644 --- a/share/man/man5/Makefile +++ b/share/man/man5/Makefile @@ -4,7 +4,7 @@ MAN5= a.out.5 acct.5 core.5 devfs.5 dir.5 disktab.5 ethers.5 \ fbtab.5 fdesc.5 forward.5 fs.5 fstab.5 group.5 \ hosts.5 hosts.equiv.5 hosts.lpd.5 intro.5 kernfs.5 link.5 \ - motd.5 networks.5 passwd.5 pbm.5 phones.5 printcap.5 \ + motd.5 networks.5 passwd.5 pbm.5 phones.5 \ procfs.5 protocols.5 rc.conf.5 remote.5 resolver.5 services.5 \ shells.5 stab.5 types.5 utmp.5 diff --git a/share/man/man5/printcap.5 b/share/man/man5/printcap.5 deleted file mode 100644 index 7c9834e..0000000 --- a/share/man/man5/printcap.5 +++ /dev/null @@ -1,358 +0,0 @@ -.\" Copyright (c) 1983, 1991, 1993 -.\" The Regents of the University of California. All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)printcap.5 8.2 (Berkeley) 12/11/93 -.\" $Id: printcap.5,v 1.12 1997/10/14 16:01:02 joerg Exp $ -.\" -.Dd December 11, 1993 -.Dt PRINTCAP 5 -.Os BSD 4.2 -.Sh NAME -.Nm printcap -.Nd printer capability data base -.Sh SYNOPSIS -.Nm printcap -.Sh DESCRIPTION -The -.Nm Printcap -function -is a simplified version of the -.Xr termcap 5 -data base -used to describe line printers. The spooling system accesses the -.Nm printcap -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 -.Xr termcap 5 , -because it may allow accounting to be bypassed. -.Pp -The default printer is normally -.Em lp , -though the environment variable -.Ev PRINTER -may be used to override this. Each spooling utility supports an option, -.Fl P Ar printer , -to allow explicit naming of a destination printer. -.Pp -Refer to the -.%T "4.3 BSD Line Printer Spooler Manual" -for a complete discussion on how to setup the database for a given printer. -.Sh CAPABILITIES -Refer to -.Xr termcap 5 -for a description of the file layout. -.Bl -column Namexxx Typexx "/var/spool/lpdxxxxx" -.Sy Name Type Default Description -.It "af str" Ta Dv NULL Ta No "name of accounting file" -.It "br num none if lp is a tty, set the baud rate" -.Pf ( Xr ioctl 2 -call) -.It "cf str" Ta Dv NULL Ta No "cifplot data filter" -.It "ct num 120 TCP connection timeout in seconds" -.It "df str" Ta Dv NULL Ta No "tex data filter" -.Pf ( Tn DVI -format) -.It "ff str" Ta So Li \ef Sc Ta No "string to send for a form feed" -.It "fo bool false print a form feed when device is opened" -.It "gf str" Ta Dv NULL Ta No "graph data filter" -.Pf ( Xr plot 3 -format -.It "hl bool false print the burst header page last" -.It "ic bool false driver supports (non standard) ioctl to indent printout" -.It "if str" Ta Dv NULL Ta No "name of text filter which does accounting" -.It "lf str" Ta Pa /dev/console Ta No "error logging file name" -.It "lo str" Ta Pa lock Ta No "name of lock file" -.It "lp str" Ta Pa /dev/lp Ta No "device name to open for output" -.It "ms str" Ta Dv NULL Ta No "if lp is a tty, a comma-seperated, " -.Xr stty 1 --like list describing the tty modes -.It "mx num 1000 maximum file size (in" -.Dv BUFSIZ -blocks), zero = unlimited -.It "nd str" Ta Dv NULL Ta No "next directory for list of queues (unimplemented)" -.It "nf str" Ta Dv NULL Ta No "ditroff data filter (device independent troff)" -.It "of str" Ta Dv NULL Ta No "name of output filtering program" -.It "pc num 200 price per foot or page in hundredths of cents" -.It "pl num 66 page length (in lines)" -.It "pw num 132 page width (in characters)" -.It "px num 0 page width in pixels (horizontal)" -.It "py num 0 page length in pixels (vertical)" -.It "rf str" Ta Dv NULL Ta No "filter for printing" -.Tn FORTRAN -style text files -.It "rg str" Ta Dv NULL Ta No "restricted group. Only members of group allowed access" -.It "rm str" Ta Dv NULL Ta No "machine name for remote printer" -.It "rp str ``lp'' remote printer name argument" -.It "rs bool false restrict remote users to those with local accounts" -.It "rw bool false open the printer device for reading and writing" -.It "sb bool false short banner (one line only)" -.It "sc bool false suppress multiple copies" -.It "sd str" Ta Pa /var/spool/lpd Ta No "spool directory" -.It "sf bool false suppress form feeds" -.It "sh bool false suppress printing of burst page header" -.It "st str" Ta Pa status Ta No "status file name" -.It "tf str" Ta Dv NULL Ta No "troff data filter (cat phototypesetter)" -.It "tr str" Ta Dv NULL Ta No "trailer string to print when queue empties" -.It "vf str" Ta Dv NULL Ta No "raster image filter" -.El -.Pp -Each two-letter capability has a human-readable alternate name. -.Bl -column "Short form" "Long form" -.Sy "Short form Long form" -.It "af acct.file" -.It "br tty.rate" -.It "cf filt.cifplot" -.It "ct remote.timeout" -.It "df filt.dvi" -.It "du daemon.user" -.It "ff job.formfeed" -.It "fo job.topofform" -.It "gf filt.plot" -.It "hl banner.last" -.It "if filt.input" -.It "lf spool.log" -.It "lo spool.lock" -.It "lp tty.device" -.It "mc max.copies" -.It "ms tty.mode" -.It "mx max.blocks" -.It "nf filt.ditroff" -.It "of filt.output" -.It "pc acct.price" -.It "pl page.length" -.It "pw page.width" -.It "px page.pwidth" -.It "py page.plength" -.It "rf filt.fortran" -.It "rg daemon.restrictgrp" -.It "rm remote.host" -.It "rp remote.queue" -.It "rs daemon.restricted" -.It "rw tty.rw" -.It "sb banner.short" -.It "sc job.no_copies" -.It "sd spool.dir" -.It "sf job.no_formfeed" -.It "sh banner.disable" -.It "st spool.status" -.It "tr job.trailer" -.It "vf filt.raster" -.El -.Pp -If the local line printer driver supports indentation, the daemon -must understand how to invoke it. -.Sh FILTERS -The -.Xr lpd 8 -daemon creates a pipeline of -.Em filters -to process files for various printer types. -The filters selected depend on the flags passed to -.Xr lpr 1 . -The pipeline set up is: -.Bd -literal -offset indent -p pr | if regular text + pr(1) -none if regular text -c cf cifplot -d df DVI (tex) -g gf plot(3) -n nf ditroff -f rf Fortran -t tf troff -v vf raster image -.Ed -.Pp -The -.Sy if -filter is invoked with arguments: -.Bd -filled -offset indent -.Cm if -.Op Fl c -.Fl w Ns Ar width -.Fl l Ns Ar length -.Fl i Ns Ar indent -.Fl n Ar login -.Fl h Ar host acct-file -.Ed -.Pp -The -.Fl c -flag is passed only if the -.Fl l -flag (pass control characters literally) -is specified to -.Xr lpr 1 . -The -.Ar Width -function -and -.Ar length -specify the page width and length -(from -.Cm pw -and -.Cm pl -respectively) in characters. -The -.Fl n -and -.Fl h -parameters specify the login name and host name of the owner -of the job respectively. -The -.Ar Acct-file -function -is passed from the -.Cm af -.Nm printcap -entry. -.Pp -If no -.Cm if -is specified, -.Cm of -is used instead, -with the distinction that -.Cm of -is opened only once, -while -.Cm if -is opened for every individual job. -Thus, -.Cm if -is better suited to performing accounting. -The -.Cm of -is only given the -.Ar width -and -.Ar length -flags. -.Pp -All other filters are called as: -.Bd -filled -offset indent -.Nm filter -.Fl x Ns Ar width -.Fl y Ns Ar length -.Fl n Ar login -.Fl h Ar host acct-file -.Ed -.Pp -where -.Ar width -and -.Ar length -are represented in pixels, -specified by the -.Cm px -and -.Cm py -entries respectively. -.Pp -All filters take -.Em stdin -as the file, -.Em stdout -as the printer, -may log either to -.Em stderr -or using -.Xr syslog 3 , -and must not ignore -.Dv SIGINT . -.Sh REMOTE PRINTING -When printing to a remote printer using -.Cm rm , -it is possible to use either -.Cm if -or -.Cm of . -If both are specified, -.Cm of -is ignored. Both filters behave the same except that they are passed -different arguments as above. Specifically, the output filter is -terminated and restarted for each file transmitted. This is necessary -in order to pass the resulting size to the remote -.Xr lpd 8 . -.Pp -If the -.Fl p -flag was passed to -.Xr lpr 1 , -.Xr pr 1 -is not executed locally, but is requested of the remote -.Xr lpd 8 . -Any input filtering via -.Cm if -will therefore happen before -.Xr pr 1 -is executed rather than afterwards. -.Sh LOGGING -Error messages generated by the line printer programs themselves -(that is, the -.Xr lpd 8 -and related programs) -are logged by -.Xr syslog 3 -using the -.Dv LPR -facility. -Messages printed on -.Em stderr -of one of the filters -are sent to the corresponding -.Cm lf -file. -The filters may, of course, use -.Xr syslog 8 -themselves. -.Pp -Error messages sent to the console have a carriage return and a line -feed appended to them, rather than just a line feed. -.Sh SEE ALSO -.Xr lpq 1 , -.Xr lpr 1 , -.Xr lprm 1 , -.Xr hosts.lpd 5 , -.Xr termcap 5 , -.Xr lpc 8 , -.Xr lpd 8 , -.Xr pac 8 -.Rs -.%T "4.3 BSD Line Printer Spooler Manual" -.Re -.Sh HISTORY -The -.Nm -file format appeared in -.Bx 4.2 . |
