ref-client-conf.html   [plain text]


<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
</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 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>