internal/

directory
v0.0.0-...-20fd28a Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 20, 2026 License: AGPL-3.0

Directories

Path Synopsis
Package actionlog records what CSM did to a host, as opposed to what it found.
Package actionlog records what CSM did to a host, as opposed to what it found.
Package admission holds the typed vocabulary automatic firewall responses are admitted with: canonical targets, evidence records, verified owners, candidate identity and priority.
Package admission holds the typed vocabulary automatic firewall responses are admitted with: canonical targets, evidence records, verified owners, candidate identity and priority.
Package admissionowner is the daemon's owner of the admission ledger: the one handle on the state database's ledger, and the one goroutine that changes it.
Package admissionowner is the daemon's owner of the admission ledger: the one handle on the state database's ledger, and the one goroutine that changes it.
Package antispam renders the Exim and rspamd configuration CSM owns for inbound spam filtering and evaluates the host preconditions for it.
Package antispam renders the Exim and rspamd configuration CSM owns for inbound spam filtering and evaluates the host preconditions for it.
dovecot
Package dovecot lists the users of a Dovecot 2.3 host and the Maildir++ folders of their \Junk mailboxes, checking directory aliases on disk.
Package dovecot lists the users of a Dovecot 2.3 host and the Maildir++ folders of their \Junk mailboxes, checking directory aliases on disk.
hostfacts
Package hostfacts reads the facts antispam.CheckHost evaluates.
Package hostfacts reads the facts antispam.CheckHost evaluates.
learn
Package learn turns Spam folder reports and operator requests into anchor values in rspamd's local fuzzy storage: a strict controller client, the ledger, anchor bodies, assignment, publication and audits.
Package learn turns Spam folder reports and operator requests into anchor values in rspamd's local fuzzy storage: a strict controller client, the ledger, anchor bodies, assignment, publication and audits.
learnwatch
Package learnwatch finds new reports in tenants' Spam folders and hands them to the learning engine.
Package learnwatch finds new reports in tenants' Spam folders and hands them to the learning engine.
reconcile
Package reconcile runs CSM's antispam integration from the daemon: it decides on each pass whether to install, remove or keep the integration, asks the root worker to do it, and turns preconditions, worker results and rspamd health into findings.
Package reconcile runs CSM's antispam integration from the daemon: it decides on each pass whether to install, remove or keep the integration, asks the root worker to do it, and turns preconditions, worker results and rspamd health into findings.
txn
Package txn runs CSM's antispam apply and remove transactions on cPanel and Postfix hosts.
Package txn runs CSM's antispam apply and remove transactions on cPanel and Postfix hosts.
worker
Package worker runs CSM's antispam transactions at the root boundary and launches them from the daemon: one JSON request in, one JSON result out, under the shared Exim mutation lock.
Package worker runs CSM's antispam transactions at the root boundary and launches them from the daemon: one JSON request in, one JSON result out, under the shared Exim mutation lock.
Package atomicio implements atomic file writes used by state-bearing callers (firewall engine, autoblock tracker, etc.).
Package atomicio implements atomic file writes used by state-bearing callers (firewall engine, autoblock tracker, etc.).
Package attackcorpus loads the attack replay corpus: malicious samples and near-miss controls, each with what every detection path must report for it.
Package attackcorpus loads the attack replay corpus: malicious samples and near-miss controls, each with what every detection path must report for it.
Package blockdigest sends the daily alert summary of attacks CSM handled, and batches auto-block events into a per-country roll-up for it so operators learn when IPs from their customers' countries get blocked.
Package blockdigest sends the daily alert summary of attacks CSM handled, and batches auto-block events into a per-country roll-up for it so operators learn when IPs from their customers' countries get blocked.
Package bpf provides the shared scaffolding that BPF-backed live monitors across the daemon use: a common Backend interface, backend-kind constants for operator config, sentinel errors that distinguish "not built" from "kernel unsupported", and a per-feature backend metric.
Package bpf provides the shared scaffolding that BPF-backed live monitors across the daemon use: a common Backend interface, backend-kind constants for operator config, sentinel errors that distinguish "not built" from "kernel unsupported", and a per-feature backend metric.
Package broadcast provides a one-to-many publish bus for alert.Finding events.
Package broadcast provides a one-to-many publish bus for alert.Finding events.
HTTP abuse detection.
HTTP abuse detection.
Package clientaddr resolves the client address of an HTTP request or access-log record from its direct peer and X-Forwarded-For chain.
Package clientaddr resolves the client address of an HTTP request or access-log record from its direct peer and X-Forwarded-For chain.
Package cms is the single declaration of the content management systems CSM supports.
Package cms is the single declaration of the content management systems CSM supports.
Package contenttype classifies file content shared by the malware scanners.
Package contenttype classifies file content shared by the malware scanners.
Package control defines the wire protocol between the CSM daemon and its local command-line client.
Package control defines the wire protocol between the CSM daemon and its local command-line client.
Package corpusgate provisions pinned clean applications for detector tests.
Package corpusgate provisions pinned clean applications for detector tests.
Package crashsample keeps private copies of inputs that crashed a parse worker, for diagnosis.
Package crashsample keeps private copies of inputs that crashed a parse worker, for diagnosis.
Package crawlid is the canonical request identity shared by the http_pattern_crawl detector and the PHP shield crawl gate.
Package crawlid is the canonical request identity shared by the http_pattern_crawl detector and the PHP shield crawl gate.
Package crawlreplay replays anonymized domlog record streams through exact models of the http_pattern_crawl detector, so window, baseline, residual and sketch settings can be chosen from traffic hosts actually served.
Package crawlreplay replays anonymized domlog record streams through exact models of the http_pattern_crawl detector, so window, baseline, residual and sketch settings can be chosen from traffic hosts actually served.
af_alg_bpfprog
Package af_alg_bpfprog hosts the BPF C source for the AF_ALG (CVE-2026-31431 "Copy Fail") kernel-side deny program and the generated Go bindings produced by bpf2go.
Package af_alg_bpfprog hosts the BPF C source for the AF_ALG (CVE-2026-31431 "Copy Fail") kernel-side deny program and the generated Go bindings produced by bpf2go.
connection_bpfprog
Package connection_bpfprog hosts the BPF C source for the cgroup/connect outbound-connection tracker and the generated Go bindings produced by bpf2go.
Package connection_bpfprog hosts the BPF C source for the cgroup/connect outbound-connection tracker and the generated Go bindings produced by bpf2go.
exec_bpfprog
Package exec_bpfprog hosts the BPF C source for the sched/sched_process_exec tracepoint live monitor and the generated Go bindings produced by bpf2go.
Package exec_bpfprog hosts the BPF C source for the sched/sched_process_exec tracepoint live monitor and the generated Go bindings produced by bpf2go.
placement_bpfprog
Package placement_bpfprog hosts the BPF C source for the lsm/inode_rename and lsm/inode_link placement monitor and the generated Go bindings produced by bpf2go.
Package placement_bpfprog hosts the BPF C source for the lsm/inode_rename and lsm/inode_link placement monitor and the generated Go bindings produced by bpf2go.
sensitive_file_bpfprog
Package sensitive_file_bpfprog hosts the BPF C source for the lsm/file_permission live monitor and the generated Go bindings produced by bpf2go.
Package sensitive_file_bpfprog hosts the BPF C source for the lsm/file_permission live monitor and the generated Go bindings produced by bpf2go.
Package eximlock serializes CSM's edits and rebuilds of shared Exim configuration.
Package eximlock serializes CSM's edits and rebuilds of shared Exim configuration.
Package eximlog extracts the connecting client from Exim main log lines.
Package eximlog extracts the connecting client from Exim main log lines.
rollback
Package rollback implements the firewall settings tentative-apply workflow: a save with a deadline that auto-reverts unless the operator confirms before the timer expires.
Package rollback implements the firewall settings tentative-apply workflow: a save with a deadline that auto-reverts unless the operator confirms before the timer expires.
Package forensic produces evidence archives for incident response.
Package forensic produces evidence archives for incident response.
Package geoip provides IP geolocation via MaxMind GeoLite2 databases and on-demand RDAP lookups for detailed ISP/org information.
Package geoip provides IP geolocation via MaxMind GeoLite2 databases and on-demand RDAP lookups for detailed ISP/org information.
Package incident groups related security findings into a single "story" with a timeline.
Package incident groups related security findings into a single "story" with a timeline.
integration
webserver
Package webserver auto-installs the CSM challenge webserver glue (Apache / LSWS / Nginx) with a write-validate-reload-or-revert flow.
Package webserver auto-installs the CSM challenge webserver glue (Apache / LSWS / Nginx) with a write-validate-reload-or-revert flow.
Package ipmap builds and writes the CSM IP map: one rspamd multimap file listing CSM's own evidence about sender addresses.
Package ipmap builds and writes the CSM IP map: one rspamd multimap file listing CSM's own evidence about sender addresses.
Package jstaint reports keystroke values that reach a network sink in a JavaScript source file.
Package jstaint reports keystroke values that reach a network sink in a JavaScript source file.
Package log provides a structured-logging wrapper around log/slog.
Package log provides a structured-logging wrapper around log/slog.
mailfwd
adapter
Package adapter renders and applies the MTA-native forward-guard rule.
Package adapter renders and applies the MTA-native forward-guard rule.
guard
Package guard glues the operator config to the pure forward-guard policy.
Package guard glues the operator config to the pure forward-guard policy.
intel
Package intel turns exim_mainlog deferral lines into operator-facing reputation signals: which outbound IPs are being throttled, by which mail providers, and for what stated reason.
Package intel turns exim_mainlog deferral lines into operator-facing reputation signals: which outbound IPs are being throttled, by which mail providers, and for what stated reason.
inventory
Package inventory enumerates mail forwarders on a host and classifies their destinations, so operators can see which accounts relay mail off-server and to which providers.
Package inventory enumerates mail forwarders on a host and classifies their destinations, so operators can see which accounts relay mail off-server and to which providers.
policy
Package policy is the single source of truth for the forward-guard hold decision: given the signals observed for a message, should the external forward copy be held? The same Verdict function feeds both the dry-run "would-hold" accounting and (in Phase 2) the generated MTA rule, so the two can never drift apart.
Package policy is the single source of truth for the forward-guard hold decision: given the signals observed for a message, should the external forward copy be held? The same Verdict function feeds both the dry-run "would-hold" accounting and (in Phase 2) the generated MTA rule, so the two can never drift apart.
quarantine
Package quarantine is the CSM-owned Maildir that holds external forward copies the forward-guard decided to withhold.
Package quarantine is the CSM-owned Maildir that holds external forward copies the forward-guard decided to withhold.
Package maillog reads postfix/dovecot log lines from either a tailed file or systemd-journald, normalizing them into a single Line type so the daemon's mail-brute and PHP-relay parsers don't have to care which source supplied the line.
Package maillog reads postfix/dovecot log lines from either a tailed file or systemd-journald, normalizing them into a single Line type so the daemon's mail-brute and PHP-relay parsers don't have to care which source supplied the line.
Package mailranges maintains an atomic in-memory map of mail-provider IP ranges used to exempt shared-source ranges (carrier CGNAT, mail providers) from firewall DoS heuristics.
Package mailranges maintains an atomic in-memory map of mail-provider IP ranges used to exempt shared-source ranges (carrier CGNAT, mail providers) from firewall DoS heuristics.
Package mailstats counts mail decisions from log lines for the Email Security page.
Package mailstats counts mail decisions from log lines for the Email Security page.
Package mcp serves a read-only Model Context Protocol endpoint for support agents.
Package mcp serves a read-only Model Context Protocol endpoint for support agents.
Package metrics is CSM's local OpenMetrics implementation.
Package metrics is CSM's local OpenMetrics implementation.
Package mysqlclient wraps the database/sql + go-sql-driver/mysql pair for the read-only queries CSM issues against host-local MySQL/MariaDB.
Package mysqlclient wraps the database/sql + go-sql-driver/mysql pair for the read-only queries CSM issues against host-local MySQL/MariaDB.
Package netutil holds the shared public-range guard used to validate operator- and vendor-supplied IP ranges.
Package netutil holds the shared public-range guard used to validate operator- and vendor-supplied IP ranges.
Package obs centralises crash reporting and selective error capture via Sentry.
Package obs centralises crash reporting and selective error capture via Sentry.
Package parseworker runs archive parsing on tenant files in a worker process.
Package parseworker runs archive parsing on tenant files in a worker process.
Package phptaint reports remotely-fetched content that reaches a PHP code-execution sink.
Package phptaint reports remotely-fetched content that reaches a PHP code-execution sink.
Package phptaintipc defines the wire protocol spoken between the CSM daemon and the supervised `csm phptaint-worker` child process.
Package phptaintipc defines the wire protocol spoken between the CSM daemon and the supervised `csm phptaint-worker` child process.
Package phptaintworker is the child side of PHP taint analysis.
Package phptaintworker is the child side of PHP taint analysis.
Package platform detects the host OS, control panel, and web server so CSM checks can pick the right config/log paths instead of hardcoding cPanel+Apache layouts.
Package platform detects the host OS, control panel, and web server so CSM checks can pick the right config/log paths instead of hardcoding cPanel+Apache layouts.
Package privops is the inventory of every CSM operation that needs privilege beyond reading its own files, or that writes outside CSM's own directories.
Package privops is the inventory of every CSM operation that needs privilege beyond reading its own files, or that writes outside CSM's own directories.
Package processctx maintains process context (PID/PPID/UID/account/exe/cmdline) for use enriching real-time security findings.
Package processctx maintains process context (PID/PPID/UID/account/exe/cmdline) for use enriching real-time security findings.
Package processhandle signals verified Linux processes through kernel handles.
Package processhandle signals verified Linux processes through kernel handles.
Package quarantinefs makes recovery copies durable before callers change live files.
Package quarantinefs makes recovery copies durable before callers change live files.
Package queuehealth measures waiting, running and lost work independently of the channel that carries findings about a protection failure.
Package queuehealth measures waiting, running and lost work independently of the channel that carries findings about a protection failure.
Package redisinfo wraps the go-redis client for the few read-only INFO calls CSM needs (memory metrics, keyspace counts).
Package redisinfo wraps the go-redis client for the few read-only INFO calls CSM needs (memory metrics, keyspace counts).
Package reporting is the node side of CSM abuse reporting (Layer A).
Package reporting is the node side of CSM abuse reporting (Layer A).
Package responsereplay replays recorded finding streams through models of the automatic response admission path, so capacity and fairness changes can be measured against what hosts actually saw.
Package responsereplay replays recorded finding streams through models of the automatic response admission path, so capacity and fairness changes can be measured against what hosts actually saw.
Package safepath pins directories for operations on tenant-controlled names.
Package safepath pins directories for operations on tenant-controlled names.
Package sdnotify talks to the systemd notification socket.
Package sdnotify talks to the systemd notification socket.
Package selftest runs CSM's detection over a small bundle of samples whose verdicts are known, so an operator can see what the shipped rules catch without pointing the scanner at a production account.
Package selftest runs CSM's detection over a small bundle of samples whose verdicts are known, so an operator can see what the shipped rules catch without pointing the scanner at a production account.
Package session owns browser-session identities and their storage contract.
Package session owns browser-session identities and their storage contract.
Package sharedsenders keeps mail services that many unrelated senders share from being reported as spam sources.
Package sharedsenders keeps mail services that many unrelated senders share from being reported as spam sources.
Package sourcewalk supports source inventories in a checkout shared with tests.
Package sourcewalk supports source inventories in a checkout shared with tests.
Package spamscore is the spam score shared by CSM's spam evidence and the rspamd reputation source: verdict masses decay with a 7-day half-life and a prior mass keeps a few verdicts from saturating the score.
Package spamscore is the spam score shared by CSM's spam evidence and the rspamd reputation source: verdict masses decay with a 7-day half-life and a prior mass keeps a few verdicts from saturating the score.
Package sshdconf reads the effective sshd_config the way sshd itself does: Include directives are followed, Match blocks are ignored because their directives are connection-scoped, and most keywords keep first-match-wins semantics.
Package sshdconf reads the effective sshd_config the way sshd itself does: Include directives are followed, Match blocks are ignored because their directives are connection-scoped, and most keywords keep first-match-wins semantics.
Package stalwartapi is a small client for the Stalwart 1.0 admin API: the JMAP "x:" methods CSM uses to read and change Stalwart's settings.
Package stalwartapi is a small client for the Stalwart 1.0 admin API: the JMAP "x:" methods CSM uses to read and change Stalwart's settings.
Package stalwartlog parses the text log Stalwart mail server 1.0 writes: one event per line, "<RFC3339> <LEVEL> <description> (<event.name>) key = value, ...".
Package stalwartlog parses the text log Stalwart mail server 1.0 writes: one event per line, "<RFC3339> <LEVEL> <description> (<event.name>) key = value, ...".
Package stalwartsetup works out what a Stalwart server needs before CSM can rely on it, and applies it.
Package stalwartsetup works out what a Stalwart server needs before CSM can rely on it, and applies it.
Package systemdrun builds argv for running a command outside the calling service's systemd sandbox.
Package systemdrun builds argv for running a command outside the calling service's systemd sandbox.
Package threatintel -- bot allowlist + verification.
Package threatintel -- bot allowlist + verification.
Package updatecheck polls upstream release channels and tells the daemon whether a newer CSM version is available so the Web UI can surface a banner.
Package updatecheck polls upstream release channels and tells the daemon whether a newer CSM version is available so the Web UI can surface a banner.
Package verdict implements an HMAC-signed HTTP client for the auto_response.verdict_callback hook.
Package verdict implements an HMAC-signed HTTP client for the auto_response.verdict_callback hook.
Package workerproc runs CSM's out-of-process workers: code that parses attacker-controlled input and can loop, crash or exhaust memory, so the daemon runs it in a child process it can kill.
Package workerproc runs CSM's out-of-process workers: code that parses attacker-controlled input and can loop, crash or exhaust memory, so the daemon runs it in a child process it can kill.
Package yaraipc defines the protocol between the CSM daemon and `csm yara-worker`, which runs in locked-down transient units: a compile unit that turns rule text into compiled rules, and a scan unit that loads them and scans descriptors.
Package yaraipc defines the protocol between the CSM daemon and `csm yara-worker`, which runs in locked-down transient units: a compile unit that turns rule text into compiled rules, and a scan unit that loads them and scans descriptors.
Package zipdir locates a zip archive's central directory from its end-of-central-directory record, zip64 included, without reading any entry data.
Package zipdir locates a zip archive's central directory from its end-of-central-directory record, zip64 included, without reading any entry data.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL