View Source: lprm(1) - Waikato Linux Users Group

Edit PageHistory Diff Info LikePages
LPRM
!!!LPRM
NAME
SYNOPSIS
DESCRIPTION
EXAMPLES
OPTIONS
WARNINGS
ENVIRONMENT
EXIT STATUS
FILES
SEE ALSO
DIAGNOSTICS
HISTORY
AUTHOR
----
!!NAME


lprm - remove jobs from the line printer spooling queue
!!SYNOPSIS


__lprm__ [[ __-a__ ] [[ __-A__ ] [[
__-D__''debugopt'' ] [[ __-P__''printer'' ] [[
__-V__ ] [[ __-U__''user'' ]


[[ ''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.


__-P__''printer''


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.


__-U__''user''


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.


__-D__''debugopts''


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/lprng/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).
!!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
----
17 pages link to lprm(1):
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.
Last edited on Tuesday, June 4, 2002 12:22:17 am by "perry"
Edit PageHistory Diff Info LikePages