[thirdparty/cups.git] / man / lpq.1

.\"
.\" lpq man page for CUPS.
.\"
.\" Copyright © 2007-2019 by Apple Inc.
.\" Copyright © 1997-2006 by Easy Software Products.
.\"
.\" Licensed under Apache License v2.0.  See the file "LICENSE" for more
.\" information.
.\"
.TH lpq 1 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
lpq \- show printer queue status
.SH SYNOPSIS
.B lpq
[
.B \-E
] [
.B \-U
.I username
] [
\fB\-h \fIserver\fR[\fB:\fIport\fR]
] [
\fB\-P \fIdestination\fR[\fB/\fIinstance\fR]
] [
.B \-a
] [
.B \-l
] [
.BI + interval
]
.SH DESCRIPTION
\fBlpq\fR shows the current print queue status on the named printer.
Jobs queued on the default destination will be shown if no printer or class is specified on the command-line.
.LP
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.
.SH OPTIONS
\fBlpq\fR supports the following options:
.TP 5
.B \-E
Forces encryption when connecting to the server.
.TP 5
\fB\-P \fIdestination\fR[\fB/\fIinstance\fR]
Specifies an alternate printer or class name.
.TP 5
\fB\-U \fIusername\fR
Specifies an alternate username.
.TP 5
.B \-a
Reports jobs on all printers.
.TP 5
\fB\-h \fIserver\fR[\fB:\fIport\fR]
Specifies an alternate server.
.TP 5
.B \-l
Requests a more verbose (long) reporting format.
.SH SEE ALSO
.BR cancel (1),
.BR lp (1),
.BR lpr (1),
.BR lprm (1),
.BR lpstat (1),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
Copyright \[co] 2007-2019 by Apple Inc.
Commit	Line	Data
	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.