1Upgrade Instructions for OpenBSM
2--------------------------------
3
4OpenBSM integrates into the FreeBSD source tree in several places:
5
6src/contrib/openbsm The OpenBSM distribution itself
7src/sys/bsm Modified versions of some bsm/ include files
8src/sys/security/audit Kernel audit framework, some OpenBSM-based files
9src/usr.sbin/*audit* Makefiles for various OpenBSM tools
10src/etc/Makefile Installation of /etc OpenBSM files
11src/lib/libbsm/* Build for OpenBSM library
12
13OpenBSM is normally built using an integrated autoconf/automake build
14system. For the purposes of tight integration with FreeBSD, we use an
15adapted BSD make (bmake) build system loosely based on the autmake
16setup. We also rely on a static config.h generated when OpenBSM is
17imported, rather than re-configuring every build. This leads to a
18more reproduceable build environment, and avoids dependence on things
19not in the base tree (i.e., autoconf, automake, GNU make, etc). An
20upgrade of OpenBSM generally involves the following steps:
21
22- Vendor import of OpenBSM into src/contrib.
23- Run configure, commit src/contrib/openbsm/config/config.h.
--- 12 unchanged lines hidden (view full) ---
36Replacing the version string as required. Use the "-n" argument to CVS to
37do a test run.
38
39Propagation of changes to src/sys/{bsm,security/audit} is something that
40requires careful coordination and attention to detail. These files are
41not on CVS vendor branches, but do have the same local vs. vendor merge
42issues.
43
44$FreeBSD: head/contrib/openbsm/FREEBSD-upgrade 156288 2006-03-04 16:50:04Z rwatson $
2--------------------------------
3
4OpenBSM integrates into the FreeBSD source tree in several places:
5
6src/contrib/openbsm The OpenBSM distribution itself
7src/sys/bsm Modified versions of some bsm/ include files
8src/sys/security/audit Kernel audit framework, some OpenBSM-based files
9src/usr.sbin/*audit* Makefiles for various OpenBSM tools
10src/etc/Makefile Installation of /etc OpenBSM files
11src/lib/libbsm/* Build for OpenBSM library
12
13OpenBSM is normally built using an integrated autoconf/automake build
14system. For the purposes of tight integration with FreeBSD, we use an
15adapted BSD make (bmake) build system loosely based on the autmake
16setup. We also rely on a static config.h generated when OpenBSM is
17imported, rather than re-configuring every build. This leads to a
18more reproduceable build environment, and avoids dependence on things
19not in the base tree (i.e., autoconf, automake, GNU make, etc). An
20upgrade of OpenBSM generally involves the following steps:
21
22- Vendor import of OpenBSM into src/contrib.
23- Run configure, commit src/contrib/openbsm/config/config.h.
--- 12 unchanged lines hidden (view full) ---
36Replacing the version string as required. Use the "-n" argument to CVS to
37do a test run.
38
39Propagation of changes to src/sys/{bsm,security/audit} is something that
40requires careful coordination and attention to detail. These files are
41not on CVS vendor branches, but do have the same local vs. vendor merge
42issues.
43
44$FreeBSD: head/contrib/openbsm/FREEBSD-upgrade 156288 2006-03-04 16:50:04Z rwatson $