summaryrefslogtreecommitdiff
path: root/usr.sbin/lpr/lpq/lpq.1
diff options
context:
space:
mode:
Diffstat (limited to 'usr.sbin/lpr/lpq/lpq.1')
-rw-r--r--usr.sbin/lpr/lpq/lpq.120
1 files changed, 12 insertions, 8 deletions
diff --git a/usr.sbin/lpr/lpq/lpq.1 b/usr.sbin/lpr/lpq/lpq.1
index 6a2f0cfe450..331d52b9ff6 100644
--- a/usr.sbin/lpr/lpq/lpq.1
+++ b/usr.sbin/lpr/lpq/lpq.1
@@ -1,3 +1,5 @@
+.\" $OpenBSD: lpq.1,v 1.6 2000/03/19 17:57:06 aaron Exp $
+.\"
.\" Copyright (c) 1983, 1990, 1993
.\" The Regents of the University of California. All rights reserved.
.\"
@@ -47,7 +49,7 @@
.Sh DESCRIPTION
.Nm lpq
examines the spooling area used by
-.Xr lpd 8
+.Xr lpd 8
for printing files on the line printer, and reports the status of the
specified jobs or all jobs associated with a user.
.Nm lpq
@@ -61,7 +63,8 @@ Specify a particular printer, otherwise the default
line printer is used (or the value of the
.Ev PRINTER
variable in the
-environment). All other arguments supplied are interpreted as user
+environment).
+All other arguments supplied are interpreted as user
names or job numbers to filter out only those jobs of interest.
.It Fl l
Information about each of the files comprising the job entry
@@ -73,12 +76,12 @@ rather than just the specified printer.
.El
.Pp
For each job submitted (i.e., invocation of
-.Xr lpr 1 )
+.Xr lpr 1 )
.Nm lpq
reports the user's name, current rank in the queue, the
names of files comprising the job, the job identifier (a number which
may be supplied to
-.Xr lprm 1
+.Xr lprm 1
for removing a specific job), and the total size in bytes.
Job ordering is dependent on
the algorithm used to scan the spooling directory and is supposed
@@ -87,7 +90,7 @@ to be
(First In First Out).
File names comprising a job may be unavailable
(when
-.Xr lpr 1
+.Xr lpr 1
is used as a sink in a pipeline) in which case the file
is indicated as
.Dq (standard input) .
@@ -96,7 +99,7 @@ If
.Nm lpq
warns that there is no daemon present (i.e., due to some malfunction),
the
-.Xr lpc 8
+.Xr lpc 8
command can be used to restart the printer daemon.
.Sh ENVIRONMENT
If the following environment variable exists, it is used by
@@ -132,6 +135,7 @@ may report unreliably.
Output formatting is sensitive to the line length of the terminal;
this can result in widely spaced columns.
.Sh DIAGNOSTICS
-Unable to open various files. The lock file being malformed. Garbage
+Unable to open various files.
+The lock file being malformed.
+Garbage
files when there is no daemon active, but files in the spooling directory.
-