LPRM(1B) BSD Compatibility Package Commands LPRM(1B)

NAME

lprm - remove print requests from the print queue

SYNOPSIS

/usr/ucb/lprm [-P destination] [-] [request-ID]...
[user]...

DESCRIPTION

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 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(5),
printers(5), and printers.conf(5) for details.

OPTIONS

The following options are supported:

-P destination
The name of the printer or class of printers (see
lpadmin(8)) from which to remove print requests.
Specify destination using atomic, URI-style
(scheme://endpoint), or POSIX-style
(server:destination) names. See printers.conf(5)
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 Notes.

OPERANDS

The following operands are supported.

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).


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.

EXAMPLES

Example 1: Removing a Print Request

The following example removes request-ID 385 from destination
killtree:


example% lprm -P killtree 385

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


ou=printers
LDAP version of /etc/printers.conf

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+

SEE ALSO

lp(1), lpstat(1), lpc(1B), lpq(1B), lpr(1B), nsswitch.conf(5),
printers(5), printers.conf(5), attributes(7), standards(7),
lpadmin(8)

NOTES

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.

NOTES

When IPP is in use, the user is prompted for a passphrase if the
remote print service is configured to require authentication.

November 26, 2017 LPRM(1B)