|
|
.\"
|
|
|
.\" cancel man page for CUPS.
|
|
|
.\"
|
|
|
.\" Copyright © 2007-2019 by Apple Inc.
|
|
|
.\" Copyright © 1997-2006 by Easy Software Products.
|
|
|
.\"
|
|
|
.\" Licensed under Apache License v2.0. See the file "LICENSE" for more
|
|
|
.\" information.
|
|
|
.\"
|
|
|
.TH cancel 1 "CUPS" "26 April 2019" "Apple Inc."
|
|
|
.SH NAME
|
|
|
cancel \- cancel jobs
|
|
|
.SH SYNOPSIS
|
|
|
.B cancel
|
|
|
[
|
|
|
.B \-E
|
|
|
] [
|
|
|
.B \-U
|
|
|
.I username
|
|
|
] [
|
|
|
.B \-a
|
|
|
] [
|
|
|
.B \-h
|
|
|
.I hostname[:port]
|
|
|
] [
|
|
|
.B \-u
|
|
|
.I username
|
|
|
] [
|
|
|
.B \-x
|
|
|
] [
|
|
|
.I id
|
|
|
] [
|
|
|
.I destination
|
|
|
] [
|
|
|
.I destination\-id
|
|
|
]
|
|
|
.SH DESCRIPTION
|
|
|
The \fBcancel\fR command cancels print jobs.
|
|
|
If no \fIdestination\fR or \fIid\fR is specified, the currently printing job on the default destination is canceled.
|
|
|
.SH OPTIONS
|
|
|
The following options are recognized by \fBcancel\fR:
|
|
|
.TP 5
|
|
|
.B \-a
|
|
|
Cancel all jobs on the named destination, or all jobs on all
|
|
|
destinations if none is provided.
|
|
|
.TP 5
|
|
|
.B \-E
|
|
|
Forces encryption when connecting to the server.
|
|
|
.TP 5
|
|
|
\fB\-h \fIhostname\fR[\fI:port\fR]
|
|
|
Specifies an alternate server.
|
|
|
.TP 5
|
|
|
\fB\-U \fIusername\fR
|
|
|
Specifies the username to use when connecting to the server.
|
|
|
.TP 5
|
|
|
\fB\-u \fIusername\fR
|
|
|
Cancels jobs owned by \fIusername\fR.
|
|
|
.TP 5
|
|
|
.B \-x
|
|
|
Deletes job data files in addition to canceling.
|
|
|
.SH CONFORMING TO
|
|
|
Unlike the System V printing system, CUPS allows printer names to contain any printable character except SPACE, TAB, "/", or "#". Also, printer and class names are \fInot\fR case-sensitive.
|
|
|
.SH EXAMPLES
|
|
|
Cancel the current print job:
|
|
|
.nf
|
|
|
|
|
|
cancel
|
|
|
|
|
|
.fi
|
|
|
Cancel job "myprinter-42":
|
|
|
.nf
|
|
|
|
|
|
cancel myprinter\-42
|
|
|
|
|
|
.fi
|
|
|
Cancel all jobs:
|
|
|
.nf
|
|
|
|
|
|
cancel \-a
|
|
|
.fi
|
|
|
.SH NOTES
|
|
|
Administrators wishing to prevent unauthorized cancellation of jobs via the \fI\-u\fR option should require authentication for Cancel-Jobs operations in
|
|
|
.BR cupsd.conf (5).
|
|
|
.SH SEE ALSO
|
|
|
.BR cupsd.conf (5),
|
|
|
.BR lp (1),
|
|
|
.BR lpmove (8),
|
|
|
.BR lpstat (1),
|
|
|
CUPS Online Help (http://localhost:631/help)
|
|
|
.SH COPYRIGHT
|
|
|
Copyright \[co] 2007-2019 by Apple Inc.
|
