FD.io VPP  v19.08-27-gf4dcae4
Vector Packet Processing
callback.h File Reference

Callback multiplex scheme For a fully worked-out example, see .../src/vlib/main. More...

+ Include dependency graph for callback.h:
+ This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros

#define clib_callback_enable_disable(h, tmp, l, f, enable)
 Add or remove a callback to the specified callback set. More...
 
#define clib_call_callbacks(h, ...)
 call the specified callback set More...
 
#define clib_callback_is_set(h, l, f)
 predicate function says whether the specified function is enabled More...
 

Detailed Description

Callback multiplex scheme For a fully worked-out example, see .../src/vlib/main.

[ch] and .../src/plugins/perfmon.c

Definition in file callback.h.

Macro Definition Documentation

#define clib_call_callbacks (   h,
  ... 
)
Value:
do { \
/* \
* Note: fp exists to shut up gcc-6, which \
* produces a warning not seen with gcc-7 or 8 \
*/ \
void (*fp)(void *a1, ...); \
int i; \
for (i = 0; i < vec_len (h); i++) \
{ \
fp = (void *)(h[i]); \
(*fp) (__VA_ARGS__); \
} \
} while (0);
for(i=1;i<=collision_buckets;i++)
int i
#define vec_len(v)
Number of elements in vector (rvalue-only, NULL tolerant)

call the specified callback set

Parameters
hthe callback set
varargsadditional callback parameters

Definition at line 67 of file callback.h.

#define clib_callback_enable_disable (   h,
  tmp,
  l,
  f,
  enable 
)
Value:
do { \
void *tmp2; \
vec_append(tmp, h); \
if (enable) \
vec_add1 (tmp,(void *)f); \
else \
{ \
int i; \
for (i = 0; i < vec_len (tmp); i++) \
if (((void *)tmp[i]) == (void *)f) \
{ \
vec_delete (tmp, 1, i); \
break; \
} \
} \
tmp2 = h; \
h = tmp; \
tmp = tmp2; \
} while(0);
#define CLIB_MEMORY_STORE_BARRIER()
Definition: clib.h:118
static_always_inline void clib_spinlock_unlock_if_init(clib_spinlock_t *p)
Definition: lock.h:108
#define vec_add1(V, E)
Add 1 element to end of vector (unspecified alignment).
Definition: vec.h:522
for(i=1;i<=collision_buckets;i++)
int i
#define vec_reset_length(v)
Reset vector length to zero NULL-pointer tolerant.
#define vec_delete(V, N, M)
Delete N elements starting at element M.
Definition: vec.h:784
#define vec_append(v1, v2)
Append v2 after v1.
Definition: vec.h:818
#define vec_len(v)
Number of elements in vector (rvalue-only, NULL tolerant)
static_always_inline void clib_spinlock_lock_if_init(clib_spinlock_t *p)
Definition: lock.h:93

Add or remove a callback to the specified callback set.

Parameters
hhead of the callback vector
tmpvector to build result
lclib_spinlock_t lock to protect the vector, may be 0
ffunction to add or remove
enable1 adds f to the vector, 0 removes f from the vector

Add or remove a callback from the indicated callback vector. Caller must provide locking to prevent > 1 concurrent writer Swaps the head of the callback vector and a tmp vector in one motion, after a write barrier to ensure that the write is atomic.

Definition at line 38 of file callback.h.

#define clib_callback_is_set (   h,
  l,
 
)
Value:
({ \
int _i; \
int _found = 0; \
for (_i = 0; _i < vec_len (h); _i++) \
if (((void *)h[_i]) == (void *) f) \
{ \
_found=1; \
break; \
} \
_found; \
})
static_always_inline void clib_spinlock_unlock_if_init(clib_spinlock_t *p)
Definition: lock.h:108
for(i=1;i<=collision_buckets;i++)
#define vec_len(v)
Number of elements in vector (rvalue-only, NULL tolerant)
static_always_inline void clib_spinlock_lock_if_init(clib_spinlock_t *p)
Definition: lock.h:93

predicate function says whether the specified function is enabled

Parameters
hthe callback set
lclib_spinlock_t lock to protect the vector, may be 0
fthe function to search for
Returns
1 if the function is enabled, 0 if not

Definition at line 88 of file callback.h.