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