Manual Pages for UNIX Operating System command usage for man cancel

User Commands                                           cancel(1)



NAME
     cancel - cancel print request

SYNOPSIS
     cancel [request-ID...] [destination]...


     cancel -u user... [destination]...


DESCRIPTION
     The cancel utility cancels print  requests.  There  are  two
     forms of the cancel command.


     The first form of cancel has two optional  arguments:  print
     requests (request-ID) and destinations (destination). Speci-
     fying request-ID with destination cancels request-ID on des-
     tination.   Specifying  only  the  destination  cancels  the
     current print request on destination. If destination is  not
     specified, cancel cancels the requested print request on all
     destinations.


     The second form of cancel cancels a user's print requests on
     specific destinations.


     Users can only cancel print requests associated  with  their
     username.  By  default, users can only cancel 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  cancel
     print  requests  associated with their username on any host.
     Super-users can cancel print requests on the host from which
     the  print request was submitted. Superusers can also cancel
     print requests from the print server.


     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:

     -u user    The name of the user for which print requests are
                to be cancelled. Specify user as a username.






SunOS 5.11          Last change: 10 Dec 2009                    1






User Commands                                           cancel(1)



OPERANDS
     The following operands are supported:

     destination    The destination on which the  print  requests
                    are  to  be canceled. destination is the name
                    of  a  printer  or  class  of  printers  (see
                    lpadmin(1M)).  If  destination  is not speci-
                    fied,  cancel  cancels  the  requested  print
                    request on all destinations. Specify destina-
                    tion      using       atomic,       URI-style
                    (scheme://endpoint),      or      POSIX-style
                    (server:destination), names.  See  Notes  for
                    information   regarding  using  URI-style  or
                    POSIX-style destination  names  with  cancel.
                    See printers.conf(4) for more information.


     request-ID     The print request  to  be  canceled.  Specify
                    request-ID   using   LP-style   request   IDs
                    (destination-number).


     user           The name of the  user  for  which  the  print
                    requests are to be cancelled. Specify user as
                    a username.


EXIT STATUS
     The following exit values are returned:

     0           Successful completion.


     non-zero    An error occurred.


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


     $HOME/.printers         User-configurable printer database


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


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


ATTRIBUTES




SunOS 5.11          Last change: 10 Dec 2009                    2






User Commands                                           cancel(1)



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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWlp-cmds                 |
    |_____________________________|_____________________________|
    | Interface Stability         | Obsolete                    |
    |_____________________________|_____________________________|


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

NOTES
     URI-style     and     POSIX-style     destination      names
     (server:destination) are treated as print requests if desti-
     nation has the same format as an  LP-style  request-ID.  See
     standards(5).


     Some print servers send  cancellation  notification  to  job
     owners  when  their  print  jobs  have  been cancelled. This
     notification usually comes in the form of an email  message.
     Cancellation notices cannot be disabled on a Solaris server.


     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