The GNU Fortran Compiler: _gfortran_caf_unlock

Next: _gfortran_caf_event_post, Previous: _gfortran_caf_lock, Up: Function ABI Documentation [Contents][Index]

#### 8.2.11 `_gfortran_caf_lock` — Unlocking a lock variable

Description:

  Release a lock on the given image on a scalar locking variable or for the given array element for an array-valued variable. Unlocking a lock variable which is unlocked or has been locked by a different image is an error.

Syntax:

  `void _gfortran_caf_unlock (caf_token_t token, size_t index, int image_index, int *stat, char *errmsg, int errmsg_len)`

Arguments:

  token | intent(in) An opaque pointer identifying the coarray.
  index | Array index; first array index is 0. For scalars, it is always 0.
  image_index | The ID of the remote image; must be a positive number.
  stat | intent(out) For allocatable coarrays, stores the STAT=; may be NULL
  errmsg | intent(out) When an error occurs, this will be set to an error message; may be NULL
  errmsg_len | the buffer size of errmsg.

NOTES

  This function is also called for critical block; for those, the array index is always zero and the image index is one. Libraries are permitted to use other images for critical-block locking variables.