ompi-top (1) Linux Manual Page
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.
Synopsis
ompi-top [ options ]Options
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.