int rm_read(int antenna, char *name, void *buf);

• Read data from reflective memory without waiting for notification.

• antenna specifies the antenna from which to read, and may be one of RM_ANT_0, RM_ANT_1, RM_ANT_2, ..., or RM_ANT_10. RM_ANT_0 is used on an antenna computer to read from the reflective memory for the central computer. antenna may also take the special value RM_ANT_ALL to read data from all reflective memory cards which are present in the crate (see the description of buf).

• name is the name of the location in reflective memory from which data should be read. It should be one of the names defined in the file $COMMON/reflmem/rm_allocation.

• buf is a pointer to a buffer in which the data will be stored. If antenna is RM_ANT_ALL, buf should be a pointer to an array of size RM_ARRAY_SIZE; data will be written in the array slots corresponding to the antennas present. The array is indexed by antenna number. For example, if the central crate contains reflective memory cards for antennas 3 and 7, data from name for antenna 3 will be placed in buf[RM_ANT_3], and data from name for antenna 7 will be placed in buf[RM_ANT_7]. The slots which will be filled by the rm_read() function are those returned in alist by the rm_open() function. The values in alist may be used directly to index buf.

  Note: It is the responsibility of the caller to insure that buf points to a space large enough to hold the requested data. The size of data stored in a particular location is encoded into the name (see §). It may also be determined with the rm_get_size() function.

• 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_ANTENNA_INVALID	There is no reflective memory card for the specified antenna
  RM_NAME_INVALID	name is not a valid name from $COMMON/reflmem/rm_allocation
  RM_ALLOC_VERS	There is a mismatch between the allocation table for the local
  	reflective memory card and the remote reflective memory card
  	(for antenna). Reinstall the drivers. (If antenna is RM_ANT_ALL,
  	this error will not be returned even if the allocation table for
  	one of the cards does not match. The read from that card will
  	fail silently, leaving that element of buf unchanged.)