source: general/sysutils/autofs.xml@ b08a9ed

10.0 10.1 11.0 11.1 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since b08a9ed was b08a9ed, checked in by Bruce Dubbs <bdubbs@…>, 4 years ago

Update to clutter-gst-3.0.26.
Update to gtk+3-3.22.29.
Update to pango-1.42.0.
Added rpcsvc-proto as a required dependency of autofs.

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

  • Property mode set to 100644
File size: 12.6 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 "&kernel-dl;/linux/daemons/autofs/v5/autofs-&autofs-version;.tar.xz">
8 <!ENTITY autofs-download-ftp " ">
9 <!ENTITY autofs-md5sum "5d35e3282e7a47ec1a5acaeebcc51db2">
10 <!ENTITY autofs-size "300 KB">
11 <!ENTITY autofs-buildsize "7.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 &lfs82_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">Required</bridgehead>
66 <para role="required">
67 <xref linkend="libtirpc"/> and
68 <xref linkend="rpcsvc-proto"/>
69 </para>
70
71 <bridgehead renderas="sect4">Optional</bridgehead>
72 <para role="optional">
73 <xref linkend="nfs-utils"/>,
74 <xref linkend="libxml2"/>,
75 <xref linkend="mitkrb"/>,
76 <xref linkend="openldap"/> (client only), and
77 <xref linkend="cyrus-sasl"/>
78 </para>
79
80 <para condition="html" role="usernotes">User Notes:
81 <ulink url="&blfs-wiki;/autofs"/></para>
82
83 </sect2>
84
85 <sect2 role="kernel" id="autofs-kernel">
86 <title>Kernel Configuration</title>
87
88 <indexterm zone="autofs autofs-kernel">
89 <primary sortas="d-Automounter">Automounter</primary>
90 </indexterm>
91
92 <para>
93 Verify that automounter kernel support has been enabled:
94 </para>
95
96<screen><literal>File systems ---&gt;
97 &lt;*/M&gt; Kernel automounter version 4 support (also supports v3) [CONFIG_AUTOFS4_FS]</literal></screen>
98
99 <para>
100 Optionally, enable the following options in the kernel configuration:
101 </para>
102
103<screen><literal>File systems ---&gt;
104 [*] Network File Systems ---&gt; [CONFIG_NETWORK_FILESYSTEMS]
105 &lt;*/M&gt; NFS client support [CONFIG_NFS_FS]
106 &lt;*/M&gt; CIFS support (advanced network filesystem, SMBFS successor) [CONFIG_CIFS]</literal></screen>
107
108 <para>Recompile and install the new kernel, if necessary.</para>
109
110 </sect2>
111
112 <sect2 role="installation">
113
114 <title>Installation of Autofs</title>
115
116 <para>Install <application>Autofs</application> by running the following
117 commands:</para>
118
119<screen revision="sysv"><userinput>./configure --prefix=/ \
120 --with-libtirpc \
121 --without-openldap \
122 --mandir=/usr/share/man &amp;&amp;
123make</userinput></screen>
124
125<screen revision="systemd"><userinput>./configure --prefix=/ \
126 --with-libtirpc \
127 --with-systemd \
128 --without-openldap \
129 --mandir=/usr/share/man &amp;&amp;
130
131make</userinput></screen>
132
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>
136
137<screen role="root"><userinput>make install</userinput></screen>
138
139 </sect2>
140
141 <sect2 role="commands">
142 <title>Command Explanations</title>
143
144 <para>
145 <parameter>--with-libtirpc</parameter>: This switch forces the package to
146 use libtirpc for RPC functionality instead of relying on implementation
147 from Glibc, which was removed in LFS 8.1.
148 </para>
149
150 <para revision="systemd">
151 <parameter>--with-systemd</parameter>: This switch enables installation
152 of the bundled systemd units.
153 </para>
154
155 <para>
156 <parameter>--without-openldap</parameter>: This switch disables openldap
157 if found. If openldap is desired, omit this switch. Note that openldap
158 support in autofs requires <xref linkend="mitkrb"/>.
159 </para>
160
161 </sect2>
162
163 <sect2 role="configuration">
164 <title>Configuring Autofs</title>
165
166 <sect3 id="autofs-config">
167 <title>Config Files</title>
168
169 <para><filename>/etc/sysconfig/autofs.conf</filename>,
170 <filename>/etc/auto.master</filename>,
171 <filename>/etc/auto.misc</filename>, and
172 <filename>/etc/auto.net</filename></para>
173
174 <indexterm zone="autofs autofs-config" >
175 <primary sortas="e-etc-sysconfig-autofs.conf">/etc/sysconfig/autofs.conf</primary>
176 </indexterm>
177
178 <indexterm zone="autofs autofs-config">
179 <primary sortas="e-etc-auto.master">/etc/auto.master</primary>
180 </indexterm>
181
182 <indexterm zone="autofs autofs-config">
183 <primary sortas="e-etc-auto.misc">/etc/auto.misc</primary>
184 </indexterm>
185
186 <indexterm zone="autofs autofs-config">
187 <primary sortas="e-etc-auto.net">/etc/auto.net</primary>
188 </indexterm>
189
190 </sect3>
191
192 <sect3>
193 <title>Configuration Information</title>
194
195 <para>The installation process creates <filename>auto.master</filename>,
196 <filename>auto.misc</filename>, <filename>auto.smb</filename>, and
197 <filename>auto.net</filename>. Replace the
198 <filename>auto.master</filename> file with the following commands
199 as the <systemitem class="username">root</systemitem> user:</para>
200
201<screen role="root"><userinput>mv /etc/auto.master /etc/auto.master.bak &amp;&amp;
202cat &gt; /etc/auto.master &lt;&lt; "EOF"
203<literal># Begin /etc/auto.master
204
205/media/auto /etc/auto.misc --ghost
206#/home /etc/auto.home
207
208# End /etc/auto.master</literal>
209EOF</userinput></screen>
210
211 <para>This file creates a new media directory, <filename>/media/auto</filename>
212 that will overlay any existing directory of the same name. In this example,
213 the file, <filename>/etc/auto.misc</filename>, has a line:</para>
214
215<screen>cd -fstype=iso9660,ro,nosuid,nodev :/dev/cdrom</screen>
216
217 <para>that will mount a cdrom as <filename>/media/auto/cd</filename> if
218 that directory is accessed. The <option>--ghost</option> option tells
219 the automounter to create <quote>ghost</quote> versions (i.e. empty
220 directories) of all the mount points listed in the configuration file
221 regardless whether any of the file systems are actually mounted or not.
222 This is very convenient and highly recommended, because it will show you
223 the available auto-mountable file systems as existing directories, even
224 when their file systems aren't currently mounted. Without the
225 <option>--ghost</option> option, you'll have to remember the names of the
226 directories. As soon as you try to access one of them, the directory will
227 be created and the file system will be mounted. When the file system gets
228 unmounted again, the directory is destroyed too, unless the
229 <option>--ghost</option> option was given.</para>
230
231 <note>
232 <para>An alternative method would be to specify another automount
233 location such as <filename
234 class='directory'>/var/lib/auto/cdrom</filename> and create a
235 symbolic link from <filename class='directory'>/media/cdrom</filename>
236 to the automount location.</para>
237 </note>
238
239 <para>The <filename>auto.misc</filename> file must be configured to your
240 working hardware. The loaded configuration file should load your cdrom
241 if <filename>/dev/cdrom</filename> is active or it can be edited to
242 match your device setup. Examples for floppies are available in the file
243 and easily activated. Documentation for this file is available using the
244 <command>man 5 autofs</command> command.</para>
245
246 <para>In the second line, if enabled, a user's home directory would be
247 mounted via NFS upon login. The <filename>/etc/home.auto</filename>
248 would need to exist and have an entry similar to:</para>
249
250<screen>joe example.org:/export/home/joe</screen>
251
252 <para>where the directory <filename>/export/home/joe</filename> is
253 exported via NFS from the system example.org. NFS shares
254 are covered on the next page.</para>
255
256 <para>This package could also be used to mount SMB shares, however that
257 feature is not configured in these instructions. For additional
258 configuration information, see the man pages for auto.master(5). There
259 are also web resources such as this <ulink
260 url='http://wiki.gentoo.org/wiki/AutoFS'>AUTOFS
261 HOWTO</ulink> available.</para>
262
263 </sect3>
264
265 <sect3 id="autofs-init">
266 <title><phrase revision="sysv">Boot Script</phrase>
267 <phrase revision="systemd">Systemd Unit</phrase></title>
268
269 <para revision="sysv"><application>autofs</application> installs its own
270 boot script, but it has no capability for logging or visual conformance
271 with other BLFS scripts.</para>
272
273 <para revision="sysv">Install the <filename>/etc/init.d/autofs</filename>
274 mount script included with the <xref linkend="bootscripts"/>
275 package.</para>
276
277 <para revision="systemd">
278 To start <application>Autofs</application> at boot, enable the
279 previously installed systemd unit by running the following command as
280 the <systemitem class="username">root</systemitem> user:
281 </para>
282
283 <indexterm zone="autofs autofs-init">
284 <primary sortas="f-autofs-init">autofs</primary>
285 </indexterm>
286
287<screen role="root" revision="sysv"><userinput>make install-autofs</userinput></screen>
288
289<screen role="root" revision="systemd"><userinput>systemctl enable autofs</userinput></screen>
290
291 <para revision="sysv">The time-out variable is set in
292 <filename>/etc/sysconfig/autofs.conf</filename>. The installed file sets
293 a default of 60 seconds of inactivity before unmounting the device. A
294 much shorter time may be necessary to protect buffer writing to a floppy
295 if users tend to remove the media prior to the timeout setting.</para>
296
297 <note revision="systemd">
298 <para>
299 You can also specify <envar>OPTIONS</envar> variable in the
300 <filename>/etc/sysconfig/autofs</filename> file with any additional
301 parameters that you might want to pass to the automount daemon.
302 </para>
303 </note>
304
305 </sect3>
306
307 </sect2>
308
309 <sect2 role="content">
310 <title>Contents</title>
311
312 <segmentedlist>
313 <segtitle>Installed Program</segtitle>
314 <segtitle>Installed Libraries</segtitle>
315 <segtitle>Installed Directories</segtitle>
316
317 <seglistitem>
318 <seg>automount</seg>
319 <seg>
320 lookup_dir.so, lookup_file.so, lookup_files.so, lookup_hosts.so,
321 lookup_ldap.so, lookup_multi.so, lookup_nis.so, lookup_nisplus.so,
322 lookup_program.so, lookup_userhome.so, lookup_yp.so, mount_afs.so,
323 mount_autofs.so, mount_bind.so, mount_changer.so, mount_ext2.so,
324 mount_ext3.so, mount_ext4.so, mount_generic.so, mount_nfs.so,
325 mount_nfs4.so, parse_amd.so, and parse_sun.so
326 </seg>
327 <seg>/lib/autofs</seg>
328 </seglistitem>
329 </segmentedlist>
330
331 <variablelist>
332 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
333 <?dbfo list-presentation="list"?>
334 <?dbhtml list-presentation="table"?>
335
336 <varlistentry id="automount">
337 <term><command>automount</command></term>
338 <listitem>
339 <para>is the daemon that performs the mounting when a request is
340 made for the device.</para>
341 <indexterm zone="autofs automount">
342 <primary sortas="b-automount">automount</primary>
343 </indexterm>
344 </listitem>
345 </varlistentry>
346
347 </variablelist>
348
349 </sect2>
350
351</sect1>
Note: See TracBrowser for help on using the repository browser.