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.