NAME

     bsprun - Initiates the parallel execution of a BSP job.

SYNOPSIS

     bsprun[  -v  ]  [  -npes  number  ][  -local  ][  -nolocal][
     -noload][ -splitio ] program command-line-options

DESCRIPTION

     The purpose of this command is to hide the machine specifics
     of starting parallel jobs. The programmer specifies with the
     -npes option an  upper  bound  of  the  number  of  parallel
     processes  to  be spawned by a program. This value doesn not
     override the value specified by bsp_begin(3).

OPTIONS

     -v    Print (on standard error output) the  phases  involved
          in the execution of the command.

     -help
          Print this manual page on standard output.

     -local
          In the TCP/IP or UDP/IP implementations of the library,
          this  option enforces process zero to be on the proces-
          sor that initiates the computation.


     -nolocal
          In the TCP/IP or UDP/IP implementations of the library,
          this  option enforces process zero to be on a processor
          other than the one that initiates the computation.


     -noload
          In the TCP/IP or UDP/IP implementations of the library,
          the  load  daemon  will  not be used to determine which
          processors should be spawned. Processors will be  tried
          in the order specified by the ~/.bsptcphosts file.


     -npes number
          Spawn at most number  BSP  processes  in  parallel.  If
          there  are P physical parallel processes available, and
          p processes are spawned by  bsp_begin(3),  then  the  p
          processes  are  allocated among the P processors evenly
          (where 1<=p<=number ).

     -splitio
          This option is intended  to  help  the  user  determine
          which  process  printed  data to either standard out or
          error. A banner of the form:

          --- pine.comlab.ox.ac.uk BSP pid 2 - stdout ---

          will be printed  whenever  the  source  pid  or  stream
          changes.  Note,  this  option is only available on some
          platforms.

NOTES

     The environment variable BSP_PROCS can be used in preference
     to the option -npes.

SEE ALSO

     bsplib(3)

     The Oxford BSP toolset web pages can be found  at:
     http://www.bsp-worldwide.org/implmnts/oxtool/

BUGS

     Problems  and  bug  reports  should  be  mailed  to  bsplib-
     bugs@comlab.ox.ac.uk

AUTHORS

     Jonathan.Hill@comlab.ox.ac.uk

     http://www.comlab.ox.ac.uk/oucl/people/jonathan.hill.html