NAME

lprm − remove jobs from the line printer spooling queue

SYNOPSIS

lprm [ −Pprinter ] [ − ] [ job # ... ] [ user ... ]

DESCRIPTION

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

When lprm is used without any arguments, it deletes the currently active job if it is owned by the user who invoked lprm. 

When a user’s name or list of user names is specified, lprm attempts to remove any jobs queued belonging to that user (or users).  This form of using lprm is useful only to the super-user.  Lprm announces the names of any files it removes.  If the spool queue is empty, the message ‘no entries’ is displayed. 

Lprm will kill off an active daemon, if necessary, before removing any spooling files.  If a daemon is killed, a new one is automatically restarted when the files have been removed. 

OPTIONS

−Pprinter
Remove jobs from the printer queue.  If this option is omitted, lprm removes jobs from the default printer, or the value of the PRINTER variable in the environment is used. 

− Remove all jobs which a user owns.  If the super-user employs this flag, the spool queue is emptied entirely. 

EXAMPLE

A user may dequeue an individual job by specifying its job number.  This number may be obtained from the lpq(1) program, for example:

% lpq  −1l
 1st: ken[job #908] (standard input) 100 bytes
% lprm  908

FILES

/etc/printcapprinter characteristics file
/usr/spool/∗spooling directories
/usr/spool/∗/locklock file used to find out the pid of the current
daemon and the job number of the currently active job
/usr/lib/∗daemon to restart

SEE ALSO

lpr(1), lpq(1), lpd(8).

BUGS

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

Sun System Release 0.3  —  22 March 1983