ompi-top collects
and displays process information in a manner similar to that of the popular
"top" program.

-h | --help

Display help for this command

-pid | --pid <value>

The
pid of the mpirun whose processes you want information about, or the name
of the file (specified as file:filename) that contains that info. Note that
the ompi-top command must be executed on the same node as mpirun to use
this option.

-uri | --uri <value>

Specify the URI of the mpirun whose processes
you want information about, or the name of the file (specified as file:filename)
that contains that info. Note that the ompi-top command does not have to
be executed on the same node as mpirun to use this option.

-rank | --rank
<value>

The rank of the processes to be monitored. This can consist of a single
rank, or a comma-separated list of ranks. These can include rank ranges separated
by a ’-’. If this option is not provided, or a value of -1 is given, ompi-top
will default to displaying information on all ranks.

-bynode | --bynode

Display
the results grouped by node, with each node’s processes reported in rank
order. If this option is not provided, ompi-top will default to displaying
all results in rank order.

-update-rate | --update-rate <value>

The time (in seconds)
between updates of the displayed information. If this option is not provided,
ompi-top will default to executing only once.

-timestamp | --timestamp

Provide
an approximate time when each sample was taken. This time is approximate
as it only shows the time when the sample command was issued.

-log-file
| --log-file <value>

Log the results to the specified file instead of displaying
them to stdout.

ompi-top collects and displays process information
in a manner similar to that of the popular "top" program. It doesn’t do the
fancy screen display, but does allow you to monitor available process information
(to the limits of the underlying operating system) of processes irrespective
of their location.