NAME    [Toc]    [Back]

       lprm  -  Removes  requests  from the line printer spooling
       queue

SYNOPSIS    [Toc]    [Back]

       lprm [-Pprinter] [-] [request_ID...] [user...]

       The lprm command removes  one  or  more  requests  from  a
       printer's spool queue.

OPTIONS    [Toc]    [Back]

       Removes  all requests that a user owns.  If specified by a
       user with superuser authority, the spool queue is  emptied
       entirely.   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    [Toc]    [Back]

       Because  the  spooling  directory is protected from users,
       using lprm is  normally  the  way  a  user  can  remove  a
       request.

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

       The  - flag removes all requests from the user issuing the
       command. If a user who has superuser authority  uses  this
       flag,  the  spool queue is emptied entirely.  The owner is
       determined by the user's  username  and  hostname  on  the
       machine where the lpr command was invoked.

       You can remove an individual request from a queue by specifying
 its request ID.  (You can obtain the request ID  by
       using the lpq or lpstat commands.)  Specifying one or more
       users removes  any  requests  queued  belonging  to  those
       users.   This works only for a user with superuser authority.


       The lprm command is silent if there are no requests in the
       queue that match the request list.

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

NOTES    [Toc]    [Back]

       Because race conditions are possible in the update of  the
       lock file, the currently active request may be incorrectly
       identified.

DIAGNOSTICS    [Toc]    [Back]

       The user tried to remove  files  that  belong  to  another
       user.

EXAMPLES    [Toc]    [Back]

       To  remove  a request from the default queue by specifying
       the request ID, enter: lprm 13 To remove a request from  a
       specific queue, enter: lprm -Plp0 13 To remove from a specific
 queue a request from user guest, enter:  lprm  -Plp0
       guest

FILES    [Toc]    [Back]

       Printer description file.  Spool directories.  Daemon control
 files.  Data files specified in cf files.   Temporary
       copies  of cf files.  Lock file used to obtain the process
       ID of the current daemon and the request ID  of  the  currently
 active request.

SEE ALSO    [Toc]    [Back]

       Commands:  lp(1),    lpc(8),   lpd(8),   lpq(1),   lpr(1),
       lpstat(1)



                                                          lprm(1)