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