


bsp_hpmove(3)           BSPlib FUNCTIONS            bsp_hpmove(3)



NAME
     bsp_abort - stop a BSP computation


C SYNOPSIS
     #include "bsp.h"

     void bsp_abort(char *_f_o_r_m_a_t,...);

FORTRAN SYNOPSIS
     SUBROUTINE bspabort(_e_r_r__s_t_r_i_n_g)
     CHARACTER(*), intent(IN)::_e_r_r__s_t_r_i_n_g


DESCRIPTION
     The function bsp_abort can be used to print an error message
     followed by a halt of the entire bsplib(3) program. The rou-
     tine is designed not to require a barrier synchronisation of
     all  processes.  A  single  process  in a potentially unique
     thread of control can therefore halt  the  entire  bsplib(3)
     program.

     In the C version of the function, _f_o_r_m_a_t is a C-style format
     string  as used by printf(3). Any other arguments are inter-
     preted in the same way as the variable number  of  arguments
     to printf(3).

     _e_r_r__s_t_r_i_n_g is single error string that is printed  when  the
     Fortran  routine is executed. All computation ceases after a
     call to bsp_abort.




SEE ALSO
     bsplib(3)

     ``_B_S_P_l_i_b: _T_h_e _B_S_P _P_r_o_g_r_a_m_m_i_n_g _L_i_b_r_a_r_y'' Jonathan M. D. Hill,
     Bill  McColl,  Dan  C.  Stefanescu,  Mark W. Goudreau, Kevin
     Lang, Satish B. Rao, , Torsten Suel, Thanasis Tsantilas, and
     Rob  Bisseling.  Parallel  Computing,  to  appear  1998. See
     _h_t_t_p://_w_w_w._b_s_p-_w_o_r_l_d_w_i_d_e._o_r_g for more details.


NOTES
     i    If more than one process calls bsp_abort  in  the  same
          superstep,  then  either  one,  all, or a subset of the
          processes that called bsp_abort may print their  format
          string  to the terminal before stopping the BSPlib com-
          putation.





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






bsp_hpmove(3)           BSPlib FUNCTIONS            bsp_hpmove(3)



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
     The Oxford BSP Toolset implementation of BSPlib was  written
     by 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



