gossan_engine/lib.rs
1//! # gossan-engine
2//!
3//! High-performance stateless SYN scanner and banner grabber.
4//!
5//! Replaces `gossan-synscan` with an architecture designed to beat masscan:
6//!
7//! - **Stateless SYN scanning** via [`netforge::SeqEncoder`] (zero per-connection state)
8//! - **Randomized scan order** via [`schedule::BlackrockPermutation`] (IDS evasion)
9//! - **Batch packet I/O** via [`netforge::PacketEngine`] (sendmmsg / AF_XDP)
10//! - **Lock-free result pipeline** via crossbeam SPSC channels
11//! - **Token-bucket rate control** with sub-microsecond precision
12//!
13//! ## Usage as a Gossan Scanner
14//!
15//! ```rust,ignore
16//! use gossan_engine::EngineScanner;
17//! let scanner = EngineScanner::default();
18//! scanner.run(input, &config).await?;
19//! ```
20
21// pedantic moved to workspace [lints.clippy] in root Cargo.toml
22#![cfg_attr(
23 not(test),
24 deny(
25 clippy::unwrap_used,
26 clippy::expect_used,
27 clippy::todo,
28 clippy::unimplemented,
29 clippy::panic
30 )
31)]
32#![allow(
33 clippy::module_name_repetitions,
34 clippy::must_use_candidate,
35 clippy::missing_errors_doc
36)]
37
38pub mod icmp_backoff;
39pub mod probe;
40pub mod rate;
41pub mod scan;
42pub mod schedule;
43
44pub use probe::{probe, Backend, ProbeReport};
45pub use scan::EngineScanner;