PM/Ethernet-HXB Configuration File Format

PM-II ETHERNET-HXB CONF(5)

FILE FORMATS

PM-II ETHERNET-HXB CONF(5)

NAME: PM/Ether-HXB Configuration File Format
Description

There are two kinds of file format to use PM/Ethernet-HXB。

File specified by -config option: To use general control parameter and dimension setting for nodes
File specified by -trunk[0123] option: To specify for a Ethernet device. This file is able to be made by adding three parameters to PM/Ethernet configuration file

Each line of the PM/Ethernet-HXB configuration files specify mapping from node number to hostname and IP address.
A single '#' character indicates that the rest of the line is a comment, and to be ignored.

FIle spicified by -config option:

Notation of a node
```
NodeNumber     Dimension address (x.y.z)   Hostname
```
NodeNumber
Node number of PM/Ethernet-HXB. An integer starting from zero.
This number doesn't have to be the same as the node number of this host on another PM network interface.
Dimension address
Dimention address for three dimension hyper-crossbar network of the host. An example of the syntax is 0.0.0
Hostname
Host name of the host. This name should be exactly the same as the name which the hostname command returns. PM/Ethernet-HXB itself doesn't depend on this constraint, thus, the pmtest command doesn't detect a problem about this, but upper-level software depends on this.
Example:
0 0.0.0 xxx.yyy.xxx
Notation of interface unit number
```
unit     unit_number
```
Specify unit number of this configuration.
Example:
unit 0
Notation of checksum option
```
checksum     0(off) or 1(on)    
```
Enable data checksum. If you application fails or results of caliculateion is wrong. Set this value 1, and re-run your application. If data checksum error occur, the error is showed by /proc/pm/ethernet/[ethernet-unit-num]/info. In some sitiation, we found a checksum error on NIC DMA(sending or receiving).
Example:
checksum 1
Notation of maxnsend option
```
maxnsend      8 - 32    
```
Define number of sending packets at a time. When you use network trunking, you should increase this parameter from default value.
Example:
maxnsend 16

EXAMPLE

This is an example of a PM/Ethernet-HXB configuration file specified by -config option. In this example, four hosts: comp0, comp1, comp2 and comp3 are connected.

#
# Sample configuration file
#
unit	0
#
# Node specification
#  NodeNumber  	Dimension address		Hostname                
0  		0.0.0      			comp0.pccluster.org
1              	1.0.0				comp1.pccluster.org
2               2.0.0				comp2.pccluster.org  
3               3.0.0				comp3.pccluster.org

File spicified by -trunk option: This file can be created by adding the three parameters (dev, chan, and slot) to PM-Ethernet configuration file

Notation of a node
```
NodeNumber     MAC address   Hostname
```
NodeNumber
Node number of PM/Ethernet. An integer starting from zero.
This number doesn't have to be the same as the node number of this host on another PM network interface.
MAC address
MAC address of the host. An example of the syntax is 00:60:08:F5:C5:5B.
Hostname
Host name of the host. This name should be exactly the same as the name which the hostname command returns. PM/Ethernet itself doesn't depend on this constraint, thus, the pmtest command doesn't detect a problem about this, but upper-level software depends on this.
Example:
0 00:00:12:23:34:45 xxx.yyy.xxx
Notation of dev option
```
dev     eth[012...]    
```
The dev option specifies a Ethernet device used by this file
Example:
dev eth0
Notation of chan option
```
chan     0 -- 2    
```
The chan option specifies a dimension channel number used by this file. The channel number is mapped as follows:
```
 
  0 	X-dimension
  1 	Y-dimension
  2 	Z-dimension
```
Example:
chan 0
Notation of slot option
```
slot     0 -- 7    
```
The slot option specifies a number of trunked number used by this file. The slot is used as trunking slot to realize multiple parallel communication using Ethernet devices.
Example:
slot 0

Expample

This is an example of a PM/Ethernet-HXB configuration file specified by -trunk option. In this example, four hosts: comp0, comp1, comp2 and comp3 are connected.

#
# Sample configuration file
#
dev 	eth0
chan	0
slot	0

#
# Node specification
#  NodeNumber  	MAC address		Hostname                
0  		00:00:f3:51:03:00      	comp0.pccluster.org
1              	00:00:f3:51:03:01	comp1.pccluster.org
2               00:00:f3:51:03:02	comp2.pccluster.org  
3               00:00:f3:51:03:03	comp3.pccluster.org

NOTES

This configuration file can be created by editting the file using mkpmethernetconf(8).

SEE ALSO

mkpmethernetconf(8)