unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

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  informa-
       tion  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 omit-
                               ted. Specify  printer  and  class  names  using
                               atomic   or   POSIX-style  (server:destination)
                               names. See standards(5) for information regard-
                               ing 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  sta-
                               tus 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  network 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  accept-
                               ing  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 rec-
                               ognized 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 omit-
                               ted.



       -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 sta-
                               tus 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 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
       /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:


       tab()     allbox;     cw(2.750000i)|    cw(2.750000i)    lw(2.750000i)|
       lw(2.750000i).  ATTRIBUTE TYPEATTRIBUTE VALUE AvailabilitySUNWpcu


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



SunOS 5.10                        23 May 2003                        lpstat(1)