NAME

shmem_global_exit - A routine that allows any PE to force termination of an entire program.

SYNOPSIS

C or C++:

#include <mpp/shmem.h>
void shmem_global_exit(int status);

Fortran:

include 'mpp/shmem.fh'
INTEGER STATUS
CALL SHMEM_GLOBAL_EXIT(status)

DESCRIPTION

shmem_global_exit() shmem_global_exit is a non-collective routine that allows any one PE to force termination of an Open- SHMEM program for all PEs, passing an exit status to the execution environment. This routine terminates the entire program, not just the OpenSHMEM portion. When any PE calls shmem_global_exit, it results in the immediate notification to all PEs to terminate. shmem_global_exit flushes I/O and releases resources in accordance with C/C++/Fortran language requirements for normal program termination. If more than one PE calls shmem_global_exit, then the exit status returned to the environment shall be one of the values passed to shmem_global_exit as the status argument. There is no return to the caller of shmem_global_exit; control is returned from the OpenSHMEM program to the execution environment for all PEs.

SEE ALSO

intro_shmem(3), shmem_my_pe(3), shmem_init(3)