| Andrew Morgan | 2c9c053 | 2007-07-10 20:50:21 -0700 | [diff] [blame] | 1 | This is a library for getting and setting POSIX.1e (formerly POSIX 6) |
| 2 | draft 15 capabilities. |
| 3 | |
| Andrew G. Morgan | d7dce56 | 2020-01-05 08:55:50 -0800 | [diff] [blame] | 4 | Natively supported languages are C/C++ and Go. |
| 5 | |
| Andrew Morgan | 2c9c053 | 2007-07-10 20:50:21 -0700 | [diff] [blame] | 6 | This library would not have been possible without the help of |
| 7 | |
| 8 | Aleph1, Roland Buresund and Andrew Main, Alexander Kjeldaas. |
| 9 | |
| Andrew G. Morgan | d7dce56 | 2020-01-05 08:55:50 -0800 | [diff] [blame] | 10 | More information on capabilities in the Linux kernel, links to the |
| 11 | official git repostitory for libcap, release notes and how to report |
| 12 | bugs can be found at: |
| Andrew Morgan | 2c9c053 | 2007-07-10 20:50:21 -0700 | [diff] [blame] | 13 | |
| Andrew G. Morgan | 1b5fb7e | 2008-11-10 18:00:28 -0800 | [diff] [blame] | 14 | http://sites.google.com/site/fullycapable/ |
| Andrew Morgan | 2c9c053 | 2007-07-10 20:50:21 -0700 | [diff] [blame] | 15 | |
| Andrew G. Morgan | d7dce56 | 2020-01-05 08:55:50 -0800 | [diff] [blame] | 16 | # BUILDING AND INSTALLATION |
| Andrew Morgan | 2c9c053 | 2007-07-10 20:50:21 -0700 | [diff] [blame] | 17 | |
| Andrew G. Morgan | d7dce56 | 2020-01-05 08:55:50 -0800 | [diff] [blame] | 18 | $ make |
| Andrew Morgan | 2c9c053 | 2007-07-10 20:50:21 -0700 | [diff] [blame] | 19 | |
| Andrew G. Morgan | d7dce56 | 2020-01-05 08:55:50 -0800 | [diff] [blame] | 20 | builds the library and the programs that are expected |
| 21 | to work on your system. For example, if you have |
| 22 | Linux-PAM installed, pam_cap is built. A golang |
| 23 | installation is required to build the Go packages. |
| Andrew Morgan | 2c9c053 | 2007-07-10 20:50:21 -0700 | [diff] [blame] | 24 | |
| Andrew G. Morgan | d7dce56 | 2020-01-05 08:55:50 -0800 | [diff] [blame] | 25 | $ make test |
| Andrew Morgan | 2c9c053 | 2007-07-10 20:50:21 -0700 | [diff] [blame] | 26 | |
| Andrew G. Morgan | d7dce56 | 2020-01-05 08:55:50 -0800 | [diff] [blame] | 27 | runs all of the tests not requiring privilege |
| Andrew Morgan | 2c9c053 | 2007-07-10 20:50:21 -0700 | [diff] [blame] | 28 | |
| Andrew G. Morgan | d7dce56 | 2020-01-05 08:55:50 -0800 | [diff] [blame] | 29 | $ make sudotest |
| 30 | |
| 31 | runs all of the tests including those that require privilege. |
| 32 | |
| 33 | $ sudo make install |
| 34 | |
| Andrew G. Morgan | 19eebc5 | 2020-07-05 14:07:52 -0700 | [diff] [blame] | 35 | default installs the library libcap.XX.Y in /lib[64]/ |
| Andrew G. Morgan | d7dce56 | 2020-01-05 08:55:50 -0800 | [diff] [blame] | 36 | the binaries in /sbin/ |
| 37 | the header files in /usr/include |
| 38 | the {libcap,libpsx}.pc files in /usr/lib[64]/pkgconfig |
| Andrew G. Morgan | 19eebc5 | 2020-07-05 14:07:52 -0700 | [diff] [blame] | 39 | the Go packages (if built) under /usr/share/gocode/src |
| Andrew G. Morgan | d7dce56 | 2020-01-05 08:55:50 -0800 | [diff] [blame] | 40 | |
| Andrew G. Morgan | 19eebc5 | 2020-07-05 14:07:52 -0700 | [diff] [blame] | 41 | For some example C programs look in the progs/ directory. Specifically, |
| 42 | capsh, getpcaps, setcap and getcap. |
| 43 | |
| 44 | Go example programs are to be found in the goapps/ directory. There |
| 45 | are also some more complicated integration tests in the go/ directory. |
| Andrew Morgan | 2c9c053 | 2007-07-10 20:50:21 -0700 | [diff] [blame] | 46 | |
| 47 | Cheers |
| 48 | |
| Andrew Morgan | 5216fff | 2007-07-10 22:38:22 -0700 | [diff] [blame] | 49 | Andrew G. Morgan <morgan@kernel.org> |