2 .\" "$Id: cupsctl.man 7600 2008-05-20 21:06:23Z mike $"
4 .\" cupsctl man page for CUPS.
6 .\" Copyright 2007-2011 by Apple Inc.
7 .\" Copyright 2007 by Easy Software Products.
9 .\" These coded instructions, statements, and computer programs are the
10 .\" property of Apple Inc. and are protected by Federal copyright
11 .\" law. Distribution and use rights are outlined in the file "LICENSE.txt"
12 .\" which should have been included with this file. If this file is
13 .\" file is missing or damaged, see the license at "http://www.cups.org/".
15 .TH cupsctl 8 "CUPS" "10 January 2011" "Apple Inc."
17 cupsctl \- configure cupsd.conf options
24 ] [ --[no-]debug-logging ] [ --[no-]remote-admin ] [ --[no-]remote-any ]
25 [ --[no-]remote-printers ] [ --[no-]share-printers ] [ --[no-]user-cancel-any ]
30 \fIcupsctl\fR updates or queries the \fBcupsd.conf\fR file for a server. When
31 no changes are requested, the current configuration values are written to the
32 standard output in the format "name=value", one per line.
34 The following options are recognized:
38 Enables encryption on the connection to the scheduler.
42 Specifies an alternate username to use when authenticating with the scheduler.
44 -h \fIserver[:port]\fR
46 Specifies the server address.
50 Enables or disables debug logging in the \fBerror_log\fR file.
54 Enables or disables remote administration.
58 Enables or disables printing from any address, e.g. the Internet.
60 --[no-]remote-printers
62 Enables or disables the display of remote printers shared via the CUPS, LDAP,
67 Enables or disables sharing of local printers with other computers.
69 --[no-]user-cancel-any
71 Allows or prevents users from canceling jobs owned by others.
73 Display the current settings:
80 cupsctl --debug-logging
83 Get the current debug logging state:
85 cupsctl | grep '^_debug_logging' | awk -F= '{print $2}'
88 Disable printer sharing:
90 cupsctl --no-shared-printers
93 Enable printing using the file: pseudo-device:
95 cupsctl FileDevice=Yes
98 You cannot set the Listen or Port directives using \fIcupsctl\fR.
100 \fIcupsd.conf(5)\fR, \fIcupsd(8)\fR,
102 http://localhost:631/help
104 Copyright 2007-2011 by Apple Inc.
106 .\" End of "$Id: cupsctl.man 7600 2008-05-20 21:06:23Z mike $".