The test application ptltest is located in the directory,
This directory contains a few, very simple portal tests. They are independent of the underlying message transport system (e.g. Ethernet or Myrinet). All the tests are linked with ptltest which controls execution of the tests.
The tests work basically as follows; ptltest is run on a ``receiver'' node (typically a Cplant service node). It rsh's itself to a destination node which acts as a ``sender'' and that begins exchanging portals messages with the ``receiver''. ptltest contains 25 different tests, including a bandwidth test (no. 23).
Here are some examples on how to run ptltest, and a description of the options. The simplest way to run the tests is:
% ptltest -dnid <sender_node_name>
This runs all the test with default parameters between the current node and node <sender_node_name>. This can be modified with the following options.
-dnid <name> {-dnid <name> }
Mandatory option. Designates the remote (sending) node. The system() function and rsh are used to run a copy of ptltest on node <name>. The option can be repeated for multiple senders.
-list
Create a list of available tests and exit. A short description and the test number (to be used for -omit or -run) are provided.
-omit List
By default all tests are run. This option allows the user to not run some tests. List is of the form a,b,c,d..e,f,g..h where ``a'' through ``h'' represent test numbers. Instead of a list, -omit also accepts the keyword ``all'' to cancel all tests.
-run List
If a test has been disabled by the -omit option, it can be re-enabled with this option. For example
% ptltest -dnid node6 -omit all -run 2..5
runs only tests 2, 3, 4, and 5. Both -run and -omit can be repeated on the command line and are processed from left to right. Therefore, ``ptltest -dnid node6 -omit 0..10 -run 2..5 -omit 4..25 -run 10'' would execute tests 2, 3, and 10 (25 is currently the last test).
-length N
This option specifies the length (in 4 byte ints) of the test message for those tests that ship data around.
-repeat R
All the selected tests are repeated R times. If R is 0, ptltest runs for ever (or the node crashed, which ever occurs first).
-count C
or
-cnt C
Some tests (for example test 15 (loop) and test 25 (mtest)) take a count as an argument. These two options let a user modify the default count.
-v
Verbosity. Each test (sender and receiver) prints some diagnostic messages to the screen. The amount of output can be increased, by adding an optional parameter to -v. For example -v2 or -v5. There must be no space between the -v and the number. The higher the number, the more output.
All options can be abbreviated. -len is the same as -length. There are some ``hidden'' options (-sender, -rnid, -rpid, -rptl) that are used by ptltest internally (Don't try to use them!) Abbreviated options have to be unambiguous with respect to the other options, including the hidden ones.