protocol

protocol - configure the type of protocol to use for running the tests.

SYNOPSIS

protocol sub-command options

DESCRIPTION

This command allows to select the ethernet frame type and protocol type to use when building data packets or running a test.

Note: To set these values in IxHal and to commit them to the hardware use stream set and stream write.

STANDARD OPTIONS
appName

The application running on top of IP. These are applications may be layer 3 or 5 and others that cannot be directly set in the IP header. To use layer 4 applications such as UDP and TCP, use ip config -ipProtocol command. Available options are:

Option

Value

Usage

Udp

5

Tests UDP protocol

Arp

8

Tests ARP protocol

Rip

11

Tests RIP protocol

Dhcp

13

Tests DHCP protocol

SrpDiscovery

41

Tests SRP Discovery protocol

SrpArp

42

Tests SRP ARP protocol

SrpIps

43

Tests SRP IPS protocol

RprTopology

47

Tests RPR Topology protocol

RprProtection

48

Tests RPR Protection protocol

RprOam

49

Tests RPR OAM protocol

Ptp

72

Precision Time Protocol

enable802dot1qTag true/false

Sets the type of 802.1q Vlan tagged frame insertion.

Option

Value

Usage

vlanNone

0

(default) No VLANs used.

vlanSingle

1

A single VLAN specification is used.

vlanStacked

2

Two or more VLANs in a stack are used, as set in the stackedVlan command.

enableCMD true/false

Enable Cisco Metadata tagged frame insertion. (default = false)

enableDataCenterEncapsulation true/false

Enable Data Center Encapsulation option. (default = false)

enableISLtag true/false

Enable Cisco ISL tagged frame insertion. (default = false)

enableMacSec

true/false

Enable MacSec frame insertion in streams. (default = false)

enableMPLS true/false

Enable MPLS Tagged frame insertion. (default = false)

enableOAM

true/false

Enable OAM frame insertion in streams. (default = false)

enableProtocolPad true/false

If true, enables Protocol Pad.

ethernetType

The type of ethernet frame selected. Options include:

Option

Value

Usage

noType

0

(default)

ethernetII

1

Ethernet II type of ethernet frame selected

ieee8023snap

2

IEEE8023 snap type of ethernet frame selected

ieee8023

3

IEEE8023 type of ethernet frame selected

ieee8022

15

IEEE8022 type of ethernet frame selected

protocolOffsetType

53

The protocol offset type of ethernet frame selected

name

The name of the protocol selected. Options include:

Option

Value

Usage

mac

0

MAC layer 2. During the learn process, simple MAC frames that contain the MAC address of the receive ports is transmitted to allow the switch to learn the ports (default)

ip

4

Uses an IP version 4 header in the frame, see ip command set. If name is set to ip, during the learn process ARP frames from both the transmit and receive ports is sent to DUT. From the ARP frames, the DUT learns the IP address of the attached Ixia ports and the Ixia ports learns the MAC address of the DUT port.

ipV4

4

same as ip above.

ipx

7

Uses an IPX header in the frame, see ipx command set. During the learn process, RIPx frames both the transmit and receive ports is sent to DUT so it may learn the network address of the attached ports and so that the transmit ports may learn the MAC address of the attached DUT port.

pauseControl

12

Pause control protocol. See pauseControl for details on setting up a pause control packet.

ipV6

31

Uses an IP version 6 header in the frame.

fcoe

68

Uses an FCoE header in the frame.

nativeFc

74

Uses an Fibre Channel header in the frame.

DEPRECATED

STANDARD OPTIONS
dutStripTag true/false

 

COMMANDS

The protocol command is invoked with the following sub-commands. If no sub-command is specified, returns a list of all sub-commands available.

protocol cget option

Returns the current value of the configuration option given by option. Option may have any of the values accepted by the protocol command.

Note: Call command stream get chasID cardID portID streamID before calling protocol cget option value to get the value of the configuration option.

protocol config option value

Modify the configuration options of the port. If no option is specified, returns a list describing all of the available options (see STANDARD OPTIONS) for port.

protocol setDefault

Sets to IxTclHal default values for all configuration options.

EXAMPLES

package require IxTclHal

 

set host localhost

set username user

# Check if we're running on UNIX - connect to the TCL Server

# which must be running on the chassis

if [isUNIX] {

if [ixConnectToTclServer $host] {

ixPuts "Could not connect to $host"

return 1

}

}

 

# Now connect to the chassis

if [ixConnectToChassis $host] {

ixPuts $::ixErrorInfo

return 1

}

 

# Get the chassis ID to use in port lists

set chas [ixGetChassisID $host]

 

set card 1

set port 1

set portList [list [list $chas $card $port]]

# Login before taking ownership

if [ixLogin $username] {

ixPuts $::ixErrorInfo

return 1

}

# Take ownership of the ports we'll use

if [ixTakeOwnership $portList] {

ixPuts $::ixErrorInfo

return 1

}

 

# Set to ethernet II and ipV4

protocol setDefault

protocol config -name ipV4

protocol config -ethernetType ethernetII

 

# Protocol values are saved via the stream command

stream set $chas $card $port 1

 

ixWriteConfigToHardware portList

 

# Let go of the ports that we reserved

ixClearOwnership $portList

# Disconnect from the chassis we're using

ixDisconnectFromChassis $host

# If we're running on UNIX, disconnect from the TCL Server

if [isUNIX] {

ixDisconnectTclServer $host

}

 

SEE ALSO

stream, ip, ipx, protocolOffset.