]> git.ipfire.org Git - thirdparty/cups.git/blob - man/lpq.1
Merge pull request #5621 from zdohnal/cgigetarray-sigsegv
[thirdparty/cups.git] / man / lpq.1
1 .\"
2 .\" lpq man page for CUPS.
3 .\"
4 .\" Copyright © 2007-2019 by Apple Inc.
5 .\" Copyright © 1997-2006 by Easy Software Products.
6 .\"
7 .\" Licensed under Apache License v2.0. See the file "LICENSE" for more
8 .\" information.
9 .\"
10 .TH lpq 1 "CUPS" "26 April 2019" "Apple Inc."
11 .SH NAME
12 lpq \- show printer queue status
13 .SH SYNOPSIS
14 .B lpq
15 [
16 .B \-E
17 ] [
18 .B \-U
19 .I username
20 ] [
21 \fB\-h \fIserver\fR[\fB:\fIport\fR]
22 ] [
23 \fB\-P \fIdestination\fR[\fB/\fIinstance\fR]
24 ] [
25 .B \-a
26 ] [
27 .B \-l
28 ] [
29 .BI + interval
30 ]
31 .SH DESCRIPTION
32 \fBlpq\fR shows the current print queue status on the named printer.
33 Jobs queued on the default destination will be shown if no printer or class is specified on the command-line.
34 .LP
35 The \fI+interval\fR option allows you to continuously report the jobs in the queue until the queue is empty; the list of jobs is shown once every \fIinterval\fR seconds.
36 .SH OPTIONS
37 \fBlpq\fR supports the following options:
38 .TP 5
39 .B \-E
40 Forces encryption when connecting to the server.
41 .TP 5
42 \fB\-P \fIdestination\fR[\fB/\fIinstance\fR]
43 Specifies an alternate printer or class name.
44 .TP 5
45 \fB\-U \fIusername\fR
46 Specifies an alternate username.
47 .TP 5
48 .B \-a
49 Reports jobs on all printers.
50 .TP 5
51 \fB\-h \fIserver\fR[\fB:\fIport\fR]
52 Specifies an alternate server.
53 .TP 5
54 .B \-l
55 Requests a more verbose (long) reporting format.
56 .SH SEE ALSO
57 .BR cancel (1),
58 .BR lp (1),
59 .BR lpr (1),
60 .BR lprm (1),
61 .BR lpstat (1),
62 CUPS Online Help (http://localhost:631/help)
63 .SH COPYRIGHT
64 Copyright \[co] 2007-2019 by Apple Inc.