1cupsctl(8) Apple Inc. cupsctl(8)
2
3
4
6 cupsctl - configure cupsd.conf options
7
9 cupsctl [ -E ] [-U username ] [ -h server[:port] ] [ --[no-]debug-log‐
10 ging ] [ --[no-]remote-admin ] [ --[no-]remote-any ] [ --[no-]remote-
11 printers ] [ --[no-]share-printers ] [ --[no-]user-cancel-any ] [
12 name=value ]
13
15 cupsctl updates or queries the cupsd.conf file for a server. When no
16 changes are requested, the current configuration values are written to
17 the standard output in the format "name=value", one per line.
18
20 The following options are recognized:
21
22 -E
23 Enables encryption on the connection to the scheduler.
24
25 -U username
26 Specifies an alternate username to use when authenticating with
27 the scheduler.
28
29 -h server[:port]
30 Specifies the server address.
31
32 --[no-]debug-logging
33 Enables or disables debug logging in the error_log file.
34
35 --[no-]remote-admin
36 Enables or disables remote administration.
37
38 --[no-]remote-any
39 Enables or disables printing from any address, e.g. the Internet.
40
41 --[no-]remote-printers
42 Enables or disables the display of remote printers shared via the
43 CUPS, LDAP, or SLP protocols.
44
45 --[no-]share-printers
46 Enables or disables sharing of local printers with other comput‐
47 ers.
48
49 --[no-]user-cancel-any
50 Allows or prevents users from canceling jobs owned by others.
51
53 Display the current settings:
54 cupsctl
55
56 Enable debug logging:
57 cupsctl --debug-logging
58
59 Get the current debug logging state:
60 cupsctl | grep '^_debug_logging' | awk -F= '{print $2}'
61
62 Disable printer sharing:
63 cupsctl --no-shared-printers
64
65 Enable printing using the file: pseudo-device:
66 cupsctl FileDevice=Yes
67
69 You cannot set the Listen or Port directives using cupsctl.
70
72 cupsd.conf(5), cupsd(8),
73 http://localhost:631/help
74
76 Copyright 2007-2011 by Apple Inc.
77
78
79
8010 January 2011 CUPS cupsctl(8)