LPRM(1)                    OpenBSD Reference Manual                    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
       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/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                          LPRM(1)
