2 * echo_client.c - vpp built-in echo client code
4 * Copyright (c) 2017 by Cisco and/or its affiliates.
5 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at:
9 * http://www.apache.org/licenses/LICENSE-2.0
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
18 #include <vnet/vnet.h>
19 #include <vlibapi/api.h>
20 #include <vlibmemory/api.h>
21 #include <vnet/session-apps/echo_client.h>
23 echo_client_main_t echo_client_main;
25 #define ECHO_CLIENT_DBG (0)
28 signal_evt_to_cli_i (int *code)
30 echo_client_main_t *ecm = &echo_client_main;
31 ASSERT (vlib_get_thread_index () == 0);
32 vlib_process_signal_event (ecm->vlib_main, ecm->cli_node_index, *code, 0);
36 signal_evt_to_cli (int code)
38 if (vlib_get_thread_index () != 0)
39 vl_api_rpc_call_main_thread (signal_evt_to_cli_i, (u8 *) & code,
42 signal_evt_to_cli_i (&code);
46 send_data_chunk (echo_client_main_t * ecm, session_t * s)
48 u8 *test_data = ecm->connect_test_data;
51 session_fifo_event_t evt;
55 ASSERT (vec_len (test_data) > 0);
57 test_buf_offset = s->bytes_sent % vec_len (test_data);
58 bytes_this_chunk = vec_len (test_data) - test_buf_offset;
60 bytes_this_chunk = bytes_this_chunk < s->bytes_to_send
61 ? bytes_this_chunk : s->bytes_to_send;
63 txf = s->server_tx_fifo;
64 rv = svm_fifo_enqueue_nowait (txf, bytes_this_chunk,
65 test_data + test_buf_offset);
67 /* If we managed to enqueue data... */
70 /* Account for it... */
71 s->bytes_to_send -= rv;
77 ELOG_TYPE_DECLARE (e) =
79 .format = "tx-enq: xfer %d bytes, sent %u remain %u",
80 .format_args = "i4i4i4",
87 ed = ELOG_DATA (&vlib_global_main.elog_main, e);
89 ed->data[1] = s->bytes_sent;
90 ed->data[2] = s->bytes_to_send;
93 /* Poke the session layer */
94 if (svm_fifo_set_event (txf))
96 /* Fabricate TX event, send to vpp */
98 evt.event_type = FIFO_EVENT_APP_TX;
101 (ecm->vpp_event_queue[txf->master_thread_index], (u8 *) & evt,
102 0 /* do wait for mutex */ ))
103 clib_warning ("could not enqueue event");
109 receive_data_chunk (echo_client_main_t * ecm, session_t * s)
111 svm_fifo_t *rx_fifo = s->server_rx_fifo;
112 u32 my_thread_index = vlib_get_thread_index ();
117 n_read = svm_fifo_dequeue_nowait (rx_fifo,
120 ecm->rx_buf[my_thread_index]);
124 n_read = svm_fifo_max_dequeue (rx_fifo);
125 svm_fifo_dequeue_drop (rx_fifo, n_read);
133 ELOG_TYPE_DECLARE (e) =
135 .format = "rx-deq: %d bytes",
143 ed = ELOG_DATA (&vlib_global_main.elog_main, e);
144 ed->data[0] = n_read;
149 for (i = 0; i < n_read; i++)
151 if (ecm->rx_buf[my_thread_index][i]
152 != ((s->bytes_received + i) & 0xff))
154 clib_warning ("read %d error at byte %lld, 0x%x not 0x%x",
155 n_read, s->bytes_received + i,
156 ecm->rx_buf[my_thread_index][i],
157 ((s->bytes_received + i) & 0xff));
158 ecm->test_failed = 1;
162 s->bytes_to_receive -= n_read;
163 s->bytes_received += n_read;
168 echo_client_node_fn (vlib_main_t * vm, vlib_node_runtime_t * node,
169 vlib_frame_t * frame)
171 echo_client_main_t *ecm = &echo_client_main;
172 int my_thread_index = vlib_get_thread_index ();
176 u32 *connection_indices;
177 u32 *connections_this_batch;
178 u32 nconnections_this_batch;
180 connection_indices = ecm->connection_index_by_thread[my_thread_index];
181 connections_this_batch =
182 ecm->connections_this_batch_by_thread[my_thread_index];
184 if ((ecm->run_test == 0) ||
185 ((vec_len (connection_indices) == 0)
186 && vec_len (connections_this_batch) == 0))
189 /* Grab another pile of connections */
190 if (PREDICT_FALSE (vec_len (connections_this_batch) == 0))
192 nconnections_this_batch =
193 clib_min (ecm->connections_per_batch, vec_len (connection_indices));
195 ASSERT (nconnections_this_batch > 0);
196 vec_validate (connections_this_batch, nconnections_this_batch - 1);
197 clib_memcpy (connections_this_batch,
198 connection_indices + vec_len (connection_indices)
199 - nconnections_this_batch,
200 nconnections_this_batch * sizeof (u32));
201 _vec_len (connection_indices) -= nconnections_this_batch;
204 if (PREDICT_FALSE (ecm->prev_conns != ecm->connections_per_batch
205 && ecm->prev_conns == vec_len (connections_this_batch)))
208 ecm->prev_conns = vec_len (connections_this_batch);
209 if (ecm->repeats == 500000)
211 clib_warning ("stuck clients");
216 ecm->prev_conns = vec_len (connections_this_batch);
220 for (i = 0; i < vec_len (connections_this_batch); i++)
224 sp = pool_elt_at_index (ecm->sessions, connections_this_batch[i]);
226 if (sp->bytes_to_send > 0)
228 send_data_chunk (ecm, sp);
231 if (sp->bytes_to_receive > 0)
233 receive_data_chunk (ecm, sp);
236 if (PREDICT_FALSE (delete_session == 1))
238 u32 index, thread_index;
241 __sync_fetch_and_add (&ecm->tx_total, sp->bytes_sent);
242 __sync_fetch_and_add (&ecm->rx_total, sp->bytes_received);
244 session_parse_handle (sp->vpp_session_handle,
245 &index, &thread_index);
246 s = session_get_if_valid (index, thread_index);
250 vnet_disconnect_args_t _a, *a = &_a;
251 a->handle = session_handle (s);
252 a->app_index = ecm->app_index;
253 vnet_disconnect_session (a);
255 vec_delete (connections_this_batch, 1, i);
257 __sync_fetch_and_add (&ecm->ready_connections, -1);
261 clib_warning ("session AWOL?");
262 vec_delete (connections_this_batch, 1, i);
265 /* Kick the debug CLI process */
266 if (ecm->ready_connections == 0)
268 signal_evt_to_cli (2);
273 ecm->connection_index_by_thread[my_thread_index] = connection_indices;
274 ecm->connections_this_batch_by_thread[my_thread_index] =
275 connections_this_batch;
280 VLIB_REGISTER_NODE (echo_clients_node) =
282 .function = echo_client_node_fn,
283 .name = "echo-clients",
284 .type = VLIB_NODE_TYPE_INPUT,
285 .state = VLIB_NODE_STATE_DISABLED,
290 create_api_loopback (echo_client_main_t * ecm)
292 api_main_t *am = &api_main;
293 vl_shmem_hdr_t *shmem_hdr;
295 shmem_hdr = am->shmem_hdr;
296 ecm->vl_input_queue = shmem_hdr->vl_input_queue;
297 ecm->my_client_index = vl_api_memclnt_create_internal ("echo_client",
298 ecm->vl_input_queue);
303 echo_clients_init (vlib_main_t * vm)
305 echo_client_main_t *ecm = &echo_client_main;
306 vlib_thread_main_t *vtm = vlib_get_thread_main ();
310 if (create_api_loopback (ecm))
313 num_threads = 1 /* main thread */ + vtm->n_threads;
315 /* Init test data. Bigecmuffer */
316 vec_validate (ecm->connect_test_data, 1024 * 1024 - 1);
317 for (i = 0; i < vec_len (ecm->connect_test_data); i++)
318 ecm->connect_test_data[i] = i & 0xff;
320 vec_validate (ecm->rx_buf, num_threads - 1);
321 for (i = 0; i < num_threads; i++)
322 vec_validate (ecm->rx_buf[i], vec_len (ecm->connect_test_data) - 1);
326 vec_validate (ecm->connection_index_by_thread, vtm->n_vlib_mains);
327 vec_validate (ecm->connections_this_batch_by_thread, vtm->n_vlib_mains);
328 vec_validate (ecm->vpp_event_queue, vtm->n_vlib_mains);
334 echo_clients_session_connected_callback (u32 app_index, u32 api_context,
335 stream_session_t * s, u8 is_fail)
337 echo_client_main_t *ecm = &echo_client_main;
340 u8 thread_index = vlib_get_thread_index ();
344 clib_warning ("connection %d failed!", api_context);
345 signal_evt_to_cli (-1);
349 ASSERT (s->thread_index == thread_index);
351 if (!ecm->vpp_event_queue[thread_index])
352 ecm->vpp_event_queue[thread_index] =
353 session_manager_get_vpp_event_queue (thread_index);
358 clib_spinlock_lock_if_init (&ecm->sessions_lock);
359 pool_get (ecm->sessions, session);
360 clib_spinlock_unlock_if_init (&ecm->sessions_lock);
362 memset (session, 0, sizeof (*session));
363 session_index = session - ecm->sessions;
364 session->bytes_to_send = ecm->bytes_to_send;
365 session->bytes_to_receive = ecm->no_return ? 0ULL : ecm->bytes_to_send;
366 session->server_rx_fifo = s->server_rx_fifo;
367 session->server_rx_fifo->client_session_index = session_index;
368 session->server_tx_fifo = s->server_tx_fifo;
369 session->server_tx_fifo->client_session_index = session_index;
370 session->vpp_session_handle = session_handle (s);
372 vec_add1 (ecm->connection_index_by_thread[thread_index], session_index);
373 __sync_fetch_and_add (&ecm->ready_connections, 1);
374 if (ecm->ready_connections == ecm->expected_connections)
377 /* Signal the CLI process that the action is starting... */
378 signal_evt_to_cli (1);
385 echo_clients_session_reset_callback (stream_session_t * s)
387 if (s->session_state == SESSION_STATE_READY)
388 clib_warning ("Reset active connection %U", format_stream_session, s, 2);
389 stream_session_cleanup (s);
394 echo_clients_session_create_callback (stream_session_t * s)
400 echo_clients_session_disconnect_callback (stream_session_t * s)
402 echo_client_main_t *ecm = &echo_client_main;
403 vnet_disconnect_args_t _a, *a = &_a;
404 a->handle = session_handle (s);
405 a->app_index = ecm->app_index;
406 vnet_disconnect_session (a);
411 echo_clients_rx_callback (stream_session_t * s)
417 echo_client_add_segment_callback (u32 client_index, const ssvm_private_t * sp)
419 /* New heaps may be added */
424 static session_cb_vft_t echo_clients = {
425 .session_reset_callback = echo_clients_session_reset_callback,
426 .session_connected_callback = echo_clients_session_connected_callback,
427 .session_accept_callback = echo_clients_session_create_callback,
428 .session_disconnect_callback = echo_clients_session_disconnect_callback,
429 .builtin_app_rx_callback = echo_clients_rx_callback,
430 .add_segment_callback = echo_client_add_segment_callback
434 static clib_error_t *
435 echo_clients_attach (u8 * appns_id, u64 appns_flags, u64 appns_secret)
437 u32 prealloc_fifos, segment_size = 256 << 20;
438 echo_client_main_t *ecm = &echo_client_main;
439 vnet_app_attach_args_t _a, *a = &_a;
441 clib_error_t *error = 0;
443 memset (a, 0, sizeof (*a));
444 memset (options, 0, sizeof (options));
446 a->api_client_index = ecm->my_client_index;
447 a->session_cb_vft = &echo_clients;
449 prealloc_fifos = ecm->prealloc_fifos ? ecm->expected_connections : 1;
451 if (ecm->private_segment_size)
452 segment_size = ecm->private_segment_size;
454 options[APP_OPTIONS_ACCEPT_COOKIE] = 0x12345678;
455 options[APP_OPTIONS_SEGMENT_SIZE] = segment_size;
456 options[APP_OPTIONS_ADD_SEGMENT_SIZE] = segment_size;
457 options[APP_OPTIONS_RX_FIFO_SIZE] = ecm->fifo_size;
458 options[APP_OPTIONS_TX_FIFO_SIZE] = ecm->fifo_size;
459 options[APP_OPTIONS_PRIVATE_SEGMENT_COUNT] = ecm->private_segment_count;
460 options[APP_OPTIONS_PREALLOC_FIFO_PAIRS] = prealloc_fifos;
462 options[APP_OPTIONS_FLAGS] = APP_OPTIONS_FLAGS_IS_BUILTIN;
465 options[APP_OPTIONS_FLAGS] |= appns_flags;
466 options[APP_OPTIONS_NAMESPACE_SECRET] = appns_secret;
468 a->options = options;
469 a->namespace_id = appns_id;
471 if ((error = vnet_application_attach (a)))
474 ecm->app_index = a->app_index;
479 echo_clients_detach ()
481 echo_client_main_t *ecm = &echo_client_main;
482 vnet_app_detach_args_t _da, *da = &_da;
485 da->app_index = ecm->app_index;
486 rv = vnet_application_detach (da);
487 ecm->test_client_attached = 0;
493 echo_client_thread_fn (void *arg)
498 /** Start a transmit thread */
500 echo_clients_start_tx_pthread (echo_client_main_t * ecm)
502 if (ecm->client_thread_handle == 0)
504 int rv = pthread_create (&ecm->client_thread_handle,
506 echo_client_thread_fn, 0);
509 ecm->client_thread_handle = 0;
517 echo_clients_connect (vlib_main_t * vm, u32 n_clients)
519 echo_client_main_t *ecm = &echo_client_main;
520 vnet_connect_args_t _a, *a = &_a;
521 clib_error_t *error = 0;
524 memset (a, 0, sizeof (*a));
525 for (i = 0; i < n_clients; i++)
527 a->uri = (char *) ecm->connect_uri;
529 a->app_index = ecm->app_index;
531 if ((error = vnet_connect_uri (a)))
534 /* Crude pacing for call setups */
536 vlib_process_suspend (vm, 10e-6);
537 ASSERT (i + 1 >= ecm->ready_connections);
538 while (i + 1 - ecm->ready_connections > 1000)
540 vlib_process_suspend (vm, 100e-6);
546 #define ec_cli_output(_fmt, _args...) \
547 if (!ecm->no_output) \
548 vlib_cli_output(vm, _fmt, ##_args)
550 static clib_error_t *
551 echo_clients_command_fn (vlib_main_t * vm,
552 unformat_input_t * input, vlib_cli_command_t * cmd)
554 echo_client_main_t *ecm = &echo_client_main;
555 vlib_thread_main_t *thread_main = vlib_get_thread_main ();
556 u64 tmp, total_bytes, appns_flags = 0, appns_secret = 0;
557 f64 test_timeout = 20.0, syn_timeout = 20.0, delta;
558 char *default_uri = "tcp://6.0.1.1/1234";
559 uword *event_data = 0, event_type;
560 f64 time_before_connects;
562 int preallocate_sessions = 0;
564 clib_error_t *error = 0;
568 ecm->bytes_to_send = 8192;
570 ecm->fifo_size = 64 << 10;
571 ecm->connections_per_batch = 1000;
572 ecm->private_segment_count = 0;
573 ecm->private_segment_size = 0;
576 ecm->test_failed = 0;
578 if (thread_main->n_vlib_mains > 1)
579 clib_spinlock_init (&ecm->sessions_lock);
580 vec_free (ecm->connect_uri);
582 while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
584 if (unformat (input, "uri %s", &ecm->connect_uri))
586 else if (unformat (input, "nclients %d", &n_clients))
588 else if (unformat (input, "mbytes %lld", &tmp))
589 ecm->bytes_to_send = tmp << 20;
590 else if (unformat (input, "gbytes %lld", &tmp))
591 ecm->bytes_to_send = tmp << 30;
592 else if (unformat (input, "bytes %lld", &ecm->bytes_to_send))
594 else if (unformat (input, "test-timeout %f", &test_timeout))
596 else if (unformat (input, "syn-timeout %f", &syn_timeout))
598 else if (unformat (input, "no-return"))
600 else if (unformat (input, "fifo-size %d", &ecm->fifo_size))
601 ecm->fifo_size <<= 10;
602 else if (unformat (input, "private-segment-count %d",
603 &ecm->private_segment_count))
605 else if (unformat (input, "private-segment-size %U",
606 unformat_memory_size, &tmp))
608 if (tmp >= 0x100000000ULL)
609 return clib_error_return
610 (0, "private segment size %lld (%llu) too large", tmp, tmp);
611 ecm->private_segment_size = tmp;
613 else if (unformat (input, "preallocate-fifos"))
614 ecm->prealloc_fifos = 1;
615 else if (unformat (input, "preallocate-sessions"))
616 preallocate_sessions = 1;
618 if (unformat (input, "client-batch %d", &ecm->connections_per_batch))
620 else if (unformat (input, "appns %_%v%_", &appns_id))
622 else if (unformat (input, "all-scope"))
623 appns_flags |= (APP_OPTIONS_FLAGS_USE_GLOBAL_SCOPE
624 | APP_OPTIONS_FLAGS_USE_LOCAL_SCOPE);
625 else if (unformat (input, "local-scope"))
626 appns_flags = APP_OPTIONS_FLAGS_USE_LOCAL_SCOPE;
627 else if (unformat (input, "global-scope"))
628 appns_flags = APP_OPTIONS_FLAGS_USE_GLOBAL_SCOPE;
629 else if (unformat (input, "secret %lu", &appns_secret))
631 else if (unformat (input, "no-output"))
633 else if (unformat (input, "test-bytes"))
636 return clib_error_return (0, "failed: unknown input `%U'",
637 format_unformat_error, input);
640 /* Store cli process node index for signalling */
641 ecm->cli_node_index =
642 vlib_get_current_process (vm)->node_runtime.node_index;
644 if (ecm->is_init == 0)
646 if (echo_clients_init (vm))
647 return clib_error_return (0, "failed init");
651 ecm->ready_connections = 0;
652 ecm->expected_connections = n_clients;
656 if (!ecm->connect_uri)
658 clib_warning ("No uri provided. Using default: %s", default_uri);
659 ecm->connect_uri = format (0, "%s%c", default_uri, 0);
662 #if ECHO_CLIENT_PTHREAD
663 echo_clients_start_tx_pthread ();
666 vlib_worker_thread_barrier_sync (vm);
667 vnet_session_enable_disable (vm, 1 /* turn on session and transports */ );
668 vlib_worker_thread_barrier_release (vm);
670 if (ecm->test_client_attached == 0)
672 if ((error = echo_clients_attach (appns_id, appns_flags, appns_secret)))
675 clib_error_report (error);
680 ecm->test_client_attached = 1;
682 /* Turn on the builtin client input nodes */
683 for (i = 0; i < thread_main->n_vlib_mains; i++)
684 vlib_node_set_state (vlib_mains[i], echo_clients_node.index,
685 VLIB_NODE_STATE_POLLING);
687 if (preallocate_sessions)
689 session_t *sp __attribute__ ((unused));
690 for (i = 0; i < n_clients; i++)
691 pool_get (ecm->sessions, sp);
692 for (i = 0; i < n_clients; i++)
693 pool_put_index (ecm->sessions, i);
696 /* Fire off connect requests */
697 time_before_connects = vlib_time_now (vm);
698 if ((error = echo_clients_connect (vm, n_clients)))
701 /* Park until the sessions come up, or ten seconds elapse... */
702 vlib_process_wait_for_event_or_clock (vm, syn_timeout);
703 event_type = vlib_process_get_events (vm, &event_data);
707 ec_cli_output ("Timeout with only %d sessions active...",
708 ecm->ready_connections);
709 error = clib_error_return (0, "failed: syn timeout with %d sessions",
710 ecm->ready_connections);
714 delta = vlib_time_now (vm) - time_before_connects;
716 ec_cli_output ("%d three-way handshakes in %.2f seconds %.2f/s",
717 n_clients, delta, ((f64) n_clients) / delta);
719 ecm->test_start_time = vlib_time_now (ecm->vlib_main);
720 ec_cli_output ("Test started at %.6f", ecm->test_start_time);
724 ec_cli_output ("unexpected event(1): %d", event_type);
725 error = clib_error_return (0, "failed: unexpected event(1): %d",
730 /* Now wait for the sessions to finish... */
731 vlib_process_wait_for_event_or_clock (vm, test_timeout);
732 event_type = vlib_process_get_events (vm, &event_data);
736 ec_cli_output ("Timeout with %d sessions still active...",
737 ecm->ready_connections);
738 error = clib_error_return (0, "failed: timeout with %d sessions",
739 ecm->ready_connections);
743 ecm->test_end_time = vlib_time_now (vm);
744 ec_cli_output ("Test finished at %.6f", ecm->test_end_time);
748 ec_cli_output ("unexpected event(2): %d", event_type);
749 error = clib_error_return (0, "failed: unexpected event(2): %d",
754 delta = ecm->test_end_time - ecm->test_start_time;
757 total_bytes = (ecm->no_return ? ecm->tx_total : ecm->rx_total);
758 transfer_type = ecm->no_return ? "half-duplex" : "full-duplex";
759 ec_cli_output ("%lld bytes (%lld mbytes, %lld gbytes) in %.2f seconds",
760 total_bytes, total_bytes / (1ULL << 20),
761 total_bytes / (1ULL << 30), delta);
762 ec_cli_output ("%.2f bytes/second %s", ((f64) total_bytes) / (delta),
764 ec_cli_output ("%.4f gbit/second %s",
765 (((f64) total_bytes * 8.0) / delta / 1e9),
770 ec_cli_output ("zero delta-t?");
771 error = clib_error_return (0, "failed: zero delta-t");
775 if (ecm->test_bytes && ecm->test_failed)
776 error = clib_error_return (0, "failed: test bytes");
780 for (i = 0; i < vec_len (ecm->connection_index_by_thread); i++)
782 vec_reset_length (ecm->connection_index_by_thread[i]);
783 vec_reset_length (ecm->connections_this_batch_by_thread[i]);
786 pool_free (ecm->sessions);
788 /* Detach the application, so we can use different fifo sizes next time */
789 if (ecm->test_client_attached)
791 if (echo_clients_detach ())
793 error = clib_error_return (0, "failed: app detach");
794 ec_cli_output ("WARNING: app detach failed...");
798 ec_cli_output ("test failed");
799 vec_free (ecm->connect_uri);
804 VLIB_CLI_COMMAND (echo_clients_command, static) =
806 .path = "test echo clients",
807 .short_help = "test echo clients [nclients %d][[m|g]bytes <bytes>]"
808 "[test-timeout <time>][syn-timeout <time>][no-return][fifo-size <size>]"
809 "[private-segment-count <count>][private-segment-size <bytes>[m|g]]"
810 "[preallocate-fifos][preallocate-sessions][client-batch <batch-size>]"
811 "[uri <tcp://ip/port>][test-bytes][no-output]",
812 .function = echo_clients_command_fn,
818 echo_clients_main_init (vlib_main_t * vm)
820 echo_client_main_t *ecm = &echo_client_main;
825 VLIB_INIT_FUNCTION (echo_clients_main_init);
828 * fd.io coding-style-patch-verification: ON
831 * eval: (c-set-style "gnu")