/usr/share/cups/doc-root/help/ref-client-conf.html is in cups-server-common 1.7.2-0ubuntu1.11.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 | <HTML>
<!-- SECTION: References -->
<HEAD>
<TITLE>client.conf</TITLE>
<LINK REL="STYLESHEET" TYPE="text/css" HREF="../cups-printable.css">
</HEAD>
<BODY>
<H1 CLASS="title">client.conf</H1>
<P>The <VAR>/etc/cups/client.conf</VAR> and
<VAR>~/.cups/client.conf</VAR> files contain up to two directives
that determine how the client behaves. Each directive is listed
on a line by itself followed by its value. Comments are
introduced using the number sign ("#") character at the beginning
of a line.</P>
<H2 CLASS="title"><A NAME="Encryption">Encryption</A></H2>
<H3>Examples</H3>
<PRE CLASS="command">
Encryption Never
Encryption IfRequested
Encryption Required
Encryption Always
</PRE>
<H3>Description</H3>
<P>The <CODE>Encryption</CODE> directive specifies the default
encryption settings for the client.</P>
<P>The default setting is <VAR>IfRequested</VAR>.</P>
<H2 CLASS="title"><SPAN CLASS="info">CUPS 1.6/OS X 10.8</SPAN><A NAME="GSSServiceName">GSSServiceName</A></H2>
<H3>Examples</H3>
<PRE CLASS="command">
GSSServiceName http
GSSServiceName ipp
</PRE>
<H3>Description</H3>
<P>The <CODE>GSSServiceName</CODE> directive sets the Kerberos service name to use. The default is <CODE>http</CODE> for compatibility with Microsoft Windows.</P>
<H2 CLASS="title"><A NAME="ServerName">ServerName</A></H2>
<H3>Examples</H3>
<PRE CLASS="command">
ServerName foo.bar.com
ServerName 11.22.33.44
ServerName foo.bar.com:8631
<SPAN CLASS="info">CUPS 1.6</SPAN>ServerName foo.bar.com/version=1.1
<SPAN CLASS="info">CUPS 1.6</SPAN>ServerName foo.bar.com:8631/version=1.1
</PRE>
<H3>Description</H3>
<P>The <CODE>ServerName</CODE> directive specifies sets the remote server that is to be used for all client operations. That is, it redirects all client requests to the remote server.</P>
<P>The default port number is 631 but can be overridden by adding a colon followed by the desired port number to the value.</P>
<P>By default, CUPS 1.6 and later use IPP/2.0 to communicate with the server. Add "/version=1.1" to force IPP/1.1 which is required for CUPS 1.3.12 and earlier.</P>
<P>The default is to use the local server ("<VAR>localhost</VAR>") or domain socket, if so configured.</P>
<BLOCKQUOTE><B>Note:</B>
<P>Only one <CODE>ServerName</CODE> directive may appear. If multiple names are
present, only the last one is used. This directive is not supported on OS X 10.7 or later.</P>
</BLOCKQUOTE>
<H2 CLASS="title"><A NAME="SSLOptions">SSLOptions</A></H2>
<H3>Examples</H3>
<PRE CLASS="command">
SSLOptions None
SSLOptions AllowSSL3
SSLOptions AllowRC4
</PRE>
<H3>Description</H3>
<P>Sets encryption options (only in /etc/cups/client.conf). By
default, CUPS only supports encryption using TLS v1.0 or higher using
known secure cipher suites. The <i>AllowRC4</i> option enables the
128-bit RC4 cipher suites, which are required for some older clients
that do not implement newer ones. The <i>AllowSSL3</i> option enables
SSL v3.0, which is required for some older clients that do not support
TLS v1.0.</P>
<H2 CLASS="title"><SPAN CLASS="info">CUPS 1.6/OS X 10.8</SPAN><A NAME="User">User</A></H2>
<H3>Examples</H3>
<PRE CLASS="command">
User joe
User bob
</PRE>
<H3>Description</H3>
<P>The <CODE>User</CODE> directive sets the user name to use. The default is the username associated with the current login.</P>
</BODY>
</HTML>
|