Struct EthernetLayer 

pub struct EthernetLayer {
    interfaces: RwLock<BTreeMap<String, EthernetInterfaceInfo>>,
    devices: RwLock<BTreeMap<String, Arc<dyn NetworkInterface>>>,
    default_interface: RwLock<Option<String>>,
    protocols: RwLock<BTreeMap<u16, Arc<dyn NetworkLayer>>>,
    stats: RwLock<NetworkLayerStats>,
}

Ethernet layer

Handles Ethernet II frame encapsulation and decapsulation. Manages multiple interfaces and routes frames based on EtherType field.

Fields

interfaces: RwLock<BTreeMap<String, EthernetInterfaceInfo>>

Registered interfaces: name -> info

devices: RwLock<BTreeMap<String, Arc<dyn NetworkInterface>>>

Interface devices: name -> device (kept separate for Arc handling)

default_interface: RwLock<Option<String>>

Default interface name

protocols: RwLock<BTreeMap<u16, Arc<dyn NetworkLayer>>>

Protocol handlers registered by EtherType

stats: RwLock<NetworkLayerStats>

Statistics

Implementations

impl EthernetLayer

pub fn new() -> Arc<Self>

Create a new Ethernet layer

pub fn init(network_manager: &NetworkManager)

Initialize and register the Ethernet layer with NetworkManager

This is the first layer to be initialized as it has no dependencies. Other layers (IPv4, ARP) will register their protocols with this layer.

pub fn register_interface( &self, name: &str, mac: MacAddress, device: Arc<dyn NetworkInterface>, )

Register a network interface

pub fn unregister_interface(&self, name: &str)

Unregister a network interface

pub fn get_interface(&self, name: &str) -> Option<EthernetInterfaceInfo>

Get interface info by name

pub fn get_mac(&self, name: &str) -> Option<MacAddress>

Get MAC address for an interface

pub fn get_default_interface(&self) -> Option<String>

Get default interface name

pub fn set_default_interface(&self, name: &str)

Set default interface

pub fn list_interfaces(&self) -> Vec<String>

Get all interface names

fn get_device(&self, name: &str) -> Option<Arc<dyn NetworkInterface>>

Get device for an interface

fn resolve_dest_mac( &self, context: &LayerContext, interface: &str, ) -> Result<[u8; 6], SocketError>

Resolve destination MAC address for sending

This method determines the destination MAC address for an outgoing packet:

1. If explicit eth_dst_mac is in context, use it directly
2. If destination is broadcast IP (255.255.255.255), use broadcast MAC
3. Otherwise, look up in ARP cache (using next_hop if set, else dst_ip)

Arguments

• context - Layer context with addressing info
• interface - Interface name for per-interface ARP cache lookup

Returns

MAC address to use as destination, or error if resolution fails

pub fn receive_on_interface( &self, frame: &[u8], interface: &str, ) -> Result<(), SocketError>

Receive a frame on a specific interface

This method should be called by drivers to process incoming frames. It passes the interface name to upper layers via context.

Trait Implementations

impl NetworkLayer for EthernetLayer

fn register_protocol(&self, proto_num: u16, handler: Arc<dyn NetworkLayer>)

Register a protocol handler for this layer

fn send( &self, packet: &[u8], context: &LayerContext, _next_layers: &[Arc<dyn NetworkLayer>], ) -> Result<(), SocketError>

Send a packet through this layer

fn receive( &self, frame: &[u8], context: Option<&LayerContext>, ) -> Result<(), SocketError>

Receive and process a packet at this layer

fn name(&self) -> &'static str

Get layer name for debugging

fn stats(&self) -> NetworkLayerStats

Get layer statistics

fn as_any(&self) -> &dyn Any

Cast to Any for safe downcasting

fn configure( &self, config: &SocketConfig, next_layers: &[Arc<dyn NetworkLayer>], ) -> Result<(), SocketError>

Configure this layer with socket-specific parameters