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


8.2.19 _gfortran_caf_event_post — Post an event

Description:

Increment the event count of the specified event variable.

Syntax:

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

Arguments:
tokenintent(in) An opaque pointer identifying the coarray.
indexintent(in) Array index; first array index is 0. For scalars, it is always 0.
image_indexintent(in) The ID of the remote image; must be a positive number; zero indicates the current image, when accessed noncoindexed.
statintent(out) Stores the STAT=; may be NULL.
errmsgintent(out) When an error occurs, this will be set to an error message; may be NULL.
errmsg_lenintent(in) the buffer size of errmsg
NOTES

This acts like an atomic add of one to the remote image’s event variable. The statement is an image-control statement but does not imply sync memory. Still, all preceeding push communications of this image to the specified remote image have to be completed before event_wait on the remote image returns.