summaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorAndrew G. Morgan <morgan@kernel.org>2020-01-05 08:55:50 -0800
committerAndrew G. Morgan <morgan@kernel.org>2020-01-05 08:59:13 -0800
commitd7dce56df2ee92d1338599fdf25c1a85d7c6a731 (patch)
tree2219c9e6c304499498e229fd081f8479c3227a6e /README
parente665409008fe3da115d084740bf4e5c92e062b8c (diff)
downloadlibcap2-d7dce56df2ee92d1338599fdf25c1a85d7c6a731.tar.gz
Updated project details in README.
Signed-off-by: Andrew G. Morgan <morgan@kernel.org>
Diffstat (limited to 'README')
-rw-r--r--README37
1 files changed, 27 insertions, 10 deletions
diff --git a/README b/README
index 7356eac..40c2794 100644
--- a/README
+++ b/README
@@ -1,28 +1,45 @@
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
- Linux-Caps % make
+ $ make sudotest
- builds the library and the programs
+ runs all of the tests including those that require privilege.
- Linux-Caps % make install
+ $ sudo make install
- 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
+ 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
-* for some example programs look in progs.
+For some example programs look in the progs/ directory. Specifically,
+capsh, getpcaps, setcap and getcap. Go example programs are to be
+found in the go/ directory.
Cheers