Struct ScanConfig 

#[non_exhaustive]
pub struct ScanConfig {
    pub targets: Vec<Ipv4Addr>,
    pub ports: Vec<Port>,
    pub source: Ipv4Addr,
    pub bandwidth_kib: u64,
    pub timeout: Duration,
    pub show_closed: bool,
}

Configuration for one SYN scan.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

targets: Vec<Ipv4Addr>

IPv4 addresses to scan.

Addresses must be unique.

ports: Vec<Port>

TCP ports to scan.

Ports must be unique.

source: Ipv4Addr

Source IPv4 address assigned to the selected interface.

bandwidth_kib: u64

Approximate maximum packet bandwidth in KiB/s.

ScanConfig::new defaults this to 15 KiB/s, or approximately 384 probes per second with the scanner’s 40-byte packet accounting.

timeout: Duration

Time to listen for late replies after the final probe.

Capped at 24 hours; ScanConfig::new defaults this to 30 seconds.

show_closed: bool

Whether RST responses should be returned.

Implementations

impl ScanConfig

pub const fn new( targets: Vec<Ipv4Addr>, ports: Vec<Port>, source: Ipv4Addr, ) -> Self

Creates a configuration with 15 KiB/s bandwidth and a 30-second late-reply timeout.

Examples

use singsing_rs::ScanConfig;
use std::net::Ipv4Addr;

let target: Ipv4Addr = "192.168.2.10".parse()?;
let mut config = ScanConfig::new(vec![target], vec![22, 80, 443], Ipv4Addr::LOCALHOST);
config.show_closed = true;

assert_eq!(config.bandwidth_kib, 15);
assert!(config.show_closed);

Trait Implementations

impl Clone for ScanConfig

fn clone(&self) -> ScanConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ScanConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for ScanConfig

impl Hash for ScanConfig

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ScanConfig

fn eq(&self, other: &ScanConfig) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ScanConfig