Return to lpd.8 CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man8

Annotation of cci/usr/src/man/man8/lpd.8, revision 1.1

1.1     ! root        1: .TH LPD 8 "18 July 1983"
        !             2: .UC 4
        !             3: .ad
        !             4: .SH NAME
        !             5: lpd \- line printer daemon
        !             6: .SH SYNOPSIS
        !             7: .B /usr/lib/lpd
        !             8: [ -l ] [ -L logfile ] [ port # ]
        !             9: .SH DESCRIPTION
        !            10: .I Lpd
        !            11: is the line printer daemon (spool area handler) and is normally invoked
        !            12: at boot time from the
        !            13: .IR rc (8)
        !            14: file.  It makes a single pass through the
        !            15: .IR printcap (5)
        !            16: file to find out about the existing printers and
        !            17: prints any files left after a crash. It then uses the system calls
        !            18: .IR listen (2)
        !            19: and
        !            20: .IR accept (2)
        !            21: to receive requests to print files in the queue,
        !            22: transfer files to the spooling area, display the queue,
        !            23: or remove jobs from the queue.  In each case, it forks a child to handle
        !            24: the request so the parent can continue to listen for more requests.
        !            25: The Internet port number used to rendezvous
        !            26: with other processes is normally obtained with
        !            27: .IR getservbyname (3)
        !            28: but can be changed with the
        !            29: .IR port #
        !            30: argument. The
        !            31: .B \-L
        !            32: option changes the file used for writing error conditions from the
        !            33: system console to
        !            34: .I logfile.
        !            35: The
        !            36: .B \-l
        !            37: flag causes
        !            38: .I lpd
        !            39: to log valid requests received from the network. This can be useful
        !            40: for debugging purposes.
        !            41: .PP
        !            42: Access control is provided by two means. First, All requests must come from
        !            43: one of the machines listed in the file
        !            44: .IR /etc/hosts.equiv .
        !            45: Second, if the ``rs'' capability is specified in the
        !            46: .I printcap
        !            47: entry for the printer being accessed,
        !            48: .I lpr
        !            49: requests will only be honored for those users with accounts on the
        !            50: machine with the printer.
        !            51: .PP
        !            52: The file
        !            53: .I lock
        !            54: in each spool directory is used to prevent multiple daemons from
        !            55: becoming active simultaneously, and to store information
        !            56: about the daemon process for
        !            57: .IR lpr (1),
        !            58: .IR lpq (1),
        !            59: and
        !            60: .IR lprm (1).
        !            61: After the daemon has successfully set the lock, it scans the directory
        !            62: for files beginning with 
        !            63: .IR cf .
        !            64: Lines in each
        !            65: .I cf
        !            66: file specify files to be printed or non-printing actions to be
        !            67: performed.  Each such line begins with a key character
        !            68: to specify what to do with the remainder of the line.
        !            69: .in +3
        !            70: .IP J
        !            71: Job Name.  String to be used for the job name on the burst page.
        !            72: .IP C
        !            73: Classification.  String to be used for the classification line
        !            74: on the burst page.
        !            75: .IP L
        !            76: Literal.  The line contains identification info from
        !            77: the password file and causes the banner page to be printed.
        !            78: .IP T
        !            79: Title.  String to be used as the title for
        !            80: .IR pr (1).
        !            81: .IP H
        !            82: Host Name.  Name of the machine where
        !            83: .I lpr
        !            84: was invoked.
        !            85: .IP P
        !            86: Person.  Login name of the person who invoked
        !            87: .IR lpr .
        !            88: This is used to verify ownership by
        !            89: .IR lprm .
        !            90: .IP M
        !            91: Send mail to the specified user when the current print job completes.
        !            92: .IP f
        !            93: Formatted File.  Name of a file to print which is already formatted.
        !            94: .IP l
        !            95: Like ``f'' but passes control characters and does not make page breaks.
        !            96: .IP p
        !            97: Name of a file to print using
        !            98: .IR pr (1)
        !            99: as a filter.
        !           100: .IP t
        !           101: Troff File.  The file contains
        !           102: .IR troff (1)
        !           103: output (cat phototypesetter commands).
        !           104: .IP d
        !           105: DVI File.  The file contains
        !           106: .IR Tex (l)
        !           107: output (DVI format from Standford).
        !           108: .IP g
        !           109: Graph File.  The file contains data produced by
        !           110: .IR plot (3X).
        !           111: .IP c
        !           112: Cifplot File. The file contains data produced by
        !           113: .IR cifplot .
        !           114: .IP v
        !           115: The file contains a raster image.
        !           116: .IP r
        !           117: The file contains text data with FORTRAN carriage control characters.
        !           118: .IP 1
        !           119: Troff Font R. Name of the font file to use instead of the default.
        !           120: .IP 2
        !           121: Troff Font I. Name of the font file to use instead of the default.
        !           122: .IP 3
        !           123: Troff Font B. Name of the font file to use instead of the default.
        !           124: .IP 4
        !           125: Troff Font S. Name of the font file to use instead of the default.
        !           126: .IP W
        !           127: Width. Changes the page width (in characters) used by
        !           128: .IR pr (1)
        !           129: and the text filters.
        !           130: .IP I
        !           131: Indent.  The number of characters to indent the output by (in ascii).
        !           132: .IP U
        !           133: Unlink.  Name of file to remove upon completion of printing.
        !           134: .IP N
        !           135: File name.  The name of the file which is being printed, or a blank
        !           136: for the standard input (when 
        !           137: .I lpr
        !           138: is invoked in a pipeline).
        !           139: .in -5
        !           140: .PP
        !           141: If a file can not be opened, a message will be placed
        !           142: in the log file (normally the console).
        !           143: .I Lpd
        !           144: will try up to 20 times
        !           145: to reopen a file it expects to be there, after which it will
        !           146: skip the file to be printed.
        !           147: .PP
        !           148: .I Lpd
        !           149: uses
        !           150: .IR flock (2)
        !           151: to provide exclusive access to the lock file and to prevent multiple
        !           152: deamons from becoming active simultaneously.  If the daemon should be killed
        !           153: or die unexpectedly, the lock file need not be removed.
        !           154: The lock file is kept in a readable ASCII form
        !           155: and contains two lines.
        !           156: The first is the process id of the daemon and the second is the control
        !           157: file name of the current job being printed.  The second line is updated to
        !           158: reflect the current status of
        !           159: .I lpd
        !           160: for the programs
        !           161: .IR lpq (1)
        !           162: and
        !           163: .IR lprm (1).
        !           164: .SH FILES
        !           165: .nf
        !           166: .ta \w'/etc/printcap           'u
        !           167: /etc/printcap  printer description file
        !           168: /usr/spool/*   spool directories
        !           169: /dev/lp*       line printer devices
        !           170: /dev/printer   socket for local requests
        !           171: /etc/hosts.equiv       lists machine names allowed printer access
        !           172: .fi
        !           173: .SH "SEE ALSO"
        !           174: lpc(8),
        !           175: pac(1),
        !           176: lpr(1),
        !           177: lpq(1),
        !           178: lprm(1),
        !           179: printcap(5)
        !           180: .br
        !           181: .ul
        !           182: 4.2BSD Line Printer Spooler Manual

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.