lpstat(1)                                                          User Commands                                                         lpstat(1)

NAME

       lpstat - print information about the status of the print service

SYNOPSIS

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

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 may appear in any
       order and may be repeated and intermixed with other arguments. Some key letters may 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 com-
       mand:

       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 on all platforms.

       -d                      Prints the default destination for output requests.

       -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 may be omitted. Specify printer and class names  using  atomic  or  POSIX-style  (server:destination)
                               names. See standards(5) for information regarding POSIX.

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

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

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

                               login-ID

                                   a user on any system

                               system_name!login-ID

                                   a user on system 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 net-
                               work printers. list is a list of printer names.

       The following options return accurate results only if they are issued from a Solaris 2.6 Operating Environment or compatible version of the
       LP print server.

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

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

       -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 will list the form descriptions.

       -p [list] [-D] [-l]     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 content and
                               printer types, a printer description, and the interface used.

       -S [list] [-l]          Prints a verification that the character sets or the print wheels specified in list are recognized by the LP  print
                               service.  Items in list can be character 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.

       -d                      Prints the default destination for output requests.

       -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 may be omitted.

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

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

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

                               login-ID

                                   a user on any system

                               system_name!login-ID

                                   a user on system 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 net-
                               work 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

       /var/spool/print/*              LP print queue.

       $HOME/.printers                 User-configurable printer database.

       /etc/printers.conf              System configuration database.

       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 attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE         |      ATTRIBUTE VALUE        |
       +-----------------------------+-----------------------------+
       |Availability                 |SUNWpcu                      |
       +-----------------------------+-----------------------------+

SEE ALSO

       cancel(1), lp(1), lpq(1B), lpr(1B), lprm(1B), nsswitch.conf(4), printers( 4), printers.conf(4), attributes(5), standards(5)

SunOS 5.10                                                          23 May 2003                                                          lpstat(1)