diff options
Diffstat (limited to 'man/cupsctl.man')
| -rw-r--r-- | man/cupsctl.man | 97 |
1 files changed, 53 insertions, 44 deletions
diff --git a/man/cupsctl.man b/man/cupsctl.man index 68953c064..b3703d237 100644 --- a/man/cupsctl.man +++ b/man/cupsctl.man @@ -1,97 +1,106 @@ .\" .\" "$Id$" .\" -.\" cupsctl man page for CUPS. +.\" cupsctl man page for CUPS. .\" -.\" Copyright 2007-2013 by Apple Inc. -.\" Copyright 2007 by Easy Software Products. +.\" Copyright 2007-2014 by Apple Inc. +.\" Copyright 2007 by Easy Software Products. .\" -.\" These coded instructions, statements, and computer programs are the -.\" property of Apple Inc. and are protected by Federal copyright -.\" law. Distribution and use rights are outlined in the file "LICENSE.txt" -.\" which should have been included with this file. If this file is -.\" file is missing or damaged, see the license at "http://www.cups.org/". +.\" These coded instructions, statements, and computer programs are the +.\" property of Apple Inc. and are protected by Federal copyright +.\" law. Distribution and use rights are outlined in the file "LICENSE.txt" +.\" which should have been included with this file. If this file is +.\" file is missing or damaged, see the license at "http://www.cups.org/". .\" -.TH cupsctl 8 "CUPS" "11 January 2013" "Apple Inc." +.TH cupsctl 8 "CUPS" "11 June 2014" "Apple Inc." .SH NAME cupsctl \- configure cupsd.conf options .SH SYNOPSIS .B cupsctl -[ -E ] [-U -.I username -] [ -h -.I server[:port] -] [ --[no-]debug-logging ] [ --[no-]remote-admin ] [ --[no-]remote-any ] -[ --[no-]share-printers ] [ --[no-]user-cancel-any ] [ +.B \-E +] [ +.B \-U +.I username +] [ +.B \-h +\fIserver\fR[\fB:\fIport\fR] +] [ +\fB\-\-\fR[\fBno\-\fR]\fBdebug\-logging\fR +] [ +\fB\-\-\fR[\fBno\-\fR]\fBremote\-admin\fR +] [ +\fB\-\-\fR[\fBno\-\fR]\fBremote\-any\fR +] [ +\fB\-\-\fR[\fBno\-\fR]\fBshare\-printers\fR +] [ +\fB\-\-\fR[\fBno\-\fR]\fBuser\-cancel\-any\fR +] [ .I name=value ] .SH DESCRIPTION -\fIcupsctl\fR updates or queries the \fBcupsd.conf\fR file for a server. When +\fBcupsctl\fR updates or queries the \fIcupsd.conf\fR file for a server. When no changes are requested, the current configuration values are written to the standard output in the format "name=value", one per line. .SH OPTIONS The following options are recognized: .TP 5 --E -.br +.B \-E Enables encryption on the connection to the scheduler. .TP 5 --U \fIusername\fR -.br +\fB\-U \fIusername\fR Specifies an alternate username to use when authenticating with the scheduler. .TP 5 --h \fIserver[:port]\fR -.br +\fB\-h \fIserver\fR[\fB:\fIport\fR] Specifies the server address. .TP 5 ---[no-]debug-logging -.br -Enables or disables debug logging in the \fBerror_log\fR file. +.B \-\-\fR[\fBno\-\fR]\fBdebug\-logging +Enables (disables) debug logging to the \fIerror_log\fR file. .TP 5 ---[no-]remote-admin -.br -Enables or disables remote administration. +.B \-\-\fR[\fBno\-\fR]\fBremote\-admin +Enables (disables) remote administration. .TP 5 ---[no-]remote-any -.br -Enables or disables printing from any address, e.g. the Internet. +.B \-\-\fR[\fBno\-\fR]\fBremote\-any +Enables (disables) printing from any address, e.g., the Internet. .TP 5 ---[no-]share-printers -.br -Enables or disables sharing of local printers with other computers. +.B \-\-\fR[\fBno\-\fR]\fBshare\-printers +Enables (disables) sharing of local printers with other computers. .TP 5 ---[no-]user-cancel-any -.br -Allows or prevents users from canceling jobs owned by others. +.B \-\-\fR[\fBno\-\fR]\fBuser\-cancel\-any +Allows (prevents) users to cancel jobs owned by others. .SH EXAMPLES Display the current settings: .nf + cupsctl + .fi -.LP Enable debug logging: .nf + cupsctl --debug-logging + .fi -.LP Get the current debug logging state: .nf + cupsctl | grep '^_debug_logging' | awk -F= '{print $2}' + .fi -.LP Disable printer sharing: .nf + cupsctl --no-share-printers .fi .SH KNOWN ISSUES -You cannot set the Listen or Port directives using \fIcupsctl\fR. +You cannot set the Listen or Port directives using \fBcupsctl\fR. .SH SEE ALSO -\fIcupsd.conf(5)\fR, \fIcupsd(8)\fR, +.BR cupsd.conf (5), +.BR cupsd (8), .br -http://localhost:631/help +CUPS Online Help (http://localhost:631/help) .SH COPYRIGHT -Copyright 2007-2013 by Apple Inc. +Copyright \[co] 2007-2014 by Apple Inc. .\" .\" End of "$Id$". .\" |