]> git.ipfire.org Git - thirdparty/cups.git/blame - doc/help/man-cancel.html
The ipptool program now supports EXPECT statements for collection member
[thirdparty/cups.git] / doc / help / man-cancel.html
CommitLineData
c277f98c 1<!DOCTYPE HTML>
94436c5a
MS
2<html>
3<!-- SECTION: Man Pages -->
4<head>
5 <link rel="stylesheet" type="text/css" href="../cups-printable.css">
6 <title>cancel(1)</title>
7</head>
8<body>
9<h1 class="title">cancel(1)</h1>
10<h2 class="title"><a name="NAME">Name</a></h2>
11cancel - cancel jobs
12<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
c277f98c
MS
13<b>cancel</b>
14[ -E ] [ -U
15<i>username</i>
16] [ -a ] [ -h
17<i>hostname[:port]</i>
18] [ -u
19<i>username</i>
20] [ -x ] [
21<i>id</i>
22] [
23<i>destination</i>
24] [
25<i>destination-id</i>
26]
94436c5a
MS
27<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
28<i>cancel</i> cancels existing print jobs. The <i>-a</i> option will remove
29all jobs from the specified destination.
30<h2 class="title"><a name="OPTIONS">Options</a></h2>
31The following options are recognized by <i>cancel</i>:
2909c66c
MS
32<dl class="man">
33<dt>-E
34<dd style="margin-left: 5.0em"><br>
c277f98c 35Forces encryption when connecting to the server.
2909c66c
MS
36<dt>-U username
37<dd style="margin-left: 5.0em"><br>
c277f98c 38Specifies the username to use when connecting to the server.
2909c66c
MS
39<dt>-a
40<dd style="margin-left: 5.0em"><br>
c277f98c 41Cancel all jobs on the named destination, or all jobs on all
94436c5a 42destinations if none is provided.
2909c66c
MS
43<dt>-h hostname[:port]
44<dd style="margin-left: 5.0em"><br>
c277f98c 45Chooses an alternate server.
2909c66c
MS
46<dt>-u username
47<dd style="margin-left: 5.0em"><br>
c277f98c 48Cancels jobs owned by <i>username</i>.
2909c66c
MS
49<dt>-x
50<dd style="margin-left: 5.0em"><br>
c277f98c 51Deletes job data files in addition to canceling.
2909c66c 52</dl>
94436c5a
MS
53<h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2>
54Unlike the System V printing system, CUPS allows printer names to
55contain any printable character except SPACE, TAB, "/", or "#".
56Also, printer and class names are <i>not</i> case-sensitive.
57<h2 class="title"><a name="NOTES">Notes</a></h2>
58Administrators wishing to prevent unauthorized cancellation of
59jobs via the <i>-u</i> option should require authentication for
c277f98c 60Cancel-Jobs operations in <i>cupsd.conf(5)</i>.
94436c5a 61<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
c277f98c 62<i>lp(1)</i>, <i>lpmove(8)</i>, <i>lpstat(1)</i>,
94436c5a 63<br>
c277f98c 64<a href="http://localhost:631/help">http://localhost:631/help</a>
94436c5a
MS
65<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
66Copyright 2007-2013 by Apple Inc.
67
68</body>
69</html>