IPacketFilter

Package: inet.queueing.contract

IPacketFilter

module interface

This module interface is implemented by packet filter modules. A packet filter connects one input to one output. It can operate in both active and passive mode. Packets can be pushed into its input or packets can be pulled from its output. Processed packets are either dropped, if they don't match the filter criteria, or they are passed through without any delay or reordering. Packets are not modified in any way.

Inheritance diagram

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

Implemented by

Name Type Description
ContentBasedFilter simple module

This module filters for packets matching the configured filter criteria. When the filter is pushed by a connected packet producer, it either pushes the packet to the connected packet consumer or drops it depending on the configured packet filter. Similarily, when the filter is pulled by a connected packet collector, it pulls packets from the connected packet provider until it finds one which matches the configured packet filter.

DualIeee8021qFilter compound module

This module combines two meters and their corresponding filters per path. This is primarily useful for combining a token bucket based metering with an asynchronous packet shaper. Note that the asynchronous packet shaper also has parts in the network interface queue module.

EligibilityTimeFilter simple module

This module is a packet filter that operates based on the EligibilityTimeTag attached to the packet that is passing through. Packets are dropped if the tag is missing. If the maxResidenceTime parameter is set, then the filter also drops the packets for which the eligibility time in the attached EligibilityTimeTag is greater than the current simulation time plus the maximum residence time.

EthernetAddressChecker simple module (no description)
EthernetFcsChecker simple module (no description)
EthernetFragmentFcsChecker simple module (no description)
EthernetFragmentPhyHeaderChecker simple module (no description)
EthernetMacHeaderChecker simple module (no description)
EthernetPhyHeaderChecker simple module (no description)
EthernetTypeOrLengthChecker simple module (no description)
Ieee8021qFilter compound module

This module implements the IEEE 802.1Q per-stream filtering and policing. The relationship between streams, gates and meters is not one-to-one. The number of streams, gates and meters can be different and the module will take care about the connections between the submodules based on the streamFilterTable parameter.

Ieee8021qTagEpdHeaderChecker simple module (no description)
Ieee8021qTagTpidHeaderChecker simple module (no description)
Ieee8021rTagEpdHeaderChecker simple module (no description)
LabelFilter simple module

This packet filter module drops packets that don't match the given packet label filter criteria. The criteria can use wildcards and boolean operators.

MultiPacketFilter compound module

This module combines multiple packet filters into one.

OmittedIeee8021qTagEpdHeaderChecker compound module

This module implements the module given interface and can be used as an omitted optional module that removes itself from the module hierarchy during initialize.

OmittedIeee8021qTagTpidHeaderChecker compound module

This module implements the module given interface and can be used as an omitted optional module that removes itself from the module hierarchy during initialize.

OmittedPacketFilter compound module

This module implements the module given interface and can be used as an omitted optional module that removes itself from the module hierarchy during initialize.

PacketFilter simple module

This module filters for packets matching the configured filter criteria. When the filter is pushed by a connected packet producer, it either pushes the packet to the connected packet consumer or drops it depending on the configured packet filter. Similarily, when the filter is pulled by a connected packet collector, it pulls packets from the connected packet provider until it finds one which matches the configured packet filter.

SimpleIeee8021qFilter compound module

This module implements a simplified version of the IEEE 802.1Q per-stream filtering and policing. Each filtered stream has its own path where metering and filtering happens independently of any other stream.

StatisticalRateLimiter simple module

This module limit the datarate or the packetrate of a stream of packets based on the RateTag attached to the packets.

StreamFilter simple module

This module implements a packet filter using solely the stream name. The stream name must match the filter criteria in order the packet to pass through the filter.

StreamMerger simple module

This module merges the packets of the same stream by removing duplicates. In addition it also replaces the stream name on the packet based on the mapping parameter. For merging it maintains a separate finite buffer per stream with the last seen sequence numbers.

VlanIndFilter simple module

This module filters out packets based on the attached VlanInd tag.

VlanReqFilter simple module

This module filters out packets based on the attached VlanReq tag.

Used in compound modules

Name Type Description
DualIeee8021qFilter compound module

This module combines two meters and their corresponding filters per path. This is primarily useful for combining a token bucket based metering with an asynchronous packet shaper. Note that the asynchronous packet shaper also has parts in the network interface queue module.

EthernetFragmentingMacLayer compound module (no description)
EthernetLayer compound module (no description)
EthernetMacLayer compound module (no description)
EthernetPhyLayer compound module (no description)
EthernetPreemptingPhyLayer compound module (no description)
EthernetStreamingMacLayer compound module (no description)
Ieee8021qFilter compound module

This module implements the IEEE 802.1Q per-stream filtering and policing. The relationship between streams, gates and meters is not one-to-one. The number of streams, gates and meters can be different and the module will take care about the connections between the submodules based on the streamFilterTable parameter.

MultiPacketFilter compound module

This module combines multiple packet filters into one.

MultiPacketPolicing compound module

This module combines multiple packet policing modules into one.

PacketPolicing compound module

This module combines a packet meter and a packet filter into a packet policing module. The meter measures the packet flow that is passing through and attaches some meta information to the packets. The filter drops the packets that don't match the implemented filter criteria.

SimpleIeee8021qFilter compound module

This module implements a simplified version of the IEEE 802.1Q per-stream filtering and policing. Each filtered stream has its own path where metering and filtering happens independently of any other stream.

StreamFilterLayer compound module

This module combines two packet filters into a protocol layer so that it can be used in a layered compound module. There are separate submodules for ingress and egress traffic, but in most cases only the ingress filter is used.

StreamRelayLayer compound module

This module combines a stream merger and a stream splitter module into a stream relay layer. For incoming packets the identified streams are merged by the stream merger. For outgoing packets the requested streams are split by the stream splitter.

VlanPolicyLayer compound module (no description)

Known subclasses

Name Type Description
IProtocolHeaderChecker module interface (no description)

Extends

Name Type Description
IPacketFlow module interface

This module interface is implemented by packet flows. A packet flow connects one input to one output. It can operate in both active and passive mode. Packets can be pushed into its input or packets can be pulled from its output. Packets are never dropped but the contents and/or attached meta information may be altered.

Properties

Name Value Description
display i=block/filter
omittedTypename OmittedPacketFilter

Source code

//
// This module interface is implemented by packet filter modules. A packet filter
// connects one input to one output. It can operate in both active and passive
// mode. Packets can be pushed into its input or packets can be pulled from its
// output. Processed packets are either dropped, if they don't match the filter
// criteria, or they are passed through without any delay or reordering. Packets
// are not modified in any way.
//
moduleinterface IPacketFilter extends IPacketFlow
{
    parameters:
        @omittedTypename(OmittedPacketFilter);
        @display("i=block/filter");
}
File: src/inet/queueing/contract/IPacketFilter.ned