# lpstat

## NAME



           lpstat - print cups status information
    


## SYNOPSIS



           **lpstat**[ **-h** _hostname_[**:**_port_] ] [ **-E**] [ **-H**] [ **-U** _username_ ] [ **-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)_ ] ]
    


## DESCRIPTION



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


## OPTIONS



           The **lpstat** command supports the following options:
    
           **-E** Forces encryption when connecting to the server.
    
           **-H** Shows the server hostname and port.
    
           **-R** Shows the ranking of print jobs.
    
           **-U** _username_
                Specifies an alternate username.
    
           **-W** _which-jobs_
                Specifies which jobs to show, "all, "successful", "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 the scheduler.
    
           **-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, either the
                lpoptions(1) default (if set) or the scheduler default
                (otherwise).
    
           **-e** Shows all available destinations on the local network.
    
           **-h** _server_[**:**_port_]
                Specifies an alternate server.  Note: This option must occur
                before all others.
    
           **-l** 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.
    
           **-r** Shows whether the CUPS server is running.
    
           **-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 _-v_ options.
    
           **-t** Shows all status information.  This is equivalent to using
                the _-r_ , _-d_ , _-c_ , _-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.
    


## ENVIRONMENT



           The following environment variables override the default
           destination:
    
           **LPDEST**
                Specifies the default print queue (System V standard).
    
           **PRINTER**
                Specifies the default print queue (Berkeley standard).
    


## CONFORMING TO



           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_ case-sensitive.
    
           The _-h_ , _-e_ , _-E_ , _-U_ , and _-W_ options are unique to CUPS.
    
           The Solaris _-f_ , _-P_ , and _-S_ options are silently ignored.
    


* * *