Aller au contenu

Build

Prérequis

  • Rust 2024 edition (1.85+)
  • Pour la compilation croisée Windows depuis Linux : cargo install cargo-xwin (télécharge automatiquement le Windows SDK)

Linux / macOS

# Build du binaire Linux
cargo build --release -p sigmacatch-lnx

# Lint
cargo clippy -- -W warnings

Produit sigmacatch-linux (features par défaut auditd + builtin). Tournent en parallèle : le collecteur auditd si /var/log/audit/audit.log existe et les collecteurs syslog builtin (chaque fichier existant parmi central /var/log/messages, /var/log/syslog ; authpriv /var/log/secure, /var/log/auth.log ; cron /var/log/cron, /var/log/cron.log). Aucune source sysmon : les binaires -sysmon et -ebpf l'ajoutent (voir plus bas). Bail au démarrage si aucune source. Spécification complète des trois collecteurs : architecture.md.

Les deux saveurs Linux étendues embarquent en plus une source Sysmon, choisie par feature cargo :

cargo build --release -p sigmacatch-lnx --no-default-features --features auditd,builtin,sysmon  # sigmacatch-linux-sysmon
cargo build --release -p sigmacatch-lnx --no-default-features --features auditd,builtin,ebpf   # sigmacatch-linux-ebpf (root/CAP_BPF+CAP_PERFMON requis)

Sur Linux/macOS les collecteurs Windows sont des stubs no-op — le pipeline tourne de bout en bout pour tests (cargo build -p sigmacatch-win).

Windows

cargo build --release -p sigmacatch-win

Un binaire est produit avec le collecteur Winevt (feature winevt, activée par défaut) :

  • sigmacatch-channel (winevt) : API Winevt native (EvtQueryW → EvtNext → EvtRender) sur les channels résolus. Nécessite les droits admin pour les channels Security et System.

Build isolé :

# Winevt uniquement
cargo build --release --bin sigmacatch-channel --no-default-features --features winevt

Les sous-commandes de diagnostic (check-filter, list-rules) sont toujours compilées dans le binaire — aucune feature supplémentaire n'est requise. La cible [[bin]] exige sa feature de collecteur (winevt) via required-features.

Variantes isolées équivalentes côté Linux :

cargo build --release -p sigmacatch-lnx --no-default-features --features auditd,builtin

Compilation croisée Windows (depuis Linux)

cargo xwin build --release --target x86_64-pc-windows-msvc -p sigmacatch-win

Le binaire résultant est à target/x86_64-pc-windows-msvc/release/sigmacatch-channel.exe. La CI GitHub Actions build nativement sur windows-latest.

Taille du binaire

Build release optimisé : ~10 MB par binaire (constaté en cross x86_64-pc-windows-msvc : sigmacatch-channel.exe ~10.4 MB).

Profil appliqué :

  • strip = true
  • lto = true
  • codegen-units = 1
  • features tokio : rt, rt-multi-thread, macros, sync, time, signal

Sous-commandes de diagnostic

Les sous-commandes check-filter et list-rules sont toujours compilées dans sigmacatch-channel comme dans sigmacatch-linux — plus aucune feature cargo dédiée n'est requise (la feature tools a été supprimée).

La validation de régression (check) n'est plus une sous-commande : c'est le binaire standalone regressiondata-check (regressiondata-check), cross-platform, qui n'exige ni collector ni feature supplémentaire :

# Linux
cargo build --release -p regressiondata-check
# Windows
cargo xwin build --release --target x86_64-pc-windows-msvc -p regressiondata-check

Détails et exemples de sortie → cli.md.