bsp_hpmove(3)

NAME
bsp_abort - stop a BSP computation

C SYNOPSIS
#include "bsp.h"

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

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

DESCRIPTION
The function bsp_abort can be used to print an error message followed by a halt of the entire bsplib(3) program. The routine 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, format is a C-style format string as used by printf(3) . Any other arguments are interpreted in the same way as the variable number of arguments to printf(3) .

err_string 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) ``BSPlib: The BSP Programming Library'' 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 http://www.bsp-worldwide.org 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 computation.

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

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