Difference between revisions of "Mosps"

Latest revision as of 10:44, 22 February 2009

MOSPS(M1)                       MOSIX Commands                     MOSPS(M1)
 
NAME
    MOSPS - List information about MOSIX processes
 
SYNOPSIS
    mosps [subset of ps(1) options] [-I] [-h] [-M] [-L] [-O] [-n] [-P] [-V]
          [-D] [-S] [-J{JobID}]
 
          Supported ps(1) options:
 
          1. single-letter options:           TUacefgjlmnptuwx
          2. single-letters preceded by '-':  -AGHNTUadefgjlmptuwx
 
DESCRIPTION
    Mosps lists MOSIX processes in "ps" style, emphasizing MOSIX-related
    information, see the ps(1) manual about the standard options of ps.
    Since some of the information in the ps(1) manual is irrelevant, mosps
    does not display the following fields: %CPU, %MEM, ADDR, C, F, PRI, RSS,
    S, STAT, STIME, SZ, TIME, VSZ, WCHAN.
 
    Instead, mosps can display the following:
 
    WHERE    where is the process running.
             Special values: "here" - this node; "queue" - not yet started;
             "Mwait" - the process was started with mosrun -b and is waiting
             for a suitable node to start on; "Bwait" - the batch job was
             started with mosrun -b and is waiting for a suitable node to
             start on.
    FROM     where is the process' home-node.
             Special value: "here" - this node;
    CLASS    the class of the process (see mosrun(1)).
             Special values: "native" - exited MOSIX using the native util-
             ity; "batch" - a batch job (started with mosrun -E or mosrun
             -M).
    ORIGPID  the original process ID in the process' home-node (in the case
             of guest batch jobs, several processes from the same guest batch
             job may share the same PID).  "N/A" when the home/sending-node
             is here.
    FRZ      Freezing status:
             -    not frozen
             A    automatically frozen
             E    frozen due to being expelled back to the home/cluster
             P    preempted (by an external program)
             M    manually frozen
             N/A  cannot be frozen (batch, native or guest)
    NMIGS    the number of times the process (or its MOSIX ancesstors before
             it was forked) had migrated so far ("N/A" for guest, batch and
             native processes).
 
    Normally, if the nodes in the WHERE and FROM fields are listed in
    /etc/mosix/userview.map, then they are displayed as node-numbers: other-
    wise as IP addresses.  The -I argument forces all nodes to be displayed
    as IP addresses and the -h argument forces all nodes to be displayed as
    host-names (when the host-name can be found, otherwise as an IP address).
    Similarly, the -M argument displays just the first component of the host-
    names.  Regardless of those arguments, the local node is always displayed
    as "here".
 
    When the -L argument is specified, only local processes (those whose
    home-node is here) are listed.
 
    When the -O argument is specified, only local processes that are cur-
    rently running away from home are listed.
 
    The -n argument displays the number of migrations (NMIGS).
 
    The ORIGPID field is displayed only when the -P and/or -V arguments are
    specified.
 
    When the -V argument is specified, only guest processes (those whose
    home-node is not here) are listed: the listing includes ORIGPID, but not
    WHERE and FRZ (as those only apply to local processes).
 
    The -D argument displays the user's estimate of the remaining duration of
    their process.
 
    The -S argument displays the progress of multiple-commands (mosrun -S).
    Instead of ordinary MOSIX processes.  Only the main processes (that read
    commands-files) are displayed.  The information provided is:
 
    TOTAL  total number of command-lines given.
    DONE   number of completed command-lines (including failed commands).
    FAIL   number of command-lines that failed.
 
    The -J{JobID} argument limits the output to processes of the given JobID
    (see mosrun(1)).
 
IMPORTANT NOTES
    1. In conformance to the ps standards, since guest processes do not have
       a controlling terminal on this node, in order to list such processes
       either use the -V option, or include a suitable ps argument such as
       -A, ax or -ax (it may depend on the version of ps installed on your
       computer).
 
    2. the c option of ps(1) is useful to view the first 15 characters of the
       command being run under mosrun instead of seeing only "mosrun" in the
       command field.
 
SEE ALSO
    ps(1), mosrun(1), moskillall(1), mosix(7).
 
MOSIX                              February 2009                             MOSIX