Initialization functions

FM initialization is performed with the following functions:

Function: void FM_initialize (void)

Initialize the local FM system. Initializes variables, downloads the LANai control program (LCP), establishes a deadlock-free route from every machine to every other machine, allocates memory for the following vector:

Variable: extern FM_handler ** FM_handler_table

An array of pointers to handlers. Allocated by FM_initialize() using a size specified by FM_set_parameter() (or a default).

assigns values to the following scalars:

Variable: ULONG FM_nodeid

The local node's node number.

Variable: ULONG FM_numnodes

The number of nodes in the system (as taken from the network configuration file).

and performs a barrier synchronization with all nodes listed in the network configuration file.

Function: void FM_set_parameter (int parameter, ...)

Set an initialization parameter. If used, call must precede call to FM_initialize(). May be called multiple times, with different parameters. Parameters currently supported are:

FM_CONFIG_FILE filename

Specify the name of the network configuration file. Overrides the environment variable FMCONFIGFILE. [Default: `fmconfig']

FM_ABSOLUTE_SWITCHES

Tell FM to assume absolute-addressed Myrinet switches. Mutually exclusive with FM_RELATIVE_SWITCHES. [Default: not set]

FM_RELATIVE_SWITCHES

Tell FM to assume relative-addressed Myrinet switches. Mutually exclusive with FM_ABSOLUTE_SWITCHES. [Default: set]

FM_LCP_FILE filename

Specify the name of the LCP file. Should end in `.dat' for the LANai 2.3 boards, no extension for the 32-bit LANais. Overrides the environment variable FMLCPFILE. [Default: `lcp.dat']

FM_QUIET_START

Suppress the `Synchronizing with other nodes...' message on startup. [Default: not set]

FM_UNIT_NUMBER number

Specify which Myrinet device to use if there is more than one Myrinet board in a machine. Overrides the environment variable `FMUNITNUMBER'. [Default: 0]

FM_MAX_HANDLERS number

Designate the maximum number of handler functions the process can contain (i.e. the size of the FM_handler_table[] array). [Default: 1024]

Go to the first, previous, next, last section, table of contents.