NAME

   rlartrm - remove jobs from the lart spooling queue
    

SYNOPSIS

   rlartrm [-Llart] [-] [job # ...] [luser ...]
   

DESCRIPTION

   Rlartrm will remove a job, or jobs, from a lart's spool queue. This
   should be used in an emergency only to remove LARTs which may adversly
   affect one's future earning potential.
   
   Options and arguments:

   -Llart       Specify the queue associated with a specific lart
                (otherwise the default lart is used).

   -            If a single `-' is given, the spool queue will be
                emptied entirely.  luser Causes rlartrm to attempt to
                remove any jobs queued destined for that luser (or
                lusers).

   job #        An admin may dequeue an individual job by specifying its
                job number. This number may be obtained from the
                lartq(1m) program, e.g.

   % lartq -l
   1st:ken [job #013tacnuke]
   (standard input)
   % rlartrm 13
   
   If neither arguments or options are given, rlartrm will delete the
   currently active job if it is owned by the admin who invoked rlartrm.
   
   Rlartrm announces the names of any larts it removes and is silent if
   there are no jobs in the queue which match the request list.
   
   Rlartrm will kill off an active daemon, if necessary, before removing
   any spooling larts. If a daemon is killed, a new one is automatically
   restarted upon completion of file removals.
   

ENVIRONMENT

   If the following environment variable exists, it is utilized by
   rlartrm.

   LART If the environment variable LART exists, and a lart has not been
   specified with the -L option, the default lart is assumed from LART.
    

FILES

   /etc/lartcap         To determine lart characteristics.
   /var/larts/*         The spooling directory, as determined from lartcap.
   /var/larts/*/lock    Lock file used to obtain the pid of the current
                        daemon and the job number of the currently active job.
    

SEE ALSO

   rlart(1m), rlartrm(1m), lartc(8), lartd(8)


DIAGNOSTICS

   `Permission denied' if a luser tries to remove larts. This will cause
   an immediate queuing of a lart for this luser.


BUGS

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


AUTHORS

   Michael Firestone and Larry Lile © 1997