]>
Commit | Line | Data |
---|---|---|
bd7854cb | 1 | .\" |
7131e285 | 2 | .\" cancel man page for CUPS. |
bd7854cb | 3 | .\" |
7131e285 MS |
4 | .\" Copyright 2007-2014 by Apple Inc. |
5 | .\" Copyright 1997-2006 by Easy Software Products. | |
bd7854cb | 6 | .\" |
7131e285 MS |
7 | .\" These coded instructions, statements, and computer programs are the |
8 | .\" property of Apple Inc. and are protected by Federal copyright | |
9 | .\" law. Distribution and use rights are outlined in the file "LICENSE.txt" | |
10 | .\" which should have been included with this file. If this file is | |
11 | .\" file is missing or damaged, see the license at "http://www.cups.org/". | |
bd7854cb | 12 | .\" |
7131e285 | 13 | .TH cancel 1 "CUPS" "15 April 2014" "Apple Inc." |
bd7854cb | 14 | .SH NAME |
7131e285 | 15 | cancel \- cancel jobs |
bd7854cb | 16 | .SH SYNOPSIS |
17 | .B cancel | |
7131e285 | 18 | [ |
e94cac03 | 19 | .B \-E |
7131e285 | 20 | ] [ |
e94cac03 | 21 | .B \-U |
bd7854cb | 22 | .I username |
7131e285 | 23 | ] [ |
e94cac03 | 24 | .B \-a |
7131e285 | 25 | ] [ |
e94cac03 | 26 | .B \-h |
bd7854cb | 27 | .I hostname[:port] |
7131e285 | 28 | ] [ |
e94cac03 | 29 | .B \-u |
bd7854cb | 30 | .I username |
7131e285 | 31 | ] [ |
e94cac03 | 32 | .B \-x |
7131e285 | 33 | ] [ |
bd7854cb | 34 | .I id |
35 | ] [ | |
36 | .I destination | |
37 | ] [ | |
7131e285 | 38 | .I destination\-id |
bd7854cb | 39 | ] |
40 | .SH DESCRIPTION | |
e94cac03 MS |
41 | The \fBcancel\fR command cancels print jobs. |
42 | If no \fIdestination\fR or \fIid\fR is specified, the currently printing job on the default destination is canceled. | |
bd7854cb | 43 | .SH OPTIONS |
7131e285 | 44 | The following options are recognized by \fBcancel\fR: |
bd7854cb | 45 | .TP 5 |
7131e285 | 46 | .B \-a |
bd7854cb | 47 | Cancel all jobs on the named destination, or all jobs on all |
48 | destinations if none is provided. | |
49 | .TP 5 | |
7131e285 MS |
50 | .B \-E |
51 | Forces encryption when connecting to the server. | |
52 | .TP 5 | |
53 | \fB\-h \fIhostname\fR[\fI:port\fR] | |
54 | Specifies an alternate server. | |
55 | .TP 5 | |
56 | \fB\-U \fIusername\fR | |
57 | Specifies the username to use when connecting to the server. | |
bd7854cb | 58 | .TP 5 |
7131e285 | 59 | \fB\-u \fIusername\fR |
bd7854cb | 60 | Cancels jobs owned by \fIusername\fR. |
db8b865d | 61 | .TP 5 |
7131e285 | 62 | .B \-x |
db8b865d | 63 | Deletes job data files in addition to canceling. |
7131e285 MS |
64 | .SH CONFORMING TO |
65 | 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. | |
66 | .SH EXAMPLES | |
67 | Cancel the current print job: | |
68 | .nf | |
69 | ||
70 | cancel | |
71 | ||
72 | .fi | |
73 | Cancel job "myprinter-42": | |
74 | .nf | |
75 | ||
76 | cancel myprinter\-42 | |
77 | ||
78 | .fi | |
79 | Cancel all jobs: | |
80 | .nf | |
81 | ||
82 | cancel \-a | |
83 | .fi | |
bd7854cb | 84 | .SH NOTES |
7131e285 MS |
85 | Administrators wishing to prevent unauthorized cancellation of jobs via the \fI\-u\fR option should require authentication for Cancel-Jobs operations in |
86 | .BR cupsd.conf (5). | |
bd7854cb | 87 | .SH SEE ALSO |
7131e285 MS |
88 | .BR cupsd.conf (5), |
89 | .BR lp (1), | |
90 | .BR lpmove (8), | |
91 | .BR lpstat (1), | |
92 | CUPS Online Help (http://localhost:631/help) | |
bd7854cb | 93 | .SH COPYRIGHT |
bd5a2f28 | 94 | Copyright \[co] 2007-2017 by Apple Inc. |