source: general/sysutils/autofs.xml@ 73b53eb

10.0 10.1 11.0 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 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 73b53eb was 73b53eb, checked in by Bruce Dubbs <bdubbs@…>, 8 years ago

Update to autofs-5.0.9

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

  • Property mode set to 100644
File size: 10.8 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 " ">
8 <!ENTITY autofs-download-ftp "ftp://ftp.kernel.org/pub/linux/daemons/autofs/v5/autofs-&autofs-version;.tar.xz">
9 <!ENTITY autofs-md5sum "7e947834063b55666f3727e77503af37">
10 <!ENTITY autofs-size "256 KB">
11 <!ENTITY autofs-buildsize "8.6 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>./configure --prefix=/ \
115 --without-openldap \
116 --mandir=/usr/share/man &amp;&amp;
117make</userinput></screen>
118
119 <para>This package does not come with a test suite.</para>
120
121 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
122
123<screen role="root"><userinput>make install</userinput></screen>
124
125 </sect2>
126
127 <sect2 role="commands">
128 <title>Command Explanations</title>
129
130 <para>
131 <option>--with-libtirpc</option>: This switch enables libtirpc support if
132 available.
133 </para>
134
135 <para>
136 <option>--without-openldap</option>: This switch disables openldap if found. If
137 openldap is desired, omit this switch. Note that openldap support in autofs
138 requires <xref linkend="mitkrb"/>.
139 </para>
140
141 </sect2>
142
143 <sect2 role="configuration">
144 <title>Configuring Autofs</title>
145
146 <sect3 id="autofs-config">
147 <title>Config Files</title>
148
149 <para><filename>/etc/sysconfig/autofs.conf</filename>,
150 <filename>/etc/auto.master</filename>,
151 <filename>/etc/auto.misc</filename>, and
152 <filename>/etc/auto.net</filename></para>
153
154 <indexterm zone="autofs autofs-config" >
155 <primary sortas="e-etc-sysconfig-autofs.conf">/etc/sysconfig/autofs.conf</primary>
156 </indexterm>
157
158 <indexterm zone="autofs autofs-config">
159 <primary sortas="e-etc-auto.master">/etc/auto.master</primary>
160 </indexterm>
161
162 <indexterm zone="autofs autofs-config">
163 <primary sortas="e-etc-auto.misc">/etc/auto.misc</primary>
164 </indexterm>
165
166 <indexterm zone="autofs autofs-config">
167 <primary sortas="e-etc-auto.net">/etc/auto.net</primary>
168 </indexterm>
169
170 </sect3>
171
172 <sect3>
173 <title>Configuration Information</title>
174
175 <para>The installation process creates <filename>auto.master</filename>,
176 <filename>auto.misc</filename>, <filename>auto.smb</filename>, and
177 <filename>auto.net</filename>. Replace the
178 <filename>auto.master</filename> file with the following commands
179 as the <systemitem class="username">root</systemitem> user:</para>
180
181<screen role="root"><userinput>mv /etc/auto.master /etc/auto.master.bak &amp;&amp;
182cat &gt; /etc/auto.master &lt;&lt; "EOF"
183<literal># Begin /etc/auto.master
184
185/media/auto /etc/auto.misc --ghost
186#/home /etc/auto.home
187
188# End /etc/auto.master</literal>
189EOF</userinput></screen>
190
191 <para>This file creates a new media directory, <filename>/media/auto</filename>
192 that will overlay any existing directory of the same name. In this example,
193 the file, <filename>/etc/auto.misc</filename>, has a line:</para>
194
195<screen>cd -fstype=iso9660,ro,nosuid,nodev :/dev/cdrom</screen>
196
197 <para>that will mount a cdrom as <filename>/media/auto/cd</filename> if
198 that directory is accessed. The <option>--ghost</option> option tells
199 the automounter to create <quote>ghost</quote> versions (i.e. empty
200 directories) of all the mount points listed in the configuration file
201 regardless whether any of the file systems are actually mounted or not.
202 This is very convenient and highly recommended, because it will show you
203 the available auto-mountable file systems as existing directories, even
204 when their file systems aren't currently mounted. Without the
205 <option>--ghost</option> option, you'll have to remember the names of the
206 directories. As soon as you try to access one of them, the directory will
207 be created and the file system will be mounted. When the file system gets
208 unmounted again, the directory is destroyed too, unless the
209 <option>--ghost</option> option was given.</para>
210
211 <note>
212 <para>An alternative method would be to specify another automount
213 location such as <filename
214 class='directory'>/var/lib/auto/cdrom</filename> and create a
215 symbolic link from <filename class='directory'>/media/cdrom</filename>
216 to the automount location.</para>
217 </note>
218
219 <para>The <filename>auto.misc</filename> file must be configured to your
220 working hardware. The loaded configuration file should load your cdrom
221 if <filename>/dev/cdrom</filename> is active or it can be edited to
222 match your device setup. Examples for floppies are available in the file
223 and easily activated. Documentation for this file is available using the
224 <command>man 5 autofs</command> command.</para>
225
226 <para>In the second line, if enabled, a user's home directory would be
227 mounted via NFS upon login. The <filename>/etc/home.auto</filename>
228 would need to exist and have an entry similar to:</para>
229
230<screen>joe example.org:/export/home/joe</screen>
231
232 <para>where the directory <filename>/export/home/joe</filename> is
233 exported via NFS from the system example.org. NFS shares
234 are covered on the next page.</para>
235
236 <para>This package could also be used to mount SMB shares, however that
237 feature is not configured in these instructions. For additional
238 configuration information, see the man pages for auto.master(5). There
239 are also web resources such as this <ulink
240 url='http://wiki.gentoo.org/wiki/Autofs'>AUTOFS
241 HOWTO</ulink> available.</para>
242
243 </sect3>
244
245 <sect3 id="autofs-init">
246 <title>Boot Script</title>
247
248 <para> <application>autofs</application> installs its own boot script,
249 but it has no capability for logging or visual conformance with other
250 BLFS scripts.</para>
251
252 <para>Install the <filename>/etc/init.d/autofs</filename> mount script
253 included with the <xref linkend="bootscripts"/> package.</para>
254
255 <indexterm zone="autofs autofs-init">
256 <primary sortas="f-autofs-init">autofs</primary>
257 </indexterm>
258
259<screen role="root"><userinput>make install-autofs</userinput></screen>
260
261 <para>The time-out variable is set in
262 <filename>/etc/sysconfig/autofs.conf</filename>. The installed file sets
263 a default of 60 seconds of inactivity before unmounting the device. A
264 much shorter time may be necessary to protect buffer writing to a floppy
265 if users tend to remove the media prior to the timeout setting.</para>
266
267 </sect3>
268
269 </sect2>
270
271 <sect2 role="content">
272 <title>Contents</title>
273
274 <segmentedlist>
275 <segtitle>Installed Program</segtitle>
276 <segtitle>Installed Libraries</segtitle>
277 <segtitle>Installed Directories</segtitle>
278
279 <seglistitem>
280 <seg>automount</seg>
281 <seg>lookup_dir.so, lookup_file.so, lookup_hosts.so, lookup_ldap.so,
282 lookup_multi.so, lookup_nisplus.so, lookup_program.so,
283 lookup_userhome.so, lookup_yp.so, mount_afs.so, mount_autofs.so,
284 mount_bind.so, mount_changer.so, mount_ext2.so, mount_generic.so,
285 mount_nfs.so, parse_sun.so</seg>
286 <seg>/lib/autofs</seg>
287 </seglistitem>
288 </segmentedlist>
289
290 <variablelist>
291 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
292 <?dbfo list-presentation="list"?>
293 <?dbhtml list-presentation="table"?>
294
295 <varlistentry id="automount">
296 <term><command>automount</command></term>
297 <listitem>
298 <para>is the daemon that performs the mounting when a request is
299 made for the device.</para>
300 <indexterm zone="autofs automount">
301 <primary sortas="b-automount">automount</primary>
302 </indexterm>
303 </listitem>
304 </varlistentry>
305
306 </variablelist>
307
308 </sect2>
309
310</sect1>
Note: See TracBrowser for help on using the repository browser.