cancel - cancel print request
cancel [request-ID...] [destination]...
cancel -u user... [destination]...
The cancel utility cancels print requests. There are two forms of the
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
The following options are supported:
The name of the user for which print requests are to be
cancelled. Specify user as a username.
The following operands are supported:
The destination on which the print requests are to be
is the name of a printer or class of printers
). If destination
is not specified, cancel
cancels the requested print request on all destinations. Specify
using atomic, URI-style
), or POSIX-style
), names. See Notes for information
regarding using URI-style or POSIX-style destination names with cancel
for more information.
The print request to be canceled. Specify
request-ID using LP-style request IDs
The name of the user for which the print requests are to
be cancelled. Specify user as a username.
The following exit values are returned:
An error occurred.
System printer configuration database
User-configurable printer database
LDAP version of /etc/printers.conf
NIS version of /etc/printers.conf
See attributes(7) for descriptions of the following attributes:
lp(1), lpstat(1), lpq(1B), lpr(1B), lprm(1B),
nsswitch.conf(5), printers(5), printers.conf(5),
attributes(7), standards(7), lpadmin(8)
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.