man/cupsctl.man

   1 .\"
   2 .\" "$Id: cupsctl.man 5969 2006-09-19 20:09:24Z mike $"
   3 .\"
   4 .\"   cupsctl man page for the Common UNIX Printing System (CUPS).
   5 .\"
   6 .\"   Copyright 2007 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 "Common UNIX Printing System" "5 July 2007" "Apple Inc."
  16 .SH NAME
  17 cupsctl \- configure cupsd.conf options
  18 .SH SYNOPSIS
  19 .B cupsctl
  20 [ -E ] [-U
  21 .I username
  22 ] [ -h
  23 .I server[:port]
  24 ] [ --[no-]debug-logging ] [ --[no-]remote-admin ] [ --[no-]remote-any ]
  25 [ --[no-]remote-printers ] [ --[no-]share-printers ] [ --[no-]user-cancel-any ]
  26 [
  27 .I name=value
  28 ]
  29 .SH DESCRIPTION
  30 \fIcupsctl\fR updates or queries the \fBcupsd.conf\fR file for a server. When
  31 no changes are requested, the current configuration values are written to the
  32 standard output in the format "name=value", one per line.
  33 .SH OPTIONS
  34 The following options are recognized:
  35 .TP 5
  36 -E
  37 .br
  38 Enables encryption on the connection to the scheduler.
  39 .TP 5
  40 -U \fIusername\fR
  41 .br
  42 Specifies an alternate username to use when authenticating with the scheduler.
  43 .TP 5
  44 -h \fIserver[:port]\fR
  45 .br
  46 Specifies the server address.
  47 .TP 5
  48 --[no-]debug-logging
  49 .br
  50 Enables or disables debug logging in the \fBerror_log\fR file.
  51 .TP 5
  52 --[no-]remote-admin
  53 .br
  54 Enables or disables remote administration.
  55 .TP 5
  56 --[no-]remote-any
  57 .br
  58 Enables or disables printing from any address, e.g. the Internet.
  59 .TP 5
  60 --[no-]remote-printers
  61 .br
  62 Enables or disables the display of remote printers shared via the CUPS, LDAP,
  63 or SLP protocols.
  64 .TP 5
  65 --[no-]share-printers
  66 .br
  67 Enables or disables sharing of local printers with other computers.
  68 .TP 5
  69 --[no-]user-cancel-any
  70 .br
  71 Allows or prevents users from canceling jobs owned by others.
  72 .SH EXAMPLES
  73 Display the current settings:
  74 .nf
  75     cupsctl
  76 .fi
  77 .LP
  78 Enable debug logging:
  79 .nf
  80     cupsctl --debug-logging
  81 .fi
  82 .LP
  83 Get the current debug logging state:
  84 .nf
  85     cupsctl | grep '^_debug_logging' | awk -F= '{print $2}'
  86 .fi
  87 .LP
  88 Disable printer sharing:
  89 .nf
  90     cupsctl --no-shared-printers
  91 .fi
  92 .LP
  93 Enable printing using the file: pseudo-device:
  94 .nf
  95     cupsctl FileDevice=Yes
  96 .fi
  97 .SH SEE ALSO
  98 \fIcupsd.conf(5)\fR, \fIcupsd(8)\fR,
  99 .br
 100 http://localhost:631/help
 101 .SH COPYRIGHT
 102 Copyright 2007 by Apple Inc.
 103 .\"
 104 .\" End of "$Id: cupsctl.man 5969 2006-09-19 20:09:24Z mike $".
 105 .\"