This commit was manufactured by cvs2svn to create branch
[linux-2.6.git] / Documentation / ckrm / crbce
1 CRBCE
2 ----------
3
4 crbce is a superset of rbce. In addition to providing automatic
5 classification, the crbce module
6 - monitors per-process delay data that is collected by the delay 
7 accounting patch
8 - collects data on significant kernel events where reclassification
9 could occur e.g. fork/exec/setuid/setgid etc., and
10 - uses relayfs to supply both these datapoints to userspace
11
12 To illustrate the utility of the data gathered by crbce, we provide a
13 userspace daemon called crbcedmn that prints the header info received
14 from the records sent by the crbce module.
15
16 0. Ensure that a CKRM-enabled kernel with following options configured
17    has been compiled. At a minimum, core, rcfs, atleast one classtype,
18    delay-accounting patch and relayfs. For testing, it is recommended
19    all classtypes and resource controllers be compiled as modules.
20
21 1. Ensure that the Makefile's BUILD_CRBCE=1 and KDIR points to the
22    kernel of step 1 and call make.
23    This also builds the userspace daemon, crbcedmn.
24
25 2..9 Same as rbce installation and testing instructions, 
26      except replacing rbce.ko with crbce.ko
27
28 10. Read the pseudo daemon help file
29     # ./crbcedmn -h
30
31 11. Run the crbcedmn to display all records being processed
32     # ./crbcedmn 
33