3 <!-- SECTION: Man Pages -->
5 <link rel=
"stylesheet" type=
"text/css" href=
"../cups-printable.css">
6 <title>cupsctl(
8)
</title>
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>
21 <i>server
</i>[
<b>:
</b><i>port
</i>]
23 <b>--
</b>[
<b>no-
</b>]
<b>debug-logging
</b>
25 <b>--
</b>[
<b>no-
</b>]
<b>remote-admin
</b>
27 <b>--
</b>[
<b>no-
</b>]
<b>remote-any
</b>
29 <b>--
</b>[
<b>no-
</b>]
<b>share-printers
</b>
31 <b>--
</b>[
<b>no-
</b>]
<b>user-cancel-any
</b>
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
37 no changes are requested, the current configuration values are written to the
38 standard output in the format
"name=value", one per line.
39 <h2 class=
"title"><a name=
"OPTIONS">Options
</a></h2>
40 The following options are recognized:
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>--
</b>[
<b>no-
</b>]
<b>debug-logging
</b>
49 <dd style=
"margin-left: 5.0em">Enables (disables) debug logging to the
<i>error_log
</i> file.
50 <dt><b>--
</b>[
<b>no-
</b>]
<b>remote-admin
</b>
51 <dd style=
"margin-left: 5.0em">Enables (disables) remote administration.
52 <dt><b>--
</b>[
<b>no-
</b>]
<b>remote-any
</b>
53 <dd style=
"margin-left: 5.0em">Enables (disables) printing from any address, e.g., the Internet.
54 <dt><b>--
</b>[
<b>no-
</b>]
<b>share-printers
</b>
55 <dd style=
"margin-left: 5.0em">Enables (disables) sharing of local printers with other computers.
56 <dt><b>--
</b>[
<b>no-
</b>]
<b>user-cancel-any
</b>
57 <dd style=
"margin-left: 5.0em">Allows (prevents) users to cancel jobs owned by others.
59 <h2 class=
"title"><a name=
"EXAMPLES">Examples
</a></h2>
60 Display the current settings:
69 cupsctl --debug-logging
72 Get the current debug logging state:
75 cupsctl | grep '^_debug_logging' | awk -F= '{print $
2}'
78 Disable printer sharing:
81 cupsctl --no-share-printers
83 <h2 class=
"title"><a name=
"KNOWN_ISSUES">Known Issues
</a></h2>
84 You 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>
89 CUPS Online Help (
<a href=
"http://localhost:631/help">http://localhost:
631/help
</a>)
90 <h2 class=
"title"><a name=
"COPYRIGHT">Copyright
</a></h2>
91 Copyright
© 2007-
2018 by Apple Inc.