doc/sysconfig.docb

   1 <refentry>
   2   <refnamediv>
   3     <refname>/etc/sysconfig/</refname>
   4     <refpurpose>Basic system settings</refpurpose>
   5   </refnamediv>
   6   <refsect1>
   7     <title><filename moreinfo="None">/etc/sysconfig/clock</filename></title>
   8     <refsect2>
   9       <title>Deprecated values from earlier releases:</title>
  10       <variablelist>
  11         <varlistentry>
  12           <term>CLOCKMODE=GMT</term>
  13           <listitem><para>indicates that the clock is set to UTC</para></listitem>
  14         </varlistentry>
  15         <varlistentry>
  16           <term>CLOCKMODE=ARC</term>
  17           <listitem><para>on alpha only indicates the ARC console's
  18               42-year time offset is in effect</para>
  19           </listitem>
  20         </varlistentry>
  21       </variablelist>
  22     </refsect2>
  23     <refsect2>
  24       <title>Currently correct values:</title>
  25       <variablelist>
  26         <varlistentry>
  27           <term>UTC=true</term>
  28           <listitem><para>indicates that the clock is set to UTC; anything
  29               else indicates that it is set to local time</para>
  30           </listitem>
  31         </varlistentry>
  32         <varlistentry>
  33           <term>ARC=true</term>
  34           <listitem><para>on alpha only indicates the ARC console's
  35               42-year time offset is in effect; otherwise the normal
  36               Unix epoch is assumed</para>
  37           </listitem>
  38         </varlistentry>
  39       </variablelist>
  40     </refsect2>
  41   </refsect1>
  42   <refsect1>
  43     <title><filename moreinfo="None">/etc/sysconfig/keyboard</filename></title>
  44     <variablelist>
  45       <varlistentry>
  46         <term>KEYTABLE=&lt;keytable file></term>
  47         <listitem><para>for example:
  48             KEYTABLE="/usr/lib/kbd/keytables/us.map"</para>
  49         </listitem>
  50       </varlistentry>
  51     </variablelist>
  52   </refsect1>
  53
  54   <refsect1>
  55     <title><filename moreinfo="None">/etc/sysconfig/mouse</filename></title>
  56     <variablelist>
  57       <varlistentry>
  58         <term>MOUSETYPE=microsoft|mouseman|mousesystems|ps/2|msbm|logibm|atibm|
  59           logitech|mmseries|mmhittab</term>
  60         <listitem><para> </para>
  61         </listitem>
  62       </varlistentry>
  63       <varlistentry>
  64         <term>XEMU3=yes|no</term>
  65         <listitem><para>(emulate three buttons with two buttons whenever
  66             necessary, most notably in X)</para>
  67         </listitem>
  68       </varlistentry>
  69     </variablelist>
  70     <para>In addition, /dev/mouse points to the mouse device.</para>
  71   </refsect1>
  72   <refsect1>
  73     <title><filename moreinfo="None">/etc/sysconfig/network</filename></title>
  74     <variablelist>
  75       <varlistentry><term>NETWORKING=yes|no</term>
  76         <listitem><para>IPV6NETWORKING=yes|no</para>
  77         </listitem>
  78       </varlistentry>
  79       <varlistentry><term>HOSTNAME=$&lt;whatever hostname you want></term>
  80         <listitem><note><para> for compatibility with some old software people might
  81               install (like trn), the /etc/HOSTNAME file should contain the
  82               same value as here.</para></note>
  83         </listitem>
  84       </varlistentry>
  85       <varlistentry><term>IGNORE_ICMP_BCAST_IPV4=yes|no</term>
  86         <listitem><para>(Please note that if you accept ICMP echo
  87             requests with a broadcast/multicast destination address your network
  88             may be used as an exploder for denial of service packet flooding attacks
  89             to other hosts.</para>
  90         </listitem>
  91       </varlistentry>
  92       <varlistentry>
  93         <term>SPOOFING_IPV4=yes|no</term>
  94         <listitem>
  95           <para>(anti spoofing protection)</para></listitem>
  96       </varlistentry>
  97
  98       <varlistentry>
  99         <term>GATEWAY=&lt;gateway IP></term>
 100         <listitem>
 101     <para>
 102       </para>
 103
 104         </listitem>
 105       </varlistentry>
 106
 107       <varlistentry>
 108         <term>GATEWAYDEV=&lt;gateway device></term>
 109         <listitem>
 110           <para>
 111             (e.g. eth0)</para>
 112         </listitem>
 113       </varlistentry>
 114
 115       <varlistentry>
 116         <term>NISDOMAIN=&lt;nis domain name></term>
 117         <listitem>
 118           <para></para>
 119         </listitem>
 120       </varlistentry>
 121
 122       <varlistentry>
 123         <term>IPX=yes|no</term>
 124         <listitem>
 125     <para>
 126       </para>
 127         </listitem>
 128       </varlistentry>
 129
 130       <varlistentry>
 131         <term>IPXAUTOPRIMARY=on|off</term>
 132         <listitem>
 133     <para>
 134        (note, that MUST be on|off, not yes|no)</para>
 135         </listitem>
 136       </varlistentry>
 137
 138       <varlistentry>
 139         <term>IPXAUTOFRAME=on|off</term>
 140         <listitem>
 141     <para>
 142        (again, not yes|no)</para>
 143         </listitem>
 144       </varlistentry>
 145
 146       <varlistentry>
 147         <term>IPXINTERNALNETNUM=&lt;netnum></term>
 148         <listitem>
 149     <para>
 150       </para>
 151         </listitem>
 152       </varlistentry>
 153
 154       <varlistentry>
 155         <term>IPXINTERNALNODENUM=&lt;nodenum></term>
 156         <listitem>
 157     <para></para>
 158         </listitem>
 159       </varlistentry>
 160     </variablelist>
 161     <para>All the IPX stuff is optional, and should default to off.</para>
 162   </refsect1>
 163
 164   <refsect1>
 165     <title><filename>/etc/sysconfig/static-nat</filename></title>
 166     <para>
 167       Configuration file for static Network Address Translation (NAT).
 168       Contains lines of the form:</para>
 169     <para>
 170 <literal>&lt;address> via &lt;addressreal></literal></para>
 171     <para>
 172       NAT will translate address &lt;address> to &lt;addressreal>.</para>
 173   </refsect1>
 174   <refsect1>
 175     <title><filename>/etc/sysconfig/static-routes</filename></title>
 176     <para>Contains lines of the form:</para>
 177     <para><literal>&lt;device&gt; to [type] &lt;network&gt;/&lt;prefix&gt; via &lt;gateway&gt;</literal></para>
 178     <para>&lt;device&gt; may be a device name to have the route brought up and
 179       down with the device, or "none" if the route is not to be bound to any specific
 180       device. [type] is optional. RH style isn't supported !</para>
 181     <para>Also you can set few options after "&lt;gateway>":</para>
 182       <simplelist columns=1>
 183         <member>tos &lt;tos></member>
 184         <member>metric &lt;number></member>
 185         <member>table &lt;table></member>
 186         <member>src &lt;address></member>
 187         <member>realm &lt;realmid></member>
 188         <member>mtu &lt;mtu> or mtu lock &lt;mtu></member>
 189         <member>window &lt;number></member>
 190         <member>rtt &lt;number></member>
 191         <member>nexthop &lt;nexthop></member>
 192         <member>scope &lt;scope></member>
 193         <member>protocol &lt;rtproto></member>
 194         <member>onlink</member>
 195         <member>equalize</member>
 196       </simplelist>
 197
 198     <para>For more informations see iproute2 documentation .</para>
 199   </refsect1>
 200
 201   <refsect1>
 202     <title><filename>/etc/sysconfig/routed</filename></title>
 203     <simplelist>
 204       <member>SILENT=yes|no</member>
 205       <member>EXPORT_GATEWAY=yes|no</member>
 206     </simplelist>
 207   </refsect1>
 208
 209   <refsect1>
 210     <title><filename>/etc/sysconfig/pcmcia</filename></title>
 211     <simplelist>
 212       <member>PCMCIA=yes|no</member>
 213       <member>PCIC=i82365|tcic</member>
 214       <member>PCIC_OPTS=&lt;socket driver (i82365 or tcic) timing parameters></member>
 215       <member>CORE_OPTS=&lt;pcmcia_core options></member>
 216       <member>CARDMGR_OPTS=&lt;cardmgr options></member>
 217     </simplelist>
 218   </refsect1>
 219
 220   <refsect1>
 221     <title><filename>/etc/sysconfig/amd</filename></title>
 222     <variablelist>
 223       <varlistentry><term>ADIR=/.automount</term>
 224         <listitem><para>(normally never changed)</para></listitem>
 225       </varlistentry>
 226       <varlistentry><term>MOUNTPTS='/net /etc/amd.conf'</term>
 227         <listitem><para>(standard automount stuff)</para></listitem>
 228       </varlistentry>
 229       <varlistentry><term>AMDOPTS=</term>
 230         <listitem><para>(extra options for AMD)</para></listitem>
 231       </varlistentry>
 232     </variablelist>
 233   </refsect1>
 234
 235   <refsect1>
 236     <title><filename moreinfo="None">/etc/sysconfig/tape</filename></title>
 237     <variablelist>
 238       <varlistentry><term>DEV=/dev/nst0</term>
 239         <listitem>
 240           <para>
 241             Tape device.  Use the non-rewinding one for these scripts.</para>
 242           <para>
 243             For SCSI tapes this is /dev/nst#, where # is the number of the
 244             tape drive you want to use.  If you only have one then use
 245             nst0.</para>
 246           <para>
 247             For IDE tapes you use /dev/ht#, where # is the number of the tape
 248             drive you want to use (usually ht0).</para>
 249           <para>
 250             For floppy tape drives use /dev/ftape.</para>
 251         </listitem>
 252       </varlistentry>
 253
 254       <varlistentry><term>ADMIN=root</term>
 255         <listitem><para>Person to mail to if the backup fails for any reason</para>
 256         </listitem>
 257       </varlistentry>
 258
 259       <varlistentry>
 260         <term>SLEEP=5</term>
 261         <listitem>
 262 <para>
 263     Time to sleep between tape operations.  Some drives need a bit
 264     more than others, but 5 seems to work for 8mm, 4mm, and DLT</para>
 265         </listitem>
 266       </varlistentry>
 267
 268       <varlistentry>
 269         <term>BLOCKSIZE=32768</term>
 270         <listitem>
 271     <para>
 272     This worked fine for 8mm, then 4mm, and now DLT.  An optimal
 273     setting is probably however much data your drive writes at one
 274     time.</para>
 275         </listitem>
 276       </varlistentry>
 277
 278       <varlistentry>
 279         <term>SHORTDATE=$(date +%y:%m:%d:%H:%M)</term>
 280         <listitem>
 281    <para>
 282     A short date string, used in backup log filenames.</para>
 283         </listitem>
 284       </varlistentry>
 285
 286
 287       <varlistentry>
 288         <term>DAY=$(date +log-%y:%m:%d)</term>
 289         <listitem>
 290      <para>
 291     This is used for the log file directory.</para>
 292         </listitem>
 293       </varlistentry>
 294
 295       <varlistentry>
 296         <term>DATE=$(date)</term>
 297         <listitem>
 298     <para>
 299     Regular date string, used in log files.</para>
 300         </listitem>
 301       </varlistentry>
 302
 303       <varlistentry>
 304         <term>LOGROOT=/var/log/backup</term>
 305         <listitem>
 306     <para>
 307     Root of the logging directory</para>
 308         </listitem>
 309       </varlistentry>
 310
 311       <varlistentry>
 312         <term>LIST=$LOGROOT/incremental-list</term>
 313         <listitem>
 314     <para>
 315     This is the file name the incremental backup will use to store
 316     the incremental list.  It will be $LIST-{some number}.
 317     </para>
 318         </listitem>
 319       </varlistentry>
 320
 321       <varlistentry>
 322         <term>DOTCOUNT=$LOGROOT/.count</term>
 323         <listitem>
 324     <para>
 325     For counting as you go to know which incremental list to use
 326     </para>
 327         </listitem>
 328       </varlistentry>
 329
 330
 331       <varlistentry>
 332         <term>COUNTER=$LOGROOT/counter-file</term>
 333         <listitem>
 334     <para>
 335     For rewinding when done...might not use.
 336     </para>
 337         </listitem>
 338       </varlistentry>
 339
 340       <varlistentry>
 341         <term>BACKUPTAB=/etc/backuptab</term>
 342         <listitem>
 343     <para>
 344     The file in which we keep our list of backup(s) we want to make.
 345     </para>
 346         </listitem>
 347       </varlistentry>
 348     </variablelist>
 349   </refsect1>
 350
 351   <refsect1>
 352     <title><filename>/etc/sysconfig/sendmail</filename></title>
 353       <variablelist>
 354         <varlistentry>
 355           <term>DAEMON=yes|no</term>
 356           <listitem>
 357             <para>yes implies -bd</para>
 358           </listitem>
 359         </varlistentry>
 360         <varlistentry>
 361           <term>QUEUE=1h</term>
 362           <listitem>
 363             <para>given to sendmail as -q$QUEUE
 364               -q option is not given to sendmail if /etc/sysconfig/sendmail
 365               exists and QUEUE is empty or undefined.</para></listitem>
 366         </varlistentry>
 367       </variablelist>
 368   </refsect1>
 369
 370   <refsect1>
 371     <title><filename>/etc/sysconfig/i18n</filename></title>
 372       <simplelist>
 373         <member>LANG= can be any two letter ISO language code</member>
 374         <member>
 375           LC_ALL= is the setting of the localedata configuration (eg fr_CA)</member>
 376         <member>
 377           LINGUAS= can be a : separated list of language codes</member>
 378         <member>
 379           SYSTERM= use to set default TERM environment variable</member>
 380       </simplelist>
 381         <para>
 382           The above three variables are used in rc.sysinit.</para>
 383     <variablelist>
 384       <varlistentry>
 385         <term>SYSFONT= any font that is legal when used as</term>
 386         <listitem>
 387           <para>        /usr/sbin/setfont $SYSFONT ...
 388     (See kbd package for sysfont command)
 389 </para> </listitem>
 390       </varlistentry>
 391       <varlistentry>
 392         <term>UNIMAP= any unicode font that is legal fodder for</term>
 393         <listitem>
 394           <para>/usr/sbin/setfont $SYSFONT-u $UNIMAP</para>
 395         </listitem>
 396       </varlistentry>
 397     </variablelist>
 398     <para>
 399       The above is used by the /sbin/setsysfont command (which is run
 400       by rc.sysinit at boot time).
 401     </para>
 402   </refsect1>
 403 </refentry>
 404
 405
 406
 407
 408 <!-- to s± informacje dla emacsa -->
 409 <!-- Keep this comment at the end of the file
 410 Local variables:
 411 mode: sgml
 412 sgml-omittag:nil
 413 sgml-shorttag:nil
 414 sgml-minimize-attributes:nil
 415 sgml-always-quote-attributes:t
 416 sgml-indent-step:2
 417 sgml-indent-data:t
 418 sgml-parent-document:"rc-scripts.docb"
 419 sgml-default-dtd-file:nil
 420 sgml-exposed-tags:nil
 421 sgml-local-catalogs:nil
 422 sgml-local-ecat-files:nil
 423 sgml-declaration:nil
 424 sgml-validate-command:"nsgmls -s %s %s"
 425 End:
 426 -->
 427