Penguin
Recent Changes
Annotated edit history of lprm(1) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 LPRM
2 !!!LPRM
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 EXAMPLES
7 OPTIONS
8 WARNINGS
9 ENVIRONMENT
10 EXIT STATUS
11 FILES
12 SEE ALSO
13 DIAGNOSTICS
14 HISTORY
15 AUTHOR
16 ----
17 !!NAME
18
19
20 lprm - remove jobs from the line printer spooling queue
21 !!SYNOPSIS
22
23
24 __lprm__ [[ __-a__ ] [[ __-A__ ] [[
25 __-D__''debugopt'' ] [[ __-P__''printer'' ] [[
26 __-V__ ] [[ __-U__''user'' ]
27
28
29 [[ ''jobid''... ] [[ ''all'' ]
30 !!DESCRIPTION
31
32
33 ''Lprm'' will send a request to the LPD server to remove
34 jobs from a spool queue. (See clean(1) for an
35 lp(1) compatible interface.) ''Lprm'' is normally
36 the only method by which a user may remove a job. The jobs
37 to be removed are specified by the job number or user name;
38 with no specifiers the first removable in a queue will be
39 selected for removal. Usually users may only remove jobs
40 submitted by themselves from the host which originated the
41 original lpr request.
42
43
44 The spool queue is searched first for jobs that the user has
45 permissions to remove, then for jobs that match any of the
46 specified set of tags. If no tags are specified, only the
47 first job in the queue that the user has permissions to
48 remove will be removed. If the __-a__ flag or the
49 ''all'' spool queue is specified, ''lprm'' will search
50 all available spool queues.
51
52
53 The ''all'' wildcard jobid is used to match all jobs in a
54 spool queue; however unless the user has ''control''
55 permissions for the spool queue only the user's jobs will be
56 removed. See the lpd(1) man page for details about
57 control permissions.
58
59
60 A jobid can be a job number, a user name, a job identifier,
61 or a pattern for a ''glob'' based wild card match. This
62 match is applied to the job identifier
63 information.
64
65
66 ''Lprm'' will announce the names of any files it removes
67 and is silent if there are no jobs in the queue which match
68 the request list. If the job being removed is active, the
69 LPD server will stop printing the job and then restart
70 printing operations.
71 !!EXAMPLES
72
73
74 Remove the last job I submitted if it is in the
75 queue:
76
77
78 lprm
79
80
81 Remove job 25 in spool queue p1:
82
83
84 lprm -Pp1 25
85
86
87 Remove job 25 and 30 in spool queue p1:
88
89
90 lprm -Pp1 25 30
91
92
93 Remove all of user john's jobs in spool queue
94 p1:
95
96
97 lprm -Pp1 john
98
99
100 Remove all jobs in spool queue p1:
101
102
103 lprm -Pp1 all
104
105
106 Remove all jobs in all spool queues:
107
108
109 lprm -a all
110
111
112 Remove the jobs with identifier nobody@system in spool queue
113 p1.
114
115
116 Note that the quotes around the pattern are needed to
117 suppress shell glob expansion.
118
119
120 lprm -Pp1 'nobody@system*'
121 !!OPTIONS
122
123
124 __-A__
125
126
127 Use authentication specified by the value of the AUTH
128 environment variable.
129
130
131 __-a__
132
133
134 Remove files from all spool queues available to the
135 user.
136
137
138 __-P__''printer''
139
140
141 Specifies printer queue. By default, the destination printer
142 is taken from the command line ''dest'' value, then the
143 environment variables PRINTER, LPDEST, NPRINTER, NGPRINTER,
144 then first entry in the printcap information, and and
145 finally the default_printer entry from the configuration
146 file, and then the compile time default.
147
148
149 __-U__''user''
150
151
152 Explicitly provide a userid for doing the removal to the LPD
153 server. This can be done only by ROOT or userids listed in
154 the ''allow_user_setting'' configuration or printcap
155 option. This facility is provided to allow printing front
156 end systems such as SAMBA to submit job removal requests on
157 behalf of users.
158
159
160 __-D__''debugopts''
161
162
163 Debugging is controlled using the __-D__ option. This
164 accepts a comma-separated list of debugging settings. These
165 settings take one of two forms: __facility=value ,__ or
166 __value__ to set an overall default value.
167
168
169 __-V__
170
171
172 The -V option prints the version information for the program
173 and verbose information about activities.
174 !!WARNINGS
175
176
177 Users with CONTROL (i.e.- administrative) permissions on
178 spool queues can remove any or all jobs. The ''all''
179 wildcard defaults to all user jobs, not just those submitted
180 by the user. This allows administrators to purge a spool
181 queue easily.
182 !!ENVIRONMENT
183
184
185 By default, the destination printer is taken from the
186 command line ''dest'' value, then the environment
187 variables PRINTER, LPDEST, NPRINTER, NGPRINTER, then first
188 entry in the printcap information, and and finally the
189 default_printer entry from the configuration file, and then
190 the compile time default.
191 !!EXIT STATUS
192
193
194 The following exit values are returned:
195
196
197 __zero (0)__
198
199
200 Successful completion.
201
202
203 __non-zero (!=0)__
204
205
206 An error occurred.
207 !!FILES
208
209
210 The files used by LPRng are set by values in the printer
211 configuration file. The following are a commonly used set of
212 default values.
213
214
215 /etc/lprng/lpd.conf LPRng configuration file
216 ${HOME}/.printcap user printer description file
217 /etc/lprng/printcap printer description file
218 /etc/lprng/lpd.perms permissions
219 /var/run/lprng/lpd lock file for queue control
220 /var/spool/lpd spool directories
221 /var/spool/lpd/QUEUE/control queue control
222 /var/spool/lpd/QUEUE/log trace or debug log file
223 /var/spool/lpd/QUEUE/acct accounting file
224 /var/spool/lpd/QUEUE/status status file
225 !!SEE ALSO
226
227
228 lpd.conf(5), lpc(8), lpd(8), checkpc(8), lpr(1), lpq(1),
229 lprm(1), printcap(5), lpd.conf(5), pr(1).
230 !!DIAGNOSTICS
231
232
233 Most of the diagnostics are self explanatory.
234 If you are puzzled over the exact cause of failure,
235 set the debugging level on (-D5) and run again.
236 The debugging information will
237 help you to pinpoint the exact cause of failure.
238 !!HISTORY
239
240
241 LPRng is a enhanced printer spooler system with
242 functionality similar to the Berkeley LPR software. The
243 LPRng mailing list is lprng@lprng.com; subscribe by sending
244 mail to lprng-request@lprng.com with the word subscribe in
245 the body. The software is available from
246 ftp://ftp.lprng.com/pub/LPRng.
247 !!AUTHOR
248
249
250 Patrick Powell
251 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.