xref: /aosp_15_r20/external/libcap/README (revision 2810ac1b38eead2603277920c78344c84ddf3aff)
1This is a library for getting and setting POSIX.1e (formerly POSIX 6)
2draft 15 capabilities.
3
4Natively supported languages are C/C++ and Go.
5
6This library would not have been possible without the help of
7
8    Aleph1, Roland Buresund and Andrew Main, Alexander Kjeldaas.
9
10More information on capabilities in the Linux kernel, links to the
11official git repository for libcap, release notes and how to report
12bugs can be found at:
13
14    http://sites.google.com/site/fullycapable/
15
16The 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
45For some example C programs look in the progs/ directory.
46Specifically, capsh, getpcaps, setcap and getcap. There are some C
47tests in the tests/ directory.
48
49Go example programs are to be found in the goapps/ directory. There
50are also some more complicated integration tests in the go/ directory.
51
52There are also some oddball experimental things in the contrib/
53directory, but they are mostly curiosities.
54
55Cheers
56
57Andrew G. Morgan <[email protected]>
58