SCCS-vsn: usr.sbin/lpr/SMM.doc/1.t 6.2
SCCS-vsn: usr.sbin/lpr/SMM.doc/2.t 6.3
SCCS-vsn: usr.sbin/lpr/SMM.doc/3.t 6.3
SCCS-vsn: usr.sbin/lpr/SMM.doc/4.t 6.3
SCCS-vsn: usr.sbin/lpr/SMM.doc/5.t 6.3
SCCS-vsn: usr.sbin/lpr/SMM.doc/6.t 6.3
SCCS-vsn: usr.sbin/lpr/SMM.doc/7.t 6.3
.\" All rights reserved. The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\" All rights reserved. The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
-.\" @(#)1.t 6.1 (Berkeley) %G%
+.\" @(#)1.t 6.2 (Berkeley) %G%
both local and remote
printers, and
.IP \(bu 3
both local and remote
printers, and
.IP \(bu 3
-printers attached via serial lines which require
+printers attached via serial lines that require
line initialization such as the baud rate.
.LP
Raster output devices
line initialization such as the baud rate.
.LP
Raster output devices
printers directly attached to a machine and, also, printers
accessible across a network. The manual page entry
.IR printcap (5)
printers directly attached to a machine and, also, printers
accessible across a network. The manual page entry
.IR printcap (5)
-provides the ultimate definition of
+provides the authoritative definition of
the format of this data base, as well as
the format of this data base, as well as
-indicating default values for important items
+specifying default values for important items
such as the directory in which spooling is performed.
This document highlights the important
such as the directory in which spooling is performed.
This document highlights the important
-information which may be placed
+information that may be placed
.\" All rights reserved. The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\" All rights reserved. The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
-.\" @(#)2.t 6.2 (Berkeley) %G%
+.\" @(#)2.t 6.3 (Berkeley) %G%
.I lpd
is started it makes a single pass through the
.I printcap
.I lpd
is started it makes a single pass through the
.I printcap
-database restarting any printers which have jobs.
+database restarting any printers that have jobs.
In normal operation
.I lpd
listens for service requests on multiple sockets,
In normal operation
.I lpd
listens for service requests on multiple sockets,
.I lpd
that there are new jobs in the spooling area.
.I Lpd
.I lpd
that there are new jobs in the spooling area.
.I Lpd
-either schedules the job to be printed locally, or in the
-case of remote printing, attempts to forward
+either schedules the job to be printed locally, or if
+printing remotely, attempts to forward
the job to the appropriate machine.
If the printer cannot be opened or the destination
machine is unreachable, the job will remain queued until it is
the job to the appropriate machine.
If the printer cannot be opened or the destination
machine is unreachable, the job will remain queued until it is
.I Lpq
has two forms of output: in the default, short, format it
gives a single line of output per queued job; in the long
.I Lpq
has two forms of output: in the default, short, format it
gives a single line of output per queued job; in the long
-format it shows the list of files, and their sizes, which
+format it shows the list of files, and their sizes, that
comprise a job.
.NH 2
lprm \- remove jobs from a queue
.PP
The \fIlprm\fP\|(1) command deletes jobs from a spooling
queue. If necessary, \fIlprm\fP will first kill off a
comprise a job.
.NH 2
lprm \- remove jobs from a queue
.PP
The \fIlprm\fP\|(1) command deletes jobs from a spooling
queue. If necessary, \fIlprm\fP will first kill off a
-running daemon which is servicing the queue, restarting
+running daemon that is servicing the queue and restart
it after the required files are removed. When removing
jobs destined for a remote printer, \fIlprm\fP acts
similarly to \fIlpq\fP except it first checks locally
it after the required files are removed. When removing
jobs destined for a remote printer, \fIlprm\fP acts
similarly to \fIlpq\fP except it first checks locally
.\" All rights reserved. The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\" All rights reserved. The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
-.\" @(#)3.t 6.2 (Berkeley) %G%
+.\" @(#)3.t 6.3 (Berkeley) %G%
and \fIspooling\fP group.
.IP \(bu 3
The \fIlpr\fP program runs set-user-id to \fIroot\fP and
and \fIspooling\fP group.
.IP \(bu 3
The \fIlpr\fP program runs set-user-id to \fIroot\fP and
-set-group-id to group \fIdaemon\fP. The \fIroot\fP access is used to
-read any file required, verifying accessibility
+set-group-id to group \fIdaemon\fP. The \fIroot\fP access permits
+reading any file required. Accessibility is verified
with an \fIaccess\fP\|(2) call. The group ID
is used in setting up proper ownership of files
in the spooling area for \fIlprm\fP.
with an \fIaccess\fP\|(2) call. The group ID
is used in setting up proper ownership of files
in the spooling area for \fIlprm\fP.
.\" All rights reserved. The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\" All rights reserved. The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
-.\" @(#)4.t 6.2 (Berkeley) %G%
+.\" @(#)4.t 6.3 (Berkeley) %G%
A printer should have a separate spooling directory;
otherwise, jobs will be printed on
different printers depending on which printer daemon starts first.
A printer should have a separate spooling directory;
otherwise, jobs will be printed on
different printers depending on which printer daemon starts first.
-This section describes how to create entries for printers which do not
+This section describes how to create entries for printers that do not
conform to the default printer description (an LP-11 style interface to a
standard, band printer).
.NH 3
conform to the default printer description (an LP-11 style interface to a
standard, band printer).
.NH 3
-entry specifies the file name to open for output. In this case it could
+entry specifies the file name to open for output. Here it could
be left out since ``/dev/lp'' is the default.
The
.B br
be left out since ``/dev/lp'' is the default.
The
.B br
entry sets CRMOD, no parity, and XTABS (see \fItty\fP\|(4)).
The
.B tr
entry sets CRMOD, no parity, and XTABS (see \fItty\fP\|(4)).
The
.B tr
-entry indicates a form-feed should be printed when the queue
+entry indicates that a form-feed should be printed when the queue
empties so the paper can be torn off without turning the printer off-line and
pressing form feed.
The
empties so the paper can be torn off without turning the printer off-line and
pressing form feed.
The
.NH 3
Remote printers
.PP
.NH 3
Remote printers
.PP
-Printers which reside on remote hosts should have an empty
+Printers that reside on remote hosts should have an empty
.B lp
entry.
For example, the following printcap entry would send output to the printer
.B lp
entry.
For example, the following printcap entry would send output to the printer
.B rp
capability indicates
the name of the printer on the remote machine is ``lp'';
.B rp
capability indicates
the name of the printer on the remote machine is ``lp'';
-in this case it could be left out since this is the default value.
+here it could be left out since this is the default value.
The
.B sd
entry specifies ``/usr/spool/vaxlpd''
The
.B sd
entry specifies ``/usr/spool/vaxlpd''
Output filters
.PP
Filters are used to handle device dependencies and to
Output filters
.PP
Filters are used to handle device dependencies and to
-perform accounting functions. The output filter
+do accounting functions. The output filtering of
-is used to filter text data to the printer device when accounting is
+is for when accounting is
not used or when all text data must be passed through a filter.
not used or when all text data must be passed through a filter.
-It is not intended to perform accounting since it is started only once,
+It is not intended to do accounting since it is started only once,
all text files are filtered through it, and no provision is made for passing
owners' login name, identifying the beginning and ending of jobs, etc.
The other filters (if specified) are started for each file
all text files are filtered through it, and no provision is made for passing
owners' login name, identifying the beginning and ending of jobs, etc.
The other filters (if specified) are started for each file
-printed and perform accounting if there is an
+printed and do accounting if there is an
.B af
entry.
If entries for both
.B of
.B af
entry.
If entries for both
.B of
-and one of the other filters are specified,
+and other filters are specified,
the output filter is used only to print the banner page;
it is then stopped to allow other filters access to the printer.
the output filter is used only to print the banner page;
it is then stopped to allow other filters access to the printer.
-An example of a printer which requires output filters
+An example of a printer that requires output filters
is the Benson-Varian.
.DS
.DT
is the Benson-Varian.
.DS
.DT
.DE
Users must be in the group
.I lprgroup
.DE
Users must be in the group
.I lprgroup
-in order to submit jobs to the specified printer.
+to submit jobs to the specified printer.
The default is to allow all users access.
Note that once the files are in the local queue, they can be printed
locally or forwarded to another host depending on the configuration.
The default is to allow all users access.
Note that once the files are in the local queue, they can be printed
locally or forwarded to another host depending on the configuration.
.\" All rights reserved. The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\" All rights reserved. The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
-.\" @(#)5.t 6.2 (Berkeley) %G%
+.\" @(#)5.t 6.3 (Berkeley) %G%
.\"
.NH 1
Output filter specifications
.\"
.NH 1
Output filter specifications
sends a kill signal to the \fIlpd\fP process controlling
printing, it sends a SIGINT signal
to all filters and descendents of filters.
sends a kill signal to the \fIlpd\fP process controlling
printing, it sends a SIGINT signal
to all filters and descendents of filters.
-This signal can be trapped by filters which need
-to perform cleanup operations such as
+This signal can be trapped by filters that need
+to do cleanup operations such as
deleting temporary files.
.PP
Arguments passed to a filter depend on its type.
deleting temporary files.
.PP
Arguments passed to a filter depend on its type.
The
.B \-c
flag is optional, and only supplied when control characters
The
.B \-c
flag is optional, and only supplied when control characters
-are to be passed uninterpreted to the printer (when the
+are to be passed uninterpreted to the printer (when using the
-is used to print the file).
.\" All rights reserved. The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\" All rights reserved. The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
-.\" @(#)6.t 6.2 (Berkeley) %G%
+.\" @(#)6.t 6.3 (Berkeley) %G%
.\"
.NH 1
Line printer Administration
.\"
.NH 1
Line printer Administration
-is used to halt a spooling daemon after the current job completes;
+halts a spooling daemon after the current job completes;
this also disables printing. This is a clean way to shutdown a
this also disables printing. This is a clean way to shutdown a
-printer in order to perform
-maintenance, etc. Note that users can still enter jobs in a
+printer to do maintenance, etc. Note that users can still enter jobs in a
spool queue while a printer is
.IR stopped .
.LP
spool queue while a printer is
.IR stopped .
.LP
.\" All rights reserved. The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\" All rights reserved. The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
-.\" @(#)7.t 6.2 (Berkeley) %G%
+.\" @(#)7.t 6.3 (Berkeley) %G%
.\"
.NH 1
Troubleshooting
.PP
.\"
.NH 1
Troubleshooting
.PP
-There are a number of messages which may be generated by the
+There are several messages that may be generated by the
the line printer system. This section
categorizes the most common and explains the cause
the line printer system. This section
categorizes the most common and explains the cause
-for their generation. Where the message indicates a failure,
+for their generation. Where the message implies a failure,
directions are given to remedy the problem.
.PP
In the examples below, the name
.I printer
is the name of the printer.
directions are given to remedy the problem.
.PP
In the examples below, the name
.I printer
is the name of the printer.
-This would be one of the names from the
+This would be a name from the
.I printcap
database.
.NH 2
.I printcap
database.
.NH 2
there is no
.I lpd
process running).
there is no
.I lpd
process running).
-Usually it is sufficient to get a super-user to type the following to
+Usually it is enough to get a super-user to type the following to
restart
.IR lpd .
.DS
% /usr/lib/lpd
.DE
restart
.IR lpd .
.DS
% /usr/lib/lpd
.DE
-You can also check on the state of the master printer daemon with the following.
+You can also check the state of the master printer daemon with the following.
.DS
% ps l`cat /usr/spool/lpd.lock`
.DE
.DS
% ps l`cat /usr/spool/lpd.lock`
.DE
waiting for \fIprinter\fP to become ready (offline ?)
.IP
The printer device could not be opened by the daemon.
waiting for \fIprinter\fP to become ready (offline ?)
.IP
The printer device could not be opened by the daemon.
-This can happen for a number of reasons,
-the most common being that the printer is turned off-line.
+This can happen for several reasons,
+the most common is that the printer is turned off-line.
This message can also be generated if the printer is out
of paper, the paper is jammed, etc.
The actual reason is dependent on the meaning
of error codes returned by system device driver.
This message can also be generated if the printer is out
of paper, the paper is jammed, etc.
The actual reason is dependent on the meaning
of error codes returned by system device driver.
-Not all printers supply sufficient information
+Not all printers supply enough information
to distinguish when a printer is off-line or having
trouble (e.g. a printer connected through a serial line).
Another possible cause of this message is
to distinguish when a printer is off-line or having
trouble (e.g. a printer connected through a serial line).
Another possible cause of this message is
.SH
waiting for \fIhost\fP to come up
.IP
.SH
waiting for \fIhost\fP to come up
.IP
-This indicates there is a daemon trying to connect to the remote
+This implies there is a daemon trying to connect to the remote
-in order to send the files in the local queue.
+to send the files in the local queue.
If the remote machine is up,
.I lpd
on the remote machine is probably dead or
If the remote machine is up,
.I lpd
on the remote machine is probably dead or
Warning: no daemon present
.IP
The \fIlpd\fP process overseeing
Warning: no daemon present
.IP
The \fIlpd\fP process overseeing
-the spooling queue, as indicated in the ``lock'' file
+the spooling queue, as specified in the ``lock'' file
in that directory, does not exist. This normally occurs
only when the daemon has unexpectedly died.
The error log file for the printer should be checked for a
in that directory, does not exist. This normally occurs
only when the daemon has unexpectedly died.
The error log file for the printer should be checked for a
.SH
no space on remote; waiting for queue to drain
.IP
.SH
no space on remote; waiting for queue to drain
.IP
-This indicates that there is insufficient disk space on the remote.
+This implies that there is insufficient disk space on the remote.
If the file is large enough, there will never be enough space on
the remote (even after the queue on the remote is empty). The solution here
is to move the spooling queue or make more free space on the remote.
If the file is large enough, there will never be enough space on
the remote (even after the queue on the remote is empty). The solution here
is to move the spooling queue or make more free space on the remote.
The
.I lpd
program can log many different messages using \fIsyslogd\fP\|(8).
The
.I lpd
program can log many different messages using \fIsyslogd\fP\|(8).
-Most of these messages are about files which can not
-be opened and usually indicate the
+Most of these messages are about files that can not
+be opened and usually imply that the
.I printcap
file or the protection modes of the files are not
correct. Files may also be inaccessible if people
.I printcap
file or the protection modes of the files are not
correct. Files may also be inaccessible if people
.SH
cannot examine spool directory
.IP
.SH
cannot examine spool directory
.IP
-Error messages beginning with ``cannot ...'' are usually due to
-incorrect ownership and/or protection mode of the lock file, spooling
+Error messages beginning with ``cannot ...'' are usually because of
+incorrect ownership or protection mode of the lock file, spooling
directory or the
.I lpc
program.
directory or the
.I lpc
program.