|
Packit |
2fc92b |
.\"
|
|
Packit |
2fc92b |
.\" lpstat man page for CUPS.
|
|
Packit |
2fc92b |
.\"
|
|
Packit |
2fc92b |
.\" Copyright 2007-2017 by Apple Inc.
|
|
Packit |
2fc92b |
.\" Copyright 1997-2006 by Easy Software Products.
|
|
Packit |
2fc92b |
.\"
|
|
Packit |
2fc92b |
.\" These coded instructions, statements, and computer programs are the
|
|
Packit |
2fc92b |
.\" property of Apple Inc. and are protected by Federal copyright
|
|
Packit |
2fc92b |
.\" law. Distribution and use rights are outlined in the file "LICENSE.txt"
|
|
Packit |
2fc92b |
.\" which should have been included with this file. If this file is
|
|
Packit |
2fc92b |
.\" file is missing or damaged, see the license at "http://www.cups.org/".
|
|
Packit |
2fc92b |
.\"
|
|
Packit |
2fc92b |
.TH lpstat 1 "CUPS" "26 May 2017" "Apple Inc."
|
|
Packit |
2fc92b |
.SH NAME
|
|
Packit |
2fc92b |
lpstat \- print cups status information
|
|
Packit |
2fc92b |
.SH SYNOPSIS
|
|
Packit |
2fc92b |
.B lpstat
|
|
Packit |
2fc92b |
[
|
|
Packit |
2fc92b |
.B \-E
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-H
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-U
|
|
Packit |
2fc92b |
.I username
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
\fB\-h \fIhostname\fR[\fB:\fIport\fR]
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-l
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-W
|
|
Packit |
2fc92b |
.I which-jobs
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-a
|
|
Packit |
2fc92b |
[
|
|
Packit |
2fc92b |
.I destination(s)
|
|
Packit |
2fc92b |
] ] [
|
|
Packit |
2fc92b |
.B \-c
|
|
Packit |
2fc92b |
[
|
|
Packit |
2fc92b |
.I class(es)
|
|
Packit |
2fc92b |
] ] [
|
|
Packit |
2fc92b |
.B \-d
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-e
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-o
|
|
Packit |
2fc92b |
[
|
|
Packit |
2fc92b |
.I destination(s)
|
|
Packit |
2fc92b |
] ] [
|
|
Packit |
2fc92b |
.B \-p
|
|
Packit |
2fc92b |
[
|
|
Packit |
2fc92b |
.I printer(s)
|
|
Packit |
2fc92b |
] ] [
|
|
Packit |
2fc92b |
.B \-r
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-R
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-s
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-t
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-u
|
|
Packit |
2fc92b |
[
|
|
Packit |
2fc92b |
.I user(s)
|
|
Packit |
2fc92b |
] ] [
|
|
Packit |
2fc92b |
.B \-v
|
|
Packit |
2fc92b |
[
|
|
Packit |
2fc92b |
.I printer(s)
|
|
Packit |
2fc92b |
] ]
|
|
Packit |
2fc92b |
.SH DESCRIPTION
|
|
Packit |
2fc92b |
\fBlpstat\fR displays status information about the current classes, jobs, and printers.
|
|
Packit |
2fc92b |
When run with no arguments, \fBlpstat\fR will list active jobs queued by the current user.
|
|
Packit |
2fc92b |
.SH OPTIONS
|
|
Packit |
2fc92b |
The \fBlpstat\fR command supports the following options:
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-E
|
|
Packit |
2fc92b |
Forces encryption when connecting to the server.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-H
|
|
Packit |
2fc92b |
Shows the server hostname and port.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-R
|
|
Packit |
2fc92b |
Shows the ranking of print jobs.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-U \fIusername\fR
|
|
Packit |
2fc92b |
Specifies an alternate username.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-W \fIwhich-jobs\fR
|
|
Packit |
2fc92b |
Specifies which jobs to show, "completed" or "not-completed" (the default).
|
|
Packit |
2fc92b |
This option \fImust\fR appear before the \fI-o\fR option and/or any printer names, otherwise the default ("not-completed") value will be used in the request to the scheduler.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-a \fR[\fIprinter(s)\fR]
|
|
Packit |
2fc92b |
Shows the accepting state of printer queues.
|
|
Packit |
2fc92b |
If no printers are specified then all printers are listed.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-c \fR[\fIclass(es)\fR]
|
|
Packit |
2fc92b |
Shows the printer classes and the printers that belong to them.
|
|
Packit |
2fc92b |
If no classes are specified then all classes are listed.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-d
|
|
Packit |
2fc92b |
Shows the current default destination.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-e
|
|
Packit |
2fc92b |
Shows all available destinations on the local network.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-h \fIserver\fR[\fB:\fIport\fR]
|
|
Packit |
2fc92b |
Specifies an alternate server.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-l
|
|
Packit |
2fc92b |
Shows a long listing of printers, classes, or jobs.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-o \fR[\fIdestination(s)\fR]
|
|
Packit |
2fc92b |
Shows the jobs queued on the specified destinations.
|
|
Packit |
2fc92b |
If no destinations are specified all jobs are shown.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-p \fR[\fIprinter(s)\fR]
|
|
Packit |
2fc92b |
Shows the printers and whether they are enabled for printing.
|
|
Packit |
2fc92b |
If no printers are specified then all printers are listed.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-r
|
|
Packit |
2fc92b |
Shows whether the CUPS server is running.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-s
|
|
Packit |
2fc92b |
Shows a status summary, including the default destination, a list of classes and their member printers, and a list of printers and their associated devices.
|
|
Packit |
2fc92b |
This is equivalent to using the \fI\-d\fR, \fI\-c\fR, and \fI\-v\fR options.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-t
|
|
Packit |
2fc92b |
Shows all status information.
|
|
Packit |
2fc92b |
This is equivalent to using the \fI\-r\fR, \fI\-d\fR, \fI\-c\fR, \fI\-v\fR, \fI\-a\fR, \fI\-p\fR, and \fI\-o\fR options.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-u \fR[\fIuser(s)\fR]
|
|
Packit |
2fc92b |
Shows a list of print jobs queued by the specified users.
|
|
Packit |
2fc92b |
If no users are specified, lists the jobs queued by the current user.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-v \fR[\fIprinter(s)\fR]
|
|
Packit |
2fc92b |
Shows the printers and what device they are attached to.
|
|
Packit |
2fc92b |
If no printers are specified then all printers are listed.
|
|
Packit |
2fc92b |
.SH CONFORMING TO
|
|
Packit |
2fc92b |
Unlike the System V printing system, CUPS allows printer names to contain any printable character except SPACE, TAB, "/", and "#".
|
|
Packit |
2fc92b |
Also, printer and class names are \fInot\fR case-sensitive.
|
|
Packit |
2fc92b |
.LP
|
|
Packit |
2fc92b |
The \fI\-h\fR, \fI-e\fR, \fI\-E\fR, \fI\-U\fR, and \fI\-W\fR options are unique to CUPS.
|
|
Packit |
2fc92b |
.LP
|
|
Packit |
2fc92b |
The Solaris \fI\-f\fR, \fI\-P\fR, and \fI\-S\fR options are silently ignored.
|
|
Packit |
2fc92b |
.SH SEE ALSO
|
|
Packit |
2fc92b |
.BR cancel (1),
|
|
Packit |
2fc92b |
.BR lp (1),
|
|
Packit |
2fc92b |
.BR lpq (1),
|
|
Packit |
2fc92b |
.BR lpr (1),
|
|
Packit |
2fc92b |
.BR lprm (1),
|
|
Packit |
2fc92b |
CUPS Online Help (http://localhost:631/help)
|
|
Packit |
2fc92b |
.SH COPYRIGHT
|
|
Packit |
2fc92b |
Copyright \[co] 2007-2017 by Apple Inc.
|