NAME

mesh_mapper - generate myrinet map and routes for any regular N dimention mesh.


MODULE

myrinet


SYNOPSIS

mesh_mapper [--help] [--conf configfile] [--macfile file] [--hostinfo|--switchinfo|--hostfile|--map|--route|--allfiles] [--from nodenum] [--to nodenum] [--debug N]


DESCRIPTION

Three files are required when using the GM file mapper, (mapper.hosts, mapper.map, mapper.routes) the last of which is also used to configure a myrinet card when using Cplant(tm) runtime environment. The mesh_mapper will generate these files for "any" regular N dimention mesh topology.

mesh_mapper can also generate additional info files which may be helpful in debugging your configuration or troubleshooting myrinet problems.

The map and routes are generated based on a configuration file, by default it is mapper.conf.pl, but you can specify it with the --conf option. See the example file for more information on setting up your configuration. If the --conf optoin is not given, the mapper.conf.pl file is searched for in the /cluster/lib/Myrimap and then in the current directory.


OPTIONS

--help Print this manpage.

--conf configfile Use the specified config file. By default "mapper.conf.pl" in /cluster/lib/Myrimap or in the current directory is used.

--macfile file Import MAC addresses from external file when creating map. See NOTES section for format of this file.

--hostinfo <file> Only print host debugging info. Prints to STDOUT unless filename specified.


--switchinfo <file>
  Only print switch debugging info.  Prints to STDOUT unless filename specified.

--hostfile <file>
  Only print E<quot>mapper.hostsE<quot> file.  Prints to STDOUT unless filename specified.

--map <file>
  Only print E<quot>mapper.mapE<quot> file.  Prints to STDOUT unless filename specified.

--route <file>
  Only print E<quot>mapper.routesE<quot> file.  Prints to STDOUT unless filename specified.

--allfiles <fileprefix>
  Generate all five files.  If no prefix is given, names are E<quot>my.?E<quot> in the current directory.  Prefix can be full path, or just something to prepend to the filenames.

--from nodenum Restrict route generation to only routes with "nodenum" as the source node.

--to nodenum Restrict route generation to only routes with "nodenum" as the destination node.

--debug N Print additional debugging info. (N = 1 to 5)


NOTES

The MAC file is simply a list of hostname/mac address pairings. All lines are read, there are no comments. Any of the following forms are OK for entries in the MAC file:

        E<quot>if-0.n-0.r-13E<quot> A528345878B2
        if-0.n-1.r-13 b5285f7097b2
        E<quot>if-0.n-2.r-13E<quot> C5:34:58:70:98:B2
        E<quot>if-0.n-3.r-13E<quot> D5.28.08.70.98.B2


FILES

  mapper.conf.pl


SEE ALSO

  run.mapper