Virgin import of AMD (am-utils) v6.0a16

1 files changed, 628 insertions, 0 deletions

diff --git a/contrib/amd/NEWS b/contrib/amd/NEWS
new file mode 100644
index 0000000..f1df1e0
--- /dev/null
+++ b/contrib/amd/NEWS
@@ -0,0 +1,628 @@
+*** Notes specific to am-utils version 6.0a16:
+
+- new ports:
+	hppa1.0-hp-hpux11.00 (works, not NFS V.3 due to missing headers)
+	mips-dec-ultrix4.3 (working, unverified)
+
+- new minor ports:
+	i386-pc-bsdi3.1
+	i386-unknown-netbsd1.3.1
+	alpha-dec-osf2.1
+
+- new options addopt:=ARG will "smartly" add and override options specified
+in opts:=
+
+- new amd.conf options:
+	pid_file: specifies the file to store the PID
+	hesiod_base: specifies the base for the Hesiod service
+	unmount_on_exit: if 'yes' will attempt to unmount all file systems
+		when amd exits.
+
+- amd.conf file is parsed after all other command line options.  If no
+options specified at all, then use /etc/amd.conf by default.
+
+- some variables' values are now compared case-insensitive as per specs,
+such as host names, domain names, and more.
+
+- NIS service uses a new isup() function to detect if the service is up
+before using it.  Used to ensure amd doesn't clear the existing maps before
+reloading them, unless the remote info service is working.
+
+- new cdfs mount options: rrip, noversion, defperm, nodefperm (OSF)
+
+- support efs/xfs separately on irix
+
+- new -D info trace option to turn on info specific debugging, such as
+RES_DEBUG for hesiod services.
+
+- document updates and fixes
+
+- new file MIRRORS lists official mirror sites (also in am-utils home page)
+
+- new file BUGS lists known amd/OS bugs
+
+- source restructuring: rename all Amd file-systems' sources to amfs_ARG.c
+such that it matches the type:=ARG as well.  Free names afs/dfs for Andrew
+F/S and Distributed F/S.
+
+- checkpoint config.guess several times during the long configure, so that
+if it is aborted midway, the bulk of the features discovered will be re-read
+from the config.cache file.
+
+- more systems support shared libraries (libtool 1.2)
+
+- using automake 1.3 + more fixes
+
+- bugs fixed:
+	use dynamic buffer for list of interfaces, not fixed size
+	output of amd -H duplicated if >2 interfaces
+	-D mem for hlfsd not on by default (so it will daemonize)
+	linux looks for ext2fs before ufs
+	CDFS looks for 'isofs' mount type as well
+	compile on Solaris 2.6 with /opt/SUNWspro/bin/cc
+	various additional fixes which gcc 2.8.x reported
+	print syslog help string based on what's supported
+	correctly ignore loopback interface on SunOS 3.x
+	don't use -lucb for strcasecmp
+	hlfsd's dump file securely written in /usr/tmp/hlfsd.dump.XXXXXX
+	inherit NFS V.3 mounts correctly
+	write pid file securely
+
+*** Notes specific to am-utils version 6.0a15:
+
+- new ports:
+	alpha-unknown-linux-gnu: works
+	i386-unknown-netbsd1.3: fully working
+	*-sun-sunos3: compiles, not tested
+
+- updated ports:
+	m68k-next-nextstep3: cleaner compile, works.
+
+- new file system type nfsl (NFS Link).  Uses nfs if file system is remote,
+and link if it is local (based on if $rhost equals the host name).
+
+- support for Solaris cachefs.  Requires setting fs, rfs, and a new variable
+cachedir.  See documentation for explanation, examples, and caveats.
+
+- support negated selector functions such as !exists(/foo/bar)
+
+- wire, network, netnumber, in_network() selectors now match against all
+locally attached networks (by either name or number), not just the first two
+interfaces.
+
+- new program pawd (and man page for it) --- Print Automounter Working
+Directory, to print the proper pathname of the cwd or any other pathname,
+adjusted for automounter paths, while avoiding mount points.
+
+- two new switches to amq: -U will force using UDP only; -T will force using
+only TCP to communicate with amd.  If neither (or both) are specified, amq
+will try TCP first, and if that failed, will try UDP.
+
+- support syslog facilities, using "amd -l syslog:facility".  Old behavior
+when using only -l syslog is to use the LOG_DAEMON facility.
+
+- you may specify browsable_dirs=full, to get a listing of all entries
+(other than /default), including those with '*' wildcard and '/'
+characters.
+
+- amd -D trace now also includes as much of struct nfs_args as can be
+displayed.  Useful in figuring out what the kernel really gets during a
+mount(2), as opposed to what the /etc/mnttab file says.  -D trace also
+traces the xdr_* functions.
+
+- support for versions of shared libamu version.  upped version from 0.0.0
+to 1.0.0.  each am-utils release that will change the library will also
+update its version.
+
+- amd/ops_TEMPLATE.c: a new template file for those brave enough to try and
+implement a new amd file system.  Includes comments and other info useful
+for developers.
+
+- if localconfig.h exists in the current directory during the run of
+configure, it is included in all am-utils sources.  This allows courageous
+developers to make certain modifications during compilations, and especially
+turn off undesired features (not very recommended).
+
+- documentation types and updates for all new features, ports, etc.
+
+- bugs fixed:
+	support NFS mount options grpid and maxgrps
+	nextstep: set NFS success code to 0 (NFS_OK), not 1 (EPERM)
+	bsdi2: set NFS success code to 0 (NFS_OK), not 1 (EPERM)
+	set NFS V.3 mount table names to "nfs" if vers/proto exist
+	use mkstemp() if possible (more secure)
+	ctl-amd looks for amd.conf in ${prefix}/etc after /etc
+	hpux: use "ignore" mount table type
+	openbsd2.2: turn off "noconn" mount option, so only connected used
+	fixed memory leak in hlfsd (don't setpwent after endpwent)
+	all NFS3 systems should have proto/vers mount/amd options
+	DEBUG_MEM compiles and prints something more useful
+	uninit_mntfs(): free() mf_private *after* it is used
+	browsable_readdir: fewer bytes sent back to kernel for each chunk
+	mount_toplvl: don't free() an automatic variable!
+	amd should chdir() to / before daemonzing (for core dumps etc)
+	cdfs should be called 'cdfs' not whatever the mnttab type is
+	amd -v: don't print "FS:" list twice when >=2 net interfaces
+
+*** Notes specific to am-utils version 6.0a14:
+
+- updated ports:
+	powerpc-ibm-aix4.2.1.0: NFS V.3 works
+
+- minor new ports:
+	sparc-sun-sunos4.1.3C
+	m68k-sun-sunos4.1.1 (sun3)
+	mips-sgi-irix5.2
+
+- new option to amd, -O ARG, will override the operating systems *name* with
+ARG.  Corrected documentation for amd -o ARG --- it overrides the operating
+system *version* and not the name as the docs incorrectly stated.
+
+- logging now behave more like syslog: will not print repeated strings, but
+rather a count such as "last message repeated N times".  (N will not exceed
+100.)
+
+- restructured the code which deals with the numerous possible fields and
+flags that are set in struct nfs_args.  That code was moved to libamu as
+the functions compute_nfs_args() and compute_automounter_nfs_args().
+
+- bugs fixed:
+	mnttab name ufs/cdfs/pcfs/etc filesystems corrected
+	use pmap_ping for amq (a must for secure portmappers, bsdi2/3)
+	test for xfs (irix) as a disk-based filesystem
+	set correct nfs_prot headers for Solaris 2.5
+	removed stale code from lostaltmail.in
+	lostaltmail will look for conf file in multiple locations
+	assorted documentation corrections
+	amq does not print "get_secure_amd_client" if run as root
+
+*** Notes specific to am-utils version 6.0a13:
+
+- new in_network(ARG) nomadic selector, true if ARG is the name (or number)
+of any of this host's network interfaces.
+
+- removed variables primnetname, primnetnum, subsnetname, and subsnetnum.
+(Kept "wire" and its alias "network", and "netnumber".)
+
+- include am-utils.dvi and am-utils.ps in distribution.
+
+- hlfsd supports new option -P ARG, for reading password map off of file
+ARG.  Allows you to use the hlfs redirector using paths other than user's
+home directories.
+
+- use a replacement yp_all for some systems (irix) known to have a broken
+one which leaks a file descriptor each time called.
+
+- if remote NFS server is down or does not support portmap, downgrade
+machine to NFS V.2 and retry again later.
+
+- bugs:
+	don't redefine yywrap on systems using a modified flex
+	use correct "ignore" mnttab/mount option on hpux for df(1)
+	use nfs_args' fsname field (hpux) to avoid syncer/mount(1) problems
+	don't add ops_ufs.o twice to Makefile's $(OBJS)
+	don't fail if autofs listener fails to initialize
+	hlfsd should test if run as root after usage() and getopt
+
+- minor code cleanups for netbsd
+
+- html docs now in http://www.cs.columbia.edu/~ezk/am-utils/
+
+- added README file in binaries ftp directory
+
+*** Notes specific to am-utils version 6.0a12:
+
+- minor or updated/broken ports fixed:
+	hppa1.1-hp-hpux10.10:	compiles, untested (probably works).
+	hppa1.1-hp-hpux9.05:	compiles, untested (probably works).
+	hppa1.1-hp-hpux9.07:	compiles, untested (probably works).
+	m68k-hp-hpux9.00:	compiles, untested (probably works).
+	rs6000-ibm-aix4.1.4.0:	compiles, untested.
+	sparc-sun-solaris2.6:	works w/ NFS V.3.
+	sparc-sun-sunos4.1.4:	compiles, untested (probably works).
+
+- new ports:
+	powerpc-ibm-aix4.2.1.0:	compiles w/ NFS V.3, untested.
+
+- wire-test also checks for combinations of NFS protocol/version from the
+client to a remote (or local) host.
+
+- conf/mtab/mtab_file.c: use flock() to lock the file, and fcntl() if
+flock() is not available.  (Used to prefer fcntl() over flock().)
+
+- bug fixes:
+	tli get_nfs_version() gets into an infinite loop
+	tli get_nfs_version() should time out faster
+	sockets get_nfs_version() should work w/ secure portmappers
+	ESTALE returned for NFS mounts for SunOS 4.x fixed
+	do not exceed HOSTNAMESZ for nfs_args.hostname (get ENAMETOOLONG)
+	properly initialize some mntent_t fields (fsck, freq, mnt_time)
+	properly initialize some pcfs_args fields (mask, uid, gid)
+	properly initialize some cdfs_args fields (ssector)
+
+*** Notes specific to am-utils version 6.0a11:
+
+- bug fixes:
+	amd could not NFS mount v.2 servers from v.3 clients
+	hlfsd will only use first occurrence of home dir for same uid
+
+*** Notes specific to am-utils version 6.0a10:
+
+- MAJOR DOCUMENTATION UPDATE! (first time in 6 years)
+
+- new ports:
+	m68k-next-nextstep3: configures, compiles, not tested.
+
+- preliminary autofs support.  See README.autofs for details.
+
+- new amd.conf [global] yes/no keywords:
+	show_statfs_entries:	shows number of entries for df(1)
+	fully_qualified_hosts:	use FQHN for NFS/RPC authentication
+
+- detect down remote hosts faster
+
+- log output of "amd -v" at startup
+
+- removed $osver override for solaris: now it is 2.5.1, not 5.5.1
+
+- buildall will use gmake first if available
+
+- bugs fixed:
+	amd core dumped when remote host was down
+	allow up to 1024 entries back from readdir()
+	amd.conf works even if only [global] option defined
+	avoid using bad memcmp() implementations
+	fixed meaning of plock [global] option (was reversed)
+	hlfsd infinite loop unless compiled with --enable-debug
+	NIS code works with NIS+ servers in NIS compatibility mode
+	reset tag fields in amd.conf so they don't carry to other entries
+
+*** Notes specific to am-utils version 6.0a9:
+
+- new ports:
+	sparc-sun-solaris2.4:
+		 configures/compiles, and runs (no NFS V3)
+	i386-unknown-openbsd2.1:
+		configures/compiles, runs (NFS V3)
+
+- updated ports:
+	i486-ncr-sysv4.3.03: configures/compiles, not tested
+
+- Multiple amd support: new amd.conf [global] key "portmap_program" can be
+used to specify an alternate RPC program number for amd to un/register.
+Allowed numbers range from 300019 to 300029.  A matching new option for amq:
+-P prognum, will use an alternate program number to contact.
+
+- man pages:
+	amd.conf.5	new
+	mk-amd-map.8	new
+	amd.8		updated
+	amq.8		updated
+	(other man pages required minor updates)
+
+- shared libraries support expanded.  Using GNU libtool-1.0.  You can build
+a shared version of libamu, and link with it accordingly, by specifying
+--enable-shared to configure.  Default is --enable-static --disable-shared,
+and you can mix and match.  See "INSTALL" file for listing of systems on
+which shared libraries seem to build and work fine.
+
+- new option: amq -p, will return the PID of the running amd (local or
+remote).  Uses a new RPC message.  Useful especially in "ctl-amd stop".
+
+- new configure script options --enable-ldflags, for specifying -L flags.
+The older --enable-libs is to be used only for -l options.
+
+- two new LDAP map options for amd.conf: ldap_cache_seconds and
+ldap_cache_maxmem.
+
+- new script, am-eject from Debian linux's version of amd-upl102.
+
+- additional passwd map support using var[0-3], from Debian folks.
+
+- hesiod code cleanup.  works for hesiod 1.3 as well as 3.0.
+
+- removed defunct -h option from amd.
+
+- started using automake-1.2.  This fixed several bugs that caused some
+versions of yacc/lex and non-GNU make to fail.
+
+- bug fixes:
+	amd/hlfsd mounts should be hidden from df(1)
+	use "noconn" option for nfs mounts (multi-homed hosts)
+	don't use connected sockets on linux before 1.3.10 (from Debian)
+	better checks for [gn]dbm
+	forbid excessive retries after timeouts (from Debian)
+	readdir(): don't skip over map entries with prefix, and include it
+	more assorted linux fixes from Debian folks
+	lofs mount on svr4 was broken
+	find default value of $karch from uname() not $arch
+	hlfsd failed to mount itself on some little-endians
+
+
+*** Notes specific to am-utils version 6.0a8:
+
+- new ports:
+	i386-unknown-netbsd1.2.1: configures/compiles (with NFS V.3), works,
+				  but some OS stability problems exist.
+
+- updated ports:
+	hppa1.1-hp-hpux9.01:
+			now tested and working
+	rs6000-ibm-aix3.2 and rs6000-ibm-aix3.2.5:
+			now tested and working
+
+- fixed browsable directories (readdir) code.
+
+- better methods to find amd/hlfsd pid to kill in ctl-{amd,hlfsd}
+
+- "ignore/auto" mount types fixed for irix, sunos, and others, so "df" does not
+show amd mounts by default (but GNU df -a does).
+
+- each time amd is built, a new "build" version is incremented.  See amd -v.
+
+- man page for fsinfo added
+
+- empty fillers for new file (bsd44) systems: nullfs, unionfs, umapfs.
+
+- when amd is not running, or portmapper is down, make amq timeout faster (5
+sec) than system default, usually 4-5 minutes.
+
+- bug fixes:
+	hlfsd mount got "protocol not supported"
+	first regular map in amd.conf didn't inherit global options
+	make "bad" versions of lex still work with amd/conf_parse.l
+	check for 'nodev' option, not 'nondev'
+	typo in "ro" option, and fillers to ac{reg,dir}{min,max} and others
+	amd.conf parsing done before switching default log/debug options
+	allow doubly-quoted values in amd.conf
+	hesiod-reload code cleanup
+
+- assorted code cleanup
+
+
+*** Notes specific to am-utils version 6.0a7:
+
+- new ports:
+	i386-unknown-freebsd3.0:
+			fully functional with NFS V.3
+	sparc-sun-solaris2.3:
+			fully functional (should work for 2.4)
+	sparc-unknown-netbsd1.2E:
+			configures/compiles (with NFS V.3), untested
+
+- updated ports:
+	i386-pc-bsdi3.0:
+			NFS V.3 works
+			look for hesiod in libc
+	mips-sgi-irix5.3:
+			fully functional with NFS V.3
+
+- LDAP support!  New [global] amd.conf options ldap_base and ldap_hostports.
+Also includes a new script amd2ldif to convert amd maps into plain text LDAP
+object files.
+
+- the following amd.conf variables: browsable_dirs, map_options, map_type,
+mount_type, and search_path --- can now be specified in [global] as well as
+the map entry itself.  That way you can declare them only once in [global],
+and override them as needed per map.
+
+- option "cluster" added to [global] (HPUX clusters ala "amd -C").
+
+- assorted info_hesiod map fixes and cleanup.  removed HESIOD_RELOAD code.
+
+- added netgrp(name) function to amd map syntax to see if current host is in
+the <name> netgroup.
+
+- removed unused option "amd -m".
+
+- filled in "tasks" file with todo items.
+
+- filled "COPYING" file with legal stuff.
+
+- cleanup: all global variables are now in one big structure (struct
+amu_global_options) that's easy to identify and enhance.  Also migrated
+several flags that used be an integer each into one unsigned integer that's
+used as a bit-flag.
+
+- big fixes:
+	xdr_mountres3 should compile only if has NFS V3
+	lex/yacc macros show full pathname (to tell if correct one runs)
+	misc fixes/cleanup
+
+
+*** Notes specific to am-utils version 6.0a6:
+
+- amd configuration file!
+
+See scripts/amd.conf-sample for help and some explanation.  This new conf
+file allows for the following new features:
+
+	default selectors can be turned on/off globally.
+	browsable_dirs/readdir() support can be turned on per map.
+	search paths for file type maps.
+	can force the map type to file, nis, ndbm, etc. rather than default
+		to looking at all of them.
+	tag each map for "amd -T tag", useful for grouping maps.
+	can override $os and others (so if you don't like "sunos5" default
+		naming, set os=sos5 and it will work with your old maps).
+	and more goodies...
+
+- enable-default-selectors: No longer turned on by the configure script or
+optionally compiled.  Code made dynamic and can be turned on or off from the
+amd.conf file.  This code is off by default, and must be turned on by
+amd.conf's [global] section.
+
+- new ports:
+	mips-sgi-irix5.3:	configure/compile, not tested
+	i486-ncr-sysv4.3.03:	configure/compile, not tested
+
+- updated ports:
+	alpha-dec-osf4.0:	major code redone
+	sparc-sun-sunos4.1.3:	fixed and working
+	mips-sgi-irix6.2:	tested with gcc and "cc -32 -Wl,-woff,84"
+	mips-sgi-irix6.4:	tested with gcc and "cc -32 -Wl,-woff,84"
+
+- better NFS3 port, including more support for proto= and vers=, and
+automatic determination of proto/vers combination.
+
+- conf/nfs_prot/nfs_prot_*.h: all of the NFS protocol header files had to be
+redone, because of the osf4 port.  OSF used very different names for these,
+and they conflicted with am-utils'.  The only solution was to more or less
+conform to OSF4's naming, and change all the others.
+
+- ctl-amd script:
+	improved to look for amd.conf in $prefix/etc and /etc
+	better methods for finding the pid of amd to kill
+
+- autoconf support for LDAP.  amd/info_ldap.c needs to be written.
+
+- wire-test also reports the local IP address.  Some systems have multiple,
+buggy version of get_myaddress(), esp. SunOS and Irix.  Note that Solaris
+x86 has a buggy htonl().
+
+- amd -H prints usage.
+
+- bugs fixed:
+	minor TLI problem in fwd_socket
+	mount options properly comma delimited
+	LIBS is set only to the right set of libraries to include
+	selectors-on-default code ignored last selector ent in /defaults
+	assorted code cleanups
+
+
+*** Notes specific to am-utils version 6.0a5:
+
+- NFS Version 3 support!!!
+
+	Works on Solaris 2.5.1.
+	Minimal testing done on Irix 6.
+	Compiles cleanly on DU-4.0 but no tests performed.
+
+Will fall back to V2 mounts when V3 is not available.  Will also use TCP if
+possible, UDP otherwise.
+
+- Ports to new platforms:
+
+	alpha-dec-osf4.0		(not tested)
+	i386-pc-bsdi3.0			(tested and working)
+	i386-unknown-freebsd2.2.1	(tested and working)
+	sparc-unknown-linux-gnu		(tested and working)
+
+- New scripts added:
+
+	amd2sun:	convert amd maps to Sun automount maps
+	ctl-amd:	script to start/stop/restart amd
+	ctl-hlfsd:	script to start/stop/restart hlfsd
+	expn:		expand mail alias (used by hlfsd)
+	lostaltmail:	redeliver "lost" mail redirected by hlfsd
+	lostaltmail.conf-sample:	sample conf file for lostaltmail
+	wait4amd:	run a command once amd is up on a host
+	wait4amd2die:	wait for an amd process to die before returning
+
+- "amd -v" now includes more info and "amq -v" lists all of it.
+
+- new parser for linux specific mount options.
+
+- Main bugs fixed:
+
+	"new toplvl readdir" bug caused amd to dump core
+	handler for SIGCHLD didn't check for all possible children
+	hlfsd leaking file descriptors when home file system was full
+	cdfs/pcfs mounts should not timeout by default
+	hesiod domain names should be compared in case-insensitive manner
+	several printfs in amq were missing \n
+
+
+*** Notes specific to am-utils version 6.0a4:
+
+- amd services both TCP and UDP amq requests.  This will help because of the
+limited UDP message size.
+
+- "amq -M" code is disabled by default because it is insecure.  It is
+rarely used.  Users who wish to use it should run
+"configure --enable-amq-mount".
+
+
+*** Notes specific to am-utils version 6.0a3:
+
+- New tested ports (configures, compiles, and runs):
+
+	i386-unknown-freebsd2.2
+
+- New ports (configures and compiles correctly, not tested):
+
+	rs6000-ibm-aix3.2.5
+	rs6000-ibm-aix4.1.5.0
+
+- More am-utils programs ported to all existing platforms: hlfsd, fsinfo,
+mk-amd-map, and fixmount.
+
+- Shared libraries: a new configure option --enable-shared will build a
+shared libamu.so, link applications with it, and use it.  Reduces binary
+sizes by 20-30%.  This is the first step towards loadable modules, as many
+changes had to be done to be able to compile and use PIC code.  This is code
+that obviously needs to be generalized to be able to build shared libraries
+on many other platforms.  It was only tested on Solaris 5.5.1.
+
+- the file INSTALL contains the latest compatibility table of which
+platforms am-utils configures, compiles and runs on.
+
+- Trimmed down the size of the configure script.  Some tests that are not
+used anywhere were removed.
+
+
+*** Notes specific to am-utils version 6.0a2:
+
+- New ports (configures and compiles correctly, not tested):
+
+	i386-pc-bsdi2.1
+	hppa1.1-hp-hpux9.01
+	hppa1.1-hp-hpux10.20
+
+- new configure options:
+
+	--enable-cppflags[=ARG]
+		configure/compile with ARG (-I) preprocessor flags
+	--enable-libs[=ARG]
+		configure/compile with ARG (-L/-l) library flags
+
+- filesystem, mount table entries, and mount type tests can now look in
+/lib/modules and /proc/filesystems for statically/dyadically loadable kernel
+modules (linux)
+
+- prefer vfat over msdos/pc/etc filesystem for PCFS.
+
+- moved all fixed headers to include/am_defs.  Left only #define/#undef
+entries in aux/acconfig.h.
+
+- make more sense of systems that have full, partial, or no NFS protocol
+headers.
+
+- minor fixes for NetBSD (untested platform).
+
+- hesiod map fixed.
+
+- buildall -D: new option to run even stricter developer options.
+
+- lots of other bugs fixed (see ChangeLog).
+
+
+*** Notes specific to am-utils version 6.0a1:
+
+I have it configure and build correctly for the following systems:
+
+	i386-pc-solaris2.5.1
+	i386-unknown-freebsd2.1.0
+	mips-sgi-irix6.2
+	sparc-sun-solaris2.5.1
+	sparc-sun-sunos4.1.3
+
+Amq, wire-test, and "amd -v" work on all of the above.  A real running amd
+was only tested and confirmed working on
+
+	i386-pc-solaris2.5.1
+	sparc-sun-solaris2.5.1
+
+Many things are still missing: options, features, etc.  But for now, let's
+concentrate on getting the basic functionality working on the more popular
+systems.