projects / thirdparty / cups.git / blame
| Commit | Line | Data |
|---|---|---|
| 1a18c85c | 1 | <!DOCTYPE HTML> |
| 94436c5a MS |
2 | <html> |
| 3 | <!-- SECTION: Man Pages --> | |
| 4 | <head> | |
| 5 | <link rel="stylesheet" type="text/css" href="../cups-printable.css"> | |
| 6 | <title>client.conf(5)</title> | |
| 7 | </head> | |
| 8 | <body> | |
| 9 | <h1 class="title">client.conf(5)</h1> | |
| 10 | <h2 class="title"><a name="NAME">Name</a></h2> | |
| 1a18c85c | 11 | client.conf - client configuration file for cups (deprecated) |
| 94436c5a | 12 | <h2 class="title"><a name="DESCRIPTION">Description</a></h2> |
| 1a18c85c MS |
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. | |
| 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: | |
| 19 | <dl class="man"> | |
| 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. | |
| 23 | The default is "Yes". | |
| 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. | |
| 27 | The default is "Yes". | |
| 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. | |
| 86243a75 MS |
41 | <dt><b>SSLOptions </b>[<i>AllowRC4</i>] [<i>AllowSSL3</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>AllowRC4</i> option enables the 128-bit RC4 cipher suites, which are required for some older clients that do not implement newer ones. | |
| 46 | The <i>AllowSSL3</i> option enables SSL v3.0, which is required for some older clients that do not support TLS v1.0. | |
| 1a18c85c MS |
47 | <dt><b>User </b><i>name</i> |
| 48 | <dd style="margin-left: 5.0em">Specifies the default user name to use for requests. | |
| 49 | <dt><b>ValidateCerts Yes</b> | |
| 50 | <dd style="margin-left: 5.0em"><dt><b>ValidateCerts No</b> | |
| 51 | <dd style="margin-left: 5.0em">Specifies whether to only allow TLS with certificates whose common name matches the hostname. | |
| 52 | The default is "No". | |
| 94436c5a | 53 | </dl> |
| 1a18c85c MS |
54 | <h2 class="title"><a name="NOTES">Notes</a></h2> |
| 55 | The <b>client.conf</b> file is deprecated and will no longer be supported in a future version of CUPS. | |
| 94436c5a | 56 | <h2 class="title"><a name="SEE_ALSO">See Also</a></h2> |
| 1a18c85c MS |
57 | <a href="man-cups.html?TOPIC=Man+Pages"><b>cups</b>(1),</a> |
| 58 | CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>) | |
| 94436c5a | 59 | <h2 class="title"><a name="COPYRIGHT">Copyright</a></h2> |
| 1a18c85c | 60 | Copyright © 2007-2014 by Apple Inc. |
| 94436c5a MS |
61 | |
| 62 | </body> | |
| 63 | </html> |