Provided by: lprng_3.8.B-2_amd64 bug

NAME

       lpq - spool queue examination program

SYNOPSIS

       lpq  [-a]  [-A] [-l] [-L] [-V] [-c] [-v] [-P  printer] [-s] [-t  sleeptime] [-D  debugopt]
       [jobid...]

DESCRIPTION

       lpq requests a status report from lpd(8) on the specified printers or jobs.   lpq  invoked
       without any arguments reports on the printer given by the default printer (see -P option).
       The short (default) format simply lists the printer, host, and  numbers  of  jobs  in  the
       spool  queue.   When  using the long format (-l option), for each job in a spool queue lpq
       reports the job identifier which is generated from the user's name and  originating  host,
       current rank in the queue, the job number (which may be supplied to lprm(1) for removing a
       specific job), the job description information, and the total size in bytes.  If there  is
       an  error  or  other problem with the job, this information may be modified to reflect the
       problems.  In a spool queue, Job ordering  is  a  modified  FIFO  (First  in  First  Out),
       modified by the job class and priority information.

       The following options are available.

       -A     Use authentication specified by the value of the AUTH environment variable.

       -D debugoptions
              Debugging is controlled using the -D option. This accepts a comma-separated list of
              debugging settings. These settings take one of two forms: facility=value , or value
              to set an overall default value.

       -P printer
              By  default,  the destination printer is taken from the command line printer value,
              then the environment variables PRINTER, LPDEST,  NPRINTER,  NGPRINTER,  then  first
              entry  in  the printcap information, and and finally the default_printer entry from
              the configuration file, and then the compile time default.

       -V     Print version information.

       -v     Dump lpd related information.

       -c     Clear Screen before output, very usefull with -t

       -a     List status for all printers (see PRINTER LISTS below) which have entries  for  the
              LPRng client programs in the printcap(5) database.

       -l     Increase verbosity of the long display format.  A single -l options selects a short
              verbose display, multiple -l options increase the verbosity.

       -L     Use maximum verbosity for the long display format.

       -s     Display a short, single line status summary for each queue and subqueue.

       -t sleeptime
              Forces lpq to periodically display  the  spool  queues  and  then  sleep  sleeptime
              seconds between scans of the queue.

       jobid ... all
              The  options  are  followed  by  a  list of jobids which are used to select jobs of
              interest.  A jobid can be a user name, a job identifier, a job number,  or  a  glob
              based  pattern  which will be applied to the job identifiers.  The all keyword will
              display all jobs and is the default option.

       The lpq will report the status of the spool queue  (enabled  for  spooling,  disabled  for
       unspooling), and the absence of a server if unspooling is enabled.  The lpc(1) command lpc
       start <printer> may be used to start the server if this is the case.

ENVIRONMENT

       By default, the destination printer is taken from the command line dest  value,  then  the
       environment  variables  PRINTER,  LPDEST,  NPRINTER,  NGPRINTER,  then  first entry in the
       printcap information, and and finally the default_printer  entry  from  the  configuration
       file, and then the compile time default.

PRINTER LISTS

       The  -a  option  is  used to by lpq(1) to get status for a list of printers.  This list is
       formed as follows.

       1)     The printcap file is scanned for printer entries.  Only entries with names starting
              with a letter or digit are recognized as valid queue or printer names.

       2)     If    the    special    entry    all    is    present,   and   it   has   a   field
              :all=pr1@host1,pr2@host2,...  then the printers pr1, pr2,  ...   are  used  as  the
              printer or queue list.

       3)     If  there  is  no all entry, then the original list of printers found in step 1) is
              used as the list of printers.

       The special case of lpq -Pall disables the searching of the printcap database, and  simply
       sends  a  query to the lpd server for status of printer all.  The lpd(8) server enumerates
       the printers in its printcap file, ignoring any all entry, and  returns  status  only  for
       printers which have entries in the lpd(8) server printcap file.

       Finally, the special case lpq -Ppr@host causes lpq(1) to send a status request for printer
       pr to host host.

       Here is a simple set of rules to use:
       Client:
        pr1:lp=%P@server
        pr2:lp=%P@server
         - printer pr1 followed by pr2

       pr1:lp=%P@server
       pr2:lp=%P@server
       all:all=pr2,pr1
         - printer pr2 followed by pr1 (all overrides)

       Client:
        pr1:lp=%P@server
        pr2:lp=%P@server
       Server:
        lp:lp=...
         lpq -Pall
           - status returned only for printer 'lp'

EXIT STATUS

       The following exit values are returned:

       zero (0)       Successful completion.

       non-zero (!=0) An error occurred.

PRINTCAP INFORMATION

       The printer names and other information is obtained by using a printcap file or some other
       database.   The  ${HOME}/.printcap  file  can  be  used  to specify user level options and
       configuration information.  See printcap(5) for more information.

FILES

       The files used by LPRng are  set  by  values  in  the  printer  configuration  file.   The
       following are a commonly used set of default values.
       /etc/lprng/lpd.conf                          LPRng configuration file
       ${HOME}/.printcap                            user printer description file
       /etc/printcap                                printer description file
       /etc/lprng/lpd.perms                         permissions
       /var/run/lprng/lpd                           lock file for queue control
       /var/spool/lpd                               spool directories
       /var/spool/lpd/QUEUE/control                 queue control
       /var/spool/lpd/QUEUE/log                     trace or debug log file
       /var/spool/lpd/QUEUE/acct                    accounting file
       /var/spool/lpd/QUEUE/status                  status file

SEE ALSO

       lpd.conf(5),  lpc(8),  lpd(8),  checkpc(8),  lpr(1),  lprm(1),  printcap(5), lpd.perms(5),
       pr(1).

AUTHOR

       Patrick Powell <papowell@lprng.com>.

DIAGNOSTICS

       Most of the diagnostics are self explanatory.  If you are puzzled over the exact cause  of
       failure,  set  the debugging level on (-D5) and run again.  The debugging information will
       help you to pinpoint the exact cause of failure.

HISTORY

       LPRng is a enhanced printer spooler system with functionality similar to the Berkeley  LPR
       software.    The   LPRng  developer  mailing  list  is  lprng-devel@lists.sourceforge.net;
       subscribe by visiting https://lists.sourceforge.net/lists/listinfo/lprng-devel or  sending
       mail to lprng-request@lists.sourceforge.net with the word subscribe in the body.
       The software is available via http://lprng.sourceforge.net