are made visible to readdir(3): the "/default" entry, wildcard

are made visible to

entries, and those with a "/" in them are not included.  If you specify

.Xr readdir 3 :

"full" to this option, all but "/default" will be visible.

the

.Qq Pa /default

entry, wildcard entries, and those with a

.Qq Pa /

in them are not included.

If you specify

.Qq full

to this option, all but

.Qq Pa /default

will be visible.

.BR stat (2)

.Xr stat 2

the entries, such as often done by "ls -l" or "ls -F", amd will attempt to

the entries, such as often done by

mount

.Qq ls -l

.I every

or

entry in that map.  This is often called a ``mount storm''.

.Qq ls -F ,

.Nm amd

.TP

will attempt to mount

.BR map_options " (string, default no options)"

.Em every

entry in that map.

This is often called a

.Em mount storm .

.It Ic map_options Xo

(string, default no options)

.Xc

amd, such as "cache:=all".

.Nm amd ,

such as

.TP

.Ql cache\&:\&=all .

.BR map_type " (string, default search all map types)"

.It Ic map_type Xo

If specified, amd will initialize the map only for the type given.  This is

(string, default search all map types)

.Xc

If specified, amd will initialize the map only for the type given.

This is

used.  Possible values are

used.

Possible values are

.nf

.Pp

\fBfile\fR      plain files

.Bl -tag -width "nisplus" -compact

\fBhesiod\fR    Hesiod name service from MIT

.It Ic file

\fBldap\fR      Lightweight Directory Access Protocol

plain files

\fBndbm\fR      (New) dbm style hash files

.It Ic hesiod

\fBnis\fR       Network Information Services (version 2)

Hesiod name service from MIT

\fBnisplus\fR   Network Information Services Plus (version 3)

.It Ic ldap

\fBpasswd\fR    local password files

Lightweight Directory Access Protocol

\fBunion\fR     union maps

.It Ic ndbm

.fi

(New) dbm style hash files

.It Ic nis

.TP

Network Information Services (version 2)

.BR mount_type " (string, default=nfs)"

.It Ic nisplus

All amd mount types must be NFS.  That is, amd is an NFS server on the

Network Information Services Plus (version 3)

map mount points, for the local host it is running on.  If "autofs" is

.It Ic passwd

specified, amd will log an error and convert it to NFS.

local password files

.It Ic union 

.TP

union maps

.BR search_path " (string, default no search path)"

.El

This provides a (colon-delimited) search path for file maps.  Using a search

.It Ic mount_type Xo

(string, default=nfs)

.Xc

All

.Nm amd

mount types must be

.Tn NFS .

That is,

.Nm amd

is an

.Tn NFS

server on the

map mount points, for the local host it is running on.

If

.Qq autofs

is specified,

.Nm amd

will log an error and convert it to

.Tn NFS .

.It Ic search_path Xo

(string, default no search path)

.Xc

This provides a

(colon-delimited)

search path for file maps.

Using a search

.El

.\" **************************************************************************

.Ss "Parameters applicable to the global section only"

.SS Parameters applicable to the global section only

.Bl -tag -width 4n

.It Ic arch Xo

.TP

(string, default to compiled in value)

.BR arch " (string, default to compiled in value)"

.Xc

.Ic counter

.Ar counter

.B \-x

.Fl x

option to amd.  Specify any logging options for amd.  Options are comma

option to

delimited, and can be preceded by the string "no" to negate their meaning.

.Nm amd .

The "debug" logging option is only available if am-utils was configured with

Specify any logging options for

--enable-debug.  You can get the list of supported debugging and logging

.Nm amd .

options by running amd \-H.  Possible values are:

Options are comma

delimited, and can be preceded by the string

.nf

.Qq no

\fBall\fR       all messages

to negate their meaning.

\fBdebug\fR     debug messages

The

\fBerror\fR     non-fatal system errors

.Qq debug

\fBfatal\fR     fatal errors

logging option is only available if am-utils was configured with

\fBinfo\fR      information

--enable-debug.

\fBmap\fR       map errors

You can get the list of supported debugging and logging

\fBstats\fR     additional statistical information

options by running

\fBuser\fR      non-fatal user errors

.Nm amd Fl H .

\fBwarn\fR      warnings

Possible values are:

\fBwarning\fR   warnings

.Pp

.fi

.Bl -tag -width "warning" -compact

.It Ic all

.TP

all messages

.BR nfs_vers " (numeric, default to trying version 3 then 2)"

.It Ic debug

By default, amd tries version 3 and then version 2.  This option forces the

