SHMEM\_GLOBAL\_EXIT(3)

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)