Enum SocketMode 

#[non_exhaustive]
pub enum SocketMode {
    Raw,
    Dgram,
    Stream,
}

Socket mode (affects permissions required)

Different socket modes have different permission requirements:

• Raw: Full control but requires root/CAP_NET_RAW
• Dgram: ICMP datagram sockets - platform specific permissions
• Stream: TCP connections (not yet implemented)

The library will automatically fall back to less privileged modes when possible.

Platform-Specific DGRAM Support

• Linux: Requires root or sysctl net.ipv4.ping_group_range configuration
• macOS: Works without root for ICMP DGRAM sockets
• FreeBSD/OpenBSD: Requires root
• Windows: Uses Windows-specific ICMP APIs (IcmpSendEcho)

This enum is #[non_exhaustive]: new socket modes may be added in minor releases, so downstream matches must include a wildcard arm.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Raw

Raw socket - always requires CAP_NET_RAW or root

Dgram

Datagram socket for ICMP - permissions vary by platform

Stream

Stream socket (TCP) - not yet implemented

Implementations

impl SocketMode

pub fn description(&self) -> &'static str

Get a human-readable description

Trait Implementations

impl Clone for SocketMode

fn clone(&self) -> SocketMode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SocketMode

impl Debug for SocketMode

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SocketMode

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for SocketMode

impl PartialEq for SocketMode

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for SocketMode

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for SocketMode