LPRM(1) 						      General Commands 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 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 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/lpd.conf				    LPRng configuration file
       ${HOME}/.printcap			    user printer description file
       /etc/printcap				    printer description file
       /etc/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)