[src/netbsd-1-5]: src/usr.sbin/amd/amd Pull up revision 1.1 (new, requested b...

[he <he%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/69fa47017ed2
branches:  netbsd-1-5
changeset: 490633:69fa47017ed2
user:      he <he%NetBSD.org@localhost>
date:      Sat Feb 03 22:04:53 2001 +0000

description:
Pull up revision 1.1 (new, requested by wiz):
  Add amd.conf.5 from dist/am-utils/scripts here, and install it.
  Fixes PR#5051, PR#7524, PR#8999, PR#10814.

diffstat:

 usr.sbin/amd/amd/amd.conf.5 |  566 ++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 566 insertions(+), 0 deletions(-)

diffs (truncated from 570 to 300 lines):

diff -r 352c71891435 -r 69fa47017ed2 usr.sbin/amd/amd/amd.conf.5
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/usr.sbin/amd/amd/amd.conf.5       Sat Feb 03 22:04:53 2001 +0000
@@ -0,0 +1,566 @@
+.\"
+.\" Copyright (c) 1997-1999 Erez Zadok
+.\" Copyright (c) 1990 Jan-Simon Pendry
+.\" Copyright (c) 1990 Imperial College of Science, Technology & Medicine
+.\" Copyright (c) 1990 The Regents of the University of California.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to Berkeley by
+.\" Jan-Simon Pendry at Imperial College, London.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgment:
+.\"      This product includes software developed by the University of
+.\"      California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"    %W% (Berkeley) %G%
+.\"
+.\" $NetBSD: amd.conf.5,v 1.2.2.1 2001/02/03 22:04:53 he Exp $
+.\" Id: amd.conf.5,v 1.4 1999/09/30 21:01:43 ezk Exp 
+.\"
+.TH AMD.CONF 8 "7 August 1997"
+.SH NAME
+amd.conf \- amd configuration file
+.SH SYNOPSIS
+.B amd.conf
+.SH DESCRIPTION
+The
+.B amd.conf
+file is the configuration file for amd, as part of the am-utils suite.
+.P
+.B amd.conf
+contains runtime configuration information for the
+.B amd
+automounter program.
+.\" **************************************************************************
+.SH FILE FORMAT
+.P
+The file consists of sections and parameters.  A section begins with the
+name of the section in square brackets and continues until the next section
+begins or the end the file is reached.  Sections contain parameters of the
+form 'name = value'.
+.P
+The file is line-based - that is, each newline-terminated line represents
+either a comment, a section name or a parameter.  No line-continuation
+syntax is available.
+.P
+Section, parameter names and their values are case sensitive.
+.P
+Only the first equals sign in a parameter is significant.  Whitespace before
+or after the first equals sign is discarded.  Leading, trailing and
+internal whitespace in section and parameter names is irrelevant.  Leading
+and trailing whitespace in a parameter value is discarded.  Internal
+whitespace within a parameter value is not allowed, unless the whole
+parameter value is quoted with double quotes as in 'name = "some value"'.
+.P
+Any line beginning with a pound sign (#) is ignored, as are lines containing
+only whitespace.
+.P
+The values following the equals sign in parameters are all either a string
+(no quotes needed if string does not include spaces) or a boolean, which may
+be given as yes/no.  Case is significant in all values.  Some items such as
+cache timeouts are numeric.
+.\" **************************************************************************
+.SH SECTIONS
+.SS The [global] section
+Parameters in this section either apply to amd as a whole, or to all other
+regular map sections which follow.  There should be only one global section
+defined in one configuration file.
+.P
+It is highly recommended that this section be specified first in the
+configuration file.  If it is not, then regular map sections which precede
+it will not use global values defined later.
+
+.SS Regular [/map] sections
+Parameters in regular (non-global) sections apply to a single map entry.
+For example, if the map section
+.B [/homes]
+is defined, then all parameters following it will be applied to the
+.I /homes
+amd-managed mount point.
+.\" **************************************************************************
+.SH PARAMETERS
+.SS Parameters common to all sections
+These parameters can be specified either in the global or a map specific
+section.  Entries specified in a map-specific section override the default
+value or one defined in the global section.   If such a common parameter is
+specified only in the global section, it is applicable to all regular map
+sections that follow.
+.\" **************************************************************************
+.TP
+.BR browsable_dirs " (string, default=no)"
+If "yes", then amd's top-level mount points will be browsable to
+.BR readdir (3)
+calls.  This means you could run for example
+.BR ls (3)
+and see what keys are available to mount in that directory.  Not all entries
+are made visible to readdir(3): the "/default" entry, wildcard
+entries, and those with a "/" in them are not included.  If you specify
+"full" to this option, all but "/default" will be visible.
+Note that if you run a command which will attempt to
+.BR stat (2)
+the entries, such as often done by "ls -l" or "ls -F", amd will attempt to
+mount
+.I every
+entry in that map.  This is often called a ``mount storm''.
+
+.TP
+.BR map_options " (string, default no options)"
+This option is the same as specifying map options on the command line to
+amd, such as "cache:=all".
+
+.TP
+.BR map_type " (string, default search all map types)"
+If specified, amd will initialize the map only for the type given.  This is
+useful to avoid the default map search type used by amd which takes longer
+and can have undesired side-effects such as initializing NIS even if not
+used.  Possible values are
+
+.nf
+\fBfile\fR      plain files
+\fBhesiod\fR    Hesiod name service from MIT
+\fBldap\fR      Lightweight Directory Access Protocol
+\fBndbm\fR      (New) dbm style hash files
+\fBnis\fR       Network Information Services (version 2)
+\fBnisplus\fR   Network Information Services Plus (version 3)
+\fBpasswd\fR    local password files
+\fBunion\fR     union maps
+.fi
+
+.TP
+.BR mount_type " (string, default=nfs)"
+All amd mount types default to NFS.  That is, amd is an NFS server on the
+map mount points, for the local host it is running on.  If "autofs" is
+specified, amd will be an autofs server for those mount points.
+
+.TP
+.BR search_path " (string, default no search path)"
+This provides a (colon-delimited) search path for file maps.  Using a search
+path, sites can allow for local map customizations and overrides, and can
+distributed maps in several locations as needed.
+
+.\" **************************************************************************
+.SS Parameters applicable to the global section only
+
+.TP
+.BR arch " (string, default to compiled in value)"
+Allows you to override the value of the
+.I arch
+amd variable.
+
+.TP
+.BR auto_dir " (string, default=/a)"
+Same as the
+.B \-a
+option to amd.  This sets the private directory where amd will create
+sub-directories for its real mount points.
+
+.TP
+.BR cache_duration " (numeric, default=300)"
+Same as the
+.B \-c
+option to amd.  Sets the duration in seconds that looked up map entries
+remain in the cache.
+
+.TP
+.BR cluster " (string, default no cluster)"
+Same as the
+.B \-C
+option to amd.  Specifies the alternate HP-UX cluster to use.
+
+.TP
+.BR debug_options " (string, default no debug options)"
+Same as the
+.B \-D
+option to amd.  Specify any debugging options for amd.  Works only if
+am-utils was configured for debugging using the --enable-debug option.  The
+"mem" option, as well as all other options, can be turned on via
+--enable-debug=mem.  Otherwise debugging options are ignored.  Options are
+comma delimited, and can be preceded by the string "no" to negate their
+meaning.  You can get the list of supported debugging options by running amd
+\-H.  Possible values are:
+
+.nf
+\fBall\fR       all options
+\fBamq\fR       register for amq
+\fBdaemon\fR    enter daemon mode
+\fBfork\fR      fork server
+\fBfull\fR      program trace
+\fBinfo\fR      info service specific debugging (hesiod, nis, etc.)
+\fBmem\fR       trace memory allocations
+\fBmtab\fR      use local "./mtab" file
+\fBstr\fR       debug string munging
+\fBtest\fR      full debug but no daemon
+\fBtrace\fR     trace RPC protocol and NFS mount arguments
+.fi
+
+.TP
+.BR dismount_interval " (numeric, default=120)"
+Same as the
+.B \-w
+option to amd.  Specify in seconds, the time between attempts to dismount
+file systems that have exceeded their cached times.
+
+.TP
+.BR full_os " (string, default to compiled in value)"
+The full name of the operating system, along with its version.  Allows you
+to override the compiled-in full name and version of the operating system.
+Useful when the compiled-in name is not desired.  For example, the full
+operating system name on linux comes up as ``linux'', but you can override
+it to ``linux-2.2.5.''
+
+.TP
+.BR fully_qualified_hosts " (string, default=no)"
+If "yes",
+.I Amd
+will perform RPC authentication using fully-qualified host names.  This is
+necessary for some systems, and especially when performing cross-domain
+mounting.  For this function to work, the
+.I Amd
+variable ${hostd} is used, requiring that ${domain} not be null.
+
+.TP
+.BR hesiod_base " (string, default=automount)"
+Specify the base name for hesiod maps.
+
+.TP
+.BR karch " (string, default to karch of the system)"
+Same as the
+.B \-k
+option to amd.  Allows you to override the kernel-architecture of your
+system.  Useful for example on Sun (Sparc) machines, where you can build one
+amd binary, and run it on multiple machines, yet you want each one to get
+the correct
+.I karch
+variable set (for example, sun4c, sun4m, sun4u, etc.)  Note that if not
+specified, amd will use uname(2) to figure out the kernel architecture of
+the machine.
+
+.TP
+.BR ldap_base " (string, default not set)"
+Specify the base name for LDAP.
+
+.TP
+.BR ldap_cache_maxmem " (numeric, default=131072)"
+Specify the maximum memory amd should use to cache LDAP entries.
+
+.TP
+.BR ldap_cache_seconds " (numeric, default=0)"
+Specify the number of seconds to keep entries in the cache.
+
+.TP
+.BR ldap_hostports " (string, default not set)"
+Specify LDAP-specific values such as country and organization.
+
+.TP
+.BR local_domain " (string, default no sub-domain)"
+Same as the
+.B \-d
+option to amd.  Specify the local domain name.  If this option is not given
+the domain name is determined from the hostname, by removing the first
+component of the fully-qualified host name.
+
+.TP
+.BR log_file " (string, default=/dev/stderr)"
+Same as the
+.B \-l
+option to amd.  Specify a file name to log amd events to.
+If the string
+.B /dev/stderr
+is specified, amd will send its events to the standard error file descriptor.
+If the string
+.B syslog
+is given, amd will record its events with the system logger