ompi-top, orte-top - Diagnostic to provide process info similar to the popular
"top" program.
NOTE: ompi-top, and orte-top are exact
synonyms for each other. Using any of the names will result in exactly
identical behavior.
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.