Raw Transport

The Raw Transport uses a specified network interface as the emulation boundary entry/exit point.

Features

The Raw Transport emulation boundary provides the following set of features: Network Interface Raw Read/Write, Virtual Transport Interoperability, Bitrate Enforcement, Broadcast Only Mode, and IPv4 and IPv6 Capable.

Network Interface Raw Read/Write

The Raw Transport uses a specific network interface as the emulation boundary entry/exit point. The network interface can be a physical interface, virtual interface, tunnel, etc. The interface is managed external to the Raw Transport.

Any traffic read from the interface will be delivered to the Raw Transport’s respective NEM for emulation processing.

Virtual Transport Interoperability

The Raw Transport supports interoperability with Virtual Transport emulation boundaries using ARP caching to learn IP network to NEM Id associations.

Bitrate Enforcement

The Raw Transport supports bitrate enforcement for use with models that do not limit bitrate based on emulation implementation. Set the configuration parameter bitrate to the desired rate in bps to enable bitrate enforcement or 0 to disable.

Broadcast Only Mode

The Raw Transport supports forced NEM broadcasting of all IP packet types: unicast, broadcast and multicast. Set the configuration parameter broadcastmodeenable to true to enable broadcast only mode.

IPv4 and IPv6 Capable

The Raw Transport supports IPv4 and IPv6 packet processing.

Configuration

arpcacheenable: Enable ARP request/reply monitoring to map Ethernet address to NEM.

Default: yes                   Required: no                    Modifiable: no                  
Type:    bool                  Occurrs:  [1,1]                 Range:      [false,true]        
Values:  true

bitrate: Transport bitrate in bps. This is the total allowable throughput for the transport combined in both directions (upstream and downstream). A value of 0 disables the bitrate feature.

Default: yes                   Required: no                    Modifiable: no                  
Type:    uint64                Occurrs:  [1,1]                 Range:      [0,max_uint64]      
Values:  0

broadcastmodeenable: Broadcast all packets to all NEMs.

Default: yes                   Required: no                    Modifiable: no                  
Type:    bool                  Occurrs:  [1,1]                 Range:      [false,true]        
Values:  false

device: Device to use as the raw packet entry point.

Default: no                    Required: no                    Modifiable: no                  
Type:    string                Occurrs:  [1,1]

ethernet.type.arp.priority: Defines the emulator priority value (DSCP used for IP) to use when an ARP Ethernet frame is encountered during downstream processing.

Default: yes                   Required: no                    Modifiable: no                  
Type:    uint8                 Occurrs:  [1,1]                 Range:      [0,255]             
Values:  0

ethernet.type.unknown.priority: Defines the emulator priority value (DSCP used for IP) to use when the specified unknown Ethernet type is encountered during downstream processing. Uses the following format:

<ethernet type>:<priority>
```
Default: no                    Required: no                    Modifiable: no                  
Type:    string                Occurrs:  [0,65535]           
Regex:   ^(0[xX]){0,1}\d+:\d+$
```

Statistics

avgProcessAPIQueueDepth: Average API queue depth for a processUpstreamPacket, processUpstreamControl, processDownstreamPacket, processDownstreamControl, processEvent and processTimedEvent.
```
Type: double                Clearable: yes                 
```
avgProcessAPIQueueWait: Average API queue wait for a processUpstreamPacket, processUpstreamControl, processDownstreamPacket, processDownstreamControl, processEvent and processTimedEvent in microseconds.
```
Type: double                Clearable: yes                 
```
avgTimedEventLatency: Average latency between the scheduled timer expiration and the actual firing over the requested duration.
```
Type: double                Clearable: yes                 
```
avgTimedEventLatencyRatio: Average ratio of the delta between the scheduled timer expiration and the actual firing over the requested duration. An average ratio approaching 1 indicates that timer latencies are large in comparison to the requested durations.
```
Type: double                Clearable: yes                 
```

numAPIQueued: The number of queued API events.

Type: uint64                Clearable: yes

processedConfiguration: The number of processed configuration.

Type: uint64                Clearable: yes

processedDownstreamControl: The number of processed downstream control.

Type: uint64                Clearable: yes

processedDownstreamPackets: The number of processed downstream packets.

Type: uint64                Clearable: yes

processedEvents: The number of processed events.

Type: uint64                Clearable: yes

processedTimedEvents: The number of processed timed events.

Type: uint64                Clearable: yes

processedUpstreamControl: The number of processed upstream control.

Type: uint64                Clearable: yes

processedUpstreamPackets: The number of processed upstream packets.

Type: uint64                Clearable: yes

Statistic Tables

EventReceptionTable: Received event counts
```
Clearable:  yes
```