udp/session: refactor to support dgram mode
[vpp.git] / src / vnet / session-apps / echo_server.c
1 /*
2 * Copyright (c) 2015-2017 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:
6 *
7 *     http://www.apache.org/licenses/LICENSE-2.0
8 *
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.
14 */
15
16 #include <vnet/vnet.h>
17 #include <vlibmemory/api.h>
18 #include <vnet/session/application.h>
19 #include <vnet/session/application_interface.h>
20
21 typedef struct
22 {
23   /*
24    * Server app parameters
25    */
26   svm_queue_t **vpp_queue;
27   svm_queue_t *vl_input_queue;  /**< Sever's event queue */
28
29   u32 app_index;                /**< Server app index */
30   u32 my_client_index;          /**< API client handle */
31   u32 node_index;               /**< process node index for evnt scheduling */
32
33   /*
34    * Config params
35    */
36   u8 no_echo;                   /**< Don't echo traffic */
37   u32 fifo_size;                /**< Fifo size */
38   u32 rcv_buffer_size;          /**< Rcv buffer size */
39   u32 prealloc_fifos;           /**< Preallocate fifos */
40   u32 private_segment_count;    /**< Number of private segments  */
41   u32 private_segment_size;     /**< Size of private segments  */
42   char *server_uri;             /**< Server URI */
43   u32 tls_engine;               /**< TLS engine: mbedtls/openssl */
44   u8 is_dgram;                  /**< set if transport is dgram */
45   /*
46    * Test state
47    */
48   u8 **rx_buf;                  /**< Per-thread RX buffer */
49   u64 byte_index;
50   u32 **rx_retries;
51
52   vlib_main_t *vlib_main;
53 } echo_server_main_t;
54
55 echo_server_main_t echo_server_main;
56
57 int
58 echo_server_session_accept_callback (stream_session_t * s)
59 {
60   echo_server_main_t *esm = &echo_server_main;
61
62   esm->vpp_queue[s->thread_index] =
63     session_manager_get_vpp_event_queue (s->thread_index);
64   s->session_state = SESSION_STATE_READY;
65   esm->byte_index = 0;
66   vec_validate (esm->rx_retries[s->thread_index], s->session_index);
67   esm->rx_retries[s->thread_index][s->session_index] = 0;
68   return 0;
69 }
70
71 void
72 echo_server_session_disconnect_callback (stream_session_t * s)
73 {
74   echo_server_main_t *esm = &echo_server_main;
75   vnet_disconnect_args_t _a, *a = &_a;
76
77   a->handle = session_handle (s);
78   a->app_index = esm->app_index;
79   vnet_disconnect_session (a);
80 }
81
82 void
83 echo_server_session_reset_callback (stream_session_t * s)
84 {
85   clib_warning ("Reset session %U", format_stream_session, s, 2);
86   stream_session_cleanup (s);
87 }
88
89 int
90 echo_server_session_connected_callback (u32 app_index, u32 api_context,
91                                         stream_session_t * s, u8 is_fail)
92 {
93   clib_warning ("called...");
94   return -1;
95 }
96
97 int
98 echo_server_add_segment_callback (u32 client_index, const ssvm_private_t * sp)
99 {
100   /* New heaps may be added */
101   return 0;
102 }
103
104 int
105 echo_server_redirect_connect_callback (u32 client_index, void *mp)
106 {
107   clib_warning ("called...");
108   return -1;
109 }
110
111 void
112 test_bytes (echo_server_main_t * esm, int actual_transfer)
113 {
114   int i;
115   u32 my_thread_id = vlib_get_thread_index ();
116
117   for (i = 0; i < actual_transfer; i++)
118     {
119       if (esm->rx_buf[my_thread_id][i] != ((esm->byte_index + i) & 0xff))
120         {
121           clib_warning ("at %lld expected %d got %d", esm->byte_index + i,
122                         (esm->byte_index + i) & 0xff,
123                         esm->rx_buf[my_thread_id][i]);
124         }
125     }
126   esm->byte_index += actual_transfer;
127 }
128
129 /*
130  * If no-echo, just drop the data and be done with it.
131  */
132 int
133 echo_server_builtin_server_rx_callback_no_echo (stream_session_t * s)
134 {
135   svm_fifo_t *rx_fifo = s->server_rx_fifo;
136   svm_fifo_dequeue_drop (rx_fifo, svm_fifo_max_dequeue (rx_fifo));
137   return 0;
138 }
139
140 int
141 echo_server_rx_callback (stream_session_t * s)
142 {
143   u32 n_written, max_dequeue, max_enqueue, max_transfer;
144   int actual_transfer;
145   svm_fifo_t *tx_fifo, *rx_fifo;
146   echo_server_main_t *esm = &echo_server_main;
147   session_fifo_event_t evt;
148   u32 thread_index = vlib_get_thread_index ();
149   app_session_transport_t at;
150   svm_queue_t *q;
151
152   ASSERT (s->thread_index == thread_index);
153
154   rx_fifo = s->server_rx_fifo;
155   tx_fifo = s->server_tx_fifo;
156
157   ASSERT (rx_fifo->master_thread_index == thread_index);
158   ASSERT (tx_fifo->master_thread_index == thread_index);
159
160   max_enqueue = svm_fifo_max_enqueue (tx_fifo);
161   if (!esm->is_dgram)
162     {
163       max_dequeue = svm_fifo_max_dequeue (rx_fifo);
164     }
165   else
166     {
167       session_dgram_pre_hdr_t ph;
168       svm_fifo_peek (rx_fifo, 0, sizeof (ph), (u8 *) & ph);
169       max_dequeue = ph.data_length - ph.data_offset;
170       if (!esm->vpp_queue[s->thread_index])
171         {
172           q = session_manager_get_vpp_event_queue (s->thread_index);
173           esm->vpp_queue[s->thread_index] = q;
174         }
175       max_enqueue -= sizeof (session_dgram_hdr_t);
176     }
177
178   if (PREDICT_FALSE (max_dequeue == 0))
179     return 0;
180
181   /* Number of bytes we're going to copy */
182   max_transfer = clib_min (max_dequeue, max_enqueue);
183
184   /* No space in tx fifo */
185   if (PREDICT_FALSE (max_transfer == 0))
186     {
187       /* XXX timeout for session that are stuck */
188
189     rx_event:
190       /* Program self-tap to retry */
191       if (svm_fifo_set_event (rx_fifo))
192         {
193           evt.fifo = rx_fifo;
194           evt.event_type = FIFO_EVENT_BUILTIN_RX;
195
196           q = esm->vpp_queue[s->thread_index];
197           if (PREDICT_FALSE (q->cursize == q->maxsize))
198             clib_warning ("out of event queue space");
199           else if (svm_queue_add (q, (u8 *) & evt, 0))
200             clib_warning ("failed to enqueue self-tap");
201
202           vec_validate (esm->rx_retries[s->thread_index], s->session_index);
203           if (esm->rx_retries[thread_index][s->session_index] == 500000)
204             {
205               clib_warning ("session stuck: %U", format_stream_session, s, 2);
206             }
207           if (esm->rx_retries[thread_index][s->session_index] < 500001)
208             esm->rx_retries[thread_index][s->session_index]++;
209         }
210
211       return 0;
212     }
213
214   vec_validate (esm->rx_buf[thread_index], max_transfer);
215   if (!esm->is_dgram)
216     {
217       actual_transfer = app_recv_stream_raw (rx_fifo,
218                                              esm->rx_buf[thread_index],
219                                              max_transfer,
220                                              0 /* don't clear event */ );
221     }
222   else
223     {
224       actual_transfer = app_recv_dgram_raw (rx_fifo,
225                                             esm->rx_buf[thread_index],
226                                             max_transfer, &at,
227                                             0 /* don't clear event */ );
228     }
229   ASSERT (actual_transfer == max_transfer);
230   /* test_bytes (esm, actual_transfer); */
231
232   /*
233    * Echo back
234    */
235
236   if (!esm->is_dgram)
237     {
238       n_written = app_send_stream_raw (tx_fifo,
239                                        esm->vpp_queue[thread_index],
240                                        esm->rx_buf[thread_index],
241                                        actual_transfer, 0);
242     }
243   else
244     {
245       n_written = app_send_dgram_raw (tx_fifo, &at,
246                                       esm->vpp_queue[s->thread_index],
247                                       esm->rx_buf[thread_index],
248                                       actual_transfer, 0);
249     }
250
251   if (n_written != max_transfer)
252     clib_warning ("short trout! written %u read %u", n_written, max_transfer);
253
254   if (PREDICT_FALSE (svm_fifo_max_dequeue (rx_fifo)))
255     goto rx_event;
256
257   return 0;
258 }
259
260 static session_cb_vft_t echo_server_session_cb_vft = {
261   .session_accept_callback = echo_server_session_accept_callback,
262   .session_disconnect_callback = echo_server_session_disconnect_callback,
263   .session_connected_callback = echo_server_session_connected_callback,
264   .add_segment_callback = echo_server_add_segment_callback,
265   .builtin_app_rx_callback = echo_server_rx_callback,
266   .session_reset_callback = echo_server_session_reset_callback
267 };
268
269 /* Abuse VPP's input queue */
270 static int
271 create_api_loopback (vlib_main_t * vm)
272 {
273   echo_server_main_t *esm = &echo_server_main;
274   api_main_t *am = &api_main;
275   vl_shmem_hdr_t *shmem_hdr;
276
277   shmem_hdr = am->shmem_hdr;
278   esm->vl_input_queue = shmem_hdr->vl_input_queue;
279   esm->my_client_index = vl_api_memclnt_create_internal ("echo_server",
280                                                          esm->vl_input_queue);
281   return 0;
282 }
283
284 static int
285 echo_server_attach (u8 * appns_id, u64 appns_flags, u64 appns_secret)
286 {
287   vnet_app_add_tls_cert_args_t _a_cert, *a_cert = &_a_cert;
288   vnet_app_add_tls_key_args_t _a_key, *a_key = &_a_key;
289   echo_server_main_t *esm = &echo_server_main;
290   vnet_app_attach_args_t _a, *a = &_a;
291   u64 options[APP_OPTIONS_N_OPTIONS];
292   u32 segment_size = 512 << 20;
293
294   memset (a, 0, sizeof (*a));
295   memset (options, 0, sizeof (options));
296
297   if (esm->no_echo)
298     echo_server_session_cb_vft.builtin_app_rx_callback =
299       echo_server_builtin_server_rx_callback_no_echo;
300   else
301     echo_server_session_cb_vft.builtin_app_rx_callback =
302       echo_server_rx_callback;
303
304   if (esm->private_segment_size)
305     segment_size = esm->private_segment_size;
306
307   a->api_client_index = esm->my_client_index;
308   a->session_cb_vft = &echo_server_session_cb_vft;
309   a->options = options;
310   a->options[APP_OPTIONS_SEGMENT_SIZE] = segment_size;
311   a->options[APP_OPTIONS_ADD_SEGMENT_SIZE] = segment_size;
312   a->options[APP_OPTIONS_RX_FIFO_SIZE] = esm->fifo_size;
313   a->options[APP_OPTIONS_TX_FIFO_SIZE] = esm->fifo_size;
314   a->options[APP_OPTIONS_PRIVATE_SEGMENT_COUNT] = esm->private_segment_count;
315   a->options[APP_OPTIONS_TLS_ENGINE] = esm->tls_engine;
316   a->options[APP_OPTIONS_PREALLOC_FIFO_PAIRS] =
317     esm->prealloc_fifos ? esm->prealloc_fifos : 1;
318
319   a->options[APP_OPTIONS_FLAGS] = APP_OPTIONS_FLAGS_IS_BUILTIN;
320   if (appns_id)
321     {
322       a->namespace_id = appns_id;
323       a->options[APP_OPTIONS_FLAGS] |= appns_flags;
324       a->options[APP_OPTIONS_NAMESPACE_SECRET] = appns_secret;
325     }
326
327   if (vnet_application_attach (a))
328     {
329       clib_warning ("failed to attach server");
330       return -1;
331     }
332   esm->app_index = a->app_index;
333
334   memset (a_cert, 0, sizeof (*a_cert));
335   a_cert->app_index = a->app_index;
336   vec_validate (a_cert->cert, test_srv_crt_rsa_len);
337   clib_memcpy (a_cert->cert, test_srv_crt_rsa, test_srv_crt_rsa_len);
338   vnet_app_add_tls_cert (a_cert);
339
340   memset (a_key, 0, sizeof (*a_key));
341   a_key->app_index = a->app_index;
342   vec_validate (a_key->key, test_srv_key_rsa_len);
343   clib_memcpy (a_key->key, test_srv_key_rsa, test_srv_key_rsa_len);
344   vnet_app_add_tls_key (a_key);
345   return 0;
346 }
347
348 static int
349 echo_server_detach (void)
350 {
351   echo_server_main_t *esm = &echo_server_main;
352   vnet_app_detach_args_t _da, *da = &_da;
353   int rv;
354
355   da->app_index = esm->app_index;
356   rv = vnet_application_detach (da);
357   esm->app_index = ~0;
358   return rv;
359 }
360
361 static int
362 echo_server_listen ()
363 {
364   echo_server_main_t *esm = &echo_server_main;
365   vnet_bind_args_t _a, *a = &_a;
366   memset (a, 0, sizeof (*a));
367   a->app_index = esm->app_index;
368   a->uri = esm->server_uri;
369   return vnet_bind_uri (a);
370 }
371
372 static int
373 echo_server_create (vlib_main_t * vm, u8 * appns_id, u64 appns_flags,
374                     u64 appns_secret)
375 {
376   echo_server_main_t *esm = &echo_server_main;
377   vlib_thread_main_t *vtm = vlib_get_thread_main ();
378   u32 num_threads;
379   int i;
380
381   if (esm->my_client_index == (u32) ~ 0)
382     {
383       if (create_api_loopback (vm))
384         {
385           clib_warning ("failed to create api loopback");
386           return -1;
387         }
388     }
389
390   num_threads = 1 /* main thread */  + vtm->n_threads;
391   vec_validate (echo_server_main.vpp_queue, num_threads - 1);
392   vec_validate (esm->rx_buf, num_threads - 1);
393   vec_validate (esm->rx_retries, num_threads - 1);
394
395   esm->rcv_buffer_size = clib_max (esm->rcv_buffer_size, esm->fifo_size);
396   for (i = 0; i < num_threads; i++)
397     vec_validate (esm->rx_buf[i], esm->rcv_buffer_size);
398
399   if (echo_server_attach (appns_id, appns_flags, appns_secret))
400     {
401       clib_warning ("failed to attach server");
402       return -1;
403     }
404   if (echo_server_listen ())
405     {
406       clib_warning ("failed to start listening");
407       if (echo_server_detach ())
408         clib_warning ("failed to detach");
409       return -1;
410     }
411   return 0;
412 }
413
414 static clib_error_t *
415 echo_server_create_command_fn (vlib_main_t * vm, unformat_input_t * input,
416                                vlib_cli_command_t * cmd)
417 {
418   echo_server_main_t *esm = &echo_server_main;
419   u8 server_uri_set = 0, *appns_id = 0;
420   u64 tmp, appns_flags = 0, appns_secret = 0;
421   char *default_uri = "tcp://0.0.0.0/1234";
422   int rv, is_stop = 0;
423
424   esm->no_echo = 0;
425   esm->fifo_size = 64 << 10;
426   esm->rcv_buffer_size = 128 << 10;
427   esm->prealloc_fifos = 0;
428   esm->private_segment_count = 0;
429   esm->private_segment_size = 0;
430   esm->tls_engine = TLS_ENGINE_OPENSSL;
431   esm->is_dgram = 0;
432   vec_free (esm->server_uri);
433
434   while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
435     {
436       if (unformat (input, "uri %s", &esm->server_uri))
437         server_uri_set = 1;
438       else if (unformat (input, "no-echo"))
439         esm->no_echo = 1;
440       else if (unformat (input, "fifo-size %d", &esm->fifo_size))
441         esm->fifo_size <<= 10;
442       else if (unformat (input, "rcv-buf-size %d", &esm->rcv_buffer_size))
443         ;
444       else if (unformat (input, "prealloc-fifos %d", &esm->prealloc_fifos))
445         ;
446       else if (unformat (input, "private-segment-count %d",
447                          &esm->private_segment_count))
448         ;
449       else if (unformat (input, "private-segment-size %U",
450                          unformat_memory_size, &tmp))
451         {
452           if (tmp >= 0x100000000ULL)
453             return clib_error_return
454               (0, "private segment size %lld (%llu) too large", tmp, tmp);
455           esm->private_segment_size = tmp;
456         }
457       else if (unformat (input, "appns %_%v%_", &appns_id))
458         ;
459       else if (unformat (input, "all-scope"))
460         appns_flags |= (APP_OPTIONS_FLAGS_USE_GLOBAL_SCOPE
461                         | APP_OPTIONS_FLAGS_USE_LOCAL_SCOPE);
462       else if (unformat (input, "local-scope"))
463         appns_flags |= APP_OPTIONS_FLAGS_USE_LOCAL_SCOPE;
464       else if (unformat (input, "global-scope"))
465         appns_flags |= APP_OPTIONS_FLAGS_USE_GLOBAL_SCOPE;
466       else if (unformat (input, "secret %lu", &appns_secret))
467         ;
468       else if (unformat (input, "stop"))
469         is_stop = 1;
470       else if (unformat (input, "tls-engine %d", &esm->tls_engine))
471         ;
472       else
473         return clib_error_return (0, "failed: unknown input `%U'",
474                                   format_unformat_error, input);
475     }
476
477   if (is_stop)
478     {
479       if (esm->app_index == (u32) ~ 0)
480         {
481           clib_warning ("server not running");
482           return clib_error_return (0, "failed: server not running");
483         }
484       rv = echo_server_detach ();
485       if (rv)
486         {
487           clib_warning ("failed: detach");
488           return clib_error_return (0, "failed: server detach %d", rv);
489         }
490       return 0;
491     }
492
493   vnet_session_enable_disable (vm, 1 /* turn on TCP, etc. */ );
494
495   if (!server_uri_set)
496     {
497       clib_warning ("No uri provided! Using default: %s", default_uri);
498       esm->server_uri = (char *) format (0, "%s%c", default_uri, 0);
499     }
500   if (esm->server_uri[0] == 'u' && esm->server_uri[3] != 'c')
501     esm->is_dgram = 1;
502
503   rv = echo_server_create (vm, appns_id, appns_flags, appns_secret);
504   vec_free (appns_id);
505   if (rv)
506     {
507       vec_free (esm->server_uri);
508       return clib_error_return (0, "failed: server_create returned %d", rv);
509     }
510
511   return 0;
512 }
513
514 /* *INDENT-OFF* */
515 VLIB_CLI_COMMAND (echo_server_create_command, static) =
516 {
517   .path = "test echo server",
518   .short_help = "test echo server proto <proto> [no echo][fifo-size <mbytes>]"
519       "[rcv-buf-size <bytes>][prealloc-fifos <count>]"
520       "[private-segment-count <count>][private-segment-size <bytes[m|g]>]"
521       "[uri <tcp://ip/port>]",
522   .function = echo_server_create_command_fn,
523 };
524 /* *INDENT-ON* */
525
526 clib_error_t *
527 echo_server_main_init (vlib_main_t * vm)
528 {
529   echo_server_main_t *esm = &echo_server_main;
530   esm->my_client_index = ~0;
531   return 0;
532 }
533
534 VLIB_INIT_FUNCTION (echo_server_main_init);
535
536 /*
537 * fd.io coding-style-patch-verification: ON
538 *
539 * Local Variables:
540 * eval: (c-set-style "gnu")
541 * End:
542 */