Online Man Page

This form may be used to access the UNIX man pages. Note this form runs on a Solaris machine, so the results may disagree with other operating system implementations of the commands.

Topic:     Section:   Keyword search:

NAME

     lpq - display the content 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.

     -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

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

     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         | Standard                    |
    |_____________________________|_____________________________|

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.