doc/help/man-cupsctl.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>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</b>
  14 [ -E ] [-U
  15 <i>username</i>
  16 ] [ -h
  17 <i>server[:port]</i>
  18 ] [ --[no-]debug-logging ] [ --[no-]remote-admin ] [ --[no-]remote-any ]
  19 [ --[no-]share-printers ] [ --[no-]user-cancel-any ]
  20 [
  21 <i>name=value</i>
  22 ]
  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 <p style="margin-left: 5.0em; text-indent: -5.0em">-E
  30 <br>
  31 <br>
  32 Enables encryption on the connection to the scheduler.
  33 <p style="margin-left: 5.0em; text-indent: -5.0em">-U <i>username</i>
  34 <br>
  35 <br>
  36 Specifies an alternate username to use when authenticating with the scheduler.
  37 <p style="margin-left: 5.0em; text-indent: -5.0em">-h <i>server[:port]</i>
  38 <br>
  39 <br>
  40 Specifies the server address.
  41 <p style="margin-left: 5.0em; text-indent: -5.0em">--[no-]debug-logging
  42 <br>
  43 <br>
  44 Enables or disables debug logging in the <b>error_log</b> file.
  45 <p style="margin-left: 5.0em; text-indent: -5.0em">--[no-]remote-admin
  46 <br>
  47 <br>
  48 Enables or disables remote administration.
  49 <p style="margin-left: 5.0em; text-indent: -5.0em">--[no-]remote-any
  50 <br>
  51 <br>
  52 Enables or disables printing from any address, e.g. the Internet.
  53 <p style="margin-left: 5.0em; text-indent: -5.0em">--[no-]share-printers
  54 <br>
  55 <br>
  56 Enables or disables sharing of local printers with other computers.
  57 <p style="margin-left: 5.0em; text-indent: -5.0em">--[no-]user-cancel-any
  58 <br>
  59 <br>
  60 Allows or prevents users from canceling jobs owned by others.
  61 <h2 class="title"><a name="EXAMPLES">Examples</a></h2>
  62 Display the current settings:
  63 <pre>
  64     cupsctl
  65 </pre>
  66 <p>Enable debug logging:
  67 <pre>
  68     cupsctl --debug-logging
  69 </pre>
  70 <p>Get the current debug logging state:
  71 <pre>
  72     cupsctl | grep '^_debug_logging' | awk -F= '{print $2}'
  73 </pre>
  74 <p>Disable printer sharing:
  75 <pre>
  76     cupsctl --no-share-printers
  77 </pre>
  78 <h2 class="title"><a name="KNOWN_ISSUES">Known Issues</a></h2>
  79 You cannot set the Listen or Port directives using <i>cupsctl</i>.
  80 <h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
  81 <i>cupsd.conf(5)</i>, <i>cupsd(8)</i>,
  82 <br>
  83 <a href="http://localhost:631/help">http://localhost:631/help</a>
  84 <h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
  85 Copyright 2007-2013 by Apple Inc.
  86
  87 </body>
  88 </html>