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

ATTRIBUTES

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)