* tasks: updates. Executable maps is supported. NFSv4 and
authorErez Zadok <ezk@cs.sunysb.edu>
Wed, 16 Mar 2005 03:52:56 +0000 (03:52 +0000)
committerErez Zadok <ezk@cs.sunysb.edu>
Wed, 16 Mar 2005 03:52:56 +0000 (03:52 +0000)
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.

ChangeLog
FAQ [new file with mode: 0644]
INSTALL
Makefile.am
doc/Makefile.am
tasks

index 56edc4f584f08e3a0c14455e9dabbc79ddfeb130..9f090bea3c5aa70cbf1ed64c1c5bb32054fcc0c8 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,14 @@
+2005-03-15  Erez Zadok  <ezk@cs.sunysb.edu>
+
+       * 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  <ezk@cs.sunysb.edu>
 
        * scripts/amd2ldif.in: patch to add the amdMapName attribute to
diff --git a/FAQ b/FAQ
new file mode 100644 (file)
index 0000000..18e73a3
--- /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.
+
+<FAQ>
+
+*** 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.
+
+</FAQ>
diff --git a/INSTALL b/INSTALL
index 009f89ffd600db43794483cdc6c0c15947f8706c..92306efeaf6b86db18d1b4c7836aaf2838a4c179 100644 (file)
--- 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     -
index 23af4a1cd88d98bcc441d49429fa05abe9b31173..f35cfea31a1df2f5618790cfe949a752012ae61c 100644 (file)
@@ -276,6 +276,7 @@ EXTRA_DIST =                        \
        $(EXTRA_DIST_INCLUDE)   \
        \
        BUGS                    \
+       FAQ                     \
        LSM.am-utils            \
        MIRRORS.txt             \
        MIRRORS.html            \
index 6bc44d81c5329d81a09580cc672a3cd862067cc0..4b06bcab4aa61db7a609959e8d482d25edb26bee 100644 (file)
@@ -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 b97bf937cb800b4dceea480499477e8c76b9dbe7..24b6834cba6a73bacc06f1f4fde4be5a7f46f0b3 100644 (file)
--- 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??