NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | FILES | ATTRIBUTES | SUMMARY OF TRUSTED SOLARIS CHANGES | SEE ALSO | DIAGNOSTICS | NOTES
The lprm utility removes print requests (request-ID) from the print queue.
If invoked without arguments, lprm deletes the user's current print request. lprm reports the name of the file associated with print requests that it removes, but is silent if there are no applicable print requests to remove.
To remove a job belonging to another user, the user must have the cancel any print job authorization. lprm then removes all jobs that belong to the specified user.
You can remove a specific job by supplying its job number (request-ID) as an argument. To find the job number, run lpq(1B). See EXAMPLES.
lprm can normally cancel only requests that are at its own sensitivity label. To cancel jobs at other SLs, the user must have the bypass system mac check authorization.
The print client commands locate destination information in a very specific order. See printers(4) and printers.conf(4) for details.
The following options are supported.
The name of the printer or class of printers (see lpadmin(1M)) from which to remove print requests. 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.
If a user specifies this option, lprm removes all print requests owned by that user. If invoked by a user with the administer printing authorization, it 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 lprm was executed. See NOTES.
The following operands are supported.
Removes print requests associated with a specific user. Specify user as a valid user name. Use of this operand requires the administer printing authorization.
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).
The following example finds the job number on the printer killtree using lpq, then removes the job:
admin$ lpq -P killtree killtree is ready and printing |
Rank | Owner | Job | Files | Total Size |
active | wendy | 385 | standard input | 35501 bytes |
admin$ lprm -P killtree 385 |
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Availability | SUNWscplp |
For lprm to cancel other users' requests, requires that the user have the cancel any print job authorization. For lprm to cancel requests at other sensitivity labels requires that the user have the bypass system mac check authorization.
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.
It is likely there is an error in this software. Get help from system administrator.
You are not allowed to remove another's request.
An active job may be incorrectly identified for removal by an lprm command issued with no arguments. During the interval between an lpq command and the execution of lprm, the next job in queue may have become active; you can remove that job unintentionally if you own it. To avoid this, supply lprm with the job number as an argument.
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | FILES | ATTRIBUTES | SUMMARY OF TRUSTED SOLARIS CHANGES | SEE ALSO | DIAGNOSTICS | NOTES