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