Unix‎ > ‎Solaris‎ > ‎Solaris man pages‎ > ‎1‎ > ‎

lpstat


NAME
     lpstat - print information about the  status  of  the  print
     service

SYNOPSIS
     lpstat [-d] [-r] [-R] [-s] [-t] [-a [list]] [-c [list]]
         [-f [list]] [-o [list]] [-p [list] [-D]] [-S [list]]
         [-u [login- ID -list]] [-v [list]] [-l level]


DESCRIPTION
     The lpstat utility displays information  about  the  current
     status of the LP print service to standard output.


     If no options are given, lpstat prints the status of all the
     user's  print  requests made by lp. See lp(1). Any arguments
     that are not  options  are  assumed  to  be  request-IDs  as
     returned by lp. The lpstat command prints the status of such
     requests. options appears in any order and can  be  repeated
     and intermixed with other arguments. Some key letters can be
     followed by an optional list that  can  be  in  one  of  two
     forms:  a  list  of  items  separated  from one another by a
     comma, or a list of items  separated  from  one  another  by
     spaces enclosed in quotes. For example:

       example% lpstat -u "user1 user2 user3"




     Specifying all after any key letter that takes  list  as  an
     argument  causes  all information relevant to the key letter
     to be printed. For example, the command:

       example% lpstat -o all




     prints the status of all output requests.


     The omission of a list following such key letters causes all
     information  relevant  to  the key letter to be printed. For
     example, the command:

       example% lpstat -o




     prints the status of all output requests.


     The print client  commands  locate  destination  information
     using  the  "printers"  database in the name service switch.
     See nsswitch.conf(4), printers(4), and printers.conf(4)  for
     details.

