|
SunOS/BSD Compatibility Package Commands | lprm(1B) |
| lprm - remove print requests from
the print queue |
SYNOPSIS
| /usr/ucb/lprm [-P destination] [-] [ request-ID ...] [user ...] |
|
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.
|
|
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 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.
-
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).
|
| Example 1. Removing a print request
|
The following example removes request-ID 385 from
destination killtree:
|
example% lprm -P killtree 385
|
|
|
|
The following exit values are returned:
-
0
- Successful completion.
- non-zero
- An error occurred.
|
|
-
/var/spool/print/[cd]f*
- Spooling directories
and files.
|
|
See attributes(5)
for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
Availability | SUNWscplp |
|
|
lp(1), lpc(1B), lpq(1B), lpr(1B), lpstat(1), lpadmin(1M), nsswitch.conf(4), printers(4), printers.conf(4), attributes(5), standards(5)
|
|
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.
|
| |