Documentation
¶
Overview ¶
============================================================================= NFTBan v1.73 - Installer Dual Logger ============================================================================= SPDX-License-Identifier: MPL-2.0 meta:name="installer-logger" meta:type="lib" meta:owner="Antonios Voulvoulis <contact@nftban.com>" meta:created_date="2026-04-04" meta:description="Dual console+file logger for installer output" meta:inventory.files="internal/installer/logging/logger.go" meta:inventory.binaries="" meta:inventory.env_vars="" meta:inventory.config_files="/var/log/nftban/installer.log" meta:inventory.systemd_units="" meta:inventory.network="" meta:inventory.privileges="root" =============================================================================
Index ¶
- Constants
- type Logger
- func (l *Logger) Close()
- func (l *Logger) CmdResult(name string, exitCode int, stderr string)
- func (l *Logger) Debug(format string, args ...interface{})
- func (l *Logger) Detect(category, key, value string)
- func (l *Logger) Error(format string, args ...interface{})
- func (l *Logger) Info(format string, args ...interface{})
- func (l *Logger) LogPath() string
- func (l *Logger) Phase(name string)
- func (l *Logger) PhaseEnd(name string)
- func (l *Logger) Result(format string, args ...interface{})
- func (l *Logger) RunFooter(finalState string, exitCode int)
- func (l *Logger) RunHeader(version, mode, hostname, osInfo string)
- func (l *Logger) StateChange(from, to, reason string)
- func (l *Logger) Warn(format string, args ...interface{})
Constants ¶
const DefaultLogPath = "/var/log/nftban/installer.log"
DefaultLogPath is the standard installer log location.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Logger ¶
type Logger struct {
// contains filtered or unexported fields
}
Logger writes to both console and a persistent log file. The log file is append-only — every install/update/repair run is preserved as a contiguous block delimited by RunHeader/RunFooter for post-mortem analysis.
func New ¶
New creates a Logger. logPath may be empty to use DefaultLogPath. If the log file cannot be opened, logging continues to console only.
func (*Logger) CmdResult ¶
CmdResult logs the result of a command execution. This captures every external command's exit code and stderr for root cause analysis. Only writes to file (not console) unless verbose or non-zero exit.
func (*Logger) Detect ¶
Detect logs a detection result (SSH, panel, conflicts, authority). These are the key facts needed for root cause analysis.
func (*Logger) PhaseEnd ¶
PhaseEnd records the elapsed time for the current phase. Called automatically by Phase() for the previous phase, but should also be called for the final phase.
func (*Logger) Result ¶
Result prints a final result line (no timestamp on console for cleaner output).
func (*Logger) RunFooter ¶
RunFooter writes the closing delimiter with elapsed time and final state.
func (*Logger) RunHeader ¶
RunHeader writes a clear delimiter block marking the start of an installer run. This is essential for finding where a specific install/update begins in the log.
func (*Logger) StateChange ¶
StateChange logs a state machine transition to file.
Source Files