doc/help/man-cancel.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   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>
  11 cancel - cancel jobs
  12 <h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
  13 <b>cancel
  14 </b>[ -E ] [ -U
  15 <i>username
  16 </i>] [ -a ] [ -h
  17 <i>hostname[:port]
  18 </i>] [ -u
  19 <i>username
  20 </i>] [ -x ] [
  21 <i>id
  22 </i>] [
  23 <i>destination
  24 </i>] [
  25 <i>destination-id
  26 </i>]
  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
  29 all jobs from the specified destination.
  30 <h2 class="title"><a name="OPTIONS">Options</a></h2>
  31 The following options are recognized by <i>cancel</i>:
  32 <dl>
  33 <dt>-E
  34 </dt>
  35 <dd></dd>
  36 <dd>Forces encryption when connecting to the server.
  37 </dd>
  38 <dt>-U username
  39 </dt>
  40 <dd></dd>
  41 <dd>Specifies the username to use when connecting to the server.
  42 </dd>
  43 <dt>-a
  44 </dt>
  45 <dd></dd>
  46 <dd>Cancel all jobs on the named destination, or all jobs on all
  47 destinations if none is provided.
  48 </dd>
  49 <dt>-h hostname[:port]
  50 </dt>
  51 <dd></dd>
  52 <dd>Chooses an alternate server.
  53 </dd>
  54 <dt>-u username
  55 </dt>
  56 <dd></dd>
  57 <dd>Cancels jobs owned by <i>username</i>.
  58 </dd>
  59 <dt>-x
  60 </dt>
  61 <dd></dd>
  62 <dd>Deletes job data files in addition to canceling.
  63 </dd>
  64 </dl>
  65 <h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2>
  66 Unlike the System V printing system, CUPS allows printer names to
  67 contain any printable character except SPACE, TAB, "/", or "#".
  68 Also, printer and class names are <i>not</i> case-sensitive.
  69 <h2 class="title"><a name="NOTES">Notes</a></h2>
  70 Administrators wishing to prevent unauthorized cancellation of
  71 jobs via the <i>-u</i> option should require authentication for
  72 Cancel-Jobs operations in <a href='man-cupsd.conf.html?TOPIC=Man+Pages'>cupsd.conf(5)</a>.
  73 <h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
  74 <a href='man-lp.html?TOPIC=Man+Pages'>lp(1)</a>, <a href='man-lpmove.html?TOPIC=Man+Pages'>lpmove(8)</a>, <a href='man-lpstat.html?TOPIC=Man+Pages'>lpstat(1)</a>,
  75 <br>
  76 <a href='http://localhost:631/help'>http://localhost:631/help</a>
  77 <h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
  78 Copyright 2007-2013 by Apple Inc.
  79
  80 </body>
  81 </html>