[thirdparty/cups.git] / doc / help / ref-client-conf.html

<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"><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>
Commit	Line	Data
ef416fc2	1	<HTML>
	2	<!-- SECTION: References -->
	3	<HEAD>
	4	<TITLE>client.conf</TITLE>
178cb736	5	<LINK REL="STYLESHEET" TYPE="text/css" HREF="../cups-printable.css">
ef416fc2	6	</HEAD>
	7	<BODY>
	8
178cb736 MS	9	<H1 CLASS="title">client.conf</H1>
178cb736 MS	10
89d46774	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>
ef416fc2	17
89d46774	18	<H2 CLASS="title"><A NAME="Encryption">Encryption</A></H2>
ef416fc2	19
89d46774	20	<H3>Examples</H3>
ef416fc2	21
89d46774	22	<PRE CLASS="command">
ef416fc2	23	Encryption Never
	24	Encryption IfRequested
	25	Encryption Required
	26	Encryption Always
89d46774	27	</PRE>
	28
	29	<H3>Description</H3>
ef416fc2	30
89d46774	31	<P>The <CODE>Encryption</CODE> directive specifies the default
89d46774	32	encryption settings for the client.</P>
ef416fc2	33
89d46774	34	<P>The default setting is <VAR>IfRequested</VAR>.</P>
ef416fc2	35
ef416fc2	36
f3c17241	37	<H2 CLASS="title"><SPAN CLASS="info">CUPS 1.6/OS X 10.8</SPAN><A NAME="GSSServiceName">GSSServiceName</A></H2>
dcb445bc MS	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
89d46774	51	<H2 CLASS="title"><A NAME="ServerName">ServerName</A></H2>
ef416fc2	52
89d46774	53	<H3>Examples</H3>
ef416fc2	54
89d46774	55	<PRE CLASS="command">
ef416fc2	56	ServerName foo.bar.com
ef416fc2	57	ServerName 11.22.33.44
f7deaa1a	58	ServerName foo.bar.com:8631
3699c637 MS	59	<SPAN CLASS="info">CUPS 1.6</SPAN>ServerName foo.bar.com/version=1.1
3699c637 MS	60	<SPAN CLASS="info">CUPS 1.6</SPAN>ServerName foo.bar.com:8631/version=1.1
89d46774	61	</PRE>
ef416fc2	62
89d46774	63	<H3>Description</H3>
ef416fc2	64
f7deaa1a	65	<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>
ef416fc2	66
f7deaa1a	67	<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>
f7deaa1a	68
3699c637 MS	69	<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>
3699c637 MS	70
f7deaa1a	71	<P>The default is to use the local server ("<VAR>localhost</VAR>") or domain socket, if so configured.</P>
ef416fc2	72
dcb445bc MS	73	<BLOCKQUOTE><B>Note:</B>
dcb445bc MS	74	<P>Only one <CODE>ServerName</CODE> directive may appear. If multiple names are
f3c17241	75	present, only the last one is used. This directive is not supported on OS X 10.7 or later.</P>
dcb445bc MS	76	</BLOCKQUOTE>
dcb445bc MS	77
3e7fe0ca	78
f3c17241	79	<H2 CLASS="title"><SPAN CLASS="info">CUPS 1.6/OS X 10.8</SPAN><A NAME="User">User</A></H2>
3e7fe0ca MS	80
	81	<H3>Examples</H3>
	82
	83	<PRE CLASS="command">
	84	User joe
	85	User bob
	86	</PRE>
	87
	88	<H3>Description</H3>
	89
	90	<P>The <CODE>User</CODE> directive sets the user name to use. The default is the username associated with the current login.</P>
	91
	92
ef416fc2	93	</BODY>
ef416fc2	94	</HTML>