]>
Commit | Line | Data |
---|---|---|
c277f98c | 1 | <!DOCTYPE HTML> |
94436c5a MS |
2 | <html> |
3 | <!-- SECTION: Man Pages --> | |
4 | <head> | |
5 | <link rel="stylesheet" type="text/css" href="../cups-printable.css"> | |
6 | <title>lpstat(1)</title> | |
7 | </head> | |
8 | <body> | |
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> | |
c277f98c MS |
13 | <b>lpstat</b> |
14 | [ -E ] [ -H ] [ -U | |
15 | <i>username</i> | |
16 | ] [ -h | |
17 | <i>hostname[:port]</i> | |
18 | ] [ -l ] [ -W | |
19 | <i>which-jobs</i> | |
20 | ] [ -a [ | |
21 | <i>destination(s)</i> | |
22 | ] ] [ -c [ | |
23 | <i>class(es)</i> | |
24 | ] ] [ -d ] [ -o [ | |
25 | <i>destination(s)</i> | |
26 | ] ] [ -p [ | |
27 | <i>printer(s)</i> | |
28 | ] ] [ -r ] [ -R ] [ -s ] [ -t ] [ -u [ | |
29 | <i>user(s)</i> | |
30 | ] ] [ -v [ | |
31 | <i>printer(s)</i> | |
32 | ] ] | |
94436c5a MS |
33 | <h2 class="title"><a name="DESCRIPTION">Description</a></h2> |
34 | <i>lpstat</i> displays status information about the current | |
35 | classes, jobs, and printers. When run with no arguments, | |
36 | <i>lpstat</i> will list jobs queued by the current user. | |
37 | <h2 class="title"><a name="OPTIONS">Options</a></h2> | |
38 | The <i>lpstat</i> command supports the following options: | |
c277f98c MS |
39 | <p style="margin-left: 5.0em; text-indent: -5.0em">-E |
40 | <br> | |
41 | <br> | |
42 | Forces encryption when connecting to the server. | |
43 | <p style="margin-left: 5.0em; text-indent: -5.0em">-H | |
44 | <br> | |
45 | <br> | |
46 | Shows the server hostname and port. | |
47 | <p style="margin-left: 5.0em; text-indent: -5.0em">-R | |
48 | <br> | |
49 | <br> | |
50 | Shows the ranking of print jobs. | |
51 | <p style="margin-left: 5.0em; text-indent: -5.0em">-U username | |
52 | <br> | |
53 | <br> | |
54 | Specifies an alternate username. | |
55 | <p style="margin-left: 5.0em; text-indent: -5.0em">-W which-jobs | |
56 | <br> | |
57 | <br> | |
58 | Specifies which jobs to show, <i>completed</i> or | |
94436c5a MS |
59 | <i>not-completed</i> (the default). This option <i>must</i> appear |
60 | before the <i>-o</i> option and/or any printer names, otherwise | |
61 | the default (not-completed) value will be used in the request to | |
62 | the scheduler. | |
c277f98c MS |
63 | <p style="margin-left: 5.0em; text-indent: -5.0em">-a [printer(s)] |
64 | <br> | |
65 | <br> | |
66 | Shows the accepting state of printer queues. If no printers are | |
94436c5a | 67 | specified then all printers are listed. |
c277f98c MS |
68 | <p style="margin-left: 5.0em; text-indent: -5.0em">-c [class(es)] |
69 | <br> | |
70 | <br> | |
71 | Shows the printer classes and the printers that belong to them. | |
94436c5a | 72 | If no classes are specified then all classes are listed. |
c277f98c MS |
73 | <p style="margin-left: 5.0em; text-indent: -5.0em">-d |
74 | <br> | |
75 | <br> | |
76 | Shows the current default destination. | |
77 | <p style="margin-left: 5.0em; text-indent: -5.0em">-h server[:port] | |
78 | <br> | |
79 | <br> | |
80 | Specifies an alternate server. | |
81 | <p style="margin-left: 5.0em; text-indent: -5.0em">-l | |
82 | <br> | |
83 | <br> | |
84 | Shows a long listing of printers, classes, or jobs. | |
85 | <p style="margin-left: 5.0em; text-indent: -5.0em">-o [destination(s)] | |
86 | <br> | |
87 | <br> | |
88 | Shows the jobs queue on the specified destinations. If no destinations are | |
94436c5a | 89 | specified all jobs are shown. |
c277f98c MS |
90 | <p style="margin-left: 5.0em; text-indent: -5.0em">-p [printer(s)] |
91 | <br> | |
92 | <br> | |
93 | Shows the printers and whether or not they are enabled for printing. If | |
94436c5a | 94 | no printers are specified then all printers are listed. |
c277f98c MS |
95 | <p style="margin-left: 5.0em; text-indent: -5.0em">-r |
96 | <br> | |
97 | <br> | |
98 | Shows whether the CUPS server is running. | |
99 | <p style="margin-left: 5.0em; text-indent: -5.0em">-s | |
100 | <br> | |
101 | <br> | |
102 | Shows a status summary, including the default destination, a | |
94436c5a MS |
103 | list of classes and their member printers, and a list of printers and |
104 | their associated devices. This is equivalent to using the "-d", "-c", | |
105 | and "-v" options. | |
c277f98c MS |
106 | <p style="margin-left: 5.0em; text-indent: -5.0em">-t |
107 | <br> | |
108 | <br> | |
109 | Shows all status information. This is equivalent to using the "-r", | |
94436c5a | 110 | "-d", "-c", "-v", "-a", "-p", and "-o" options. |
c277f98c MS |
111 | <p style="margin-left: 5.0em; text-indent: -5.0em">-u [user(s)] |
112 | <br> | |
113 | <br> | |
114 | Shows a list of print jobs queued by the specified users. If no users | |
94436c5a | 115 | are specified, lists the jobs queued by the current user. |
c277f98c MS |
116 | <p style="margin-left: 5.0em; text-indent: -5.0em">-v [printer(s)] |
117 | <br> | |
118 | <br> | |
119 | Shows the printers and what device they are attached to. If no printers | |
94436c5a | 120 | are specified then all printers are listed. |
94436c5a MS |
121 | <h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2> |
122 | Unlike the System V printing system, CUPS allows printer names to | |
123 | contain any printable character except SPACE, TAB, "/", and "#". | |
124 | Also, printer and class names are <i>not</i> case-sensitive. | |
125 | <p>The "-h", "-E", "-U", and "-W" options are unique to CUPS. | |
126 | <p>The Solaris "-f", "-P", and "-S" options are silently ignored. | |
127 | <h2 class="title"><a name="SEE_ALSO">See Also</a></h2> | |
c277f98c | 128 | <i>cancel(1)</i>, <i>lp(1)</i>, |
94436c5a | 129 | <br> |
c277f98c | 130 | <a href="http://localhost:631/help">http://localhost:631/help</a> |
94436c5a MS |
131 | <h2 class="title"><a name="COPYRIGHT">Copyright</a></h2> |
132 | Copyright 2007-2013 by Apple Inc. | |
133 | ||
134 | </body> | |
135 | </html> |