src/vnet/session/application.c

   1 /*
   2  * Copyright (c) 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/session/application.h>
  17 #include <vnet/session/application_interface.h>
  18 #include <vnet/session/application_namespace.h>
  19 #include <vnet/session/session.h>
  20
  21 /**
  22  * Pool from which we allocate all applications
  23  */
  24 static application_t *app_pool;
  25
  26 /**
  27  * Hash table of apps by api client index
  28  */
  29 static uword *app_by_api_client_index;
  30
  31 /**
  32  * Default application event queue size
  33  */
  34 static u32 default_app_evt_queue_size = 128;
  35
  36 static u8 *
  37 app_get_name_from_reg_index (application_t * app)
  38 {
  39   u8 *app_name;
  40
  41   vl_api_registration_t *regp;
  42   regp = vl_api_client_index_to_registration (app->api_client_index);
  43   if (!regp)
  44     app_name = format (0, "builtin-%d%c", app->index, 0);
  45   else
  46     app_name = format (0, "%s%c", regp->name, 0);
  47
  48   return app_name;
  49 }
  50
  51 u32
  52 application_session_table (application_t * app, u8 fib_proto)
  53 {
  54   app_namespace_t *app_ns;
  55   app_ns = app_namespace_get (app->ns_index);
  56   if (!application_has_global_scope (app))
  57     return APP_INVALID_INDEX;
  58   if (fib_proto == FIB_PROTOCOL_IP4)
  59     return session_lookup_get_index_for_fib (fib_proto,
  60                                              app_ns->ip4_fib_index);
  61   else
  62     return session_lookup_get_index_for_fib (fib_proto,
  63                                              app_ns->ip6_fib_index);
  64 }
  65
  66 u32
  67 application_local_session_table (application_t * app)
  68 {
  69   app_namespace_t *app_ns;
  70   if (!application_has_local_scope (app))
  71     return APP_INVALID_INDEX;
  72   app_ns = app_namespace_get (app->ns_index);
  73   return app_ns->local_table_index;
  74 }
  75
  76 int
  77 application_api_queue_is_full (application_t * app)
  78 {
  79   unix_shared_memory_queue_t *q;
  80
  81   /* builtin servers are always OK */
  82   if (app->api_client_index == ~0)
  83     return 0;
  84
  85   q = vl_api_client_index_to_input_queue (app->api_client_index);
  86   if (!q)
  87     return 1;
  88
  89   if (q->cursize == q->maxsize)
  90     return 1;
  91   return 0;
  92 }
  93
  94 /**
  95  * Returns app name
  96  *
  97  * Since the name is not stored per app, we generate it on the fly. It is
  98  * the caller's responsibility to free the vector
  99  */
 100 u8 *
 101 application_name_from_index (u32 app_index)
 102 {
 103   application_t *app = application_get (app_index);
 104   if (!app)
 105     return 0;
 106   return app_get_name_from_reg_index (app);
 107 }
 108
 109 static void
 110 application_table_add (application_t * app)
 111 {
 112   hash_set (app_by_api_client_index, app->api_client_index, app->index);
 113 }
 114
 115 static void
 116 application_table_del (application_t * app)
 117 {
 118   hash_unset (app_by_api_client_index, app->api_client_index);
 119 }
 120
 121 application_t *
 122 application_lookup (u32 api_client_index)
 123 {
 124   uword *p;
 125   p = hash_get (app_by_api_client_index, api_client_index);
 126   if (p)
 127     return application_get (p[0]);
 128
 129   return 0;
 130 }
 131
 132 application_t *
 133 application_new ()
 134 {
 135   application_t *app;
 136   pool_get (app_pool, app);
 137   memset (app, 0, sizeof (*app));
 138   app->index = application_get_index (app);
 139   app->connects_seg_manager = APP_INVALID_SEGMENT_MANAGER_INDEX;
 140   app->first_segment_manager = APP_INVALID_SEGMENT_MANAGER_INDEX;
 141   if (CLIB_DEBUG > 1)
 142     clib_warning ("[%d] New app (%d)", getpid (), app->index);
 143   return app;
 144 }
 145
 146 void
 147 application_del (application_t * app)
 148 {
 149   segment_manager_properties_t *props;
 150   vnet_unbind_args_t _a, *a = &_a;
 151   segment_manager_t *sm;
 152   u64 handle, *handles = 0;
 153   u32 index;
 154   int i;
 155
 156   /*
 157    * The app event queue allocated in first segment is cleared with
 158    * the segment manager. No need to explicitly free it.
 159    */
 160   if (CLIB_DEBUG > 1)
 161     clib_warning ("[%d] Delete app (%d)", getpid (), app->index);
 162
 163   if (application_is_proxy (app))
 164     application_remove_proxy (app);
 165
 166   /*
 167    *  Listener cleanup
 168    */
 169
 170   /* *INDENT-OFF* */
 171   hash_foreach (handle, index, app->listeners_table,
 172   ({
 173     vec_add1 (handles, handle);
 174     sm = segment_manager_get (index);
 175     sm->app_index = SEGMENT_MANAGER_INVALID_APP_INDEX;
 176   }));
 177   /* *INDENT-ON* */
 178
 179   for (i = 0; i < vec_len (handles); i++)
 180     {
 181       a->app_index = app->index;
 182       a->handle = handles[i];
 183       /* seg manager is removed when unbind completes */
 184       vnet_unbind (a);
 185     }
 186
 187   /*
 188    * Connects segment manager cleanup
 189    */
 190
 191   if (app->connects_seg_manager != APP_INVALID_SEGMENT_MANAGER_INDEX)
 192     {
 193       sm = segment_manager_get (app->connects_seg_manager);
 194       sm->app_index = SEGMENT_MANAGER_INVALID_APP_INDEX;
 195       segment_manager_init_del (sm);
 196     }
 197
 198   /* If first segment manager is used by a listener */
 199   if (app->first_segment_manager != APP_INVALID_SEGMENT_MANAGER_INDEX
 200       && app->first_segment_manager != app->connects_seg_manager)
 201     {
 202       sm = segment_manager_get (app->first_segment_manager);
 203       /* .. and has no fifos, e.g. it might be used for redirected sessions,
 204        * remove it */
 205       if (!segment_manager_has_fifos (sm))
 206         {
 207           sm->app_index = SEGMENT_MANAGER_INVALID_APP_INDEX;
 208           segment_manager_del (sm);
 209         }
 210     }
 211   props = segment_manager_properties_get (app->sm_properties);
 212   segment_manager_properties_free (props);
 213   application_table_del (app);
 214   pool_put (app_pool, app);
 215 }
 216
 217 static void
 218 application_verify_cb_fns (session_cb_vft_t * cb_fns)
 219 {
 220   if (cb_fns->session_accept_callback == 0)
 221     clib_warning ("No accept callback function provided");
 222   if (cb_fns->session_connected_callback == 0)
 223     clib_warning ("No session connected callback function provided");
 224   if (cb_fns->session_disconnect_callback == 0)
 225     clib_warning ("No session disconnect callback function provided");
 226   if (cb_fns->session_reset_callback == 0)
 227     clib_warning ("No session reset callback function provided");
 228 }
 229
 230 int
 231 application_init (application_t * app, u32 api_client_index, u64 * options,
 232                   session_cb_vft_t * cb_fns)
 233 {
 234   segment_manager_t *sm;
 235   segment_manager_properties_t *props;
 236   u32 app_evt_queue_size, first_seg_size;
 237   u32 default_rx_fifo_size = 16 << 10, default_tx_fifo_size = 16 << 10;
 238   int rv;
 239
 240   app_evt_queue_size = options[APP_EVT_QUEUE_SIZE] > 0 ?
 241     options[APP_EVT_QUEUE_SIZE] : default_app_evt_queue_size;
 242
 243   /*
 244    * Setup segment manager
 245    */
 246   sm = segment_manager_new ();
 247   sm->app_index = app->index;
 248   props = segment_manager_properties_alloc ();
 249   app->sm_properties = segment_manager_properties_index (props);
 250   props->add_segment_size = options[SESSION_OPTIONS_ADD_SEGMENT_SIZE];
 251   props->rx_fifo_size = options[SESSION_OPTIONS_RX_FIFO_SIZE];
 252   props->rx_fifo_size =
 253     props->rx_fifo_size ? props->rx_fifo_size : default_rx_fifo_size;
 254   props->tx_fifo_size = options[SESSION_OPTIONS_TX_FIFO_SIZE];
 255   props->tx_fifo_size =
 256     props->tx_fifo_size ? props->tx_fifo_size : default_tx_fifo_size;
 257   props->add_segment = props->add_segment_size != 0;
 258   props->preallocated_fifo_pairs = options[APP_OPTIONS_PREALLOC_FIFO_PAIRS];
 259   props->use_private_segment = options[APP_OPTIONS_FLAGS]
 260     & APP_OPTIONS_FLAGS_IS_BUILTIN;
 261   props->private_segment_count = options[APP_OPTIONS_PRIVATE_SEGMENT_COUNT];
 262   props->private_segment_size = options[APP_OPTIONS_PRIVATE_SEGMENT_SIZE];
 263
 264   first_seg_size = options[SESSION_OPTIONS_SEGMENT_SIZE];
 265   if ((rv = segment_manager_init (sm, app->sm_properties, first_seg_size)))
 266     return rv;
 267   sm->first_is_protected = 1;
 268
 269   /*
 270    * Setup application
 271    */
 272   app->first_segment_manager = segment_manager_index (sm);
 273   app->api_client_index = api_client_index;
 274   app->flags = options[APP_OPTIONS_FLAGS];
 275   app->cb_fns = *cb_fns;
 276   app->ns_index = options[APP_OPTIONS_NAMESPACE];
 277   app->listeners_table = hash_create (0, sizeof (u64));
 278   app->proxied_transports = options[APP_OPTIONS_PROXY_TRANSPORT];
 279
 280   /* If no scope enabled, default to global */
 281   if (!application_has_global_scope (app)
 282       && !application_has_local_scope (app))
 283     app->flags |= APP_OPTIONS_FLAGS_USE_GLOBAL_SCOPE;
 284
 285   /* Allocate app event queue in the first shared-memory segment */
 286   app->event_queue = segment_manager_alloc_queue (sm, app_evt_queue_size);
 287
 288   /* Check that the obvious things are properly set up */
 289   application_verify_cb_fns (cb_fns);
 290
 291   /* Add app to lookup by api_client_index table */
 292   application_table_add (app);
 293
 294   return 0;
 295 }
 296
 297 application_t *
 298 application_get (u32 index)
 299 {
 300   if (index == APP_INVALID_INDEX)
 301     return 0;
 302   return pool_elt_at_index (app_pool, index);
 303 }
 304
 305 application_t *
 306 application_get_if_valid (u32 index)
 307 {
 308   if (pool_is_free_index (app_pool, index))
 309     return 0;
 310
 311   return pool_elt_at_index (app_pool, index);
 312 }
 313
 314 u32
 315 application_get_index (application_t * app)
 316 {
 317   return app - app_pool;
 318 }
 319
 320 static segment_manager_t *
 321 application_alloc_segment_manager (application_t * app)
 322 {
 323   segment_manager_t *sm = 0;
 324
 325   /* If the first segment manager is not in use, don't allocate a new one */
 326   if (app->first_segment_manager != APP_INVALID_SEGMENT_MANAGER_INDEX
 327       && app->first_segment_manager_in_use == 0)
 328     {
 329       sm = segment_manager_get (app->first_segment_manager);
 330       app->first_segment_manager_in_use = 1;
 331       return sm;
 332     }
 333
 334   sm = segment_manager_new ();
 335   sm->properties_index = app->sm_properties;
 336
 337   return sm;
 338 }
 339
 340 /**
 341  * Start listening local transport endpoint for requested transport.
 342  *
 343  * Creates a 'dummy' stream session with state LISTENING to be used in session
 344  * lookups, prior to establishing connection. Requests transport to build
 345  * it's own specific listening connection.
 346  */
 347 int
 348 application_start_listen (application_t * srv, session_endpoint_t * sep,
 349                           u64 * res)
 350 {
 351   segment_manager_t *sm;
 352   stream_session_t *s;
 353   u64 handle;
 354   session_type_t sst;
 355
 356   sst = session_type_from_proto_and_ip (sep->transport_proto, sep->is_ip4);
 357   s = listen_session_new (sst);
 358   s->app_index = srv->index;
 359
 360   if (stream_session_listen (s, sep))
 361     goto err;
 362
 363   /* Allocate segment manager. All sessions derived out of a listen session
 364    * have fifos allocated by the same segment manager. */
 365   sm = application_alloc_segment_manager (srv);
 366   if (sm == 0)
 367     goto err;
 368
 369   /* Add to app's listener table. Useful to find all child listeners
 370    * when app goes down, although, just for unbinding this is not needed */
 371   handle = listen_session_get_handle (s);
 372   hash_set (srv->listeners_table, handle, segment_manager_index (sm));
 373
 374   *res = handle;
 375   return 0;
 376
 377 err:
 378   listen_session_del (s);
 379   return -1;
 380 }
 381
 382 /**
 383  * Stop listening on session associated to handle
 384  */
 385 int
 386 application_stop_listen (application_t * srv, u64 handle)
 387 {
 388   stream_session_t *listener;
 389   uword *indexp;
 390   segment_manager_t *sm;
 391
 392   if (srv && hash_get (srv->listeners_table, handle) == 0)
 393     {
 394       clib_warning ("app doesn't own handle %llu!", handle);
 395       return -1;
 396     }
 397
 398   listener = listen_session_get_from_handle (handle);
 399   stream_session_stop_listen (listener);
 400
 401   indexp = hash_get (srv->listeners_table, handle);
 402   ASSERT (indexp);
 403
 404   sm = segment_manager_get (*indexp);
 405   if (srv->first_segment_manager == *indexp)
 406     {
 407       /* Delete sessions but don't remove segment manager */
 408       srv->first_segment_manager_in_use = 0;
 409       segment_manager_del_sessions (sm);
 410     }
 411   else
 412     {
 413       segment_manager_init_del (sm);
 414     }
 415   hash_unset (srv->listeners_table, handle);
 416   listen_session_del (listener);
 417
 418   return 0;
 419 }
 420
 421 int
 422 application_open_session (application_t * app, session_endpoint_t * sep,
 423                           u32 api_context)
 424 {
 425   segment_manager_t *sm;
 426   int rv;
 427
 428   /* Make sure we have a segment manager for connects */
 429   if (app->connects_seg_manager == APP_INVALID_SEGMENT_MANAGER_INDEX)
 430     {
 431       sm = application_alloc_segment_manager (app);
 432       if (sm == 0)
 433         return -1;
 434       app->connects_seg_manager = segment_manager_index (sm);
 435     }
 436
 437   if ((rv = session_open (app->index, sep, api_context)))
 438     return rv;
 439
 440   return 0;
 441 }
 442
 443 segment_manager_t *
 444 application_get_connect_segment_manager (application_t * app)
 445 {
 446   ASSERT (app->connects_seg_manager != (u32) ~ 0);
 447   return segment_manager_get (app->connects_seg_manager);
 448 }
 449
 450 segment_manager_t *
 451 application_get_listen_segment_manager (application_t * app,
 452                                         stream_session_t * s)
 453 {
 454   uword *smp;
 455   smp = hash_get (app->listeners_table, listen_session_get_handle (s));
 456   ASSERT (smp != 0);
 457   return segment_manager_get (*smp);
 458 }
 459
 460 int
 461 application_is_proxy (application_t * app)
 462 {
 463   return (app->flags & APP_OPTIONS_FLAGS_IS_PROXY);
 464 }
 465
 466 int
 467 application_is_builtin (application_t * app)
 468 {
 469   return (app->flags & APP_OPTIONS_FLAGS_IS_BUILTIN);
 470 }
 471
 472 int
 473 application_is_builtin_proxy (application_t * app)
 474 {
 475   return (application_is_proxy (app) && application_is_builtin (app));
 476 }
 477
 478 int
 479 application_add_segment_notify (u32 app_index, u32 fifo_segment_index)
 480 {
 481   application_t *app = application_get (app_index);
 482   u32 seg_size = 0;
 483   u8 *seg_name;
 484
 485   /* Send an API message to the external app, to map new segment */
 486   ASSERT (app->cb_fns.add_segment_callback);
 487
 488   segment_manager_get_segment_info (fifo_segment_index, &seg_name, &seg_size);
 489   return app->cb_fns.add_segment_callback (app->api_client_index, seg_name,
 490                                            seg_size);
 491 }
 492
 493 u8
 494 application_has_local_scope (application_t * app)
 495 {
 496   return app->flags & APP_OPTIONS_FLAGS_USE_LOCAL_SCOPE;
 497 }
 498
 499 u8
 500 application_has_global_scope (application_t * app)
 501 {
 502   return app->flags & APP_OPTIONS_FLAGS_USE_GLOBAL_SCOPE;
 503 }
 504
 505 u32
 506 application_n_listeners (application_t * app)
 507 {
 508   return hash_elts (app->listeners_table);
 509 }
 510
 511 stream_session_t *
 512 application_first_listener (application_t * app, u8 fib_proto,
 513                             u8 transport_proto)
 514 {
 515   stream_session_t *listener;
 516   u64 handle;
 517   u32 sm_index;
 518   u8 sst;
 519
 520   sst = session_type_from_proto_and_ip (transport_proto,
 521                                         fib_proto == FIB_PROTOCOL_IP4);
 522
 523   /* *INDENT-OFF* */
 524    hash_foreach (handle, sm_index, app->listeners_table, ({
 525      listener = listen_session_get_from_handle (handle);
 526      if (listener->session_type == sst
 527          && listener->listener_index != SESSION_PROXY_LISTENER_INDEX)
 528        return listener;
 529    }));
 530   /* *INDENT-ON* */
 531
 532   return 0;
 533 }
 534
 535 static clib_error_t *
 536 application_start_stop_proxy_fib_proto (application_t * app, u8 fib_proto,
 537                                         u8 transport_proto, u8 is_start)
 538 {
 539   app_namespace_t *app_ns = app_namespace_get (app->ns_index);
 540   u8 is_ip4 = (fib_proto == FIB_PROTOCOL_IP4);
 541   session_endpoint_t sep = SESSION_ENDPOINT_NULL;
 542   transport_connection_t *tc;
 543   stream_session_t *s;
 544   u64 handle;
 545
 546   if (is_start)
 547     {
 548       sep.is_ip4 = is_ip4;
 549       sep.fib_index = app_namespace_get_fib_index (app_ns, fib_proto);
 550       sep.sw_if_index = app_ns->sw_if_index;
 551       sep.transport_proto = transport_proto;
 552       application_start_listen (app, &sep, &handle);
 553       s = listen_session_get_from_handle (handle);
 554       s->listener_index = SESSION_PROXY_LISTENER_INDEX;
 555     }
 556   else
 557     {
 558       s = application_first_listener (app, fib_proto, transport_proto);
 559     }
 560   tc = listen_session_get_transport (s);
 561
 562   if (!ip_is_zero (&tc->lcl_ip, 1))
 563     {
 564       u32 sti;
 565       sep.is_ip4 = is_ip4;
 566       sep.fib_index = app_namespace_get_fib_index (app_ns, fib_proto);
 567       sep.transport_proto = transport_proto;
 568       sep.port = 0;
 569       sti = session_lookup_get_index_for_fib (fib_proto, sep.fib_index);
 570       session_lookup_add_session_endpoint (sti, &sep, s->session_index);
 571     }
 572   return 0;
 573 }
 574
 575 void
 576 application_start_stop_proxy (application_t * app,
 577                               transport_proto_t transport_proto, u8 is_start)
 578 {
 579   if (application_has_local_scope (app))
 580     {
 581       session_endpoint_t sep = SESSION_ENDPOINT_NULL;
 582       app_namespace_t *app_ns;
 583       app_ns = app_namespace_get (app->ns_index);
 584       sep.is_ip4 = 1;
 585       sep.transport_proto = transport_proto;
 586       sep.port = 0;
 587       session_lookup_add_session_endpoint (app_ns->local_table_index, &sep,
 588                                            app->index);
 589
 590       sep.is_ip4 = 0;
 591       session_lookup_add_session_endpoint (app_ns->local_table_index, &sep,
 592                                            app->index);
 593     }
 594
 595   if (application_has_global_scope (app))
 596     {
 597       application_start_stop_proxy_fib_proto (app, FIB_PROTOCOL_IP4,
 598                                               transport_proto, is_start);
 599       application_start_stop_proxy_fib_proto (app, FIB_PROTOCOL_IP6,
 600                                               transport_proto, is_start);
 601     }
 602 }
 603
 604 void
 605 application_setup_proxy (application_t * app)
 606 {
 607   u16 transports = app->proxied_transports;
 608   transport_proto_t tp;
 609
 610   ASSERT (application_is_proxy (app));
 611   if (application_is_builtin (app))
 612     return;
 613
 614   /* *INDENT-OFF* */
 615   transport_proto_foreach (tp, ({
 616     if (transports & (1 << tp))
 617       application_start_stop_proxy (app, tp, 1);
 618   }));
 619   /* *INDENT-ON* */
 620 }
 621
 622 void
 623 application_remove_proxy (application_t * app)
 624 {
 625   u16 transports = app->proxied_transports;
 626   transport_proto_t tp;
 627
 628   ASSERT (application_is_proxy (app));
 629
 630   /* *INDENT-OFF* */
 631   transport_proto_foreach (tp, ({
 632     if (transports & (1 << tp))
 633       application_start_stop_proxy (app, tp, 0);
 634   }));
 635   /* *INDENT-ON* */
 636 }
 637
 638 u8 *
 639 format_application_listener (u8 * s, va_list * args)
 640 {
 641   application_t *app = va_arg (*args, application_t *);
 642   u64 handle = va_arg (*args, u64);
 643   u32 index = va_arg (*args, u32);
 644   int verbose = va_arg (*args, int);
 645   stream_session_t *listener;
 646   u8 *app_name, *str;
 647
 648   if (app == 0)
 649     {
 650       if (verbose)
 651         s = format (s, "%-40s%-20s%-15s%-15s%-10s", "Connection", "App",
 652                     "API Client", "ListenerID", "SegManager");
 653       else
 654         s = format (s, "%-40s%-20s", "Connection", "App");
 655
 656       return s;
 657     }
 658
 659   app_name = app_get_name_from_reg_index (app);
 660   listener = listen_session_get_from_handle (handle);
 661   str = format (0, "%U", format_stream_session, listener, verbose);
 662
 663   if (verbose)
 664     {
 665       s = format (s, "%-40s%-20s%-15u%-15u%-10u", str, app_name,
 666                   app->api_client_index, handle, index);
 667     }
 668   else
 669     s = format (s, "%-40s%-20s", str, app_name);
 670
 671   vec_free (app_name);
 672   return s;
 673 }
 674
 675 void
 676 application_format_connects (application_t * app, int verbose)
 677 {
 678   vlib_main_t *vm = vlib_get_main ();
 679   segment_manager_t *sm;
 680   u8 *app_name, *s = 0;
 681   int j;
 682
 683   /* Header */
 684   if (app == 0)
 685     {
 686       if (verbose)
 687         vlib_cli_output (vm, "%-40s%-20s%-15s%-10s", "Connection", "App",
 688                          "API Client", "SegManager");
 689       else
 690         vlib_cli_output (vm, "%-40s%-20s", "Connection", "App");
 691       return;
 692     }
 693
 694   /* make sure */
 695   if (app->connects_seg_manager == (u32) ~ 0)
 696     return;
 697
 698   app_name = app_get_name_from_reg_index (app);
 699
 700   /* Across all fifo segments */
 701   sm = segment_manager_get (app->connects_seg_manager);
 702   for (j = 0; j < vec_len (sm->segment_indices); j++)
 703     {
 704       svm_fifo_segment_private_t *fifo_segment;
 705       svm_fifo_t *fifo;
 706       u8 *str;
 707
 708       fifo_segment = svm_fifo_segment_get_segment (sm->segment_indices[j]);
 709       fifo = svm_fifo_segment_get_fifo_list (fifo_segment);
 710       while (fifo)
 711         {
 712           u32 session_index, thread_index;
 713           stream_session_t *session;
 714
 715           session_index = fifo->master_session_index;
 716           thread_index = fifo->master_thread_index;
 717
 718           session = session_get (session_index, thread_index);
 719           str = format (0, "%U", format_stream_session, session, verbose);
 720
 721           if (verbose)
 722             s = format (s, "%-40s%-20s%-15u%-10u", str, app_name,
 723                         app->api_client_index, app->connects_seg_manager);
 724           else
 725             s = format (s, "%-40s%-20s", str, app_name);
 726
 727           vlib_cli_output (vm, "%v", s);
 728           vec_reset_length (s);
 729           vec_free (str);
 730
 731           fifo = fifo->next;
 732         }
 733       vec_free (s);
 734     }
 735
 736   vec_free (app_name);
 737 }
 738
 739 u8 *
 740 format_application (u8 * s, va_list * args)
 741 {
 742   application_t *app = va_arg (*args, application_t *);
 743   CLIB_UNUSED (int verbose) = va_arg (*args, int);
 744   segment_manager_properties_t *props;
 745   const u8 *app_ns_name;
 746   u8 *app_name;
 747
 748   if (app == 0)
 749     {
 750       if (verbose)
 751         s = format (s, "%-10s%-20s%-15s%-15s%-15s%-15s%-15s", "Index", "Name",
 752                     "API Client", "Namespace", "Add seg size", "Rx fifo size",
 753                     "Tx fifo size");
 754       else
 755         s =
 756           format (s, "%-10s%-20s%-15s%-40s", "Index", "Name", "API Client",
 757                   "Namespace");
 758       return s;
 759     }
 760
 761   app_name = app_get_name_from_reg_index (app);
 762   app_ns_name = app_namespace_id_from_index (app->ns_index);
 763   props = segment_manager_properties_get (app->sm_properties);
 764   if (verbose)
 765     s =
 766       format (s, "%-10d%-20s%-15d%-15d%-15d%-15d%-15d", app->index, app_name,
 767               app->api_client_index, app->ns_index,
 768               props->add_segment_size,
 769               props->rx_fifo_size, props->tx_fifo_size);
 770   else
 771     s = format (s, "%-10d%-20s%-15d%-40s", app->index, app_name,
 772                 app->api_client_index, app_ns_name);
 773   return s;
 774 }
 775
 776 static clib_error_t *
 777 show_app_command_fn (vlib_main_t * vm, unformat_input_t * input,
 778                      vlib_cli_command_t * cmd)
 779 {
 780   application_t *app;
 781   int do_server = 0;
 782   int do_client = 0;
 783   int verbose = 0;
 784
 785   session_cli_return_if_not_enabled ();
 786
 787   while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
 788     {
 789       if (unformat (input, "server"))
 790         do_server = 1;
 791       else if (unformat (input, "client"))
 792         do_client = 1;
 793       else if (unformat (input, "verbose"))
 794         verbose = 1;
 795       else
 796         break;
 797     }
 798
 799   if (do_server)
 800     {
 801       u64 handle;
 802       u32 index;
 803       if (pool_elts (app_pool))
 804         {
 805           vlib_cli_output (vm, "%U", format_application_listener,
 806                            0 /* header */ , 0, 0,
 807                            verbose);
 808           /* *INDENT-OFF* */
 809           pool_foreach (app, app_pool,
 810           ({
 811             /* App's listener sessions */
 812             if (hash_elts (app->listeners_table) == 0)
 813               continue;
 814             hash_foreach (handle, index, app->listeners_table,
 815             ({
 816               vlib_cli_output (vm, "%U", format_application_listener, app,
 817                                        handle, index, verbose);
 818             }));
 819           }));
 820           /* *INDENT-ON* */
 821         }
 822       else
 823         vlib_cli_output (vm, "No active server bindings");
 824     }
 825
 826   if (do_client)
 827     {
 828       if (pool_elts (app_pool))
 829         {
 830           application_format_connects (0, verbose);
 831
 832           /* *INDENT-OFF* */
 833           pool_foreach (app, app_pool,
 834           ({
 835             if (app->connects_seg_manager == (u32)~0)
 836               continue;
 837             application_format_connects (app, verbose);
 838           }));
 839           /* *INDENT-ON* */
 840         }
 841       else
 842         vlib_cli_output (vm, "No active client bindings");
 843     }
 844
 845   /* Print app related info */
 846   if (!do_server && !do_client)
 847     {
 848       vlib_cli_output (vm, "%U", format_application, 0, verbose);
 849       /* *INDENT-OFF* */
 850       pool_foreach (app, app_pool, ({
 851         vlib_cli_output (vm, "%U", format_application, app, verbose);
 852       }));
 853       /* *INDENT-ON* */
 854     }
 855
 856   return 0;
 857 }
 858
 859 /* *INDENT-OFF* */
 860 VLIB_CLI_COMMAND (show_app_command, static) =
 861 {
 862   .path = "show app",
 863   .short_help = "show app [server|client] [verbose]",
 864   .function = show_app_command_fn,
 865 };
 866 /* *INDENT-ON* */
 867
 868 /*
 869  * fd.io coding-style-patch-verification: ON
 870  *
 871  * Local Variables:
 872  * eval: (c-set-style "gnu")
 873  * End:
 874  */