]> git.ipfire.org Git - thirdparty/cups.git/blob - man/cupsctl.man
Fix 'it not'/'is not' typo in client.conf.man manpage
[thirdparty/cups.git] / man / cupsctl.man
1 .\"
2 .\" cupsctl man page for CUPS.
3 .\"
4 .\" Copyright 2007-2016 by Apple Inc.
5 .\" Copyright 2007 by Easy Software Products.
6 .\"
7 .\" These coded instructions, statements, and computer programs are the
8 .\" property of Apple Inc. and are protected by Federal copyright
9 .\" law. Distribution and use rights are outlined in the file "LICENSE.txt"
10 .\" which should have been included with this file. If this file is
11 .\" file is missing or damaged, see the license at "http://www.cups.org/".
12 .\"
13 .TH cupsctl 8 "CUPS" "30 May 2016" "Apple Inc."
14 .SH NAME
15 cupsctl \- configure cupsd.conf options
16 .SH SYNOPSIS
17 .B cupsctl
18 [
19 .B \-E
20 ] [
21 .B \-U
22 .I username
23 ] [
24 .B \-h
25 \fIserver\fR[\fB:\fIport\fR]
26 ] [
27 \fB\-\-\fR[\fBno\-\fR]\fBdebug\-logging\fR
28 ] [
29 \fB\-\-\fR[\fBno\-\fR]\fBremote\-admin\fR
30 ] [
31 \fB\-\-\fR[\fBno\-\fR]\fBremote\-any\fR
32 ] [
33 \fB\-\-\fR[\fBno\-\fR]\fBshare\-printers\fR
34 ] [
35 \fB\-\-\fR[\fBno\-\fR]\fBuser\-cancel\-any\fR
36 ] [
37 .I name=value
38 ]
39 .SH DESCRIPTION
40 \fBcupsctl\fR updates or queries the \fIcupsd.conf\fR file for a server. When
41 no changes are requested, the current configuration values are written to the
42 standard output in the format "name=value", one per line.
43 .SH OPTIONS
44 The following options are recognized:
45 .TP 5
46 .B \-E
47 Enables encryption on the connection to the scheduler.
48 .TP 5
49 \fB\-U \fIusername\fR
50 Specifies an alternate username to use when authenticating with the scheduler.
51 .TP 5
52 \fB\-h \fIserver\fR[\fB:\fIport\fR]
53 Specifies the server address.
54 .TP 5
55 \fB\-\-\fR[\fBno\-\fR]\fBdebug\-logging\fR
56 Enables (disables) debug logging to the \fIerror_log\fR file.
57 .TP 5
58 \fB\-\-\fR[\fBno\-\fR]\fBremote\-admin\fR
59 Enables (disables) remote administration.
60 .TP 5
61 \fB\-\-\fR[\fBno\-\fR]\fBremote\-any\fR
62 Enables (disables) printing from any address, e.g., the Internet.
63 .TP 5
64 \fB\-\-\fR[\fBno\-\fR]\fBshare\-printers\fR
65 Enables (disables) sharing of local printers with other computers.
66 .TP 5
67 \fB\-\-\fR[\fBno\-\fR]\fBuser\-cancel\-any\fR
68 Allows (prevents) users to cancel jobs owned by others.
69 .SH EXAMPLES
70 Display the current settings:
71 .nf
72
73 cupsctl
74
75 .fi
76 Enable debug logging:
77 .nf
78
79 cupsctl --debug-logging
80
81 .fi
82 Get the current debug logging state:
83 .nf
84
85 cupsctl | grep '^_debug_logging' | awk -F= '{print $2}'
86
87 .fi
88 Disable printer sharing:
89 .nf
90
91 cupsctl --no-share-printers
92 .fi
93 .SH KNOWN ISSUES
94 You cannot set the Listen or Port directives using \fBcupsctl\fR.
95 .SH SEE ALSO
96 .BR cupsd.conf (5),
97 .BR cupsd (8),
98 .br
99 CUPS Online Help (http://localhost:631/help)
100 .SH COPYRIGHT
101 Copyright \[co] 2007-2016 by Apple Inc.