4.4BSD/usr/share/man/cat8/amd.0

AMD(8)                    BSD System Manager's Manual                   AMD(8)

NNAAMMEE
     aammdd - automatically mount file systems

SSYYNNOOPPSSIISS
     aammdd [--nnpprrvv] [--aa _m_o_u_n_t___p_o_i_n_t] [--cc _d_u_r_a_t_i_o_n] [--dd _d_o_m_a_i_n] [--kk _k_e_r_n_e_l_-_a_r_c_h]
         [--ll _l_o_g_f_i_l_e] [--tt _i_n_t_e_r_v_a_l_._i_n_t_e_r_v_a_l] [--ww _i_n_t_e_r_v_a_l] [--xx _l_o_g_-_o_p_t_i_o_n] [--yy
         _Y_P_-_d_o_m_a_i_n] [--CC _c_l_u_s_t_e_r_-_n_a_m_e] [--DD _o_p_t_i_o_n] [_d_i_r_e_c_t_o_r_y _m_a_p_n_a_m_e
         [--mmaapp--ooppttiioonnss]] _._._.

DDEESSCCRRIIPPTTIIOONN
     AAmmdd is a daemon that automatically mounts filesystems whenever a file or
     directory within that filesystem is accessed.  Filesystems are automati-
     cally unmounted when they appear to be quiescent.

     AAmmdd operates by attaching itself as an NFS server to each of the speci-
     fied _d_i_r_e_c_t_o_r_i_e_s. Lookups within the specified directories are handled by
     aammdd, which uses the map defined by _m_a_p_n_a_m_e to determine how to resolve
     the lookup.  Generally, this will be a host name, some filesystem infor-
     mation and some mount options for the given filesystem.

OOPPTTIIOONNSS
     --aa _t_e_m_p_o_r_a_r_y_-_d_i_r_e_c_t_o_r_y
             Specify an alternative location for the real mount points.  The
             default is _/_a.

     --cc _d_u_r_a_t_i_o_n
             Specify a _d_u_r_a_t_i_o_n, in seconds, that a looked up name remains
             cached when not in use.  The default is 5 minutes.

     --dd _d_o_m_a_i_n
             Specify the local domain name.  If this option is not given the
             domain name is determined from the hostname.

     --kk _k_e_r_n_e_l_-_a_r_c_h
             Specifies the kernel architecture.  This is used solely to set
             the ${karch} selector.

     --ll _l_o_g_f_i_l_e
             Specify a logfile in which to record mount and unmount events.
             If _l_o_g_f_i_l_e is the string _s_y_s_l_o_g, the log messages will be sent to
             the system log daemon by syslog(3).

     --nn      Normalize hostnames.  The name refered to by ${rhost} is normal-
             ized relative to the host database before being used.  The effect
             is to translate aliases into ``official'' names.

     --pp      Print _P_I_D. Outputs the process-id of aammdd to standard output where
             it can be saved into a file.

     --rr      Restart existing mounts.  AAmmdd will scan the mount file table to
             determine which filesystems are currently mounted.  Whenever one
             of these would have been auto-mounted, aammdd _i_n_h_e_r_i_t_s it.

     --tt _i_n_t_e_r_v_a_l_._i_n_t_e_r_v_a_l
             Specify the _i_n_t_e_r_v_a_l, in tenths of a second, between NFS/RPC/UDP
             retries.  The default is 0.8 seconds.  The second values alters
             the restransmit counter.  Useful defaults are supplied if either
             or both values are missing.

     --vv      Version.  Displays version and configuration information on stan-
             dard error.

     --ww _i_n_t_e_r_v_a_l
             Specify an _i_n_t_e_r_v_a_l, in seconds, between attempts to dismount
             filesystems that have exceeded their cached times.  The default
             is 2 minutes.

     --yy _d_o_m_a_i_n
             Specify an alternative NIS domain from which to fetch the NIS
             maps.  The default is the system domain name.  This option is ig-
             nored if NIS support is not available.

     --xx _o_p_t_i_o_n_s
             Specify run-time logging options.  The options are a comma sepa-
             rated list chosen from: fatal, error, user, warn, info, map,
             stats, all.

     --DD _o_p_t_i_o_n
             Select from a variety of debug options.  Prefixing an option with
             the strings _n_o reverses the effect of that option.  Options are
             cumulative.  The most useful option is _a_l_l.

     Since --DD is only used for debugging other options are not documented
     here: the current supported set of options is listed by the --vv option and
     a fuller description is available in the program source.

FFIILLEESS
     /a    directory under which filesystems are dynamically mounted

CCAAVVEEAATTSS
     Some care may be required when creating a mount map.

     Symbolic links on an NFS filesystem can be incredibly inefficient.  In
     most implementations of NFS, their interpolations are not cached by the
     kernel and each time a symbolic link is encountered during a _l_o_o_k_u_p_p_n
     translation it costs an RPC call to the NFS server.  A large improvement
     in real-time performance could be gained by adding a cache somewhere.
     Replacing symlinks(2) with a suitable incarnation of the auto-mounter re-
     sults in a large real-time speedup, but also causes a large number of
     process context switches.

     A weird imagination is most useful to gain full advantage of all the fea-
     tures.

SSEEEE AALLSSOO
     amq(8),  hostname(1),  mount(8),  umount(8),

     _A_m_d _- _T_h_e _4_._4 _B_S_D _A_u_t_o_m_o_u_n_t_e_r.

AAUUTTHHOORR
     Jan-Simon Pendry <jsp@doc.ic.ac.uk>, Department of Computing, Imperial
     College, London, UK.

HHIISSTTOORRYY
     The aammdd utility first appeared in 4.4BSD.

4.4BSD                           June 9, 1993                                2