init_env: centralize stdout/stderr capture for all tests

- Add optional global tee capture controlled by RUN_STDOUT_ENABLE/… env vars.
- Create timestamped  (under  or ROOT_DIR/logs).
- Export the same file so child run.sh scripts append to one unified log.
- Install trap to restore FDs on exit; idempotent guard prevents double-capture.

Signed-off-by: Srikanth Muppandam <smuppand@qti.qualcomm.com>

Author: smuppand

Runner/init_env

@@ -43,11 +43,70 @@ export __RUNNER_UTILS_BIN_DIR="$ROOT_DIR/common"
 # --- Ensure TOOLS is usable in all shells ---
 case ":$PATH:" in
   *":$TOOLS:"*) : ;;
-  *) PATH="$TOOLS:$PATH"; export PATH ;;
+  *)
+    PATH="$TOOLS:$PATH"
+    export PATH
+    ;;
 esac
 
 # --- Optional: pre-check for required tools (safe no-op for minimal builds) ---
 if [ -f "$TOOLS/functestlib.sh" ]; then
     # shellcheck disable=SC1090,SC1091
     . "$TOOLS/functestlib.sh" >/dev/null 2>&1 || true
 fi
+
+###############################################################################
+# Stdout/stderr capture (per-test folder)
+#
+# Controls (set BEFORE sourcing this file):
+# RUN_STDOUT_ENABLE = 1 | 0 (default: 1)
+# RUN_STDOUT_TAG = <string> (default: basename of $PWD)
+# RUN_STDOUT_FILE = <path> (default: $PWD/<tag>_stdout_<ts>.log)
+#
+# Behavior:
+# - Writes the capture file into the CURRENT DIRECTORY (usually the test dir).
+# - No global logs/stdout directory is created/used.
+###############################################################################
+_runner_stdout_cleanup() {
+    st=$?
+    # restore original fds (if they were saved)
+    exec 1>&3 2>&4
+    if [ -n "${__TEE_PID:-}" ]; then
+        kill "$__TEE_PID" 2>/dev/null
+    fi
+    if [ -n "${PIPE:-}" ]; then
+        rm -f "$PIPE" 2>/dev/null
+    fi
+    exit "$st"
+}
+
+if [ "${RUN_STDOUT_ENABLE:-1}" -eq 1 ] && [ -z "${__RUN_STDOUT_ACTIVE:-}" ]; then
+    _tag="${RUN_STDOUT_TAG:-$(basename "$(pwd)")}"
+    _ts="$(date +%Y%m%d-%H%M%S)"
+    RUN_STDOUT_FILE="${RUN_STDOUT_FILE:-$(pwd)/${_tag}_stdout_${_ts}.log}"
+    export RUN_STDOUT_FILE
+
+    # Save original stdout/stderr
+    exec 3>&1 4>&2
+
+    if command -v tee >/dev/null 2>&1; then
+        PIPE="$(mktemp -u "/tmp/stdout_pipe.XXXXXX")"
+        if mkfifo "$PIPE" 2>/dev/null; then
+            ( tee -a "$RUN_STDOUT_FILE" >&3 ) < "$PIPE" &
+            __TEE_PID=$!
+            exec > "$PIPE" 2>&1
+            __RUN_STDOUT_ACTIVE=1
+            trap _runner_stdout_cleanup EXIT INT TERM
+        else
+            # Fallback: file-only capture
+            exec >> "$RUN_STDOUT_FILE" 2>&1
+            __RUN_STDOUT_ACTIVE=1
+            trap _runner_stdout_cleanup EXIT INT TERM
+        fi
+    else
+        # Fallback: file-only capture
+        exec >> "$RUN_STDOUT_FILE" 2>&1
+        __RUN_STDOUT_ACTIVE=1
+        trap _runner_stdout_cleanup EXIT INT TERM
+    fi
+fi