lprm - remove jobs from the line printer spooling queue
SYNOPSIS
lprm [ -a ] [ -A ] [ -Ddebugopt ] [ -Pprinter ] [ -V ] [
-Uuser ]
[ jobid... ] [ all ]
DESCRIPTION
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 speci
fied 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 permis
sions for the spool queue only the user's jobs will be
removed. See the lpd(1) man page for details about con
trol permissions.
A jobid can be a job number, a user name, a job identi
fier, 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.
EXAMPLES
Remove the last job I submitted if it is in the queue:
lprm
Remove job 25 in spool queue p1:
lprm -Pt1 25
Remove job 25 and 30 in spool queue p1:
Remove all of user john's jobs in spool queue p1:
lprm -Pt1 john
Remove all jobs in spool queue p1:
lprm -Pt1 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 -Pt1 'nobody@system*'
OPTIONS
-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 com
pile 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 configura
tion 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.
ENVIRONMENT
By default, the destination printer is taken from the com
mand 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.
EXIT STATUS
The following exit values are returned:
zero (0) Successful completion.
non-zero (!=0) An error occurred.
FILES
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/lpd.conf LPRng configuration file
${HOME}/.printcap user printer description file
/etc/printcap system printer description file
/etc/lpd.perms printer permissions
/var/spool/printer* spool directories
/var/spool/printer*/printer lock file for queue control
/var/spool/printer*/control.printer queue control
/var/spool/printer*/active.printer active job
/var/spool/printer*/log.printer log file
SEE ALSO
lpd.conf(5), lpc(8), lpd(8), checkpc(8), lpr(1), lpq(1),
lprm(1), printcap(5), lpd.conf(5), pr(1).
DIAGNOSTICS
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.
HISTORY
LPRng is a enhanced printer spooler system with function
ality similar to the Berkeley LPR software. The LPRng
mailing list is lprng@lprng.com; subscribe by sending mail
to lprng-request@lprng.com with the word subscribe in the
body. The software is available from
ftp://ftp.astart.com/pub/LPRng.
Patrick Powell <papowell@lprng.com>.
Man(1) output converted with
man2html