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#MaxCopies">MaxCopies</A></CODE></TD>
  76         <TD><CODE>@CUPS_MAX_COPIES@</CODE></TD>
  77 </TR>
  78 <TR>
  79         <TD><CODE><A HREF="ref-cupsd-conf.html#UseNetworkDefault">UseNetworkDefault</A></CODE></TD>
  80         <TD><CODE>@CUPS_USE_NETWORK_DEFAULT@</CODE></TD>
  81 </TR>
  82 </TABLE></DIV>
  83
  84
  85 <H2 CLASS="title"><A NAME="DIRECTORIES">Directories</A></H2>
  86
  87 <DIV CLASS="table"><TABLE SUMMARY="Directories">
  88 <CAPTION>Table 2: Directories</CAPTION>
  89 <TR>
  90         <TH>Directory</TH>
  91         <TH>Purpose</TH>
  92 </TR>
  93 <TR>
  94         <TD><VAR>@CUPS_SERVERROOT@</VAR></TD>
  95         <TD>The location of configuration files such as
  96         <VAR>printers.conf</VAR>. Overridden by the <A
  97         HREF="ref-cupsd-conf.html#ServerRoot"><CODE>ServerRoot</CODE></A>
  98         directive in <VAR>cupsd.conf</VAR>.</TD>
  99 </TR>
 100 <TR>
 101         <TD><VAR>@bindir@</VAR></TD>
 102         <TD>The location of user programs.</TD>
 103 </TR>
 104 <TR>
 105         <TD><VAR>@includedir@</VAR></TD>
 106         <TD>The location of CUPS include files.</TD>
 107 </TR>
 108 <TR>
 109         <TD><VAR>@libdir@</VAR></TD>
 110         <TD>The location of CUPS library files.</TD>
 111 </TR>
 112 <TR>
 113         <TD><VAR>@CUPS_SERVERBIN@</VAR></TD>
 114         <TD>The location of server programs such as backends and
 115         filters. Overridden by the <A
 116         HREF="ref-cupsd-conf.html#ServerBin"><CODE>ServerBin</CODE></A>
 117         directive in <VAR>cupsd.conf</VAR>.</TD>
 118 </TR>
 119 <TR>
 120         <TD><VAR>@sbindir@</VAR></TD>
 121         <TD>The location of administrator programs.</TD>
 122 </TR>
 123 <TR>
 124         <TD><VAR>@CUPS_DATADIR@</VAR></TD>
 125         <TD>The location of data files such as fonts. Overridden
 126         by the <A
 127         HREF="ref-cupsd-conf.html#DataDir"><CODE>DataDir</CODE></A>
 128         directive in <VAR>cupsd.conf</VAR>.</TD>
 129 </TR>
 130 <TR>
 131         <TD><VAR>@CUPS_DOCROOT@</VAR></TD>
 132         <TD>The location of documentation files. Overridden by
 133         the <A
 134         HREF="ref-cupsd-conf.html#DocumentRoot"><CODE>DocumentRoot</CODE></A>
 135         directive in <VAR>cupsd.conf</VAR>.</TD>
 136 </TR>
 137 <TR>
 138         <TD><VAR>@CUPS_LOCALEDIR@</VAR></TD>
 139         <TD>The location of localization files.</TD>
 140 </TR>
 141 <TR>
 142         <TD><VAR>@CUPS_CACHEDIR@</VAR></TD>
 143         <TD>The location of cache files such as
 144         <VAR>ppds.dat</VAR> and <VAR>remote.cache</VAR>.
 145         Overridden by the <A
 146         HREF="ref-cupsd-conf.html#CacheDir"><CODE>CacheDir</CODE></A>
 147         directive in <VAR>cupsd.conf</VAR>.</TD>
 148 </TR>
 149 <TR>
 150         <TD><VAR>@CUPS_LOGDIR@</VAR></TD>
 151         <TD>The location of the <VAR>access_log</VAR>,
 152         <VAR>error_log</VAR>, and <VAR>page_log</VAR> files.
 153         Overridden by the <A
 154         HREF="ref-cupsd-conf.html#AccessLog"><CODE>AccessLog</CODE></A>,
 155         <A
 156         HREF="ref-cupsd-conf.html#ErrorLog"><CODE>ErrorLog</CODE></A>,
 157         <A
 158         HREF="ref-cupsd-conf.html#PageLog"><CODE>PageLog</CODE></A>,
 159         directive in <VAR>cupsd.conf</VAR>.</TD>
 160 </TR>
 161 <TR>
 162         <TD><VAR>@CUPS_STATEDIR@</VAR></TD>
 163         <TD>The location of the domain socket file and state data
 164         such as authentication certificates. Overridden by the <A
 165         HREF="ref-cupsd-conf.html#StateDir"><CODE>StateDir</CODE></A>
 166         directive in <VAR>cupsd.conf</VAR>.</TD>
 167 </TR>
 168 <TR>
 169         <TD><VAR>@CUPS_REQUESTS@</VAR></TD>
 170         <TD>The location of spooled print jobs. Overridden by the
 171         <A
 172         HREF="ref-cupsd-conf.html#RequestRoot"><CODE>RequestRoot</CODE></A>
 173         directive in <VAR>cupsd.conf</VAR>.</TD>
 174 </TR>
 175 </TABLE></DIV>
 176
 177 </BODY>
 178 </HTML>