xref: /freebsd/contrib/openbsm/INSTALL (revision f6a3b357e9be4c6423c85eff9a847163a0d307c8)
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
6support is found.  Typical builds will be performed using:
7
8    ./configure
9    make
10
11On Linux systems, OpenSSL headers may have to be installed to support
12encryption of on-the-wire audit streams using auditdistd; the following
13appears to work on Ubuntu:
14
15    sudo apt-get install libssl-dev
16
17Similarly, Mac OS X systems will require OpenSSL support:
18
19    brew install openssl
20
21Mac OS X systems will similarly require setting CFLAGS and LDFLAGS to notify
22configure of the location of the OpenSSL headers and library:
23
24    CFLAGS=-I/usr/local/opt/openssl/include			\
25    LDFLAGS=-L/usr/local/opt/openssl/lib			\
26    configure
27
28To install the library, binaries, and man pages, use:
29
30    make install
31
32The OpenBSM install will not install files in /etc; these have to be
33manually installed or merged.  Currently, the locations of these files are
34not configurable.
35
36You may wish to specify that the OpenBSM components not be installed in the
37base system, rather in a specific directory.  This may be done using the
38--prefix argument to configure.  If installing to a specific directory,
39remember to update your library path so that when running tools from that
40directory the correct libbsm is used:
41
42    ./configure --prefix=/home/rwatson/openbsm
43    make
44    make install
45    LD_LIBRARY_PATH=/home/rwatson/openbsm/libbsm ; export LD_LIBRARY_PATH
46