doc/help/standard.html.in

   1 <HTML>
   2 <!-- SECTION: Getting Started -->
   3 <HEAD>
   4         <TITLE>Standard Configuration</TITLE>
   5 </HEAD>
   6 <BODY>
   7
   8 <P>This document describes the standard configuration for this CUPS
   9 server.</P>
  10
  11 <BLOCKQUOTE><B>Note:</B>
  12
  13 <!-- Packagers: Change the following statement and the following sections
  14      if you make any changes to the standard CUPS distribution that are
  15      not automatically updated by the configure script. -->
  16 <P>This file reflects the standard CUPS configuration as distributed
  17 by Easy Software Products, the creator of CUPS.</P>
  18
  19 </BLOCKQUOTE>
  20
  21
  22 <H2 CLASS="title"><A NAME="CUPSD">cupsd Configuration</A></H2>
  23
  24 <P><CODE>cupsd(8)</CODE> is configured by default to show
  25 printers shared by other systems and only allow local access to
  26 the system and its printers. Administration operations require
  27 Basic authentication with membership in the group
  28 "@CUPS_GROUP@".</P>
  29
  30 <P>Connections are accepted via domain socket
  31 (<VAR>@CUPS_DEFAULT_DOMAINSOCKET@</VAR>) or "localhost"
  32 (127.0.0.1).</P>
  33
  34 <H3><A NAME="SETTINGS">Settings</A></H3>
  35
  36 <DIV CLASS="table"><TABLE SUMMARY="Default Values">
  37 <CAPTION>Table 1: Default Values</CAPTION>
  38 <TR>
  39         <TH>Directive</TH>
  40         <TH>Value</TH>
  41 </TR>
  42 <TR>
  43         <TD><CODE><A HREF="ref-cupsd-conf.html#Browsing">Browsing</A></CODE></TD>
  44         <TD><CODE>@CUPS_BROWSING@</CODE></TD>
  45 </TR>
  46 <TR>
  47         <TD><CODE><A HREF="ref-cupsd-conf.html#BrowseLocalProtocols">BrowseLocalProtocols</A></CODE></TD>
  48         <TD><CODE>@CUPS_BROWSE_LOCAL_PROTOCOLS@</CODE></TD>
  49 </TR>
  50 <TR>
  51         <TD><CODE><A HREF="ref-cupsd-conf.html#BrowseRemoteProtocols">BrowseRemoteProtocols</A></CODE></TD>
  52         <TD><CODE>@CUPS_BROWSE_REMOTE_PROTOCOLS@</CODE></TD>
  53 </TR>
  54 <TR>
  55         <TD><CODE><A HREF="ref-cupsd-conf.html#BrowseShortNames">BrowseShortNames</A></CODE></TD>
  56         <TD><CODE>@CUPS_BROWSE_SHORT_NAMES@</CODE></TD>
  57 </TR>
  58 <TR>
  59         <TD><CODE><A HREF="ref-cupsd-conf.html#ConfigFilePerm">ConfigFilePerm</A></CODE></TD>
  60         <TD><CODE>@CUPS_CONFIG_FILE_PERM@</CODE></TD>
  61 </TR>
  62 <TR>
  63         <TD><CODE><A HREF="ref-cupsd-conf.html#DefaultShared">DefaultShared</A></CODE></TD>
  64         <TD><CODE>@CUPS_DEFAULT_SHARED@</CODE></TD>
  65 </TR>
  66 <TR>
  67         <TD><CODE><A HREF="ref-cupsd-conf.html#ImplicitClasses">ImplicitClasses</A></CODE></TD>
  68         <TD><CODE>@CUPS_IMPLICIT_CLASSES@</CODE></TD>
  69 </TR>
  70 <TR>
  71         <TD><CODE><A HREF="ref-cupsd-conf.html#LogFilePerm">LogFilePerm</A></CODE></TD>
  72         <TD><CODE>@CUPS_LOG_FILE_PERM@</CODE></TD>
  73 </TR>
  74 <TR>
  75         <TD><CODE><A HREF="ref-cupsd-conf.html#UseNetworkDefault">UseNetworkDefault</A></CODE></TD>
  76         <TD><CODE>@CUPS_USE_NETWORK_DEFAULT@</CODE></TD>
  77 </TR>
  78 </TABLE></DIV>
  79
  80
  81 <H2 CLASS="title"><A NAME="DIRECTORIES">Directories</A></H2>
  82
  83 <DIV CLASS="table"><TABLE SUMMARY="Directories">
  84 <CAPTION>Table 2: Directories</CAPTION>
  85 <TR>
  86         <TH>Directory</TH>
  87         <TH>Purpose</TH>
  88 </TR>
  89 <TR>
  90         <TD><VAR>@CUPS_SERVERROOT@</VAR></TD>
  91         <TD>The location of configuration files such as
  92         <VAR>printers.conf</VAR>. Overridden by the <A
  93         HREF="ref-cupsd-conf.html#ServerRoot"><CODE>ServerRoot</CODE></A>
  94         directive in <VAR>cupsd.conf</VAR>.</TD>
  95 </TR>
  96 <TR>
  97         <TD><VAR>@bindir@</VAR></TD>
  98         <TD>The location of user programs.</TD>
  99 </TR>
 100 <TR>
 101         <TD><VAR>@includedir@</VAR></TD>
 102         <TD>The location of CUPS include files.</TD>
 103 </TR>
 104 <TR>
 105         <TD><VAR>@libdir@</VAR></TD>
 106         <TD>The location of CUPS library files.</TD>
 107 </TR>
 108 <TR>
 109         <TD><VAR>@CUPS_SERVERBIN@</VAR></TD>
 110         <TD>The location of server programs such as backends and
 111         filters. Overridden by the <A
 112         HREF="ref-cupsd-conf.html#ServerBin"><CODE>ServerBin</CODE></A>
 113         directive in <VAR>cupsd.conf</VAR>.</TD>
 114 </TR>
 115 <TR>
 116         <TD><VAR>@sbindir@</VAR></TD>
 117         <TD>The location of administrator programs.</TD>
 118 </TR>
 119 <TR>
 120         <TD><VAR>@CUPS_DATADIR@</VAR></TD>
 121         <TD>The location of data files such as fonts. Overridden
 122         by the <A
 123         HREF="ref-cupsd-conf.html#DataDir"><CODE>DataDir</CODE></A>
 124         directive in <VAR>cupsd.conf</VAR>.</TD>
 125 </TR>
 126 <TR>
 127         <TD><VAR>@CUPS_DOCROOT@</VAR></TD>
 128         <TD>The location of documentation files. Overridden by
 129         the <A
 130         HREF="ref-cupsd-conf.html#DocumentRoot"><CODE>DocumentRoot</CODE></A>
 131         directive in <VAR>cupsd.conf</VAR>.</TD>
 132 </TR>
 133 <TR>
 134         <TD><VAR>@CUPS_LOCALEDIR@</VAR></TD>
 135         <TD>The location of localization files.</TD>
 136 </TR>
 137 <TR>
 138         <TD><VAR>@CUPS_CACHEDIR@</VAR></TD>
 139         <TD>The location of cache files such as
 140         <VAR>ppds.dat</VAR> and <VAR>remote.cache</VAR>.
 141         Overridden by the <A
 142         HREF="ref-cupsd-conf.html#CacheDir"><CODE>CacheDir</CODE></A>
 143         directive in <VAR>cupsd.conf</VAR>.</TD>
 144 </TR>
 145 <TR>
 146         <TD><VAR>@CUPS_LOGDIR@</VAR></TD>
 147         <TD>The location of the <VAR>access_log</VAR>,
 148         <VAR>error_log</VAR>, and <VAR>page_log</VAR> files.
 149         Overridden by the <A
 150         HREF="ref-cupsd-conf.html#AccessLog"><CODE>AccessLog</CODE></A>,
 151         <A
 152         HREF="ref-cupsd-conf.html#ErrorLog"><CODE>ErrorLog</CODE></A>,
 153         <A
 154         HREF="ref-cupsd-conf.html#PageLog"><CODE>PageLog</CODE></A>,
 155         directive in <VAR>cupsd.conf</VAR>.</TD>
 156 </TR>
 157 <TR>
 158         <TD><VAR>@CUPS_STATEDIR@</VAR></TD>
 159         <TD>The location of the domain socket file and state data
 160         such as authentication certificates. Overridden by the <A
 161         HREF="ref-cupsd-conf.html#StateDir"><CODE>StateDir</CODE></A>
 162         directive in <VAR>cupsd.conf</VAR>.</TD>
 163 </TR>
 164 <TR>
 165         <TD><VAR>@CUPS_REQUESTS@</VAR></TD>
 166         <TD>The location of spooled print jobs. Overridden by the
 167         <A
 168         HREF="ref-cupsd-conf.html#RequestRoot"><CODE>RequestRoot</CODE></A>
 169         directive in <VAR>cupsd.conf</VAR>.</TD>
 170 </TR>
 171 </TABLE></DIV>
 172
 173 </BODY>
 174 </HTML>