lprm - remove jobs from the line printer spooling queue
lprm [
-a ] [
-A ] [
-Ddebugopt ] [
-Pprinter ] [
-V ] [
-Uuser ] [
jobid... ] [
all ]
Lprm will send a request to the LPD server to remove jobs from a spool
queue. (See
clean(1) for an
lp(1) compatible interface.)
Lprm is normally the only method by which a user may remove a job. The
jobs to be removed are specified by the job number or user name; with no
specifiers the first removable in a queue will be selected for removal.
Usually users may only remove jobs submitted by themselves from the host which
originated the original lpr request.
The spool queue is searched first for jobs that the user has permissions to
remove, then for jobs that match any of the specified set of tags. If no tags
are specified, only the first job in the queue that the user has permissions
to remove will be removed. If the
-a flag or the
all spool queue
is specified,
lprm will search all available spool queues.
The
all wildcard jobid is used to match all jobs in a spool queue;
however unless the user has
control permissions for the spool queue
only the user's jobs will be removed. See the
lpd(1) man page for
details about control permissions.
A jobid can be a job number, a user name, a job identifier, or a pattern for a
glob based wild card match. This match is applied to the job identifier
information.
Lprm will announce the names of any files it removes and is silent if
there are no jobs in the queue which match the request list. If the job being
removed is active, the LPD server will stop printing the job and then restart
printing operations.
- Remove the last job I submitted if it is in the queue:
-
lprm
- Remove job 25 in spool queue p1:
-
lprm -Pp1 25
- Remove job 25 and 30 in spool queue p1:
-
lprm -Pp1 25 30
- Remove all of user john's jobs in spool queue p1:
-
lprm -Pp1 john
- Remove all jobs in spool queue p1:
-
lprm -Pp1 all
- Remove all jobs in all spool queues:
-
lprm -a all
- Remove the jobs with identifier nobody@system in spool
queue p1.
- Note that the quotes around the pattern are needed to
suppress shell glob expansion.
lprm -Pp1 'nobody@system*'
- -A
- Use authentication specified by the value of the AUTH
environment variable.
- -a
- Remove files from all spool queues available to the
user.
-
-Pprinter
- Specifies printer queue. By default, the destination
printer is taken from the command line dest value, then the
environment variables PRINTER, LPDEST, NPRINTER, NGPRINTER, then first
entry in the printcap information, and and finally the default_printer
entry from the configuration file, and then the compile time default.
-
-Uuser
- Explicitly provide a userid for doing the removal to the
LPD server. This can be done only by ROOT or userids listed in the
allow_user_setting configuration or printcap option. This facility
is provided to allow printing front end systems such as SAMBA to submit
job removal requests on behalf of users.
-
-Ddebugopts
- Debugging is controlled using the -D option. This
accepts a comma-separated list of debugging settings. These settings take
one of two forms: facility=value , or value to set an
overall default value.
- -V
- The -V option prints the version information for the
program and verbose information about activities.
Users with CONTROL (i.e.- administrative) permissions on spool queues can remove
any or all jobs. The
all wildcard defaults to all user jobs, not just
those submitted by the user. This allows administrators to purge a spool queue
easily.
By default, the destination printer is taken from the command line
dest
value, then the environment variables PRINTER, LPDEST, NPRINTER, NGPRINTER,
then first entry in the printcap information, and and finally the
default_printer entry from the configuration file, and then the compile time
default.
The following exit values are returned:
- zero (0)
- Successful completion.
- non-zero (!=0)
- An error occurred.
The files used by LPRng are set by values in the printer configuration file. The
following are a commonly used set of default values.
/etc/lprng/lpd.conf LPRng configuration file
${HOME}/.printcap user printer description file
/etc/printcap printer description file
/etc/lprng/lpd.perms permissions
/var/run/lprng/lpd lock file for queue control
/var/spool/lpd spool directories
/var/spool/lpd/QUEUE/control queue control
/var/spool/lpd/QUEUE/log trace or debug log file
/var/spool/lpd/QUEUE/acct accounting file
/var/spool/lpd/QUEUE/status status file
lpd.conf(5),
lpc(8),
lpd(8),
checkpc(8),
lpr(1),
lpq(1),
lprm(1),
printcap(5),
lpd.conf(5),
pr(1),
lprng_certs(1),
lprng_index_certs(1).
Patrick Powell <
[email protected]>.
Most of the diagnostics are self explanatory. If you are puzzled over the exact
cause of failure, set the debugging level on (-D5) and run again. The
debugging information will help you to pinpoint the exact cause of failure.
LPRng is a enhanced printer spooler system with functionality similar to the
Berkeley LPR software. The LPRng developer mailing list is
[email protected]; subscribe by visiting
https://lists.sourceforge.net/lists/listinfo/lprng-devel or sending
mail to
[email protected] with the word
subscribe in the body.
The software is available via
http://lprng.sourceforge.net