lprm - remove print requests from the print queue
/usr/ucb/lprm [-P destination] [-] [request-ID]...
The lprm utility removes print requests (request-ID) from the
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
Users can only remove print requests associated with their user
name. See Notes. If a superuser executes lprm and specifies the
user operand, lprm removes all print requests belonging to the
The print client commands locate destination information using the
"printers" database in the name service switch. See
nsswitch.conf(5), printers(5), and printers.conf(5) for
The following options are supported:
The name of the printer or class of printers (see
) from which to remove print requests. Specify destination
using atomic, URI-style (scheme://endpoint
) names. See
for information regarding the naming naming
conventions for destination names.
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.
Removes a specific print request. Specify
as the job number (Job
) associated with a print
request and reported by lpq
. See lpq(1B)
Removes print requests associated with a specific user.
Specify user as a valid user name. This option can only be used by a
Example 1 Removing a Print Request
The following example removes request-ID 385 from
example% lprm −P killtree 385
The following exit values are returned:
An error occurred.
User-configurable printer database
System printer configuration database
NIS version of /etc/printers.conf
LDAP version of /etc/printers.conf
See attributes(7) for descriptions of the following attributes:
lp(1), lpstat(1), lpc(1B), lpq(1B), lpr(1B),
nsswitch.conf(5), printers(5), printers.conf(5),
attributes(7), standards(7), lpadmin(8)
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 cancellation notifications to job owners
when their print jobs have been cancelled. This notification usually comes
in the form of an email message. Cancellation notices cannot be disabled on
a Solaris server.
When IPP is in use, the user is prompted for a passphrase if the remote print
service is configured to require authentication.