MacRelayUnitBase

Package: inet.linklayer.base

MacRelayUnitBase

simple module

C++ definition

Abstract base module for MAC relay unit implementations (Ethernet switches). Provides core functionality for MAC address learning and frame forwarding in bridged Ethernet networks. Contains functionality for maintaining a MAC address table that maps addresses to ports, learning addresses from incoming frames, and forwarding frames to appropriate interfaces. It is able to handle unicast, multicast, and broadcast traffic according to standard Ethernet switching rules.

<b>See also:</b> IMacForwardingTable

Inheritance diagram

The following diagram shows inheritance relationships for this type. Unresolved types are missing from the diagram.

Known subclasses

Name Type Description
Ieee8021dRelay simple module

Forwards frames (~EtherFrame) based on their destination MAC addresses to appropriate ports.

MacRelayUnit simple module

Implements Ethernet switch functionality by relaying frames between different ports based on destination MAC addresses. Maintains a MAC address table that maps addresses to ports, learns addresses from incoming frames, and forwards frames appropriately. Handles unicast, multicast, and broadcast traffic according to standard Ethernet switching rules, with support for VLANs.

Extends

Name Type Description
SimpleModule simple module

Base module for all INET simple modules.

Parameters

Name Type Default value Description
displayStringTextFormat string "proc: %p\ndisc: %d"

Determines the text that is written on top of the submodule, supports displaying pars, watches, and module-specific information

macTableModule string
interfaceTableModule string

Properties

Name Value Description
class MacRelayUnitBase
display i=block/switch

Gates

Name Direction Size Description
lowerLayerIn input
lowerLayerOut output
upperLayerIn input
upperLayerOut output

Signals

Name Type Unit Description
packetReceivedFromUpper inet::Packet
packetReceivedFromLower inet::Packet
packetDropped inet::Packet
packetSentToLower inet::Packet

Statistics

Name Title Source Record Unit Interpolation Mode Description
packetDropped packets dropped count, sum(packetBytes), vector(packetBytes) none

Source code

//
// Abstract base module for MAC relay unit implementations (Ethernet switches).
// Provides core functionality for MAC address learning and frame forwarding in
// bridged Ethernet networks. Contains functionality for maintaining a MAC
// address table that maps addresses to ports, learning addresses from incoming
// frames, and forwarding frames to appropriate interfaces. It is able to handle
// unicast, multicast, and broadcast traffic according to standard Ethernet
// switching rules.
//
// @see IMacForwardingTable
//
simple MacRelayUnitBase extends SimpleModule
{
    parameters:
        @class(MacRelayUnitBase);
        string macTableModule;
        string interfaceTableModule;
        displayStringTextFormat = default("proc: %p\ndisc: %d");
        @display("i=block/switch");
        @signal[packetSentToLower](type=inet::Packet);
        @signal[packetReceivedFromUpper](type=inet::Packet);
        @signal[packetReceivedFromLower](type=inet::Packet);
        @signal[packetDropped](type=inet::Packet);
        @statistic[packetDropped](title="packets dropped"; record=count,sum(packetBytes),vector(packetBytes); interpolationmode=none);
    gates:
        input lowerLayerIn;
        output lowerLayerOut;
        input upperLayerIn;
        output upperLayerOut;
}

File: src/inet/linklayer/base/MacRelayUnitBase.ned