Gitiles
Code Review Sign In
gerrit.nordix.org / fdio / vpp / c99ab12cbb9252806db55f7a79e5d84b41df3525 / . / src / vlibapi / api_helper_macros.h
blob: d49282e9e65f4b9109b6761ca309ee7eee25344f [file] [log] [blame]
Dave Barachaff70772016-10-31 11:59:07 -0400[diff] [blame]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
Dave Barachaff70772016-10-31 11:59:07 -0400[diff] [blame]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
Eyal Bari0856b972017-03-15 14:54:19 +0200[diff] [blame]26#ifndef REPLY_MSG_ID_BASE
27#define REPLY_MSG_ID_BASE 0
28#endif
29
Dave Barach59b25652017-09-10 15:04:27 -0400[diff] [blame]30#define REPLY_MACRO(t) \
31do { \
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 \
Florin Corase86a8ed2018-01-05 03:20:25 -0800[diff] [blame]43 vl_api_send_msg (rp, (u8 *)rmp); \
Dave Barachaff70772016-10-31 11:59:07 -0400[diff] [blame]44} while(0);
45
Ole Troanbad67922020-08-24 12:22:01 +0200[diff] [blame]46#define REPLY_MACRO_END(t) \
47do { \
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
Dave Barach59b25652017-09-10 15:04:27 -0400[diff] [blame]65#define REPLY_MACRO2(t, body) \
66do { \
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); \
Florin Corase86a8ed2018-01-05 03:20:25 -0800[diff] [blame]78 vl_api_send_msg (rp, (u8 *)rmp); \
Dave Barachaff70772016-10-31 11:59:07 -0400[diff] [blame]79} while(0);
80
Ole Troane796a182020-05-18 11:14:05 +0200[diff] [blame]81#define REPLY_MACRO2_END(t, body) \
82do { \
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 *); \
Ole Troanbad67922020-08-24 12:22:01 +0200[diff] [blame]96 endian_fp = am->msg_endian_handlers[t+(REPLY_MSG_ID_BASE)]; \
Ole Troane796a182020-05-18 11:14:05 +0200[diff] [blame]97 (*endian_fp) (rmp); \
98 vl_api_send_msg (rp, (u8 *)rmp); \
99} while(0);
100
Paul Vinciguerraf24de172020-01-27 18:42:25 -0500[diff] [blame]101#define REPLY_MACRO2_ZERO(t, body) \
102do { \
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
Ole Troan2a1ca782019-09-19 01:08:30 +0200[diff] [blame]117#define REPLY_MACRO_DETAILS2(t, body) \
118do { \
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
Ole Troanf5db3712020-05-20 15:47:06 +0200[diff] [blame]132#define REPLY_MACRO_DETAILS4(t, rp, context, body) \
133do { \
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
Dave Barach59b25652017-09-10 15:04:27 -0400[diff] [blame]141#define REPLY_MACRO3(t, n, body) \
142do { \
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); \
Florin Corase86a8ed2018-01-05 03:20:25 -0800[diff] [blame]154 vl_api_send_msg (rp, (u8 *)rmp); \
Dave Barachaff70772016-10-31 11:59:07 -0400[diff] [blame]155} while(0);
156
Paul Vinciguerraf24de172020-01-27 18:42:25 -0500[diff] [blame]157#define REPLY_MACRO3_ZERO(t, n, body) \
158do { \
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
Dave Barach59b25652017-09-10 15:04:27 -0400[diff] [blame]173#define REPLY_MACRO4(t, n, body) \
174do { \
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 \
Dave Barachb7b92992018-10-17 10:38:51 -0400[diff] [blame]192 clib_memset (rmp, 0, sizeof (*rmp)); \
Dave Barach59b25652017-09-10 15:04:27 -0400[diff] [blame]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); \
Florin Corase86a8ed2018-01-05 03:20:25 -0800[diff] [blame]201 vl_api_send_msg (rp, (u8 *)rmp); \
Dave Barachaff70772016-10-31 11:59:07 -0400[diff] [blame]202} while(0);
203
Neale Ranns44db1ca2020-12-24 09:16:09 +0000[diff] [blame]204#define REPLY_AND_DETAILS_MACRO(t, p, body) \
205 do \
206 { \
207 if (pool_elts (p) == 0) \
208 { \
209 REPLY_MACRO (t); \
210 break; \
211 } \
212 vl_api_registration_t *rp; \
213 rp = vl_api_client_index_to_registration (mp->client_index); \
214 if (rp == 0) \
215 return; \
216 u32 cursor = clib_net_to_host_u32 (mp->cursor); \
217 vlib_main_t *vm = vlib_get_main (); \
218 f64 start = vlib_time_now (vm); \
219 if (pool_is_free_index (p, cursor)) \
220 { \
221 cursor = pool_next_index (p, cursor); \
222 if (cursor == ~0) \
223 rv = VNET_API_ERROR_INVALID_VALUE; \
224 } \
225 while (cursor != ~0) \
226 { \
227 do \
228 { \
229 body; \
230 } \
231 while (0); \
232 cursor = pool_next_index (p, cursor); \
233 if (vl_api_process_may_suspend (vm, rp, start)) \
234 { \
235 if (cursor != ~0) \
236 rv = VNET_API_ERROR_EAGAIN; \
237 break; \
238 } \
239 } \
240 REPLY_MACRO2 (t, ({ rmp->cursor = clib_host_to_net_u32 (cursor); })); \
241 } \
242 while (0);
Ole Troanf5db3712020-05-20 15:47:06 +0200[diff] [blame]243
Jon Loeligerc0b19542020-05-11 08:43:51 -0500[diff] [blame]244#define REPLY_AND_DETAILS_VEC_MACRO(t, v, mp, rmp, rv, body) \
245do { \
246 vl_api_registration_t *rp; \
247 rp = vl_api_client_index_to_registration (mp->client_index); \
248 if (rp == 0) \
249 return; \
250 u32 cursor = clib_net_to_host_u32 (mp->cursor); \
251 vlib_main_t *vm = vlib_get_main (); \
252 f64 start = vlib_time_now (vm); \
253 if (!v || vec_len (v) == 0) { \
254 cursor = ~0; \
255 rv = VNET_API_ERROR_INVALID_VALUE; \
256 } else if (cursor == ~0) \
257 cursor = 0; \
258 while (cursor != ~0 && cursor < vec_len (v)) { \
259 do {body;} while (0); \
260 ++cursor; \
261 if (vl_api_process_may_suspend (vm, rp, start)) { \
262 if (cursor < vec_len (v)) \
263 rv = VNET_API_ERROR_EAGAIN; \
264 break; \
265 } \
266 } \
267 REPLY_MACRO2 (t, ({ \
268 rmp->cursor = clib_host_to_net_u32 (cursor); \
269 })); \
270} while(0);
271
272
Dave Barachaff70772016-10-31 11:59:07 -0400[diff] [blame]273/* "trust, but verify" */
274
Eyal Bari1c82cd42017-03-14 14:39:51 +0200[diff] [blame]275static inline uword
276vnet_sw_if_index_is_api_valid (u32 sw_if_index)
277{
278 return vnet_sw_interface_is_api_valid (vnet_get_main (), sw_if_index);
279}
280
Dave Barachaff70772016-10-31 11:59:07 -0400[diff] [blame]281#define VALIDATE_SW_IF_INDEX(mp) \
Neale Ranns947ea622018-06-07 23:48:20 -0700[diff] [blame]282 do { u32 __sw_if_index = ntohl((mp)->sw_if_index); \
Eyal Bari1c82cd42017-03-14 14:39:51 +0200[diff] [blame]283 if (!vnet_sw_if_index_is_api_valid(__sw_if_index)) { \
Dave Barachaff70772016-10-31 11:59:07 -0400[diff] [blame]284 rv = VNET_API_ERROR_INVALID_SW_IF_INDEX; \
285 goto bad_sw_if_index; \
286 } \
287} while(0);
288
289#define BAD_SW_IF_INDEX_LABEL \
290do { \
291bad_sw_if_index: \
292 ; \
293} while (0);
294
295#define VALIDATE_RX_SW_IF_INDEX(mp) \
Neale Ranns947ea622018-06-07 23:48:20 -0700[diff] [blame]296 do { u32 __rx_sw_if_index = ntohl((mp)->rx_sw_if_index); \
Eyal Bari1c82cd42017-03-14 14:39:51 +0200[diff] [blame]297 if (!vnet_sw_if_index_is_api_valid(__rx_sw_if_index)) { \
Dave Barachaff70772016-10-31 11:59:07 -0400[diff] [blame]298 rv = VNET_API_ERROR_INVALID_SW_IF_INDEX; \
299 goto bad_rx_sw_if_index; \
300 } \
301} while(0);
302
303#define BAD_RX_SW_IF_INDEX_LABEL \
304do { \
305bad_rx_sw_if_index: \
306 ; \
307} while (0);
308
309#define VALIDATE_TX_SW_IF_INDEX(mp) \
310 do { u32 __tx_sw_if_index = ntohl(mp->tx_sw_if_index); \
Eyal Bari1c82cd42017-03-14 14:39:51 +0200[diff] [blame]311 if (!vnet_sw_if_index_is_api_valid(__tx_sw_if_index)) { \
Dave Barachaff70772016-10-31 11:59:07 -0400[diff] [blame]312 rv = VNET_API_ERROR_INVALID_SW_IF_INDEX; \
313 goto bad_tx_sw_if_index; \
314 } \
315} while(0);
316
317#define BAD_TX_SW_IF_INDEX_LABEL \
318do { \
319bad_tx_sw_if_index: \
320 ; \
321} while (0);
322
John Lo97934772017-05-18 22:26:47 -0400[diff] [blame]323#define VALIDATE_BD_ID(mp) \
324 do { u32 __rx_bd_id = ntohl(mp->bd_id); \
325 if (__rx_bd_id > L2_BD_ID_MAX) { \
326 rv = VNET_API_ERROR_BD_ID_EXCEED_MAX; \
327 goto bad_bd_id; \
328 } \
329} while(0);
330
331#define BAD_BD_ID_LABEL \
332do { \
333bad_bd_id: \
334 ; \
335} while (0);
336
Dave Barach6d963c22016-12-05 09:50:05 -0500[diff] [blame]337#define pub_sub_handler(lca,UCA) \
338static void vl_api_want_##lca##_t_handler ( \
339 vl_api_want_##lca##_t *mp) \
340{ \
341 vpe_api_main_t *vam = &vpe_api_main; \
342 vpe_client_registration_t *rp; \
343 vl_api_want_##lca##_reply_t *rmp; \
344 uword *p; \
345 i32 rv = 0; \
346 \
347 p = hash_get (vam->lca##_registration_hash, mp->client_index); \
348 if (p) { \
349 if (mp->enable_disable) { \
Ole Troan32ef1372019-01-07 22:17:31 +0100[diff] [blame]350 clib_warning ("pid %d: already enabled...", ntohl(mp->pid)); \
Dave Barach6d963c22016-12-05 09:50:05 -0500[diff] [blame]351 rv = VNET_API_ERROR_INVALID_REGISTRATION; \
352 goto reply; \
353 } else { \
354 rp = pool_elt_at_index (vam->lca##_registrations, p[0]); \
355 pool_put (vam->lca##_registrations, rp); \
356 hash_unset (vam->lca##_registration_hash, \
357 mp->client_index); \
358 goto reply; \
359 } \
360 } \
361 if (mp->enable_disable == 0) { \
362 clib_warning ("pid %d: already disabled...", mp->pid); \
363 rv = VNET_API_ERROR_INVALID_REGISTRATION; \
364 goto reply; \
365 } \
366 pool_get (vam->lca##_registrations, rp); \
367 rp->client_index = mp->client_index; \
368 rp->client_pid = mp->pid; \
369 hash_set (vam->lca##_registration_hash, rp->client_index, \
370 rp - vam->lca##_registrations); \
371 \
372reply: \
373 REPLY_MACRO (VL_API_WANT_##UCA##_REPLY); \
Neale Rannsf12dad62018-06-04 18:41:24 -0700[diff] [blame]374} \
375 \
376static clib_error_t * vl_api_want_##lca##_t_reaper (u32 client_index) \
377{ \
378 vpe_api_main_t *vam = &vpe_api_main; \
379 vpe_client_registration_t *rp; \
380 uword *p; \
381 \
Matthew Smithd4656312018-06-14 11:40:49 -0500[diff] [blame]382 p = hash_get (vam->lca##_registration_hash, client_index); \
Neale Rannsf12dad62018-06-04 18:41:24 -0700[diff] [blame]383 if (p) \
384 { \
385 rp = pool_elt_at_index (vam->lca##_registrations, p[0]); \
386 pool_put (vam->lca##_registrations, rp); \
387 hash_unset (vam->lca##_registration_hash, client_index); \
388 } \
389 return (NULL); \
390} \
391 \
392VL_MSG_API_REAPER_FUNCTION (vl_api_want_##lca##_t_reaper); \
Dave Barach6d963c22016-12-05 09:50:05 -0500[diff] [blame]393
394#define foreach_registration_hash \
395_(interface_events) \
396_(to_netconf_server) \
397_(from_netconf_server) \
398_(to_netconf_client) \
399_(from_netconf_client) \
Klement Sekera0e3c0de2016-09-29 14:43:44 +0200[diff] [blame]400_(oam_events) \
Eyal Bari20197482017-09-13 12:29:08 +0300[diff] [blame]401_(bfd_events) \
Neale Rannscbe25aa2019-09-30 10:53:31 +0000[diff] [blame]402_(l2_arp_term_events) \
Juraj Sloboda81119e82018-05-25 14:02:20 +0200[diff] [blame]403_(ip6_ra_events) \
Juraj Slobodadd3b8f72018-05-04 14:20:06 +0200[diff] [blame]404_(dhcp6_pd_reply_events) \
Matthew Smith78f487e2020-10-08 11:11:27 -0500[diff] [blame]405_(dhcp6_reply_events) \
406_(vrrp_vr_events)
Dave Barach6d963c22016-12-05 09:50:05 -0500[diff] [blame]407
Dave Barach6d963c22016-12-05 09:50:05 -0500[diff] [blame]408typedef struct
409{
410 u32 client_index; /* in memclnt registration pool */
411 u32 client_pid;
412} vpe_client_registration_t;
413
Dave Barach6d963c22016-12-05 09:50:05 -0500[diff] [blame]414typedef struct
415{
Neale Rannscbe25aa2019-09-30 10:53:31 +0000[diff] [blame]416#define _(a) \
417 uword *a##_registration_hash; \
418 vpe_client_registration_t * a##_registrations;
Dave Barach6d963c22016-12-05 09:50:05 -0500[diff] [blame]419 foreach_registration_hash
420#undef _
421 /* notifications happen really early in the game */
422 u8 link_state_process_up;
423
Dave Barach6d963c22016-12-05 09:50:05 -0500[diff] [blame]424 /* convenience */
425 vlib_main_t *vlib_main;
426 vnet_main_t *vnet_main;
427} vpe_api_main_t;
428
429extern vpe_api_main_t vpe_api_main;
430
Dave Barachaff70772016-10-31 11:59:07 -0400[diff] [blame]431#endif /* __api_helper_macros_h__ */
432
433/*
434 * fd.io coding-style-patch-verification: ON
435 *
436 * Local Variables:
437 * eval: (c-set-style "gnu")
438 * End:
439 */