Provided by:
lprng_3.8.28dfsg.1-1.1ubuntu2_i386 
NAME
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 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.
EXAMPLES
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*’
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 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.
WARNINGS
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 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.
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/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
SEE ALSO
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).
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 functionality 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.lprng.com/pub/LPRng.
AUTHOR
Patrick Powell <papowell@lprng.com>.