X-Git-Url: http://git.ipfire.org/?p=thirdparty%2Fcups.git;a=blobdiff_plain;f=man%2Fcupsctl.man;fp=man%2Fcupsctl.man;h=38684b87dd842b8e7d054cffb4ba50dab2cb5009;hp=692d15a8cc29ec5256bce107b561a968e21174e8;hb=1a18c85cd15c6af88ec2c3a5ece0d67add6f56a7;hpb=b60086f8ae7ff126ecb97cf6d400d6d4a5c6f571 diff --git a/man/cupsctl.man b/man/cupsctl.man index 692d15a8c..38684b87d 100644 --- a/man/cupsctl.man +++ b/man/cupsctl.man @@ -1,97 +1,106 @@ .\" -.\" "$Id: cupsctl.man 11022 2013-06-06 22:14:09Z msweet $" +.\" "$Id: cupsctl.man 11920 2014-06-11 19:03:59Z msweet $" .\" -.\" 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: cupsctl.man 11022 2013-06-06 22:14:09Z msweet $". +.\" End of "$Id: cupsctl.man 11920 2014-06-11 19:03:59Z msweet $". .\"