56 lines
2.1 KiB
Bash
56 lines
2.1 KiB
Bash
#!/bin/bash
|
|
# SPDX-Version: 3.0
|
|
# SPDX-CreationInfo: 2025-05-05; WEIDNER, Marc S.; <msw@coresecret.dev>
|
|
# SPDX-ExternalRef: GIT https://git.coresecret.dev/msw/CISS.debian.live.builder.git
|
|
# SPDX-FileContributor: WEIDNER, Marc S.; Centurion Intelligence Consulting Agency
|
|
# SPDX-FileCopyrightText: 2024-2025; WEIDNER, Marc S.; <msw@coresecret.dev>
|
|
# SPDX-FileType: SOURCE
|
|
# SPDX-License-Identifier: EUPL-1.2 OR LicenseRef-CCLA-1.0
|
|
# SPDX-LicenseComment: This file is part of the CISS.hardened.installer framework.
|
|
# SPDX-PackageName: CISS.debian.live.builder
|
|
# SPDX-Security-Contact: security@coresecret.eu
|
|
|
|
#######################################
|
|
# Debugger Wrapper for xtrace to Debug Log
|
|
# Globals:
|
|
# BASH_SOURCE
|
|
# BASH_XTRACEFD
|
|
# LOG_DEBUG
|
|
# PS4
|
|
# SHELLOPTS
|
|
# VAR_DUMP_VARS_INITIAL
|
|
# VAR_EARLY_DEBUG
|
|
# var
|
|
# Arguments:
|
|
# None
|
|
#######################################
|
|
debugger() {
|
|
### Capture an initial snapshot of all variables (excluding '^(BASH|_).*')
|
|
# shellcheck disable=SC2155
|
|
declare -grx VAR_DUMP_VARS_INITIAL=$(mktemp)
|
|
{
|
|
declare var
|
|
while IFS= read -r var; do
|
|
declare -p "${var}" 2>/dev/null
|
|
done < <(compgen -v | grep -Ev '^(BASH|_).*')
|
|
} | sort >| "${VAR_DUMP_VARS_INITIAL}"
|
|
declare -gx VAR_EARLY_DEBUG=true
|
|
### Set a verbose PS4 prompt including timestamp, source, line, exit status, and function name
|
|
declare -grx PS4='\e[97m+\e[0m\e[96m$(date -u +%Y-%m-%dT%H:%M:%S.%4N%z)\e[0m\e[97m:\e[0m\e[92m[${BASH_SOURCE[0]}:${LINENO}]\e[0m\e[97m|\e[0m\e[93m${?}\e[0m\e[97m>\e[0m\e[95m${FUNCNAME[0]:-main}()\e[0m \e[97m>>\e[0m '
|
|
# shellcheck disable=SC2155
|
|
declare -grx LOG_DEBUG="/tmp/ciss_live_builder_$$_debug.log"
|
|
### Generates empty LOG_DEBUG
|
|
touch "${LOG_DEBUG}" && chmod 0600 "${LOG_DEBUG}"
|
|
### Open file descriptor 42 for writing to the debug log
|
|
exec 42>| "${LOG_DEBUG}"
|
|
### Write Debug Log Header https://www.gnu.org/software/bash/manual/html_node/Bash-Variables
|
|
debug_header "$#" "$*"
|
|
### Tell Bash to send xtrace output to FD 42
|
|
export BASH_XTRACEFD=42
|
|
### Enable inheritable shell options
|
|
export SHELLOPTS
|
|
### Turn on xtrace
|
|
set -x
|
|
}
|
|
# vim: number et ts=2 sw=2 sts=2 ai tw=128 ft=sh
|