lprm(1)                                                   lprm(1)



NAME
     lprm - removes jobs from the line printer spooling queue for
     a Berkeley file system (4.2)

SYNOPSIS
     lprm [-Pprinter] [-] [jobno]...  [user]...

ARGUMENTS
     -    Removes all jobs that a user owns.  If the superuser
          employs this option, the spool queue is emptied
          entirely.  The owner is determined by the user's login
          name and host name on the machine where the lpr command
          was invoked.

     jobno
          Specifies the job number that is to be removed.

     -Pprinter
          Specifies the queue associated with a specific printer;
          otherwise the default printer, or the value of the
          PRINTER variable in the environment is used.

     user Specifies the name of the user who owns the job that is
          being removed.

DESCRIPTION
     lprm removes a job, or jobs, from a printer 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.

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

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

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

        % lpq -l

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

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



January 1992                                                    1

lprm(1)                                                   lprm(1)



     The lprm 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.

STATUS MESSAGES AND VALUES
     A ``Permission denied'' is received if the user tries to
     remove files other than his own.

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

FILES
     /etc/printcap
          Printer characteristics file
     /usr/spool/*
          Spooling directories
     /usr/spool/*/lock
          Lock file used to obtain the process ID of the current
          daemon and the job number of the currently active job

SEE ALSO
     lpr(1), lpq(1)

     lpd(1M) in A/UX System Administrator's Reference




























2                                                    January 1992