


LPRM(1)                                                   LPRM(1)


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 nor-
       mally 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  speci-
       fiers  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 permis-
       sions 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; how-
       ever  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 pat-
       tern 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




LPRng                      LPRng-3.9.0                          1





LPRM(1)                                                   LPRM(1)


       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 vari-
            ables 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 facil-
            ity 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



LPRng                      LPRng-3.9.0                          2





LPRM(1)                                                   LPRM(1)


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













LPRng                      LPRng-3.9.0                          3


