2 .\" cupsctl man page for CUPS.
4 .\" Copyright 2007-2016 by Apple Inc.
5 .\" Copyright 2007 by Easy Software Products.
7 .\" Licensed under Apache License v2.0. See the file "LICENSE" for more information.
9 .TH cupsctl 8 "CUPS" "30 May 2016" "Apple Inc."
11 cupsctl \- configure cupsd.conf options
21 \fIserver\fR[\fB:\fIport\fR]
23 \fB\-\-\fR[\fBno\-\fR]\fBdebug\-logging\fR
25 \fB\-\-\fR[\fBno\-\fR]\fBremote\-admin\fR
27 \fB\-\-\fR[\fBno\-\fR]\fBremote\-any\fR
29 \fB\-\-\fR[\fBno\-\fR]\fBshare\-printers\fR
31 \fB\-\-\fR[\fBno\-\fR]\fBuser\-cancel\-any\fR
36 \fBcupsctl\fR updates or queries the \fIcupsd.conf\fR 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.
40 The following options are recognized:
43 Enables encryption on the connection to the scheduler.
46 Specifies an alternate username to use when authenticating with the scheduler.
48 \fB\-h \fIserver\fR[\fB:\fIport\fR]
49 Specifies the server address.
51 \fB\-\-\fR[\fBno\-\fR]\fBdebug\-logging\fR
52 Enables (disables) debug logging to the \fIerror_log\fR file.
54 \fB\-\-\fR[\fBno\-\fR]\fBremote\-admin\fR
55 Enables (disables) remote administration.
57 \fB\-\-\fR[\fBno\-\fR]\fBremote\-any\fR
58 Enables (disables) printing from any address, e.g., the Internet.
60 \fB\-\-\fR[\fBno\-\fR]\fBshare\-printers\fR
61 Enables (disables) sharing of local printers with other computers.
63 \fB\-\-\fR[\fBno\-\fR]\fBuser\-cancel\-any\fR
64 Allows (prevents) users to cancel jobs owned by others.
66 Display the current settings:
75 cupsctl --debug-logging
78 Get the current debug logging state:
81 cupsctl | grep '^_debug_logging' | awk -F= '{print $2}'
84 Disable printer sharing:
87 cupsctl --no-share-printers
90 You cannot set the Listen or Port directives using \fBcupsctl\fR.
95 CUPS Online Help (http://localhost:631/help)
97 Copyright \[co] 2007-2018 by Apple Inc.