doc/README

   1 1. What is it?
   2
   3 A utility to apply default POSIX ACLs to files and directories.
   4
   5 The way some common utilities handle POSIX ACLs is busted. For more
   6 info, see [1].
   7
   8
   9 2. Requirements
  10
  11 Right now, this will probably only work on Linux because I'm
  12 lazy. You'll need the sys/acl.h and acl/libacl.h headers from [2], at
  13 least until I decide to replace acl_get_perm with something portable
  14 (or just steal it).
  15
  16
  17 3. Installation
  18
  19 It's using GNU Autotools, so run `./configure && make` and maybe `make
  20 install` if you think it's going to wind up in the right
  21 place. Otherwise you can just take the binary out of the 'src'
  22 directory and put it somewhere in your $PATH.
  23
  24
  25 4. Usage
  26
  27 Basic usage:
  28
  29   $ apply-default-acl /path/to/whatever
  30
  31 Work recursively (from the top down):
  32
  33   $ apply-default-acl --recursive /path/to/whatever
  34   $ apply-default-acl -r /path/to/whatever
  35
  36 5. How to report bugs
  37
  38 Email them to me at michael@orlitzky.com.
  39
  40
  41
  42 [1] http://michael.orlitzky.com/articles/problems_with_posix_acls_and_common_utilities.php
  43
  44 [2] http://savannah.nongnu.org/projects/acl
  45