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 in a very specific order. See 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 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.
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
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
/var/spool/print/[cd]f∗ Spooling directories and files.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
| Availability | SUNWscplp |
SEE ALSO
lp(1), lpc(1B), lpq(1B), lpr(1B), lpstat(1), lpadmin(1M), printers(4), printers.conf(4), attributes(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.
SunOS 5.6 — Last change: 13 Mar 1997