xenial (1) ompi-top.1.gz

Provided by: openmpi-bin_1.10.2-8ubuntu1_amd64 bug

NAME

       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.

DESCRIPTION

       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.

SEE ALSO