NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXIT STATUS | FILES | ATTRIBUTES | SUMMARY OF TRUSTED SOLARIS CHANGES | SEE ALSO | DIAGNOSTICS | NOTES
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:
the username of the person associated with a print request
the position of a print request in the print queue
the name of file or files comprising a print request
the job number of a print request
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. Jobs are normally queued on a first-in-first-out basis. Filenames comprising a job may be unavailable, such as when lpr is used at the end of a pipeline; in such cases the filename field indicates the standard input.
Normally, lpq displays only the user's own print jobs. If the user has the list all print jobs authorization, lpq displays other users' print jobs as well.
The print client commands locate destination information in a specific order. See printers.conf(4) and printers(4) for details.
If lpq warns that there is no daemon present (that is, due to some malfunction), the lpc(1B) command can be used to restart a printer daemon.
The following options are supported:
Displays information about printer or class of printers (see lpadmin(1M)). Specify destination using atomic, POSIX-style (server:destination), or Federated Naming Service (FNS) (.../service/printer/...) names. See printers.conf (4) for information regarding the naming conventions for atomic and FNS names, and standards(5) for information regarding POSIX.
Displays information in long format. Long format includes the name of the host from which a print request originated in the display.
Display multilabel queue information. Without this option, only jobs at the user's sensitivity label are displayed. If the -M option is used, all jobs at sensitivity labels dominated by the user's sensitivity label are displayed. If the -M option is used and the user has the bypass system mac check authorization, jobs at all sensitivity labels are displayed.
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.
The following operands are supported:
The job number associated with a print request.
The name of the user about whose jobs lpq reports information. Specify user as a valid username.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Availability | SUNWscplp |
The -M option is added. To display other users' print jobs requires that the user has the list all print jobs authorization, unless the PRINT_LIST is set in /etc/default/print.
The lpq program queries the spooler LPSCHED about the status of the printer. If the printer is disabled, the administrator can restart the spooler using lpc(1B).
The daemon could not open the printer device. The printer may be turned off-line. This message can also occur if a printer is out of paper, the paper is jammed, and so on. Another possible cause is that a process, such as an output filter, has exclusive use of the device. The only recourse in this case is to kill the offending process and restart the printer with lpc.
A daemon is trying to connect to the remote machine named host, in order to send the files in the local queue. If the remote machine is up, lpd on the remote machine is probably dead or hung and should be restarted using lpc.
The files are being transferred to the remote host, or else the local daemon has hung while trying to transfer the files.
The printer has been marked as being unavailable with lpc.
The lpsched process overseeing the spooling queue does not exist. This normally occurs only when the daemon has unexpectedly died. You can restart the printer daemon with lpc.
The printer was not found in the System V LP database. Usually this is a typing mistake; however, it may indicate that the printer does not exist on the system. Use lpstat -p (see lpstat(1)) or lpc status (see lpc(1B)) to discover the reason.
The connection to lpsched on the local machine failed. This usually means the printer server started at boot time has died or is hung. Check if the printer spooler daemon /usr/lib/lpsched is running.
These indicate that the LP print service has been stopped. Get help from the system administrator.
These indicate that the LP print service has been stopped. Get help from the system administrator.
It is likely there is an error in this software. Get help from system administrator.
Output formatting is sensitive to the line length of the terminal; this can result in widely-spaced columns.
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXIT STATUS | FILES | ATTRIBUTES | SUMMARY OF TRUSTED SOLARIS CHANGES | SEE ALSO | DIAGNOSTICS | NOTES