summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorA. Wilcox <AWilcox@Wilcox-Tech.com>2018-12-15 15:27:26 -0600
committerA. Wilcox <AWilcox@Wilcox-Tech.com>2018-12-15 15:27:26 -0600
commit67cf44b673798295db4d9e9c6c2a1af9dc77bb36 (patch)
tree70e905a2b5184bfb379587f02972f3543c08db10
parent94e7be5b855f4689a8148d92f7775798d3e29f33 (diff)
downloaddocs-67cf44b673798295db4d9e9c6c2a1af9dc77bb36.tar.gz
docs-67cf44b673798295db4d9e9c6c2a1af9dc77bb36.tar.bz2
docs-67cf44b673798295db4d9e9c6c2a1af9dc77bb36.tar.xz
docs-67cf44b673798295db4d9e9c6c2a1af9dc77bb36.zip
Admin: ch07: more files
-rw-r--r--src/admin/7_config.xml105
1 files changed, 103 insertions, 2 deletions
diff --git a/src/admin/7_config.xml b/src/admin/7_config.xml
index 5e58987..d971448 100644
--- a/src/admin/7_config.xml
+++ b/src/admin/7_config.xml
@@ -276,7 +276,7 @@
</section>
<section role="NotInToc">
<title>Detailed Information</title>
- <para>The <filename>/etc/conf.d/modules</filename> file allows you to specify additional kernel modules for the system to load during initialisation. This is typically unnecessary as the <package>eudev</pacakge> system will automatically load any modules required for the correct functioning of your hardware. However, some advanced use cases may require the loading of additional kernel modules.</para>
+ <para>The <filename>/etc/conf.d/modules</filename> file allows you to specify additional kernel modules for the system to load during initialisation. This is typically unnecessary as the <package>eudev</package> system will automatically load any modules required for the correct functioning of your hardware. However, some advanced use cases may require the loading of additional kernel modules.</para>
<para>The <filename>/etc/conf.d/modules</filename> file defines the <varname>modules</varname> configuration variables. This is a space-delimited list of modules to load.</para>
<para>For each module specified, an additional variable, <varname>module_<replaceable>MODNAME</replaceable>_args</varname>, is defined, where <replaceable>MODNAME</replaceable> is the name of the module. The <varname>module_<replaceable>MODNAME</replaceable>_args</varname> variable controls the arguments passed to the module. Refer to the documentation for each module for a list of arguments it supports.</para>
</section>
@@ -300,7 +300,7 @@
<title><filename>/etc/conf.d/urandom</filename>: Random number configuration</title>
<section role="NotInToc">
<title>Purpose</title>
- <para>The <filename>/etc/conf.d/urandom</filename> file specifies the path where the random number seed is stored when the system is shut down.</para>
+ <para>The <filename>/etc/conf.d/urandom</filename> file determines the path where the random number seed is stored when the system is shut down.</para>
</section>
<section role="NotInToc">
<title>Syntax</title>
@@ -311,4 +311,105 @@
<para>The <filename>/etc/conf.d/urandom</filename> file defines a single configuration variable, <varname>urandom_seed</varname>, which specifies the path in which to save the random number seed when the system is shut down. The default is <filename>/var/lib/misc/random-seed</filename>. This variable must point to a path that is on the root filesystem; if <filename class="directory">/var</filename> is a separate filesystem, you must configure this variable to use a different path.</para>
</section>
</section>
+ <section>
+ <title><filename>/etc/default/console-setup</filename>: Virtual terminal configuration</title>
+ <section role="NotInToc">
+ <title>Purpose</title>
+ <para>The <filename>/etc/default/console-setup</filename> file determines the configuration of the system virtual terminals or consoles. Note that this does not include graphical terminals run inside X11 (such as Konsole or XFCE Terminal).</para>
+ </section>
+ <section role="NotInToc">
+ <title>Syntax</title>
+ <para>Shell script style. Variables are in uppercase.</para>
+ </section>
+ <section role="NotInToc">
+ <title>External References</title>
+ <para>For more information, consult the official manual page for console-setup(5). This manual page is available in the <package>console-setup-doc</package> package. If your computer has an Internet connection, you may also read it <ulink url="https://manpages.debian.org/stable/console-setup/console-setup.5.en.html">on the Web</ulink>.</para>
+ </section>
+ </section>
+ <section>
+ <title><filename>/etc/default/keyboard</filename>: Console keyboard configuration</title>
+ <section role="NotInToc">
+ <title>Purpose</title>
+ <para>The <filename>/etc/default/keyboard</filename> file determines the configuration of the keyboard on the system virtual terminals or consoles. This file does not control the configuration of the keyboard inside X11 or a desktop environment (such as KDE or LXQt).</para>
+ </section>
+ <section role="NotInToc">
+ <title>Syntax</title>
+ <para>Shell script style. Variables are in uppercase.</para>
+ </section>
+ <section role="NotInToc">
+ <title>Detailed Information</title>
+ <para>The <filename>/etc/default/keyboard</filename> file is used by the <package>console-setup</package> package (when the <literal>console-setup</literal> service is enabled) to configure the keyboard model and layout in use on the system's virtual terminals. The most important variables in the <filename>/etc/default/keyboard</filename> file are the <varname>XKBMODEL</varname> variable, which controls the model of keyboard, and the <varname>XKBLAYOUT</varname> variable, which controls the layout of the keyboard.</para>
+ <para>In order to use additional keyboard layouts, you must install the <package>console-keymaps</package> package.</para>
+ </section>
+ <section role="NotInToc">
+ <title>External Resources</title>
+ <para>For more information, consult the official manual page for keyboard(5). This manual page is available in the <package>console-setup-doc</package> package. If your computer has an Internet connection, you may also read it <ulink url="https://manpages.debian.org/stable/console-setup/keyboard.5.en.html">on the Web</ulink>.</para>
+ </section>
+ </section>
+ <section>
+ <title><filename class="directory">/etc/dracut.conf.d/</filename>: Early system initialisation configuration</title>
+ <section role="NotInToc">
+ <title>Purpose</title>
+ <para>The <filename class="directory">/etc/dracut.conf.d</filename> directory contains files that determine the configuration of <package>dracut</package>, the initial RAM disk generation system for the Adélie Linux system. The initial RAM disk is needed on some computers during system initialisation; tasks it may perform include enabling access to a disk, unlocking an encrypted partition, or establishing a network connection.</para>
+ </section>
+ <section role="NotInToc">
+ <title>Syntax</title>
+ <para>Shell script style. Variables are in lowercase.</para>
+ </section>
+ <section role="NotInToc">
+ <title>External Resources</title>
+ <para>For more information, consult the dracut.conf(5) manual page. This manual page is available in the <package>dracut-doc</package> package.</para>
+ </section>
+ </section>
+ <section>
+ <title><filename>/etc/fstab</filename>: Filesystem mount point configuration</title>
+ <section role="NotInToc">
+ <title>Purpose</title>
+ <para>The <filename>/etc/fstab</filename> file determines the mount points of file systems on the hard disk(s) connected to a system. It may also control whether or not users may mount removable storage devices such as CD-ROM devices, and where they may mount them.</para>
+ </section>
+ <section role="NotInToc">
+ <title>Syntax</title>
+ <para>The syntax for <filename>/etc/fstab</filename> is columnar in nature. There may be any amount of whitespace between columns; the following two lines will be viewed identically to the system:</para>
+ <informalexample>
+<programlisting>
+/dev/sda1 /boot ext3 defaults 0 1
+/dev/sda1 /boot ext3 defaults 0 1
+</programlisting>
+ </informalexample>
+ </section>
+ <section role="NotInToc">
+ <title>External Resources</title>
+ <para>For more information, consult the fstab(5) manual page. This manual page is available in the <package>util-linux-doc</package> package.</para>
+ </section>
+ </section>
+ <section>
+ <title><filename>/etc/hostname</filename>: Host name configuration</title>
+ <section role="NotInToc">
+ <title>Purpose</title>
+ <para>The <filename>/etc/hostname</filename> file determines the host name of the system. This is used in system prompts, and for identification on a network.</para>
+ </section>
+ <section role="NotInToc">
+ <title>Syntax</title>
+ <para>The host name must appear as the only content of this file. Any other contents are invalid.</para>
+ </section>
+ <section role="NotInToc">
+ <title>Detailed Information</title>
+ <para>The <filename>/etc/hostname</filename> is read during system initialisation. The system host name is set to the contents of this file. If the <filename>/etc/hostname</filename> file is missing or corrupt, the system will retain the kernel's default host name &mdash; with the default Adélie Linux kernel, this is "<literal>adelie</literal>".</para>
+ </section>
+ </section>
+ <section>
+ <title><filename>/etc/inputrc</filename>: Bash shell keyboard configuration</title>
+ <section role="NotInToc">
+ <title>Purpose</title>
+ <para>The <filename>/etc/inputrc</filename> file determines the behaviour of keyboard input and the system bell in programs that use the GNU readline library. The GNU readline library is not packaged for the Adélie Linux system; therefore, the only system packages that would use the configuration in this file are <package>bash</package> and <package>gdb</package>, which contain their own private copies of the GNU readline library.</para>
+ </section>
+ <section role="NotInToc">
+ <title>Syntax</title>
+ <para>The <filename>/etc/inputrc</filename> is declarative in nature; variables are set using the <command>set</command> command, and escape sequences are mapped to functions using the format: <literal>"<replaceable>&lt;escape sequence&gt;</replaceable>": <replaceable>function</replaceable></literal>.</para>
+ </section>
+ <section role="NotInToc">
+ <title>External Resources</title>
+ <para>There are a few comments in the <filename>/etc/inputrc</filename> file. Since the GNU readline library is not packaged for the Adélie Linux system, it is not possible to read the manual page.</para>
+ </section>
+ </section>
</chapter>