[S] Change in coreboot[main]: util/scripts: Add script to capture commands from build

[Felix Held (Code Review)]

Felix Held has submitted this change. ( https://review.coreboot.org/c/coreboot/+/83442?usp=email )

Change subject: util/scripts: Add script to capture commands from build
......................................................................

util/scripts: Add script to capture commands from build

This allows better debugging of the build by writing all the commands
run by the build into a file by replacing the standard shell.

Run with:
make SHELL="${PWD}/util/scripts/capture_commands.sh"

This will allow us to verify that the commands being run are posix
compliant.

Signed-off-by: Martin Roth 
Change-Id: I67efc5096747c2e746642639f88273132e070e49
Reviewed-on: https://review.coreboot.org/c/coreboot/+/83442
Tested-by: build bot (Jenkins) 
Reviewed-by: Felix Singer 
Reviewed-by: Matt DeVillier 
---
A util/scripts/capture_commands.sh
M util/scripts/description.md
2 files changed, 19 insertions(+), 0 deletions(-)

Approvals:
  Matt DeVillier: Looks good to me, approved
  build bot (Jenkins): Verified
  Felix Singer: Looks good to me, but someone else must approve

diff --git a/util/scripts/capture_commands.sh b/util/scripts/capture_commands.sh
new file mode 100755
index 0000000..9e2e08f
--- /dev/null
+++ b/util/scripts/capture_commands.sh
@@ -0,0 +1,17 @@
+#!/usr/bin/env sh
+## SPDX-License-Identifier: BSD-3-Clause
+
+# This script allows us to capture all the commands run in the shell by the
+# coreboot build. This is better than using 'make v=1' because it captures
+# commands right from the beginning of the build, and sends the output of any
+# command to the interactive shell.
+
+# To use, run:
+# make SHELL="${PWD}/util/scripts/capture_commands.sh"
+
+REALSHELL=${REALSHELL:-sh}
+OUTPUT_DIR=${TOP:-/tmp}
+CAPTURE_FILE=${CAPTURE_FILE:-commands.txt}
+
+env echo "$*" | sed 's/^-c '// >> "${OUTPUT_DIR}/${CAPTURE_FILE}"
+"${REALSHELL}" "$@"
diff --git a/util/scripts/description.md b/util/scripts/description.md
index 1c67f07..91a108c 100644
--- a/util/scripts/description.md
+++ b/util/scripts/description.md
@@ -1,4 +1,6 @@
 __scripts__
+  * capture_commands.sh - Write all commands from the build to a file.
+                          `Shell`
   * _config_ - Manipulate options in a .config file from the command
               line `Bash`
   * _cross-repo-cherrypick_ - Pull in patches from another tree from a