


bsprun(1)                 User Commands                 bsprun(1)



NAME
     bsprun - Initiates the parallel execution of a BSP job.


SYNOPSIS
     bsprun[  -v  ]  [  -npes  number  ][  -local  ][  -nolocal][
     -noload][ -splitio ] _p_r_o_g_r_a_m _c_o_m_m_a_n_d-_l_i_n_e-_o_p_t_i_o_n_s


DESCRIPTION
     The purpose of this command is to hide the machine specifics
     of starting parallel jobs. The programmer specifies with the
     -_n_p_e_s option an  _u_p_p_e_r  _b_o_u_n_d  of  the  number  of  parallel
     processes  to  be spawned by a program. This value doesn not
     override the value specified by _b_s_p__b_e_g_i_n(_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  implementation  of  the  library,  this
          option  enforces  process  zero  to be on the processor
          that initiates the computation.


     -nolocal
          In the  TCP/IP  implementation  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 implementation 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 _n_u_m_b_e_r  BSP  processes  in  parallel.  If
          there  are _P physical parallel processes available, and
          _p processes are spawned by  _b_s_p__b_e_g_i_n(_3),  then  the  _p
          processes  are  allocated among the _P processors evenly
          (where _1<=_p<=_n_u_m_b_e_r ).

     -splitio
          This option is intended  to  help  the  user  determine



Oxford BSP Toolset  Last change: 1.4 25/9/98                    1






bsprun(1)                 User Commands                 bsprun(1)



          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 _B_S_P__P_R_O_C_S can be used in preference
     to the option -_n_p_e_s.


SEE ALSO
     bsplib(3)

     The Oxford BSP toolset web pages can be found  at:
     _h_t_t_p://_w_w_w._b_s_p-_w_o_r_l_d_w_i_d_e._o_r_g/_i_m_p_l_m_n_t_s/_o_x_t_o_o_l/


BUGS
     Problems  and  bug  reports  should  be  mailed  to  _b_s_p_l_i_b-
     _b_u_g_s@_c_o_m_l_a_b._o_x._a_c._u_k


AUTHORS
     Jonathan.Hill@comlab.ox.ac.uk

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
























Oxford BSP Toolset  Last change: 1.4 25/9/98                    2



