Provided by: lprng_3.8.B-2_amd64 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).

AUTHOR

       Patrick Powell <papowell@lprng.com>.

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  developer  mailing  list   is   lprng-devel@lists.sourceforge.net;
       subscribe  by visiting https://lists.sourceforge.net/lists/listinfo/lprng-devel or sending
       mail to lprng-request@lists.sourceforge.net with the word subscribe in the body.
       The software is available via http://lprng.sourceforge.net