session: api to add new transport types
[vpp.git] / src / plugins / hs_apps / sapi / vpp_echo_common.c
1 /*
2  * Copyright (c) 2019 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 <stdio.h>
17 #include <signal.h>
18
19 #include <hs_apps/sapi/vpp_echo_common.h>
20
21 char *echo_fail_code_str[] = {
22 #define _(sym, str) str,
23   foreach_echo_fail_code
24 #undef _
25 };
26
27 /*
28  *
29  *  Format functions
30  *
31  */
32
33 u8 *
34 format_ip4_address (u8 * s, va_list * args)
35 {
36   u8 *a = va_arg (*args, u8 *);
37   return format (s, "%d.%d.%d.%d", a[0], a[1], a[2], a[3]);
38 }
39
40 u8 *
41 format_ip6_address (u8 * s, va_list * args)
42 {
43   ip6_address_t *a = va_arg (*args, ip6_address_t *);
44   u32 i, i_max_n_zero, max_n_zeros, i_first_zero, n_zeros, last_double_colon;
45
46   i_max_n_zero = ARRAY_LEN (a->as_u16);
47   max_n_zeros = 0;
48   i_first_zero = i_max_n_zero;
49   n_zeros = 0;
50   for (i = 0; i < ARRAY_LEN (a->as_u16); i++)
51     {
52       u32 is_zero = a->as_u16[i] == 0;
53       if (is_zero && i_first_zero >= ARRAY_LEN (a->as_u16))
54         {
55           i_first_zero = i;
56           n_zeros = 0;
57         }
58       n_zeros += is_zero;
59       if ((!is_zero && n_zeros > max_n_zeros)
60           || (i + 1 >= ARRAY_LEN (a->as_u16) && n_zeros > max_n_zeros))
61         {
62           i_max_n_zero = i_first_zero;
63           max_n_zeros = n_zeros;
64           i_first_zero = ARRAY_LEN (a->as_u16);
65           n_zeros = 0;
66         }
67     }
68
69   last_double_colon = 0;
70   for (i = 0; i < ARRAY_LEN (a->as_u16); i++)
71     {
72       if (i == i_max_n_zero && max_n_zeros > 1)
73         {
74           s = format (s, "::");
75           i += max_n_zeros - 1;
76           last_double_colon = 1;
77         }
78       else
79         {
80           s = format (s, "%s%x",
81                       (last_double_colon || i == 0) ? "" : ":",
82                       clib_net_to_host_u16 (a->as_u16[i]));
83           last_double_colon = 0;
84         }
85     }
86
87   return s;
88 }
89
90 /* Format an IP46 address. */
91 u8 *
92 format_ip46_address (u8 * s, va_list * args)
93 {
94   ip46_address_t *ip46 = va_arg (*args, ip46_address_t *);
95   ip46_type_t type = va_arg (*args, ip46_type_t);
96   int is_ip4 = 1;
97
98   switch (type)
99     {
100     case IP46_TYPE_ANY:
101       is_ip4 = ip46_address_is_ip4 (ip46);
102       break;
103     case IP46_TYPE_IP4:
104       is_ip4 = 1;
105       break;
106     case IP46_TYPE_IP6:
107       is_ip4 = 0;
108       break;
109     }
110
111   return is_ip4 ?
112     format (s, "%U", format_ip4_address, &ip46->ip4) :
113     format (s, "%U", format_ip6_address, &ip46->ip6);
114 }
115
116 u8 *
117 format_api_error (u8 * s, va_list * args)
118 {
119   echo_main_t *em = &echo_main;
120   i32 error = va_arg (*args, u32);
121   uword *p;
122
123   p = hash_get (em->error_string_by_error_number, -error);
124
125   if (p)
126     s = format (s, "%s", p[0]);
127   else
128     s = format (s, "%d", error);
129   return s;
130 }
131
132 void
133 init_error_string_table ()
134 {
135   echo_main_t *em = &echo_main;
136   em->error_string_by_error_number = hash_create (0, sizeof (uword));
137
138 #define _(n,v,s) hash_set (em->error_string_by_error_number, -v, s);
139   foreach_vnet_api_error;
140 #undef _
141
142   hash_set (em->error_string_by_error_number, 99, "Misc");
143 }
144
145 u8 *
146 echo_format_session (u8 * s, va_list * args)
147 {
148   echo_session_t *session = va_arg (*args, echo_session_t *);
149
150   return format (s, "%U 0x%lx S[%u]", echo_format_session_type,
151                  session->session_type, session->vpp_session_handle,
152                  session->session_index);
153 }
154
155 u8 *
156 echo_format_session_type (u8 * s, va_list * args)
157 {
158   u32 session_type = va_arg (*args, u32);
159   switch (session_type)
160     {
161     case ECHO_SESSION_TYPE_QUIC:
162       return format (s, "Qsession");
163     case ECHO_SESSION_TYPE_STREAM:
164       return format (s, "Stream");
165     case ECHO_SESSION_TYPE_LISTEN:
166       return format (s, "Lsession");
167     default:
168       break;
169     }
170   return format (s, "BadSession");
171 }
172
173 u8 *
174 echo_format_session_state (u8 * s, va_list * args)
175 {
176   u32 session_state = va_arg (*args, u32);
177   switch (session_state)
178     {
179     case ECHO_SESSION_STATE_INITIAL:
180       return format (s, "ECHO_SESSION_STATE_INITIAL (%u)", session_state);
181     case ECHO_SESSION_STATE_READY:
182       return format (s, "ECHO_SESSION_STATE_READY (%u)", session_state);
183     case ECHO_SESSION_STATE_AWAIT_CLOSING:
184       return format (s, "ECHO_SESSION_STATE_AWAIT_CLOSING (%u)",
185                      session_state);
186     case ECHO_SESSION_STATE_AWAIT_DATA:
187       return format (s, "ECHO_SESSION_STATE_AWAIT_DATA (%u)", session_state);
188     case ECHO_SESSION_STATE_CLOSING:
189       return format (s, "ECHO_SESSION_STATE_CLOSING (%u)", session_state);
190     case ECHO_SESSION_STATE_CLOSED:
191       return format (s, "ECHO_SESSION_STATE_CLOSED (%u)", session_state);
192     default:
193       break;
194     }
195   return format (s, "unknown session state (%u)", session_state);
196 }
197
198 u8 *
199 echo_format_app_state (u8 * s, va_list * args)
200 {
201   u32 state = va_arg (*args, u32);
202   if (state == STATE_START)
203     return format (s, "STATE_START (%u)", state);
204   if (state == STATE_ATTACHED)
205     return format (s, "STATE_ATTACHED (%u)", state);
206   if (state == STATE_ATTACHED_NO_CERT)
207     return format (s, "STATE_ATTACHED_NO_CERT (%u)", state);
208   if (state == STATE_LISTEN)
209     return format (s, "STATE_LISTEN (%u)", state);
210   if (state == STATE_READY)
211     return format (s, "STATE_READY (%u)", state);
212   if (state == STATE_DATA_DONE)
213     return format (s, "STATE_DATA_DONE (%u)", state);
214   if (state == STATE_DISCONNECTED)
215     return format (s, "STATE_DISCONNECTED (%u)", state);
216   if (state == STATE_DETACHED)
217     return format (s, "STATE_DETACHED (%u)", state);
218   else
219     return format (s, "unknown state (%u)", state);
220 }
221
222 uword
223 echo_unformat_close (unformat_input_t * input, va_list * args)
224 {
225   u8 *a = va_arg (*args, u8 *);
226   if (unformat (input, "Y"))
227     *a = ECHO_CLOSE_F_ACTIVE;
228   else if (unformat (input, "N"))
229     *a = ECHO_CLOSE_F_NONE;
230   else if (unformat (input, "W"))
231     *a = ECHO_CLOSE_F_PASSIVE;
232   else
233     return 0;
234   return 1;
235 }
236
237 uword
238 echo_unformat_timing_event (unformat_input_t * input, va_list * args)
239 {
240   u8 *a = va_arg (*args, u8 *);
241   if (unformat (input, "start"))
242     *a = ECHO_EVT_START;
243   else if (unformat (input, "qconnected"))
244     *a = ECHO_EVT_LAST_QCONNECTED;
245   else if (unformat (input, "qconnect"))
246     *a = ECHO_EVT_FIRST_QCONNECT;
247   else if (unformat (input, "sconnected"))
248     *a = ECHO_EVT_LAST_SCONNECTED;
249   else if (unformat (input, "sconnect"))
250     *a = ECHO_EVT_FIRST_SCONNECT;
251   else if (unformat (input, "lastbyte"))
252     *a = ECHO_EVT_LAST_BYTE;
253   else if (unformat (input, "exit"))
254     *a = ECHO_EVT_EXIT;
255   else
256     return 0;
257   return 1;
258 }
259
260 u8 *
261 echo_format_bytes_per_sec (u8 * s, va_list * args)
262 {
263   f64 bps = va_arg (*args, f64) * 8;
264   if (bps > 1e9)
265     return format (s, "%.3f Gb/s", bps / 1e9);
266   else if (bps > 1e6)
267     return format (s, "%.3f Mb/s", bps / 1e6);
268   else if (bps > 1e3)
269     return format (s, "%.3f Kb/s", bps / 1e3);
270   else
271     return format (s, "%.3f b/s", bps);
272 }
273
274 u8 *
275 echo_format_timing_event (u8 * s, va_list * args)
276 {
277   u32 timing_event = va_arg (*args, u32);
278   if (timing_event == ECHO_EVT_START)
279     return format (s, "start");
280   if (timing_event == ECHO_EVT_FIRST_QCONNECT)
281     return format (s, "qconnect");
282   if (timing_event == ECHO_EVT_LAST_QCONNECTED)
283     return format (s, "qconnected");
284   if (timing_event == ECHO_EVT_FIRST_SCONNECT)
285     return format (s, "sconnect");
286   if (timing_event == ECHO_EVT_LAST_SCONNECTED)
287     return format (s, "sconnected");
288   if (timing_event == ECHO_EVT_LAST_BYTE)
289     return format (s, "lastbyte");
290   if (timing_event == ECHO_EVT_EXIT)
291     return format (s, "exit");
292   else
293     return format (s, "unknown timing event");
294 }
295
296 uword
297 unformat_transport_proto (unformat_input_t * input, va_list * args)
298 {
299   u32 *proto = va_arg (*args, u32 *);
300   if (unformat (input, "tcp"))
301     *proto = TRANSPORT_PROTO_TCP;
302   else if (unformat (input, "TCP"))
303     *proto = TRANSPORT_PROTO_TCP;
304   else if (unformat (input, "udpc"))
305     *proto = TRANSPORT_PROTO_UDPC;
306   else if (unformat (input, "UDPC"))
307     *proto = TRANSPORT_PROTO_UDPC;
308   else if (unformat (input, "udp"))
309     *proto = TRANSPORT_PROTO_UDP;
310   else if (unformat (input, "UDP"))
311     *proto = TRANSPORT_PROTO_UDP;
312   else if (unformat (input, "tls"))
313     *proto = TRANSPORT_PROTO_TLS;
314   else if (unformat (input, "TLS"))
315     *proto = TRANSPORT_PROTO_TLS;
316   else if (unformat (input, "quic"))
317     *proto = TRANSPORT_PROTO_QUIC;
318   else if (unformat (input, "QUIC"))
319     *proto = TRANSPORT_PROTO_QUIC;
320   else
321     return 0;
322   return 1;
323 }
324
325 u8 *
326 format_transport_proto (u8 * s, va_list * args)
327 {
328   u32 transport_proto = va_arg (*args, u32);
329   switch (transport_proto)
330     {
331     case TRANSPORT_PROTO_TCP:
332       s = format (s, "TCP");
333       break;
334     case TRANSPORT_PROTO_UDP:
335       s = format (s, "UDP");
336       break;
337     case TRANSPORT_PROTO_NONE:
338       s = format (s, "NONE");
339       break;
340     case TRANSPORT_PROTO_TLS:
341       s = format (s, "TLS");
342       break;
343     case TRANSPORT_PROTO_UDPC:
344       s = format (s, "UDPC");
345       break;
346     case TRANSPORT_PROTO_QUIC:
347       s = format (s, "QUIC");
348       break;
349     default:
350       s = format (s, "UNKNOWN");
351       break;
352     }
353   return s;
354 }
355
356 uword
357 unformat_ip4_address (unformat_input_t * input, va_list * args)
358 {
359   u8 *result = va_arg (*args, u8 *);
360   unsigned a[4];
361
362   if (!unformat (input, "%d.%d.%d.%d", &a[0], &a[1], &a[2], &a[3]))
363     return 0;
364
365   if (a[0] >= 256 || a[1] >= 256 || a[2] >= 256 || a[3] >= 256)
366     return 0;
367
368   result[0] = a[0];
369   result[1] = a[1];
370   result[2] = a[2];
371   result[3] = a[3];
372
373   return 1;
374 }
375
376 uword
377 unformat_ip6_address (unformat_input_t * input, va_list * args)
378 {
379   ip6_address_t *result = va_arg (*args, ip6_address_t *);
380   u16 hex_quads[8];
381   uword hex_quad, n_hex_quads, hex_digit, n_hex_digits;
382   uword c, n_colon, double_colon_index;
383
384   n_hex_quads = hex_quad = n_hex_digits = n_colon = 0;
385   double_colon_index = ARRAY_LEN (hex_quads);
386   while ((c = unformat_get_input (input)) != UNFORMAT_END_OF_INPUT)
387     {
388       hex_digit = 16;
389       if (c >= '0' && c <= '9')
390         hex_digit = c - '0';
391       else if (c >= 'a' && c <= 'f')
392         hex_digit = c + 10 - 'a';
393       else if (c >= 'A' && c <= 'F')
394         hex_digit = c + 10 - 'A';
395       else if (c == ':' && n_colon < 2)
396         n_colon++;
397       else
398         {
399           unformat_put_input (input);
400           break;
401         }
402
403       /* Too many hex quads. */
404       if (n_hex_quads >= ARRAY_LEN (hex_quads))
405         return 0;
406
407       if (hex_digit < 16)
408         {
409           hex_quad = (hex_quad << 4) | hex_digit;
410
411           /* Hex quad must fit in 16 bits. */
412           if (n_hex_digits >= 4)
413             return 0;
414
415           n_colon = 0;
416           n_hex_digits++;
417         }
418
419       /* Save position of :: */
420       if (n_colon == 2)
421         {
422           /* More than one :: ? */
423           if (double_colon_index < ARRAY_LEN (hex_quads))
424             return 0;
425           double_colon_index = n_hex_quads;
426         }
427
428       if (n_colon > 0 && n_hex_digits > 0)
429         {
430           hex_quads[n_hex_quads++] = hex_quad;
431           hex_quad = 0;
432           n_hex_digits = 0;
433         }
434     }
435
436   if (n_hex_digits > 0)
437     hex_quads[n_hex_quads++] = hex_quad;
438
439   {
440     word i;
441
442     /* Expand :: to appropriate number of zero hex quads. */
443     if (double_colon_index < ARRAY_LEN (hex_quads))
444       {
445         word n_zero = ARRAY_LEN (hex_quads) - n_hex_quads;
446
447         for (i = n_hex_quads - 1; i >= (signed) double_colon_index; i--)
448           hex_quads[n_zero + i] = hex_quads[i];
449
450         for (i = 0; i < n_zero; i++)
451           hex_quads[double_colon_index + i] = 0;
452
453         n_hex_quads = ARRAY_LEN (hex_quads);
454       }
455
456     /* Too few hex quads given. */
457     if (n_hex_quads < ARRAY_LEN (hex_quads))
458       return 0;
459
460     for (i = 0; i < ARRAY_LEN (hex_quads); i++)
461       result->as_u16[i] = clib_host_to_net_u16 (hex_quads[i]);
462
463     return 1;
464   }
465 }
466
467 uword
468 unformat_ip46_address (unformat_input_t * input, va_list * args)
469 {
470   ip46_address_t *ip = va_arg (*args, ip46_address_t *);
471
472   if (unformat (input, "%U", unformat_ip4_address, &ip->ip4))
473     ;
474   else if (unformat (input, "%U", unformat_ip6_address, &ip->ip6))
475     ;
476   else
477     return 0;
478   return 1;
479 }
480
481 u8 *
482 echo_format_crypto_engine (u8 * s, va_list * args)
483 {
484   u32 state = va_arg (*args, u32);
485   if (state == CRYPTO_ENGINE_MBEDTLS)
486     return format (s, "mbedtls");
487   if (state == CRYPTO_ENGINE_OPENSSL)
488     return format (s, "openssl");
489   if (state == CRYPTO_ENGINE_PICOTLS)
490     return format (s, "picotls");
491   if (state == CRYPTO_ENGINE_VPP)
492     return format (s, "vpp");
493   else
494     return format (s, "unknown crypto engine");
495 }
496
497 uword
498 echo_unformat_crypto_engine (unformat_input_t * input, va_list * args)
499 {
500   u8 *a = va_arg (*args, u8 *);
501   if (unformat (input, "mbedtls"))
502     *a = CRYPTO_ENGINE_MBEDTLS;
503   else if (unformat (input, "openssl"))
504     *a = CRYPTO_ENGINE_OPENSSL;
505   else if (unformat (input, "picotls"))
506     *a = CRYPTO_ENGINE_PICOTLS;
507   else if (unformat (input, "vpp"))
508     *a = CRYPTO_ENGINE_VPP;
509   else
510     return 0;
511   return 1;
512 }
513
514
515 /*
516  *
517  *  End of format functions
518  *
519  */
520
521 void
522 echo_session_handle_add_del (echo_main_t * em, u64 handle, u32 sid)
523 {
524   clib_spinlock_lock (&em->sid_vpp_handles_lock);
525   if (sid == SESSION_INVALID_INDEX)
526     {
527       ECHO_LOG (3, "hash_unset(0x%lx)", handle);
528       hash_unset (em->session_index_by_vpp_handles, handle);
529     }
530   else
531     {
532       ECHO_LOG (3, "hash_set(0x%lx) S[%d]", handle, sid);
533       hash_set (em->session_index_by_vpp_handles, handle, sid);
534     }
535   clib_spinlock_unlock (&em->sid_vpp_handles_lock);
536 }
537
538 echo_session_t *
539 echo_session_new (echo_main_t * em)
540 {
541   /* thread safe new prealloced session
542    * see echo_session_prealloc */
543   return pool_elt_at_index (em->sessions,
544                             clib_atomic_fetch_add (&em->nxt_available_sidx,
545                                                    1));
546 }
547
548 int
549 echo_send_rpc (echo_main_t * em, void *fp, echo_rpc_args_t * args)
550 {
551   svm_msg_q_msg_t msg;
552   echo_rpc_msg_t *evt;
553   if (PREDICT_FALSE (svm_msg_q_lock (em->rpc_msq_queue)))
554     {
555       ECHO_FAIL (ECHO_FAIL_RPC_SIZE, "RPC lock failed");
556       return -1;
557     }
558   if (PREDICT_FALSE (svm_msg_q_ring_is_full (em->rpc_msq_queue, 0)))
559     {
560       svm_msg_q_unlock (em->rpc_msq_queue);
561       ECHO_FAIL (ECHO_FAIL_RPC_SIZE, "RPC ring is full");
562       return -2;
563     }
564   msg = svm_msg_q_alloc_msg_w_ring (em->rpc_msq_queue, 0);
565   evt = (echo_rpc_msg_t *) svm_msg_q_msg_data (em->rpc_msq_queue, &msg);
566   evt->fp = fp;
567   clib_memcpy (&evt->args, args, sizeof (evt->args));
568
569   svm_msg_q_add_and_unlock (em->rpc_msq_queue, &msg);
570   return 0;
571 }
572
573 echo_session_t *
574 echo_get_session_from_handle (echo_main_t * em, u64 handle)
575 {
576   uword *p;
577   clib_spinlock_lock (&em->sid_vpp_handles_lock);
578   p = hash_get (em->session_index_by_vpp_handles, handle);
579   clib_spinlock_unlock (&em->sid_vpp_handles_lock);
580   if (!p)
581     {
582       ECHO_LOG (2, "unknown handle 0x%lx", handle);
583       return 0;
584     }
585   return pool_elt_at_index (em->sessions, p[0]);
586 }
587
588 int
589 wait_for_state_change (echo_main_t * em, connection_state_t state,
590                        f64 timeout)
591 {
592   f64 end_time = clib_time_now (&em->clib_time) + timeout;
593   while (!timeout || clib_time_now (&em->clib_time) < end_time)
594     {
595       if (em->state == state)
596         return 0;
597       if (em->time_to_stop)
598         return 1;
599     }
600   ECHO_LOG (2, "timeout waiting for %U", echo_format_app_state, state);
601   return -1;
602 }
603
604 void
605 echo_notify_event (echo_main_t * em, echo_test_evt_t e)
606 {
607   if (em->timing.events_sent & e)
608     return;
609   if (em->timing.start_event == e)
610     em->timing.start_time = clib_time_now (&em->clib_time);
611   else if (em->timing.end_event == e)
612     em->timing.end_time = clib_time_now (&em->clib_time);
613   em->timing.events_sent |= e;
614 }
615
616 void
617 echo_session_print_stats (echo_main_t * em, echo_session_t * session)
618 {
619   f64 deltat = clib_time_now (&em->clib_time) - session->start;
620   ECHO_LOG (1, "Session 0x%x done in %.6fs RX[%.4f] TX[%.4f] Gbit/s\n",
621             session->vpp_session_handle, deltat,
622             (session->bytes_received * 8.0) / deltat / 1e9,
623             (session->bytes_sent * 8.0) / deltat / 1e9);
624 }
625
626 /*
627  * fd.io coding-style-patch-verification: ON
628  *
629  * Local Variables:
630  * eval: (c-set-style "gnu")
631  * End:
632  */