[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</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
</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>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 Mac OS X 10.7 or later.</P>
</BLOCKQUOTE>


<H2 CLASS="title"><SPAN CLASS="info">CUPS 1.6</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
dcb445bc MS	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
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
89d46774	59	</PRE>
ef416fc2	60
89d46774	61	<H3>Description</H3>
ef416fc2	62
f7deaa1a	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>
ef416fc2	64
f7deaa1a	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>
ef416fc2	68
dcb445bc MS	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
3e7fe0ca MS	74
	75	<H2 CLASS="title"><SPAN CLASS="info">CUPS 1.6</SPAN><A NAME="User">User</A></H2>
	76
	77	<H3>Examples</H3>
	78
	79	<PRE CLASS="command">
	80	User joe
	81	User bob
	82	</PRE>
	83
	84	<H3>Description</H3>
	85
	86	<P>The <CODE>User</CODE> directive sets the user name to use. The default is the username associated with the current login.</P>
	87
	88
ef416fc2	89	</BODY>
ef416fc2	90	</HTML>