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