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>-h</b> 16<i>server</i>[<b>:</b><i>port</i>] 17] [ 18<b>-E</b> 19] [ 20<b>-U</b> 21<i>username</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. 48Note: This option must occur before all others. 49<dt><b>--</b>[<b>no-</b>]<b>debug-logging</b> 50<dd style="margin-left: 5.0em">Enables (disables) debug logging to the <i>error_log</i> file. 51<dt><b>--</b>[<b>no-</b>]<b>remote-admin</b> 52<dd style="margin-left: 5.0em">Enables (disables) remote administration. 53<dt><b>--</b>[<b>no-</b>]<b>remote-any</b> 54<dd style="margin-left: 5.0em">Enables (disables) printing from any address, e.g., the Internet. 55<dt><b>--</b>[<b>no-</b>]<b>share-printers</b> 56<dd style="margin-left: 5.0em">Enables (disables) sharing of local printers with other computers. 57<dt><b>--</b>[<b>no-</b>]<b>user-cancel-any</b> 58<dd style="margin-left: 5.0em">Allows (prevents) users to cancel jobs owned by others. 59</dl> 60<h2 class="title"><a name="EXAMPLES">Examples</a></h2> 61Display the current settings: 62<pre class="man"> 63 cupsctl 64 65</pre> 66Enable debug logging: 67<pre class="man"> 68 cupsctl --debug-logging 69 70</pre> 71Get the current debug logging state: 72<pre class="man"> 73 cupsctl | grep '^_debug_logging' | awk -F= '{print $2}' 74 75</pre> 76Disable printer sharing: 77<pre class="man"> 78 cupsctl --no-share-printers 79</pre> 80<h2 class="title"><a name="KNOWN_ISSUES">Known Issues</a></h2> 81You cannot set the Listen or Port directives using <b>cupsctl</b>. 82<h2 class="title"><a name="SEE_ALSO">See Also</a></h2> 83<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a> 84<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a> 85<br> 86CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>) 87<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2> 88Copyright © 2020-2024 by OpenPrinting. 89 90</body> 91</html> 92