debug messages

overall NFS protocol used to version 3 or 2.  It overrides what is in the

.It Ic error

non-fatal system errors

.It Ic fatal

fatal errors

.It Ic info

information

.It Ic map

map errors

.It Ic stats

additional statistical information

.It Ic user

non-fatal user errors

.It Ic warn

warnings

.It Ic warning

warnings

.El

.It Ic nfs_vers Xo

(numeric, default to trying version 3 then 2)

.Xc

By default,

.Nm amd

tries version 3 and then version 2.

This option forces the

overall

.Tn NFS

protocol used to version 3 or 2.

It overrides what is in the

be stable.  With this option you can turn off the complete usage of NFSv3

be stable.

With this option you can turn off the complete usage of NFSv3

.It Ic nfs_retransmit_counter Xo

.TP

(numeric, default=11)

.BR nfs_retransmit_counter " (numeric, default=11)"

.Xc

.I retransmit

.Ar retransmit

.BI \-t " timeout.retransmit"

.Fl t Ar timeout.retransmit

option to amd.

option to

Specifies the number of NFS retransmissions that the kernel will use to

.Nm amd .

communicate with amd.

Specifies the number of

.Tn NFS

.TP

retransmissions that the kernel will use to

.BR nfs_retry_interval " (numeric, default=8)"

communicate with

.Nm amd .

.It Ic nfs_retry_interval Xo

(numeric, default=8)

.Xc

.I timeout

.Ar timeout

.BI \-t " timeout.retransmit"

.Fl t Ar timeout.retransmit

option to amd.  Specifies the NFS timeout interval, in

option to

.I tenths

.Nm amd .

of seconds, between NFS/RPC retries (for UDP only).

Specifies the

.Tn NFS

timeout interval, in

.Em tenths

of seconds, between NFS/RPC

retries (for UDP only).

communicate with amd.

communicate with

.Nm amd .

Amd relies on the kernel RPC retransmit mechanism to trigger mount retries.

.Pp

.Nm Amd

relies on the kernel RPC retransmit mechanism to trigger mount retries.

.B nfs_retransmit_counter

.Ar nfs_retransmit_counter

.B nfs_retry_interval

.Ar nfs_retry_interval

parameters change the overall retry interval.  Too long an interval gives

parameters change the overall retry interval.

Too long an interval gives

.It Ic nfs_proto Xo

.TP

(string, default to trying version tcp then udp)

.BR nfs_proto " (string, default to trying version tcp then udp)"

.Xc

By default, amd tries TCP and then UDP.  This option forces the overall NFS

By default,

protocol used to TCP or UDP.  It overrides what is in the amd maps, and is

.Nm amd

useful when amd is compiled with NFSv3 support that may not be stable.  With

tries TCP and then UDP.

This option forces the overall

.Tn NFS

protocol used to TCP or UDP.

It overrides what is in the amd maps, and is

useful when amd is compiled with NFSv3 support that may not be stable.

With

.It Ic nis_domain Xo

.TP

(string, default to local NIS domain name)

.BR nis_domain " (string, default to local NIS domain name)"

.Xc

Same as the

Same as the

.B \-y

.Fl y

option to amd.  Specify an alternative NIS domain from which to fetch the

option to

NIS maps.  The default is the system domain name.  This option is ignored if

.Nm amd .

NIS support is not available.

Specify an alternative

.Tn NIS

.TP

domain from which to fetch the

.BR normalize_hostnames " (boolean, default=no)"

.Tn NIS

Same as the

maps.

.B \-n

The default is the system domain name.

option to amd.  If "yes", then the name refereed to by ${rhost} is

This option is ignored if

normalized relative to the host database before being used.  The effect is

.Tn NIS

to translate aliases into ``official'' names.

support is not available.

.It Ic normalize_hostnames Xo

.TP

(boolean, default=no)

.BR os " (string, default to compiled in value)"

.Xc

Same as the

Same as the

.B \-O

.Fl n

option to amd.  Allows you to override the compiled-in name of the operating

option to

system.  Useful when the built-in name is not desired for backward

.Nm amd .

compatibility reasons.  For example, if the build in name is

If

.Qq yes ,

then the name refereed to by

.Va ${rhost}

is normalized relative to the host database before being used.

The effect is

to translate aliases into

.Qq official

names.

.It Ic os Xo

(string, default to compiled in value)

.Xc

Same as the

.Fl O

option to

.Nm amd .

Allows you to override the compiled-in name of the operating system.

Useful when the built-in name is not desired for backward

compatibility reasons.

For example, if the build in name is