Name Date Size #Lines LOC

..--

cap/H25-Apr-2025-4,1572,637

contrib/H25-Apr-2025-3,7922,544

doc/H25-Apr-2025-3,3503,060

go/H25-Apr-2025-1,060807

goapps/H25-Apr-2025-1,301988

kdebug/H25-Apr-2025-177127

libcap/H25-Apr-2025-5,3403,526

pam_cap/H25-Apr-2025-1,143777

progs/H25-Apr-2025-3,0342,549

psx/H25-Apr-2025-1,6501,017

tests/H25-Apr-2025-926721

.gitignoreH A D25-Apr-202521 54

Android.bpH A D25-Apr-20253.5 KiB141127

CHANGELOGH A D25-Apr-2025426 168

LicenseH A D25-Apr-202519.8 KiB397325

METADATAH A D25-Apr-2025571 2018

MODULE_LICENSE_BSD_LIKEHD25-Apr-20250

Make.RulesH A D25-Apr-20256.4 KiB202171

MakefileH A D25-Apr-20253.2 KiB8666

NOTICEH A D25-Apr-202519.8 KiB386319

OWNERSH A D25-Apr-202565 32

READMEH A D25-Apr-20251.7 KiB5836

distcheck.shH A D25-Apr-2025458 149

generate_cap_names_list.awkH A D25-Apr-202595 21

gomods.shH A D25-Apr-2025256 128

pgp.keys.ascH A D25-Apr-202519.6 KiB350331

template.cH A D25-Apr-202560 70

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