rte_alarm.h File Reference

#include <stdint.h>

Typedefs
typedef void(*	rte_eal_alarm_callback )(void *arg)

Functions
int	rte_eal_alarm_set (uint64_t us, rte_eal_alarm_callback cb, void *cb_arg)
int	rte_eal_alarm_cancel (rte_eal_alarm_callback cb_fn, void *cb_arg)

Detailed Description

Alarm functions

Simple alarm-clock functionality supplied by eal. Does not require hpet support.

Typedef Documentation

typedef void(* rte_eal_alarm_callback)(void *arg)

Signature of callback back function called when an alarm goes off.

Function Documentation

int rte_eal_alarm_cancel	(	rte_eal_alarm_callback	cb_fn,
		void *	cb_arg
	)

Function to cancel an alarm callback which has been registered before.

Parameters

cb_fn	alarm callback
cb_arg	Pointer parameter to be passed to the callback function. To remove all copies of a given callback function, irrespective of parameter, (void *)-1 can be used here.

Returns

• The number of callbacks removed

int rte_eal_alarm_set	(	uint64_t	us,
		rte_eal_alarm_callback	cb,
		void *	cb_arg
	)

Function to set a callback to be triggered when us microseconds have expired. Accuracy of timing to the microsecond is not guaranteed. The alarm function will not be called before the requested time, but may be called a short period of time afterwards. The alarm handler will be called only once. There is no need to call "rte_eal_alarm_cancel" from within the callback function.

Parameters

us	The time in microseconds before the callback is called
cb	The function to be called when the alarm expires
cb_arg	Pointer parameter to be passed to the callback function

Returns

On success, zero. On failure, a negative error number