xref: /freebsd-10.1-release/contrib/openbsm/INSTALL

OpenBSM Build and Installation Instructions

OpenBSM is currently built using autoconf and automake, which should allow
for building on a range of operating systems, including FreeBSD, Mac OS X,
and Linux.  Some components are built only if appropriate kernel audit
suppport is found.  Typical builds will be performed using:

    ./configure
    make

If doing development work on OpenBSM with gcc, the following invocation of
configure is preferred in order to generate full compiler warnings and force
the compile to fail if a warning is found:

    CFLAGS="-Wall -Werror" ./configure

On Linux systems, OpenSSL headers may have to be installed to support
encryption of on-the-wire audit streams using auditdistd; the following
appears to work on Ubuntu:

    sudo apt-get install libssl-dev

To install the library, binaries, and man pages, use:

    make install

The OpenBSM install will not install files in /etc; these have to be
manually installed or merged.  Currently, the locations of these files are
not configurable.

You may wish to specify that the OpenBSM components not be installed in the
base system, rather in a specific directory.  This may be done using the
--prefix argument to configure.  If installing to a specific directory,
remember to update your library path so that running tools from that
directory the correct libbsm is used:

    ./configure --prefix=/home/rwatson/openbsm
    make
    make install
    LD_LIBRARY_PATH=/home/rwatson/openbsm/libbsm ; export LD_LIBRARY_PATH