]> git.pld-linux.org Git - projects/rc-scripts.git/blob - doc/sysconfig.docb
- updates in static-routes description
[projects/rc-scripts.git] / 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;fqdn by default, but 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>FORWARD_IPV4=yes|no</term>
86         <listitem><para>(The current Red Hat Linux installation
87           sets this to no by default for RFC compliance, but if
88           FORWARD_IPV4 is not set at all, forwarding is *enabled*
89           for compatibility with the configuration files used on
90           Red Hat Linux versions 4.2 and earlier.)</para>
91         </listitem>
92       </varlistentry>
93       <varlistentry><term>IGNORE_ICMP_BCAST_IPV4=yes|no</term>
94         <listitem><para>(Please note that if you accept ICMP echo
95             requests with a broadcast/multicast destination address your network
96             may be used as an exploder for denial of service packet flooding attacks
97             to other hosts.</para>
98         </listitem>
99       </varlistentry>
100       <varlistentry>
101         <term>SPOOFING_IPV4=yes|no</term>
102         <listitem>
103           <para>(anti spoofing protection)</para></listitem>
104       </varlistentry>
105
106       <varlistentry>
107         <term>GATEWAY=&lt;gateway IP></term>
108         <listitem>
109     <para>
110       </para>
111     
112         </listitem>
113       </varlistentry>
114
115       <varlistentry>
116         <term>GATEWAYDEV=&lt;gateway device></term>
117         <listitem>
118           <para>
119             (e.g. eth0)</para>
120         </listitem>
121       </varlistentry>
122
123       <varlistentry>
124         <term>NISDOMAIN=&lt;nis domain name></term>
125         <listitem>
126           <para></para>
127         </listitem>
128       </varlistentry>
129
130       <varlistentry>
131         <term>IPX=yes|no</term>
132         <listitem>
133     <para>
134       </para>
135         </listitem>
136       </varlistentry>
137
138       <varlistentry>
139         <term>IPXAUTOPRIMARY=on|off</term>
140         <listitem>
141     <para>
142        (note, that MUST be on|off, not yes|no)</para>
143         </listitem>
144       </varlistentry>
145
146       <varlistentry>
147         <term>IPXAUTOFRAME=on|off</term>
148         <listitem>
149     <para>
150        (again, not yes|no)</para>
151         </listitem>
152       </varlistentry>
153
154       <varlistentry>
155         <term>IPXINTERNALNETNUM=&lt;netnum></term>
156         <listitem>
157     <para>
158       </para>
159         </listitem>
160       </varlistentry>
161
162       <varlistentry>
163         <term>IPXINTERNALNODENUM=&lt;nodenum></term>
164         <listitem>
165     <para></para>
166         </listitem>
167       </varlistentry>
168     </variablelist>
169     <para>All the IPX stuff is optional, and should default to off.</para>
170   </refsect1>
171
172   <refsect1>
173     <title><filename>/etc/sysconfig/static-nat</filename></title>
174     <para>
175       Configuration file for static Network Address Translation (NAT).
176       Contains lines of the form:</para>
177     <para>
178 <literal>&lt;address> via &lt;addressreal></literal></para>
179     <para>
180       NAT will translate address &lt;address> to &lt;addressreal>.</para>
181   </refsect1>
182   <refsect1>
183     <title><filename>/etc/sysconfig/static-routes</filename></title>
184     <para>Contains lines of the form:</para>
185     <para><literal>&lt;device&gt; to [type] &lt;network&gt;/&lt;prefix&gt; via &lt;gateway&gt;</literal></para>
186     <para>&lt;device&gt; may be a device name to have the route brought up and
187       down with the device, or "none" if the route is not to be bound to any specific
188       device. [type] is optional. RH style isn't supported !</para>
189     <para>Also you can set few options after "&lt;gateway>":</para>
190       <simplelist columns=1>
191         <member>tos &lt;tos></member>
192         <member>metric &lt;number></member>
193         <member>table &lt;table></member>
194         <member>src &lt;address></member>
195         <member>realm &lt;realmid></member>
196         <member>mtu &lt;mtu> or mtu lock &lt;mtu></member>
197         <member>window &lt;number></member>
198         <member>rtt &lt;number></member>
199         <member>nexthop &lt;nexthop></member>
200         <member>scope &lt;scope></member>
201         <member>protocol &lt;rtproto></member>
202         <member>onlink</member>
203         <member>equalize</member>
204       </simplelist>
205
206     <para>For more informations see iproute2 documentation .</para>
207   </refsect1>
208
209   <refsect1>
210     <title><filename>/etc/sysconfig/routed</filename></title>
211     <simplelist>
212       <member>SILENT=yes|no</member>
213       <member>EXPORT_GATEWAY=yes|no</member>
214     </simplelist>
215   </refsect1>
216
217   <refsect1>
218     <title><filename>/etc/sysconfig/pcmcia</filename></title>
219     <simplelist>
220       <member>PCMCIA=yes|no</member>
221       <member>PCIC=i82365|tcic</member>
222       <member>PCIC_OPTS=&lt;socket driver (i82365 or tcic) timing parameters></member>
223       <member>CORE_OPTS=&lt;pcmcia_core options></member>
224       <member>CARDMGR_OPTS=&lt;cardmgr options></member>
225     </simplelist>
226   </refsect1>
227
228   <refsect1>
229     <title><filename>/etc/sysconfig/amd</filename></title>
230     <variablelist>
231       <varlistentry><term>ADIR=/.automount</term>
232         <listitem><para>(normally never changed)</para></listitem>
233       </varlistentry>
234       <varlistentry><term>MOUNTPTS='/net /etc/amd.conf'</term>
235         <listitem><para>(standard automount stuff)</para></listitem>
236       </varlistentry>
237       <varlistentry><term>AMDOPTS=</term>
238         <listitem><para>(extra options for AMD)</para></listitem>
239       </varlistentry>
240     </variablelist>
241   </refsect1>
242
243   <refsect1>
244     <title><filename moreinfo="None">/etc/sysconfig/tape</filename></title>
245     <variablelist>
246       <varlistentry><term>DEV=/dev/nst0</term>
247         <listitem>
248           <para>
249             Tape device.  Use the non-rewinding one for these scripts.</para>
250           <para>
251             For SCSI tapes this is /dev/nst#, where # is the number of the
252             tape drive you want to use.  If you only have one then use
253             nst0.</para>
254           <para> 
255             For IDE tapes you use /dev/ht#, where # is the number of the tape
256             drive you want to use (usually ht0).</para>
257           <para>
258             For floppy tape drives use /dev/ftape.</para>
259         </listitem>
260       </varlistentry>
261
262       <varlistentry><term>ADMIN=root</term>
263         <listitem><para>Person to mail to if the backup fails for any reason</para>
264         </listitem>
265       </varlistentry>
266
267       <varlistentry>
268         <term>SLEEP=5</term>
269         <listitem>
270 <para>
271     Time to sleep between tape operations.  Some drives need a bit
272     more than others, but 5 seems to work for 8mm, 4mm, and DLT</para>
273         </listitem>
274       </varlistentry>
275
276       <varlistentry>
277         <term>BLOCKSIZE=32768</term>
278         <listitem>
279     <para>
280     This worked fine for 8mm, then 4mm, and now DLT.  An optimal
281     setting is probably however much data your drive writes at one
282     time.</para>
283         </listitem>
284       </varlistentry>
285
286       <varlistentry>
287         <term>SHORTDATE=$(date +%y:%m:%d:%H:%M)</term>
288         <listitem>
289    <para>
290     A short date string, used in backup log filenames.</para>
291         </listitem>
292       </varlistentry>
293       
294
295       <varlistentry>
296         <term>DAY=$(date +log-%y:%m:%d)</term>
297         <listitem>
298      <para>
299     This is used for the log file directory.</para>
300         </listitem>
301       </varlistentry>
302
303       <varlistentry>
304         <term>DATE=$(date)</term>
305         <listitem>
306     <para>
307     Regular date string, used in log files.</para>
308         </listitem>
309       </varlistentry>
310
311       <varlistentry>
312         <term>LOGROOT=/var/log/backup</term>
313         <listitem>
314     <para>
315     Root of the logging directory</para>
316         </listitem>
317       </varlistentry>
318
319       <varlistentry>
320         <term>LIST=$LOGROOT/incremental-list</term>
321         <listitem>
322     <para>
323     This is the file name the incremental backup will use to store
324     the incremental list.  It will be $LIST-{some number}.
325     </para>
326         </listitem>
327       </varlistentry>
328
329       <varlistentry>
330         <term>DOTCOUNT=$LOGROOT/.count</term>
331         <listitem>
332     <para>
333     For counting as you go to know which incremental list to use
334     </para>
335         </listitem>
336       </varlistentry>
337
338
339       <varlistentry>
340         <term>COUNTER=$LOGROOT/counter-file</term>
341         <listitem>
342     <para>
343     For rewinding when done...might not use.
344     </para>
345         </listitem>
346       </varlistentry>
347
348       <varlistentry>
349         <term>BACKUPTAB=/etc/backuptab</term>
350         <listitem>
351     <para>
352     The file in which we keep our list of backup(s) we want to make.
353     </para>
354         </listitem>
355       </varlistentry>
356     </variablelist>
357   </refsect1>
358
359   <refsect1>
360     <title><filename>/etc/sysconfig/sendmail</filename></title>
361       <variablelist>
362         <varlistentry>
363           <term>DAEMON=yes|no</term>
364           <listitem>
365             <para>yes implies -bd</para>
366           </listitem>
367         </varlistentry>
368         <varlistentry>
369           <term>QUEUE=1h</term>
370           <listitem>
371             <para>given to sendmail as -q$QUEUE
372               -q option is not given to sendmail if /etc/sysconfig/sendmail
373               exists and QUEUE is empty or undefined.</para></listitem>
374         </varlistentry>
375       </variablelist>
376   </refsect1>
377
378   <refsect1>
379     <title><filename>/etc/sysconfig/i18n</filename></title>
380       <simplelist>
381         <member>LANG= can be any two letter ISO language code</member>
382         <member>
383           LC_ALL= is the setting of the localedata configuration (eg fr_CA)</member>
384         <member>
385           LINGUAS= can be a : separated list of language codes</member>
386         <member>
387           SYSTERM= use to set default TERM environment variable</member>
388       </simplelist>
389         <para>
390           The above three variables are used in rc.sysinit.</para>
391     <variablelist>
392       <varlistentry>
393         <term>SYSFONT= any font that is legal when used as</term>
394         <listitem>
395           <para>        /usr/sbin/setfont $SYSFONT ...
396     (See kbd package for sysfont command)
397 </para> </listitem>
398       </varlistentry>
399       <varlistentry>
400         <term>UNIMAP= any unicode font that is legal fodder for</term>
401         <listitem>
402           <para>/usr/sbin/setfont $SYSFONT-u $UNIMAP</para>
403         </listitem>
404       </varlistentry>
405     </variablelist>
406     <para>
407       The above is used by the /sbin/setsysfont command (which is run
408       by rc.sysinit at boot time).
409     </para>
410   </refsect1>
411 </refentry>
412
413
414
415
416 <!-- to s± informacje dla emacsa -->
417 <!-- Keep this comment at the end of the file
418 Local variables:
419 mode: sgml
420 sgml-omittag:nil
421 sgml-shorttag:nil
422 sgml-minimize-attributes:nil
423 sgml-always-quote-attributes:t
424 sgml-indent-step:2
425 sgml-indent-data:t
426 sgml-parent-document:"rc-scripts.docb"
427 sgml-default-dtd-file:nil
428 sgml-exposed-tags:nil
429 sgml-local-catalogs:nil
430 sgml-local-ecat-files:nil
431 sgml-declaration:nil
432 sgml-validate-command:"nsgmls -s %s %s"
433 End:
434 -->
435                       
This page took 0.072567 seconds and 3 git commands to generate.