]> git.ipfire.org Git - thirdparty/cups.git/blob - doc/help/ref-client-conf.html
Merge changes from CUPS 1.6svn-r10188, including changes for <rdar://problem/10127258...
[thirdparty/cups.git] / doc / help / ref-client-conf.html
1 <HTML>
2 <!-- SECTION: References -->
3 <HEAD>
4 <TITLE>client.conf</TITLE>
5 <LINK REL="STYLESHEET" TYPE="text/css" HREF="../cups-printable.css">
6 </HEAD>
7 <BODY>
8
9 <H1 CLASS="title">client.conf</H1>
10
11 <P>The <VAR>/etc/cups/client.conf</VAR> and
12 <VAR>~/.cups/client.conf</VAR> files contain up to two directives
13 that determine how the client behaves. Each directive is listed
14 on a line by itself followed by its value. Comments are
15 introduced using the number sign ("#") character at the beginning
16 of a line.</P>
17
18 <H2 CLASS="title"><A NAME="Encryption">Encryption</A></H2>
19
20 <H3>Examples</H3>
21
22 <PRE CLASS="command">
23 Encryption Never
24 Encryption IfRequested
25 Encryption Required
26 Encryption Always
27 </PRE>
28
29 <H3>Description</H3>
30
31 <P>The <CODE>Encryption</CODE> directive specifies the default
32 encryption settings for the client.</P>
33
34 <P>The default setting is <VAR>IfRequested</VAR>.</P>
35
36
37 <H2 CLASS="title"><SPAN CLASS="info">CUPS 1.6</SPAN><A NAME="GSSServiceName">GSSServiceName</A></H2>
38
39 <H3>Examples</H3>
40
41 <PRE CLASS="command">
42 GSSServiceName http
43 GSSServiceName ipp
44 </PRE>
45
46 <H3>Description</H3>
47
48 <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>
49
50
51 <H2 CLASS="title"><A NAME="ServerName">ServerName</A></H2>
52
53 <H3>Examples</H3>
54
55 <PRE CLASS="command">
56 ServerName foo.bar.com
57 ServerName 11.22.33.44
58 ServerName foo.bar.com:8631
59 </PRE>
60
61 <H3>Description</H3>
62
63 <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>
64
65 <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>
66
67 <P>The default is to use the local server ("<VAR>localhost</VAR>") or domain socket, if so configured.</P>
68
69 <BLOCKQUOTE><B>Note:</B>
70 <P>Only one <CODE>ServerName</CODE> directive may appear. If multiple names are
71 present, only the last one is used. This directive is not supported on Mac OS X 10.7 or later.</P>
72 </BLOCKQUOTE>
73
74 </BODY>
75 </HTML>