Manual Pages for UNIX Operating System command usage for man lprm

SunOS/BSD Compatibility Package Commands                 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  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 Notes.




SunOS 5.11          Last change: 10 Dec 2009                    1






SunOS/BSD Compatibility Package Commands                 lprm(1B)



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


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


ATTRIBUTES




SunOS 5.11          Last change: 10 Dec 2009                    2






SunOS/BSD Compatibility Package Commands                 lprm(1B)



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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWlpr-cmds                |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | Standard                    | See standards(5).           |
    |_____________________________|_____________________________|


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.













SunOS 5.11          Last change: 10 Dec 2009                    3