| .\" |
| .\" "$Id: cancel.man 7600 2008-05-20 21:06:23Z mike $" |
| .\" |
| .\" cancel man page for CUPS. |
| .\" |
| .\" Copyright 2007-2011 by Apple Inc. |
| .\" Copyright 1997-2006 by Easy Software Products. |
| .\" |
| .\" These coded instructions, statements, and computer programs are the |
| .\" property of Apple Inc. and are protected by Federal copyright |
| .\" law. Distribution and use rights are outlined in the file "LICENSE.txt" |
| .\" which should have been included with this file. If this file is |
| .\" file is missing or damaged, see the license at "http://www.cups.org/". |
| .\" |
| .TH cancel 1 "CUPS" "20 March 2006" "Apple Inc." |
| .SH NAME |
| cancel - cancel jobs |
| .SH SYNOPSIS |
| .B cancel |
| [ -E ] [ -U |
| .I username |
| ] [ -a ] [ -h |
| .I hostname[:port] |
| ] [ -u |
| .I username |
| ] [ |
| .I id |
| ] [ |
| .I destination |
| ] [ |
| .I destination-id |
| ] |
| .SH DESCRIPTION |
| \fIcancel\fR cancels existing print jobs. The \fI-a\fR option will remove |
| all jobs from the specified destination. |
| .SH OPTIONS |
| The following options are recognized by \fIcancel\fR: |
| .TP 5 |
| -E |
| .br |
| Forces encryption when connecting to the server. |
| .TP 5 |
| -U username |
| .br |
| Specifies the username to use when connecting to the server. |
| .TP 5 |
| -a |
| .br |
| Cancel all jobs on the named destination, or all jobs on all |
| destinations if none is provided. |
| .TP 5 |
| -h hostname[:port] |
| .br |
| Chooses an alternate server. |
| .TP 5 |
| -u username |
| .br |
| Cancels jobs owned by \fIusername\fR. |
| .SH COMPATIBILITY |
| 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 NOTES |
| Administrators wishing to prevent unauthorized cancellation of |
| jobs via the \fI-u\fR option should require authentication for |
| Cancel-Jobs operations in \fIcupsd.conf(5)\fR. |
| .SH SEE ALSO |
| \fIlp(1)\fR, \fIlpmove(8)\fR, \fIlpstat(1)\fR, |
| .br |
| http://localhost:631/help |
| .SH COPYRIGHT |
| Copyright 2007-2011 by Apple Inc. |
| .\" |
| .\" End of "$Id: cancel.man 7600 2008-05-20 21:06:23Z mike $". |
| .\" |