CANCEL(1) 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). Specifying
request-ID with
destination cancels
request-ID on
destination. 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(5),
printers(5), and
printers.conf(5) 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(8)). If
destination is
not specified,
cancel cancels the requested print
request on all destinations. Specify
destination 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(5) 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 database
$HOME/.printers User-configurable printer database
ou=printers LDAP version of
/etc/printers.conf printers.conf.byname NIS version of
/etc/printers.confATTRIBUTES
See
attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Obsolete |
+--------------------+-----------------+
SEE ALSO
lp(1),
lpstat(1),
lpq(1B),
lpr(1B),
lprm(1B),
nsswitch.conf(5),
printers(5),
printers.conf(5),
attributes(7),
standards(7),
lpadmin(8)NOTES
URI-style and POSIX-style destination names (
server:
destination) are
treated as print requests if
destination has the same format as an
LP-style request-ID. See
standards(7).
Some print servers send cancellation notifications 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 authentication.
November 26, 2017 CANCEL(1)
