1cupsctl(8)                       OpenPrinting                       cupsctl(8)
2
3
4

NAME

6       cupsctl - configure cupsd.conf options
7

SYNOPSIS

9       cupsctl [ -h server[:port] ] [ -E ] [ -U username ] [ --[no-]debug-log‐
10       ging   ]   [   --[no-]remote-admin   ]   [   --[no-]remote-any   ]    [
11       --[no-]share-printers ] [ --[no-]user-cancel-any ] [ name=value ]
12

DESCRIPTION

14       cupsctl  updates  or  queries the cupsd.conf file for a server. When no
15       changes are requested, the current configuration values are written  to
16       the standard output in the format "name=value", one per line.
17

OPTIONS

19       The following options are recognized:
20
21       -E   Enables encryption on the connection to the scheduler.
22
23       -U username
24            Specifies  an  alternate  username to use when authenticating with
25            the scheduler.
26
27       -h server[:port]
28            Specifies the server address.  Note: This option must occur before
29            all others.
30
31       --[no-]debug-logging
32            Enables (disables) debug logging to the error_log file.
33
34       --[no-]remote-admin
35            Enables (disables) remote administration.
36
37       --[no-]remote-any
38            Enables (disables) printing from any address, e.g., the Internet.
39
40       --[no-]share-printers
41            Enables (disables) sharing of local printers with other computers.
42
43       --[no-]user-cancel-any
44            Allows (prevents) users to cancel jobs owned by others.
45

EXAMPLES

47       Display the current settings:
48
49           cupsctl
50
51       Enable debug logging:
52
53           cupsctl --debug-logging
54
55       Get the current debug logging state:
56
57           cupsctl | grep '^_debug_logging' | awk -F= '{print $2}'
58
59       Disable printer sharing:
60
61           cupsctl --no-share-printers
62

KNOWN ISSUES

64       You cannot set the Listen or Port directives using cupsctl.
65

SEE ALSO

67       cupsd.conf(5), cupsd(8),
68       CUPS Online Help (http://localhost:631/help)
69
71       Copyright © 2021-2023 by OpenPrinting.
72
73
74
752022-05-02                           CUPS                           cupsctl(8)
Impressum