ibmssh man page

ibmssh IB MANAGEMENT SIMULATOR — Extentended TCL shell

Description

ibmssh is a TCL shell extended with interface for the IB Management Simulator facilities. Normally you will not run this shell directly - but instead it will be invoked by the IBMgtSim utility. However, in order to write simulation flows that interacts closely with the simulated model, a simulation flow should be provided. This flow is loaded by IBMgtSim and excersize the API provided by this shell.

The following sub sections provide detailed definition for those objects and API.

IBMgtSim Constants

These constants are provided by IBMgtSim

Massage Manager Log Verbosity Flags

[ Constant : int ] $MsgShowFatal = 0x01

[ Constant : int ] $MsgShowError = 0x02

[ Constant : int ] $MsgShowWarning = 0x04

[ Constant : int ] $MsgShowInfo = 0x08

[ Constant : int ] $MsgShowVerbose = 0x10

[ Constant : int ] $MsgShowContext = 0x20

[ Constant : int ] $MsgShowSource = 0x40

[ Constant : int ] $MsgShowTime = 0x80

[ Constant : int ] $MsgShowModule = 0x100

[ Constant : int ] $MsgShowMads = 0x200

[ Constant : int ] $MsgShowFrames = 0x400

[ Constant : int ] $MsgShowAll = 0xffff

[ Constant : int ] $MsgDefault = 0x62f

Message Manager Objects

class msgManager

This is the Message Manager class

[ Member : returns int ] getVerbLevel ?module?

[ Member : returns int ] clrVerbLevel ?module?

[ Member : returns void ] setVerbLevel vl ?module?

[ Member : returns int ] outstandingMsgCount ?vl?

[ Member : returns string ] outstandingMsgs ?vl?

[ Member : returns string ] getNextMessage

[ Member : returns void ] nullOutstandingMsgs

[ Member : returns int ] setLogFile fileName

Random Manager Functions

[ returns float ] rmRand
obtain a random number in the range 0.0 - 1.0
[ returns int ] rmSeed seed
initialize the seed for the random manager

class ib_node_info_t

[ Member data: returns uint8_t * ] -base_version

[ Member data: returns uint8_t * ] -class_version

[ Member data: returns uint8_t * ] -node_type

[ Member data: returns uint8_t * ] -num_ports

[ Member data: returns ib_net64_t * ] -sys_guid

[ Member data: returns ib_net64_t * ] -node_guid

[ Member data: returns ib_net64_t * ] -port_guid

[ Member data: returns ib_net16_t * ] -partition_cap

[ Member data: returns ib_net16_t * ] -device_id

[ Member data: returns ib_net32_t * ] -revision

[ Member data: returns ib_net32_t * ] -port_num_vendor_id

class ib_switch_info_t

[ Member data: returns ib_net16_t * ] -lin_cap

[ Member data: returns ib_net16_t * ] -rand_cap

[ Member data: returns ib_net16_t * ] -mcast_cap

[ Member data: returns ib_net16_t * ] -lin_top

[ Member data: returns uint8_t * ] -def_port

[ Member data: returns uint8_t * ] -def_mcast_pri_port

[ Member data: returns uint8_t * ] -def_mcast_not_port

[ Member data: returns uint8_t * ] -life_state

[ Member data: returns ib_net16_t * ] -lids_per_port

[ Member data: returns ib_net16_t * ] -enforce_cap

[ Member data: returns uint8_t * ] -flags

class ib_port_info_t

[ Member data: returns ib_net64_t * ] -m_key
[ Member data: returns ib_net64_t * ] -subnet_prefix
[ Member data: returns ib_net16_t * ] -base_lid
[ Member data: returns ib_net16_t * ] -master_sm_base_lid
[ Member data: returns ib_net32_t * ] -capability_mask
[ Member data: returns ib_net16_t * ] -diag_code
[ Member data: returns ib_net16_t * ] -m_key_lease_period
[ Member data: returns uint8_t * ] -local_port_num
[ Member data: returns uint8_t * ] -link_width_enabled
[ Member data: returns uint8_t * ] -link_width_supported
[ Member data: returns uint8_t * ] -link_width_active
[ Member data: returns uint8_t * ] -state_info1
[ Member data: returns uint8_t * ] -state_info2
LinkSpeedSupported and PortState
[ Member data: returns uint8_t * ] -mkey_lmc
PortPhysState and LinkDownDefaultState
[ Member data: returns uint8_t * ] -link_speed
[ Member data: returns uint8_t * ] -mtu_smsl
LinkSpeedEnabled and LinkSpeedActive
[ Member data: returns uint8_t * ] -vl_cap
[ Member data: returns uint8_t * ] -vl_high_limit
VlCap and InitType

[ Member data: returns uint8_t * ] -vl_arb_high_cap

[ Member data: returns uint8_t * ] -vl_arb_low_cap

[ Member data: returns uint8_t * ] -mtu_cap

[ Member data: returns uint8_t * ] -vl_stall_life

[ Member data: returns uint8_t * ] -vl_enforce

