doc/help/man-cupsenable.html

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