$Id: README,v 1.4 2001/05/18 14:59:59 yann Exp $
http://www.nohup.se/software/

Acltool is a simple GTK user interface to the functions performed by
"fs setacl" and "fs listacl". It has the feature to set an acl recursively.

Usage:

When started with a pathname as argument, it loads the ACL for that directory.
If no argument is given the current working directory is used. The button
"Reread" can be used to reload the ACL, and loading an ACL from a different 
directory can be done by editing the "Folder:" entry and hitting Enter. 

Changing an entry in the ACL is done by selecting it in the list and using
the permission buttons. Since negative permissions are seldom used, they are
hidden by default, unless the currently active entry has negative permissions. 
Adding entries is done by editing the "User/Group:" entry and hitting Enter.
The entry is added with no permissions.
Removing entries is done by removing all permissions, both positive and 
negative. The entry disappears when you save the ACL.

Saving an ACL can be done with Apply or OK; OK causes ACLtool to exit after
saving the changes. If the ACL is applied recursively, please note that 
ACLtool will not examine the original ACLs of subdirectories but only set the
one you have on screen. 

ACLtool can be exited by deleting its window or using the OK or Cancel buttons.
OK will first save the ACL.


Building:

I don't know autoconf yet, so you'll probably have to edit AFS_CFLAGS and
AFS_LIBS in src/Makefile after running configure in order to link against
your AFS libraries. I'm a bit confused as to how this is arranged; it seems
the library libkafs is included with Heimdal, but our current installation
has undefined symbols. OpenAFS simply doesn't have a libkafs. The one I
found in /usr/athena works fine, both with Arla and OpenAFS.

My development system is based on Red Hat 6.2.
On Solaris systems we've tested Heimdal libraries work well, but make sure
you build them on the target systems (Solaris 2.6 and 8 were not compatible).

The calls for reading and writing ACLs are platform independent (text data),
and I learned how to do them by reading the source code for the Arla "fs"
command.

Your mileage may vary.

Note: we believe that acltool is not a good name for this utility, as it is
AFS specific, but since we have not been able to make up a better name than
"gafsacl" or "gaclafs", we decided to release it as is and hope for
suggestions.

Yann Vernier <yann@nohup.se>
Nohup AB   http://www.nohup.se
