FD.io VPP  v20.09-64-g4f7b92f0a
Vector Packet Processing
api_helper_macros.h
Go to the documentation of this file.
1 /*
2  *------------------------------------------------------------------
3  * api_helper_macros.h - message handler helper macros
4  *
5  * Copyright (c) 2016 Cisco and/or its affiliates.
6  * Licensed under the Apache License, Version 2.0 (the "License");
7  * you may not use this file except in compliance with the License.
8  * You may obtain a copy of the License at:
9  *
10  * http://www.apache.org/licenses/LICENSE-2.0
11  *
12  * Unless required by applicable law or agreed to in writing, software
13  * distributed under the License is distributed on an "AS IS" BASIS,
14  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15  * See the License for the specific language governing permissions and
16  * limitations under the License.
17  *------------------------------------------------------------------
18  */
19 
20 #ifndef __api_helper_macros_h__
21 #define __api_helper_macros_h__
22 
23 #define f64_endian(a)
24 #define f64_print(a,b)
25 
26 #ifndef REPLY_MSG_ID_BASE
27 #define REPLY_MSG_ID_BASE 0
28 #endif
29 
30 #define REPLY_MACRO(t) \
31 do { \
32  vl_api_registration_t *rp; \
33  rv = vl_msg_api_pd_handler (mp, rv); \
34  rp = vl_api_client_index_to_registration (mp->client_index); \
35  if (rp == 0) \
36  return; \
37  \
38  rmp = vl_msg_api_alloc (sizeof (*rmp)); \
39  rmp->_vl_msg_id = htons((t)+(REPLY_MSG_ID_BASE)); \
40  rmp->context = mp->context; \
41  rmp->retval = ntohl(rv); \
42  \
43  vl_api_send_msg (rp, (u8 *)rmp); \
44 } while(0);
45 
46 #define REPLY_MACRO_END(t) \
47 do { \
48  vl_api_registration_t *rp; \
49  rv = vl_msg_api_pd_handler (mp, rv); \
50  rp = vl_api_client_index_to_registration (mp->client_index); \
51  if (rp == 0) \
52  return; \
53  \
54  rmp = vl_msg_api_alloc (sizeof (*rmp)); \
55  rmp->_vl_msg_id = t+(REPLY_MSG_ID_BASE); \
56  rmp->context = mp->context; \
57  rmp->retval = rv; \
58  api_main_t *am = vlibapi_get_main (); \
59  void (*endian_fp) (void *); \
60  endian_fp = am->msg_endian_handlers[t+(REPLY_MSG_ID_BASE)]; \
61  (*endian_fp) (rmp); \
62  vl_api_send_msg (rp, (u8 *)rmp); \
63 } while(0);
64 
65 #define REPLY_MACRO2(t, body) \
66 do { \
67  vl_api_registration_t *rp; \
68  rv = vl_msg_api_pd_handler (mp, rv); \
69  rp = vl_api_client_index_to_registration (mp->client_index); \
70  if (rp == 0) \
71  return; \
72  \
73  rmp = vl_msg_api_alloc (sizeof (*rmp)); \
74  rmp->_vl_msg_id = htons((t)+(REPLY_MSG_ID_BASE)); \
75  rmp->context = mp->context; \
76  rmp->retval = ntohl(rv); \
77  do {body;} while (0); \
78  vl_api_send_msg (rp, (u8 *)rmp); \
79 } while(0);
80 
81 #define REPLY_MACRO2_END(t, body) \
82 do { \
83  vl_api_registration_t *rp; \
84  rv = vl_msg_api_pd_handler (mp, rv); \
85  rp = vl_api_client_index_to_registration (mp->client_index); \
86  if (rp == 0) \
87  return; \
88  \
89  rmp = vl_msg_api_alloc (sizeof (*rmp)); \
90  rmp->_vl_msg_id = t+(REPLY_MSG_ID_BASE); \
91  rmp->context = mp->context; \
92  rmp->retval = rv; \
93  do {body;} while (0); \
94  api_main_t *am = vlibapi_get_main (); \
95  void (*endian_fp) (void *); \
96  endian_fp = am->msg_endian_handlers[t+(REPLY_MSG_ID_BASE)]; \
97  (*endian_fp) (rmp); \
98  vl_api_send_msg (rp, (u8 *)rmp); \
99 } while(0);
100 
101 #define REPLY_MACRO2_ZERO(t, body) \
102 do { \
103  vl_api_registration_t *rp; \
104  rv = vl_msg_api_pd_handler (mp, rv); \
105  rp = vl_api_client_index_to_registration (mp->client_index); \
106  if (rp == 0) \
107  return; \
108  \
109  rmp = vl_msg_api_alloc_zero (sizeof (*rmp)); \
110  rmp->_vl_msg_id = htons((t)+(REPLY_MSG_ID_BASE)); \
111  rmp->context = mp->context; \
112  rmp->retval = ntohl(rv); \
113  do {body;} while (0); \
114  vl_api_send_msg (rp, (u8 *)rmp); \
115 } while(0);
116 
117 #define REPLY_MACRO_DETAILS2(t, body) \
118 do { \
119  vl_api_registration_t *rp; \
120  rv = vl_msg_api_pd_handler (mp, rv); \
121  rp = vl_api_client_index_to_registration (mp->client_index); \
122  if (rp == 0) \
123  return; \
124  \
125  rmp = vl_msg_api_alloc (sizeof (*rmp)); \
126  rmp->_vl_msg_id = htons((t)+(REPLY_MSG_ID_BASE)); \
127  rmp->context = mp->context; \
128  do {body;} while (0); \
129  vl_api_send_msg (rp, (u8 *)rmp); \
130 } while(0);
131 
132 #define REPLY_MACRO_DETAILS4(t, rp, context, body) \
133 do { \
134  rmp = vl_msg_api_alloc (sizeof (*rmp)); \
135  rmp->_vl_msg_id = htons((t)+(REPLY_MSG_ID_BASE)); \
136  rmp->context = context; \
137  do {body;} while (0); \
138  vl_api_send_msg (rp, (u8 *)rmp); \
139 } while(0);
140 
141 #define REPLY_MACRO3(t, n, body) \
142 do { \
143  vl_api_registration_t *rp; \
144  rv = vl_msg_api_pd_handler (mp, rv); \
145  rp = vl_api_client_index_to_registration (mp->client_index); \
146  if (rp == 0) \
147  return; \
148  \
149  rmp = vl_msg_api_alloc (sizeof (*rmp) + n); \
150  rmp->_vl_msg_id = htons((t)+(REPLY_MSG_ID_BASE)); \
151  rmp->context = mp->context; \
152  rmp->retval = ntohl(rv); \
153  do {body;} while (0); \
154  vl_api_send_msg (rp, (u8 *)rmp); \
155 } while(0);
156 
157 #define REPLY_MACRO3_ZERO(t, n, body) \
158 do { \
159  vl_api_registration_t *rp; \
160  rv = vl_msg_api_pd_handler (mp, rv); \
161  rp = vl_api_client_index_to_registration (mp->client_index); \
162  if (rp == 0) \
163  return; \
164  \
165  rmp = vl_msg_api_alloc_zero (sizeof (*rmp) + n); \
166  rmp->_vl_msg_id = htons((t)+(REPLY_MSG_ID_BASE)); \
167  rmp->context = mp->context; \
168  rmp->retval = ntohl(rv); \
169  do {body;} while (0); \
170  vl_api_send_msg (rp, (u8 *)rmp); \
171 } while(0);
172 
173 #define REPLY_MACRO4(t, n, body) \
174 do { \
175  vl_api_registration_t *rp; \
176  u8 is_error = 0; \
177  rv = vl_msg_api_pd_handler (mp, rv); \
178  \
179  rp = vl_api_client_index_to_registration (mp->client_index); \
180  if (rp == 0) \
181  return; \
182  \
183  rmp = vl_msg_api_alloc_or_null (sizeof (*rmp) + n); \
184  if (!rmp) \
185  { \
186  /* if there isn't enough memory, try to allocate */ \
187  /* some at least for returning an error */ \
188  rmp = vl_msg_api_alloc (sizeof (*rmp)); \
189  if (!rmp) \
190  return; \
191  \
192  clib_memset (rmp, 0, sizeof (*rmp)); \
193  rv = VNET_API_ERROR_TABLE_TOO_BIG; \
194  is_error = 1; \
195  } \
196  rmp->_vl_msg_id = htons((t)+(REPLY_MSG_ID_BASE)); \
197  rmp->context = mp->context; \
198  rmp->retval = ntohl(rv); \
199  if (!is_error) \
200  do {body;} while (0); \
201  vl_api_send_msg (rp, (u8 *)rmp); \
202 } while(0);
203 
204 #define REPLY_AND_DETAILS_MACRO(t, p, body) \
205 do { \
206  vl_api_registration_t *rp; \
207  rp = vl_api_client_index_to_registration (mp->client_index); \
208  if (rp == 0) \
209  return; \
210  u32 cursor = clib_net_to_host_u32 (mp->cursor); \
211  vlib_main_t *vm = vlib_get_main (); \
212  f64 start = vlib_time_now (vm); \
213  if (pool_is_free_index (p, cursor)) { \
214  cursor = pool_next_index (p, cursor); \
215  if (cursor == ~0) \
216  rv = VNET_API_ERROR_INVALID_VALUE; \
217  } \
218  while (cursor != ~0) { \
219  do {body;} while (0); \
220  cursor = pool_next_index (p, cursor); \
221  if (vl_api_process_may_suspend (vm, rp, start)) { \
222  if (cursor != ~0) \
223  rv = VNET_API_ERROR_EAGAIN; \
224  break; \
225  } \
226  } \
227  REPLY_MACRO2 (t, ({ \
228  rmp->cursor = clib_host_to_net_u32 (cursor); \
229  })); \
230 } while(0);
231 
232 /* "trust, but verify" */
233 
234 static inline uword
235 vnet_sw_if_index_is_api_valid (u32 sw_if_index)
236 {
237  return vnet_sw_interface_is_api_valid (vnet_get_main (), sw_if_index);
238 }
239 
240 #define VALIDATE_SW_IF_INDEX(mp) \
241  do { u32 __sw_if_index = ntohl((mp)->sw_if_index); \
242  if (!vnet_sw_if_index_is_api_valid(__sw_if_index)) { \
243  rv = VNET_API_ERROR_INVALID_SW_IF_INDEX; \
244  goto bad_sw_if_index; \
245  } \
246 } while(0);
247 
248 #define BAD_SW_IF_INDEX_LABEL \
249 do { \
250 bad_sw_if_index: \
251  ; \
252 } while (0);
253 
254 #define VALIDATE_RX_SW_IF_INDEX(mp) \
255  do { u32 __rx_sw_if_index = ntohl((mp)->rx_sw_if_index); \
256  if (!vnet_sw_if_index_is_api_valid(__rx_sw_if_index)) { \
257  rv = VNET_API_ERROR_INVALID_SW_IF_INDEX; \
258  goto bad_rx_sw_if_index; \
259  } \
260 } while(0);
261 
262 #define BAD_RX_SW_IF_INDEX_LABEL \
263 do { \
264 bad_rx_sw_if_index: \
265  ; \
266 } while (0);
267 
268 #define VALIDATE_TX_SW_IF_INDEX(mp) \
269  do { u32 __tx_sw_if_index = ntohl(mp->tx_sw_if_index); \
270  if (!vnet_sw_if_index_is_api_valid(__tx_sw_if_index)) { \
271  rv = VNET_API_ERROR_INVALID_SW_IF_INDEX; \
272  goto bad_tx_sw_if_index; \
273  } \
274 } while(0);
275 
276 #define BAD_TX_SW_IF_INDEX_LABEL \
277 do { \
278 bad_tx_sw_if_index: \
279  ; \
280 } while (0);
281 
282 #define VALIDATE_BD_ID(mp) \
283  do { u32 __rx_bd_id = ntohl(mp->bd_id); \
284  if (__rx_bd_id > L2_BD_ID_MAX) { \
285  rv = VNET_API_ERROR_BD_ID_EXCEED_MAX; \
286  goto bad_bd_id; \
287  } \
288 } while(0);
289 
290 #define BAD_BD_ID_LABEL \
291 do { \
292 bad_bd_id: \
293  ; \
294 } while (0);
295 
296 #define pub_sub_handler(lca,UCA) \
297 static void vl_api_want_##lca##_t_handler ( \
298  vl_api_want_##lca##_t *mp) \
299 { \
300  vpe_api_main_t *vam = &vpe_api_main; \
301  vpe_client_registration_t *rp; \
302  vl_api_want_##lca##_reply_t *rmp; \
303  uword *p; \
304  i32 rv = 0; \
305  \
306  p = hash_get (vam->lca##_registration_hash, mp->client_index); \
307  if (p) { \
308  if (mp->enable_disable) { \
309  clib_warning ("pid %d: already enabled...", ntohl(mp->pid)); \
310  rv = VNET_API_ERROR_INVALID_REGISTRATION; \
311  goto reply; \
312  } else { \
313  rp = pool_elt_at_index (vam->lca##_registrations, p[0]); \
314  pool_put (vam->lca##_registrations, rp); \
315  hash_unset (vam->lca##_registration_hash, \
316  mp->client_index); \
317  goto reply; \
318  } \
319  } \
320  if (mp->enable_disable == 0) { \
321  clib_warning ("pid %d: already disabled...", mp->pid); \
322  rv = VNET_API_ERROR_INVALID_REGISTRATION; \
323  goto reply; \
324  } \
325  pool_get (vam->lca##_registrations, rp); \
326  rp->client_index = mp->client_index; \
327  rp->client_pid = mp->pid; \
328  hash_set (vam->lca##_registration_hash, rp->client_index, \
329  rp - vam->lca##_registrations); \
330  \
331 reply: \
332  REPLY_MACRO (VL_API_WANT_##UCA##_REPLY); \
333 } \
334  \
335 static clib_error_t * vl_api_want_##lca##_t_reaper (u32 client_index) \
336 { \
337  vpe_api_main_t *vam = &vpe_api_main; \
338  vpe_client_registration_t *rp; \
339  uword *p; \
340  \
341  p = hash_get (vam->lca##_registration_hash, client_index); \
342  if (p) \
343  { \
344  rp = pool_elt_at_index (vam->lca##_registrations, p[0]); \
345  pool_put (vam->lca##_registrations, rp); \
346  hash_unset (vam->lca##_registration_hash, client_index); \
347  } \
348  return (NULL); \
349 } \
350  \
351 VL_MSG_API_REAPER_FUNCTION (vl_api_want_##lca##_t_reaper); \
352 
353 #define foreach_registration_hash \
354 _(interface_events) \
355 _(to_netconf_server) \
356 _(from_netconf_server) \
357 _(to_netconf_client) \
358 _(from_netconf_client) \
359 _(oam_events) \
360 _(bfd_events) \
361 _(l2_arp_term_events) \
362 _(ip6_ra_events) \
363 _(dhcp6_pd_reply_events) \
364 _(dhcp6_reply_events)
365 
366 typedef struct
367 {
368  u32 client_index; /* in memclnt registration pool */
369  u32 client_pid;
370 } vpe_client_registration_t;
371 
372 typedef struct
373 {
374 #define _(a) \
375  uword *a##_registration_hash; \
376  vpe_client_registration_t * a##_registrations;
377  foreach_registration_hash
378 #undef _
379  /* notifications happen really early in the game */
380  u8 link_state_process_up;
381 
382  /* convenience */
383  vlib_main_t *vlib_main;
384  vnet_main_t *vnet_main;
385 } vpe_api_main_t;
386 
387 extern vpe_api_main_t vpe_api_main;
388 
389 #endif /* __api_helper_macros_h__ */
390 
391 /*
392  * fd.io coding-style-patch-verification: ON
393  *
394  * Local Variables:
395  * eval: (c-set-style "gnu")
396  * End:
397  */
vpe_api_main_t::vnet_main
vnet_main_t * vnet_main
Definition: api_helper_macros.h:384
vpe_api_main_t
Definition: api_helper_macros.h:372
vnet_get_main
vnet_main_t * vnet_get_main(void)
Definition: misc.c:46
vpe_api_main_t::vlib_main
vlib_main_t * vlib_main
Definition: api_helper_macros.h:383
u8
unsigned char u8
Definition: types.h:56
u32
unsigned int u32
Definition: types.h:88
vpe_client_registration_t::client_pid
u32 client_pid
Definition: api_helper_macros.h:369
vnet_sw_if_index_is_api_valid
static uword vnet_sw_if_index_is_api_valid(u32 sw_if_index)
Definition: api_helper_macros.h:235
vnet_main_t
Definition: vnet.h:54
vpe_api_main_t::link_state_process_up
foreach_registration_hash u8 link_state_process_up
Definition: api_helper_macros.h:380
vpe_client_registration_t
Definition: api_helper_macros.h:366
vnet_sw_interface_is_api_valid
static uword vnet_sw_interface_is_api_valid(vnet_main_t *vnm, u32 sw_if_index)
Definition: interface_funcs.h:285
vlib_main_t
Definition: main.h:120
uword
u64 uword
Definition: types.h:112
vpe_client_registration_t::client_index
u32 client_index
Definition: api_helper_macros.h:368
vpe_api_main
vpe_api_main_t vpe_api_main
Definition: interface_api.c:54
sw_if_index
vl_api_interface_index_t sw_if_index
Definition: wireguard.api:33
foreach_registration_hash
#define foreach_registration_hash
Definition: api_helper_macros.h:353