Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
rte_alarm.h(3)			      DPDK			  rte_alarm.h(3)

NAME
     rte_alarm.h

SYNOPSIS
     #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.

     Definition in file rte_alarm.h.

Typedef Documentation
   typedef void(* rte_eal_alarm_callback) (void *arg)
     Signature of callback back function called when an alarm goes off.

     Definition at line 26 of file rte_alarm.h.

Function Documentation
   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 ex-
     pired. 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 call-
     back 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

   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. If
     used outside alarm callback it wait for all callbacks to finish execution.

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

     Returns

	 * value greater than 0 and rte_errno not changed -  returned  value  is
	   the number of canceled alarm callback functions

	 * value  greater  or equal 0 and rte_errno set to EINPROGRESS, at least
	   one alarm could not be canceled because  cancellation  was  requested
	   from alarm callback context. Returned value is the number of success-
	   fully canceled alarm callbacks

	 * 0 and rte_errno set to ENOENT - no alarm found

	 * -1 and rte_errno set to EINVAL - invalid parameter (NULL callback)

Author
     Generated automatically by Doxygen for DPDK from the source code.

Version 25.11.0 		 Thu Aug 27 2026		  rte_alarm.h(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=rte_eal_alarm_callback&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help