|
Name |
|
Date |
Size |
#Lines |
LOC |
| .. | | - | - |
| cap/ | H | 25-Apr-2025 | - | 4,157 | 2,637 |
| contrib/ | H | 25-Apr-2025 | - | 3,792 | 2,544 |
| doc/ | H | 25-Apr-2025 | - | 3,350 | 3,060 |
| go/ | H | 25-Apr-2025 | - | 1,060 | 807 |
| goapps/ | H | 25-Apr-2025 | - | 1,301 | 988 |
| kdebug/ | H | 25-Apr-2025 | - | 177 | 127 |
| libcap/ | H | 25-Apr-2025 | - | 5,340 | 3,526 |
| pam_cap/ | H | 25-Apr-2025 | - | 1,143 | 777 |
| progs/ | H | 25-Apr-2025 | - | 3,034 | 2,549 |
| psx/ | H | 25-Apr-2025 | - | 1,650 | 1,017 |
| tests/ | H | 25-Apr-2025 | - | 926 | 721 |
| .gitignore | H A D | 25-Apr-2025 | 21 | 5 | 4 |
| Android.bp | H A D | 25-Apr-2025 | 3.5 KiB | 141 | 127 |
| CHANGELOG | H A D | 25-Apr-2025 | 426 | 16 | 8 |
| License | H A D | 25-Apr-2025 | 19.8 KiB | 397 | 325 |
| METADATA | H A D | 25-Apr-2025 | 571 | 20 | 18 |
| MODULE_LICENSE_BSD_LIKE | HD | 25-Apr-2025 | 0 | | |
| Make.Rules | H A D | 25-Apr-2025 | 6.4 KiB | 202 | 171 |
| Makefile | H A D | 25-Apr-2025 | 3.2 KiB | 86 | 66 |
| NOTICE | H A D | 25-Apr-2025 | 19.8 KiB | 386 | 319 |
| OWNERS | H A D | 25-Apr-2025 | 65 | 3 | 2 |
| README | H A D | 25-Apr-2025 | 1.7 KiB | 58 | 36 |
| distcheck.sh | H A D | 25-Apr-2025 | 458 | 14 | 9 |
| generate_cap_names_list.awk | H A D | 25-Apr-2025 | 95 | 2 | 1 |
| gomods.sh | H A D | 25-Apr-2025 | 256 | 12 | 8 |
| pgp.keys.asc | H A D | 25-Apr-2025 | 19.6 KiB | 350 | 331 |
| template.c | H A D | 25-Apr-2025 | 60 | 7 | 0 |
README
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