lprm(1B)

NAME

     lprm - remove print requests from the print queue

SYNOPSIS

     /usr/ucb/lprm   [-P destination]   [-]   [    request-ID...]
     [user...]

DESCRIPTION

     The  lprm utility removes print requests  (request-ID)  from
     the print queue.

     Without arguments, lprm deletes the current  print  request.
     lprm  reports  the   name  of the file associated with print
     requests that it removes. lprm is silent  if  there  are  no
     applicable print requests to remove.

     Users can only remove print requests associated  with  their
     user  name.   See  NOTES.  If a super-user executes lprm and
     specifies the user operand, lprm removes all print  requests
     belonging to the specified user.

     The print client  commands  locate  destination  information
     using  the  "printers"  database in the name service switch.
     See nsswitch.conf(4), printers(4), and printers.conf(4)  for
     details.

OPTIONS

     The following options are supported:

     - P destination
           The name of the printer  or  class  of  printers  (see
           lpadmin(1M))  from  which  to  remove  print requests.
           Specify   destination   using   atomic,    POSIX-style
           (server:destination),   or  Federated  Naming  Service
           (FNS)     (.../service/printer/...)     names.     See
           printers.conf(4)  for information regarding the naming
           conventions for  atomic  and   FNS  names,  and  stan-
           dards(5) for information regarding POSIX.

     -     If a user specifies this option,   removes  all  print
           requests owned by that user. If a super-user specifies
           this option, removes all requests in the print  queue.
           Job  ownership  is determined by the user's login name
           and host name on the machine from which  lpr was  exe-
           cuted. See NOTES.

OPERANDS

     The following operands are supported.

      user Removes print requests  associated  with   a  specific
           user.  Specify  user as a valid user name. This option
           can only be used by a super-user.

     request-ID
           Removes a specific print request. Specify   request-ID
           as  the  job  number  (Job)  associated  with  a print
           request and  reported by lpq. See  lpq(1B).

EXAMPLES

     Example 1: Removing a print request

     The following example removes request-ID 385  from  destina-
     tion killtree:

     example% lprm -P killtree 385

EXIT STATUS

     The following exit values are returned:

      0    Successful completion.

     non-zero
           An error occurred.

FILES

      /var/spool/print/[cd]f*
           Spooling directories and files.

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWscplp                   |
    |_____________________________|_____________________________|

SEE ALSO

     lp(1), lpc(1B), lpq(1B),  lpr(1B),  lpstat(1),  lpadmin(1M),
     nsswitch.conf(4),   printers(4),   printers.conf(4),  attri-
     butes(5), standards(5)

NOTES

     Users can only remove print requests associated  with  their
     user name.  By default, users can only remove print requests
     on the host from which the print request was submitted. If a
     super-user      has     set     user-equivalence=true     in
     /etc/printers.conf on the print  server,  users  can  remove
     print  requests associated with their user name on any host.
     Super-users can remove print requests on the host from which
     the print request was submitted. Super-users can also remove
     print requests from the print server.