diff options
author | Aaron Campbell <aaron@cvs.openbsd.org> | 2000-03-19 17:57:20 +0000 |
---|---|---|
committer | Aaron Campbell <aaron@cvs.openbsd.org> | 2000-03-19 17:57:20 +0000 |
commit | 480390dc59325200978ed49a1b26f00a94c91baa (patch) | |
tree | 062c09ac43a080a68cd77af35c77fcac0d938f46 /usr.sbin/lpr/lpd/lpd.8 | |
parent | fb660b4c0cea9ae33d3d4dac0984c52ed7b6eeb0 (diff) |
Remove hard sentence breaks. Add $OpenBSD$ tags where appropriate. Some other
cleanup along the way.
Diffstat (limited to 'usr.sbin/lpr/lpd/lpd.8')
-rw-r--r-- | usr.sbin/lpr/lpd/lpd.8 | 90 |
1 files changed, 57 insertions, 33 deletions
diff --git a/usr.sbin/lpr/lpd/lpd.8 b/usr.sbin/lpr/lpd/lpd.8 index 96c08f8693d..1bf56259249 100644 --- a/usr.sbin/lpr/lpd/lpd.8 +++ b/usr.sbin/lpr/lpd/lpd.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: lpd.8,v 1.9 1999/10/17 19:59:44 aaron Exp $ +.\" $OpenBSD: lpd.8,v 1.10 2000/03/19 17:57:06 aaron Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -47,16 +47,19 @@ is the line printer daemon (spool area handler) and is normally invoked at boot time from the .Xr rc 8 -file. It makes a single pass through the +file. +It makes a single pass through the .Xr printcap 5 file to find out about the existing printers and -prints any files left after a crash. It then uses the system calls +prints any files left after a crash. +It then uses the system calls .Xr listen 2 and .Xr accept 2 to receive requests to print files in the queue, transfer files to the spooling area, display the queue, -or remove jobs from the queue. In each case, it forks a child to handle +or remove jobs from the queue. +In each case, it forks a child to handle the request so the parent can continue to listen for more requests. .Pp The options are as follows: @@ -64,11 +67,12 @@ The options are as follows: .It Fl l Cause .Nm -to log valid requests received from the network. This can be useful -for debugging purposes. +to log valid requests received from the network. +This can be useful for debugging purposes. .El .Pp -Access control is provided by two means. First, all requests must come from +Access control is provided by two means. +First, all requests must come from one of the machines listed in the file .Pa /etc/hosts.equiv or @@ -99,33 +103,40 @@ for files beginning with Lines in each .Em cf file specify files to be printed or non-printing actions to be -performed. Each such line begins with a key character +performed. +Each such line begins with a key character to specify what to do with the remainder of the line. .Bl -tag -width Ds .It J -Job Name. String to be used for the job name on the burst page. +Job Name. +String to be used for the job name on the burst page. .It C -Classification. String to be used for the classification line -on the burst page. +Classification. +String to be used for the classification line on the burst page. .It L -Literal. The line contains identification info from +Literal. +The line contains identification info from the password file and causes the banner page to be printed. .It T -Title. String to be used as the title for +Title. +String to be used as the title for .Xr pr 1 . .It H -Host Name. Name of the machine where +Host Name. +Name of the machine where .Xr lpr 1 was invoked. .It P -Person. Login name of the person who invoked +Person. +Login name of the person who invoked .Xr lpr 1 . This is used to verify ownership by .Xr lprm 1 . .It M Send mail to the specified user when the current print job completes. .It f -Formatted File. Name of a file to print which is already formatted. +Formatted File. +Name of a file to print which is already formatted. .It l Like .Dq f @@ -135,22 +146,26 @@ Name of a file to print using .Xr pr 1 as a filter. .It t -Troff File. The file contains +Troff File. +The file contains .Xr troff 1 output (cat phototypesetter commands). .It n -Ditroff File. The file contains device independent troff -output. +Ditroff File. +The file contains device independent troff output. .It r -DVI File. The file contains +DVI File. +The file contains .Tn Tex l output DVI format from Standford. .It g -Graph File. The file contains data produced by +Graph File. +The file contains data produced by .Xr plot 3 . .It c -Cifplot File. The file contains data produced by +Cifplot File. +The file contains data produced by .Em cifplot . .It v The file contains a raster image. @@ -158,23 +173,31 @@ The file contains a raster image. The file contains text data with FORTRAN carriage control characters. .It \&1 -Troff Font R. Name of the font file to use instead of the default. +Troff Font R. +Name of the font file to use instead of the default. .It \&2 -Troff Font I. Name of the font file to use instead of the default. +Troff Font I. +Name of the font file to use instead of the default. .It \&3 -Troff Font B. Name of the font file to use instead of the default. +Troff Font B. +Name of the font file to use instead of the default. .It \&4 -Troff Font S. Name of the font file to use instead of the default. +Troff Font S. +Name of the font file to use instead of the default. .It W -Width. Changes the page width (in characters) used by +Width. +Changes the page width (in characters) used by .Xr pr 1 and the text filters. .It I -Indent. The number of characters to indent the output by (in ascii). +Indent. +The number of characters to indent the output by (in ascii). .It U -Unlink. Name of file to remove upon completion of printing. +Unlink. +Name of file to remove upon completion of printing. .It N -File name. The name of the file which is being printed, or a blank +File name. +The name of the file which is being printed, or a blank for the standard input (when .Xr lpr 1 is invoked in a pipeline). @@ -194,15 +217,16 @@ skip the file to be printed. uses .Xr flock 2 to provide exclusive access to the lock file and to prevent multiple -daemons from becoming active simultaneously. If the daemon should be killed +daemons from becoming active simultaneously. +If the daemon should be killed or die unexpectedly, the lock file need not be removed. The lock file is kept in a readable .Tn ASCII form and contains two lines. The first is the process ID of the daemon and the second is the control -file name of the current job being printed. The second line is updated to -reflect the current status of +file name of the current job being printed. +The second line is updated to reflect the current status of .Nm for the programs .Xr lpq 1 |