2 * Copyright (c) 2018 Cisco and/or its affiliates.
3 * Licensed under the Apache License, Version 2.0 (the "License");
5 * You may obtain a copy of the License at:
7 * http://www.apache.org/licenses/LICENSE-2.0
9 * Unless required by applicable law or agreed to in writing, software
10 * distributed under the License is distributed on an "AS IS" BASIS,
11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 * See the License for the specific language governing permissions and
13 * limitations under the License.
16 #include <vcl/vcl_private.h>
17 #include <vlibmemory/api.h>
18 #include <vpp/api/vpe_msg_enum.h>
20 #define vl_typedefs /* define message structures */
21 #include <vpp/api/vpe_all_api_h.h>
24 /* declare message handlers for each api */
26 #define vl_endianfun /* define message structures */
27 #include <vpp/api/vpe_all_api_h.h>
30 /* instantiate all the print functions we know about */
31 #define vl_print(handle, ...)
33 #include <vpp/api/vpe_all_api_h.h>
37 format_api_error (u8 * s, va_list * args)
39 i32 error = va_arg (*args, u32);
42 p = hash_get (vcm->error_string_by_error_number, -error);
45 s = format (s, "%s (%d)", p[0], error);
47 s = format (s, "%d", error);
52 vl_api_session_enable_disable_reply_t_handler
53 (vl_api_session_enable_disable_reply_t * mp)
57 clib_warning ("VCL<%d>: session_enable_disable failed: %U", getpid (),
58 format_api_error, ntohl (mp->retval));
61 vcm->app_state = STATE_APP_ENABLED;
65 ssvm_segment_attach (char *name, ssvm_segment_type_t type, int fd)
67 svm_fifo_segment_create_args_t _a, *a = &_a;
70 memset (a, 0, sizeof (*a));
71 a->segment_name = (char *) name;
72 a->segment_type = type;
74 if (type == SSVM_SEGMENT_MEMFD)
77 if ((rv = svm_fifo_segment_attach (a)))
79 clib_warning ("svm_fifo_segment_attach ('%s') failed", name);
82 vec_reset_length (a->new_segment_indices);
87 vl_api_application_attach_reply_t_handler (vl_api_application_attach_reply_t *
90 vcl_worker_t *wrk = vcl_worker_get (0);
96 clib_warning ("VCL<%d>: attach failed: %U", getpid (),
97 format_api_error, ntohl (mp->retval));
101 wrk->app_event_queue = uword_to_pointer (mp->app_event_queue_address,
105 vec_validate (fds, mp->n_fds);
106 vl_socket_client_recv_fd_msg (fds, mp->n_fds, 5);
108 if (mp->fd_flags & SESSION_FD_F_VPP_MQ_SEGMENT)
109 if (ssvm_segment_attach ("vpp-mq-seg", SSVM_SEGMENT_MEMFD,
113 if (mp->fd_flags & SESSION_FD_F_MEMFD_SEGMENT)
114 if (ssvm_segment_attach ((char *) mp->segment_name,
115 SSVM_SEGMENT_MEMFD, fds[n_fds++]))
118 if (mp->fd_flags & SESSION_FD_F_MQ_EVENTFD)
120 svm_msg_q_set_consumer_eventfd (wrk->app_event_queue, fds[n_fds]);
121 vcl_mq_epoll_add_evfd (wrk, wrk->app_event_queue);
129 if (ssvm_segment_attach ((char *) mp->segment_name, SSVM_SEGMENT_SHM,
134 vcm->app_index = clib_net_to_host_u32 (mp->app_index);
135 vcm->app_state = STATE_APP_ATTACHED;
139 vl_api_app_worker_add_del_reply_t_handler (vl_api_app_worker_add_del_reply_t *
142 int n_fds = 0, *fds = 0;
148 clib_warning ("VCL<%d>: add/del worker failed: %U", getpid (),
149 format_api_error, ntohl (mp->retval));
152 wrk_index = mp->context;
153 wrk = vcl_worker_get (wrk_index);
154 wrk->vpp_wrk_index = clib_net_to_host_u32 (mp->wrk_index);
159 wrk->app_event_queue = uword_to_pointer (mp->app_event_queue_address,
164 vec_validate (fds, mp->n_fds);
165 vl_socket_client_recv_fd_msg (fds, mp->n_fds, 5);
167 if (mp->fd_flags & SESSION_FD_F_VPP_MQ_SEGMENT)
168 if (ssvm_segment_attach ("vpp-worker-seg", SSVM_SEGMENT_MEMFD,
172 if (mp->fd_flags & SESSION_FD_F_MEMFD_SEGMENT)
173 if (ssvm_segment_attach ((char *) mp->segment_name,
174 SSVM_SEGMENT_MEMFD, fds[n_fds++]))
177 if (mp->fd_flags & SESSION_FD_F_MQ_EVENTFD)
179 svm_msg_q_set_consumer_eventfd (wrk->app_event_queue, fds[n_fds]);
180 vcl_mq_epoll_add_evfd (wrk, wrk->app_event_queue);
188 if (ssvm_segment_attach ((char *) mp->segment_name, SSVM_SEGMENT_SHM,
192 vcm->app_state = STATE_APP_READY;
193 VDBG (0, "worker %u vpp-worker %u added", wrk_index, wrk->vpp_wrk_index);
197 vcm->app_state = STATE_APP_FAILED;
201 vl_api_application_detach_reply_t_handler (vl_api_application_detach_reply_t *
205 clib_warning ("VCL<%d>: detach failed: %U", getpid (), format_api_error,
208 vcm->app_state = STATE_APP_ENABLED;
212 vl_api_map_another_segment_t_handler (vl_api_map_another_segment_t * mp)
214 ssvm_segment_type_t seg_type = SSVM_SEGMENT_SHM;
217 vcm->mounting_segment = 1;
221 vl_socket_client_recv_fd_msg (&fd, 1, 5);
222 seg_type = SSVM_SEGMENT_MEMFD;
225 if (PREDICT_FALSE (ssvm_segment_attach ((char *) mp->segment_name,
228 clib_warning ("VCL<%d>: svm_fifo_segment_attach ('%s') failed",
229 getpid (), mp->segment_name);
233 VDBG (1, "VCL<%d>: mapped new segment '%s' size %d", getpid (),
234 mp->segment_name, mp->segment_size);
235 vcm->mounting_segment = 0;
239 vl_api_unmap_segment_t_handler (vl_api_unmap_segment_t * mp)
243 * XXX Need segment_name to session_id hash,
244 * XXX - have sessionID by handle hash currently
247 VDBG (1, "Unmapped segment '%s'",
248 clib_net_to_host_u64 (mp->segment_handle));
252 vl_api_app_cut_through_registration_add_t_handler
253 (vl_api_app_cut_through_registration_add_t * mp)
255 vcl_cut_through_registration_t *ctr;
262 ASSERT (mp->n_fds == 2);
263 vec_validate (fds, mp->n_fds);
264 vl_socket_client_recv_fd_msg (fds, mp->n_fds, 5);
267 wrk = vcl_worker_get (mp->wrk_index);
268 ctr = vcl_ct_registration_lock_and_alloc (wrk);
269 ctr->mq = uword_to_pointer (mp->evt_q_address, svm_msg_q_t *);
270 ctr->peer_mq = uword_to_pointer (mp->peer_evt_q_address, svm_msg_q_t *);
271 VDBG (0, "Adding ct registration %u", vcl_ct_registration_index (wrk, ctr));
273 if (mp->n_fds && (mp->fd_flags & SESSION_FD_F_MQ_EVENTFD))
275 svm_msg_q_set_consumer_eventfd (ctr->mq, fds[0]);
276 svm_msg_q_set_producer_eventfd (ctr->peer_mq, fds[1]);
277 mqc_index = vcl_mq_epoll_add_evfd (wrk, ctr->mq);
278 ctr->epoll_evt_conn_index = mqc_index;
281 vcl_ct_registration_lookup_add (wrk, mp->evt_q_address,
282 vcl_ct_registration_index (wrk, ctr));
283 vcl_ct_registration_unlock (wrk);
287 vl_api_bind_sock_reply_t_handler (vl_api_bind_sock_reply_t * mp)
289 /* Expecting a similar message on mq. So ignore this */
290 VDBG (1, "VCL<%d>: bapi msg vpp handle 0x%llx, sid %u: bind retval: %u!",
291 getpid (), mp->handle, mp->context, mp->retval);
295 vl_api_unbind_sock_reply_t_handler (vl_api_unbind_sock_reply_t * mp)
298 clib_warning ("VCL<%d>: ERROR: sid %u: unbind failed: %U",
299 getpid (), mp->context, format_api_error,
303 VDBG (1, "VCL<%d>: sid %u: unbind succeeded!", getpid (), mp->context);
307 vl_api_disconnect_session_reply_t_handler (vl_api_disconnect_session_reply_t *
311 clib_warning ("VCL<%d>: ERROR: sid %u: disconnect failed: %U",
312 getpid (), mp->context, format_api_error,
317 vl_api_connect_session_reply_t_handler (vl_api_connect_sock_reply_t * mp)
320 clib_warning ("VCL<%d>: ERROR: sid %u: connect failed: %U",
321 getpid (), mp->context, format_api_error,
325 #define foreach_sock_msg \
326 _(SESSION_ENABLE_DISABLE_REPLY, session_enable_disable_reply) \
327 _(BIND_SOCK_REPLY, bind_sock_reply) \
328 _(UNBIND_SOCK_REPLY, unbind_sock_reply) \
329 _(CONNECT_SESSION_REPLY, connect_session_reply) \
330 _(DISCONNECT_SESSION_REPLY, disconnect_session_reply) \
331 _(APPLICATION_ATTACH_REPLY, application_attach_reply) \
332 _(APPLICATION_DETACH_REPLY, application_detach_reply) \
333 _(MAP_ANOTHER_SEGMENT, map_another_segment) \
334 _(UNMAP_SEGMENT, unmap_segment) \
335 _(APP_CUT_THROUGH_REGISTRATION_ADD, app_cut_through_registration_add) \
336 _(APP_WORKER_ADD_DEL_REPLY, app_worker_add_del_reply) \
339 vppcom_api_hookup (void)
342 vl_msg_api_set_handlers(VL_API_##N, #n, \
343 vl_api_##n##_t_handler, \
345 vl_api_##n##_t_endian, \
346 vl_api_##n##_t_print, \
347 sizeof(vl_api_##n##_t), 1);
353 * VPP-API message functions
356 vppcom_send_session_enable_disable (u8 is_enable)
358 vcl_worker_t *wrk = vcl_worker_get_current ();
359 vl_api_session_enable_disable_t *bmp;
360 bmp = vl_msg_api_alloc (sizeof (*bmp));
361 memset (bmp, 0, sizeof (*bmp));
363 bmp->_vl_msg_id = ntohs (VL_API_SESSION_ENABLE_DISABLE);
364 bmp->client_index = wrk->my_client_index;
365 bmp->context = htonl (0xfeedface);
366 bmp->is_enable = is_enable;
367 vl_msg_api_send_shmem (wrk->vl_input_queue, (u8 *) & bmp);
371 vppcom_app_send_attach (void)
373 vcl_worker_t *wrk = vcl_worker_get_current ();
374 vl_api_application_attach_t *bmp;
375 u8 nsid_len = vec_len (vcm->cfg.namespace_id);
376 u8 app_is_proxy = (vcm->cfg.app_proxy_transport_tcp ||
377 vcm->cfg.app_proxy_transport_udp);
379 bmp = vl_msg_api_alloc (sizeof (*bmp));
380 memset (bmp, 0, sizeof (*bmp));
382 bmp->_vl_msg_id = ntohs (VL_API_APPLICATION_ATTACH);
383 bmp->client_index = wrk->my_client_index;
384 bmp->context = htonl (0xfeedface);
385 bmp->options[APP_OPTIONS_FLAGS] =
386 APP_OPTIONS_FLAGS_ACCEPT_REDIRECT | APP_OPTIONS_FLAGS_ADD_SEGMENT |
387 (vcm->cfg.app_scope_local ? APP_OPTIONS_FLAGS_USE_LOCAL_SCOPE : 0) |
388 (vcm->cfg.app_scope_global ? APP_OPTIONS_FLAGS_USE_GLOBAL_SCOPE : 0) |
389 (app_is_proxy ? APP_OPTIONS_FLAGS_IS_PROXY : 0) |
390 APP_OPTIONS_FLAGS_USE_MQ_FOR_CTRL_MSGS |
391 (vcm->cfg.use_mq_eventfd ? APP_OPTIONS_FLAGS_EVT_MQ_USE_EVENTFD : 0);
392 bmp->options[APP_OPTIONS_PROXY_TRANSPORT] =
393 (u64) ((vcm->cfg.app_proxy_transport_tcp ? 1 << TRANSPORT_PROTO_TCP : 0) |
394 (vcm->cfg.app_proxy_transport_udp ? 1 << TRANSPORT_PROTO_UDP : 0));
395 bmp->options[APP_OPTIONS_SEGMENT_SIZE] = vcm->cfg.segment_size;
396 bmp->options[APP_OPTIONS_ADD_SEGMENT_SIZE] = vcm->cfg.add_segment_size;
397 bmp->options[APP_OPTIONS_RX_FIFO_SIZE] = vcm->cfg.rx_fifo_size;
398 bmp->options[APP_OPTIONS_TX_FIFO_SIZE] = vcm->cfg.tx_fifo_size;
399 bmp->options[APP_OPTIONS_PREALLOC_FIFO_PAIRS] =
400 vcm->cfg.preallocated_fifo_pairs;
401 bmp->options[APP_OPTIONS_EVT_QUEUE_SIZE] = vcm->cfg.event_queue_size;
404 bmp->namespace_id_len = nsid_len;
405 clib_memcpy_fast (bmp->namespace_id, vcm->cfg.namespace_id, nsid_len);
406 bmp->options[APP_OPTIONS_NAMESPACE_SECRET] = vcm->cfg.namespace_secret;
408 vl_msg_api_send_shmem (wrk->vl_input_queue, (u8 *) & bmp);
412 vppcom_app_send_detach (void)
414 vcl_worker_t *wrk = vcl_worker_get_current ();
415 vl_api_application_detach_t *bmp;
416 bmp = vl_msg_api_alloc (sizeof (*bmp));
417 memset (bmp, 0, sizeof (*bmp));
419 bmp->_vl_msg_id = ntohs (VL_API_APPLICATION_DETACH);
420 bmp->client_index = wrk->my_client_index;
421 bmp->context = htonl (0xfeedface);
422 vl_msg_api_send_shmem (wrk->vl_input_queue, (u8 *) & bmp);
426 vcl_send_app_worker_add_del (u8 is_add)
428 vcl_worker_t *wrk = vcl_worker_get_current ();
429 vl_api_app_worker_add_del_t *mp;
430 u32 wrk_index = wrk->wrk_index;
432 mp = vl_msg_api_alloc (sizeof (*mp));
433 memset (mp, 0, sizeof (*mp));
435 mp->_vl_msg_id = ntohs (VL_API_APP_WORKER_ADD_DEL);
436 mp->client_index = wrk->my_client_index;
437 mp->app_index = clib_host_to_net_u32 (vcm->app_index);
438 mp->context = wrk_index;
441 mp->wrk_index = clib_host_to_net_u32 (wrk_index);
443 vl_msg_api_send_shmem (wrk->vl_input_queue, (u8 *) & mp);
447 vppcom_send_connect_sock (vcl_session_t * session)
449 vcl_worker_t *wrk = vcl_worker_get_current ();
450 vl_api_connect_sock_t *cmp;
452 cmp = vl_msg_api_alloc (sizeof (*cmp));
453 memset (cmp, 0, sizeof (*cmp));
454 cmp->_vl_msg_id = ntohs (VL_API_CONNECT_SOCK);
455 cmp->client_index = wrk->my_client_index;
456 cmp->context = session->session_index;
457 cmp->wrk_index = wrk->vpp_wrk_index;
458 cmp->is_ip4 = session->transport.is_ip4;
459 clib_memcpy_fast (cmp->ip, &session->transport.rmt_ip, sizeof (cmp->ip));
460 cmp->port = session->transport.rmt_port;
461 cmp->proto = session->session_type;
462 clib_memcpy_fast (cmp->options, session->options, sizeof (cmp->options));
463 vl_msg_api_send_shmem (wrk->vl_input_queue, (u8 *) & cmp);
467 vppcom_send_disconnect_session (u64 vpp_handle)
469 vcl_worker_t *wrk = vcl_worker_get_current ();
470 vl_api_disconnect_session_t *dmp;
472 dmp = vl_msg_api_alloc (sizeof (*dmp));
473 memset (dmp, 0, sizeof (*dmp));
474 dmp->_vl_msg_id = ntohs (VL_API_DISCONNECT_SESSION);
475 dmp->client_index = wrk->my_client_index;
476 dmp->handle = vpp_handle;
477 vl_msg_api_send_shmem (wrk->vl_input_queue, (u8 *) & dmp);
480 /* VPP combines bind and listen as one operation. VCL manages the separation
481 * of bind and listen locally via vppcom_session_bind() and
482 * vppcom_session_listen() */
484 vppcom_send_bind_sock (vcl_session_t * session)
486 vcl_worker_t *wrk = vcl_worker_get_current ();
487 vl_api_bind_sock_t *bmp;
489 /* Assumes caller has acquired spinlock: vcm->sessions_lockp */
490 bmp = vl_msg_api_alloc (sizeof (*bmp));
491 memset (bmp, 0, sizeof (*bmp));
493 bmp->_vl_msg_id = ntohs (VL_API_BIND_SOCK);
494 bmp->client_index = wrk->my_client_index;
495 bmp->context = session->session_index;
496 bmp->wrk_index = wrk->vpp_wrk_index;
497 bmp->is_ip4 = session->transport.is_ip4;
498 clib_memcpy_fast (bmp->ip, &session->transport.lcl_ip, sizeof (bmp->ip));
499 bmp->port = session->transport.lcl_port;
500 bmp->proto = session->session_type;
501 clib_memcpy_fast (bmp->options, session->options, sizeof (bmp->options));
502 vl_msg_api_send_shmem (wrk->vl_input_queue, (u8 *) & bmp);
506 vppcom_send_unbind_sock (u64 vpp_handle)
508 vcl_worker_t *wrk = vcl_worker_get_current ();
509 vl_api_unbind_sock_t *ump;
511 ump = vl_msg_api_alloc (sizeof (*ump));
512 memset (ump, 0, sizeof (*ump));
514 ump->_vl_msg_id = ntohs (VL_API_UNBIND_SOCK);
515 ump->client_index = wrk->my_client_index;
516 ump->wrk_index = wrk->vpp_wrk_index;
517 ump->handle = vpp_handle;
518 vl_msg_api_send_shmem (wrk->vl_input_queue, (u8 *) & ump);
522 vppcom_send_accept_session_reply (u64 handle, u32 context, int retval)
524 vcl_worker_t *wrk = vcl_worker_get_current ();
525 vl_api_accept_session_reply_t *rmp;
527 rmp = vl_msg_api_alloc (sizeof (*rmp));
528 memset (rmp, 0, sizeof (*rmp));
529 rmp->_vl_msg_id = ntohs (VL_API_ACCEPT_SESSION_REPLY);
530 rmp->retval = htonl (retval);
531 rmp->context = context;
532 rmp->handle = handle;
533 vl_msg_api_send_shmem (wrk->vl_input_queue, (u8 *) & rmp);
537 vcl_max_nsid_len (void)
539 vl_api_application_attach_t *mp;
540 return (sizeof (mp->namespace_id) - 1);
544 vppcom_init_error_string_table (void)
546 vcm->error_string_by_error_number = hash_create (0, sizeof (uword));
548 #define _(n, v, s) hash_set (vcm->error_string_by_error_number, -v, s);
549 foreach_vnet_api_error;
552 hash_set (vcm->error_string_by_error_number, 99, "Misc");
556 vppcom_connect_to_vpp (char *app_name)
558 vcl_worker_t *wrk = vcl_worker_get_current ();
559 api_main_t *am = &api_main;
560 vppcom_cfg_t *vcl_cfg = &vcm->cfg;
562 if (vcl_cfg->vpp_api_socket_name)
564 if (vl_socket_client_connect ((char *) vcl_cfg->vpp_api_socket_name,
565 app_name, 0 /* default rx/tx buffer */ ))
567 VERR ("app (%s) socket connect failed!", app_name);
568 return VPPCOM_ECONNREFUSED;
571 if (vl_socket_client_init_shm (0))
573 VERR ("app (%s) init shm failed!", app_name);
574 return VPPCOM_ECONNREFUSED;
579 if (!vcl_cfg->vpp_api_filename)
580 vcl_cfg->vpp_api_filename = format (0, "/vpe-api%c", 0);
582 VDBG (0, "app (%s) connecting to VPP api (%s)...",
583 app_name, vcl_cfg->vpp_api_filename);
585 if (vl_client_connect_to_vlib ((char *) vcl_cfg->vpp_api_filename,
586 app_name, vcm->cfg.vpp_api_q_length) < 0)
588 VERR ("app (%s) connect failed!", app_name);
589 return VPPCOM_ECONNREFUSED;
594 wrk->vl_input_queue = am->shmem_hdr->vl_input_queue;
595 wrk->my_client_index = (u32) am->my_client_index;
596 wrk->wrk_state = STATE_APP_CONN_VPP;
598 VDBG (0, "app (%s) is connected to VPP!", app_name);
599 vcl_evt (VCL_EVT_INIT, vcm);
604 * fd.io coding-style-patch-verification: ON
607 * eval: (c-set-style "gnu")