xref: /freebsd/contrib/openbsm/INSTALL (revision 39ee7a7a6bdd1557b1c3532abf60d139798ac88b)
1OpenBSM Build and Installation Instructions
2
3OpenBSM is currently built using autoconf and automake, which should allow
4for building on a range of operating systems, including FreeBSD, Mac OS X,
5and Linux.  Some components are built only if appropriate kernel audit
6suppport is found.  Typical builds will be performed using:
7
8    ./configure
9    make
10
11If doing development work on OpenBSM with gcc, the following invocation of
12configure is preferred in order to generate full compiler warnings and force
13the compile to fail if a warning is found:
14
15    CFLAGS="-Wall -Werror" ./configure
16
17On Linux systems, OpenSSL headers may have to be installed to support
18encryption of on-the-wire audit streams using auditdistd; the following
19appears to work on Ubuntu:
20
21    sudo apt-get install libssl-dev
22
23To install the library, binaries, and man pages, use:
24
25    make install
26
27The OpenBSM install will not install files in /etc; these have to be
28manually installed or merged.  Currently, the locations of these files are
29not configurable.
30
31You may wish to specify that the OpenBSM components not be installed in the
32base system, rather in a specific directory.  This may be done using the
33--prefix argument to configure.  If installing to a specific directory,
34remember to update your library path so that running tools from that
35directory the correct libbsm is used:
36
37    ./configure --prefix=/home/rwatson/openbsm
38    make
39    make install
40    LD_LIBRARY_PATH=/home/rwatson/openbsm/libbsm ; export LD_LIBRARY_PATH
41