#!/bin/bash
# SPDX-Version: 3.0
# SPDX-CreationInfo: 2025-06-17; WEIDNER, Marc S.; <msw@coresecret.dev>
# SPDX-ExternalRef: GIT https://git.coresecret.dev/msw/CISS.debian.installer.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.debian.installer.secure framework.
# SPDX-PackageName: CISS.debian.installer
# SPDX-Security-Contact: security@coresecret.eu

guard_sourcing || return "${ERR_GUARD_SOURCE}"

#######################################
# Wrapper that enables and disables XTRACE password handling safely.
# Globals:
#   VAR_DEBUG_TRACE
# Arguments:
#   1: on [set +x] || off [set -x]
#######################################
guard_trace() {
  declare -l var_mode="${1:-}"             # Lower-case, default empty.
  declare -l var_dbg="${VAR_DEBUG_TRACE-}" # Lower-case, empty if unset.
  case "${var_mode}" in
    on)  [[ "${var_dbg}" == "true" ]] && set +x ;;
    off) [[ "${var_dbg}" == "true" ]] && set -x ;;
    *)   : ;;                              # No-op on unknown mode.
  esac
  return 0
}
# vim: number et ts=2 sw=2 sts=2 ai tw=128 ft=sh