]> git.ipfire.org Git - thirdparty/cups.git/blob - man/lpq.man
License change: Apache License, Version 2.0.
[thirdparty/cups.git] / man / lpq.man
1 .\"
2 .\" lpq man page for CUPS.
3 .\"
4 .\" Copyright 2007-2014 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 information.
8 .\"
9 .TH lpq 1 "CUPS" "12 June 2014" "Apple Inc."
10 .SH NAME
11 lpq \- show printer queue status
12 .SH SYNOPSIS
13 .B lpq
14 [
15 .B \-E
16 ] [
17 .B \-U
18 .I username
19 ] [
20 \fB\-h \fIserver\fR[\fB:\fIport\fR]
21 ] [
22 \fB\-P \fIdestination\fR[\fB/\fIinstance\fR]
23 ] [
24 .B \-a
25 ] [
26 .B \-l
27 ] [
28 .BI + interval
29 ]
30 .SH DESCRIPTION
31 \fBlpq\fR shows the current print queue status on the named printer.
32 Jobs queued on the default destination will be shown if no printer or class is specified on the command-line.
33 .LP
34 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.
35 .SH OPTIONS
36 \fBlpq\fR supports the following options:
37 .TP 5
38 .B \-E
39 Forces encryption when connecting to the server.
40 .TP 5
41 \fB\-P \fIdestination\fR[\fB/\fIinstance\fR]
42 Specifies an alternate printer or class name.
43 .TP 5
44 \fB\-U \fIusername\fR
45 Specifies an alternate username.
46 .TP 5
47 .B \-a
48 Reports jobs on all printers.
49 .TP 5
50 \fB\-h \fIserver\fR[\fB:\fIport\fR]
51 Specifies an alternate server.
52 .TP 5
53 .B \-l
54 Requests a more verbose (long) reporting format.
55 .SH SEE ALSO
56 .BR cancel (1),
57 .BR lp (1),
58 .BR lpr (1),
59 .BR lprm (1),
60 .BR lpstat (1),
61 CUPS Online Help (http://localhost:631/help)
62 .SH COPYRIGHT
63 Copyright \[co] 2007-2017 by Apple Inc.