1lprm(1B) SunOS/BSD Compatibility Package Commands lprm(1B)
2
6 lprm - remove print requests from the print queue
7
9 /usr/ucb/lprm [-P destination] [-] [request-ID]...
10 [user]...
11
14 The lprm utility removes print requests (request-ID) from the print
15 queue.
16 Without arguments, lprm deletes the current print request. lprm reports
19 the name of the file associated with print requests that it removes.
20 lprm is silent if there are no applicable print requests to remove.
21 Users can only remove print requests associated with their user name.
24 See Notes. If a superuser executes lprm and specifies the user operand,
25 lprm removes all print requests belonging to the specified user.
26 The print client commands locate destination information using the
29 "printers" database in the name service switch. See nsswitch.conf(4),
30 printers(4), and printers.conf(4) for details.
31
33 The following options are supported:
34 -P destination The name of the printer or class of printers (see
36 lpadmin(1M)) from which to remove print requests.
37 Specify destination using atomic, URI-style
38 (scheme://endpoint), or POSIX-style (server:destina‐
39 tion) names. See printers.conf(4) for information
40 regarding the naming naming conventions for destina‐
41 tion names.
42 − If a user specifies this option, removes all print
45 requests owned by that user. If a superuser specifies
46 this option, removes all requests in the print queue.
47 Job ownership is determined by the user's login name
48 and host name on the machine from which lpr was exe‐
49 cuted. See Notes.
50
53 The following operands are supported.
54 request-ID Removes a specific print request. Specify request-ID as
56 the job number (Job) associated with a print request and
57 reported by lpq. See lpq(1B).
58 user Removes print requests associated with a specific user.
61 Specify user as a valid user name. This option can only
62 be used by a superuser.
63
66 Example 1 Removing a Print Request
67 The following example removes request-ID 385 from destination killtree:
70 example% lprm −P killtree 385
73
77 The following exit values are returned:
78 0 Successful completion.
80 non-zero An error occurred.
83
86 $HOME/.printers User-configurable printer database
87 /etc/printers.conf System printer configuration database
90 printers.conf.byname NIS version of /etc/printers.conf
93 printers.org_dir NIS+ version of /etc/printers.conf
96 ou=printers LDAP version of /etc/printers.conf
99
102 See attributes(5) for descriptions of the following attributes:
103 ┌─────────────────────────────┬─────────────────────────────┐
108 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
109 ├─────────────────────────────┼─────────────────────────────┤
110 │Availability │SUNWlpr-cmds │
111 ├─────────────────────────────┼─────────────────────────────┤
112 │Interface Stability │Standard │
113 └─────────────────────────────┴─────────────────────────────┘
114
116 lp(1), lpc(1B), lpq(1B), lpr(1B), lpstat(1), lpadmin(1M), nss‐
117 witch.conf(4), printers(4), printers.conf(4), attributes(5), stan‐
118 dards(5)
119
121 Users can only remove print requests associated with their user name.
122 By default, users can only remove print requests on the host from which
123 the print request was submitted. If a superuser has set user-equiva‐
124 lence=true in /etc/printers.conf on the print server, users can remove
125 print requests associated with their user name on any host. Superusers
126 can remove print requests on the host from which the print request was
127 submitted. Superusers can also remove print requests from the print
128 server.
129 Some print servers send cancelation notification to job owners when
132 their print jobs have been cancelled. This notification usually comes
133 in the form of an email message. Cancelation notices cannot be disabled
134 on a Solaris server.
135
137 When IPP is in use, the user is prompted for a passphrase if the remote
138 print service is configured to require authentication.
139SunOS 5.11 2 Jun 2006 lprm(1B)