|
Packit |
2fc92b |
.\"
|
|
Packit |
2fc92b |
.\" cancel man page for CUPS.
|
|
Packit |
2fc92b |
.\"
|
|
Packit |
2fc92b |
.\" Copyright 2007-2014 by Apple Inc.
|
|
Packit |
2fc92b |
.\" Copyright 1997-2006 by Easy Software Products.
|
|
Packit |
2fc92b |
.\"
|
|
Packit |
2fc92b |
.\" These coded instructions, statements, and computer programs are the
|
|
Packit |
2fc92b |
.\" property of Apple Inc. and are protected by Federal copyright
|
|
Packit |
2fc92b |
.\" law. Distribution and use rights are outlined in the file "LICENSE.txt"
|
|
Packit |
2fc92b |
.\" which should have been included with this file. If this file is
|
|
Packit |
2fc92b |
.\" file is missing or damaged, see the license at "http://www.cups.org/".
|
|
Packit |
2fc92b |
.\"
|
|
Packit |
2fc92b |
.TH cancel 1 "CUPS" "15 April 2014" "Apple Inc."
|
|
Packit |
2fc92b |
.SH NAME
|
|
Packit |
2fc92b |
cancel \- cancel jobs
|
|
Packit |
2fc92b |
.SH SYNOPSIS
|
|
Packit |
2fc92b |
.B cancel
|
|
Packit |
2fc92b |
[
|
|
Packit |
2fc92b |
.B \-E
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-U
|
|
Packit |
2fc92b |
.I username
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-a
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-h
|
|
Packit |
2fc92b |
.I hostname[:port]
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-u
|
|
Packit |
2fc92b |
.I username
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-x
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.I id
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.I destination
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.I destination\-id
|
|
Packit |
2fc92b |
]
|
|
Packit |
2fc92b |
.SH DESCRIPTION
|
|
Packit |
2fc92b |
The \fBcancel\fR command cancels print jobs.
|
|
Packit |
2fc92b |
If no \fIdestination\fR or \fIid\fR is specified, the currently printing job on the default destination is canceled.
|
|
Packit |
2fc92b |
.SH OPTIONS
|
|
Packit |
2fc92b |
The following options are recognized by \fBcancel\fR:
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-a
|
|
Packit |
2fc92b |
Cancel all jobs on the named destination, or all jobs on all
|
|
Packit |
2fc92b |
destinations if none is provided.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-E
|
|
Packit |
2fc92b |
Forces encryption when connecting to the server.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-h \fIhostname\fR[\fI:port\fR]
|
|
Packit |
2fc92b |
Specifies an alternate server.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-U \fIusername\fR
|
|
Packit |
2fc92b |
Specifies the username to use when connecting to the server.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
\fB\-u \fIusername\fR
|
|
Packit |
2fc92b |
Cancels jobs owned by \fIusername\fR.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-x
|
|
Packit |
2fc92b |
Deletes job data files in addition to canceling.
|
|
Packit |
2fc92b |
.SH CONFORMING TO
|
|
Packit |
2fc92b |
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.
|
|
Packit |
2fc92b |
.SH EXAMPLES
|
|
Packit |
2fc92b |
Cancel the current print job:
|
|
Packit |
2fc92b |
.nf
|
|
Packit |
2fc92b |
|
|
Packit |
2fc92b |
cancel
|
|
Packit |
2fc92b |
|
|
Packit |
2fc92b |
.fi
|
|
Packit |
2fc92b |
Cancel job "myprinter-42":
|
|
Packit |
2fc92b |
.nf
|
|
Packit |
2fc92b |
|
|
Packit |
2fc92b |
cancel myprinter\-42
|
|
Packit |
2fc92b |
|
|
Packit |
2fc92b |
.fi
|
|
Packit |
2fc92b |
Cancel all jobs:
|
|
Packit |
2fc92b |
.nf
|
|
Packit |
2fc92b |
|
|
Packit |
2fc92b |
cancel \-a
|
|
Packit |
2fc92b |
.fi
|
|
Packit |
2fc92b |
.SH NOTES
|
|
Packit |
2fc92b |
Administrators wishing to prevent unauthorized cancellation of jobs via the \fI\-u\fR option should require authentication for Cancel-Jobs operations in
|
|
Packit |
2fc92b |
.BR cupsd.conf (5).
|
|
Packit |
2fc92b |
.SH SEE ALSO
|
|
Packit |
2fc92b |
.BR cupsd.conf (5),
|
|
Packit |
2fc92b |
.BR lp (1),
|
|
Packit |
2fc92b |
.BR lpmove (8),
|
|
Packit |
2fc92b |
.BR lpstat (1),
|
|
Packit |
2fc92b |
CUPS Online Help (http://localhost:631/help)
|
|
Packit |
2fc92b |
.SH COPYRIGHT
|
|
Packit |
2fc92b |
Copyright \[co] 2007-2017 by Apple Inc.
|