[Buildroot] [PATCH v8 14/14] docs/manual: document how to debug shell script
Samuel Martin
s.martin49 at gmail.com
Sun Apr 17 21:38:31 UTC 2016
The method describes here is only true for scripts using the shell
modules from support/scripts/shell/*.
Signed-off-by: Samuel Martin <s.martin49 at gmail.com>
---
changes v7->v8:
- put instrumentation in a subsection (Arnout)
- minor rewording
changes v6->v7:
- new patch
---
docs/manual/debugging-buildroot.txt | 17 +++++++++++++++++
1 file changed, 17 insertions(+)
diff --git a/docs/manual/debugging-buildroot.txt b/docs/manual/debugging-buildroot.txt
index f575fc4..b809c2d 100644
--- a/docs/manual/debugging-buildroot.txt
+++ b/docs/manual/debugging-buildroot.txt
@@ -5,6 +5,8 @@
== Debugging Buildroot
+=== Running scripts before and after each build step
+
It is possible to instrument the steps +Buildroot+ does when building
packages. Define the variable +BR2_INSTRUMENTATION_SCRIPTS+ to contain
the path of one or more scripts (or other executables), in a
@@ -41,3 +43,18 @@ The script has access to the following variables:
- +BINARIES_DIR+: the place where all binary files (aka images) are
stored
- +BASE_DIR+: the base output directory
+
+=== Debugging shell scripts in Buildroot
+
+For shell scripts using the _shell modules_ (available in
++support/scripts/shell/+), an environment variable is available to trace
+the scripts:
+
+ - +SHELL_DEBUG+ adjustes the debug level, from 0 to 3 (only errors to
+ all debug messages)
+
+To enable these debug outputs:
+
+----
+SHELL_DEBUG=3 make
+----
--
2.8.0
More information about the buildroot
mailing list