Online Man Page

This form may be used to access the UNIX man pages. Note this form runs on a Solaris machine, so the results may disagree with other operating system implementations of the commands.

Topic:     Section:   Keyword search:

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 . If a superuser 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,          URI-style
                       (scheme://endpoint),    or     POSIX-style
                       (server:destination)       names.      See
                       printers.conf(4) for information regarding
                       the naming naming conventions for destina-
                       tion names.

     -                 If a user specifies this option,   removes
                       all  print requests owned by that user. If
                       a superuser specifies this option, removes
                       all requests in the print queue.  Job own-
                       ership is determined by the  user's  login
                       name  and  host  name  on the machine from
                       which lpr was executed. See .

OPERANDS

     The following operands are supported.

     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).

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

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

     $HOME/.printers         User-configurable printer database

     /etc/printers.conf      System printer  configuration  data-
                             base

     printers.conf.byname    NIS version of /etc/printers.conf

     printers.org_dir        NIS+ version of /etc/printers.conf

     ou=printers             LDAP version of /etc/printers.conf

ATTRIBUTES

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

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWlpr-cmds                |
    |_____________________________|_____________________________|
    | Interface Stability         | Standard                    |
    |_____________________________|_____________________________|

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
     superuser      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.
     Superusers can remove print requests on the host from  which
     the  print request was submitted. Superusers can also remove
     print requests from the print server.

     Some print servers send cancelation notification to job own-
     ers  when their print jobs have been cancelled. This notifi-
     cation usually comes in the form of an email message. Cance-
     lation notices cannot be disabled on a Solaris server.

NOTES

     When IPP is in use, the user is prompted for a passphrase if
     the  remote print service is configured to require authenti-
     cation.