NAME
rcancel — remove requests from a remote printer spooling queue
SYNOPSIS
/usr/sbin/rcancel
[id ...]
[printer]
[-a]
[-e]
[-u
user]
DESCRIPTION
The
rcancel
command removes a request, or requests,
from the spool queue of a remote printer.
rcancel
is invoked by the
cancel
command (see
lp(1)).
At least one
id
or the name of a
printer
must be specified.
This command is intended to be used only by the spool system
in response to the
cancel
command (see
lp(1)),
and should not be invoked directly.
Options
The
rcancel
command recognizes the following options:
- id
Specifying a request ID
(as returned by
lp
(see
lp(1)))
cancels the associated request, even if it is currently printing.
The maximum number of
ids
that can be specified is 50.
- printer
Name of the printer (for a complete list, use
lpstat
(see
lpstat(1))).
Specifying a
printer
cancels the request which is currently printing on that printer,
if the request is owned by the user.
If the
-a,
-e,
or the
-u
option is specified, this option only specifies the printer
on which to perform the corresponding cancel operation.
- -a
Remove all requests owned by the user on the specified printer (see
printer).
The owner is determined by the user's login name
and host name on the machine where the
lp
command was invoked.
- -e
Empty the spool queue of all requests for the specified
printer.
This form of invoking
rcancel
is useful only to users with appropriate privileges.
- -u user
Remove any requests queued belonging to that user (or users)
for the specified
printer.
You can repeat the
-u
option to specify more users.
The maximum number of users that can be specified is 50.
This form of invoking
rcancel
is useful only to users with appropriate privileges.
WARNINGS
A remote print request can be canceled
only from the system on which the the original
lp
command was issued, and if the restrict cancel
feature (see
lpadmin(1M))
is enabled for the specified printer,
a request belonging to this printer can be canceled
only by the system administrator or the user who requested it.
This command is intended to be used only by the spool system in
response to the
cancel
command (see
lp(1)),
and should not be invoked directly.
AUTHOR
rcancel
was developed by the University of California, Berkeley,
and HP.
FILES
/var/spool/lp/*
/var/adm/lp/*
/etc/lp/*
/usr/lib/lp/*
