summaryrefslogtreecommitdiffstats
path: root/share/man
diff options
context:
space:
mode:
authorwollman <wollman@FreeBSD.org>1998-02-04 15:59:43 +0000
committerwollman <wollman@FreeBSD.org>1998-02-04 15:59:43 +0000
commit0c5a9444e98029032dcd282b6cb66ecb893e4903 (patch)
tree604537570f8d053b10d4ebd945621d79222e9512 /share/man
parent5d47725872c3cfbdaf8ae554aca77afcca23d132 (diff)
downloadFreeBSD-src-0c5a9444e98029032dcd282b6cb66ecb893e4903.zip
FreeBSD-src-0c5a9444e98029032dcd282b6cb66ecb893e4903.tar.gz
Don't install printcap.5 from here.
Diffstat (limited to 'share/man')
-rw-r--r--share/man/man5/Makefile2
-rw-r--r--share/man/man5/printcap.5358
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 .
OpenPOWER on IntegriCloud