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