* Document FAM's lack of support for AFS's security model and recommend

    gamin instead.  (Closes: #343246)

diff --git a/debian/README.Debian b/debian/README.Debian
index 6456353dd6783337ab8b4458470d53ff8c6e7cf2..0c0262a5aa25fb7ec77891d7712e54f424049620 100644 (file)
--- a/debian/README.Debian
+++ b/debian/README.Debian
@@ -20,6 +20,14 @@ Introduction
   dd, create an ext2 file system in it with mkfs, and then mount it with
   mount -o loop for use as a cache partition.
 
+  FAM does not work correctly with AFS except for directories that are
+  world-readable since it does not run in the user's security context and
+  therefore doesn't have the user's AFS tokens.  If you are using FAM,
+  you'll encounter errors from file managers such as Nautilus that use it
+  if you browse restricted AFS directories.  Instead of FAM, install
+  gamin, which runs in the user's security context and works correctly
+  with AFS.
+
   For information on how to set up an OpenAFS server, read README.servers.
   You will want the openafs-fileserver package for a file server and,
   additionally, the openafs-dbserver package for a database server.
@@ -120,4 +128,4 @@ PAM Authentication
   the openafs-kpasswd package to get the administrative utilities for
   managing those Kerberos accounts.
 
- -- Russ Allbery <rra@debian.org>, Sat Dec 10 20:11:43 2005
+ -- Russ Allbery <rra@stanford.edu>, Tue Dec 20 17:24:51 2005

diff --git a/debian/changelog b/debian/changelog
index 0cc1690be6739df36946af785d1206d0603a06c9..a41bcce89c84f2933ea0c0f36353d256edadddbf 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -2,6 +2,8 @@ openafs (1.4.0-3) unstable; urgency=low
 
   * Apply patch to allow the module to build with the Ubuntu kernel.
     Thanks, Björn Torkelsson.  (Closes: #342607)
+  * Document FAM's lack of support for AFS's security model and recommend
+    gamin instead.  (Closes: #343246)
   * Add a hint to README.Debian on what to do about the cache partition if
     running ReiserFS or XFS without a spare partition.