diff --git a/documentation/Makefile b/documentation/Makefile
index 0218211313..6cac5caeaa 100644
--- a/documentation/Makefile
+++ b/documentation/Makefile
@@ -176,7 +176,7 @@ TARFILES = mega-manual.html mega-style.css figures/yocto-environment.png figures
else
TARFILES = mega-manual.html mega-style.css figures/yocto-environment.png figures/building-an-image.png \
figures/using-a-pre-built-image.png \
- figures/poky-title.png \
+ figures/poky-title.png figures/buildhistory.png figures/buildhistory-web.png \
figures/adt-title.png figures/bsp-title.png \
figures/kernel-title.png figures/kernel-architecture-overview.png \
figures/app-dev-flow.png figures/bsp-dev-flow.png figures/dev-title.png \
@@ -199,7 +199,8 @@ XSLTOPTS = --stringparam html.stylesheet ref-style.css \
--stringparam section.label.includes.component.label 1 \
--xinclude
ALLPREQ = html pdf tarball
-TARFILES = poky-ref-manual.html ref-style.css figures/poky-title.png
+TARFILES = poky-ref-manual.html ref-style.css figures/poky-title.png \
+ figures/buildhistory.png figures/buildhistory-web.png
MANUALS = $(DOC)/$(DOC).html $(DOC)/$(DOC).pdf
FIGURES = figures
STYLESHEET = $(DOC)/*.css
diff --git a/documentation/mega-manual/figures/buildhistory-web.png b/documentation/mega-manual/figures/buildhistory-web.png
new file mode 100644
index 0000000000..f6db86c977
Binary files /dev/null and b/documentation/mega-manual/figures/buildhistory-web.png differ
diff --git a/documentation/mega-manual/figures/buildhistory.png b/documentation/mega-manual/figures/buildhistory.png
new file mode 100644
index 0000000000..614b8ee2e4
Binary files /dev/null and b/documentation/mega-manual/figures/buildhistory.png differ
diff --git a/documentation/poky-ref-manual/figures/buildhistory-web.png b/documentation/poky-ref-manual/figures/buildhistory-web.png
new file mode 100644
index 0000000000..f6db86c977
Binary files /dev/null and b/documentation/poky-ref-manual/figures/buildhistory-web.png differ
diff --git a/documentation/poky-ref-manual/figures/buildhistory.png b/documentation/poky-ref-manual/figures/buildhistory.png
new file mode 100644
index 0000000000..614b8ee2e4
Binary files /dev/null and b/documentation/poky-ref-manual/figures/buildhistory.png differ
diff --git a/documentation/poky-ref-manual/ref-variables.xml b/documentation/poky-ref-manual/ref-variables.xml
index ac068228cf..282d9f3090 100644
--- a/documentation/poky-ref-manual/ref-variables.xml
+++ b/documentation/poky-ref-manual/ref-variables.xml
@@ -120,6 +120,158 @@
+ BB_DISKMON_DIRS
+
+
+ Monitors disk space and available inodes during the build
+ and allows you to control the build based on these
+ parameters.
+
+
+
+ Disk space monitoring is disabled by default.
+ To enable monitoring, add the BB_DISKMON_DIRS
+ variable to your conf/local.conf file found in the
+ Build Directory.
+ Use the following form:
+
+ BB_DISKMON_DIRS = "<action>,<dir>,<threshold> [...]"
+
+ where:
+
+ <action> is:
+ ABORT: Immediately abort the build when
+ a threshold is broken.
+ STOPTASKS: Stop the build after the currently
+ executing tasks have finished when
+ a threshold is broken.
+ WARN: Issue a warning but continue the
+ build when a threshold is broken.
+ Subsequent warnings are issued as
+ defined by the
+ BB_DISKMON_WARNINTERVAL variable,
+ which must be defined in the
+ conf/local.conf file.
+
+ <dir> is:
+ Any directory you choose. You can specify one or
+ more directories to monitor by separating the
+ groupings with a space. If two directories are
+ on the same device, only the first directory
+ is monitored.
+
+ <threshold> is:
+ Either the minimum available disk space,
+ the minimum number of free inodes, or
+ both. You must specify at least one. To
+ omit one or the other, simply omit the value.
+ Specify the threshold using G, M, K for Gbytes,
+ Mbytes, and Kbytes, respectively. If you do
+ not specify G, M, or K, Kbytes is assumed by
+ default. Do not use GB, MB, or KB.
+
+
+
+
+ Here are some examples:
+
+ BB_DISKMON_DIRS = "ABORT,${TMPDIR},1G,100K WARN,${SSTATE_DIR},1G,100K"
+ BB_DISKMON_DIRS = "STOPTASKS,${TMPDIR},1G"
+ BB_DISKMON_DIRS = "ABORT,${TMPDIR},,100K"
+
+ The first example works only if you also provide
+ the BB_DISKMON_WARNINTERVAL variable
+ in the conf/local.conf.
+ This example causes the build system to immediately
+ abort when either the disk space in ${TMPDIR} drops
+ below 1 Gbyte or the available free inodes drops below
+ 100 Kbytes.
+ Because two directories are provided with the variable, the
+ build system also issue a
+ warning when the disk space in the
+ ${SSTATE_DIR} directory drops
+ below 1 Gbyte or the number of free inodes drops
+ below 100 Kbytes.
+ Subsequent warnings are issued during intervals as
+ defined by the BB_DISKMON_WARNINTERVAL
+ variable.
+
+
+
+ The second example stops the build after all currently
+ executing tasks complete when the minimum disk space
+ in the ${TMPDIR} directory drops
+ below 1 Gbyte.
+ No disk monitoring occurs for the free inodes in this case.
+
+
+
+ The final example immediately aborts the build when the
+ number of free inodes in the ${TMPDIR} directory
+ drops below 100 Kbytes.
+ No disk space monitoring for the directory itself occurs
+ in this case.
+
+
+
+
+ BB_DISKMON_WARNINTERVAL
+
+
+ Defines the disk space and free inode warning intervals.
+ To set these intervals, define the variable in your
+ conf/local.conf file in the
+ Build Directory.
+
+
+
+ If you are going to use the
+ BB_DISKMON_WARNINTERVAL variable, you must
+ also use the
+ BB_DISKMON_DIRS variable
+ and define its action as "WARN".
+ During the build, subsequent warnings are issued each time
+ disk space or number of free inodes further reduces by
+ the respective interval.
+
+
+
+ Use the following form:
+
+ BB_DISKMON_WARNINTERVAL = "<disk_space_interval>,<disk_inode_interval>"
+
+ where:
+
+ <disk_space_interval> is:
+ An interval of memory expressed in either
+ G, M, or K for Gbytes, Mbytes, or Kbytes,
+ respectively. You cannot use GB, MB, or KB.
+
+ <disk_inode_interval> is:
+ An interval of free inodes expressed in either
+ G, M, or K for Gbytes, Mbytes, or Kbytes,
+ respectively. You cannot use GB, MB, or KB.
+
+
+
+
+ Here is an example:
+
+ BB_DISKMON_DIRS = "WARN,${SSTATE_DIR},1G,100K"
+ BB_DISKMON_WARNINTERVAL = "50M,5K"
+
+ These variables cause the OpenEmbedded build system to
+ issue subsequent warnings each time the available
+ disk space further reduces by 50 Mbytes or the number
+ of free inodes further reduces by 5 Kbytes in the
+ ${SSTATE_DIR} directory.
+ Subsequent warnings based on the interval occur each time
+ a respective interval is reached beyond the intial warning
+ (i.e. 1 Gbytes and 100 Kbytes).
+
+
+
+
BBCLASSEXTEND