95 lines
2.9 KiB
HTML
95 lines
2.9 KiB
HTML
<!DOCTYPE HTML>
|
|
<html>
|
|
<!-- SECTION: Man Pages -->
|
|
<head>
|
|
<link rel="stylesheet" type="text/css" href="../cups-printable.css">
|
|
<title>cupsctl(8)</title>
|
|
</head>
|
|
<body>
|
|
<h1 class="title">cupsctl(8)</h1>
|
|
<h2 class="title"><a name="NAME">Name</a></h2>
|
|
cupsctl - configure cupsd.conf options
|
|
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
|
|
<b>cupsctl</b>
|
|
[
|
|
<b>-E</b>
|
|
] [
|
|
<b>-U</b>
|
|
<i>username</i>
|
|
] [
|
|
<b>-h</b>
|
|
<i>server</i>[<b>:</b><i>port</i>]
|
|
] [
|
|
<b>--</b>[<b>no-</b>]<b>debug-logging</b>
|
|
] [
|
|
<b>--</b>[<b>no-</b>]<b>remote-admin</b>
|
|
] [
|
|
<b>--</b>[<b>no-</b>]<b>remote-any</b>
|
|
] [
|
|
<b>--</b>[<b>no-</b>]<b>share-printers</b>
|
|
] [
|
|
<b>--</b>[<b>no-</b>]<b>user-cancel-any</b>
|
|
] [
|
|
<i>name=value</i>
|
|
]
|
|
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
|
|
<b>cupsctl</b> updates or queries the <i>cupsd.conf</i> file for a server. When
|
|
no changes are requested, the current configuration values are written to the
|
|
standard output in the format "name=value", one per line.
|
|
<h2 class="title"><a name="OPTIONS">Options</a></h2>
|
|
The following options are recognized:
|
|
<dl class="man">
|
|
<dt><b>-E</b>
|
|
<dd style="margin-left: 5.0em">Enables encryption on the connection to the scheduler.
|
|
<dt><b>-U </b><i>username</i>
|
|
<dd style="margin-left: 5.0em">Specifies an alternate username to use when authenticating with the scheduler.
|
|
<dt><b>-h </b><i>server</i>[<b>:</b><i>port</i>]
|
|
<dd style="margin-left: 5.0em">Specifies the server address.
|
|
<dt><b>--</b>[<b>no-</b>]<b>debug-logging</b>
|
|
<dd style="margin-left: 5.0em">Enables (disables) debug logging to the <i>error_log</i> file.
|
|
<dt><b>--</b>[<b>no-</b>]<b>remote-admin</b>
|
|
<dd style="margin-left: 5.0em">Enables (disables) remote administration.
|
|
<dt><b>--</b>[<b>no-</b>]<b>remote-any</b>
|
|
<dd style="margin-left: 5.0em">Enables (disables) printing from any address, e.g., the Internet.
|
|
<dt><b>--</b>[<b>no-</b>]<b>share-printers</b>
|
|
<dd style="margin-left: 5.0em">Enables (disables) sharing of local printers with other computers.
|
|
<dt><b>--</b>[<b>no-</b>]<b>user-cancel-any</b>
|
|
<dd style="margin-left: 5.0em">Allows (prevents) users to cancel jobs owned by others.
|
|
</dl>
|
|
<h2 class="title"><a name="EXAMPLES">Examples</a></h2>
|
|
Display the current settings:
|
|
<pre class="man">
|
|
|
|
cupsctl
|
|
|
|
</pre>
|
|
Enable debug logging:
|
|
<pre class="man">
|
|
|
|
cupsctl --debug-logging
|
|
|
|
</pre>
|
|
Get the current debug logging state:
|
|
<pre class="man">
|
|
|
|
cupsctl | grep '^_debug_logging' | awk -F= '{print $2}'
|
|
|
|
</pre>
|
|
Disable printer sharing:
|
|
<pre class="man">
|
|
|
|
cupsctl --no-share-printers
|
|
</pre>
|
|
<h2 class="title"><a name="KNOWN_ISSUES">Known Issues</a></h2>
|
|
You cannot set the Listen or Port directives using <b>cupsctl</b>.
|
|
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
|
|
<b>cupsd.conf</b>(5),
|
|
<b>cupsd</b>(8),
|
|
<br>
|
|
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
|
|
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
|
|
Copyright © 2007-2019 by Apple Inc.
|
|
|
|
</body>
|
|
</html>
|