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/OS X 10.8</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 <SPAN CLASS="info">CUPS 1.6</SPAN>ServerName foo.bar.com/version=1.1
  60 <SPAN CLASS="info">CUPS 1.6</SPAN>ServerName foo.bar.com:8631/version=1.1
  61 </PRE>
  62
  63 <H3>Description</H3>
  64
  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>
  66
  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>
  68
  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>
  70
  71 <P>The default is to use the local server ("<VAR>localhost</VAR>") or domain socket, if so configured.</P>
  72
  73 <BLOCKQUOTE><B>Note:</B>
  74 <P>Only one <CODE>ServerName</CODE> directive may appear. If multiple names are
  75 present, only the last one is used. This directive is not supported on OS X 10.7 or later.</P>
  76 </BLOCKQUOTE>
  77
  78
  79 <H2 CLASS="title"><SPAN CLASS="info">CUPS 1.6/OS X 10.8</SPAN><A NAME="User">User</A></H2>
  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
  93 </BODY>
  94 </HTML>