2 * Copyright (c) 2015-2016 Cisco and/or its affiliates.
3 * Licensed under the Apache License, Version 2.0 (the "License");
4 * you may not use this file except in compliance with 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 <vnet/vnet.h>
17 #include <vlibmemory/api.h>
18 #include <vnet/session/application.h>
19 #include <vnet/session/application_interface.h>
20 #include <vnet/session/session_rules_table.h>
21 #include <vnet/session/session_table.h>
23 #include <vnet/vnet_msg_enum.h>
25 #define vl_typedefs /* define message structures */
26 #include <vnet/vnet_all_api_h.h>
29 #define vl_endianfun /* define message structures */
30 #include <vnet/vnet_all_api_h.h>
33 /* instantiate all the print functions we know about */
34 #define vl_print(handle, ...) vlib_cli_output (handle, __VA_ARGS__)
36 #include <vnet/vnet_all_api_h.h>
39 #include <vlibapi/api_helper_macros.h>
41 #define foreach_session_api_msg \
42 _(MAP_ANOTHER_SEGMENT_REPLY, map_another_segment_reply) \
43 _(APPLICATION_ATTACH, application_attach) \
44 _(APPLICATION_DETACH, application_detach) \
45 _(BIND_URI, bind_uri) \
46 _(UNBIND_URI, unbind_uri) \
47 _(CONNECT_URI, connect_uri) \
48 _(DISCONNECT_SESSION, disconnect_session) \
49 _(DISCONNECT_SESSION_REPLY, disconnect_session_reply) \
50 _(ACCEPT_SESSION_REPLY, accept_session_reply) \
51 _(RESET_SESSION_REPLY, reset_session_reply) \
52 _(BIND_SOCK, bind_sock) \
53 _(UNBIND_SOCK, unbind_sock) \
54 _(CONNECT_SOCK, connect_sock) \
55 _(SESSION_ENABLE_DISABLE, session_enable_disable) \
56 _(APP_NAMESPACE_ADD_DEL, app_namespace_add_del) \
57 _(SESSION_RULE_ADD_DEL, session_rule_add_del) \
58 _(SESSION_RULES_DUMP, session_rules_dump) \
59 _(APPLICATION_TLS_CERT_ADD, application_tls_cert_add) \
60 _(APPLICATION_TLS_KEY_ADD, application_tls_key_add) \
63 session_send_fds (vl_api_registration_t * reg, int fds[], int n_fds)
66 if (vl_api_registration_file_index (reg) == VL_API_INVALID_FI)
68 clib_warning ("can't send memfd fd");
71 error = vl_api_send_fd_msg (reg, fds, n_fds);
74 clib_error_report (error);
81 send_add_segment_callback (u32 api_client_index, const ssvm_private_t * sp)
83 int fds[SESSION_N_FD_TYPE], n_fds = 0;
84 vl_api_map_another_segment_t *mp;
85 vl_api_registration_t *reg;
88 reg = vl_mem_api_client_index_to_registration (api_client_index);
91 clib_warning ("no registration: %u", api_client_index);
95 if (ssvm_type (sp) == SSVM_SEGMENT_MEMFD)
97 if (vl_api_registration_file_index (reg) == VL_API_INVALID_FI)
99 clib_warning ("can't send memfd fd");
103 fd_flags |= SESSION_FD_F_MEMFD_SEGMENT;
108 mp = vl_mem_api_alloc_as_if_client_w_reg (reg, sizeof (*mp));
109 memset (mp, 0, sizeof (*mp));
110 mp->_vl_msg_id = clib_host_to_net_u16 (VL_API_MAP_ANOTHER_SEGMENT);
111 mp->segment_size = sp->ssvm_size;
112 mp->fd_flags = fd_flags;
113 strncpy ((char *) mp->segment_name, (char *) sp->name,
114 sizeof (mp->segment_name) - 1);
116 vl_msg_api_send_shmem (reg->vl_input_queue, (u8 *) & mp);
119 return session_send_fds (reg, fds, n_fds);
125 send_del_segment_callback (u32 api_client_index, const ssvm_private_t * fs)
127 vl_api_unmap_segment_t *mp;
128 vl_api_registration_t *reg;
130 reg = vl_mem_api_client_index_to_registration (api_client_index);
133 clib_warning ("no registration: %u", api_client_index);
137 mp = vl_mem_api_alloc_as_if_client_w_reg (reg, sizeof (*mp));
138 memset (mp, 0, sizeof (*mp));
139 mp->_vl_msg_id = clib_host_to_net_u16 (VL_API_UNMAP_SEGMENT);
140 strcpy ((char *) mp->segment_name, (char *) fs->name);
142 vl_msg_api_send_shmem (reg->vl_input_queue, (u8 *) & mp);
148 send_app_cut_through_registration_add (u32 api_client_index, u64 mq_addr,
151 vl_api_app_cut_through_registration_add_t *mp;
152 vl_api_registration_t *reg;
153 svm_msg_q_t *mq, *peer_mq;
156 reg = vl_mem_api_client_index_to_registration (api_client_index);
159 clib_warning ("no registration: %u", api_client_index);
163 mp = vl_mem_api_alloc_as_if_client_w_reg (reg, sizeof (*mp));
164 memset (mp, 0, sizeof (*mp));
166 clib_host_to_net_u16 (VL_API_APP_CUT_THROUGH_REGISTRATION_ADD);
168 mp->evt_q_address = mq_addr;
169 mp->peer_evt_q_address = peer_mq_addr;
171 mq = uword_to_pointer (mq_addr, svm_msg_q_t *);
172 peer_mq = uword_to_pointer (peer_mq_addr, svm_msg_q_t *);
174 if (svm_msg_q_get_producer_eventfd (mq) != -1)
176 mp->fd_flags |= SESSION_FD_F_MQ_EVENTFD;
178 /* app will overwrite exactly the fds we pass here. So
179 * when we swap mq with peer_mq (accept vs connect) the
180 * fds will still be valid */
181 fds[0] = svm_msg_q_get_consumer_eventfd (mq);
182 fds[1] = svm_msg_q_get_producer_eventfd (peer_mq);
185 vl_msg_api_send_shmem (reg->vl_input_queue, (u8 *) & mp);
188 session_send_fds (reg, fds, mp->n_fds);
194 send_session_accept_callback (stream_session_t * s)
196 application_t *server = application_get (s->app_index);
197 transport_proto_vft_t *tp_vft;
198 vl_api_accept_session_t *mp;
199 vl_api_registration_t *reg;
200 transport_connection_t *tc;
201 stream_session_t *listener;
202 svm_msg_q_t *vpp_queue;
204 reg = vl_mem_api_client_index_to_registration (server->api_client_index);
207 clib_warning ("no registration: %u", server->api_client_index);
211 mp = vl_mem_api_alloc_as_if_client_w_reg (reg, sizeof (*mp));
212 memset (mp, 0, sizeof (*mp));
214 mp->_vl_msg_id = clib_host_to_net_u16 (VL_API_ACCEPT_SESSION);
215 mp->context = server->index;
216 mp->server_rx_fifo = pointer_to_uword (s->server_rx_fifo);
217 mp->server_tx_fifo = pointer_to_uword (s->server_tx_fifo);
219 if (session_has_transport (s))
221 listener = listen_session_get (s->listener_index);
222 mp->listener_handle = listen_session_get_handle (listener);
223 if (application_is_proxy (server))
226 application_first_listener (server, session_get_fib_proto (s),
227 session_get_transport_proto (s));
229 mp->listener_handle = listen_session_get_handle (listener);
231 vpp_queue = session_manager_get_vpp_event_queue (s->thread_index);
232 mp->vpp_event_queue_address = pointer_to_uword (vpp_queue);
233 mp->handle = session_handle (s);
234 tp_vft = transport_protocol_get_vft (session_get_transport_proto (s));
235 tc = tp_vft->get_connection (s->connection_index, s->thread_index);
236 mp->port = tc->rmt_port;
237 mp->is_ip4 = tc->is_ip4;
238 clib_memcpy (&mp->ip, &tc->rmt_ip, sizeof (tc->rmt_ip));
242 local_session_t *ls = (local_session_t *) s;
244 if (application_local_session_listener_has_transport (ls))
246 listener = listen_session_get (ls->listener_index);
247 mp->listener_handle = listen_session_get_handle (listener);
248 mp->is_ip4 = session_type_is_ip4 (listener->session_type);
252 ll = application_get_local_listen_session (server,
254 if (ll->transport_listener_index != ~0)
256 listener = listen_session_get (ll->transport_listener_index);
257 mp->listener_handle = listen_session_get_handle (listener);
261 mp->listener_handle = application_local_session_handle (ll);
263 mp->is_ip4 = session_type_is_ip4 (ll->listener_session_type);
265 mp->handle = application_local_session_handle (ls);
267 mp->vpp_event_queue_address = ls->client_evt_q;
268 mp->server_event_queue_address = ls->server_evt_q;
270 vl_msg_api_send_shmem (reg->vl_input_queue, (u8 *) & mp);
276 mq_send_local_session_disconnected_cb (u32 app_index, local_session_t * ls)
278 application_t *app = application_get (app_index);
279 svm_msg_q_msg_t _msg, *msg = &_msg;
280 session_disconnected_msg_t *mp;
282 session_event_t *evt;
284 app_mq = app->event_queue;
285 svm_msg_q_lock_and_alloc_msg_w_ring (app_mq, SESSION_MQ_CTRL_EVT_RING,
287 svm_msg_q_unlock (app_mq);
288 evt = svm_msg_q_msg_data (app_mq, msg);
289 memset (evt, 0, sizeof (*evt));
290 evt->event_type = SESSION_CTRL_EVT_DISCONNECTED;
291 mp = (session_disconnected_msg_t *) evt->data;
292 mp->handle = application_local_session_handle (ls);
293 mp->context = app->api_client_index;
294 svm_msg_q_add (app_mq, msg, SVM_Q_WAIT);
298 send_session_disconnect_callback (stream_session_t * s)
300 application_t *app = application_get (s->app_index);
301 vl_api_disconnect_session_t *mp;
302 vl_api_registration_t *reg;
304 reg = vl_mem_api_client_index_to_registration (app->api_client_index);
307 clib_warning ("no registration: %u", app->api_client_index);
311 mp = vl_mem_api_alloc_as_if_client_w_reg (reg, sizeof (*mp));
312 memset (mp, 0, sizeof (*mp));
313 mp->_vl_msg_id = clib_host_to_net_u16 (VL_API_DISCONNECT_SESSION);
314 mp->handle = session_handle (s);
315 mp->context = app->api_client_index;
316 vl_msg_api_send_shmem (reg->vl_input_queue, (u8 *) & mp);
320 send_session_reset_callback (stream_session_t * s)
322 application_t *app = application_get (s->app_index);
323 vl_api_registration_t *reg;
324 vl_api_reset_session_t *mp;
326 reg = vl_mem_api_client_index_to_registration (app->api_client_index);
329 clib_warning ("no registration: %u", app->api_client_index);
333 mp = vl_mem_api_alloc_as_if_client_w_reg (reg, sizeof (*mp));
334 memset (mp, 0, sizeof (*mp));
335 mp->_vl_msg_id = clib_host_to_net_u16 (VL_API_RESET_SESSION);
336 mp->handle = session_handle (s);
337 vl_msg_api_send_shmem (reg->vl_input_queue, (u8 *) & mp);
341 send_session_connected_callback (u32 app_index, u32 api_context,
342 stream_session_t * s, u8 is_fail)
344 vl_api_connect_session_reply_t *mp;
345 transport_connection_t *tc;
346 vl_api_registration_t *reg;
347 svm_msg_q_t *vpp_queue;
350 app = application_get (app_index);
351 reg = vl_mem_api_client_index_to_registration (app->api_client_index);
354 clib_warning ("no registration: %u", app->api_client_index);
358 mp = vl_mem_api_alloc_as_if_client_w_reg (reg, sizeof (*mp));
359 mp->_vl_msg_id = clib_host_to_net_u16 (VL_API_CONNECT_SESSION_REPLY);
360 mp->context = api_context;
365 if (session_has_transport (s))
367 tc = session_get_transport (s);
374 vpp_queue = session_manager_get_vpp_event_queue (s->thread_index);
375 mp->handle = session_handle (s);
376 mp->vpp_event_queue_address = pointer_to_uword (vpp_queue);
377 clib_memcpy (mp->lcl_ip, &tc->lcl_ip, sizeof (tc->lcl_ip));
378 mp->is_ip4 = tc->is_ip4;
379 mp->lcl_port = tc->lcl_port;
380 mp->server_rx_fifo = pointer_to_uword (s->server_rx_fifo);
381 mp->server_tx_fifo = pointer_to_uword (s->server_tx_fifo);
385 local_session_t *ls = (local_session_t *) s;
386 mp->handle = application_local_session_handle (ls);
387 mp->lcl_port = ls->port;
388 mp->vpp_event_queue_address = ls->server_evt_q;
389 mp->client_event_queue_address = ls->client_evt_q;
390 mp->server_rx_fifo = pointer_to_uword (s->server_tx_fifo);
391 mp->server_tx_fifo = pointer_to_uword (s->server_rx_fifo);
395 mp->retval = is_fail ?
396 clib_host_to_net_u32 (VNET_API_ERROR_SESSION_CONNECT) : 0;
397 vl_msg_api_send_shmem (reg->vl_input_queue, (u8 *) & mp);
401 static session_cb_vft_t session_cb_vft = {
402 .session_accept_callback = send_session_accept_callback,
403 .session_disconnect_callback = send_session_disconnect_callback,
404 .session_connected_callback = send_session_connected_callback,
405 .session_reset_callback = send_session_reset_callback,
406 .add_segment_callback = send_add_segment_callback,
407 .del_segment_callback = send_del_segment_callback,
411 mq_send_session_accepted_cb (stream_session_t * s)
413 application_t *app = application_get (s->app_index);
414 svm_msg_q_msg_t _msg, *msg = &_msg;
415 svm_msg_q_t *vpp_queue, *app_mq;
416 transport_proto_vft_t *tp_vft;
417 transport_connection_t *tc;
418 stream_session_t *listener;
419 session_accepted_msg_t *mp;
420 session_event_t *evt;
422 app_mq = app->event_queue;
423 svm_msg_q_lock_and_alloc_msg_w_ring (app_mq, SESSION_MQ_CTRL_EVT_RING,
425 svm_msg_q_unlock (app_mq);
427 evt = svm_msg_q_msg_data (app_mq, msg);
428 memset (evt, 0, sizeof (*evt));
429 evt->event_type = SESSION_CTRL_EVT_ACCEPTED;
430 mp = (session_accepted_msg_t *) evt->data;
431 mp->context = app->index;
432 mp->server_rx_fifo = pointer_to_uword (s->server_rx_fifo);
433 mp->server_tx_fifo = pointer_to_uword (s->server_tx_fifo);
435 if (session_has_transport (s))
437 listener = listen_session_get (s->listener_index);
438 mp->listener_handle = listen_session_get_handle (listener);
439 if (application_is_proxy (app))
442 application_first_listener (app, session_get_fib_proto (s),
443 session_get_transport_proto (s));
445 mp->listener_handle = listen_session_get_handle (listener);
447 vpp_queue = session_manager_get_vpp_event_queue (s->thread_index);
448 mp->vpp_event_queue_address = pointer_to_uword (vpp_queue);
449 mp->handle = session_handle (s);
450 tp_vft = transport_protocol_get_vft (session_get_transport_proto (s));
451 tc = tp_vft->get_connection (s->connection_index, s->thread_index);
452 mp->port = tc->rmt_port;
453 mp->is_ip4 = tc->is_ip4;
454 clib_memcpy (&mp->ip, &tc->rmt_ip, sizeof (tc->rmt_ip));
458 local_session_t *ls = (local_session_t *) s;
460 u8 main_thread = vlib_num_workers ()? 1 : 0;
462 send_app_cut_through_registration_add (app->api_client_index,
466 if (application_local_session_listener_has_transport (ls))
468 listener = listen_session_get (ls->listener_index);
469 mp->listener_handle = listen_session_get_handle (listener);
470 mp->is_ip4 = session_type_is_ip4 (listener->session_type);
474 ll = application_get_local_listen_session (app, ls->listener_index);
475 if (ll->transport_listener_index != ~0)
477 listener = listen_session_get (ll->transport_listener_index);
478 mp->listener_handle = listen_session_get_handle (listener);
482 mp->listener_handle = application_local_session_handle (ll);
484 mp->is_ip4 = session_type_is_ip4 (ll->listener_session_type);
486 mp->handle = application_local_session_handle (ls);
488 vpp_queue = session_manager_get_vpp_event_queue (main_thread);
489 mp->vpp_event_queue_address = pointer_to_uword (vpp_queue);
490 mp->client_event_queue_address = ls->client_evt_q;
491 mp->server_event_queue_address = ls->server_evt_q;
493 svm_msg_q_add (app_mq, msg, SVM_Q_WAIT);
499 mq_send_session_disconnected_cb (stream_session_t * s)
501 application_t *app = application_get (s->app_index);
502 svm_msg_q_msg_t _msg, *msg = &_msg;
503 session_disconnected_msg_t *mp;
505 session_event_t *evt;
507 app_mq = app->event_queue;
508 svm_msg_q_lock_and_alloc_msg_w_ring (app_mq, SESSION_MQ_CTRL_EVT_RING,
510 svm_msg_q_unlock (app_mq);
511 evt = svm_msg_q_msg_data (app_mq, msg);
512 memset (evt, 0, sizeof (*evt));
513 evt->event_type = SESSION_CTRL_EVT_DISCONNECTED;
514 mp = (session_disconnected_msg_t *) evt->data;
515 mp->handle = session_handle (s);
516 mp->context = app->api_client_index;
517 svm_msg_q_add (app_mq, msg, SVM_Q_WAIT);
521 mq_send_session_reset_cb (stream_session_t * s)
523 application_t *app = application_get (s->app_index);
524 svm_msg_q_msg_t _msg, *msg = &_msg;
525 session_reset_msg_t *mp;
527 session_event_t *evt;
529 app_mq = app->event_queue;
530 svm_msg_q_lock_and_alloc_msg_w_ring (app_mq, SESSION_MQ_CTRL_EVT_RING,
532 svm_msg_q_unlock (app_mq);
533 evt = svm_msg_q_msg_data (app_mq, msg);
534 memset (evt, 0, sizeof (*evt));
535 evt->event_type = SESSION_CTRL_EVT_RESET;
536 mp = (session_reset_msg_t *) evt->data;
537 mp->handle = session_handle (s);
538 svm_msg_q_add (app_mq, msg, SVM_Q_WAIT);
542 mq_send_session_connected_cb (u32 app_index, u32 api_context,
543 stream_session_t * s, u8 is_fail)
545 svm_msg_q_msg_t _msg, *msg = &_msg;
546 session_connected_msg_t *mp;
547 svm_msg_q_t *vpp_mq, *app_mq;
548 transport_connection_t *tc;
549 session_event_t *evt;
552 app = application_get (app_index);
553 app_mq = app->event_queue;
556 clib_warning ("app %u with api index: %u not attached", app->index,
557 app->api_client_index);
561 svm_msg_q_lock_and_alloc_msg_w_ring (app_mq, SESSION_MQ_CTRL_EVT_RING,
563 svm_msg_q_unlock (app_mq);
564 evt = svm_msg_q_msg_data (app_mq, msg);
565 memset (evt, 0, sizeof (*evt));
566 evt->event_type = SESSION_CTRL_EVT_CONNECTED;
567 mp = (session_connected_msg_t *) evt->data;
568 mp->context = api_context;
573 if (session_has_transport (s))
575 tc = session_get_transport (s);
582 vpp_mq = session_manager_get_vpp_event_queue (s->thread_index);
583 mp->handle = session_handle (s);
584 mp->vpp_event_queue_address = pointer_to_uword (vpp_mq);
585 clib_memcpy (mp->lcl_ip, &tc->lcl_ip, sizeof (tc->lcl_ip));
586 mp->is_ip4 = tc->is_ip4;
587 mp->lcl_port = tc->lcl_port;
588 mp->server_rx_fifo = pointer_to_uword (s->server_rx_fifo);
589 mp->server_tx_fifo = pointer_to_uword (s->server_tx_fifo);
593 local_session_t *ls = (local_session_t *) s;
594 u8 main_thread = vlib_num_workers ()? 1 : 0;
596 send_app_cut_through_registration_add (app->api_client_index,
600 mp->handle = application_local_session_handle (ls);
601 mp->lcl_port = ls->port;
602 vpp_mq = session_manager_get_vpp_event_queue (main_thread);
603 mp->vpp_event_queue_address = pointer_to_uword (vpp_mq);
604 mp->client_event_queue_address = ls->client_evt_q;
605 mp->server_event_queue_address = ls->server_evt_q;
606 mp->server_rx_fifo = pointer_to_uword (s->server_tx_fifo);
607 mp->server_tx_fifo = pointer_to_uword (s->server_rx_fifo);
611 mp->retval = is_fail ?
612 clib_host_to_net_u32 (VNET_API_ERROR_SESSION_CONNECT) : 0;
614 svm_msg_q_add (app_mq, msg, SVM_Q_WAIT);
618 static session_cb_vft_t session_mq_cb_vft = {
619 .session_accept_callback = mq_send_session_accepted_cb,
620 .session_disconnect_callback = mq_send_session_disconnected_cb,
621 .session_connected_callback = mq_send_session_connected_cb,
622 .session_reset_callback = mq_send_session_reset_cb,
623 .add_segment_callback = send_add_segment_callback,
624 .del_segment_callback = send_del_segment_callback,
628 vl_api_session_enable_disable_t_handler (vl_api_session_enable_disable_t * mp)
630 vl_api_session_enable_disable_reply_t *rmp;
631 vlib_main_t *vm = vlib_get_main ();
634 vnet_session_enable_disable (vm, mp->is_enable);
635 REPLY_MACRO (VL_API_SESSION_ENABLE_DISABLE_REPLY);
639 vl_api_application_attach_t_handler (vl_api_application_attach_t * mp)
641 int rv = 0, fds[SESSION_N_FD_TYPE], n_fds = 0;
642 vl_api_application_attach_reply_t *rmp;
643 ssvm_private_t *segp, *evt_q_segment;
644 vnet_app_attach_args_t _a, *a = &_a;
645 vl_api_registration_t *reg;
646 clib_error_t *error = 0;
649 reg = vl_api_client_index_to_registration (mp->client_index);
653 if (session_manager_is_enabled () == 0)
655 rv = VNET_API_ERROR_FEATURE_DISABLED;
659 STATIC_ASSERT (sizeof (u64) * APP_OPTIONS_N_OPTIONS <=
660 sizeof (mp->options),
661 "Out of options, fix api message definition");
663 memset (a, 0, sizeof (*a));
664 a->api_client_index = mp->client_index;
665 a->options = mp->options;
667 if (a->options[APP_OPTIONS_FLAGS] & APP_OPTIONS_FLAGS_USE_MQ_FOR_CTRL_MSGS)
668 a->session_cb_vft = &session_mq_cb_vft;
670 a->session_cb_vft = &session_cb_vft;
672 if (mp->namespace_id_len > 64)
674 rv = VNET_API_ERROR_INVALID_VALUE;
678 if (mp->namespace_id_len)
680 vec_validate (a->namespace_id, mp->namespace_id_len - 1);
681 clib_memcpy (a->namespace_id, mp->namespace_id, mp->namespace_id_len);
684 if ((error = vnet_application_attach (a)))
686 rv = clib_error_get_code (error);
687 clib_error_report (error);
688 vec_free (a->namespace_id);
691 vec_free (a->namespace_id);
693 /* Send event queues segment */
694 if ((evt_q_segment = session_manager_get_evt_q_segment ()))
696 fd_flags |= SESSION_FD_F_VPP_MQ_SEGMENT;
697 fds[n_fds] = evt_q_segment->fd;
700 /* Send fifo segment fd if needed */
701 if (ssvm_type (a->segment) == SSVM_SEGMENT_MEMFD)
703 fd_flags |= SESSION_FD_F_MEMFD_SEGMENT;
704 fds[n_fds] = a->segment->fd;
707 if (a->options[APP_OPTIONS_FLAGS] & APP_OPTIONS_FLAGS_EVT_MQ_USE_EVENTFD)
709 fd_flags |= SESSION_FD_F_MQ_EVENTFD;
710 fds[n_fds] = svm_msg_q_get_producer_eventfd (a->app_evt_q);
717 REPLY_MACRO2 (VL_API_APPLICATION_ATTACH_REPLY, ({
721 rmp->segment_name_length = 0;
722 rmp->segment_size = segp->ssvm_size;
723 if (vec_len (segp->name))
725 memcpy (rmp->segment_name, segp->name, vec_len (segp->name));
726 rmp->segment_name_length = vec_len (segp->name);
728 rmp->app_event_queue_address = pointer_to_uword (a->app_evt_q);
730 rmp->fd_flags = fd_flags;
736 session_send_fds (reg, fds, n_fds);
740 vl_api_application_detach_t_handler (vl_api_application_detach_t * mp)
742 vl_api_application_detach_reply_t *rmp;
743 int rv = VNET_API_ERROR_INVALID_VALUE_2;
744 vnet_app_detach_args_t _a, *a = &_a;
747 if (session_manager_is_enabled () == 0)
749 rv = VNET_API_ERROR_FEATURE_DISABLED;
753 app = application_lookup (mp->client_index);
756 a->app_index = app->index;
757 rv = vnet_application_detach (a);
761 REPLY_MACRO (VL_API_APPLICATION_DETACH_REPLY);
765 vl_api_bind_uri_t_handler (vl_api_bind_uri_t * mp)
767 transport_connection_t *tc = 0;
768 vnet_bind_args_t _a, *a = &_a;
769 vl_api_bind_uri_reply_t *rmp;
771 application_t *app = 0;
772 svm_msg_q_t *vpp_evt_q;
775 if (session_manager_is_enabled () == 0)
777 rv = VNET_API_ERROR_FEATURE_DISABLED;
781 app = application_lookup (mp->client_index);
784 memset (a, 0, sizeof (*a));
785 a->uri = (char *) mp->uri;
786 a->app_index = app->index;
787 rv = vnet_bind_uri (a);
791 rv = VNET_API_ERROR_APPLICATION_NOT_ATTACHED;
797 REPLY_MACRO2 (VL_API_BIND_URI_REPLY, ({
800 rmp->handle = a->handle;
801 if (app && application_has_global_scope (app))
803 s = listen_session_get_from_handle (a->handle);
804 tc = listen_session_get_transport (s);
805 rmp->lcl_is_ip4 = tc->is_ip4;
806 rmp->lcl_port = tc->lcl_port;
807 clib_memcpy (rmp->lcl_ip, &tc->lcl_ip, sizeof(tc->lcl_ip));
808 if (session_transport_service_type (s) == TRANSPORT_SERVICE_CL)
810 rmp->rx_fifo = pointer_to_uword (s->server_rx_fifo);
811 rmp->tx_fifo = pointer_to_uword (s->server_tx_fifo);
812 vpp_evt_q = session_manager_get_vpp_event_queue (0);
813 rmp->vpp_evt_q = pointer_to_uword (vpp_evt_q);
822 vl_api_unbind_uri_t_handler (vl_api_unbind_uri_t * mp)
824 vl_api_unbind_uri_reply_t *rmp;
826 vnet_unbind_args_t _a, *a = &_a;
829 if (session_manager_is_enabled () == 0)
831 rv = VNET_API_ERROR_FEATURE_DISABLED;
835 app = application_lookup (mp->client_index);
838 a->uri = (char *) mp->uri;
839 a->app_index = app->index;
840 rv = vnet_unbind_uri (a);
844 rv = VNET_API_ERROR_APPLICATION_NOT_ATTACHED;
848 REPLY_MACRO (VL_API_UNBIND_URI_REPLY);
852 vl_api_connect_uri_t_handler (vl_api_connect_uri_t * mp)
854 vl_api_connect_session_reply_t *rmp;
855 vnet_connect_args_t _a, *a = &_a;
857 clib_error_t *error = 0;
860 if (session_manager_is_enabled () == 0)
862 rv = VNET_API_ERROR_FEATURE_DISABLED;
866 app = application_lookup (mp->client_index);
869 a->uri = (char *) mp->uri;
870 a->api_context = mp->context;
871 a->app_index = app->index;
872 if ((error = vnet_connect_uri (a)))
874 rv = clib_error_get_code (error);
875 clib_error_report (error);
880 rv = VNET_API_ERROR_APPLICATION_NOT_ATTACHED;
884 * Don't reply to stream (tcp) connects. The reply will come once
885 * the connection is established. In case of the redirects, the reply
886 * will come from the server app.
893 REPLY_MACRO (VL_API_CONNECT_SESSION_REPLY);
898 vl_api_disconnect_session_t_handler (vl_api_disconnect_session_t * mp)
900 vl_api_disconnect_session_reply_t *rmp;
901 vnet_disconnect_args_t _a, *a = &_a;
905 if (session_manager_is_enabled () == 0)
907 rv = VNET_API_ERROR_FEATURE_DISABLED;
911 app = application_lookup (mp->client_index);
914 a->handle = mp->handle;
915 a->app_index = app->index;
916 rv = vnet_disconnect_session (a);
920 rv = VNET_API_ERROR_APPLICATION_NOT_ATTACHED;
924 REPLY_MACRO2 (VL_API_DISCONNECT_SESSION_REPLY, rmp->handle = mp->handle);
928 vl_api_disconnect_session_reply_t_handler (vl_api_disconnect_session_reply_t *
931 vnet_disconnect_args_t _a, *a = &_a;
934 /* Client objected to disconnecting the session, log and continue */
937 clib_warning ("client retval %d", mp->retval);
941 /* Disconnect has been confirmed. Confirm close to transport */
942 app = application_lookup (mp->context);
945 a->handle = mp->handle;
946 a->app_index = app->index;
947 vnet_disconnect_session (a);
952 vl_api_reset_session_reply_t_handler (vl_api_reset_session_reply_t * mp)
956 u32 index, thread_index;
958 app = application_lookup (mp->client_index);
962 session_parse_handle (mp->handle, &index, &thread_index);
963 s = session_get_if_valid (index, thread_index);
964 if (s == 0 || app->index != s->app_index)
966 clib_warning ("Invalid session!");
970 /* Client objected to resetting the session, log and continue */
973 clib_warning ("client retval %d", mp->retval);
977 /* This comes as a response to a reset, transport only waiting for
978 * confirmation to remove connection state, no need to disconnect */
979 stream_session_cleanup (s);
983 vl_api_accept_session_reply_t_handler (vl_api_accept_session_reply_t * mp)
985 vnet_disconnect_args_t _a = { 0 }, *a = &_a;
989 /* Server isn't interested, kill the session */
992 a->app_index = mp->context;
993 a->handle = mp->handle;
994 vnet_disconnect_session (a);
998 if (session_handle_is_local (mp->handle))
1000 ls = application_get_local_session_from_handle (mp->handle);
1001 if (!ls || ls->app_index != mp->context)
1003 clib_warning ("server %u doesn't own local handle %llu",
1004 mp->context, mp->handle);
1007 if (application_local_session_connect_notify (ls))
1009 ls->session_state = SESSION_STATE_READY;
1013 s = session_get_from_handle_if_valid (mp->handle);
1016 clib_warning ("session doesn't exist");
1019 if (s->app_index != mp->context)
1021 clib_warning ("app doesn't own session");
1024 s->session_state = SESSION_STATE_READY;
1029 vl_api_map_another_segment_reply_t_handler (vl_api_map_another_segment_reply_t
1032 clib_warning ("not implemented");
1036 vl_api_bind_sock_t_handler (vl_api_bind_sock_t * mp)
1038 vl_api_bind_sock_reply_t *rmp;
1039 vnet_bind_args_t _a, *a = &_a;
1041 clib_error_t *error;
1042 application_t *app = 0;
1043 stream_session_t *s;
1044 transport_connection_t *tc = 0;
1045 ip46_address_t *ip46;
1046 svm_msg_q_t *vpp_evt_q;
1048 if (session_manager_is_enabled () == 0)
1050 rv = VNET_API_ERROR_FEATURE_DISABLED;
1054 app = application_lookup (mp->client_index);
1057 rv = VNET_API_ERROR_APPLICATION_NOT_ATTACHED;
1061 ip46 = (ip46_address_t *) mp->ip;
1062 memset (a, 0, sizeof (*a));
1063 a->sep.is_ip4 = mp->is_ip4;
1065 a->sep.port = mp->port;
1066 a->sep.fib_index = mp->vrf;
1067 a->sep.sw_if_index = ENDPOINT_INVALID_INDEX;
1068 a->sep.transport_proto = mp->proto;
1069 a->app_index = app->index;
1071 if ((error = vnet_bind (a)))
1073 rv = clib_error_get_code (error);
1074 clib_error_report (error);
1079 REPLY_MACRO2 (VL_API_BIND_SOCK_REPLY,({
1082 rmp->handle = a->handle;
1083 rmp->lcl_port = mp->port;
1084 rmp->lcl_is_ip4 = mp->is_ip4;
1085 if (app && application_has_global_scope (app))
1087 s = listen_session_get_from_handle (a->handle);
1088 tc = listen_session_get_transport (s);
1089 clib_memcpy (rmp->lcl_ip, &tc->lcl_ip, sizeof (tc->lcl_ip));
1090 if (session_transport_service_type (s) == TRANSPORT_SERVICE_CL)
1092 rmp->rx_fifo = pointer_to_uword (s->server_rx_fifo);
1093 rmp->tx_fifo = pointer_to_uword (s->server_tx_fifo);
1094 vpp_evt_q = session_manager_get_vpp_event_queue (0);
1095 rmp->vpp_evt_q = pointer_to_uword (vpp_evt_q);
1104 vl_api_unbind_sock_t_handler (vl_api_unbind_sock_t * mp)
1106 vl_api_unbind_sock_reply_t *rmp;
1107 vnet_unbind_args_t _a, *a = &_a;
1109 clib_error_t *error;
1112 if (session_manager_is_enabled () == 0)
1114 rv = VNET_API_ERROR_FEATURE_DISABLED;
1118 app = application_lookup (mp->client_index);
1121 a->app_index = app->index;
1122 a->handle = mp->handle;
1123 if ((error = vnet_unbind (a)))
1125 rv = clib_error_get_code (error);
1126 clib_error_report (error);
1131 REPLY_MACRO (VL_API_UNBIND_SOCK_REPLY);
1135 vl_api_connect_sock_t_handler (vl_api_connect_sock_t * mp)
1137 vl_api_connect_session_reply_t *rmp;
1138 vnet_connect_args_t _a, *a = &_a;
1140 clib_error_t *error = 0;
1143 if (session_manager_is_enabled () == 0)
1145 rv = VNET_API_ERROR_FEATURE_DISABLED;
1149 app = application_lookup (mp->client_index);
1152 svm_queue_t *client_q;
1153 ip46_address_t *ip46 = (ip46_address_t *) mp->ip;
1155 memset (a, 0, sizeof (*a));
1156 client_q = vl_api_client_index_to_input_queue (mp->client_index);
1157 mp->client_queue_address = pointer_to_uword (client_q);
1158 a->sep.is_ip4 = mp->is_ip4;
1160 a->sep.port = mp->port;
1161 a->sep.transport_proto = mp->proto;
1162 a->sep.fib_index = mp->vrf;
1163 a->sep.sw_if_index = ENDPOINT_INVALID_INDEX;
1164 if (mp->hostname_len)
1166 vec_validate (a->sep.hostname, mp->hostname_len - 1);
1167 clib_memcpy (a->sep.hostname, mp->hostname, mp->hostname_len);
1169 a->api_context = mp->context;
1170 a->app_index = app->index;
1171 if ((error = vnet_connect (a)))
1173 rv = clib_error_get_code (error);
1174 clib_error_report (error);
1176 vec_free (a->sep.hostname);
1180 rv = VNET_API_ERROR_APPLICATION_NOT_ATTACHED;
1186 /* Got some error, relay it */
1189 REPLY_MACRO (VL_API_CONNECT_SESSION_REPLY);
1193 vl_api_app_namespace_add_del_t_handler (vl_api_app_namespace_add_del_t * mp)
1195 vl_api_app_namespace_add_del_reply_t *rmp;
1196 clib_error_t *error = 0;
1197 u32 appns_index = 0;
1200 if (!session_manager_is_enabled ())
1202 rv = VNET_API_ERROR_FEATURE_DISABLED;
1206 if (mp->namespace_id_len > ARRAY_LEN (mp->namespace_id))
1208 rv = VNET_API_ERROR_INVALID_VALUE;
1212 vec_validate (ns_id, mp->namespace_id_len - 1);
1213 clib_memcpy (ns_id, mp->namespace_id, mp->namespace_id_len);
1214 vnet_app_namespace_add_del_args_t args = {
1216 .secret = clib_net_to_host_u64 (mp->secret),
1217 .sw_if_index = clib_net_to_host_u32 (mp->sw_if_index),
1218 .ip4_fib_id = clib_net_to_host_u32 (mp->ip4_fib_id),
1219 .ip6_fib_id = clib_net_to_host_u32 (mp->ip6_fib_id),
1222 error = vnet_app_namespace_add_del (&args);
1225 rv = clib_error_get_code (error);
1226 clib_error_report (error);
1230 appns_index = app_namespace_index_from_id (ns_id);
1231 if (appns_index == APP_NAMESPACE_INVALID_INDEX)
1233 clib_warning ("app ns lookup failed");
1234 rv = VNET_API_ERROR_UNSPECIFIED;
1241 REPLY_MACRO2 (VL_API_APP_NAMESPACE_ADD_DEL_REPLY, ({
1243 rmp->appns_index = clib_host_to_net_u32 (appns_index);
1249 vl_api_session_rule_add_del_t_handler (vl_api_session_rule_add_del_t * mp)
1251 vl_api_session_rule_add_del_reply_t *rmp;
1252 session_rule_add_del_args_t args;
1253 session_rule_table_add_del_args_t *table_args = &args.table_args;
1254 clib_error_t *error;
1258 memset (&args, 0, sizeof (args));
1259 fib_proto = mp->is_ip4 ? FIB_PROTOCOL_IP4 : FIB_PROTOCOL_IP6;
1261 table_args->lcl.fp_len = mp->lcl_plen;
1262 table_args->lcl.fp_proto = fib_proto;
1263 table_args->rmt.fp_len = mp->rmt_plen;
1264 table_args->rmt.fp_proto = fib_proto;
1265 table_args->lcl_port = mp->lcl_port;
1266 table_args->rmt_port = mp->rmt_port;
1267 table_args->action_index = clib_net_to_host_u32 (mp->action_index);
1268 table_args->is_add = mp->is_add;
1269 mp->tag[sizeof (mp->tag) - 1] = 0;
1270 table_args->tag = format (0, "%s", mp->tag);
1271 args.appns_index = clib_net_to_host_u32 (mp->appns_index);
1272 args.scope = mp->scope;
1273 args.transport_proto = mp->transport_proto;
1275 memset (&table_args->lcl.fp_addr, 0, sizeof (table_args->lcl.fp_addr));
1276 memset (&table_args->rmt.fp_addr, 0, sizeof (table_args->rmt.fp_addr));
1277 ip_set (&table_args->lcl.fp_addr, mp->lcl_ip, mp->is_ip4);
1278 ip_set (&table_args->rmt.fp_addr, mp->rmt_ip, mp->is_ip4);
1279 error = vnet_session_rule_add_del (&args);
1282 rv = clib_error_get_code (error);
1283 clib_error_report (error);
1285 vec_free (table_args->tag);
1286 REPLY_MACRO (VL_API_SESSION_RULE_ADD_DEL_REPLY);
1290 send_session_rule_details4 (mma_rule_16_t * rule, u8 is_local,
1291 u8 transport_proto, u32 appns_index, u8 * tag,
1292 vl_api_registration_t * reg, u32 context)
1294 vl_api_session_rules_details_t *rmp = 0;
1295 session_mask_or_match_4_t *match =
1296 (session_mask_or_match_4_t *) & rule->match;
1297 session_mask_or_match_4_t *mask =
1298 (session_mask_or_match_4_t *) & rule->mask;
1300 rmp = vl_msg_api_alloc (sizeof (*rmp));
1301 memset (rmp, 0, sizeof (*rmp));
1302 rmp->_vl_msg_id = ntohs (VL_API_SESSION_RULES_DETAILS);
1303 rmp->context = context;
1306 clib_memcpy (rmp->lcl_ip, &match->lcl_ip, sizeof (match->lcl_ip));
1307 clib_memcpy (rmp->rmt_ip, &match->rmt_ip, sizeof (match->rmt_ip));
1308 rmp->lcl_plen = ip4_mask_to_preflen (&mask->lcl_ip);
1309 rmp->rmt_plen = ip4_mask_to_preflen (&mask->rmt_ip);
1310 rmp->lcl_port = match->lcl_port;
1311 rmp->rmt_port = match->rmt_port;
1312 rmp->action_index = clib_host_to_net_u32 (rule->action_index);
1314 is_local ? SESSION_RULE_SCOPE_LOCAL : SESSION_RULE_SCOPE_GLOBAL;
1315 rmp->transport_proto = transport_proto;
1316 rmp->appns_index = clib_host_to_net_u32 (appns_index);
1319 clib_memcpy (rmp->tag, tag, vec_len (tag));
1320 rmp->tag[vec_len (tag)] = 0;
1323 vl_api_send_msg (reg, (u8 *) rmp);
1327 send_session_rule_details6 (mma_rule_40_t * rule, u8 is_local,
1328 u8 transport_proto, u32 appns_index, u8 * tag,
1329 vl_api_registration_t * reg, u32 context)
1331 vl_api_session_rules_details_t *rmp = 0;
1332 session_mask_or_match_6_t *match =
1333 (session_mask_or_match_6_t *) & rule->match;
1334 session_mask_or_match_6_t *mask =
1335 (session_mask_or_match_6_t *) & rule->mask;
1337 rmp = vl_msg_api_alloc (sizeof (*rmp));
1338 memset (rmp, 0, sizeof (*rmp));
1339 rmp->_vl_msg_id = ntohs (VL_API_SESSION_RULES_DETAILS);
1340 rmp->context = context;
1343 clib_memcpy (rmp->lcl_ip, &match->lcl_ip, sizeof (match->lcl_ip));
1344 clib_memcpy (rmp->rmt_ip, &match->rmt_ip, sizeof (match->rmt_ip));
1345 rmp->lcl_plen = ip6_mask_to_preflen (&mask->lcl_ip);
1346 rmp->rmt_plen = ip6_mask_to_preflen (&mask->rmt_ip);
1347 rmp->lcl_port = match->lcl_port;
1348 rmp->rmt_port = match->rmt_port;
1349 rmp->action_index = clib_host_to_net_u32 (rule->action_index);
1351 is_local ? SESSION_RULE_SCOPE_LOCAL : SESSION_RULE_SCOPE_GLOBAL;
1352 rmp->transport_proto = transport_proto;
1353 rmp->appns_index = clib_host_to_net_u32 (appns_index);
1356 clib_memcpy (rmp->tag, tag, vec_len (tag));
1357 rmp->tag[vec_len (tag)] = 0;
1360 vl_api_send_msg (reg, (u8 *) rmp);
1364 send_session_rules_table_details (session_rules_table_t * srt, u8 fib_proto,
1365 u8 tp, u8 is_local, u32 appns_index,
1366 vl_api_registration_t * reg, u32 context)
1368 mma_rule_16_t *rule16;
1369 mma_rule_40_t *rule40;
1370 mma_rules_table_16_t *srt16;
1371 mma_rules_table_40_t *srt40;
1374 if (is_local || fib_proto == FIB_PROTOCOL_IP4)
1378 srt16 = &srt->session_rules_tables_16;
1379 pool_foreach (rule16, srt16->rules, ({
1380 ri = mma_rules_table_rule_index_16 (srt16, rule16);
1381 tag = session_rules_table_rule_tag (srt, ri, 1);
1382 send_session_rule_details4 (rule16, is_local, tp, appns_index, tag,
1387 if (is_local || fib_proto == FIB_PROTOCOL_IP6)
1391 srt40 = &srt->session_rules_tables_40;
1392 pool_foreach (rule40, srt40->rules, ({
1393 ri = mma_rules_table_rule_index_40 (srt40, rule40);
1394 tag = session_rules_table_rule_tag (srt, ri, 1);
1395 send_session_rule_details6 (rule40, is_local, tp, appns_index, tag,
1403 vl_api_session_rules_dump_t_handler (vl_api_one_map_server_dump_t * mp)
1405 vl_api_registration_t *reg;
1406 session_table_t *st;
1409 reg = vl_api_client_index_to_registration (mp->client_index);
1414 session_table_foreach (st, ({
1415 for (tp = 0; tp < TRANSPORT_N_PROTO; tp++)
1417 send_session_rules_table_details (&st->session_rules[tp],
1418 st->active_fib_proto, tp,
1419 st->is_local, st->appns_index, reg,
1427 vl_api_application_tls_cert_add_t_handler (vl_api_application_tls_cert_add_t *
1430 vl_api_app_namespace_add_del_reply_t *rmp;
1431 vnet_app_add_tls_cert_args_t _a, *a = &_a;
1432 clib_error_t *error;
1436 if (!session_manager_is_enabled ())
1438 rv = VNET_API_ERROR_FEATURE_DISABLED;
1441 if (!(app = application_lookup (mp->client_index)))
1443 rv = VNET_API_ERROR_APPLICATION_NOT_ATTACHED;
1446 memset (a, 0, sizeof (*a));
1447 a->app_index = app->index;
1448 cert_len = clib_net_to_host_u16 (mp->cert_len);
1449 if (cert_len > 10000)
1451 rv = VNET_API_ERROR_INVALID_VALUE;
1454 vec_validate (a->cert, cert_len);
1455 clib_memcpy (a->cert, mp->cert, cert_len);
1456 if ((error = vnet_app_add_tls_cert (a)))
1458 rv = clib_error_get_code (error);
1459 clib_error_report (error);
1463 REPLY_MACRO (VL_API_APPLICATION_TLS_CERT_ADD_REPLY);
1467 vl_api_application_tls_key_add_t_handler (vl_api_application_tls_key_add_t *
1470 vl_api_app_namespace_add_del_reply_t *rmp;
1471 vnet_app_add_tls_key_args_t _a, *a = &_a;
1472 clib_error_t *error;
1476 if (!session_manager_is_enabled ())
1478 rv = VNET_API_ERROR_FEATURE_DISABLED;
1481 if (!(app = application_lookup (mp->client_index)))
1483 rv = VNET_API_ERROR_APPLICATION_NOT_ATTACHED;
1486 memset (a, 0, sizeof (*a));
1487 a->app_index = app->index;
1488 key_len = clib_net_to_host_u16 (mp->key_len);
1489 if (key_len > 10000)
1491 rv = VNET_API_ERROR_INVALID_VALUE;
1494 vec_validate (a->key, key_len);
1495 clib_memcpy (a->key, mp->key, key_len);
1496 if ((error = vnet_app_add_tls_key (a)))
1498 rv = clib_error_get_code (error);
1499 clib_error_report (error);
1503 REPLY_MACRO (VL_API_APPLICATION_TLS_KEY_ADD_REPLY);
1506 static clib_error_t *
1507 application_reaper_cb (u32 client_index)
1509 application_t *app = application_lookup (client_index);
1510 vnet_app_detach_args_t _a, *a = &_a;
1513 a->app_index = app->index;
1514 vnet_application_detach (a);
1519 VL_MSG_API_REAPER_FUNCTION (application_reaper_cb);
1521 #define vl_msg_name_crc_list
1522 #include <vnet/vnet_all_api_h.h>
1523 #undef vl_msg_name_crc_list
1526 setup_message_id_table (api_main_t * am)
1528 #define _(id,n,crc) vl_msg_api_add_msg_name_crc (am, #n "_" #crc, id);
1529 foreach_vl_msg_name_crc_session;
1534 * session_api_hookup
1535 * Add uri's API message handlers to the table.
1536 * vlib has alread mapped shared memory and
1537 * added the client registration handlers.
1538 * See .../open-repo/vlib/memclnt_vlib.c:memclnt_process()
1540 static clib_error_t *
1541 session_api_hookup (vlib_main_t * vm)
1543 api_main_t *am = &api_main;
1546 vl_msg_api_set_handlers(VL_API_##N, #n, \
1547 vl_api_##n##_t_handler, \
1549 vl_api_##n##_t_endian, \
1550 vl_api_##n##_t_print, \
1551 sizeof(vl_api_##n##_t), 1);
1552 foreach_session_api_msg;
1556 * Messages which bounce off the data-plane to
1557 * an API client. Simply tells the message handling infra not
1558 * to free the message.
1560 * Bounced message handlers MUST NOT block the data plane
1562 am->message_bounce[VL_API_CONNECT_URI] = 1;
1563 am->message_bounce[VL_API_CONNECT_SOCK] = 1;
1566 * Set up the (msg_name, crc, message-id) table
1568 setup_message_id_table (am);
1573 VLIB_API_INIT_FUNCTION (session_api_hookup);
1576 * fd.io coding-style-patch-verification: ON
1579 * eval: (c-set-style "gnu")