Manual Pages for UNIX Operating System command usage for man lpq

SunOS/BSD Compatibility Package Commands                  lpq(1B)



NAME
     lpq - display the contents of a print queue

SYNOPSIS
     /usr/ucb/lpq [-P destination] [-l] [+ [interval]]
          [request-ID...] [user]...


DESCRIPTION
     The lpq utility displays the information about the  contents
     of  a  print  queue.  A  print  queue  is comprised of print
     requests that are waiting  in the process of being printed.


     lpq displays the following information to the standard  out-
     put:

         o    the username of the person associated with a  print
              request,

         o    the position of a print request in the print queue,

         o    the name  of  file  or  files  comprising  a  print
              request,

         o    the job number of a print request, and

         o    the size of the file requested by a print  request.
              File size is reported in bytes.


     Normally, only as much information as will fit on  one  line
     is  displayed. If the name of the input file associated with
     a print request is not available, the input file field indi-
     cates the standard input.


     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:

     -l                Displays information in long format.  Long
                       format  includes the name of the host from
                       which a print request  originated  in  the
                       display.






SunOS 5.11          Last change: 10 Dec 2009                    1






SunOS/BSD Compatibility Package Commands                  lpq(1B)



     -P destination    Displays  information  about  printer   or
                       class  of  printers  (see  lpadmin(1M))  .
                       Specify  destination  using  atomic,  URI-
                       style  (scheme://endpoint), or POSIX-style
                       (server:destination)      names.       See
                       printers.conf(4) for information regarding
                       destination names.


     + [interval]      Displays  information  at  specific   time
                       intervals.  Stops  displaying  information
                       when the print queue is empty. Clears  the
                       screen  before  reporting  displaying  the
                       print  queue.  Specify  interval  as   the
                       number  of  seconds  between  displays. If
                       interval is not  specified  only  executes
                       once.


OPERANDS
     The following operands are supported:

     request-ID    The  job  number  associated  with   a   print
                   request.


     user          The name of the user  about  whose  jobs   lpq
                   reports  information.  Specify user as a valid
                   username.


EXIT STATUS
     The following exit values are returned:

     0           Successful completion.


     non-zero    An error occurred.


FILES
     $HOME/.printers         User-configurable printer database


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


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






SunOS 5.11          Last change: 10 Dec 2009                    2






SunOS/BSD Compatibility Package Commands                  lpq(1B)



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


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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWlpr-cmds                |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | Standard                    | See standards(5).           |
    |_____________________________|_____________________________|


SEE ALSO
     lp(1), lpc(1B), lpr(1B), lprm(1B),  lpstat(1),  lpadmin(1M),
     nsswitch.conf(4),   printers(4),   printers.conf(4),  attri-
     butes(5), standards(5)

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


























SunOS 5.11          Last change: 10 Dec 2009                    3