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 NOTES. If a super-user executes lprm and specifies the user operand, lprm removes all print requests belonging to the specified user.
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, removes all print requests owned by that user. If a super-user 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 NOTES.
The following operands are supported.
Removes print requests associated with a specific user. Specify user as a valid user name. This option can only be used by a super-user.
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 removes request-ID 385 from destination killtree:
example% lprm -P killtree 385
See attributes(5) for descriptions of the following attributes:
|ATTRIBUTE TYPE||ATTRIBUTE VALUE|
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 super-user 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. Super-users can remove print requests on the host from which the print request was submitted. Super-users can also remove print requests from the print server.