doc/help/man-cupsenable.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>cupsenable(8)</title>
   7 </head>
   8 <body>
   9 <h1 class="title">cupsenable(8)</h1>
  10 <h2 class="title"><a name="NAME">Name</a></h2>
  11 cupsdisable, cupsenable - stop/start printers and classes
  12 <h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
  13 <b>cupsdisable
  14 </b>[ -E ] [-U
  15 <i>username
  16 </i>] [ -c ] [ -h
  17 <i>server[:port]
  18 </i>] [ -r
  19 <i>reason
  20 </i>] [ --hold ] destination(s)
  21 <br>
  22 <b>cupsenable
  23 </b>[ -E ] [-U
  24 <i>username
  25 </i>] [ -c ] [ -h
  26 <i>server[:port]
  27 </i>] [ --release ] destination(s)
  28 <h2 class="title"><a name="DESCRIPTION">Description</a></h2>
  29 <i>cupsenable</i> starts the named printers or classes.
  30 <p><i>cupsdisable</i> stops the named printers or classes.  The
  31 following options may be used:
  32 <dl>
  33 <dt>-E
  34 </dt>
  35 <dd></dd>
  36 <dd>Forces encryption of the connection to the server.
  37 </dd>
  38 <dt>-U username
  39 </dt>
  40 <dd></dd>
  41 <dd>Uses the specified username when connecting to the server.
  42 </dd>
  43 <dt>-c
  44 </dt>
  45 <dd></dd>
  46 <dd>Cancels all jobs on the named destination.
  47 </dd>
  48 <dt>-h server[:port]
  49 </dt>
  50 <dd></dd>
  51 <dd>Uses the specified server and port.
  52 </dd>
  53 <dt>--hold
  54 </dt>
  55 <dd></dd>
  56 <dd>Holds remaining jobs on the named printer.  Useful for allowing the current
  57 job to complete before performing maintenance.
  58 </dd>
  59 <dt>-r "reason"
  60 </dt>
  61 <dd></dd>
  62 <dd>Sets the message associated with the stopped state. If no reason is specified
  63 then the message is set to "Reason Unknown".
  64 </dd>
  65 <dt>--release
  66 </dt>
  67 <dd></dd>
  68 <dd>Releases pending jobs for printing. Use after running <i>cupsdisable</i> with
  69 the <i>--hold</i> option to resume printing.
  70 </dd>
  71 </dl>
  72 <h2 class="title"><a name="COMPATIBILITY">Compatibility</a></h2>
  73 Unlike the System V printing system, CUPS allows printer names to
  74 contain any printable character except SPACE, TAB, "/", or "#".
  75 Also, printer and class names are <i>not</i> case-sensitive.
  76 <p>The System V versions of these commands are <i>disable</i> and
  77 <i>enable</i>. They have been renamed to avoid conflicts with the
  78 <i>bash(1)</i> build-in commands of the same name.
  79 <p>The CUPS versions of <i>disable</i> and <i>enable</i> may ask the
  80 user for an access password depending on the printing system
  81 configuration.  This differs from the System V versions which
  82 require the root user to execute these commands.
  83 <h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
  84 <a href='man-cupsaccept.html?TOPIC=Man+Pages'>cupsaccept(8)</a>, <i>cupsreject(8)</i>, <a href='man-cancel.html?TOPIC=Man+Pages'>cancel(1)</a>, <a href='man-lp.html?TOPIC=Man+Pages'>lp(1)</a>,
  85 <a href='man-lpadmin.html?TOPIC=Man+Pages'>lpadmin(8)</a>, <a href='man-lpstat.html?TOPIC=Man+Pages'>lpstat(1)</a>,
  86 <br>
  87 <a href='http://localhost:631/help'>http://localhost:631/help</a>
  88 <h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
  89 Copyright 2007-2013 by Apple Inc.
  90
  91
  92 </body>
  93 </html>