Deleted Added
full compact
FREEBSD-upgrade (155363) FREEBSD-upgrade (156288)
1Upgrade Instructions for OpenBSM
2--------------------------------
3
1Upgrade Instructions for OpenBSM
2--------------------------------
3
4Currently this is very straight forward:
4OpenBSM integrates into the FreeBSD source tree in several places:
5
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.
24- Replication of src/contrib/openbsm/bsm changes into src/sys/bsm.
25- Possible updates to src/sys/security/audit, especially relating to
26 bsm_token.c.
27- Update any library, tool, or etc BSD Makefiles to add new files,
28 defines, or other generally useful or necessary things.
29
30Normally, the CVS vendor import goes along the following lines:
31
6 cd ~/p4/projects/trustedbsd/openbsm
7 cvs -d rwatson@repoman.FreeBSD.org:/home/ncvs -q import src/contrib/openbsm \
8 TrustedBSD OPENBSM_1_0_ALPHA_1
9
10Replacing the version string as required. Use the "-n" argument to CVS to
11do a test run.
12
32 cd ~/p4/projects/trustedbsd/openbsm
33 cvs -d rwatson@repoman.FreeBSD.org:/home/ncvs -q import src/contrib/openbsm \
34 TrustedBSD OPENBSM_1_0_ALPHA_1
35
36Replacing the version string as required. Use the "-n" argument to CVS to
37do a test run.
38
13Right now, no local FreeBSD modification or configuration is required. In
14future OpenBSM versions, this is likely to change.
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.
15
43
16After importing OpenBSM, make sure to propagate any changes to files that
17appear in both contrib/openbsm/bsm and sys/bsm.
18
19$FreeBSD: head/contrib/openbsm/FREEBSD-upgrade 155363 2006-02-06 00:03:39Z rwatson $
44$FreeBSD: head/contrib/openbsm/FREEBSD-upgrade 156288 2006-03-04 16:50:04Z rwatson $