diff options
Diffstat (limited to 'README')
-rw-r--r-- | README | 40 |
1 files changed, 30 insertions, 10 deletions
@@ -1,28 +1,48 @@ 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 can be found at +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/ -# INSTALLATION +# 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 - Linux-Caps % make + runs all of the tests including those that require privilege. - builds the library and the programs + $ sudo make install - Linux-Caps % 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 - installs the library libcap.XX.Y in /lib[64]/ - the binaries in /sbin/ - the <sys/capability.h> file in /usr/include - the libcap.pc file in /usr/lib[64]/pkgconfig +For some example C programs look in the progs/ directory. Specifically, +capsh, getpcaps, setcap and getcap. -* for some example programs look in progs. +Go example programs are to be found in the goapps/ directory. There +are also some more complicated integration tests in the go/ directory. Cheers |