Linux / Unix Command: lpstat

Command Library

NAME

lpstat - print cups status information  

SYNOPSIS

lpstat [ -E ] [ -a [ destination(s) ] ] [ -c [ class(es) ] [ -d ] [ -h server ] [ -l ] [ -o [ destination(s) ] ] [ -p [ printer(s) ] ] [ -r ] [ -R ] [ -s ] [ -t ] [ -u [ user(s) ] ] [ -v [ printer(s) ] [ -W [ which-jobs ] ]  

DESCRIPTION

lpstat displays status information about the current classes, jobs, and printers. When run with no arguments, lpstat will list jobs queued by the user. Other options include:

-E

Forces encryption when connecting to the server.

-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.

-d

Shows the current default destination.

-h server

Specifies the CUPS server to communicate with.

-l

Shows a long listing of printers, classes, or jobs.

-o [destination(s)]

Shows the jobs queue on the specified destinations. If no destinations are specified all jobs are shown.

-p [printer(s)]

Shows the printers and whether or not they are enabled for printing. If no printers are specified then all printers are listed.

-r

Shows whether or not the CUPS server is running.

-R

Shows the ranking of print jobs.

-s

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 "-p" options.

-t

Shows all status information. This is equivalent to using the "-r", "-d", "-c", "-d", "-v", "-a", "-p", and "-o" options.

-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.

-W [which-jobs]

Specifies which jobs to show, completed or not-completed (the default).

 

SEE ALSO

cancel(1), lp(1), CUPS Software Users Manual  

---

Important: Use the man command (% man) to see how a command is used on your particular computer.

>> Linux/Unix Command Library

>> Shell Command Library