1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
|
'\" te
.\" Copyright (c) 1983 Regents of the University of California. All rights reserved. The Berkeley software License Agreement specifies the terms and conditions for redistribution.
.\" Copyright (C) 2006, Sun Microsystems, Inc. All Rights Reserved
.TH LPRM 1B "Nov 26, 2017"
.SH NAME
lprm \- remove print requests from the print queue
.SH SYNOPSIS
.LP
.nf
\fB/usr/ucb/lprm\fR [\fB-P\fR \fIdestination\fR] [\fB-\fR] [\fIrequest-ID\fR]...
[\fIuser\fR]...
.fi
.SH DESCRIPTION
.LP
The \fBlprm\fR utility removes print requests (\fIrequest-ID\fR) from the
print queue.
.sp
.LP
Without arguments, \fBlprm\fR deletes the current print request. \fBlprm\fR
reports the name of the file associated with print requests that it removes.
\fBlprm\fR is silent if there are no applicable print requests to remove.
.sp
.LP
Users can only remove print requests associated with their user name. See
Notes. If a superuser executes \fBlprm\fR and specifies the \fIuser\fR operand,
\fBlprm\fR removes all print requests belonging to the specified user.
.sp
.LP
The print client commands locate destination information using the "printers"
database in the name service switch. See \fBnsswitch.conf\fR(4),
\fBprinters\fR(4), and \fBprinters.conf\fR(4) for details.
.SH OPTIONS
.LP
The following options are supported:
.sp
.ne 2
.na
\fB\fB-P\fR \fIdestination\fR\fR
.ad
.RS 18n
The name of the printer or class of printers (see \fBlpadmin\fR(1M)) from which
to remove print requests. Specify destination using atomic, URI-style
(\fIscheme\fR\fB://\fR\fBendpoint\fR), or POSIX-style
(\fIserver\fR\fB:\fR\fIdestination\fR) names. See \fBprinters.conf\fR(4) for
information regarding the naming naming conventions for destination names.
.RE
.sp
.ne 2
.na
\fB\fB\(mi\fR\fR
.ad
.RS 18n
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 \fBlpr\fR was executed. See Notes.
.RE
.SH OPERANDS
.LP
The following operands are supported.
.sp
.ne 2
.na
\fB\fIrequest-ID\fR\fR
.ad
.RS 14n
Removes a specific print request. Specify \fIrequest-ID\fR as the job number
(\fBJob\fR) associated with a print request and reported by \fBlpq\fR. See
\fBlpq\fR(1B).
.RE
.sp
.ne 2
.na
\fB\fIuser\fR\fR
.ad
.RS 14n
Removes print requests associated with a specific user. Specify \fIuser\fR as
a valid user name. This option can only be used by a superuser.
.RE
.SH EXAMPLES
.LP
\fBExample 1 \fRRemoving a Print Request
.sp
.LP
The following example removes request-ID \fB385\fR from destination
\fBkilltree\fR:
.sp
.in +2
.nf
example% \fBlprm \(miP killtree 385\fR
.fi
.in -2
.sp
.SH EXIT STATUS
.LP
The following exit values are returned:
.sp
.ne 2
.na
\fB\fB0\fR\fR
.ad
.RS 12n
Successful completion.
.RE
.sp
.ne 2
.na
\fBnon-zero\fR
.ad
.RS 12n
An error occurred.
.RE
.SH FILES
.ne 2
.na
\fB\fB$HOME/.printers\fR\fR
.ad
.RS 24n
User-configurable printer database
.RE
.sp
.ne 2
.na
\fB\fB/etc/printers.conf\fR\fR
.ad
.RS 24n
System printer configuration database
.RE
.sp
.ne 2
.na
\fB\fBprinters.conf.byname\fR\fR
.ad
.RS 24n
NIS version of \fB/etc/printers.conf\fR
.RE
.sp
.ne 2
.na
\fB\fBou=printers\fR\fR
.ad
.RS 24n
LDAP version of \fB/etc/printers.conf\fR
.RE
.SH ATTRIBUTES
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
.sp
.TS
box;
c | c
l | l .
ATTRIBUTE TYPE ATTRIBUTE VALUE
_
Interface Stability Standard
.TE
.SH SEE ALSO
.LP
\fBlp\fR(1), \fBlpc\fR(1B), \fBlpq\fR(1B), \fBlpr\fR(1B), \fBlpstat\fR(1),
\fBlpadmin\fR(1M), \fBnsswitch.conf\fR(4), \fBprinters\fR(4),
\fBprinters.conf\fR(4), \fBattributes\fR(5), \fBstandards\fR(5)
.SH NOTES
.LP
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 \fBuser-equivalence=true\fR in
\fB/etc/printers.conf\fR 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.
.sp
.LP
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.
.SH NOTES
.LP
When IPP is in use, the user is prompted for a passphrase if the remote print
service is configured to require authentication.
|
