Copyright (C) 2000-2012 |
Manpages LPQSection: User Commands (1)Updated: LPRng-3.9.0 Index Return to Main Contents NAMElpq - spool queue examination programSYNOPSISlpq [ -a ] [ -A ] [ -l ] [ -L ] [ -P printer ] [ -s ][ -t sleeptime ] [ -V ] [ -D debugopt ] [ jobid... ] DESCRIPTIONlpq 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.
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. ENVIRONMENTBy 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 LISTSThe -a option is used to by lpq(1) to get status for a list of printers. This list is formed as follows.
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 STATUSThe following exit values are returned:
PRINTCAP INFORMATIONThe 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. FILESThe 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/lprng/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 ALSOlpd.conf(5), lpc(8), lpd(8), checkpc(8), lpr(1), lprm(1), printcap(5), lpd.perms(5), pr(1).DIAGNOSTICSMost 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. HISTORYLPRng is a enhanced printer spooler system with functionality similar to the Berkeley LPR software. The LPRng mailing list is lprng@lprng.com; subscribe by sending mail to lprng-request@lprng.com with the word subscribe in the body. The software is available from ftp://ftp.lprng.com/pub/LPRng. AUTHORPatrick Powell <papowell@lprng.com>.
Index
This document was created by man2html, using the manual pages. Time: 16:00:48 GMT, November 07, 2024 |