Provided by: lprng_3.8.28-4ubuntu1_i386 bug

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