Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

lpq(1b) [opensolaris man page]

lpq(1B) 					     SunOS/BSD Compatibility Package Commands						   lpq(1B)

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 output: 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 indicates 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 destina- tion 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 database 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 attributes: +-----------------------------+-----------------------------+ | 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), attributes(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 authentication. SunOS 5.11 2 Jun 2006 lpq(1B)

Check Out this Related Man Page

lprm(1B)																  lprm(1B)

NAME
lprm - remove print requests from the print queue SYNOPSIS
/usr/ucb/lprm [-P destination] [-] [ request-ID...] [user...] The lprm utility removes print requests (request-ID) from the print queue. Without arguments, lprm deletes the current print request. lprm reports the name of the file associated with print requests that it removes. lprm is silent if there are no applicable print requests to remove. Users can only remove print requests associated with their user name. See . If a superuser executes lprm and specifies the user operand, lprm removes all print requests belonging to the specified user. 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. The following options are supported: -P destination The name of the printer or class of printers (see lpadmin(1M)) from which to remove print requests. Specify destination using atomic or POSIX-style (server:destination) names. See printers.conf(4) for information regarding the naming conven- tions for atomic names and standards(5) for information regarding POSIX. - If a user specifies this option, removes all print requests owned by that user. If a superuser specifies this option, removes all requests in the print queue. Job ownership is determined by the user's login name and host name on the machine from which lpr was executed. See . The following operands are supported. user Removes print requests associated with a specific user. Specify user as a valid user name. This option can only be used by a superuser. request-ID Removes a specific print request. Specify request-ID as the job number (Job) associated with a print request and reported by lpq. See lpq(1B). Example 1: Removing a print request The following example removes request-ID 385 from destination killtree: example% lprm -P killtree 385 The following exit values are returned: 0 Successful completion. non-zero An error occurred. /var/spool/print/[cd]f* Spooling directories and files. /var/spool/lp/* LP print queue $HOME/.printers User-configurable printer database /etc/printers.conf System printer configuration database printers.conf.byname NIS version of /etc/printers.conf printers.org_dir NIS+ version of /etc/printers.conf See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWscplp | +-----------------------------+-----------------------------+ lp(1), lpc(1B), lpq(1B), lpr(1B), lpstat(1), lpadmin(1M), nsswitch.conf(4), printers(4), printers.conf(4), attributes(5), standards(5) Users can only remove print requests associated with their user name. By default, users can only remove print requests on the host from which the print request was submitted. If a superuser has set user-equivalence=true in /etc/printers.conf on the print server, users can remove print requests associated with their user name on any host. Superusers can remove print requests on the host from which the print request was submitted. Superusers can also remove print requests from the print server. Some print servers send cancelation notification to job owners when their print jobs have been cancelled. This notification usually comes in the form of an email message. Cancelation notices cannot be disabled on a Solaris server. 23 Feb 2005 lprm(1B)
Man Page