ipx
ipx - configure the IPX parameters for a port on a card on a chassis
SYNOPSIS
ipx sub-command options
DESCRIPTION
The ipx command is used to configure the IPX-specific information used when building IPX-type packets if the protocol config-name has been set to ipx. Note that stream get must be called before this command's get sub-command.
STANDARD OPTIONS
destNetwork
The network number of the network to which the destination node belongs. (default = {00 00 00 00})
destNetworkCounter
Mode
Specifies how the destination network address is incremented or decremented. Possible values include:
Option |
Value |
Usage |
---|---|---|
ipxIdle |
0 |
(default) no change to network address regardless of destNetworkRepeatCounter |
ipxIncrement |
1 |
increment the network address for as many destNetworkRepeatCounter specified |
ipxDecrement |
2 |
decrement the network address for as many destNetworkRepeatCounter specified |
ipxContIncrement |
3 |
Continuously increment the network address for each frame |
ipxContDecrement |
4 |
Continuously decrement the network address for each frame |
ipxCtrRandom |
5 |
Generate random destination network address for each frame |
destNetworkMask
Select
Selects the bits in the 32-bit destination network address that are to be masked by the value set by destNetworkMaskValue. (default = 00 00 00 00)
destNetworkMaskValue
Value of the masked bits selected by destNetworkMaskSelect in the destination network address. (default = FF FF FF FF)
destNetworkRepeat
Counter
Number of destination network addresses the stream is going to be transmitted to. (default = 1)
destNode
The physical address of the destination node. (default = 00 00 00 00 00 00)
destNodeCounterMode
Specifies how the destination node is incremented or decremented. Note: Setting the destNodeCounterMode other then ipxIdle takes over one of the available UDFs. Possible values include:
Option |
Value |
Usage |
---|---|---|
ipxIdle |
0 |
(default) no change to node regardless of destNodeRepeatCounter |
ipxIncrement |
1 |
increment the node for as many destNodeRepeatCounter specified |
ipxDecrement |
2 |
decrement the node for as many destNodeRepeatCounter specified |
ipxContIncrement |
3 |
Continuously increment the node for each frame |
ipxContDecrement |
4 |
Continuously decrement the node for each frame |
ipxCtrRandom |
5 |
Generate random destination node for each frame |
destNodeMaskSelect
Selects the bits in the 48-bit destination node address that are to be masked by the value set by destNodeMaskValue. (default = 00 00 00 00 00 00)
destNodeMaskValue
Value of the masked bits selected by destNodeMaskSelect in the destination node. (default = FF FF FF FF FF FF)
destNodeRepeat
Counter
Number of destination nodes the stream is going to be transmitted to. (default = 1)
destSocket
The socket address of the packet's destination process. (default = 0x4000) Well defined addresses include:
Option |
Value |
Usage |
---|---|---|
socketNcp |
1105-0x0451 |
|
socketSap |
1106-0x0452 |
|
socketRipx |
1107-0x0453 |
|
socketNetBios |
1109-0x0455 |
|
socketDiagnostics |
1110-0x0456 |
|
socketSerialization |
1111-0x0457 |
|
destSocketCounter
Mode
Specifies how the destination socket is incremented or decremented. Note: Setting the destSocketCounterMode other then ipxIdle takes over one of the available UDFs. Possible values include:
Option |
Value |
Usage |
---|---|---|
ipxIdle |
0 |
(default) no change to socket regardless of destSocketRepeatCounter |
ipxIncrement |
1 |
increment the socket for as many destSocketRepeatCounter specified |
ipxDecrement |
2 |
decrement the socket for as many destSocketRepeatCounter specified |
ipxContIncrement |
3 |
Continuously increment the socket for each frame |
ipxContDecrement |
4 |
Continuously decrement the socket for each frame |
ipxCtrRandom |
5 |
Generate random destination socket for each frame |
destSocketMaskSelect
Selects the bits in destination socket address that are to be masked by the value set by destSocketMaskValue. (default = 00 00 )
destSocketMaskValue
Value of the masked bits selected by destSocketMaskSelect in the destination socket. (default = FF FF)
destSocketRepeat
Counter
Number of destination sockets the stream is going to be transmitted to. (default = 1)
length
The length of the IPX header plus the length of the data. (default = 0)
lengthOverride
true/false
Allows to change the length in ipx header. (default = false)
packetType
This field indicates the type of service offered or required by the packet. Possible values include:
|
|
|
---|---|---|
typeUnknown |
0-0x00 |
Used for all packets not classified by any other type. |
typeRoutingInfo |
1-0x01 |
Routing Information Packet. |
typeEcho |
2-0x02 |
Echo |
typeError |
3-0x03 |
Error |
typeIpx |
4-0x04 |
(default) Service Advertising Packet. |
typeSpx |
5-0x05 |
Used for sequenced packets. |
typeNcp |
17-0x11 |
Used for NetWare Core Protocol Packets. |
typeNetBios |
20-0x14 |
Used for Novell netBIOS. |
typeNdsNcp |
104-0x68 |
Used for NetWare Core Protocol Packets. |
sourceNetwork
The network number of the network to which the source node belongs. (default = 00 00 00 00)
sourceNetwork
CounterMode
Specifies how the source network address is incremented or decremented. Note: Setting the sourceNetworkCounterMode other then ipxIdle takes over one of the available UDFs. Possible values include:
Option |
Value |
Usage |
---|---|---|
ipxIdle |
0 |
(default) no change to network address regardless of sourceNetworkRepeatCounter |
ipxIncrement |
1 |
increment the network address for as many sourceNetworkRepeatCounter specified |
ipxDecrement |
2 |
decrement the network address for as many sourceNetworkRepeatCounter specified |
ipxContIncrement |
3 |
Continuously increment the network address for each frame |
ipxContDecrement |
4 |
Continuously decrement the network address for each frame |
ipxCtrRandom |
5 |
Generate random source network address for each frame |
sourceNetworkMask
Select
Selects the bits in the 32-bit source network address that are to be masked by the value set by sourceNetworkMaskValue. (default = 00 00 00 00)
sourceNetwork
MaskValue
Value of the masked bits selected by sourceNetworkMaskSelect in the source network address. (default = FF FF FF FF)
sourceNetworkRepeat
Counter
Number of source network addresses the stream is going to be transmitted to. (default = 1)
sourceNode
The physical address of the source node. (default = 00 00 00 00 00 00)
sourceNodeCounter
Mode
Specifies how the source node is incremented or decremented. Note: Setting the sourceNodeCounterMode other then ipxIdle takes over one of the available UDFs. Possible values include:
Option |
Value |
Usage |
---|---|---|
ipxIdle |
0 |
(default) no change to node regardless of sourceNodeRepeatCounter |
ipxIncrement |
1 |
increment the node for as many sourceNodeRepeatCounter specified |
ipxDecrement |
2 |
decrement the node for as many sourceNodeRepeatCounter specified |
ipxContIncrement |
3 |
Continuously increment the node for each frame |
ipxContDecrement |
4 |
Continuously decrement the node for each frame |
ipxCtrRandom |
5 |
Generate random source node for each frame |
sourceNodeMaskSelect
Selects the bits in the 48-bit source node address that are to be masked by the value set by sourceNodeMaskValue. (default = 00 00 00 00 00 00)
sourceNodeMaskValue
Value of the masked bits selected by sourceNodeMaskSelect in the source node. (default = FF FF FF FF FF FF)
sourceNodeRepeat
Counter
Number of source nodes the stream is going to be transmitted to. (default = 1)
sourceSocket
The socket address of the packet's source process. (default = 0x4000) Well known addresses include:
Option |
Value |
Usage |
---|---|---|
socketNcp |
1105-0x0451 |
|
socketSap |
1106-0x0452 |
|
socketRipx |
1107-0x0453 |
|
socketNetBios |
1109-0x0455 |
|
socketDiagnostics |
1110-0x0456 |
|
socketSerialization |
1111-0x0457 |
|
sourceSocketCounter
Mode
Specifies how the source socket is incremented or decremented. Note: Setting the sourceSocketCounterMode other then ipxIdle takes over one of the available UDFs. Possible values include:
Option |
Value |
Usage |
---|---|---|
ipxIdle |
0 |
(default) no change to socket regardless of sourceSocketRepeatCounter |
ipxIncrement |
1 |
increment the socket for as many sourceSocketRepeatCounter specified |
ipxDecrement |
2 |
decrement the socket for as many |
ipxContIncrement |
3 |
Continuously increment the socket for each frame sourceSocketRepeatCounter specified |
ipxContDecrement |
4 |
Continuously decrement the socket for each frame |
ipxCtrRandom |
5 |
Generate random source socket for each frame |
sourceSocketMask
Select
Selects the bits in source socket address that are to be masked by the value set by sourceSocketMaskValue. (default = 00 00)
sourceSocket
MaskValue
Value of the masked bits selected by sourceSocketMaskSelect in the source socket. (default = FF FF)
sourceSocketRepeat
Counter
Number of source sockets the stream is going to be transmitted to. (default = 1)
svrClientType
This allows the port to act either as a NetWare server or client. If set to server, then the port may send out SAP broadcasts to announce itself. Possible values include:
Option |
Value |
Usage |
---|---|---|
server |
1 |
|
client |
2 |
(default) |
transportControl
The number of routers that the packet has passed through. (default = 0)
COMMANDS
The ipx command is invoked with the following sub-commands. If no sub-command is specified, returns a list of all sub-commands available.
ipx cget option
Returns the current value of the configuration option given by option. Option may have any of the values accepted by the ipx command.
ipx config option value
Modify the IPX configuration options of the port. If no option is specified, returns a list describing all of the available IPX options (see STANDARD OPTIONS) for port.
ipx decode capFrame [chasID cardID portID]
Decodes a captured frame in the capture buffer and updates TclHal. ipx cget option command can be used after decoding to get the option data. Specific errors are:
- No connection to a chassis
- Invalid port number
- The captured frame is not a valid IPX frame
ipx get chasID cardID portID
Gets the current configuration of the ipx object for port with id portID on card cardID, chassis chasID from its hardware and sets the ipx class members with the current data. Note that stream get must be called before this command's get sub-command. Specific errors are:
- No connection to a chassis
- Invalid port number
ipx set chasID cardID portID
Sets the IPX configuration of the port with id portID on card cardID, chassis chasID by reading the configuration option values set by the ipx config option value command. Specific errors are:
- No connection to a chassis
- Invalid port number
- The port is being used by another user
- The configured parameters are not valid for this port
ipx 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
}
stream setDefault
protocol setDefault
protocol config -name ipx
protocol config -ethernetType ethernetII
ipx setDefault
ipx config -destNetwork {00 00 00 02}
ipx config -destNetworkCounterMode ipxIdle
ipx config -sourceNetwork {00 00 00 01}
ipx config -sourceNetworkCounterMode ipxIdle
ipx config -destNode {00 00 00 01 00 00}
ipx config -destNodeRepeatCounter 16
ipx config -destNodeCounterMode ipxDecrement
ipx config -sourceNode {00 00 00 00 00 00}
ipx config -sourceNodeRepeatCounter 16
ipx config -sourceNodeCounterMode ipxIncrement
ipx config -destSocket 5
ipx config -sourceSocket 4
ipx set $chas $card $port
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
}