lprm(1)                             CLIX                             lprm(1)



  NAME

    lprm - Removes jobs from the line printer spooling queue

  SYNOPSIS

    lprm [-P printer] [-] [job# ... ] [user ... ]

  FLAGS

    -            Causes lprm to remove all jobs that a user owns.  If the
                 superuser employs this flag, the spool queue will be emptied
                 entirely.  The owner is determined by the login name of the
                 user and the name of the host machine where the lpr command
                 was invoked.

    -P printer   Specifies the queue associated with a specific printer.
                 (Otherwise, the default printer or the value of the $PRINTER
                 variable in the environment is used).

  DESCRIPTION

    The lprm command removes jobs from a printer's spool queue.  Because the
    spooling directory is protected from user(s), using lprm is normally the
    only method by which a user can remove a job.

    Without arguments, lprm will delete the currently-active job if it is
    owned by the user who invoked lprm.

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

    The lprm command kills the lpd daemon if necessary before removing any
    spooling files.  If a daemon is killed, a new one is automatically
    restarted on completion of file removals.

  EXAMPLE

    1.  A user can dequeue a job by specifying its job number.  This number
        can be obtained from the lpq command as follows:

        lpq -l


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


    2.  Having acquired the job number, the user can remove the job as
        follows:



  2/94 - Intergraph Corporation                                              1

  lprm(1)                             CLIX                             lprm(1)



        lprm 13


  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

  NOTES

    Because of possible race conditions in the lock file update, the
    currently-active job can be incorrectly identified.

  DIAGNOSTICS

    permission denied
           user attempted to remove files other than his/her own.

  EXIT VALUES

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

  RELATED INFORMATION

    Commands: lpr(1), lpq(1), lpd(8)





















  2                                              Intergraph Corporation - 2/94