From f670e3a13401d6f690657ae4a17084074c015a13 Mon Sep 17 00:00:00 2001 From: Scott Rifenbark Date: Fri, 31 Jan 2014 16:25:55 -0600 Subject: ref-manual: Edits to ROOT_HOME Fixes [YOCTO #5762] Applied some more detail based on Laszlo's review comments. (From yocto-docs rev: eb8d11504d6c22dfd9620422df3fc31cfcebb00c) Signed-off-by: Scott Rifenbark Signed-off-by: Richard Purdie --- documentation/ref-manual/ref-variables.xml | 21 +++++++++++++++++---- 1 file changed, 17 insertions(+), 4 deletions(-) (limited to 'documentation/ref-manual') diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml index ae39bf2488..b7189e7489 100644 --- a/documentation/ref-manual/ref-variables.xml +++ b/documentation/ref-manual/ref-variables.xml @@ -5480,13 +5480,26 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" ROOT_HOME ??= "/home/root" + + This default value is likely used because some + embedded solutions prefer to have a read-only root + filesystem and prefer to keep writeable data in one + place. + + + + You can override the default by setting the variable - in any layer or in the - local.conf file using the following - form: + in any layer or in the local.conf file. + Because the default is set using a "weak" assignment + (i.e. "??="), you can use either of the following forms + to define your override: - ROOT_HOME ?= "<path>" + ROOT_HOME = "/root" + ROOT_HOME ?= "/root" + These override examples use /root, + which is probably the most commonly used override. -- cgit v1.2.3-54-g00ecf