diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml index cab546a0ae..e8f5a2f72b 100644 --- a/documentation/ref-manual/ref-classes.xml +++ b/documentation/ref-manual/ref-classes.xml @@ -332,12 +332,42 @@ The Build History (buildhistory) class records a history of build output metadata, which can be used to detect possible regressions as well as used for analysis of the build output. - For more information on usinig Build History, see the + For more information on using Build History, see the "Maintaining Build Output Quality" section. +
+ <filename>buildstats.bbclass</filename> + + + The Build Stats (buildstats) class records + performance statistics about each task executed during the build + (e.g. elapsed time, CPU usage, and I/O usage). + + + + When you use this class, the output goes into the + BUILDSTATS_BASE + directory, which defaults to ${TMPDIR}/buildstats/. + You can analyze the elapsed time using + scripts/pybootchartgui/pybootchartgui.py, which + produces a cascading chart of the entire build process and can be + useful for highlighting bottlenecks. + + + + To enable this class, use the + USER_CLASSES + variable from your local.conf file. + The meta-yocto/conf/local.conf.sample file + in the + Source Directory + enables this class by default. + +
+
Debian Renaming - <filename>debian.bbclass</filename>