lpstat

print cups status information

lpstat [-E] [-H] [-U [username] [-h hostname[:port]] [-l] [-W which-jobs] [-a [ destination(s)]] [-c [ class(es)]] [-d] [-e] [-o[destination(s)] ] [-p[printer(s)] ] [-r] [-R] [-s] [-t] [-u [ user(s) ] ] [-v[printer(s)]]

Displays status information about the current classes, jobs, and printers.

With no arguments, lists active jobs queued by the current user.

-s 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 -d, -c, and -v .
-l long listing of printers, classes, or jobs.
-d current default destination.
-c [class(es)] printer classes and the printers that belong to them.
-v [printer(s)] printers and what device they are attached to. If no printers are specified then all printers are listed.
-t all status information. This is equivalent to using the -r, -d, -c, -v, -a, -p, and -o options.
>  lpstat -t
scheduler is running
system default destination: Photosmart_7520_series
device for Photosmart_7520_series: 
     dnssd://Photosmart%207520%20series%20%5BC658CA%5D._ipp._tcp.local./?uuid=1c8…
Photosmart_7520_series accepting requests since Wed Nov 29 19:09:38 2023
printer Photosmart_7520_series is idle.  enabled since Wed Nov 29 19:09:38 2023

-r whether the CUPS server is running.
-a [printer(s)] accepting state of printer queues.
-p [printer(s)] printers and whether they are enabled for printing.
-W which-jobs Specifies which jobs to show, completed or not-completed or all (NO default).
Must appear before -o and/or any printer names.
> lpstat -W completed
Photosmart_7520_series-64 dgerman          10240   Wed Nov 29 19:09:38 2023
Photosmart_7520_series-63 dgerman         136192   Mon Nov 20 15:34:23 2023
Photosmart_7520_series-62 dgerman           4096   Sun Nov 19 13:19:36 2023
Photosmart_7520_series-61 dgerman          29696   Sat Oct 28 20:56:57 2023
Photosmart_7520_series-60 dgerman         375808   Wed Oct 25 13:06:13 2023
… 
-o [destination(s)] jobs queued on the specified destinations.
-u [user(s)] Shows a list of print jobs queued by the specified users. If no users are specified, lists the jobs queued by the current user.
-e all available destinations on the local network.
Photosmart_7520_series
-h server[:port] Specifies an alternate server.
-H server hostname and port.
/private/var/run/cupsd
-R ranking of print jobs.
-E Forces encryption when connecting to the server.
-U username Specifies an alternate username.

Banner pages


lprm

remove jobs

lprm [ -E ] [ -U username ] [ -h server[:port] ] [ -P destination[/instance] ] [ - ] [ job-id(s) … ] jobs that have been queued for printing. Default :the current job on the default destination

- all jobs!

-P destination[/instance] destination printer or class.
-U username alternate username.
-h server[:port] alternate server.
-E Forces encryption when connecting to the server.

EXAMPLES

Cancel the current job on the default printer: lprm

Cancel job 1234: lprm 1234

Cancel all jobs: lprm -

> lprm
lprm: No active jobs on Photosmart_7520_series.

>lprm - no response
>

SEE ALSO cancel(1), lp(1), lpq(1), lpr(1), lprm(1),

CUPS Online Help (http://localhost:631/help) Web Interface is Disabled
The web interface is currently disabled. Run “cupsctl WebInterface=yes” to enable it