OPTIONS
     The following options are supported:

     -a [list]             Reports whether print destinations are
                           accepting  requests. list is a list of
                           intermixed  printer  names  and  class
                           names.

                           If the print queue is remote  and  IPP
                           is in use, the information provided is
                           very close to that reported for  local
                           queues.  If  the print queue is remote
                           and IPP  is  not  in  use  (the  print
                           server is older than Solaris 9, Update
                           6 or another RFC-1179-based print ser-
                           vice), this option does not report any
                           useful information.


     -c [list]             Prints name of all classes  and  their
                           members.  list  is  a  list  of  class
                           names.

                           If the print queue is remote  and  IPP
                           is in use, the information provided is
                           very close to that reported for  local
                           queues.  If  the print queue is remote
                           and IPP  is  not  in  use  (the  print
                           server is older than Solaris 9, Update
                           6 or another RFC-1179-based print ser-
                           vice), this option does not report any
                           useful information.


     -d                    Prints  the  default  destination  for
                           output requests.


     -f[list] [-l]         Prints a verification that  the  forms
                           in list are recognized by the LP print
                           service. list is a list of forms;  the
                           default  is  all.  The -l option lists
                           the form descriptions.

                           If the print queue is remote  and  IPP
                           is in use, the information provided is
                           very close to that reported for  local
                           queues.  If  the print queue is remote
                           and IPP  is  not  in  use  (the  print
                           server is older than Solaris 9, Update
                           6 or another RFC-1179-based print ser-
                           vice), this option does not report any
                           useful information.


     -l [level]             specifies  the  verbosity  level  for
                           extended  reporting  of printer or job
                           objects (-o, -p, -r, -u). Without this
                           option,  a  level  of 0 is used, which
                           reports summary information.  When  no
                           level  is  specified,  a  level of 1is
                           used, which provides more  information
                           about the object. A level of 2 or more
                           enumerates all of the object's  attri-
                           butes.

                           If the print queue is remote  and  IPP
                           is in use, the information provided is
                           very close to that reported for  local
                           queues.  If  the print queue is remote
                           and IPP  is  not  in  use  (the  print
                           server is older than Solaris 9, Update
                           6 or another RFC-1179-based print ser-
                           vice), this option does not report any
                           useful information.


     -o [list]             Prints the status of output  requests.
                           list  is  a list of intermixed printer
                           names, class names,  and  request-IDs.
                           The key letter -o can be omitted.

                           Specify printer and class names  using
                           atomic, URI-style (scheme://endpoint),
                           or  POSIX-style   (server:destination)
                           names.  See  printers.conf(4) for more
                           information.


     -p [list] [-D]        Prints the status of printers. list is
                           a  list  of  printer  names. If the -D
                           option is given, a  brief  description
                           is  printed  for each printer in list.
                           If the -l  option  is  given  and  the
                           printer  is  on  the  local machine, a
                           full  description  of  each  printer's
                           configuration  is  returned, including
                           the form mounted, the acceptable  con-
                           tent  and  printer  types,  a  printer
                           description, and the interface used.


     -r                    Prints the status of  the  LP  request
                           scheduler.


     -R                    Prints a number showing  the  position
                           of each request in the print queue.


     -s                    Prints a status summary, including the
                           status   of   the  LP  scheduler,  the
                           default   destination,   a   list   of
                           printers and their associated devices,
                           a list of the machines  sharing  print
                           services,   a   list   of   all  forms
                           currently mounted, and a list  of  all
                           recognized  character  sets  and print
                           wheels.


     -S [list]             Prints a verification that the charac-
                           ter sets or the print wheels specified
                           in list are recognized by the LP print
                           service.  Items in list can be charac-
                           ter sets or print wheels; the  default
                           for  the list is all. If the -l option
                           is given, each line is appended  by  a
                           list  of  printers that can handle the
                           print wheel or character set. The list
                           also  shows whether the print wheel or
                           character set is mounted, or specifies
                           the  built-in character set into which
                           it maps.

                           If the print queue is remote  and  IPP
                           is in use, the information provided is
                           very close to that reported for  local
                           queues.  If  the print queue is remote
                           and IPP  is  not  in  use  (the  print
                           server is older than Solaris 9, Update
                           6 or another RFC-1179-based print ser-
                           vice), this option does not report any
                           useful information.


     -t                    Prints all  status  information.  This
                           includes  all the information obtained
                           with the -s option,  plus  the  accep-
                           tance  and  idle/busy  status  of  all
                           printers.


     -u [login-ID-list]    Prints the status of  output  requests
                           for  users. The login-ID-list argument
                           can include any or all of the  follow-
                           ing constructs:

                           login-ID                a user on  any
                                                   system


                           system_name!login-ID    a user on sys-
                                                   tem
                                                   system_name


                           system_name!all         all  users  on
                                                   system
                                                   system_name


                           all!login-ID            a user on  all
                                                   systems


                           all                     all  users  on
                                                   all systems



     -v [list]             Prints the names of printers  and  the
                           path  names  of the devices associated
                           with them or remote system  names  for
                           network  printers.  list  is a list of
                           printer names.


EXIT STATUS
     The following exit values are returned:

     0           Successful completion.


     non-zero    An error occurred.


FILES
     /etc/printers.conf      System printer  configuration  data-
                             base

     $HOME/.printers         User-configurable printer database


     ou=printers             LDAP version of /etc/printers.conf


     printers.conf.byname    NIS version of /etc/printers.conf


     printers.org_dir        NIS+ version of /etc/printers.conf


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWlp-cmds                 |
    |_____________________________|_____________________________|
    | Interface Stability         | Standard                    |
    |_____________________________|_____________________________|


SEE ALSO
     cancel(1),    lp(1),     lpq(1B),     lpr(1B),     lprm(1B),
     nsswitch.conf(4),  printers(  4),  printers.conf(4),  attri-
     butes(5), standards(5)

NOTES
     For remote print queues, the BSD print protocol  provides  a
     very limited set of information. The Internet Print Protocol
     (IPP) is preferred.


     When IPP is in use, the user is prompted for a passphrase if
     the  remote print service is configured to require authenti-
     cation.










Man pages from Solaris 10 Update 8. See docs.sun.com and www.oracle.com for further documentation and Solaris information.
Comments