RW_tmr.ih.px-xxx-xxx File Reference

Defines the POSIX platform dependent Resource Wait timer (RW_tmr) routines. More...

#include <pthread.h>
#include <errno.h>

Defines
#define	RW_TMR_PINIT(rw_tmr)
	Initializes the platform specific piece of the RW_tmr structure.
Functions
RW__EXP_FNC RW_state	RW__tmr_lock (RW_tmr *tmr, RW_state state)
	Locks the resource.
RW__EXP_FNC RW_state	RW__tmr_wait (RW_tmr *tmr, RW_state state)
	Waits until the timer expires or another task calls RW__tmr_wake indicating that another attempt be made to allocate the resource.
RW__EXP_FNC RW_state	RW__tmr_unlock (RW_tmr *tmr, RW_state state)
	Unlocks the resource.
RW__EXP_FNC RW_state	RW__tmr_destroy (RW_tmr *tmr, RW_state state)
	Destroys the tmr RW handle. This should be called before exiting the routine doing the allocation, since it will cleanup any outstanding timers among other things.

---

Detailed Description

Defines the POSIX platform dependent Resource Wait timer (RW_tmr) routines.

Author:

JJRussell - russell@slac.stanford.edu

   CVS $Id: RW_tmr.ih.px-xxx-xxx,v 1.4 2011/03/24 23:05:47 apw Exp $

---

Define Documentation

#define RW_TMR_PINIT

(

rw_tmr

)

Initializes the platform specific piece of the RW_tmr structure.

Parameters:

rw_tmr

Pointer to the RW_tmr structure to initialize

Referenced by RW__tmr_init().

---

Function Documentation

RW_state RW__tmr_destroy	(	RW_tmr *	tmr,
		RW_state	state
	)

Destroys the tmr RW handle. This should be called before exiting the routine doing the allocation, since it will cleanup any outstanding timers among other things.

Parameters:

	tmr	The RW timer handle
	state	The current state

Returns:

The updated state.

Warning:

Failure to call this routine if a timer is still on the WUT que is fatal.

Referenced by rng_allocate(), and RW_getW_toc().

RW_state RW__tmr_lock	(	RW_tmr *	tmr,
		RW_state	state
	)

Locks the resource.

Parameters:

	tmr	The RW timer handle
	state	The current RW state

Returns:

The update RW state.

References _RW_ctl::mutex, and _RW_tmr::rw.

Referenced by rng__wait(), and RW_getW_toc().

RW_state RW__tmr_unlock	(	RW_tmr *	tmr,
		RW_state	state
	)

Unlocks the resource.

Parameters:

	tmr	The RW timer handle
	state	The current RW state

Returns:

The update RW state.

References _RW_ctl::mutex, and _RW_tmr::rw.

Referenced by rng__wait(), and RW_getW_toc().

RW_state RW__tmr_wait	(	RW_tmr *	tmr,
		RW_state	state
	)

Waits until the timer expires or another task calls RW__tmr_wake indicating that another attempt be made to allocate the resource.

Parameters:

	tmr	A previously initialized timer resource handle
	state	The current RW state

Returns:

The updated RW state.

References _RW_waitctl_u::bf, _RW_ctl::cond, _RW_ctl::mutex, _RW_tmr::rw, RW_M_ERROR, RW_M_INCWAITING, RW_M_TIMEDOUT, RW_M_TMRSTART, RW_M_TOVCOMPUTE, RW_M_TRYAGAIN, _RW_tmr::toc, TOC_compute(), _RW_tmr::tov, TOV_K_FOREVER, TOV_K_NOWAIT, and _RW_ctl::waiting.

Referenced by rng__wait(), and RW_getW_toc().