[U-Boot] [PATCH 1/2] README.SPL: Add a small Debugging section

Signed-off-by: Tom Rini trini@ti.com --- doc/README.SPL | 7 +++++++ 1 file changed, 7 insertions(+)
diff --git a/doc/README.SPL b/doc/README.SPL index e4a5ac3..bd375a0 100644 --- a/doc/README.SPL +++ b/doc/README.SPL @@ -78,3 +78,10 @@ an SPL CPU in boards.cfg as follows:
This this case CPU will be set to "normal_cpu" during the main u-boot build and "spl_cpu" during the SPL build. + + +Debugging +--------- + +When building SPL with DEBUG set you may also need to set CONFIG_PANIC_HANG +as in most cases do_reset is not defined within SPL.

The instructions are generic, so move to the generic doc.
Signed-off-by: Tom Rini trini@ti.com --- doc/README.SPL | 23 +++++++++++++++++++++++ doc/SPL/README.omap3 | 22 ---------------------- 2 files changed, 23 insertions(+), 22 deletions(-)
diff --git a/doc/README.SPL b/doc/README.SPL index bd375a0..5368586 100644 --- a/doc/README.SPL +++ b/doc/README.SPL @@ -85,3 +85,26 @@ Debugging
When building SPL with DEBUG set you may also need to set CONFIG_PANIC_HANG as in most cases do_reset is not defined within SPL. + + +Estimating stack usage +---------------------- + +With gcc 4.6 (and later) and the use of GNU cflow it is possible to estimate +stack usage at various points in run sequence of SPL. The -fstack-usage option +to gcc will produce '.su' files (such as arch/arm/cpu/armv7/syslib.su) that +will give stack usage information and cflow can construct program flow. + +Must have gcc 4.6 or later, which supports -fstack-usage + +1) Build normally +2) Perform the following shell command to generate a list of C files used in +SPL: +$ find spl -name '*.su' | sed -e 's:^spl/::' -e 's:[.]su$:.c:' > used-spl.list +3) Execute cflow: +$ cflow --main=board_init_r `cat used-spl.list` 2>&1 | $PAGER + +cflow will spit out a number of warnings as it does not parse +the config files and picks functions based on #ifdef. Parsing the '.i' +files instead introduces another set of headaches. These warnings are +not usually important to understanding the flow, however. diff --git a/doc/SPL/README.omap3 b/doc/SPL/README.omap3 index a543e65..c77ca43 100644 --- a/doc/SPL/README.omap3 +++ b/doc/SPL/README.omap3 @@ -50,25 +50,3 @@ For the areas that reside within DDR1 they must not be used prior to s_init() completing. Note that CONFIG_SYS_TEXT_BASE must be clear of the areas that SPL uses while running. This is why we have two versions of the memory map that only vary in where the BSS and malloc pool reside. - -Estimating stack usage ----------------------- - -With gcc 4.6 (and later) and the use of GNU cflow it is possible to estimate -stack usage at various points in run sequence of SPL. The -fstack-usage option -to gcc will produce '.su' files (such as arch/arm/cpu/armv7/syslib.su) that -will give stack usage information and cflow can construct program flow. - -Must have gcc 4.6 or later, which supports -fstack-usage - -1) Build normally -2) Perform the following shell command to generate a list of C files used in -SPL: -$ find spl -name '*.su' | sed -e 's:^spl/::' -e 's:[.]su$:.c:' > used-spl.list -3) Execute cflow: -$ cflow --main=board_init_r `cat used-spl.list` 2>&1 | $PAGER - -cflow will spit out a number of warnings as it does not parse -the config files and picks functions based on #ifdef. Parsing the '.i' -files instead introduces another set of headaches. These warnings are -not usually important to understanding the flow, however.

Dear Tom Rini,
In message 1345051401-6104-2-git-send-email-trini@ti.com you wrote:
The instructions are generic, so move to the generic doc.
Signed-off-by: Tom Rini trini@ti.com
doc/README.SPL | 23 +++++++++++++++++++++++ doc/SPL/README.omap3 | 22 ---------------------- 2 files changed, 23 insertions(+), 22 deletions(-)
Applied, thanks.
Best regards,
Wolfgang Denk

Dear Tom Rini,
In message 1345051401-6104-1-git-send-email-trini@ti.com you wrote:
Signed-off-by: Tom Rini trini@ti.com
doc/README.SPL | 7 +++++++ 1 file changed, 7 insertions(+)
Applied, thanks.
Best regards,
Wolfgang Denk
participants (2)
-
Tom Rini
-
Wolfgang Denk