source: general/sysutils/autofs.xml@ 3e072580

10.0 10.1 11.0 11.1 7.10 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 krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 3e072580 was 3e072580, checked in by Bruce Dubbs <bdubbs@…>, 8 years ago

Update to autofs-5.1.0

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

  • Property mode set to 100644
File size: 11.1 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY autofs-download-http "http://www.kernel.org/pub/linux/daemons/autofs/v5/autofs-&autofs-version;.tar.xz">
8 <!ENTITY autofs-download-ftp "ftp://ftp.kernel.org/pub/linux/daemons/autofs/v5/autofs-&autofs-version;.tar.xz">
9 <!ENTITY autofs-md5sum "4c34cacea07db3681b0da1befa229ec4">
10 <!ENTITY autofs-size "284 KB">
11 <!ENTITY autofs-buildsize "9.7 MB">
12 <!ENTITY autofs-time "0.1 SBU">
13]>
14
15<sect1 id="autofs" xreflabel="Autofs-&autofs-version;">
16 <?dbhtml filename="autofs.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>autofs-&autofs-version;</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>
33 <application>Autofs</application> controls the operation of the automount
34 daemons. The automount daemons automatically mount filesystems when they
35 are accessed and unmount them after a period of inactivity. This is done
36 based on a set of pre-configured maps.
37 </para>
38
39 &lfs75_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <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>
60 </listitem>
61 </itemizedlist>
62
63 <bridgehead renderas="sect3">Autofs Dependencies</bridgehead>
64
65 <bridgehead renderas="sect4">Optional</bridgehead>
66 <para role="optional">
67 <xref linkend="libtirpc"/>,
68 <xref linkend="nfs-utils"/>,
69 <xref linkend="libxml2"/>,
70 <xref linkend="mitkrb"/>,
71 <xref linkend="openldap"/> (client only), and
72 <xref linkend="cyrus-sasl"/>
73 </para>
74
75 <para condition="html" role="usernotes">User Notes:
76 <ulink url="&blfs-wiki;/autofs"/></para>
77
78 </sect2>
79
80 <sect2 role="kernel" id="autofs-kernel">
81 <title>Kernel Configuration</title>
82
83 <indexterm zone="autofs autofs-kernel">
84 <primary sortas="d-Automounter">Automounter</primary>
85 </indexterm>
86
87 <para>
88 Verify that automounter kernel support has been enabled:
89 </para>
90
91<screen><literal>File systems ---&gt;
92 Kernel automounter version 4 support (also supports v3): Y or M</literal></screen>
93
94 <para>
95 Optionally, enable the following options in the kernel configuration:
96 </para>
97
98<screen><literal>File systems ---&gt;
99 Network File Systems ---&gt;
100 NFS client support: Y or M
101 CIFS support (advanced network filesystem, SMBFS successor): Y or M</literal></screen>
102
103 <para>Recompile and install the new kernel, if necessary.</para>
104
105 </sect2>
106
107 <sect2 role="installation">
108
109 <title>Installation of Autofs</title>
110
111 <para>Install <application>Autofs</application> by running the following
112 commands:</para>
113
114<screen><userinput>sed -i -e '/include.*config.h/ i #include &lt;stdarg.h&gt;' lib/defaults.c &amp;&amp;
115
116./configure --prefix=/ \
117 --without-openldap \
118 --mandir=/usr/share/man &amp;&amp;
119make</userinput></screen>
120
121 <para>This package does not come with a test suite.</para>
122
123 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
124
125<screen role="root"><userinput>make install</userinput></screen>
126
127 </sect2>
128
129 <sect2 role="commands">
130 <title>Command Explanations</title>
131
132 <para>
133 <command>sed ... lib/defaults.c</command>: Fix a build problem with current
134 headers.
135 </para>
136
137 <para>
138 <option>--with-libtirpc</option>: This switch enables libtirpc support if
139 available.
140 </para>
141
142 <para>
143 <option>--without-openldap</option>: This switch disables openldap if found. If
144 openldap is desired, omit this switch. Note that openldap support in autofs
145 requires <xref linkend="mitkrb"/>.
146 </para>
147
148 </sect2>
149
150 <sect2 role="configuration">
151 <title>Configuring Autofs</title>
152
153 <sect3 id="autofs-config">
154 <title>Config Files</title>
155
156 <para><filename>/etc/sysconfig/autofs.conf</filename>,
157 <filename>/etc/auto.master</filename>,
158 <filename>/etc/auto.misc</filename>, and
159 <filename>/etc/auto.net</filename></para>
160
161 <indexterm zone="autofs autofs-config" >
162 <primary sortas="e-etc-sysconfig-autofs.conf">/etc/sysconfig/autofs.conf</primary>
163 </indexterm>
164
165 <indexterm zone="autofs autofs-config">
166 <primary sortas="e-etc-auto.master">/etc/auto.master</primary>
167 </indexterm>
168
169 <indexterm zone="autofs autofs-config">
170 <primary sortas="e-etc-auto.misc">/etc/auto.misc</primary>
171 </indexterm>
172
173 <indexterm zone="autofs autofs-config">
174 <primary sortas="e-etc-auto.net">/etc/auto.net</primary>
175 </indexterm>
176
177 </sect3>
178
179 <sect3>
180 <title>Configuration Information</title>
181
182 <para>The installation process creates <filename>auto.master</filename>,
183 <filename>auto.misc</filename>, <filename>auto.smb</filename>, and
184 <filename>auto.net</filename>. Replace the
185 <filename>auto.master</filename> file with the following commands
186 as the <systemitem class="username">root</systemitem> user:</para>
187
188<screen role="root"><userinput>mv /etc/auto.master /etc/auto.master.bak &amp;&amp;
189cat &gt; /etc/auto.master &lt;&lt; "EOF"
190<literal># Begin /etc/auto.master
191
192/media/auto /etc/auto.misc --ghost
193#/home /etc/auto.home
194
195# End /etc/auto.master</literal>
196EOF</userinput></screen>
197
198 <para>This file creates a new media directory, <filename>/media/auto</filename>
199 that will overlay any existing directory of the same name. In this example,
200 the file, <filename>/etc/auto.misc</filename>, has a line:</para>
201
202<screen>cd -fstype=iso9660,ro,nosuid,nodev :/dev/cdrom</screen>
203
204 <para>that will mount a cdrom as <filename>/media/auto/cd</filename> if
205 that directory is accessed. The <option>--ghost</option> option tells
206 the automounter to create <quote>ghost</quote> versions (i.e. empty
207 directories) of all the mount points listed in the configuration file
208 regardless whether any of the file systems are actually mounted or not.
209 This is very convenient and highly recommended, because it will show you
210 the available auto-mountable file systems as existing directories, even
211 when their file systems aren't currently mounted. Without the
212 <option>--ghost</option> option, you'll have to remember the names of the
213 directories. As soon as you try to access one of them, the directory will
214 be created and the file system will be mounted. When the file system gets
215 unmounted again, the directory is destroyed too, unless the
216 <option>--ghost</option> option was given.</para>
217
218 <note>
219 <para>An alternative method would be to specify another automount
220 location such as <filename
221 class='directory'>/var/lib/auto/cdrom</filename> and create a
222 symbolic link from <filename class='directory'>/media/cdrom</filename>
223 to the automount location.</para>
224 </note>
225
226 <para>The <filename>auto.misc</filename> file must be configured to your
227 working hardware. The loaded configuration file should load your cdrom
228 if <filename>/dev/cdrom</filename> is active or it can be edited to
229 match your device setup. Examples for floppies are available in the file
230 and easily activated. Documentation for this file is available using the
231 <command>man 5 autofs</command> command.</para>
232
233 <para>In the second line, if enabled, a user's home directory would be
234 mounted via NFS upon login. The <filename>/etc/home.auto</filename>
235 would need to exist and have an entry similar to:</para>
236
237<screen>joe example.org:/export/home/joe</screen>
238
239 <para>where the directory <filename>/export/home/joe</filename> is
240 exported via NFS from the system example.org. NFS shares
241 are covered on the next page.</para>
242
243 <para>This package could also be used to mount SMB shares, however that
244 feature is not configured in these instructions. For additional
245 configuration information, see the man pages for auto.master(5). There
246 are also web resources such as this <ulink
247 url='http://wiki.gentoo.org/wiki/Autofs'>AUTOFS
248 HOWTO</ulink> available.</para>
249
250 </sect3>
251
252 <sect3 id="autofs-init">
253 <title>Boot Script</title>
254
255 <para> <application>autofs</application> installs its own boot script,
256 but it has no capability for logging or visual conformance with other
257 BLFS scripts.</para>
258
259 <para>Install the <filename>/etc/init.d/autofs</filename> mount script
260 included with the <xref linkend="bootscripts"/> package.</para>
261
262 <indexterm zone="autofs autofs-init">
263 <primary sortas="f-autofs-init">autofs</primary>
264 </indexterm>
265
266<screen role="root"><userinput>make install-autofs</userinput></screen>
267
268 <para>The time-out variable is set in
269 <filename>/etc/sysconfig/autofs.conf</filename>. The installed file sets
270 a default of 60 seconds of inactivity before unmounting the device. A
271 much shorter time may be necessary to protect buffer writing to a floppy
272 if users tend to remove the media prior to the timeout setting.</para>
273
274 </sect3>
275
276 </sect2>
277
278 <sect2 role="content">
279 <title>Contents</title>
280
281 <segmentedlist>
282 <segtitle>Installed Program</segtitle>
283 <segtitle>Installed Libraries</segtitle>
284 <segtitle>Installed Directories</segtitle>
285
286 <seglistitem>
287 <seg>automount</seg>
288 <seg>lookup_dir.so, lookup_file.so, lookup_hosts.so, lookup_ldap.so,
289 lookup_multi.so, lookup_nisplus.so, lookup_program.so,
290 lookup_userhome.so, lookup_yp.so, mount_afs.so, mount_autofs.so,
291 mount_bind.so, mount_changer.so, mount_ext2.so, mount_generic.so,
292 mount_nfs.so, parse_sun.so</seg>
293 <seg>/lib/autofs</seg>
294 </seglistitem>
295 </segmentedlist>
296
297 <variablelist>
298 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
299 <?dbfo list-presentation="list"?>
300 <?dbhtml list-presentation="table"?>
301
302 <varlistentry id="automount">
303 <term><command>automount</command></term>
304 <listitem>
305 <para>is the daemon that performs the mounting when a request is
306 made for the device.</para>
307 <indexterm zone="autofs automount">
308 <primary sortas="b-automount">automount</primary>
309 </indexterm>
310 </listitem>
311 </varlistentry>
312
313 </variablelist>
314
315 </sect2>
316
317</sect1>
Note: See TracBrowser for help on using the repository browser.