aosp12/external/libcap
hcl 7be3fd486c init from android-12.1.0_r8 2023-01-09 17:11:35 +08:00
..
cap init from android-12.1.0_r8 2023-01-09 17:11:35 +08:00
contrib init from android-12.1.0_r8 2023-01-09 17:11:35 +08:00
doc init from android-12.1.0_r8 2023-01-09 17:11:35 +08:00
go init from android-12.1.0_r8 2023-01-09 17:11:35 +08:00
goapps init from android-12.1.0_r8 2023-01-09 17:11:35 +08:00
kdebug init from android-12.1.0_r8 2023-01-09 17:11:35 +08:00
libcap init from android-12.1.0_r8 2023-01-09 17:11:35 +08:00
pam_cap init from android-12.1.0_r8 2023-01-09 17:11:35 +08:00
progs init from android-12.1.0_r8 2023-01-09 17:11:35 +08:00
psx init from android-12.1.0_r8 2023-01-09 17:11:35 +08:00
tests init from android-12.1.0_r8 2023-01-09 17:11:35 +08:00
.gitignore init from android-12.1.0_r8 2023-01-09 17:11:35 +08:00
Android.bp init from android-12.1.0_r8 2023-01-09 17:11:35 +08:00
CHANGELOG init from android-12.1.0_r8 2023-01-09 17:11:35 +08:00
License init from android-12.1.0_r8 2023-01-09 17:11:35 +08:00
METADATA init from android-12.1.0_r8 2023-01-09 17:11:35 +08:00
MODULE_LICENSE_BSD_LIKE init from android-12.1.0_r8 2023-01-09 17:11:35 +08:00
Make.Rules init from android-12.1.0_r8 2023-01-09 17:11:35 +08:00
Makefile init from android-12.1.0_r8 2023-01-09 17:11:35 +08:00
NOTICE init from android-12.1.0_r8 2023-01-09 17:11:35 +08:00
OWNERS init from android-12.1.0_r8 2023-01-09 17:11:35 +08:00
README init from android-12.1.0_r8 2023-01-09 17:11:35 +08:00
distcheck.sh init from android-12.1.0_r8 2023-01-09 17:11:35 +08:00
generate_cap_names_list.awk init from android-12.1.0_r8 2023-01-09 17:11:35 +08:00
pgp.keys.asc init from android-12.1.0_r8 2023-01-09 17:11:35 +08:00
template.c init from android-12.1.0_r8 2023-01-09 17:11:35 +08:00

README

This is a library for getting and setting POSIX.1e (formerly POSIX 6)
draft 15 capabilities.

Natively supported languages are C/C++ and Go.

This library would not have been possible without the help of 

	Aleph1, Roland Buresund and Andrew Main, Alexander Kjeldaas.

More information on capabilities in the Linux kernel, links to the
official git repostitory for libcap, release notes and how to report
bugs can be found at:

	http://sites.google.com/site/fullycapable/

# BUILDING AND INSTALLATION

	$ make

	       builds the library and the programs that are expected
	       to work on your system. For example, if you have
	       Linux-PAM installed, pam_cap is built. A golang
	       installation is required to build the Go packages.

        $ make test

	       runs all of the tests not requiring privilege

	$ make sudotest

	       runs all of the tests including those that require privilege.

	$ sudo make install

	       default installs the library libcap.XX.Y in /lib[64]/
	       the binaries in /sbin/
	       the header files in /usr/include
	       the {libcap,libpsx}.pc files in /usr/lib[64]/pkgconfig
	       the Go packages (if built) under /usr/share/gocode/src

For some example C programs look in the progs/ directory. Specifically,
capsh, getpcaps, setcap and getcap.

Go example programs are to be found in the goapps/ directory. There
are also some more complicated integration tests in the go/ directory.

Cheers

Andrew G. Morgan <morgan@kernel.org>