summaryrefslogtreecommitdiff
path: root/README
blob: 37b970952e0d2f2d40dbfe50cfcc5ad08b18e492 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
libseccomp: An Enhanced Seccomp (mode 2) Helper Library
===============================================================================
http://libseccomp.sf.net

The libseccomp library provides and easy to use, platform independent,
interface to the Linux Kernel's syscall filtering mechanism: seccomp.  The
libseccomp API is designed to abstract away the underlying BPF based syscall
filter language and present a more conventional function-call based filtering
interface that should be familiar to, and easily adopted by application
developers.

* Documentation

The "doc/" directory contains all of the documentation aside from the README
file (this file) and the LICENSE file which can be found in the top level
directory.

* Building and Installing the Library

In order to build the library you should follow the familiar three step
process used by most applications:

	# ./configure
	# make [V=0|1]
	# make install

As usual, running "./configure -h" will display a list of build-time
configuration options.

* Testing the Library

There are a number of tests located in the "tests/" directory and a script
which can be used to help automate their execution, "regression".  If you want
to run all of the tests you can simply run the script:

	# ./configure
	# make
	# cd tests
	# ./regression

However, the script takes a number of options to customize its execution; the
options can be displayed by running "./regression -h".

* Other Useful Tools

The "tools/" directory includes a number of tools which may be helpful in the
development of the library, or applications using the library, but for various
reasons are not installed by default.