NAME

await − wait for any asynchronous I/O operation to complete

SYNOPSIS

int await (nids, ids)
unsigned nids;
int ∗ids;

DESCRIPTION

await examines the identifiers (see aread(2) and awrite(2)) specified by the bit mask ids to see which of the specified identifiers correspond to asynchronous I/O operations which are not currently in progress.  Identifier i is represented by the bit “1<<i” in the mask.  Nids identifiers are checked, i.e. the bits from 0 through nids−1 in the mask are examined.  await will return when at least 1 of the identifiers no longer corresponds to an asynchronous I/O operation which is in progress.  await returns, in place, a mask of those identifiers corresponding to asynchronous I/O operations which are not currently in progress. 

await will fail if one or more of the following are true:

[EFAULT] Ids points outside the allocated address space. 

[EINVAL] The mask specified by ids is 0. 

[EINTR] A signal was delivered before any of the specified asynchronous I/O operations have completed. 

RETURN VALUE

Upon successful completion, a value of 0 is returned to the calling process.  Otherwise, a value of −1 is returned and errno is set to indicate the error. 

SEE ALSO

acancel(2), aread(2), awrite(2). 

CX/UX Programmer’s Reference Manual