3 <!-- SECTION: Man Pages -->
5 <link rel=
"stylesheet" type=
"text/css" href=
"../cups-printable.css">
6 <title>client.conf(
5)
</title>
9 <h1 class=
"title">client.conf(
5)
</h1>
10 <h2 class=
"title"><a name=
"NAME">Name
</a></h2>
11 client.conf - client configuration file for cups (deprecated)
12 <h2 class=
"title"><a name=
"DESCRIPTION">Description
</a></h2>
13 The
<b>client.conf
</b> file configures the CUPS client and is normally located in the
<i>/etc/cups
</i> and/or
<i>~/.cups
</i> directories.
14 Each line in the file can be a configuration directive, a blank line, or a comment. Comment lines start with the # character.
15 <p><b>Note:
</b> Starting with OS X
10.7, this file is only used by command-line and X11 applications plus the IPP backend.
16 The
<b>ServerName
</b> directive is not supported on OS X at all.
17 <h3><a name=
"DIRECTIVES">Directives
</a></h3>
18 The following directives are understood by the client. Consult the online help for detailed descriptions:
20 <dt><b>AllowAnyRoot Yes
</b>
21 <dd style=
"margin-left: 5.0em"><dt><b>AllowAnyRoot No
</b>
22 <dd style=
"margin-left: 5.0em">Specifies whether to allow TLS with certificates that have not been signed by a trusted Certificate Authority.
24 <dt><b>AllowExpiredCerts Yes
</b>
25 <dd style=
"margin-left: 5.0em"><dt><b>AllowExpiredCerts No
</b>
26 <dd style=
"margin-left: 5.0em">Specifies whether to allow TLS with expired certificates.
28 <dt><b>Encryption IfRequested
</b>
29 <dd style=
"margin-left: 5.0em"><dt><b>Encryption Never
</b>
30 <dd style=
"margin-left: 5.0em"><dt><b>Encryption Required
</b>
31 <dd style=
"margin-left: 5.0em">Specifies the level of encryption that should be used.
32 <dt><b>GSSServiceName
</b><i>name
</i>
33 <dd style=
"margin-left: 5.0em">Specifies the Kerberos service name that is used for authentication, typically
"host",
"http", or
"ipp".
34 CUPS adds the remote hostname (
"name@server.example.com") for you. The default name is
"http".
35 <dt><b>ServerName
</b><i>hostname-or-ip-address
</i>[
<i>:port
</i>]
36 <dd style=
"margin-left: 5.0em"><dt><b>ServerName
</b><i>/domain/socket
</i>
37 <dd style=
"margin-left: 5.0em">Specifies the address and optionally the port to use when connecting to the server.
38 <b>Note: This directive it not supported on OS X
10.7 or later.
</b>
39 <dt><b>ServerName
</b><i>hostname-or-ip-address
</i>[
<i>:port
</i>]
<b>/version=
1.1</b>
40 <dd style=
"margin-left: 5.0em">Specifies the address and optionally the port to use when connecting to a server running CUPS
1.3.12 and earlier.
41 <dt><b>SSLOptions
</b>[
<i>AllowDH
</i>] [
<i>AllowRC4
</i>] [
<i>AllowSSL3
</i>] [
<i>DenyTLS1.0
</i>]
42 <dd style=
"margin-left: 5.0em"><dt><b>SSLOptions None
</b>
43 <dd style=
"margin-left: 5.0em">Sets encryption options (only in /etc/cups/client.conf).
44 By default, CUPS only supports encryption using TLS v1.0 or higher using known secure cipher suites.
45 The
<i>AllowDH
</i> option enables cipher suites using plain Diffie-Hellman key negotiation.
46 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.
47 The
<i>AllowSSL3
</i> option enables SSL v3.0, which is required for some older clients that do not support TLS v1.0.
48 The
<i>DenyTLS1.0
</i> option disables TLS v1.0 support - this sets the minimum protocol version to TLS v1.1.
49 <dt><b>User
</b><i>name
</i>
50 <dd style=
"margin-left: 5.0em">Specifies the default user name to use for requests.
51 <dt><b>ValidateCerts Yes
</b>
52 <dd style=
"margin-left: 5.0em"><dt><b>ValidateCerts No
</b>
53 <dd style=
"margin-left: 5.0em">Specifies whether to only allow TLS with certificates whose common name matches the hostname.
56 <h2 class=
"title"><a name=
"NOTES">Notes
</a></h2>
57 The
<b>client.conf
</b> file is deprecated and will no longer be supported in a future version of CUPS.
58 <h2 class=
"title"><a name=
"SEE_ALSO">See Also
</a></h2>
59 <a href=
"man-cups.html?TOPIC=Man+Pages"><b>cups
</b>(
1),
</a>
60 CUPS Online Help (
<a href=
"http://localhost:631/help">http://localhost:
631/help
</a>)
61 <h2 class=
"title"><a name=
"COPYRIGHT">Copyright
</a></h2>
62 Copyright
© 2007-
2015 by Apple Inc.