msw/CISS.debian.installer
SHA256
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

V8.00.000.2025.06.17
All checks were successful
🛡️ Shell Script Linting / 🛡️ Shell Script Linting (push) Successful in 1m52s
Details

Browse Source 
Signed-off-by: Marc S. Weidner <msw@coresecret.dev>
This commit is contained in:
Marc S. Weidner
2025-10-24 10:57:49 +01:00
parent fd60deb5b9
commit dcd3680077
138 changed files with 398 additions and 168 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
lib/cdi_0005_guard/0005_guard_sourcing.sh
View File

@@ -16,23 +16,23 @@
# Globals:
# BASH_SOURCE
# Arguments:
# 1: Explicitly provided Argument: filename of the caller LIB. (Better let the guard_sourcing() determine dynamically.)
# 1: Explicitly provided Argument: filename of the caller LIB. (Better let the guard_sourcing || return "${ERR_GUARD_SOURCE}"() determine dynamically.)
# Returns:
# 0: Returns '0' in both cases as they are intended to be successful.
#######################################
guard_sourcing() {
guard_sourcing || return "${ERR_GUARD_SOURCE}"() {
### Determine the caller script (the library being sourced).
declare var_src="${1:-${BASH_SOURCE[1]}}"
declare var_src="${1:-${BASH_SOURCE[1]}}"
### Strip path, keep only the filename
declare var_file_name="${var_src##*/}"
declare var_file_name="${var_src##*/}"
### Sanitize to valid var name.
declare var_safe_name="${var_file_name//[^a-zA-Z0-9_]/_}"
declare var_safe_name="${var_file_name//[^a-zA-Z0-9_]/_}"
### Build guard-variable name.
declare var_guard_var="_${var_safe_name}_LOADED"
declare var_guard_var="_${var_safe_name}_LOADED"
### If already loaded, abort sourcing
if [[ -n "${!var_guard_var:-}" ]]; then
return 0
return "${ERR_GUARD_SOURCE}"
fi
### Mark as loaded (readonly + exported)
@@ -41,5 +41,5 @@ guard_sourcing() {
}
### Prevents accidental 'unset -f'.
# shellcheck disable=SC2034
readonly -f guard_sourcing
readonly -f guard_sourcing || return "${ERR_GUARD_SOURCE}"
# vim: number et ts=2 sw=2 sts=2 ai tw=128 ft=sh

2
lib/cdi_0005_guard/0007_guard_safe_exec.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.installer
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Generic safe wrapper for external commands.

2
lib/cdi_0005_guard/0008_guard_variable.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.installer
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Converts the value of a passed variable to lowercase.

2
lib/cdi_0005_guard/0009_guard_dir.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.installer
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Function to log a module success message and change pwd to script root.

4
lib/cdi_0005_guard/README.md
View File

@@ -19,7 +19,7 @@ sourcing, which are frequent sources of bugs and side effects in modular Bash-ba
## 2.1. Purpose and Functionality
- **0005_guard_sourcing.sh**
Defines the `guard_sourcing()` function, which programmatically prevents a Bash library file from being sourced multiple
Defines the `guard_sourcing || return "${ERR_GUARD_SOURCE}"()` function, which programmatically prevents a Bash library file from being sourced multiple
times. It constructs a uniquely scoped read-only environment variable guard to mark the sourced state.
- **0006_source_guard.sh**
@@ -36,7 +36,7 @@ sourcing, which are frequent sources of bugs and side effects in modular Bash-ba
- Bash version ≥ 5.1
- Active error trapping via `trap 'trap_err' ERR`
- `do_log()` must be declared elsewhere in the global context
- All libraries must be sourced via `source_guard()` and invoke `guard_sourcing` on top
- All libraries must be sourced via `source_guard()` and invoke `guard_sourcing || return "${ERR_GUARD_SOURCE}"` on top
## 2.3. Dependencies

2
lib/cdi_0010_basic/0010_color_echo.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.installer
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Print-colored text.

2
lib/cdi_0010_basic/0011_gen_dir_files.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.installer
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Creates the DIRs, prepares the files and mounting paths for installation.

2
lib/cdi_0010_basic/0012_calculate_runtime.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.installer
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Calculates total runtime of the CISS.debian.installer.

2
lib/cdi_0025_logging/0024_logging_helper.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.installer
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Wrapper around 'printf' for clean code.

2
lib/cdi_0025_logging/0025_logging_modules.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.installer
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Log level values for comparison.

2
lib/cdi_0030_checks/0030_check_pkgs.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.installer
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Check for required deb packages to run the script.

2
lib/cdi_0030_checks/0031_check_git.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.installer
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Define Git Repo related Variables.

2
lib/cdi_0030_checks/0040_check_var.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.installer
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Unbound Variable Check.

2
lib/cdi_0050_debug/0050_debug_pre_scan.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.installer
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Check for DEBUG mode.

2
lib/cdi_0050_debug/0051_debug_var_dump.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.installer
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Capture an initial snapshot of all variables (excluding '^(BASH|_).*').

2
lib/cdi_0050_debug/0052_debug_trace.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.installer
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Wrapper for XTRACE Debug.

2
lib/cdi_0050_debug/0053_debug_trace_header.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.installer
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Generates XTRACE Debug Log Header.

2
lib/cdi_0050_debug/0054_debug_trap.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.installer
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Initialize Trap on 'DEBUG'.

2
lib/cdi_0050_debug/0055_debug_trap_header.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.installer
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Generates TRAP Debug Log Header.

2
lib/cdi_0050_debug/0056_debug_guard.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.installer
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Wrapper that enables and disables XTRACE password handling safely.

2
lib/cdi_0060_traps/0060_trap_err.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.installer
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Print Error Message for Trap on 'ERR' in '${ERROR_LOG}'.

2
lib/cdi_0060_traps/0070_trap_exit.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.live.builder
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Copy pre-debootstrap-environment logs into target system.

2
lib/cdi_0060_traps/0080_trap_int.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.installer
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Restart Dialog Wrapper in case of unintentional SIGINT.

2
lib/cdi_0060_traps/0090_clean_up.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.live.builder
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Clean Up Wrapper on Trap on 'EXIT'.

2
lib/cdi_0100_arg/0100_arg_mismatch.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.installer
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Wrapper for mismatched Arguments.

2
lib/cdi_0100_arg/0101_arg_sanitizer.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.installer
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Argument Check Wrapper.

2
lib/cdi_0100_arg/0102_arg_parser.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.installer
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Argument Parser

2
lib/cdi_0100_arg/0103_arg_priority_check.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.installer
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Check and setup Script Priorities

2
lib/cdi_0100_arg/0104_arg_passphrase_modules.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.installer
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Generates a 16-byte salt.

2
lib/cdi_0100_arg/0105_arg_nuke_converter.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.installer
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Generates 'nuke=HASH' Bootparameter.

2
lib/cdi_0110_interactive/0110_dialog_kernel.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.installer
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Kernel Image Selector.

2
lib/cdi_0110_interactive/0115_dialog_notes.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.installer
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Notes Textbox.

2
lib/cdi_0200_dialog/0200_dialog_helper.sh
View File

@@ -10,7 +10,7 @@
# SPDX-PackageName: CISS.debian.installer
# SPDX-Security-Contact: security@coresecret.eu
guard_sourcing
guard_sourcing || return "${ERR_GUARD_SOURCE}"
#######################################
# Terminal cleaner for Dialog Wrappers.