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