man/cupsctl.man

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