[ Member data: returns ib_net16_t * ] -m_key_violations

[ Member data: returns ib_net16_t * ] -p_key_violations

[ Member data: returns ib_net16_t * ] -q_key_violations

[ Member data: returns uint8_t * ] -guid_cap

[ Member data: returns uint8_t * ] -subnet_timeout

[ Member data: returns uint8_t * ] -resp_time_value

[ Member data: returns uint8_t * ] -error_threshold

class ib_node_desc_t

[ Member data: returns uint8_array_t * ] -description
Node String is an array of UTF-8 character that describes the node in text format Note that this string is NOT NULL TERMINATED!

class ib_lft_record_t

[ Member data: returns ib_net16_t * ] -lid

[ Member data: returns ib_net16_t * ] -block_num

[ Member data: returns uint32_t * ] -resv0

[ Member data: returns uint8_array_t * ] -lft

class ib_pm_counters_t

[ Member data: returns ib_mad_t * ] -mad_header

[ Member data: returns uint32_array_t * ] -reserved0

[ Member data: returns uint8_t * ] -reserved1

[ Member data: returns uint8_t * ] -port_select

[ Member data: returns ib_net16_t * ] -counter_select

[ Member data: returns ib_net16_t * ] -symbol_error_counter

[ Member data: returns uint8_t * ] -link_error_recovery_counter

[ Member data: returns uint8_t * ] -link_down_counter

[ Member data: returns ib_net16_t * ] -port_rcv_errors

[ Member data: returns ib_net16_t * ] -port_rcv_remote_physical_errors

[ Member data: returns ib_net16_t * ] -port_rcv_switch_relay_errors

[ Member data: returns ib_net16_t * ] -port_xmit_discard

[ Member data: returns uint8_t * ] -port_xmit_constraint_errors

[ Member data: returns uint8_t * ] -port_rcv_constraint_errors

[ Member data: returns uint8_t * ] -reserved2

[ Member data: returns uint8_t * ] -lli_errors_exc_buf_errors

[ Member data: returns ib_net16_t * ] -reserved3

[ Member data: returns ib_net16_t * ] -vl15_dropped

[ Member data: returns ib_net32_t * ] -port_xmit_data

[ Member data: returns ib_net32_t * ] -port_rcv_data

[ Member data: returns ib_net32_t * ] -port_xmit_pkts

[ Member data: returns ib_net32_t * ] -port_rcv_pkts

[ Member data: returns uint32_array_t * ] -reserved5

IBMgtSim Simulator Objects

class IBMgtSim

[ Member : returns IBFabric * ] getFabric

[ Member : returns IBMSServer * ] getServer

[ Member : returns IBMSDispatcher * ] getDispatcher

[ Member : returns int ] init topoFileName serverPortNum numWorkers

class IBMSNode

[ Member : returns IBNode * ] getIBNode
get the IBNode of the IBMSNode
[ Member : returns int ] getLinkStatus outPortNum
get the link status of the given port
[ Member : returns int ] setPhyPortErrProfile portNum errProfileIn
set a particular port err profile
[ Member : returns int ] getPhyPortErrProfile portNum
get a particular port err profile
[ Member : returns int ] setPhyPortPMCounter portNum counterSelect countersVal
set a specific port counter
[ Member : returns ib_pm_counters_t * ] getPhyPortPMCounter portNum counterSelect get a specific port counter
[ Member : returns ib_port_info_t * ] getPortInfo portNum
get a specific port info
[ Member : returns int ] setLinkStatus portNum newState
set the Link status including sending trap128
[ Member : returns ib_node_info_t * ] getNodeInfo
get the node info
[ Member : returns ib_switch_info_t * ] getSwitchInfo
get the switch info
[ Member : returns ib_pkey_table_t * ] getPKeyTblBlock portNum blockNum
get pkey table block
[ Member : returns int ] setPKeyTblBlock portNum blockNum tbl
set pkey table block
[ Member : returns int ] setCrSpace startAddr length data
set CR Space Value
[ Member : returns int ] getCrSpace startAddr length data
get CR Space Value
[ Member : returns int ] getMFTBlock blockIdx portIdx
get MFT block
[ Member : returns int ] setMFTBlock blockIdx portIdx inMftBlock
set MFT block

class madMcMemberRec

[ Constructor: returns madMcMemberRec * ] madMcMemberRec name

[ Destructor: returns void ] rename obj {}

[ Member data: returns ib_gid_t * ] -mgid

[ Member data: returns ib_gid_t * ] -port_gid

[ Member data: returns ib_net32_t * ] -qkey

[ Member data: returns ib_net16_t * ] -mlid

[ Member data: returns uint8_t * ] -mtu

[ Member data: returns uint8_t * ] -tclass

[ Member data: returns ib_net16_t * ] -pkey

[ Member data: returns uint8_t * ] -rate

[ Member data: returns uint8_t * ] -pkt_life

[ Member data: returns ib_net32_t * ] -sl_flow_hop

[ Member data: returns uint8_t * ] -scope_state

