lprm(1)								       lprm(1)

Name
       lprm - remove jobs from line printer queue

Syntax
       lprm [-Pprinter] [-] [job #...] [user...]

Description
       The  command  removes  a	 job,  or  jobs, from a printer's spool queue.
       Since the spooling directory is protected from users, using is normally
       the only method by which a user may remove a job.

       The  command  without any arguments deletes the currently active job if
       it is owned by the user who invoked

       If the - flag is specified, removes all jobs which a user owns.	If the
       super-user  employs this flag, the spool queue is emptied entirely. The
       owner is determined by the user's login	name  and  host	 name  on  the
       machine where the command was invoked.

       Specifying  a  user's name, or list of user names, causes to attempt to
       remove any jobs queued belonging to that user (or users).  This form of
       invoking is useful only to the super-user.

       A  user	may  dequeue  an  individual job by specifying its job number.
       This number may be obtained from the program.  For example,
       % lpq -l

       1st: ken	 [job #013ucbarpa]
	    (standard input)	100 bytes
       % lprm 13

       The command announces the names of any files it removes and  is	silent
       if there are no jobs in the queue which match the request list.

       The  command  kills off an active daemon, if necessary, before removing
       any spooling files.  If a daemon is killed, a new one is	 automatically
       restarted upon completion of file removals.

Options
       -		   Removes all jobs owned by you only.

       -P printer	   Removes  jobs  from	specified  printer.  It may be
			   used to specify the queue associated	 with  a  spe‐
			   cific  printer  (otherwise  the default printer, or
			   the value of the PRINTER variable in	 the  environ‐
			   ment is used).

Restrictions
       Since  there  are  race	conditions  possible in the update of the lock
       file, the currently active job may be incorrectly identified.

Diagnostics
       ``Permission denied" if the user tries to remove files other  than  his
       own.

Files
       /etc/printcap	   printer characteristics file
       /usr/spool/*	   spooling directories
       /usr/spool/*/lock   lock file used to obtain the pid of the current
			   daemon and the job number of the currently active job

See Also
       lpq(1), lpr(1), lpd(8)

								       lprm(1)

Vote for polarhome