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 super-user 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(4), printers(4), and printers.conf(4) for
details.
OPTIONS
The following options are supported:
- P destination
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 stan-
dards(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 exe-
cuted. See NOTES.
OPERANDS
The following operands are supported.
user 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.
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).
EXAMPLES
Example 1: Removing a print request
The following example removes request-ID 385 from destina-
tion killtree:
example% lprm -P killtree 385
EXIT STATUS
The following exit values are returned:
0 Successful completion.
non-zero
An error occurred.
FILES
/var/spool/print/[cd]f*
Spooling directories and files.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWscplp |
|_____________________________|_____________________________|
SEE ALSO
lp(1), lpc(1B), lpq(1B), lpr(1B), lpstat(1), lpadmin(1M),
nsswitch.conf(4), printers(4), printers.conf(4), attri-
butes(5), standards(5)
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
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.
Man(1) output converted with
man2html