C-Functions for Waiting for Data with Timeouts (Data and Metadata)

Functions
kogmo_rtdb_objsize_t	kogmo_rtdb_obj_readdata_waitnext_until (kogmo_rtdb_handle_t *db_h, kogmo_rtdb_objid_t oid, kogmo_timestamp_t old_ts, void *data_p, kogmo_rtdb_objsize_t size, kogmo_timestamp_t wakeup_ts)
	kogmo_rtdb_obj_readdata_waitnext() with wakeup. see: kogmo_rtdb_obj_readdata_waitnext()
kogmo_rtdb_objsize_t	kogmo_rtdb_obj_readdata_waitnext_until_ptr (kogmo_rtdb_handle_t *db_h, kogmo_rtdb_objid_t oid, kogmo_timestamp_t old_ts, void *data_p, kogmo_rtdb_objsize_t size, kogmo_timestamp_t wakeup_ts)
	kogmo_rtdb_obj_readdata_waitnext_ptr() with wakeup. see: kogmo_rtdb_obj_readdata_waitnext_ptr()

---

Detailed Description

These functions contain an additional parameter wakeup_ts that specifies an *absolute* timestamp when to wakeup from a blocking call. They return -KOGMO_RTDB_ERR_TIMEOUT in this case. With 0 as wakeup_ts they behave like the function that doen't have a trailing _until in its name.
kogmo_rtdb_obj_readdata_waitnext_until(..,0) = kogmo_rtdb_obj_readdata_waitnext()

---

Function Documentation

kogmo_rtdb_objsize_t kogmo_rtdb_obj_readdata_waitnext_until	(	kogmo_rtdb_handle_t *	db_h,
		kogmo_rtdb_objid_t	oid,
		kogmo_timestamp_t	old_ts,
		void *	data_p,
		kogmo_rtdb_objsize_t	size,
		kogmo_timestamp_t	wakeup_ts
	)

kogmo_rtdb_obj_readdata_waitnext() with wakeup. see: kogmo_rtdb_obj_readdata_waitnext()

Parameters:

wakeup_ts

time at which to wake up if there is no data available. returns -KOGMO_RTDB_ERR_TIMEOUT in this case.

kogmo_rtdb_objsize_t kogmo_rtdb_obj_readdata_waitnext_until_ptr	(	kogmo_rtdb_handle_t *	db_h,
		kogmo_rtdb_objid_t	oid,
		kogmo_timestamp_t	old_ts,
		void *	data_p,
		kogmo_rtdb_objsize_t	size,
		kogmo_timestamp_t	wakeup_ts
	)

kogmo_rtdb_obj_readdata_waitnext_ptr() with wakeup. see: kogmo_rtdb_obj_readdata_waitnext_ptr()

Parameters:

wakeup_ts

time at which to wake up if there is no data available. returns -KOGMO_RTDB_ERR_TIMEOUT in this case.