MOSRUN(1)               System General Commands Manual               MOSRUN(1)  <<

NAME

     mosrun - run a command with particular node-allocation preferences

SYNOPSIS

     mosrun [-{h | openMosix_ID | jID1-ID2 [,ID3-ID4] ... } [-F]] [-{l|L|k}]
            [-{c|i|n|s|f| [-t tt] [-d dec] } [-{e|E}] [-{r|R}]] [-z]
            command [ arg ... ]

     nomig [-z] command [ arg ... ]

     runhome [-z] command [ arg ... ]

     runon openMosix_ID [-z] command [ arg ... ]

     cpujob [-{h|openMosix_id}] [-z] command [ arg ... ]

     iojob [-{h|openMosix_id}] [-z] command [ arg ... ]

     nodecay [-{h|openMosix_id}] [-z] command [ arg ... ]

     slowdecay [-{h|openMosix_id}] [-z] command [ arg ... ]

     fastdecay [-{h|openMosix_id}] [-z] command [ arg ... ]


DESCRIPTION

     mosrun runs a command while advising openMosix about the placement, node-
     lock status and the best method of decaying its openMosix per-process
     statistics to suit the program's behaviour.

     The -h option (h for "home") requests that the command be run on the home
     node.  Similarly, a numeric option (-openMosix_ID) requests that the pro-
     cess be run on a particular openMosix node.  mosrun will fail should that
     node be unavailable, unless the -F option is specified, in which case,
     the program could run anywhere.  The -jID-LIST option selects a random
     node from among the supplied list of nodes.  the list should be comma-
     separated and may contain any combination of either single openMosix node
     numbers, or dash-separated range of openMosix nodes.  Again, mosrun will
     fail should the selected random node be unavailable (unless the -F option
     is specified).

     The node-lock, preventing automatic process-migrations (except in emer-
     gencies, such as when a node is being shut-down, in which case the pro-
     cesses will migrate to their home-node), can be controlled via one of the
     -l (unlock), -L (lock) or -k (keep) flags.
     The default is to lock whenever either -h, -openMosix_ID or -j are speci-
     fied or when no decay options are specified and to otherwise keep the
     status as per the calling shell/program.

     The -c option advises openMosix that the program is heavy user-mode com-
     putational and should therefore ignore the statistics of any I/O or other
     system-calls.

     The -i option advises openMosix that the program uses heavy I/O or other
     system calls and should therefore ignore the statistics of any user-mode
     CPU usage.

     The -n option advises openMosix that the program runs an irregular pat-
     tern of mixed CPU and I/O (or other system-calls), thus decaying should
     not be applied.

     The -s option advises openMosix to apply slow decaying over the program's
     statistics (this is also openMosix's default).

     The -f option advises openMosix to apply fast decaying over the program's
     statistics, indicating a program that alternates between large-granular-
     ity chunks of CPU and I/O (or other system-calls).

     The -d option and/or the -t option specifies explicitly how often to
     decay the statistics for the program and what portion of the statistics
     should remain after decaying: tt specifies the interval between decays in
     seconds and dec specifies the (integer) portion to keep out of 1000
     units.  If only one of -d or -t is specified, the other is obtained from
     the current decaying policy (or if the current policy is either -c or -i,
     from the current default settings, eg. of a slow decay).

     The -e argument specifies that the new decaying preferences will cease to
     apply for any of the generated processes that performs a successful
     exec(3) system call.  -E (the default) specifies that the decaying pref-
     erences be kept even across an exec(3).

     The -r argument specifies that the new decaying preferences will not be
     inherited to the program's child processes (and further descendants),
     while -R (the default) specifies that the decaying preferences be inher-
     ited.

     The -z argument specifies that the argument-list begins with argument
     number zero (which is normally identical to the command), rather than the
     usual argument number one.

     Without any options, 'mosrun command arg ...' is equivalent to
     'mosrun -L command arg ...'.

     On a plain, non-openMosix Linux operating system, mosrun will simply
     spawn the command with no side-effects.

     The following scripts operate as simple front-ends to mosrun:

     Nomig runs a command with a node-lock.

     Runhome runs a command locked at the home node.

     runon runs a command locked on a particular openMosix node.

     cpujob runs a command, advising openMosix that it is a computation inten-
     sive program.

     iojob runs a command, advising openMosix that it is an I/O intensive pro-
     gram.


     nodecay runs a command, advising openMosix to not decay the program's
     statistics.

     slowdecay runs a command, advising openMosix to apply slow statistics-
     decaying.

     fastdecay runs a command advising openMosix to apply fast statistics-
     decaying.


EXAMPLES

     mosrun -7 -F -c program

     runs a computation-intensive program on openMosix node #7, if available.

     mosrun -j2-5,7,10-16 program arg

     runs a program on a random node among node numbers 2-5, 7 or 10-16.


     mosrun -h -l -i -r job_manager file-name

     runs a program (job_manager) initially on the home-node, but allowing it
     to subsequently migrate.  openMosix is informed that the main process, a
     manager is heavily I/O bound, but that its children are not so necessar-
     ily.

     mosrun -t 1 -d 700 two_phases

     runs a program that alternates between a relatively long I/O phase and a
     computational phase.  openMosix is advised to decay the statistics very
     quickly - leaving only 70% every second, so that the program is migrated
     away quickly between the home node and a most available/fast node when-
     ever it switches between stages.


SEE ALSO

     openmosix(1), cpujob(1), fastdecay(1), iojob(1), joingroup(1),
     migrate(1), migrategroup(1), mosmon(1), mosctl(1), mosrun(1), mps(1),
     mtop(1), nodecay(1), nomig(1), omdiscd(1), resetgroup(1), runhome(1),
     runon(1), setpe(1), showgroup(1), slowdecay(1)


HISTORY

     mosrun is an openMosix utility.

openMosix                         May 3, 1999                        openMosix  <<