Travis: rework build matrix
[pylibacl.git] / README.rst
1 pylibacl
2 ========
3
4 This is a Python 2.7+ extension module allows you to manipulate the
5 POSIX.1e Access Control Lists present in some OS/file-systems
6 combinations.
7
8 Downloads: go to http://pylibacl.k1024.org/downloads. Latest
9 version is 0.5.3. The source repository is either
10 at `<git://git.k1024.org/pylibacl.git>`_ or
11 at https://github.com/iustin/pylibacl.
12
13 For any issues, please file bugs at
14 https://github.com/iustin/pylibacl/issues.
15
16 Requirements
17 ------------
18
19 pylibacl has been written and tested on Linux, kernel v2.4 or newer,
20 with XFS filesystems; ext2/ext3 should also work. Since release 0.4.0,
21 FreeBSD 7 also has quite good support. If any other platform
22 implements the POSIX.1e draft, pylibacl can be used. I heard that
23 Solaris does, but I can't test it.
24
25 - Python 2.7 or newer
26 - operating system:
27     - Linux, kernel v2.4 or newer, and the libacl library and
28       development packages (all modern distributions should have this,
29       under various names); also the file-systems you use must have
30       ACLs turned on, either as a compile or mount option
31     - FreeBSD 7.0 or newer
32
33 License
34 -------
35
36 pylibacl is Copyright (C) 2002-2009, 2012, 2014, 2015 Iustin Pop.
37
38 pylibacl is free software; you can redistribute it and/or modify it under the
39 terms of the GNU Lesser General Public License as published by the Free
40 Software Foundation; either version 2.1 of the License, or (at your option) any
41 later version. See the COPYING file for the full license terms.