delete amd(8) section from the handbook - it is obsolete

In addition amd has been disabled by default in src r354902.

Reviewed by:	bcr
Approved by:	bcr
Sponsored by:	The FreeBSD Foundation
Differential Revision:	https://reviews.freebsd.org/D22459
This commit is contained in:
Ed Maste 2019-11-20 17:43:36 +00:00
parent 6eeaff09eb
commit 5c9998f2cc
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=53617

View file

@ -798,110 +798,6 @@ rpc_statd_enable="YES"</programlisting>
for further details.</para>
</sect2>
<sect2 xml:id="network-amd">
<info>
<title>Automating Mounts with &man.amd.8;</title>
<authorgroup>
<author>
<personname>
<firstname>Wylie</firstname>
<surname>Stilwell</surname>
</personname>
<contrib>Contributed by </contrib>
</author>
</authorgroup>
<authorgroup>
<author>
<personname>
<firstname>Chern</firstname>
<surname>Lee</surname>
</personname>
<contrib>Rewritten by </contrib>
</author>
</authorgroup>
</info>
<indexterm><primary>amd</primary></indexterm>
<indexterm>
<primary>automatic mounter daemon</primary>
</indexterm>
<para>The automatic mounter daemon,
<application>amd</application>, automatically mounts a remote
file system whenever a file or directory within that file
system is accessed. File systems that are inactive for a
period of time will be automatically unmounted by
<application>amd</application>.</para>
<para>This daemon provides an alternative to modifying
<filename>/etc/fstab</filename> to list every client. It
operates by attaching itself as an <acronym>NFS</acronym>
server to the <filename>/host</filename> and
<filename>/net</filename> directories. When a file is
accessed within one of these directories,
<application>amd</application> looks up the corresponding
remote mount and automatically mounts it.
<filename>/net</filename> is used to mount an exported file
system from an <acronym>IP</acronym> address while
<filename>/host</filename> is used to mount an export from a
remote hostname. For instance, an attempt to access a file
within <filename>/host/foobar/usr</filename> would tell
<application>amd</application> to mount the
<filename>/usr</filename> export on the host
<systemitem>foobar</systemitem>.</para>
<example>
<title>Mounting an Export with
<application>amd</application></title>
<para>In this example, <command>showmount -e</command> shows
the exported file systems that can be mounted from the
<acronym>NFS</acronym> server,
<systemitem>foobar</systemitem>:</para>
<screen>&prompt.user; <userinput>showmount -e foobar</userinput>
Exports list on foobar:
/usr 10.10.10.0
/a 10.10.10.0
&prompt.user; <userinput>cd /host/foobar/usr</userinput></screen>
</example>
<para>The output from <command>showmount</command> shows
<filename>/usr</filename> as an export. When changing
directories to <filename>/host/foobar/usr</filename>,
<application>amd</application> intercepts the request and
attempts to resolve the hostname
<systemitem>foobar</systemitem>. If successful,
<application>amd</application> automatically mounts the
desired export.</para>
<para>To enable <application>amd</application> at boot time, add
this line to <filename>/etc/rc.conf</filename>:</para>
<programlisting>amd_enable="YES"</programlisting>
<para>To start <application>amd</application> now:</para>
<screen>&prompt.root; <userinput>service amd start</userinput></screen>
<para>Custom flags can be passed to
<application>amd</application> from the
<varname>amd_flags</varname> environment variable. By
default, <varname>amd_flags</varname> is set to:</para>
<programlisting>amd_flags="-a /.amd_mnt -l syslog /host /etc/amd.map /net /etc/amd.map"</programlisting>
<para>The default options with which exports are mounted are
defined in <filename>/etc/amd.map</filename>. Some of the
more advanced features of <application>amd</application> are
defined in <filename>/etc/amd.conf</filename>.</para>
<para>Consult &man.amd.8; and &man.amd.conf.5; for more
information.</para>
</sect2>
<sect2 xml:id="network-autofs">
<title>Automating Mounts with &man.autofs.5;</title>