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

     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.

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  for  infor-
                    mation  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

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

ATTRIBUTES

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

     When IPP is in use, the user is prompted for  a  passphsrase
     if the remote print service is configured to require authen-
     tication.