doc/help/man-cupsctl.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>cupsctl(8)</title>
   7 </head>
   8 <body>
   9 <h1 class="title">cupsctl(8)</h1>
  10 <h2 class="title"><a name="NAME">Name</a></h2>
  11 cupsctl - configure cupsd.conf options
  12 <h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
  13 <b>cupsctl
  14 </b>[ -E ] [-U
  15 <i>username
  16 </i>] [ -h
  17 <i>server[:port]
  18 </i>] [ --[no-]debug-logging ] [ --[no-]remote-admin ] [ --[no-]remote-any ]
  19 [ --[no-]share-printers ] [ --[no-]user-cancel-any ]
  20 [
  21 <i>name=value
  22 </i>]
  23 <h2 class="title"><a name="DESCRIPTION">Description</a></h2>
  24 <i>cupsctl</i> updates or queries the <b>cupsd.conf</b> file for a server. When
  25 no changes are requested, the current configuration values are written to the
  26 standard output in the format "name=value", one per line.
  27 <h2 class="title"><a name="OPTIONS">Options</a></h2>
  28 The following options are recognized:
  29 <dl>
  30 <dt>-E
  31 </dt>
  32 <dd></dd>
  33 <dd>Enables encryption on the connection to the scheduler.
  34 </dd>
  35 <dt>-U <i>username</i>
  36 </dt>
  37 <dd></dd>
  38 <dd>Specifies an alternate username to use when authenticating with the scheduler.
  39 </dd>
  40 <dt>-h <i>server[:port]</i>
  41 </dt>
  42 <dd></dd>
  43 <dd>Specifies the server address.
  44 </dd>
  45 <dt>--[no-]debug-logging
  46 </dt>
  47 <dd></dd>
  48 <dd>Enables or disables debug logging in the <b>error_log</b> file.
  49 </dd>
  50 <dt>--[no-]remote-admin
  51 </dt>
  52 <dd></dd>
  53 <dd>Enables or disables remote administration.
  54 </dd>
  55 <dt>--[no-]remote-any
  56 </dt>
  57 <dd></dd>
  58 <dd>Enables or disables printing from any address, e.g. the Internet.
  59 </dd>
  60 <dt>--[no-]share-printers
  61 </dt>
  62 <dd></dd>
  63 <dd>Enables or disables sharing of local printers with other computers.
  64 </dd>
  65 <dt>--[no-]user-cancel-any
  66 </dt>
  67 <dd></dd>
  68 <dd>Allows or prevents users from canceling jobs owned by others.
  69 </dd>
  70 </dl>
  71 <h2 class="title"><a name="EXAMPLES">Examples</a></h2>
  72 Display the current settings:
  73 <pre>
  74     cupsctl
  75 </pre>
  76 <p>Enable debug logging:
  77 <pre>
  78     cupsctl --debug-logging
  79 </pre>
  80 <p>Get the current debug logging state:
  81 <pre>
  82     cupsctl | grep '^_debug_logging' | awk -F= '{print $2}'
  83 </pre>
  84 <p>Disable printer sharing:
  85 <pre>
  86     cupsctl --no-share-printers
  87 </pre>
  88 <h2 class="title"><a name="KNOWN_ISSUES">Known Issues</a></h2>
  89 You cannot set the Listen or Port directives using <i>cupsctl</i>.
  90 <h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
  91 <a href='man-cupsd.conf.html?TOPIC=Man+Pages'>cupsd.conf(5)</a>, <a href='man-cupsd.html?TOPIC=Man+Pages'>cupsd(8)</a>,
  92 <br>
  93 <a href='http://localhost:631/help'>http://localhost:631/help</a>
  94 <h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
  95 Copyright 2007-2013 by Apple Inc.
  96
  97 </body>
  98 </html>