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

Browse Source 
Signed-off-by: Marc S. Weidner <msw@coresecret.dev>
This commit is contained in:
Marc S. Weidner
2025-07-31 01:21:35 +02:00
parent 38510a103c
commit 57dcc9c19b
1 changed files with 4 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
docs/man/ERROR_HANDLING.md
View File

@@ -18,7 +18,7 @@ This document outlines the core mechanisms responsible for global Bash environme
handling, and structured diagnostics in the `CISS.debian.installer`. These foundational components ensure that the installer handling, and structured diagnostics in the `CISS.debian.installer`. These foundational components ensure that the installer
operates in a predictable, robust, and audit-friendly manner, even under adverse conditions. operates in a predictable, robust, and audit-friendly manner, even under adverse conditions.
## File: 2.2. [bash.var.sh](../../var/bash.var.sh) ## 2.2. [bash.var.sh](../../var/bash.var.sh)
### 2.2.1. Purpose ### 2.2.1. Purpose
@@ -44,7 +44,7 @@ exhaustive state introspection. The defined options anticipate and actively prev
conditions or shell misbehavior. conditions or shell misbehavior.
## 2.3. File: [0060_trap_err.sh](../../lib/0060_trap_err.sh) ## 2.3. [0060_trap_err.sh](../../lib/0060_trap_err.sh)
### 2.3.1. Purpose ### 2.3.1. Purpose
@@ -68,7 +68,7 @@ anomalies precisely, log them comprehensively, and expose them to the console an
- Integrates gracefully with dialog-driven user interfaces (e.g., `dialog_box_cleaner`, `dialog_gauge_cleaner`). - Integrates gracefully with dialog-driven user interfaces (e.g., `dialog_box_cleaner`, `dialog_gauge_cleaner`).
- Evaluates `VAR_DEBUG_TRACE` and `VAR_DEBUG_TRAP` to determine the scope of runtime introspection. - Evaluates `VAR_DEBUG_TRACE` and `VAR_DEBUG_TRAP` to determine the scope of runtime introspection.
## 2.4. File: [0070_trap_exit.sh](../../lib/0070_trap_exit.sh) ## 2.4. [0070_trap_exit.sh](../../lib/0070_trap_exit.sh)
### 2.4.1. Purpose ### 2.4.1. Purpose
@@ -95,7 +95,7 @@ error. Notably, it complements `trap_err()` by catching unbound variable errors
- Isolates early trap context via local read-only declarations to avoid overwriting. - Isolates early trap context via local read-only declarations to avoid overwriting.
- Ensures that debug logs and variable states are flushed before exit. - Ensures that debug logs and variable states are flushed before exit.
## 2.5. File: [0080_trap_int.sh](../../lib/0080_trap_int.sh) ## 2.5. [0080_trap_int.sh](../../lib/0080_trap_int.sh)
### 2.5.1. Purpose ### 2.5.1. Purpose
@@ -127,7 +127,6 @@ crucial for headless or semi-automated deployments with interactive components.
- **Fail-fast philosophy:** The combination of `set -Ceuo pipefail` with trap integration guarantees that misconfigurations or runtime anomalies are never silently ignored. - **Fail-fast philosophy:** The combination of `set -Ceuo pipefail` with trap integration guarantees that misconfigurations or runtime anomalies are never silently ignored.
- **Interactive safety net:** Signal handling introduces it a user-verifiable fail-safe for recovery or re-entry. - **Interactive safety net:** Signal handling introduces it a user-verifiable fail-safe for recovery or re-entry.
## 2.7. Summary ## 2.7. Summary
These core components of the `CISS.debian.installer` provide a robust, secure, and transparent execution environment. The Bash These core components of the `CISS.debian.installer` provide a robust, secure, and transparent execution environment. The Bash