---
name: "shmem_global_exit"
section: "3"
platform: "linux"
package: "openmpi"
version: "5.0.11-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/shmem_global_exit"
---

# shmem\_global\_exit(3)

*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)](/intro_shmem/3.md) [*shmem\_my\_pe*(3)](/shmem_my_pe/3.md) [*shmem\_init*(3)](/shmem_init/3.md)

## COPYRIGHT

2003-2026, The Open MPI Community