SCCS-vsn: usr.sbin/lpr/SMM.doc/1.t 6.3
SCCS-vsn: usr.sbin/lpr/SMM.doc/4.t 6.4
SCCS-vsn: usr.sbin/lpr/SMM.doc/5.t 6.4
SCCS-vsn: usr.sbin/lpr/SMM.doc/6.t 6.4
SCCS-vsn: usr.sbin/lpr/SMM.doc/7.t 6.4
.\" 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.2 (Berkeley) %G%
+.\" @(#)1.t 6.3 (Berkeley) %G%
the format of this data base, as well as
specifying default values for important items
such as the directory in which spooling is performed.
the format of this data base, as well as
specifying default values for important items
such as the directory in which spooling is performed.
-This document highlights the important
+This document introduces some of the
information that may be placed
.IR printcap .
information that may be placed
.IR printcap .
.\" 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.3 (Berkeley) %G%
+.\" @(#)4.t 6.4 (Berkeley) %G%
to be written to the file ``/usr/adm/lpd-errs''
instead of the console. Most errors from \fIlpd\fP are logged using
\fIsyslogd\fP\|(8) and will not be logged in the specified file. The
to be written to the file ``/usr/adm/lpd-errs''
instead of the console. Most errors from \fIlpd\fP are logged using
\fIsyslogd\fP\|(8) and will not be logged in the specified file. The
-filters may use either method of reporting errors.
+filters should use \fIsyslogd\fP to report errors; only those that
+write to standard error output will end up with errors in the \fBlf\fP file.
+(Occasionally errors sent to standard error output have not appeared
+in the log file; the use of \fIsyslogd\fP is highly recommended.)
.NH 3
Remote printers
.PP
.NH 3
Remote printers
.PP
The
.B rm
entry is the name of the remote machine to connect to; this name must
The
.B rm
entry is the name of the remote machine to connect to; this name must
-appear in the /etc/hosts database, see \fIhosts\fP\|(5).
+be a known host name for a machine on the network.
The
.B rp
capability indicates
The
.B rp
capability indicates
Filters are used to handle device dependencies and to
do accounting functions. The output filtering of
.B of
Filters are used to handle device dependencies and to
do accounting functions. The output filtering of
.B of
-is for when accounting is
-not used or when all text data must be passed through a filter.
+is used when accounting is
+not being done or when all text data must be passed through a filter.
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.
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.
.\" 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.3 (Berkeley) %G%
+.\" @(#)5.t 6.4 (Berkeley) %G%
.\"
.NH 1
Output filter specifications
.PP
.\"
.NH 1
Output filter specifications
.PP
-The filters supplied with 4.2BSD
+The filters supplied with 4.3BSD
handle printing and accounting for most common
line printers, the Benson-Varian, the wide (36") and
narrow (11") Versatec printer/plotters. For other devices or accounting
handle printing and accounting for most common
line printers, the Benson-Varian, the wide (36") and
narrow (11") Versatec printer/plotters. For other devices or accounting
with their standard input the data to be printed, and standard output
the printer. The standard error is attached to the
.B lf
with their standard input the data to be printed, and standard output
the printer. The standard error is attached to the
.B lf
-file for logging errors. A filter must return a 0 exit
+file for logging errors or \fIsyslogd\fP may be used for logging errors.
+A filter must return a 0 exit
code if there were no errors, 1 if the job should be reprinted,
and 2 if the job should be thrown away.
When \fIlprm\fP
code if there were no errors, 1 if the job should be reprinted,
and 2 if the job should be thrown away.
When \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.
.\"
-.\" @(#)6.t 6.3 (Berkeley) %G%
+.\" @(#)6.t 6.4 (Berkeley) %G%
.\"
.NH 1
Line printer Administration
.\"
.NH 1
Line printer Administration
places jobs at the top of a printer queue. This can be used
to reorder high priority jobs since
.I lpr
places jobs at the top of a printer queue. This can be used
to reorder high priority jobs since
.I lpr
-only only provides first-come-first-serve ordering of jobs.
+only provides first-come-first-serve ordering of jobs.
.\" 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.3 (Berkeley) %G%
+.\" @(#)7.t 6.4 (Berkeley) %G%
.\"
.NH 1
Troubleshooting
.\"
.NH 1
Troubleshooting
.PP
In the examples below, the name
.I printer
.PP
In the examples below, the name
.I printer
-is the name of the printer.
-This would be a name from the
+is the name of the printer from the
.I printcap
database.
.NH 2
.I printcap
database.
.NH 2
.I lpq
program checks to see if a daemon process exists for
.I printer
.I lpq
program checks to see if a daemon process exists for
.I printer
-and prints the file
-.IR status .
+and prints the file \fIstatus\fP located in the spooling directory.
If the daemon is hung, a super user can use
.I lpc
to abort the current daemon and start a new one.
If the daemon is hung, a super user can use
.I lpc
to abort the current daemon and start a new one.
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 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
+The error log file for the printer and the \fIsyslogd\fP logs
+should be checked for a
diagnostic from the deceased process.
To restart an \fIlpd\fP, use
.DS
diagnostic from the deceased process.
To restart an \fIlpd\fP, use
.DS
Most of these messages are about files that can not
be opened and usually imply that the
.I printcap
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
+file or the protection modes of the files are
+incorrect. Files may also be inaccessible if people
manually manipulate the line printer system (i.e. they
bypass the
.I lpr
manually manipulate the line printer system (i.e. they
bypass the
.I lpr
.IR lpd ,
any of the filters that
.I lpd
.IR lpd ,
any of the filters that
.I lpd
-spawns may log messages to the error log file (the file specified in the
-\fBlf\fP entry in \fIprintcap\fP\|).
+spawns may log messages using \fIsyslogd\fP or to the error log file
+(the file specified in the \fBlf\fP entry in \fIprintcap\fP\|).