Ignore:
Timestamp:
03/19/2020 10:00:16 AM (4 years ago)
Author:
Pierre Labastie <pieere@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
e68b588
Parents:
09f0998
Message:

Format sysutils

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@22859 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:
1 edited

Legend:

Unmodified
Added
Removed

  • general/sysutils/autofs.xml

    r09f0998 rb1532549  
    4242    <itemizedlist spacing="compact">
    4343      <listitem>
    44         <para>Download (HTTP): <ulink url="&autofs-download-http;"/></para>
    45       </listitem>
    46       <listitem>
    47         <para>Download (FTP): <ulink url="&autofs-download-ftp;"/></para>
    48       </listitem>
    49       <listitem>
    50         <para>Download MD5 sum: &autofs-md5sum;</para>
    51       </listitem>
    52       <listitem>
    53         <para>Download size: &autofs-size;</para>
    54       </listitem>
    55       <listitem>
    56         <para>Estimated disk space required: &autofs-buildsize;</para>
    57       </listitem>
    58       <listitem>
    59         <para>Estimated build time: &autofs-time;</para>
     44        <para>
     45          Download (HTTP): <ulink url="&autofs-download-http;"/>
     46        </para>
     47      </listitem>
     48      <listitem>
     49        <para>
     50          Download (FTP): <ulink url="&autofs-download-ftp;"/>
     51        </para>
     52      </listitem>
     53      <listitem>
     54        <para>
     55          Download MD5 sum: &autofs-md5sum;
     56        </para>
     57      </listitem>
     58      <listitem>
     59        <para>
     60          Download size: &autofs-size;
     61        </para>
     62      </listitem>
     63      <listitem>
     64        <para>
     65          Estimated disk space required: &autofs-buildsize;
     66        </para>
     67      </listitem>
     68      <listitem>
     69        <para>
     70          Estimated build time: &autofs-time;
     71        </para>
    6072      </listitem>
    6173    </itemizedlist>
    … …  
    106118    &lt;*/M&gt; CIFS support (advanced network filesystem, SMBFS successor) [CONFIG_CIFS]</literal></screen>
    107119
    108     <para>Recompile and install the new kernel, if necessary.</para>
     120    <para>
     121      Recompile and install the new kernel, if necessary.
     122    </para>
    109123
    110124  </sect2>
    … …  
    114128    <title>Installation of Autofs</title>
    115129
    116     <para>Install <application>Autofs</application> by running the following
    117     commands:</para>
     130    <para>
     131      Install <application>Autofs</application> by running the following
     132      commands:
     133    </para>
    118134
    119135<screen revision="sysv"><userinput>./configure --prefix=/         \
    … …  
    131147make</userinput></screen>
    132148
    133     <para>This package does not come with a test suite.</para>
    134 
    135     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     149    <para>
     150      This package does not come with a test suite.
     151    </para>
     152
     153    <para>
     154      Now, as the <systemitem class="username">root</systemitem> user:
     155    </para>
    136156
    137157<screen role="root"><userinput>make install</userinput></screen>
    … …  
    183203      <title>Config Files</title>
    184204
    185       <para><filename>/etc/sysconfig/autofs.conf</filename>,
    186       <filename>/etc/auto.master</filename>,
    187       <filename>/etc/auto.misc</filename>, and
    188       <filename>/etc/auto.net</filename></para>
     205      <para>
     206        <filename>/etc/sysconfig/autofs.conf</filename>,
     207        <filename>/etc/auto.master</filename>,
     208        <filename>/etc/auto.misc</filename>, and
     209        <filename>/etc/auto.net</filename>
     210      </para>
    189211
    190212      <indexterm zone="autofs autofs-config" >
    … …  
    209231      <title>Configuration Information</title>
    210232
    211       <para>The installation process creates <filename>auto.master</filename>,
    212       <filename>auto.misc</filename>,  <filename>auto.smb</filename>, and
    213       <filename>auto.net</filename>. Replace the
    214       <filename>auto.master</filename> file with the following commands
    215       as the <systemitem class="username">root</systemitem> user:</para>
     233      <para>
     234        The installation process creates <filename>auto.master</filename>,
     235        <filename>auto.misc</filename>,  <filename>auto.smb</filename>, and
     236        <filename>auto.net</filename>. Replace the
     237        <filename>auto.master</filename> file with the following commands
     238        as the <systemitem class="username">root</systemitem> user:
     239      </para>
    216240
    217241<screen role="root"><userinput>mv /etc/auto.master /etc/auto.master.bak &amp;&amp;
    … …  
    225249EOF</userinput></screen>
    226250
    227       <para>This file creates a new media directory, <filename>/media/auto</filename>
    228       that will overlay any existing directory of the same name.  In this example,
    229       the file, <filename>/etc/auto.misc</filename>, has a line:</para>
     251      <para>
     252        This file creates a new media directory,
     253        <filename>/media/auto</filename> that will overlay any existing
     254        directory of the same name.  In this example, the file,
     255        <filename>/etc/auto.misc</filename>, has a line:
     256      </para>
    230257
    231258<screen>cd   -fstype=iso9660,ro,nosuid,nodev :/dev/cdrom</screen>
    232259
    233       <para>that will mount a cdrom as <filename>/media/auto/cd</filename> if
    234       that directory is accessed.  The <option>--ghost</option> option tells
    235       the automounter to create <quote>ghost</quote> versions (i.e. empty
    236       directories) of all the mount points listed in the configuration file
    237       regardless whether any of the file systems are actually mounted or not.
    238       This is very convenient and highly recommended, because it will show you
    239       the available auto-mountable file systems as existing directories, even
    240       when their file systems aren't currently mounted. Without the
    241       <option>--ghost</option> option, you'll have to remember the names of the
    242       directories. As soon as you try to access one of them, the directory will
    243       be created and the file system will be mounted. When the file system gets
    244       unmounted again, the directory is destroyed too, unless the
    245       <option>--ghost</option> option was given.</para>
     260      <para>
     261        that will mount a cdrom as <filename>/media/auto/cd</filename> if
     262        that directory is accessed.  The <option>--ghost</option> option tells
     263        the automounter to create <quote>ghost</quote> versions (i.e. empty
     264        directories) of all the mount points listed in the configuration file
     265        regardless whether any of the file systems are actually mounted or not.
     266        This is very convenient and highly recommended, because it will show
     267        you the available auto-mountable file systems as existing directories,
     268        even when their file systems aren't currently mounted. Without the
     269        <option>--ghost</option> option, you'll have to remember the names of
     270        the directories. As soon as you try to access one of them, the
     271        directory will be created and the file system will be mounted. When
     272        the file system gets unmounted again, the directory is destroyed too,
     273        unless the <option>--ghost</option> option was given.
     274      </para>
    246275
    247276      <note>
    248         <para>An alternative method would be to specify another automount
    249         location such as <filename
    250         class='directory'>/var/lib/auto/cdrom</filename> and create a
    251         symbolic link from <filename class='directory'>/media/cdrom</filename>
    252         to the automount location.</para>
     277        <para>
     278          An alternative method would be to specify another automount
     279          location such as <filename
     280          class='directory'>/var/lib/auto/cdrom</filename> and create a
     281          symbolic link from <filename
     282          class='directory'>/media/cdrom</filename> to the automount location.
     283        </para>
    253284      </note>
    254285
    255       <para>The <filename>auto.misc</filename> file must be configured to your
    256       working hardware. The loaded configuration file should load your cdrom
    257       if <filename>/dev/cdrom</filename> is active or it can be edited to
    258       match your device setup.  Examples for floppies are available in the file
    259       and easily activated. Documentation for this file is available using the
    260       <command>man 5 autofs</command> command.</para>
    261 
    262       <para>In the second line, if enabled, a user's home directory would be
    263       mounted via NFS upon login.  The <filename>/etc/home.auto</filename>
    264       would need to exist and have an entry similar to:</para>
     286      <para>
     287        The <filename>auto.misc</filename> file must be configured to your
     288        working hardware. The loaded configuration file should load your cdrom
     289        if <filename>/dev/cdrom</filename> is active or it can be edited to
     290        match your device setup.  Examples for floppies are available in the
     291        file and easily activated. Documentation for this file is available
     292        using the <command>man 5 autofs</command> command.
     293      </para>
     294
     295      <para>
     296        In the second line, if enabled, a user's home directory would be
     297        mounted via NFS upon login.  The <filename>/etc/home.auto</filename>
     298        would need to exist and have an entry similar to:
     299      </para>
    265300
    266301<screen>joe  example.org:/export/home/joe</screen>
    267302
    268       <para>where the directory <filename>/export/home/joe</filename> is
    269       exported via NFS from the system example.org.  NFS shares
    270       are covered on the next page.</para>
    271 
    272       <para>This package could also be used to mount SMB shares, however that
    273       feature is not configured in these instructions.  For additional
    274       configuration information, see the man pages for auto.master(5).  There
    275       are also web resources such as this <ulink
    276       url='http://wiki.gentoo.org/wiki/AutoFS'>AUTOFS
    277       HOWTO</ulink> available.</para>
     303      <para>
     304        where the directory <filename>/export/home/joe</filename> is
     305        exported via NFS from the system example.org.  NFS shares
     306        are covered on the next page.
     307      </para>
     308
     309      <para>
     310        This package could also be used to mount SMB shares, however that
     311        feature is not configured in these instructions.  For additional
     312        configuration information, see the man pages for auto.master(5). There
     313        are also web resources such as this <ulink
     314        url='http://wiki.gentoo.org/wiki/AutoFS'>AUTOFS
     315        HOWTO</ulink> available.
     316      </para>
    278317
    279318    </sect3>
    … …  
    283322             <phrase revision="systemd">Systemd Unit</phrase></title>
    284323
    285       <para revision="sysv"><application>autofs</application> installs its own
    286       boot script, but it has no capability for logging or visual conformance
    287       with other BLFS scripts.</para>
    288 
    289       <para revision="sysv">Install the <filename>/etc/init.d/autofs</filename>
    290       mount script included with the <xref linkend="bootscripts"/>
    291       package.</para>
     324      <para revision="sysv">
     325        <application>autofs</application> installs its own
     326        boot script, but it has no capability for logging or visual conformance
     327        with other BLFS scripts.
     328      </para>
     329
     330      <para revision="sysv">
     331        Install the <filename>/etc/init.d/autofs</filename>
     332        mount script included with the <xref linkend="bootscripts"/>
     333        package.
     334      </para>
    292335
    293336      <para revision="systemd">
    … …  
    305348<screen role="root" revision="systemd"><userinput>systemctl enable autofs</userinput></screen>
    306349
    307       <para revision="sysv">The time-out variable is set in
    308       <filename>/etc/sysconfig/autofs.conf</filename>. The installed file sets
    309       a default of 60 seconds of inactivity before unmounting the device.  A
    310       much shorter time may be necessary to protect buffer writing to a floppy
    311       if users tend to remove the media prior to the timeout setting.</para>
     350      <para revision="sysv">
     351        The time-out variable is set in
     352        <filename>/etc/sysconfig/autofs.conf</filename>. The installed file sets
     353        a default of 60 seconds of inactivity before unmounting the device.  A
     354        much shorter time may be necessary to protect buffer writing to a floppy
     355        if users tend to remove the media prior to the timeout setting.
     356      </para>
    312357
    313358      <note revision="systemd">
    … …  
    353398        <term><command>automount</command></term>
    354399        <listitem>
    355           <para>is the daemon that performs the mounting when a request is
    356           made for the device.</para>
     400          <para>
     401            is the daemon that performs the mounting when a request is
     402            made for the device.
     403          </para>
    357404          <indexterm zone="autofs automount">
    358405            <primary sortas="b-automount">automount</primary>
Note: See TracChangeset for help on using the changeset viewer.