1cancel(1) User Commands cancel(1)
2
6 cancel - cancel print request
7
9 cancel [request-ID...] [destination]...
10 cancel -u user... [destination]...
13
16 The cancel utility cancels print requests. There are two forms of the
17 cancel command.
18 The first form of cancel has two optional arguments: print requests
21 (request-ID) and destinations (destination). Specifying request-ID with
22 destination cancels request-ID on destination. Specifying only the des‐
23 tination cancels the current print request on destination. If destina‐
24 tion is not specified, cancel cancels the requested print request on
25 all destinations.
26 The second form of cancel cancels a user's print requests on specific
29 destinations.
30 Users can only cancel print requests associated with their username. By
33 default, users can only cancel print requests on the host from which
34 the print request was submitted. If a super-user has set user-equiva‐
35 lence=true in /etc/printers.conf on the print server, users can cancel
36 print requests associated with their username on any host. Super-users
37 can cancel print requests on the host from which the print request was
38 submitted. Superusers can also cancel print requests from the print
39 server.
40 The print client commands locate destination information using the
43 printers database in the name service switch. See nsswitch.conf(4),
44 printers(4), and printers.conf(4) for details.
45
47 The following options are supported:
48 -u user The name of the user for which print requests are to be can‐
50 celled. Specify user as a username.
51
54 The following operands are supported:
55 destination The destination on which the print requests are to be
57 canceled. destination is the name of a printer or class
58 of printers (see lpadmin(1M)). If destination is not
59 specified, cancel cancels the requested print request on
60 all destinations. Specify destination using atomic, URI-
61 style (scheme://endpoint), or POSIX-style (server:desti‐
62 nation), names. See Notes for information regarding
63 using URI-style or POSIX-style destination names with
64 cancel. See printers.conf(4) for more information.
65 request-ID The print request to be canceled. Specify request-ID
68 using LP-style request IDs (destination-number).
69 user The name of the user for which the print requests are to
72 be cancelled. Specify user as a username.
73
76 The following exit values are returned:
77 0 Successful completion.
79 non-zero An error occurred.
82
85 /etc/printers.conf System printer configuration database
86 $HOME/.printers User-configurable printer database
89 ou=printers LDAP version of /etc/printers.conf
92 printers.conf.byname NIS version of /etc/printers.conf
95 printers.org_dir NIS+ version of /etc/printers.conf
98
101 See attributes(5) for descriptions of the following attributes:
102 ┌─────────────────────────────┬─────────────────────────────┐
107 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
108 ├─────────────────────────────┼─────────────────────────────┤
109 │Availability │SUNWlp-cmds │
110 ├─────────────────────────────┼─────────────────────────────┤
111 │Interface Stability │Obsolete │
112 └─────────────────────────────┴─────────────────────────────┘
113
115 lp(1), lpq(1B), lpr(1B), lprm(1B), lpstat(1), lpadmin(1M), nss‐
116 witch.conf(4), printers(4), printers.conf(4), attributes(5), stan‐
117 dards(5)
118
120 URI-style and POSIX-style destination names (server:destination) are
121 treated as print requests if destination has the same format as an LP-
122 style request-ID. See standards(5).
123 Some print servers send cancelation notification to job owners when
126 their print jobs have been cancelled. This notification usually comes
127 in the form of an email message. Cancelation notices cannot be disabled
128 on a Solaris server.
129 When IPP is in use, the user is prompted for a passphsrase if the
132 remote print service is configured to require authentication.
133SunOS 5.11 26 May 2006 cancel(1)