From 6d1c241524cbee05cb74c11a37bcd8cf1a7aebb6 Mon Sep 17 00:00:00 2001
From: castaglia <castaglia>
Date: Sun, 27 Feb 2005 19:21:23 +0000
Subject: [PATCH] Fleshing out the POSIX ACL doc.

---
 README.facl | 42 +++++++++++++++++++++++++++++++-----------
 1 file changed, 31 insertions(+), 11 deletions(-)

diff --git a/README.facl b/README.facl
index e55dfbec3a..9f33c54ccb 100644
--- a/README.facl
+++ b/README.facl
@@ -2,21 +2,41 @@
 POSIX ACLs (File ACLs)
 ----------------------
 
-  EXPERIMENTAL
+As of 1.3.0rc1, ProFTPD has support for POSIX ACLs.  This is a new feature
+and should be considered experimental.
 
-  automatically check for POSIX ACL support
+For more information on what POSIX ACLs are and how they work, see
+"POSIX ACLs on Linux":
 
-  --enable-facl
-  --with-modules=mod_facl
+    http://www.suse.de/~agruen/acl/linux-acls/online/
 
-  copy_file
+POSIX ACLs are supported and implemented differently on Linux, BSD, and
+Solaris.  ProFTPD attempts to work properly with POSIX ACLs on all of
+these platforms.
 
-  mod_ls changes: '+', ACL MASK as group mode
+The configure script automatically checks to see if your system has
+support for POSIX ACLs.  However, proftpd will not make use of any
+POSIX ACL support unless specifically requested:
+
+  ./configure --enable-facl ...
+
+This configure option tells proftpd to compile and link against the proper
+libraries.  However, to make proftpd fully honor any POSIX ACLs on files,
+you will also need the mod_facl module:
+
+  ./configure --enable-facl --with-modules=mod_facl ...
+
+Note that on some systems (notably Red Hat installations), you may encounter
+the following error when compiling proftpd with ACL support:
 
   libtool: link: cannot find the library `/lib/libattr.la'
-    RH /usr/lib/libacl.la points to /lib/libattr.la, rather than
-    /usr/lib/libattr.la.  We hatesses RH.
 
-  Future Work:
-    mod_ls, '+'
-    manipulating ACLs via SITE commands?
+This is caused by a bug in the /usr/lib/libacl.la file.  This is a text
+file which mentions /lib/libattr.la, when it should use /usr/lib/libattr.la.
+You may have to manually edit the /usr/lib/libacl.la file to correct
+the problem.
+
+Future work on ProFTPD's support of POSIX ACLs will most likely include
+changing mod_ls so that it displays a '+' symbol when LISTing files,
+denoting a file marked with  POSIX ACLs, and perhaps adding support for
+SITE commands for manipulating ACLs (similar to SITE CHMOD).