[ Member : returns int ] send_set pFromNode fromPort destLid comp_mask

[ Member : returns int ] send_get pFromNode fromPort destLid comp_mask

[ Member : returns int ] send_del pFromNode fromPort destLid comp_mask

class madPathRec

[ Constructor: returns madPathRec * ] madPathRec name

[ Destructor: returns void ] rename obj {}

[ Member data: returns uint8_array_t * ] -resv0

[ Member data: returns ib_gid_t * ] -dgid

[ Member data: returns ib_gid_t * ] -sgid

[ Member data: returns ib_net16_t * ] -dlid

[ Member data: returns ib_net16_t * ] -slid

[ Member data: returns ib_net32_t * ] -hop_flow_raw

[ Member data: returns uint8_t * ] -tclass

[ Member data: returns uint8_t * ] -num_path

[ Member data: returns ib_net16_t * ] -pkey

[ Member data: returns ib_net16_t * ] -sl

[ Member data: returns uint8_t * ] -mtu

[ Member data: returns uint8_t * ] -rate

[ Member data: returns uint8_t * ] -pkt_life

[ Member data: returns uint8_t * ] -preference

[ Member data: returns uint8_array_t * ] -resv2

[ Member : returns int ] send_get pFromNode fromPort destLid comp_mask

class madServiceRec

[ Constructor: returns madServiceRec * ] madServiceRec name

[ Destructor: returns void ] rename obj {}

[ Member data: returns ib_net64_t * ] -service_id

[ Member data: returns ib_gid_t * ] -service_gid

[ Member data: returns ib_net16_t * ] -service_pkey

[ Member data: returns ib_net16_t * ] -resv

[ Member data: returns ib_net32_t * ] -service_lease

[ Member data: returns uint8_array_t * ] -service_key

[ Member data: returns uint8_array_t * ] -service_name

[ Member data: returns uint8_array_t * ] -service_data8

[ Member data: returns uint16_array_t * ] -service_data16

[ Member data: returns uint32_array_t * ] -service_data32

[ Member data: returns uint64_array_t * ] -service_data64

[ Member : returns int ] send_set pFromNode fromPort destLid comp_mask

[ Member : returns int ] send_get pFromNode fromPort destLid comp_mask

[ Member : returns int ] send_del pFromNode fromPort destLid comp_mask

class madNotice128

[ Constructor: returns madNotice128 * ] madNotice128 name
[ Destructor: returns void ] rename obj {}
[ Member data: returns uint8_t * ] -generic_type
[ Member data: returns uint8_t * ] -prod_type_msb
[ Member data: returns ib_net16_t * ] -prod_type_lsb
[ Member data: returns ib_net16_t * ] -trap_num
[ Member data: returns ib_net16_t * ] -issuer_lid
[ Member data: returns ib_net16_t * ] -toggle_count
[ Member data: returns ib_net16_t * ] -sw_lid
the sw lid of which link state changed - for 128 only

[ Member data: returns ib_gid_t * ] -issuer_gid

[ Member : returns int ] send_trap pFromNode fromPort destLid

class madNotice129

[ Constructor: returns madNotice129 * ] madNotice129 name
[ Destructor: returns void ] rename obj {}
[ Member data: returns uint8_t * ] -generic_type
[ Member data: returns uint8_t * ] -prod_type_msb
[ Member data: returns ib_net16_t * ] -prod_type_lsb
[ Member data: returns ib_net16_t * ] -trap_num
[ Member data: returns ib_net16_t * ] -issuer_lid
[ Member data: returns ib_net16_t * ] -toggle_count
[ Member data: returns ib_net16_t * ] -pad
[ Member data: returns ib_net16_t * ] -lid
lid and port number of the violation

[ Member data: returns uint8_t * ] -port_num

[ Member data: returns ib_gid_t * ] -issuer_gid

[ Member : returns int ] send_trap pFromNode fromPort destLid

class madNotice144

[ Constructor: returns madNotice144 * ] madNotice144 name
[ Destructor: returns void ] rename obj {}
[ Member data: returns uint8_t * ] -generic_type
[ Member data: returns uint8_t * ] -prod_type_msb
[ Member data: returns ib_net16_t * ] -prod_type_lsb
[ Member data: returns ib_net16_t * ] -trap_num
[ Member data: returns ib_net16_t * ] -issuer_lid
[ Member data: returns ib_net16_t * ] -toggle_count
[ Member data: returns ib_net16_t * ] -pad1
[ Member data: returns ib_net16_t * ] -lid
lid where capability mask changed
[ Member data: returns ib_net16_t * ] -pad2
[ Member data: returns ib_net32_t * ] -new_cap_mask
new capability mask

[ Member data: returns ib_gid_t * ] -issuer_gid

[ Member : returns int ] send_trap pFromNode fromPort destLid

Author

Eitan Zahavi, Mellanox Technologies LTD, eitan@mellanox.co.il

Info

2008-06-16 IBMGTSIM 1.0 IB MANAGEMENT SIMULATOR