xref: /freebsd/contrib/openbsm/INSTALL (revision 5e386598a6d77973b93c073080f0cc574edda9e2)
152267f74SRobert WatsonOpenBSM Build and Installation Instructions
252267f74SRobert Watson
352267f74SRobert WatsonOpenBSM is currently built using autoconf and automake, which should allow
452267f74SRobert Watsonfor building on a range of operating systems, including FreeBSD, Mac OS X,
5c0020399SRobert Watsonand Linux.  Some components are built only if appropriate kernel audit
6b6a05070SChristian Brueffersupport is found.  Typical builds will be performed using:
752267f74SRobert Watson
852267f74SRobert Watson    ./configure
952267f74SRobert Watson    make
1052267f74SRobert Watson
11aa772005SRobert WatsonOn Linux systems, OpenSSL headers may have to be installed to support
12aa772005SRobert Watsonencryption of on-the-wire audit streams using auditdistd; the following
13aa772005SRobert Watsonappears to work on Ubuntu:
14aa772005SRobert Watson
15aa772005SRobert Watson    sudo apt-get install libssl-dev
16aa772005SRobert Watson
17*5e386598SRobert WatsonSimilarly, Mac OS X systems will require OpenSSL support:
18*5e386598SRobert Watson
19*5e386598SRobert Watson    brew install openssl
20*5e386598SRobert Watson
21*5e386598SRobert WatsonMac OS X systems will similarly require setting CFLAGS and LDFLAGS to notify
22*5e386598SRobert Watsonconfigure of the location of the OpenSSL headers and library:
23*5e386598SRobert Watson
24*5e386598SRobert Watson    CFLAGS=-I/usr/local/opt/openssl/include			\
25*5e386598SRobert Watson    LDFLAGS=-L/usr/local/opt/openssl/lib			\
26*5e386598SRobert Watson    configure
27*5e386598SRobert Watson
28c0020399SRobert WatsonTo install the library, binaries, and man pages, use:
2952267f74SRobert Watson
3052267f74SRobert Watson    make install
3152267f74SRobert Watson
32c0020399SRobert WatsonThe OpenBSM install will not install files in /etc; these have to be
33c0020399SRobert Watsonmanually installed or merged.  Currently, the locations of these files are
34c0020399SRobert Watsonnot configurable.
35c0020399SRobert Watson
3652267f74SRobert WatsonYou may wish to specify that the OpenBSM components not be installed in the
3752267f74SRobert Watsonbase system, rather in a specific directory.  This may be done using the
3852267f74SRobert Watson--prefix argument to configure.  If installing to a specific directory,
39b6a05070SChristian Bruefferremember to update your library path so that when running tools from that
4052267f74SRobert Watsondirectory the correct libbsm is used:
4152267f74SRobert Watson
4252267f74SRobert Watson    ./configure --prefix=/home/rwatson/openbsm
4352267f74SRobert Watson    make
4452267f74SRobert Watson    make install
4552267f74SRobert Watson    LD_LIBRARY_PATH=/home/rwatson/openbsm/libbsm ; export LD_LIBRARY_PATH
46