217 lines
5.0 KiB
HTML
217 lines
5.0 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of lpstat</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>lpstat</H1>
|
|
Section: Apple Inc. (1)<BR>Updated: CUPS<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
lpstat - print cups status information
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>lpstat</B>
|
|
|
|
[
|
|
<B>-E</B>
|
|
|
|
] [
|
|
<B>-H</B>
|
|
|
|
] [
|
|
<B>-U</B>
|
|
|
|
<I>username</I>
|
|
|
|
] [
|
|
<B>-h </B><I>hostname</I>[<B>:</B><I>port</I>]
|
|
] [
|
|
<B>-l</B>
|
|
|
|
] [
|
|
<B>-W</B>
|
|
|
|
<I>which-jobs</I>
|
|
|
|
] [
|
|
<B>-a</B>
|
|
|
|
[
|
|
<I>destination(s)</I>
|
|
|
|
] ] [
|
|
<B>-c</B>
|
|
|
|
[
|
|
<I>class(es)</I>
|
|
|
|
] ] [
|
|
<B>-d</B>
|
|
|
|
] [
|
|
<B>-e</B>
|
|
|
|
] [
|
|
<B>-o</B>
|
|
|
|
[
|
|
<I>destination(s)</I>
|
|
|
|
] ] [
|
|
<B>-p</B>
|
|
|
|
[
|
|
<I>printer(s)</I>
|
|
|
|
] ] [
|
|
<B>-r</B>
|
|
|
|
] [
|
|
<B>-R</B>
|
|
|
|
] [
|
|
<B>-s</B>
|
|
|
|
] [
|
|
<B>-t</B>
|
|
|
|
] [
|
|
<B>-u</B>
|
|
|
|
[
|
|
<I>user(s)</I>
|
|
|
|
] ] [
|
|
<B>-v</B>
|
|
|
|
[
|
|
<I>printer(s)</I>
|
|
|
|
] ]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>lpstat</B> displays status information about the current classes, jobs, and printers.
|
|
When run with no arguments, <B>lpstat</B> will list active jobs queued by the current user.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
The <B>lpstat</B> command supports the following options:
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-E</B>
|
|
|
|
<DD>
|
|
Forces encryption when connecting to the server.
|
|
<DT id="2"><B>-H</B>
|
|
|
|
<DD>
|
|
Shows the server hostname and port.
|
|
<DT id="3"><B>-R</B>
|
|
|
|
<DD>
|
|
Shows the ranking of print jobs.
|
|
<DT id="4"><B>-U </B><I>username</I><DD>
|
|
Specifies an alternate username.
|
|
<DT id="5"><B>-W </B><I>which-jobs</I><DD>
|
|
Specifies which jobs to show, "completed" or "not-completed" (the default).
|
|
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.
|
|
<DT id="6"><B>-a </B>[<I>printer(s)</I>]<DD>
|
|
Shows the accepting state of printer queues.
|
|
If no printers are specified then all printers are listed.
|
|
<DT id="7"><B>-c </B>[<I>class(es)</I>]<DD>
|
|
Shows the printer classes and the printers that belong to them.
|
|
If no classes are specified then all classes are listed.
|
|
<DT id="8"><B>-d</B>
|
|
|
|
<DD>
|
|
Shows the current default destination.
|
|
<DT id="9"><B>-e</B>
|
|
|
|
<DD>
|
|
Shows all available destinations on the local network.
|
|
<DT id="10"><B>-h </B><I>server</I>[<B>:</B><I>port</I>]<DD>
|
|
Specifies an alternate server.
|
|
<DT id="11"><B>-l</B>
|
|
|
|
<DD>
|
|
Shows a long listing of printers, classes, or jobs.
|
|
<DT id="12"><B>-o </B>[<I>destination(s)</I>]<DD>
|
|
Shows the jobs queued on the specified destinations.
|
|
If no destinations are specified all jobs are shown.
|
|
<DT id="13"><B>-p </B>[<I>printer(s)</I>]<DD>
|
|
Shows the printers and whether they are enabled for printing.
|
|
If no printers are specified then all printers are listed.
|
|
<DT id="14"><B>-r</B>
|
|
|
|
<DD>
|
|
Shows whether the CUPS server is running.
|
|
<DT id="15"><B>-s</B>
|
|
|
|
<DD>
|
|
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.
|
|
This is equivalent to using the <I>-d</I>, <I>-c</I>, and <I>-v</I> options.
|
|
<DT id="16"><B>-t</B>
|
|
|
|
<DD>
|
|
Shows all status information.
|
|
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.
|
|
<DT id="17"><B>-u </B>[<I>user(s)</I>]<DD>
|
|
Shows a list of print jobs queued by the specified users.
|
|
If no users are specified, lists the jobs queued by the current user.
|
|
<DT id="18"><B>-v </B>[<I>printer(s)</I>]<DD>
|
|
Shows the printers and what device they are attached to.
|
|
If no printers are specified then all printers are listed.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>CONFORMING TO</H2>
|
|
|
|
Unlike the System V printing system, CUPS allows printer names to contain any printable character except SPACE, TAB, "/", and "#".
|
|
Also, printer and class names are <I>not</I> case-sensitive.
|
|
<P>
|
|
|
|
The <I>-h</I>, <I>-e</I>, <I>-E</I>, <I>-U</I>, and <I>-W</I> options are unique to CUPS.
|
|
<P>
|
|
|
|
The Solaris <I>-f</I>, <I>-P</I>, and <I>-S</I> options are silently ignored.
|
|
<A NAME="lbAG"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+cancel">cancel</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+lp">lp</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+lpq">lpq</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+lpr">lpr</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+lprm">lprm</A></B>(1),
|
|
|
|
CUPS Online Help (<A HREF="http://localhost:631/help)">http://localhost:631/help)</A>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>COPYRIGHT</H2>
|
|
|
|
Copyright © 2007-2019 by Apple Inc.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="19"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="20"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="21"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="22"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="23"><A HREF="#lbAF">CONFORMING TO</A><DD>
|
|
<DT id="24"><A HREF="#lbAG">SEE ALSO</A><DD>
|
|
<DT id="25"><A HREF="#lbAH">COPYRIGHT</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:18 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|