From: Erez Zadok Date: Wed, 16 Mar 2005 03:52:56 +0000 (+0000) Subject: * tasks: updates. Executable maps is supported. NFSv4 and X-Git-Tag: am-utils-6_1_rc1~4 X-Git-Url: https://git.fsl.cs.sunysb.edu/?a=commitdiff_plain;h=a94fedcc3efd72fe9d239b73fe2d0ca1d11d215e;p=am-utils-6.2.git * tasks: updates. Executable maps is supported. NFSv4 and FreeBSD autofs isn't. * Makefile.am (EXTRA_DIST): include FAQ in distro. * doc/Makefile.am (alldocs): install README.lda and README.osx. * FAQ: new file, better late than never. --- diff --git a/ChangeLog b/ChangeLog index 56edc4f5..9f090bea 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,14 @@ +2005-03-15 Erez Zadok + + * tasks: updates. Executable maps is supported. NFSv4 and + FreeBSD autofs isn't. + + * Makefile.am (EXTRA_DIST): include FAQ in distro. + + * doc/Makefile.am (alldocs): install README.lda and README.osx. + + * FAQ: new file, better late than never. + 2005-03-14 Erez Zadok * scripts/amd2ldif.in: patch to add the amdMapName attribute to diff --git a/FAQ b/FAQ new file mode 100644 index 00000000..18e73a3f --- /dev/null +++ b/FAQ @@ -0,0 +1,69 @@ + Am-utils Frequently Asked Questions + +Note: we started this FAQ only on March 15, 2005; so it's not long or +comprehensive, yet. Amd is much older than that, and so there's a lot of +information that's already available in other forms. If this FAQ doesn't +answer your questions, see information in the following sources: + +1. The Am-utils book: http://www.am-utils.org/docs/amd-book/ + +2. The Am-utils user manual, which is part of the distribution and is also + available from www.am-utils.org. + +3. The www.am-utils.org Web site resources, especially the "am-utils" mailing + list (and its archives). + +4. In the am-utils distribution (always use the latest ones), see all of the + various README files (README, README.autofs, README.ldap, README.osx, and + README.y2k). The "BUGS" file also lists useful information about bugs + and problems with specific OSs which affect Amd. All of these text files + are also available from www.am-utils.org. + +5. Some FAQ questions (including newbie questions) are available here: + http://www.kernelcorp.com/resources_faqs.html + +6. Some problems are known bugs but have not been fixed yet: this are + listed in bugzilla in https://bugzilla.am-utils.org/ + +If you have additions to this FAQ, please let us know at +am-utils@am-utils.org. + +Thank you, +The Am-utils development team. + + + +*** Linux Questions + +Q1. When I use Amd with Autofs and I restart Amd, how come it cannot remount + the Autofs partitions? + +A1. This is a limitation of the Linux Autofs kernel module (for both autofs + v2. and v3). The Linux Autofs does not allow restarting automounted + points. There's nothing Amd can do about this. In fact, the same + problem exists if you use the userland "automount" daemon instead of + Amd. Hopefully Autofs-v4 or the separate effort of Autofs-NG will + address this serious problem. + + Note that Amd itself can restart autofs automounted points just fine on + OSs that support it, for example Solaris. + + +Q2. When I use Amd, I get this console message frequently: "mount version + older than kernel." Is it a problem? + +A2. No, it's a harmless warning message that the Linux kernel prints for NFS + mounts. The intent was to alert administrators that the kernel has + supposedly a different version of the mount(2) code than a userland + program used. This happens if you compile Amd against kernel headers + that are different than the kernel you're running. If the message + really bothers you, then one way to "fix" the problem is to recompile + Amd against the same kernel headers as the running kernel. + + Nevertheless, it is a relatively useless message because as far as we + know, the NFS v2 and v3 mount codes have been in perfect sync between + the userland and kernel sides, and were "standardized" for years + already. This warning message caused more unnecessary worry among + administrators than helping alert them to legitimate problems. + + diff --git a/INSTALL b/INSTALL index 009f89ff..92306efe 100644 --- a/INSTALL +++ b/INSTALL @@ -20,6 +20,7 @@ i386-pc-linux-rh7.3 ion ion ion ion ion i386-pc-linux-rh8.0 ezk ezk ezk ezk - i386-pc-linux-rh9 ion ion ion ion ion i386-pc-linux-rhel3 ezk ezk ezk ezk - +i386-pc-linux-rhel4 ezk ezk ezk ezk - i386-pc-linux-suse8.2 ezk ezk ezk ezk - i386-pc-linux-suse9.1 ezk ezk ezk ezk - i386-pc-solaris2.10 ro ro ro - - @@ -50,6 +51,7 @@ mips-sgi-irix6.5 ro ro ro - -[3] mipsel-unknown-linux-rhPS2 ezk ezk ezk ezk - powerpc-apple-darwin7.6.0 ezk ezk ezk ezk - powerpc-apple-darwin7.7.0 ezk ezk ezk ezk - +powerpc-apple-darwin7.8.0 ezk ezk ezk ezk - powerpc-ibm-aix5.1.0.0 ion ion ion ion[X] ion[1,2] powerpc-ibm-aix5.2.0.0 ezk ezk ezk ezk - powerpc-ibm-aix5.3.0.0 ezk ezk ezk ezk - diff --git a/Makefile.am b/Makefile.am index 23af4a1c..f35cfea3 100644 --- a/Makefile.am +++ b/Makefile.am @@ -276,6 +276,7 @@ EXTRA_DIST = \ $(EXTRA_DIST_INCLUDE) \ \ BUGS \ + FAQ \ LSM.am-utils \ MIRRORS.txt \ MIRRORS.html \ diff --git a/doc/Makefile.am b/doc/Makefile.am index 6bc44d81..4b06bcab 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -36,7 +36,7 @@ ps: am-utils.dvi am-utils.ps am-utils-clean: clean maintainer-clean-aminfo maintainer-clean-vti # personal rule for Erez Zadok to generate and install html docs -alldocs: ps install-NEWS install-INSTALL install-ChangeLog install-AUTHORS install-tasks install-autofs install-y2k install-BUGS install-html install-ps install-MIRRORS +alldocs: ps install-NEWS install-INSTALL install-ChangeLog install-AUTHORS install-tasks install-autofs install-y2k install-ldap install-osx install-BUGS install-FAQ install-html install-ps install-MIRRORS AMU_HTML_TOP=$(HOME)/proj/www/docs/am-utils install-html: $(AMU_HTML_TOP)/am-utils-all.html @@ -78,10 +78,22 @@ install-y2k: $(AMU_HTML_TOP)/y2k.txt $(AMU_HTML_TOP)/y2k.txt: $(top_srcdir)/README.y2k install -c -m 644 $< $@ +install-ldap: $(AMU_HTML_TOP)/ldap.txt +$(AMU_HTML_TOP)/ldap.txt: $(top_srcdir)/README.ldap + install -c -m 644 $< $@ + +install-osx: $(AMU_HTML_TOP)/osx.txt +$(AMU_HTML_TOP)/osx.txt: $(top_srcdir)/README.osx + install -c -m 644 $< $@ + install-BUGS: $(AMU_HTML_TOP)/BUGS.txt $(AMU_HTML_TOP)/BUGS.txt: $(top_srcdir)/BUGS install -c -m 644 $< $@ +install-FAQ: $(AMU_HTML_TOP)/FAQ.txt +$(AMU_HTML_TOP)/FAQ.txt: $(top_srcdir)/FAQ + install -c -m 644 $< $@ + install-MIRRORS: $(AMU_HTML_TOP)/MIRRORS.txt $(AMU_HTML_TOP)/MIRRORS.html $(AMU_HTML_TOP)/MIRRORS.txt: $(top_srcdir)/MIRRORS.txt install -c -m 644 $< $@ diff --git a/tasks b/tasks index b97bf937..24b6834c 100644 --- a/tasks +++ b/tasks @@ -73,9 +73,6 @@ Please volunteer to do any of the following: - linux support for ext3 -- support executable maps: run a program/script and use its output as the - map data. - - be able to pass generic mount options to systems w/ a mount(2) that supports it (Linux). Perhaps genopt="foo,bar" syntax. @@ -87,6 +84,9 @@ Please volunteer to do any of the following: "=" sign. Note this isn't so trivial because 'value' may include "=" signs. +- NFSv4 support (such a short "tasks" entry given how much work it is :-) + + * documentation - document what can and what can't be a top-level mount type (i.e. a map-backed or map-holding type). Currently that's toplvl, auto, and @@ -104,5 +104,8 @@ Solaris: - nfsx status unknown - local filesystems (ufs, etc) status unknown +FreeBSD: +- just do it + All: - mntfs->mf_fo->opt_fs can contain garbage sometimes??