int rm_read_wait(int *antennap, char *name, void *buf);

• Wait for notification that the data at one of the locations in the monitor list has changed, and return the new data. When notification is received, the function will return and the space pointed to by the parameters will contain the new information.

• *antennap will contain one of RM_ANT_0, RM_ANT_1, RM_ANT_2, ..., or RM_ANT_10, indicating the associated antenna for which the data changed. On an antenna computer, *antennap is set to RM_ANT_0.

• name will contain one of the names from the file $COMMON/reflmem/rm_allocation, indicating which data changed. name must point to a buffer of size RM_NAME_LENGTH bytes.

• buf points to a buffer in which the new data will be stored. NOTE: It is the responsibility of the caller to insure that buf points to a space large enough to hold the largest value which may be returned, as specified in the monitor list. For example, if an 8-byte double and a 50-byte string are being monitored, buf must point to a 50-byte space.

• The monitor list is manipulated using the functions function rm_monitor(), rm_no_monitor(), and rm_clear_monitor(). The monitor list in place at the time of the call to rm_read_wait() is used; changes to the monitor list will become active in subsequent calls to rm_read_wait().

• Returns RM_SUCCESS if successful. On failure, returns a code describing the error:

  RM_NO_INIT	Reflective memory operations have not been initialized
  	with rm_open()
  RM_MON_LIST_EMPTY	No reflective memory locations are being monitored;
  	the monitor list is empty
  RM_REL_PREMATURE	The function returned prematurely due to a signal or a manual
  	release by rm_release_read() or rm_close()