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