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:

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:

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:

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

}

 

SEE ALSO

stream, protocol, ip, udp.