lpstat - print cups status information
] [ -H
] [ -U username
] [ -h
] ] [ -l
] [ -W
] [ -a
] ] [ -c
] ] [ -d
] [ -e
] [ -o
] ] [ -p
] ] [ -r
] [ -s
] [ -t
] [ -u
] ] [
displays status information about the current classes, jobs, and
printers. When run with no arguments, lpstat
will list active jobs
queued by the current user.
command supports the following options:
- Forces encryption when connecting to the server.
- Shows the server hostname and port.
- Shows the ranking of print jobs.
- -U username
- Specifies an alternate username.
- -W which-jobs
- Specifies which jobs to show, "completed" or
"not-completed" (the default). This option must appear
before the -o option and/or any printer names, otherwise the
default ("not-completed") value will be used in the request to
- -a [printer(s)]
- Shows the accepting state of printer queues. If no printers are specified
then all printers are listed.
- -c [class(es)]
- Shows the printer classes and the printers that belong to them. If no
classes are specified then all classes are listed.
- Shows the current default destination.
- Shows all available destinations on the local network.
- -h server[:port]
- Specifies an alternate server.
- Shows a long listing of printers, classes, or jobs.
- -o [destination(s)]
- Shows the jobs queued on the specified destinations. If no destinations
are specified all jobs are shown.
- -p [printer(s)]
- Shows the printers and whether they are enabled for printing. If no
printers are specified then all printers are listed.
- Shows whether the CUPS server is running.
- 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 -d, -c,
and -v options.
- Shows all status information. This is equivalent to using the -r,
-d, -c, -v, -a, -p, and -o
- -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.
- -v [printer(s)]
- Shows the printers and what device they are attached to. If no printers
are specified then all printers are listed.
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 not
, and -W
options are unique
The Solaris -f
, and -S
options are silently ignored.
CUPS Online Help (http://localhost:631/help)
Copyright © 2007-2017 by Apple Inc.