3 <!-- SECTION: Man Pages -->
5 <link rel=
"stylesheet" type=
"text/css" href=
"../cups-printable.css">
6 <title>lpstat(
1)
</title>
9 <h1 class=
"title">lpstat(
1)
</h1>
10 <h2 class=
"title"><a name=
"NAME">Name
</a></h2>
11 lpstat - print cups status information
12 <h2 class=
"title"><a name=
"SYNOPSIS">Synopsis
</a></h2>
22 <b>-h
</b><i>hostname
</i>[
<b>:
</b><i>port
</i>]
63 <h2 class=
"title"><a name=
"DESCRIPTION">Description
</a></h2>
64 <b>lpstat
</b> displays status information about the current classes, jobs, and printers.
65 When run with no arguments,
<b>lpstat
</b> will list active jobs queued by the current user.
66 <h2 class=
"title"><a name=
"OPTIONS">Options
</a></h2>
67 The
<b>lpstat
</b> command supports the following options:
70 <dd style=
"margin-left: 5.0em">Forces encryption when connecting to the server.
72 <dd style=
"margin-left: 5.0em">Shows the server hostname and port.
74 <dd style=
"margin-left: 5.0em">Shows the ranking of print jobs.
75 <dt><b>-U
</b><i>username
</i>
76 <dd style=
"margin-left: 5.0em">Specifies an alternate username.
77 <dt><b>-W
</b><i>which-jobs
</i>
78 <dd style=
"margin-left: 5.0em">Specifies which jobs to show,
"completed" or
"not-completed" (the default).
79 This option
<i>must
</i> appear before the
<i>-o
</i> option and/or any printer names, otherwise the default (
"not-completed") value will be used in the request to the scheduler.
80 <dt><b>-a
</b>[
<i>printer(s)
</i>]
81 <dd style=
"margin-left: 5.0em">Shows the accepting state of printer queues.
82 If no printers are specified then all printers are listed.
83 <dt><b>-c
</b>[
<i>class(es)
</i>]
84 <dd style=
"margin-left: 5.0em">Shows the printer classes and the printers that belong to them.
85 If no classes are specified then all classes are listed.
87 <dd style=
"margin-left: 5.0em">Shows the current default destination.
88 <dt><b>-h
</b><i>server
</i>[
<b>:
</b><i>port
</i>]
89 <dd style=
"margin-left: 5.0em">Specifies an alternate server.
91 <dd style=
"margin-left: 5.0em">Shows a long listing of printers, classes, or jobs.
92 <dt><b>-o
</b>[
<i>destination(s)
</i>]
93 <dd style=
"margin-left: 5.0em">Shows the jobs queued on the specified destinations.
94 If no destinations are specified all jobs are shown.
95 <dt><b>-p
</b>[
<i>printer(s)
</i>]
96 <dd style=
"margin-left: 5.0em">Shows the printers and whether they are enabled for printing.
97 If no printers are specified then all printers are listed.
99 <dd style=
"margin-left: 5.0em">Shows whether the CUPS server is running.
101 <dd style=
"margin-left: 5.0em">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.
102 This is equivalent to using the
<i>-d
</i>,
<i>-c
</i>, and
<i>-v
</i> options.
104 <dd style=
"margin-left: 5.0em">Shows all status information.
105 This is equivalent to using the
<i>-r
</i>,
<i>-d
</i>,
<i>-c
</i>,
<i>-v
</i>,
<i>-a
</i>,
<i>-p
</i>, and
<i>-o
</i> options.
106 <dt><b>-u
</b>[
<i>user(s)
</i>]
107 <dd style=
"margin-left: 5.0em">Shows a list of print jobs queued by the specified users.
108 If no users are specified, lists the jobs queued by the current user.
109 <dt><b>-v
</b>[
<i>printer(s)
</i>]
110 <dd style=
"margin-left: 5.0em">Shows the printers and what device they are attached to.
111 If no printers are specified then all printers are listed.
113 <h2 class=
"title"><a name=
"CONFORMING_TO">Conforming To
</a></h2>
114 Unlike the System V printing system, CUPS allows printer names to contain any printable character except SPACE, TAB,
"/", and
"#".
115 Also, printer and class names are
<i>not
</i> case-sensitive.
116 <p>The
<i>-h
</i>,
<i>-E
</i>,
<i>-U
</i>, and
<i>-W
</i> options are unique to CUPS.
117 <p>The Solaris
<i>-f
</i>,
<i>-P
</i>, and
<i>-S
</i> options are silently ignored.
118 <h2 class=
"title"><a name=
"SEE_ALSO">See Also
</a></h2>
119 <a href=
"man-cancel.html?TOPIC=Man+Pages"><b>cancel
</b>(
1),
</a>
120 <a href=
"man-lp.html?TOPIC=Man+Pages"><b>lp
</b>(
1),
</a>
121 <a href=
"man-lpq.html?TOPIC=Man+Pages"><b>lpq
</b>(
1),
</a>
122 <a href=
"man-lpr.html?TOPIC=Man+Pages"><b>lpr
</b>(
1),
</a>
123 <a href=
"man-lprm.html?TOPIC=Man+Pages"><b>lprm
</b>(
1),
</a>
124 CUPS Online Help (
<a href=
"http://localhost:631/help">http://localhost:
631/help
</a>)
125 <h2 class=
"title"><a name=
"COPYRIGHT">Copyright
</a></h2>
126 Copyright
© 2007-
2016 by Apple Inc.