1184902SrwatsonOpenBSM Build and Installation Instructions
2184902Srwatson
3184902SrwatsonOpenBSM is currently built using autoconf and automake, which should allow
4184902Srwatsonfor building on a range of operating systems, including FreeBSD, Mac OS X,
5191273Srwatsonand Linux.  Some components are built only if appropriate kernel audit
6292432Sbrueffersupport is found.  Typical builds will be performed using:
7184902Srwatson
8184902Srwatson    ./configure
9184902Srwatson    make
10184902Srwatson
11187214SrwatsonIf doing development work on OpenBSM with gcc, the following invocation of
12244265Srwatsonconfigure is preferred in order to generate full compiler warnings and force
13244265Srwatsonthe compile to fail if a warning is found:
14187214Srwatson
15187214Srwatson    CFLAGS="-Wall -Werror" ./configure
16187214Srwatson
17243750SrwatsonOn Linux systems, OpenSSL headers may have to be installed to support
18243750Srwatsonencryption of on-the-wire audit streams using auditdistd; the following
19243750Srwatsonappears to work on Ubuntu:
20243750Srwatson
21243750Srwatson    sudo apt-get install libssl-dev
22243750Srwatson
23191273SrwatsonTo install the library, binaries, and man pages, use:
24184902Srwatson
25184902Srwatson    make install
26184902Srwatson
27191273SrwatsonThe OpenBSM install will not install files in /etc; these have to be
28191273Srwatsonmanually installed or merged.  Currently, the locations of these files are
29191273Srwatsonnot configurable.
30191273Srwatson
31184902SrwatsonYou may wish to specify that the OpenBSM components not be installed in the
32184902Srwatsonbase system, rather in a specific directory.  This may be done using the
33184902Srwatson--prefix argument to configure.  If installing to a specific directory,
34292432Sbruefferremember to update your library path so that when running tools from that
35184902Srwatsondirectory the correct libbsm is used:
36184902Srwatson
37184902Srwatson    ./configure --prefix=/home/rwatson/openbsm
38184902Srwatson    make
39184902Srwatson    make install
40184902Srwatson    LD_LIBRARY_PATH=/home/rwatson/openbsm/libbsm ; export LD_LIBRARY_PATH
41