Changeset d3ad3271


Ignore:
Timestamp:
05/12/2005 07:51:44 PM (19 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
1e247d1
Parents:
bcc83ef
Message:

Tagged autofs.xml

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • postlfs/config/autofs.xml

    rbcc83ef rd3ad3271  
    1414
    1515<sect1 id="autofs" xreflabel="autofs-&autofs-version;">
    16 <sect1info>
    17 <othername>$LastChangedBy$</othername>
    18 <date>$Date$</date>
    19 </sect1info>
    20 <?dbhtml filename="autofs.html"?>
    21 <title>Automate Mounting of File Systems</title>
    22 <indexterm zone="autofs">
    23 <primary sortas="a-Autofs">Autofs</primary></indexterm>
    24 
    25 <sect2>
    26 <title>Introduction to <application>autofs</application></title>
    27 
    28 <para>The <application>autofs</application> package contains userspace
    29 tools that work with the kernel to mount and un-mount removable file
    30 systems. This is useful for allowing users to mount floppies, cdroms and
    31 other removable storage devices without requiring the system
    32 administrator to mount the devices.  This may not be ideal for all
    33 installations, so be aware of the risks before implementing this feature.</para>
    34 
    35 <sect3><title>Package information</title>
    36 <itemizedlist spacing="compact">
    37 <listitem><para>Download (HTTP):
    38 <ulink url="&autofs-download-http;"/></para></listitem>
    39 <listitem><para>Download (FTP):
    40 <ulink url="&autofs-download-ftp;"/></para></listitem>
    41 <listitem><para>Download MD5 sum: &autofs-md5sum;</para></listitem>
    42 <listitem><para>Download size: &autofs-size;</para></listitem>
    43 <listitem><para>Estimated disk space required:
    44 &autofs-buildsize;</para></listitem>
    45 <listitem><para>Estimated build time:
    46 &autofs-time;</para></listitem></itemizedlist>
    47 </sect3>
    48 
    49 <sect3><title>Additional downloads</title>
    50 <itemizedlist spacing="compact">
    51 <listitem><para>Recommended Patch: <ulink
    52 url="http://ftp.kernel.org/pub/linux/daemons/autofs/v4/autofs-4.1.3-strict.patch"/></para>
    53 </listitem>
    54 <listitem><para>Recommended Patch: <ulink
    55 url="http://ftp.kernel.org/pub/linux/daemons/autofs/v4/autofs-4.1.3-bad_chdir.patch
    56 "/></para>
    57 </listitem>
    58 <listitem><para>Recommended Patch: <ulink
    59 url="http://ftp.kernel.org/pub/linux/daemons/autofs/v4/autofs-4.1.3-mtab_lock.patch
    60 "/></para>
    61 </listitem>
    62 <listitem><para>Recommended Patch: <ulink
    63 url="http://ftp.kernel.org/pub/linux/daemons/autofs/v4/autofs-4.1.3-non_block_ping.patch
    64 "/></para>
    65 </listitem>
    66 <listitem><para>Recommended Patch: <ulink
    67 url="http://ftp.kernel.org/pub/linux/daemons/autofs/v4/autofs-4.1.3-signal-race-fix.patch
    68 "/></para>
    69 </listitem>
    70 <listitem><para>Recommended Patch: <ulink
    71 url="http://ftp.kernel.org/pub/linux/daemons/autofs/v4/autofs-4.1.3-sock-leak-fix.patch
    72 "/></para>
    73 </listitem>
    74 <listitem><para>Recommended Patch: <ulink
    75 url="http://ftp.kernel.org/pub/linux/daemons/autofs/v4/autofs-4.1.3-replicated_server_select.patch
    76 "/></para>
    77 </listitem>
    78 <listitem><para>Recommended Patch: <ulink
    79 url="http://ftp.kernel.org/pub/linux/daemons/autofs/v4/autofs-4.1.3-multi-over.patch
    80 "/></para>
    81 </listitem>
    82 </itemizedlist>
    83 </sect3>
    84 <!---
    85 <sect3><title><application>template</application> dependencies</title>
    86 <sect4><title>Required</title>
    87 <para><xref linkend="BLFS DEPENDENCY"/></para>
    88 </sect4>
    89 
    90 <sect4><title>Optional</title>
    91 <para><ulink url="http://www.some.url/">EXTERNAL DEPENDENCY</ulink></para>
    92 </sect4>
    93 </sect3> -->
    94 
    95 </sect2>
    96 
    97 <sect2 id="autofs-kernel">
    98 <title>Installation of <application>autofs</application></title>
    99 <indexterm zone="autofs autofs-kernel">
    100 <primary sortas="d-Automounter">Automounter</primary></indexterm>
    101 
    102 <para>Verify that kernel support has been compiled in or built as
    103 modules in the following areas:
    104 <screen>File systems
    105         Kernel automounter version 4 support    Y or M
     16  <?dbhtml filename="autofs.html"?>
     17
     18  <sect1info>
     19    <othername>$LastChangedBy$</othername>
     20    <date>$Date$</date>
     21  </sect1info>
     22
     23  <title>Automate Mounting of File Systems</title>
     24
     25  <indexterm zone="autofs">
     26    <primary sortas="a-Autofs">Autofs</primary>
     27  </indexterm>
     28
     29  <sect2 role="package">
     30    <title>Introduction to Autofs</title>
     31
     32    <para>The <application>autofs</application> package contains userspace
     33    tools that work with the kernel to mount and un-mount removable file
     34    systems. This is useful for allowing users to mount floppies, cdroms and
     35    other removable storage devices without requiring the system
     36    administrator to mount the devices.  This may not be ideal for all
     37    installations, so be aware of the risks before implementing this feature.</para>
     38
     39    <bridgehead renderas="sect3">Package Information</bridgehead>
     40    <itemizedlist spacing="compact">
     41      <listitem>
     42        <para>Download (HTTP): <ulink url="&autofs-download-http;"/></para>
     43      </listitem>
     44      <listitem>
     45        <para>Download (FTP): <ulink url="&autofs-download-ftp;"/></para>
     46      </listitem>
     47      <listitem>
     48        <para>Download MD5 sum: &autofs-md5sum;</para>
     49      </listitem>
     50      <listitem>
     51        <para>Download size: &autofs-size;</para>
     52      </listitem>
     53      <listitem>
     54        <para>Estimated disk space required: &autofs-buildsize;</para>
     55      </listitem>
     56      <listitem>
     57        <para>Estimated build time: &autofs-time;</para>
     58      </listitem>
     59    </itemizedlist>
     60
     61    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
     62    <itemizedlist spacing="compact">
     63      <listitem>
     64        <para>Recommended Patch: <ulink
     65        url="http://ftp.kernel.org/pub/linux/daemons/autofs/v4/autofs-4.1.3-strict.patch"/></para>
     66      </listitem>
     67      <listitem>
     68        <para>Recommended Patch: <ulink
     69        url="http://ftp.kernel.org/pub/linux/daemons/autofs/v4/autofs-4.1.3-bad_chdir.patch"/></para>
     70      </listitem>
     71      <listitem>
     72        <para>Recommended Patch: <ulink
     73        url="http://ftp.kernel.org/pub/linux/daemons/autofs/v4/autofs-4.1.3-mtab_lock.patch"/></para>
     74      </listitem>
     75      <listitem>
     76        <para>Recommended Patch: <ulink
     77        url="http://ftp.kernel.org/pub/linux/daemons/autofs/v4/autofs-4.1.3-non_block_ping.patch"/></para>
     78      </listitem>
     79      <listitem>
     80        <para>Recommended Patch: <ulink
     81        url="http://ftp.kernel.org/pub/linux/daemons/autofs/v4/autofs-4.1.3-signal-race-fix.patch"/></para>
     82      </listitem>
     83      <listitem>
     84        <para>Recommended Patch: <ulink
     85        url="http://ftp.kernel.org/pub/linux/daemons/autofs/v4/autofs-4.1.3-sock-leak-fix.patch"/></para>
     86      </listitem>
     87      <listitem>
     88        <para>Recommended Patch: <ulink
     89        url="http://ftp.kernel.org/pub/linux/daemons/autofs/v4/autofs-4.1.3-replicated_server_select.patch"/></para>
     90      </listitem>
     91      <listitem>
     92        <para>Recommended Patch: <ulink
     93        url="http://ftp.kernel.org/pub/linux/daemons/autofs/v4/autofs-4.1.3-multi-over.patch"/></para>
     94      </listitem>
     95    </itemizedlist>
     96
     97  </sect2>
     98
     99  <sect2 role="kernel" id="autofs-kernel">
     100    <title>Kernel Configuration</title>
     101
     102    <indexterm zone="autofs autofs-kernel">
     103      <primary sortas="d-Automounter">Automounter</primary>
     104    </indexterm>
     105
     106    <para>Verify that kernel support has been compiled in or built as
     107    modules in the following areas:</para>
     108
     109<screen><literal>File systems
     110    Kernel automounter version 4 support        Y or M
    106111Network File Systems
    107         NFS file system support                 Y or M
    108         SMB file system support                 Y or M</screen>
    109 Recompile and install the new kernel, if necessary.</para>
    110 
    111 <para>Install <application>autofs</application> by running the following
    112 commands:</para>
    113 
    114 <screen><userinput><command>patch -Np1 -i ../autofs-4.1.3-strict.patch &amp;&amp;
     112    NFS file system support                     Y or M
     113    SMB file system support                     Y or M</literal></screen>
     114   
     115    <para>Recompile and install the new kernel, if necessary.</para>
     116
     117  </sect2>
     118
     119  <sect2 role="installation">
     120   
     121    <title>Installation of Autofs</title>
     122
     123    <para>Install <application>autofs</application> by running the following
     124    commands:</para>
     125
     126<screen><userinput>patch -Np1 -i ../autofs-4.1.3-strict.patch &amp;&amp;
    115127patch -Np1 -i ../autofs-4.1.3-bad_chdir.patch &amp;&amp;
    116128patch -Np1 -i ../autofs-4.1.3-mtab_lock.patch &amp;&amp;
    … …  
    121133patch -Np1 -i ../autofs-4.1.3-multi-over.patch &amp;&amp;
    122134./configure --prefix=/ --mandir=/usr/share/man &amp;&amp;
    123 make</command></userinput></screen>
    124 
    125 <para>Now, as the root user:</para>
    126 
    127 <screen><userinput role='root'><command>make install &amp;&amp;
    128 rm /etc/rc.d/init.d/autofs</command></userinput></screen>
    129 
    130 </sect2>
    131 
    132 <sect2>
    133 <title>Command explanations</title>
    134 
    135 <para><command>rm /etc/rc.d/init.d/autofs</command>: This command
    136 removes the installed script which only works on specific distributions.</para>
    137 
    138 </sect2>
    139 
    140 <sect2>
    141 <title>Configuring <application>autofs</application></title>
    142 
    143 <sect3 id="autofs-config"><title>Config files</title>
    144 <para><filename>/etc/sysconfig/autofs.conf</filename>,
    145 <filename>/etc/auto.master</filename>,
    146 <filename>/etc/auto.misc</filename>, and
    147 <filename>/etc/auto.net</filename></para>
    148 <indexterm zone="autofs autofs-config" >
    149 <primary
    150 sortas="e-etc-sysconfig-autofs.conf">/etc/sysconfig/autofs.conf</primary>
    151 </indexterm>
    152 <indexterm zone="autofs autofs-config">
    153 <primary sortas="e-etc-auto.master">/etc/auto.master</primary></indexterm>
    154 <indexterm zone="autofs autofs-config">
    155 <primary sortas="e-etc-auto.misc">/etc/auto.misc</primary></indexterm>
    156 <indexterm zone="autofs autofs-config">
    157 <primary sortas="e-etc-auto.net">/etc/auto.net</primary></indexterm>
    158 </sect3>
    159 
    160 <sect3><title>Configuration Information</title>
    161 
    162 <para>The installation process creates <filename>auto.master</filename>,
    163 <filename>auto.misc</filename> and <filename>auto.net</filename>. You
    164 will replace the <filename>auto.master</filename> with the following
    165 commands.
    166 
    167 <screen><userinput role='root'><command>mv /etc/auto.master /etc/auto.master.bak &amp;&amp;
    168 cat &gt; /etc/auto.master &lt;&lt; "EOF"</command>
    169 # Begin /etc/auto.master
     135make</userinput></screen>
     136
     137    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     138
     139<screen role="root"><userinput>make install &amp;&amp;
     140rm /etc/rc.d/init.d/autofs</userinput></screen>
     141
     142  </sect2>
     143
     144  <sect2 role="commands">
     145    <title>Command Explanations</title>
     146
     147    <para><command>rm /etc/rc.d/init.d/autofs</command>: This command
     148    removes the installed script which only works on specific distributions.</para>
     149
     150  </sect2>
     151
     152  <sect2 role="configuration">
     153    <title>Configuring Autofs</title>
     154
     155    <sect3 id="autofs-config">
     156      <title>Config Files</title>
     157
     158      <para><filename>/etc/sysconfig/autofs.conf</filename>,
     159      <filename>/etc/auto.master</filename>,
     160      <filename>/etc/auto.misc</filename>, and
     161      <filename>/etc/auto.net</filename></para>
     162
     163      <indexterm zone="autofs autofs-config" >
     164        <primary sortas="e-etc-sysconfig-autofs.conf">/etc/sysconfig/autofs.conf</primary>
     165      </indexterm>
     166
     167      <indexterm zone="autofs autofs-config">
     168        <primary sortas="e-etc-auto.master">/etc/auto.master</primary>
     169      </indexterm>
     170
     171      <indexterm zone="autofs autofs-config">
     172        <primary sortas="e-etc-auto.misc">/etc/auto.misc</primary>
     173      </indexterm>
     174
     175      <indexterm zone="autofs autofs-config">
     176        <primary sortas="e-etc-auto.net">/etc/auto.net</primary>
     177      </indexterm>
     178
     179    </sect3>
     180
     181    <sect3>
     182      <title>Configuration Information</title>
     183
     184      <para>The installation process creates <filename>auto.master</filename>,
     185      <filename>auto.misc</filename> and <filename>auto.net</filename>. You
     186      will replace the <filename>auto.master</filename> with the following
     187      commands:</para>
     188
     189<screen role="root"><userinput>mv /etc/auto.master /etc/auto.master.bak &amp;&amp;
     190cat &gt; /etc/auto.master &lt;&lt; "EOF"
     191<literal># Begin /etc/auto.master
    170192
    171193/media  /etc/auto.misc
    172194
    173 # End /etc/auto.master
    174 <command>EOF</command></userinput></screen></para>
    175 
    176 <note><para>This file mounts a new media directory over the one created by
    177 <acronym>LFS</acronym> and will therefore hide any mounts made by the
    178 <filename>fstab</filename> file into that directory.</para></note>
    179 
    180 <para>While this package could be used to mount <acronym>NFS</acronym>
    181 shares and <acronym>SMB</acronym> shares, that feature is not configured
    182 in these instructions. <acronym>NFS</acronym> shares are covered on the
    183 next page.
    184 </para>
    185 
    186 <para>The <filename>auto.misc</filename> must be configured to your
    187 working hardware. The loaded configuration file should load your cdrom
    188 if <filename>/dev/cdrom</filename> is active or it can be edited to
    189 match your device setup and examples for floppies are available in the file
    190 and easily activated. Documentation for this file is available using the
    191 <command>man 5 autofs</command> command.</para>
    192 
    193 <para id="autofs-init">Install the
    194 <filename>/etc/rc.d/init.d/autofs</filename> mount script and
    195 <filename>/etc/sysconfig/autofs.conf</filename> support file
    196 included with the <xref linkend="intro-important-bootscripts"/>
    197 package.</para>
    198 <indexterm zone="autofs autofs-init">
    199 <primary sortas="f-autofs-init">autofs</primary></indexterm>
    200 
    201 <screen><userinput role='root'><command>make install-autofs</command></userinput></screen>
    202 
    203 <para>The time-out variable is set in
    204 <filename>/etc/sysconfig/autofs.conf</filename>. The installed file sets
    205 a default of 60 seconds of inactivity before unmounting the device.  A
    206 much shorter time may be necessary to protect buffer writing to a
    207 floppy if users tend to remove the media prior to the timeout
    208 setting.</para>
    209 </sect3>
    210 
    211 </sect2>
    212 
    213 <sect2>
    214 <title>Contents</title>
    215 
    216 <segmentedlist>
    217 <segtitle>Installed Program</segtitle>
    218 <segtitle>Installed Libraries</segtitle>
    219 <seglistitem>
    220 <seg>automount</seg>
    221 <seg>autofs modules</seg>
    222 </seglistitem>
    223 </segmentedlist>
    224 
    225 <variablelist>
    226 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
    227 <?dbfo list-presentation="list"?>
    228 
    229 <varlistentry id="automount">
    230 <term><command>automount</command></term>
    231 <listitem><para>is the daemon that performs the mounting when a request is
    232 made for the device.</para>
    233 <indexterm zone="autofs automount">
    234 <primary sortas="b-automount">automount</primary></indexterm>
    235 </listitem>
    236 </varlistentry>
    237 </variablelist>
    238 
    239 </sect2>
     195# End /etc/auto.master</literal>
     196EOF</userinput></screen>
     197
     198      <note>
     199        <para>This file mounts a new media directory over the one created by
     200        LFS and will therefore hide any mounts made by the
     201        <filename>fstab</filename> file into that directory.</para>
     202      </note>
     203
     204      <para>While this package could be used to mount NFS shares and SMB
     205      shares, that feature is not configured in these instructions. NFS shares
     206      are covered on the next page.</para>
     207
     208      <para>The <filename>auto.misc</filename> must be configured to your
     209      working hardware. The loaded configuration file should load your cdrom
     210      if <filename>/dev/cdrom</filename> is active or it can be edited to
     211      match your device setup and examples for floppies are available in the file
     212      and easily activated. Documentation for this file is available using the
     213      <command>man 5 autofs</command> command.</para>
     214
     215    </sect3>
     216
     217    <sect3  id="autofs-init">
     218      <title>Boot Script</title>
     219
     220
     221      <para>Install the <filename>/etc/rc.d/init.d/autofs</filename> mount script
     222      and <filename>/etc/sysconfig/autofs.conf</filename> support file included
     223      with the <xref linkend="intro-important-bootscripts"/> package.</para>
     224
     225      <indexterm zone="autofs autofs-init">
     226        <primary sortas="f-autofs-init">autofs</primary>
     227      </indexterm>
     228
     229<screen role="root"><userinput>make install-autofs</userinput></screen>
     230
     231      <para>The time-out variable is set in
     232      <filename>/etc/sysconfig/autofs.conf</filename>. The installed file sets
     233      a default of 60 seconds of inactivity before unmounting the device.  A
     234      much shorter time may be necessary to protect buffer writing to a floppy
     235      if users tend to remove the media prior to the timeout setting.</para>
     236
     237    </sect3>
     238
     239  </sect2>
     240
     241  <sect2 role="content">
     242    <title>Contents</title>
     243
     244    <segmentedlist>
     245      <segtitle>Installed Program</segtitle>
     246      <segtitle>Installed Libraries</segtitle>
     247      <segtitle>Installed Directories</segtitle>
     248
     249      <seglistitem>
     250        <seg>automount</seg>
     251        <seg>autofs modules</seg>
     252        <seg>Not determined at this time</seg>
     253      </seglistitem>
     254    </segmentedlist>
     255
     256    <variablelist>
     257      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     258      <?dbfo list-presentation="list"?>
     259      <?dbhtml list-presentation="table"?>
     260
     261      <varlistentry id="automount">
     262        <term><command>automount</command></term>
     263        <listitem>
     264          <para>is the daemon that performs the mounting when a request is
     265          made for the device.</para>
     266          <indexterm zone="autofs automount">
     267            <primary sortas="b-automount">automount</primary>
     268          </indexterm>
     269        </listitem>
     270      </varlistentry>
     271
     272    </variablelist>
     273
     274  </sect2>
    240275
    241276</sect1>
Note: See TracChangeset for help on using the changeset viewer.