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