]>
Commit | Line | Data |
---|---|---|
bc44d920 | 1 | .\" |
bf1bc4c6 | 2 | .\" cupsctl man page for CUPS. |
bc44d920 | 3 | .\" |
3bd2e630 | 4 | .\" Copyright 2007-2016 by Apple Inc. |
bf1bc4c6 | 5 | .\" Copyright 2007 by Easy Software Products. |
bc44d920 | 6 | .\" |
e3101897 | 7 | .\" Licensed under Apache License v2.0. See the file "LICENSE" for more information. |
bc44d920 | 8 | .\" |
3bd2e630 | 9 | .TH cupsctl 8 "CUPS" "30 May 2016" "Apple Inc." |
bc44d920 | 10 | .SH NAME |
11 | cupsctl \- configure cupsd.conf options | |
12 | .SH SYNOPSIS | |
13 | .B cupsctl | |
bc44d920 | 14 | [ |
bf1bc4c6 MS |
15 | .B \-E |
16 | ] [ | |
17 | .B \-U | |
18 | .I username | |
19 | ] [ | |
20 | .B \-h | |
21 | \fIserver\fR[\fB:\fIport\fR] | |
22 | ] [ | |
23 | \fB\-\-\fR[\fBno\-\fR]\fBdebug\-logging\fR | |
24 | ] [ | |
25 | \fB\-\-\fR[\fBno\-\fR]\fBremote\-admin\fR | |
26 | ] [ | |
27 | \fB\-\-\fR[\fBno\-\fR]\fBremote\-any\fR | |
28 | ] [ | |
29 | \fB\-\-\fR[\fBno\-\fR]\fBshare\-printers\fR | |
30 | ] [ | |
31 | \fB\-\-\fR[\fBno\-\fR]\fBuser\-cancel\-any\fR | |
32 | ] [ | |
bc44d920 | 33 | .I name=value |
34 | ] | |
35 | .SH DESCRIPTION | |
bf1bc4c6 | 36 | \fBcupsctl\fR updates or queries the \fIcupsd.conf\fR file for a server. When |
bc44d920 | 37 | no changes are requested, the current configuration values are written to the |
38 | standard output in the format "name=value", one per line. | |
39 | .SH OPTIONS | |
40 | The following options are recognized: | |
41 | .TP 5 | |
bf1bc4c6 | 42 | .B \-E |
bc44d920 | 43 | Enables encryption on the connection to the scheduler. |
44 | .TP 5 | |
bf1bc4c6 | 45 | \fB\-U \fIusername\fR |
bc44d920 | 46 | Specifies an alternate username to use when authenticating with the scheduler. |
47 | .TP 5 | |
bf1bc4c6 | 48 | \fB\-h \fIserver\fR[\fB:\fIport\fR] |
bc44d920 | 49 | Specifies the server address. |
50 | .TP 5 | |
3bd2e630 | 51 | \fB\-\-\fR[\fBno\-\fR]\fBdebug\-logging\fR |
bf1bc4c6 | 52 | Enables (disables) debug logging to the \fIerror_log\fR file. |
bc44d920 | 53 | .TP 5 |
3bd2e630 | 54 | \fB\-\-\fR[\fBno\-\fR]\fBremote\-admin\fR |
bf1bc4c6 | 55 | Enables (disables) remote administration. |
bc44d920 | 56 | .TP 5 |
3bd2e630 | 57 | \fB\-\-\fR[\fBno\-\fR]\fBremote\-any\fR |
bf1bc4c6 | 58 | Enables (disables) printing from any address, e.g., the Internet. |
bc44d920 | 59 | .TP 5 |
3bd2e630 | 60 | \fB\-\-\fR[\fBno\-\fR]\fBshare\-printers\fR |
bf1bc4c6 | 61 | Enables (disables) sharing of local printers with other computers. |
bc44d920 | 62 | .TP 5 |
3bd2e630 | 63 | \fB\-\-\fR[\fBno\-\fR]\fBuser\-cancel\-any\fR |
bf1bc4c6 | 64 | Allows (prevents) users to cancel jobs owned by others. |
bc44d920 | 65 | .SH EXAMPLES |
66 | Display the current settings: | |
67 | .nf | |
bf1bc4c6 | 68 | |
bc44d920 | 69 | cupsctl |
bf1bc4c6 | 70 | |
bc44d920 | 71 | .fi |
bc44d920 | 72 | Enable debug logging: |
73 | .nf | |
bf1bc4c6 | 74 | |
bc44d920 | 75 | cupsctl --debug-logging |
bf1bc4c6 | 76 | |
bc44d920 | 77 | .fi |
bc44d920 | 78 | Get the current debug logging state: |
79 | .nf | |
bf1bc4c6 | 80 | |
bc44d920 | 81 | cupsctl | grep '^_debug_logging' | awk -F= '{print $2}' |
bf1bc4c6 | 82 | |
bc44d920 | 83 | .fi |
bc44d920 | 84 | Disable printer sharing: |
85 | .nf | |
bf1bc4c6 | 86 | |
0cb67df3 | 87 | cupsctl --no-share-printers |
bc44d920 | 88 | .fi |
0268488e | 89 | .SH KNOWN ISSUES |
bf1bc4c6 | 90 | You cannot set the Listen or Port directives using \fBcupsctl\fR. |
bc44d920 | 91 | .SH SEE ALSO |
bf1bc4c6 MS |
92 | .BR cupsd.conf (5), |
93 | .BR cupsd (8), | |
bc44d920 | 94 | .br |
bf1bc4c6 | 95 | CUPS Online Help (http://localhost:631/help) |
bc44d920 | 96 | .SH COPYRIGHT |
bd5a2f28 | 97 | Copyright \[co] 2007-2017 by Apple Inc. |