src/vnet/session/application_worker.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 <vnet/session/application.h>
  17 #include <vnet/session/application_interface.h>
  18 #include <vnet/session/session.h>
  19
  20 /**
  21  * Pool of workers associated to apps
  22  */
  23 static app_worker_t *app_workers;
  24
  25 app_worker_t *
  26 app_worker_alloc (application_t * app)
  27 {
  28   app_worker_t *app_wrk;
  29   pool_get (app_workers, app_wrk);
  30   clib_memset (app_wrk, 0, sizeof (*app_wrk));
  31   app_wrk->wrk_index = app_wrk - app_workers;
  32   app_wrk->app_index = app->app_index;
  33   app_wrk->wrk_map_index = ~0;
  34   app_wrk->connects_seg_manager = APP_INVALID_SEGMENT_MANAGER_INDEX;
  35   app_wrk->first_segment_manager = APP_INVALID_SEGMENT_MANAGER_INDEX;
  36   APP_DBG ("New app %v worker %u", app->name, app_wrk->wrk_index);
  37   return app_wrk;
  38 }
  39
  40 app_worker_t *
  41 app_worker_get (u32 wrk_index)
  42 {
  43   return pool_elt_at_index (app_workers, wrk_index);
  44 }
  45
  46 app_worker_t *
  47 app_worker_get_if_valid (u32 wrk_index)
  48 {
  49   if (pool_is_free_index (app_workers, wrk_index))
  50     return 0;
  51   return pool_elt_at_index (app_workers, wrk_index);
  52 }
  53
  54 void
  55 app_worker_free (app_worker_t * app_wrk)
  56 {
  57   application_t *app = application_get (app_wrk->app_index);
  58   vnet_unlisten_args_t _a, *a = &_a;
  59   u64 handle, *handles = 0;
  60   segment_manager_t *sm;
  61   session_t *ls;
  62   u32 sm_index;
  63   int i;
  64
  65   /*
  66    *  Listener cleanup
  67    */
  68
  69   /* *INDENT-OFF* */
  70   hash_foreach (handle, sm_index, app_wrk->listeners_table, ({
  71     ls = listen_session_get_from_handle (handle);
  72     vec_add1 (handles, app_listen_session_handle (ls));
  73     sm = segment_manager_get (sm_index);
  74     sm->app_wrk_index = SEGMENT_MANAGER_INVALID_APP_INDEX;
  75   }));
  76   /* *INDENT-ON* */
  77
  78   for (i = 0; i < vec_len (handles); i++)
  79     {
  80       a->app_index = app->app_index;
  81       a->wrk_map_index = app_wrk->wrk_map_index;
  82       a->handle = handles[i];
  83       /* seg manager is removed when unbind completes */
  84       (void) vnet_unlisten (a);
  85     }
  86
  87   /*
  88    * Connects segment manager cleanup
  89    */
  90
  91   if (app_wrk->connects_seg_manager != APP_INVALID_SEGMENT_MANAGER_INDEX)
  92     {
  93       sm = segment_manager_get (app_wrk->connects_seg_manager);
  94       sm->app_wrk_index = SEGMENT_MANAGER_INVALID_APP_INDEX;
  95       sm->first_is_protected = 0;
  96       segment_manager_init_free (sm);
  97     }
  98
  99   /* If first segment manager is used by a listener */
 100   if (app_wrk->first_segment_manager != APP_INVALID_SEGMENT_MANAGER_INDEX
 101       && app_wrk->first_segment_manager != app_wrk->connects_seg_manager)
 102     {
 103       sm = segment_manager_get (app_wrk->first_segment_manager);
 104       sm->first_is_protected = 0;
 105       sm->app_wrk_index = SEGMENT_MANAGER_INVALID_APP_INDEX;
 106       /* .. and has no fifos, e.g. it might be used for redirected sessions,
 107        * remove it */
 108       if (!segment_manager_has_fifos (sm))
 109         segment_manager_free (sm);
 110     }
 111
 112   if (CLIB_DEBUG)
 113     clib_memset (app_wrk, 0xfe, sizeof (*app_wrk));
 114   pool_put (app_workers, app_wrk);
 115 }
 116
 117 application_t *
 118 app_worker_get_app (u32 wrk_index)
 119 {
 120   app_worker_t *app_wrk;
 121   app_wrk = app_worker_get_if_valid (wrk_index);
 122   if (!app_wrk)
 123     return 0;
 124   return application_get_if_valid (app_wrk->app_index);
 125 }
 126
 127 static segment_manager_t *
 128 app_worker_alloc_segment_manager (app_worker_t * app_wrk)
 129 {
 130   segment_manager_t *sm = 0;
 131
 132   /* If the first segment manager is not in use, don't allocate a new one */
 133   if (app_wrk->first_segment_manager != APP_INVALID_SEGMENT_MANAGER_INDEX
 134       && app_wrk->first_segment_manager_in_use == 0)
 135     {
 136       sm = segment_manager_get (app_wrk->first_segment_manager);
 137       app_wrk->first_segment_manager_in_use = 1;
 138       return sm;
 139     }
 140
 141   sm = segment_manager_alloc ();
 142   sm->app_wrk_index = app_wrk->wrk_index;
 143
 144   return sm;
 145 }
 146
 147 static int
 148 app_worker_alloc_session_fifos (segment_manager_t * sm, session_t * s)
 149 {
 150   svm_fifo_t *rx_fifo = 0, *tx_fifo = 0;
 151   int rv;
 152
 153   if ((rv = segment_manager_alloc_session_fifos (sm, s->thread_index,
 154                                                  &rx_fifo, &tx_fifo)))
 155     return rv;
 156
 157   rx_fifo->master_session_index = s->session_index;
 158   rx_fifo->master_thread_index = s->thread_index;
 159
 160   tx_fifo->master_session_index = s->session_index;
 161   tx_fifo->master_thread_index = s->thread_index;
 162
 163   s->rx_fifo = rx_fifo;
 164   s->tx_fifo = tx_fifo;
 165   return 0;
 166 }
 167
 168 int
 169 app_worker_init_listener (app_worker_t * app_wrk, session_t * ls)
 170 {
 171   segment_manager_t *sm;
 172
 173   /* Allocate segment manager. All sessions derived out of a listen session
 174    * have fifos allocated by the same segment manager. */
 175   if (!(sm = app_worker_alloc_segment_manager (app_wrk)))
 176     return -1;
 177
 178   /* Keep track of the segment manager for the listener or this worker */
 179   hash_set (app_wrk->listeners_table, listen_session_get_handle (ls),
 180             segment_manager_index (sm));
 181
 182   if (transport_connection_is_cless (session_get_transport (ls)))
 183     {
 184       if (ls->rx_fifo)
 185         {
 186           clib_warning ("sharing of connectionless listeners not supported");
 187           return -1;
 188         }
 189       if (app_worker_alloc_session_fifos (sm, ls))
 190         return -1;
 191     }
 192   return 0;
 193 }
 194
 195 int
 196 app_worker_start_listen (app_worker_t * app_wrk,
 197                          app_listener_t * app_listener)
 198 {
 199   session_t *ls;
 200
 201   if (clib_bitmap_get (app_listener->workers, app_wrk->wrk_map_index))
 202     return VNET_API_ERROR_ADDRESS_IN_USE;
 203
 204   app_listener->workers = clib_bitmap_set (app_listener->workers,
 205                                            app_wrk->wrk_map_index, 1);
 206
 207   if (app_listener->session_index != SESSION_INVALID_INDEX)
 208     {
 209       ls = session_get (app_listener->session_index, 0);
 210       if (app_worker_init_listener (app_wrk, ls))
 211         return -1;
 212     }
 213
 214   if (app_listener->local_index != SESSION_INVALID_INDEX)
 215     {
 216       ls = session_get (app_listener->local_index, 0);
 217       if (app_worker_init_listener (app_wrk, ls))
 218         return -1;
 219     }
 220
 221   return 0;
 222 }
 223
 224 static void
 225 app_worker_stop_listen_session (app_worker_t * app_wrk, session_t * ls)
 226 {
 227   session_handle_t handle;
 228   segment_manager_t *sm;
 229   uword *sm_indexp;
 230
 231   handle = listen_session_get_handle (ls);
 232   sm_indexp = hash_get (app_wrk->listeners_table, handle);
 233   if (PREDICT_FALSE (!sm_indexp))
 234     return;
 235
 236   /* Dealloc fifos first, if any, to avoid cleanup attempt lower */
 237   if (ls->rx_fifo)
 238     {
 239       segment_manager_dealloc_fifos (ls->rx_fifo, ls->tx_fifo);
 240       ls->tx_fifo = ls->rx_fifo = 0;
 241     }
 242
 243   sm = segment_manager_get (*sm_indexp);
 244   if (app_wrk->first_segment_manager == *sm_indexp)
 245     {
 246       /* Delete sessions but don't remove segment manager */
 247       app_wrk->first_segment_manager_in_use = 0;
 248       segment_manager_del_sessions (sm);
 249     }
 250   else
 251     {
 252       segment_manager_init_free (sm);
 253     }
 254   hash_unset (app_wrk->listeners_table, handle);
 255 }
 256
 257 int
 258 app_worker_stop_listen (app_worker_t * app_wrk, app_listener_t * al)
 259 {
 260   session_t *ls;
 261
 262   if (!clib_bitmap_get (al->workers, app_wrk->wrk_map_index))
 263     return 0;
 264
 265   if (al->session_index != SESSION_INVALID_INDEX)
 266     {
 267       ls = listen_session_get (al->session_index);
 268       app_worker_stop_listen_session (app_wrk, ls);
 269     }
 270
 271   if (al->local_index != SESSION_INVALID_INDEX)
 272     {
 273       ls = listen_session_get (al->local_index);
 274       app_worker_stop_listen_session (app_wrk, ls);
 275     }
 276
 277   clib_bitmap_set_no_check (al->workers, app_wrk->wrk_map_index, 0);
 278   if (clib_bitmap_is_zero (al->workers))
 279     app_listener_cleanup (al);
 280
 281   return 0;
 282 }
 283
 284 int
 285 app_worker_init_accepted (session_t * s)
 286 {
 287   app_worker_t *app_wrk;
 288   segment_manager_t *sm;
 289   session_t *listener;
 290   application_t *app;
 291
 292   listener = listen_session_get_from_handle (s->listener_handle);
 293   app_wrk = application_listener_select_worker (listener);
 294   s->app_wrk_index = app_wrk->wrk_index;
 295
 296   app = application_get (app_wrk->app_index);
 297   if (app->cb_fns.fifo_tuning_callback)
 298     s->flags |= SESSION_F_CUSTOM_FIFO_TUNING;
 299
 300   sm = app_worker_get_listen_segment_manager (app_wrk, listener);
 301   if (app_worker_alloc_session_fifos (sm, s))
 302     return -1;
 303
 304   return 0;
 305 }
 306
 307 int
 308 app_worker_accept_notify (app_worker_t * app_wrk, session_t * s)
 309 {
 310   application_t *app = application_get (app_wrk->app_index);
 311   return app->cb_fns.session_accept_callback (s);
 312 }
 313
 314 int
 315 app_worker_init_connected (app_worker_t * app_wrk, session_t * s)
 316 {
 317   application_t *app = application_get (app_wrk->app_index);
 318   segment_manager_t *sm;
 319
 320   /* Allocate fifos for session, unless the app is a builtin proxy */
 321   if (!application_is_builtin_proxy (app))
 322     {
 323       sm = app_worker_get_connect_segment_manager (app_wrk);
 324       if (app_worker_alloc_session_fifos (sm, s))
 325         return -1;
 326     }
 327
 328   if (app->cb_fns.fifo_tuning_callback)
 329     s->flags |= SESSION_F_CUSTOM_FIFO_TUNING;
 330
 331   return 0;
 332 }
 333
 334 int
 335 app_worker_connect_notify (app_worker_t * app_wrk, session_t * s, u32 opaque)
 336 {
 337   application_t *app = application_get (app_wrk->app_index);
 338   return app->cb_fns.session_connected_callback (app_wrk->wrk_index, opaque,
 339                                                  s, s == 0 /* is_fail */ );
 340 }
 341
 342 int
 343 app_worker_close_notify (app_worker_t * app_wrk, session_t * s)
 344 {
 345   application_t *app = application_get (app_wrk->app_index);
 346   app->cb_fns.session_disconnect_callback (s);
 347   return 0;
 348 }
 349
 350 int
 351 app_worker_transport_closed_notify (app_worker_t * app_wrk, session_t * s)
 352 {
 353   application_t *app = application_get (app_wrk->app_index);
 354   if (app->cb_fns.session_transport_closed_callback)
 355     app->cb_fns.session_transport_closed_callback (s);
 356   return 0;
 357 }
 358
 359 int
 360 app_worker_reset_notify (app_worker_t * app_wrk, session_t * s)
 361 {
 362   application_t *app = application_get (app_wrk->app_index);
 363   app->cb_fns.session_reset_callback (s);
 364   return 0;
 365 }
 366
 367 int
 368 app_worker_cleanup_notify (app_worker_t * app_wrk, session_t * s,
 369                            session_cleanup_ntf_t ntf)
 370 {
 371   application_t *app = application_get (app_wrk->app_index);
 372   if (app->cb_fns.session_cleanup_callback)
 373     app->cb_fns.session_cleanup_callback (s, ntf);
 374   return 0;
 375 }
 376
 377 int
 378 app_worker_builtin_rx (app_worker_t * app_wrk, session_t * s)
 379 {
 380   application_t *app = application_get (app_wrk->app_index);
 381   app->cb_fns.builtin_app_rx_callback (s);
 382   return 0;
 383 }
 384
 385 int
 386 app_worker_builtin_tx (app_worker_t * app_wrk, session_t * s)
 387 {
 388   application_t *app = application_get (app_wrk->app_index);
 389
 390   if (!app->cb_fns.builtin_app_tx_callback)
 391     return 0;
 392
 393   app->cb_fns.builtin_app_tx_callback (s);
 394   return 0;
 395 }
 396
 397 int
 398 app_worker_migrate_notify (app_worker_t * app_wrk, session_t * s,
 399                            session_handle_t new_sh)
 400 {
 401   application_t *app = application_get (app_wrk->app_index);
 402   app->cb_fns.session_migrate_callback (s, new_sh);
 403   return 0;
 404 }
 405
 406 int
 407 app_worker_own_session (app_worker_t * app_wrk, session_t * s)
 408 {
 409   segment_manager_t *sm;
 410   svm_fifo_t *rxf, *txf;
 411
 412   if (s->session_state == SESSION_STATE_LISTENING)
 413     return application_change_listener_owner (s, app_wrk);
 414
 415   s->app_wrk_index = app_wrk->wrk_index;
 416
 417   rxf = s->rx_fifo;
 418   txf = s->tx_fifo;
 419
 420   if (!rxf || !txf)
 421     return 0;
 422
 423   s->rx_fifo = 0;
 424   s->tx_fifo = 0;
 425
 426   sm = app_worker_get_or_alloc_connect_segment_manager (app_wrk);
 427   if (app_worker_alloc_session_fifos (sm, s))
 428     return -1;
 429
 430   if (!svm_fifo_is_empty_cons (rxf))
 431     svm_fifo_clone (s->rx_fifo, rxf);
 432
 433   if (!svm_fifo_is_empty_cons (txf))
 434     svm_fifo_clone (s->tx_fifo, txf);
 435
 436   segment_manager_dealloc_fifos (rxf, txf);
 437
 438   return 0;
 439 }
 440
 441 int
 442 app_worker_connect_session (app_worker_t * app, session_endpoint_t * sep,
 443                             u32 api_context)
 444 {
 445   int rv;
 446
 447   /* Make sure we have a segment manager for connects */
 448   app_worker_alloc_connects_segment_manager (app);
 449
 450   if ((rv = session_open (app->wrk_index, sep, api_context)))
 451     return rv;
 452
 453   return 0;
 454 }
 455
 456 int
 457 app_worker_session_fifo_tuning (app_worker_t * app_wrk, session_t * s,
 458                                 svm_fifo_t * f,
 459                                 session_ft_action_t act, u32 len)
 460 {
 461   application_t *app = application_get (app_wrk->app_index);
 462   return app->cb_fns.fifo_tuning_callback (s, f, act, len);
 463 }
 464
 465 int
 466 app_worker_alloc_connects_segment_manager (app_worker_t * app_wrk)
 467 {
 468   segment_manager_t *sm;
 469
 470   if (app_wrk->connects_seg_manager == APP_INVALID_SEGMENT_MANAGER_INDEX)
 471     {
 472       sm = app_worker_alloc_segment_manager (app_wrk);
 473       if (sm == 0)
 474         return -1;
 475       app_wrk->connects_seg_manager = segment_manager_index (sm);
 476     }
 477   return 0;
 478 }
 479
 480 segment_manager_t *
 481 app_worker_get_connect_segment_manager (app_worker_t * app)
 482 {
 483   ASSERT (app->connects_seg_manager != (u32) ~ 0);
 484   return segment_manager_get (app->connects_seg_manager);
 485 }
 486
 487 segment_manager_t *
 488 app_worker_get_or_alloc_connect_segment_manager (app_worker_t * app_wrk)
 489 {
 490   if (app_wrk->connects_seg_manager == (u32) ~ 0)
 491     app_worker_alloc_connects_segment_manager (app_wrk);
 492   return segment_manager_get (app_wrk->connects_seg_manager);
 493 }
 494
 495 segment_manager_t *
 496 app_worker_get_listen_segment_manager (app_worker_t * app,
 497                                        session_t * listener)
 498 {
 499   uword *smp;
 500   smp = hash_get (app->listeners_table, listen_session_get_handle (listener));
 501   ALWAYS_ASSERT (smp != 0);
 502   return segment_manager_get (*smp);
 503 }
 504
 505 session_t *
 506 app_worker_first_listener (app_worker_t * app_wrk, u8 fib_proto,
 507                            u8 transport_proto)
 508 {
 509   session_t *listener;
 510   u64 handle;
 511   u32 sm_index;
 512   u8 sst;
 513
 514   sst = session_type_from_proto_and_ip (transport_proto,
 515                                         fib_proto == FIB_PROTOCOL_IP4);
 516
 517   /* *INDENT-OFF* */
 518    hash_foreach (handle, sm_index, app_wrk->listeners_table, ({
 519      listener = listen_session_get_from_handle (handle);
 520      if (listener->session_type == sst
 521          && !(listener->flags & SESSION_F_PROXY))
 522        return listener;
 523    }));
 524   /* *INDENT-ON* */
 525
 526   return 0;
 527 }
 528
 529 session_t *
 530 app_worker_proxy_listener (app_worker_t * app_wrk, u8 fib_proto,
 531                            u8 transport_proto)
 532 {
 533   session_t *listener;
 534   u64 handle;
 535   u32 sm_index;
 536   u8 sst;
 537
 538   sst = session_type_from_proto_and_ip (transport_proto,
 539                                         fib_proto == FIB_PROTOCOL_IP4);
 540
 541   /* *INDENT-OFF* */
 542    hash_foreach (handle, sm_index, app_wrk->listeners_table, ({
 543      listener = listen_session_get_from_handle (handle);
 544      if (listener->session_type == sst && (listener->flags & SESSION_F_PROXY))
 545        return listener;
 546    }));
 547   /* *INDENT-ON* */
 548
 549   return 0;
 550 }
 551
 552 /**
 553  * Send an API message to the external app, to map new segment
 554  */
 555 int
 556 app_worker_add_segment_notify (app_worker_t * app_wrk, u64 segment_handle)
 557 {
 558   application_t *app = application_get (app_wrk->app_index);
 559
 560   return app->cb_fns.add_segment_callback (app_wrk->wrk_index,
 561                                            segment_handle);
 562 }
 563
 564 int
 565 app_worker_del_segment_notify (app_worker_t * app_wrk, u64 segment_handle)
 566 {
 567   application_t *app = application_get (app_wrk->app_index);
 568   return app->cb_fns.del_segment_callback (app_wrk->wrk_index,
 569                                            segment_handle);
 570 }
 571
 572 static inline u8
 573 app_worker_application_is_builtin (app_worker_t * app_wrk)
 574 {
 575   return app_wrk->app_is_builtin;
 576 }
 577
 578 static inline int
 579 app_send_io_evt_rx (app_worker_t * app_wrk, session_t * s)
 580 {
 581   session_event_t *evt;
 582   svm_msg_q_msg_t msg;
 583   svm_msg_q_t *mq;
 584
 585   if (app_worker_application_is_builtin (app_wrk))
 586     return app_worker_builtin_rx (app_wrk, s);
 587
 588   if (svm_fifo_has_event (s->rx_fifo))
 589     return 0;
 590
 591   mq = app_wrk->event_queue;
 592   svm_msg_q_lock (mq);
 593
 594   if (PREDICT_FALSE (svm_msg_q_is_full (mq)))
 595     {
 596       clib_warning ("evt q full");
 597       svm_msg_q_unlock (mq);
 598       return -1;
 599     }
 600
 601   if (PREDICT_FALSE (svm_msg_q_ring_is_full (mq, SESSION_MQ_IO_EVT_RING)))
 602     {
 603       clib_warning ("evt q rings full");
 604       svm_msg_q_unlock (mq);
 605       return -1;
 606     }
 607
 608   msg = svm_msg_q_alloc_msg_w_ring (mq, SESSION_MQ_IO_EVT_RING);
 609   evt = (session_event_t *) svm_msg_q_msg_data (mq, &msg);
 610   evt->session_index = s->rx_fifo->client_session_index;
 611   evt->event_type = SESSION_IO_EVT_RX;
 612
 613   (void) svm_fifo_set_event (s->rx_fifo);
 614   svm_msg_q_add_and_unlock (mq, &msg);
 615
 616   return 0;
 617 }
 618
 619 static inline int
 620 app_send_io_evt_tx (app_worker_t * app_wrk, session_t * s)
 621 {
 622   svm_msg_q_t *mq;
 623   session_event_t *evt;
 624   svm_msg_q_msg_t msg;
 625
 626   if (app_worker_application_is_builtin (app_wrk))
 627     return app_worker_builtin_tx (app_wrk, s);
 628
 629   mq = app_wrk->event_queue;
 630   svm_msg_q_lock (mq);
 631
 632   if (PREDICT_FALSE (svm_msg_q_is_full (mq)))
 633     {
 634       clib_warning ("evt q full");
 635       svm_msg_q_unlock (mq);
 636       return -1;
 637     }
 638
 639   if (PREDICT_FALSE (svm_msg_q_ring_is_full (mq, SESSION_MQ_IO_EVT_RING)))
 640     {
 641       clib_warning ("evt q rings full");
 642       svm_msg_q_unlock (mq);
 643       return -1;
 644     }
 645
 646   msg = svm_msg_q_alloc_msg_w_ring (mq, SESSION_MQ_IO_EVT_RING);
 647   evt = (session_event_t *) svm_msg_q_msg_data (mq, &msg);
 648   evt->event_type = SESSION_IO_EVT_TX;
 649   evt->session_index = s->tx_fifo->client_session_index;
 650
 651   svm_msg_q_add_and_unlock (mq, &msg);
 652   return 0;
 653 }
 654
 655 /* *INDENT-OFF* */
 656 typedef int (app_send_evt_handler_fn) (app_worker_t *app,
 657                                        session_t *s);
 658 static app_send_evt_handler_fn * const app_send_evt_handler_fns[2] = {
 659     app_send_io_evt_rx,
 660     app_send_io_evt_tx,
 661 };
 662 /* *INDENT-ON* */
 663
 664 /**
 665  * Send event to application
 666  *
 667  * Logic from queue perspective is blocking. However, if queue is full,
 668  * we return.
 669  */
 670 int
 671 app_worker_lock_and_send_event (app_worker_t * app, session_t * s,
 672                                 u8 evt_type)
 673 {
 674   return app_send_evt_handler_fns[evt_type] (app, s);
 675 }
 676
 677 u8 *
 678 format_app_worker_listener (u8 * s, va_list * args)
 679 {
 680   app_worker_t *app_wrk = va_arg (*args, app_worker_t *);
 681   u64 handle = va_arg (*args, u64);
 682   u32 sm_index = va_arg (*args, u32);
 683   int verbose = va_arg (*args, int);
 684   session_t *listener;
 685   const u8 *app_name;
 686   u8 *str;
 687
 688   if (!app_wrk)
 689     {
 690       if (verbose)
 691         s = format (s, "%-40s%-25s%=10s%-15s%-15s%-10s", "Connection", "App",
 692                     "Wrk", "API Client", "ListenerID", "SegManager");
 693       else
 694         s = format (s, "%-40s%-25s%=10s", "Connection", "App", "Wrk");
 695
 696       return s;
 697     }
 698
 699   app_name = application_name_from_index (app_wrk->app_index);
 700   listener = listen_session_get_from_handle (handle);
 701   str = format (0, "%U", format_session, listener, verbose);
 702
 703   if (verbose)
 704     {
 705       char buf[32];
 706       sprintf (buf, "%u(%u)", app_wrk->wrk_map_index, app_wrk->wrk_index);
 707       s = format (s, "%-40s%-25s%=10s%-15u%-15u%-10u", str, app_name,
 708                   buf, app_wrk->api_client_index, handle, sm_index);
 709     }
 710   else
 711     s = format (s, "%-40s%-25s%=10u", str, app_name, app_wrk->wrk_map_index);
 712
 713   return s;
 714 }
 715
 716 u8 *
 717 format_app_worker (u8 * s, va_list * args)
 718 {
 719   app_worker_t *app_wrk = va_arg (*args, app_worker_t *);
 720   u32 indent = 1;
 721
 722   s = format (s, "%U wrk-index %u app-index %u map-index %u "
 723               "api-client-index %d\n", format_white_space, indent,
 724               app_wrk->wrk_index, app_wrk->app_index, app_wrk->wrk_map_index,
 725               app_wrk->api_client_index);
 726   return s;
 727 }
 728
 729 void
 730 app_worker_format_connects (app_worker_t * app_wrk, int verbose)
 731 {
 732   segment_manager_t *sm;
 733
 734   /* Header */
 735   if (!app_wrk)
 736     {
 737       segment_manager_format_sessions (0, verbose);
 738       return;
 739     }
 740
 741   if (app_wrk->connects_seg_manager == (u32) ~ 0)
 742     return;
 743
 744   sm = segment_manager_get (app_wrk->connects_seg_manager);
 745   segment_manager_format_sessions (sm, verbose);
 746 }
 747
 748 /*
 749  * fd.io coding-style-patch-verification: ON
 750  *
 751  * Local Variables:
 752  * eval: (c-set-style "gnu")
 753  * End:
 754  */