[0m


LPRM(1)             UNIX Programmer's Manual		  LPRM(1)



[1mNAME
     [0mlprm - remove jobs from the line printer spooling queue

[1mSYNOPSIS
     lprm [0m[ [1m-P[0m_p_r_i_n_t_e_r ] [ [1m- [0m] [ job # ...  ] [ user ...  ]

[1mDESCRIPTION
     [0m_L_p_r_m will remove a job, or jobs, from a printer's spool
     queue.  Since the spooling directory is protected from
     users, using _l_p_r_m is normally the only method by which a
     user may remove a job.

     _L_p_r_m without any arguments will delete the currently active
     job if it is owned by the user who invoked _l_p_r_m.

     If the [1m- [0mflag is specified, _l_p_r_m will remove all jobs which
     a user owns.  If the super-user employs this flag, the spool
     queue will be emptied entirely. The owner is determined by
     the user's login name and host name on the machine where the
     _l_p_r command was invoked.

     Specifying a user's name, or list of user names, will cause
     _l_p_r_m to attempt to remove any jobs queued belonging to that
     user (or users).  This form of invoking _l_p_r_m 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 _l_p_q(1) pro-
     gram, e.g.

	  % lpq -l

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

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

     _L_p_r_m will kill 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 remo-
     vals.

     The [1m-P [0moption may be usd to specify the queue associated
     with a specific printer (otherwise the default printer, or
     the value of the PRINTER variable in the environment is
     used).

[1mFILES
     [0m/etc/printcap	 printer characteristics file



Printed 26/11/91    Revision 1.3 of 18/06/90			1






LPRM(1)             UNIX Programmer's Manual		  LPRM(1)



     /var/spool/*	 spooling directories
     /var/spool/*/lock	 lock file used to obtain the pid of the current
			 daemon and the job number of the currently active job

[1mSEE ALSO
     [0mlpr(1), lpq(1), lpd(8)

[1mDIAGNOSTICS
     [0m``Permission denied" if the user tries to remove files other
     than his own.

[1mBUGS
     [0mSince there are race conditions possible in the update of
     the lock file, the currently active job may be incorrectly
     identified.








































Printed 26/11/91    Revision 1.3 of 18/06/90			2



[0m