src/vlib/threads.c

   1 /*
   2  * Copyright (c) 2015 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 #define _GNU_SOURCE
  16
  17 #include <signal.h>
  18 #include <math.h>
  19 #include <vppinfra/format.h>
  20 #include <vppinfra/time_range.h>
  21 #include <vppinfra/interrupt.h>
  22 #include <vppinfra/linux/sysfs.h>
  23 #include <vlib/vlib.h>
  24
  25 #include <vlib/threads.h>
  26
  27 #include <vlib/stats/stats.h>
  28
  29 u32
  30 vl (void *p)
  31 {
  32   return vec_len (p);
  33 }
  34
  35 vlib_worker_thread_t *vlib_worker_threads;
  36 vlib_thread_main_t vlib_thread_main;
  37
  38 /*
  39  * Barrier tracing can be enabled on a normal build to collect information
  40  * on barrier use, including timings and call stacks.  Deliberately not
  41  * keyed off CLIB_DEBUG, because that can add significant overhead which
  42  * imapacts observed timings.
  43  */
  44
  45 static inline void
  46 barrier_trace_sync (f64 t_entry, f64 t_open, f64 t_closed)
  47 {
  48   if (!vlib_worker_threads->barrier_elog_enabled)
  49     return;
  50
  51   ELOG_TYPE_DECLARE (e) = {
  52     .format = "bar-trace-%s-#%d",
  53     .format_args = "T4i4",
  54   };
  55
  56   struct
  57   {
  58     u32 caller, count, t_entry, t_open, t_closed;
  59   } *ed = 0;
  60
  61   ed = ELOG_DATA (&vlib_global_main.elog_main, e);
  62   ed->count = (int) vlib_worker_threads[0].barrier_sync_count;
  63   ed->caller = elog_string (&vlib_global_main.elog_main,
  64                             (char *) vlib_worker_threads[0].barrier_caller);
  65   ed->t_entry = (int) (1000000.0 * t_entry);
  66   ed->t_open = (int) (1000000.0 * t_open);
  67   ed->t_closed = (int) (1000000.0 * t_closed);
  68 }
  69
  70 static inline void
  71 barrier_trace_sync_rec (f64 t_entry)
  72 {
  73   if (!vlib_worker_threads->barrier_elog_enabled)
  74     return;
  75
  76   ELOG_TYPE_DECLARE (e) = {
  77     .format = "bar-syncrec-%s-#%d",
  78     .format_args = "T4i4",
  79   };
  80
  81   struct
  82   {
  83     u32 caller, depth;
  84   } *ed = 0;
  85
  86   ed = ELOG_DATA (&vlib_global_main.elog_main, e);
  87   ed->depth = (int) vlib_worker_threads[0].recursion_level - 1;
  88   ed->caller = elog_string (&vlib_global_main.elog_main,
  89                             (char *) vlib_worker_threads[0].barrier_caller);
  90 }
  91
  92 static inline void
  93 barrier_trace_release_rec (f64 t_entry)
  94 {
  95   if (!vlib_worker_threads->barrier_elog_enabled)
  96     return;
  97
  98   ELOG_TYPE_DECLARE (e) = {
  99     .format = "bar-relrrec-#%d",
 100     .format_args = "i4",
 101   };
 102
 103   struct
 104   {
 105     u32 depth;
 106   } *ed = 0;
 107
 108   ed = ELOG_DATA (&vlib_global_main.elog_main, e);
 109   ed->depth = (int) vlib_worker_threads[0].recursion_level;
 110 }
 111
 112 static inline void
 113 barrier_trace_release (f64 t_entry, f64 t_closed_total, f64 t_update_main)
 114 {
 115   if (!vlib_worker_threads->barrier_elog_enabled)
 116     return;
 117
 118   ELOG_TYPE_DECLARE (e) = {
 119     .format = "bar-rel-#%d-e%d-u%d-t%d",
 120     .format_args = "i4i4i4i4",
 121   };
 122
 123   struct
 124   {
 125     u32 count, t_entry, t_update_main, t_closed_total;
 126   } *ed = 0;
 127
 128   ed = ELOG_DATA (&vlib_global_main.elog_main, e);
 129   ed->t_entry = (int) (1000000.0 * t_entry);
 130   ed->t_update_main = (int) (1000000.0 * t_update_main);
 131   ed->t_closed_total = (int) (1000000.0 * t_closed_total);
 132   ed->count = (int) vlib_worker_threads[0].barrier_sync_count;
 133
 134   /* Reset context for next trace */
 135   vlib_worker_threads[0].barrier_context = NULL;
 136 }
 137
 138 uword
 139 os_get_nthreads (void)
 140 {
 141   return vec_len (vlib_thread_stacks);
 142 }
 143
 144 void
 145 vlib_set_thread_name (char *name)
 146 {
 147   int pthread_setname_np (pthread_t __target_thread, const char *__name);
 148   int rv;
 149   pthread_t thread = pthread_self ();
 150
 151   if (thread)
 152     {
 153       rv = pthread_setname_np (thread, name);
 154       if (rv)
 155         clib_warning ("pthread_setname_np returned %d", rv);
 156     }
 157 }
 158
 159 static int
 160 sort_registrations_by_no_clone (void *a0, void *a1)
 161 {
 162   vlib_thread_registration_t **tr0 = a0;
 163   vlib_thread_registration_t **tr1 = a1;
 164
 165   return ((i32) ((*tr0)->no_data_structure_clone)
 166           - ((i32) ((*tr1)->no_data_structure_clone)));
 167 }
 168
 169
 170 /* Called early in the init sequence */
 171
 172 clib_error_t *
 173 vlib_thread_init (vlib_main_t * vm)
 174 {
 175   vlib_thread_main_t *tm = &vlib_thread_main;
 176   vlib_worker_thread_t *w;
 177   vlib_thread_registration_t *tr;
 178   u32 n_vlib_mains = 1;
 179   u32 first_index = 1;
 180   u32 i;
 181   uword *avail_cpu;
 182   u32 stats_num_worker_threads_dir_index;
 183
 184   stats_num_worker_threads_dir_index =
 185     vlib_stats_add_gauge ("/sys/num_worker_threads");
 186   ASSERT (stats_num_worker_threads_dir_index != ~0);
 187
 188   /* get bitmaps of active cpu cores and sockets */
 189   tm->cpu_core_bitmap =
 190     clib_sysfs_list_to_bitmap ("/sys/devices/system/cpu/online");
 191   tm->cpu_socket_bitmap =
 192     clib_sysfs_list_to_bitmap ("/sys/devices/system/node/online");
 193
 194   avail_cpu = clib_bitmap_dup (tm->cpu_core_bitmap);
 195
 196   /* skip cores */
 197   for (i = 0; i < tm->skip_cores; i++)
 198     {
 199       uword c = clib_bitmap_first_set (avail_cpu);
 200       if (c == ~0)
 201         return clib_error_return (0, "no available cpus to skip");
 202
 203       avail_cpu = clib_bitmap_set (avail_cpu, c, 0);
 204     }
 205
 206   /* grab cpu for main thread */
 207   if (tm->main_lcore != ~0)
 208     {
 209       if (clib_bitmap_get (avail_cpu, tm->main_lcore) == 0)
 210         return clib_error_return (0, "cpu %u is not available to be used"
 211                                   " for the main thread", tm->main_lcore);
 212       avail_cpu = clib_bitmap_set (avail_cpu, tm->main_lcore, 0);
 213     }
 214
 215   /* assume that there is socket 0 only if there is no data from sysfs */
 216   if (!tm->cpu_socket_bitmap)
 217     tm->cpu_socket_bitmap = clib_bitmap_set (0, 0, 1);
 218
 219   /* pin main thread to main_lcore  */
 220   if (tm->main_lcore != ~0)
 221     {
 222       cpu_set_t cpuset;
 223       CPU_ZERO (&cpuset);
 224       CPU_SET (tm->main_lcore, &cpuset);
 225       pthread_setaffinity_np (pthread_self (), sizeof (cpu_set_t), &cpuset);
 226     }
 227
 228   /* Set up thread 0 */
 229   vec_validate_aligned (vlib_worker_threads, 0, CLIB_CACHE_LINE_BYTES);
 230   vec_set_len (vlib_worker_threads, 1);
 231   w = vlib_worker_threads;
 232   w->thread_mheap = clib_mem_get_heap ();
 233   w->thread_stack = vlib_thread_stacks[0];
 234   w->cpu_id = tm->main_lcore;
 235   w->lwp = syscall (SYS_gettid);
 236   w->thread_id = pthread_self ();
 237   tm->n_vlib_mains = 1;
 238
 239   vlib_get_thread_core_numa (w, w->cpu_id);
 240
 241   if (tm->sched_policy != ~0)
 242     {
 243       struct sched_param sched_param;
 244       if (!sched_getparam (w->lwp, &sched_param))
 245         {
 246           if (tm->sched_priority != ~0)
 247             sched_param.sched_priority = tm->sched_priority;
 248           sched_setscheduler (w->lwp, tm->sched_policy, &sched_param);
 249         }
 250     }
 251
 252   /* assign threads to cores and set n_vlib_mains */
 253   tr = tm->next;
 254
 255   while (tr)
 256     {
 257       vec_add1 (tm->registrations, tr);
 258       tr = tr->next;
 259     }
 260
 261   vec_sort_with_function (tm->registrations, sort_registrations_by_no_clone);
 262
 263   for (i = 0; i < vec_len (tm->registrations); i++)
 264     {
 265       int j;
 266       tr = tm->registrations[i];
 267       tr->first_index = first_index;
 268       first_index += tr->count;
 269       n_vlib_mains += (tr->no_data_structure_clone == 0) ? tr->count : 0;
 270
 271       /* construct coremask */
 272       if (tr->use_pthreads || !tr->count)
 273         continue;
 274
 275       if (tr->coremask)
 276         {
 277           uword c;
 278           /* *INDENT-OFF* */
 279           clib_bitmap_foreach (c, tr->coremask)  {
 280             if (clib_bitmap_get(avail_cpu, c) == 0)
 281               return clib_error_return (0, "cpu %u is not available to be used"
 282                                         " for the '%s' thread",c, tr->name);
 283
 284             avail_cpu = clib_bitmap_set(avail_cpu, c, 0);
 285           }
 286           /* *INDENT-ON* */
 287         }
 288       else
 289         {
 290           for (j = 0; j < tr->count; j++)
 291             {
 292               /* Do not use CPU 0 by default - leave it to the host and IRQs */
 293               uword avail_c0 = clib_bitmap_get (avail_cpu, 0);
 294               avail_cpu = clib_bitmap_set (avail_cpu, 0, 0);
 295
 296               uword c = clib_bitmap_first_set (avail_cpu);
 297               /* Use CPU 0 as a last resort */
 298               if (c == ~0 && avail_c0)
 299                 {
 300                   c = 0;
 301                   avail_c0 = 0;
 302                 }
 303
 304               if (c == ~0)
 305                 return clib_error_return (0,
 306                                           "no available cpus to be used for"
 307                                           " the '%s' thread", tr->name);
 308
 309               avail_cpu = clib_bitmap_set (avail_cpu, 0, avail_c0);
 310               avail_cpu = clib_bitmap_set (avail_cpu, c, 0);
 311               tr->coremask = clib_bitmap_set (tr->coremask, c, 1);
 312             }
 313         }
 314     }
 315
 316   clib_bitmap_free (avail_cpu);
 317
 318   tm->n_vlib_mains = n_vlib_mains;
 319   vlib_stats_set_gauge (stats_num_worker_threads_dir_index, n_vlib_mains - 1);
 320
 321   /*
 322    * Allocate the remaining worker threads, and thread stack vector slots
 323    * from now on, calls to os_get_nthreads() will return the correct
 324    * answer.
 325    */
 326   vec_validate_aligned (vlib_worker_threads, first_index - 1,
 327                         CLIB_CACHE_LINE_BYTES);
 328   vec_validate (vlib_thread_stacks, vec_len (vlib_worker_threads) - 1);
 329   return 0;
 330 }
 331
 332 vlib_frame_queue_t *
 333 vlib_frame_queue_alloc (int nelts)
 334 {
 335   vlib_frame_queue_t *fq;
 336
 337   fq = clib_mem_alloc_aligned (sizeof (*fq), CLIB_CACHE_LINE_BYTES);
 338   clib_memset (fq, 0, sizeof (*fq));
 339   fq->nelts = nelts;
 340   fq->vector_threshold = 2 * VLIB_FRAME_SIZE;
 341   vec_validate_aligned (fq->elts, nelts - 1, CLIB_CACHE_LINE_BYTES);
 342
 343   if (nelts & (nelts - 1))
 344     {
 345       fformat (stderr, "FATAL: nelts MUST be a power of 2\n");
 346       abort ();
 347     }
 348
 349   return (fq);
 350 }
 351
 352 void vl_msg_api_handler_no_free (void *) __attribute__ ((weak));
 353 void
 354 vl_msg_api_handler_no_free (void *v)
 355 {
 356 }
 357
 358 /* To be called by vlib worker threads upon startup */
 359 void
 360 vlib_worker_thread_init (vlib_worker_thread_t * w)
 361 {
 362   vlib_thread_main_t *tm = vlib_get_thread_main ();
 363
 364   /*
 365    * Note: disabling signals in worker threads as follows
 366    * prevents the api post-mortem dump scheme from working
 367    * {
 368    *    sigset_t s;
 369    *    sigfillset (&s);
 370    *    pthread_sigmask (SIG_SETMASK, &s, 0);
 371    *  }
 372    */
 373
 374   clib_mem_set_heap (w->thread_mheap);
 375
 376   if (vec_len (tm->thread_prefix) && w->registration->short_name)
 377     {
 378       w->name = format (0, "%v_%s_%d%c", tm->thread_prefix,
 379                         w->registration->short_name, w->instance_id, '\0');
 380       vlib_set_thread_name ((char *) w->name);
 381     }
 382
 383   if (!w->registration->use_pthreads)
 384     {
 385
 386       /* Initial barrier sync, for both worker and i/o threads */
 387       clib_atomic_fetch_add (vlib_worker_threads->workers_at_barrier, 1);
 388
 389       while (*vlib_worker_threads->wait_at_barrier)
 390         ;
 391
 392       clib_atomic_fetch_add (vlib_worker_threads->workers_at_barrier, -1);
 393     }
 394 }
 395
 396 void *
 397 vlib_worker_thread_bootstrap_fn (void *arg)
 398 {
 399   vlib_worker_thread_t *w = arg;
 400
 401   w->lwp = syscall (SYS_gettid);
 402   w->thread_id = pthread_self ();
 403
 404   __os_thread_index = w - vlib_worker_threads;
 405
 406   if (CLIB_DEBUG > 0)
 407     {
 408       void *frame_addr = __builtin_frame_address (0);
 409       if (frame_addr < (void *) w->thread_stack ||
 410           frame_addr > (void *) w->thread_stack + VLIB_THREAD_STACK_SIZE)
 411         {
 412           /* heap is not set yet */
 413           fprintf (stderr, "thread stack is not set properly\n");
 414           exit (1);
 415         }
 416     }
 417
 418   w->thread_function (arg);
 419
 420   return 0;
 421 }
 422
 423 void
 424 vlib_get_thread_core_numa (vlib_worker_thread_t * w, unsigned cpu_id)
 425 {
 426   const char *sys_cpu_path = "/sys/devices/system/cpu/cpu";
 427   const char *sys_node_path = "/sys/devices/system/node/node";
 428   clib_bitmap_t *nbmp = 0, *cbmp = 0;
 429   u32 node;
 430   u8 *p = 0;
 431   int core_id = -1, numa_id = -1;
 432
 433   p = format (p, "%s%u/topology/core_id%c", sys_cpu_path, cpu_id, 0);
 434   clib_sysfs_read ((char *) p, "%d", &core_id);
 435   vec_reset_length (p);
 436
 437   /* *INDENT-OFF* */
 438   clib_sysfs_read ("/sys/devices/system/node/online", "%U",
 439         unformat_bitmap_list, &nbmp);
 440   clib_bitmap_foreach (node, nbmp)  {
 441     p = format (p, "%s%u/cpulist%c", sys_node_path, node, 0);
 442     clib_sysfs_read ((char *) p, "%U", unformat_bitmap_list, &cbmp);
 443     if (clib_bitmap_get (cbmp, cpu_id))
 444       numa_id = node;
 445     vec_reset_length (cbmp);
 446     vec_reset_length (p);
 447   }
 448   /* *INDENT-ON* */
 449   vec_free (nbmp);
 450   vec_free (cbmp);
 451   vec_free (p);
 452
 453   w->core_id = core_id;
 454   w->numa_id = numa_id;
 455 }
 456
 457 static clib_error_t *
 458 vlib_launch_thread_int (void *fp, vlib_worker_thread_t * w, unsigned cpu_id)
 459 {
 460   clib_mem_main_t *mm = &clib_mem_main;
 461   vlib_thread_main_t *tm = &vlib_thread_main;
 462   pthread_t worker;
 463   pthread_attr_t attr;
 464   cpu_set_t cpuset;
 465   void *(*fp_arg) (void *) = fp;
 466   void *numa_heap;
 467
 468   w->cpu_id = cpu_id;
 469   vlib_get_thread_core_numa (w, cpu_id);
 470
 471   /* Set up NUMA-bound heap if indicated */
 472   if (mm->per_numa_mheaps[w->numa_id] == 0)
 473     {
 474       /* If the user requested a NUMA heap, create it... */
 475       if (tm->numa_heap_size)
 476         {
 477           clib_mem_set_numa_affinity (w->numa_id, 1 /* force */ );
 478           numa_heap = clib_mem_create_heap (0 /* DIY */ , tm->numa_heap_size,
 479                                             1 /* is_locked */ ,
 480                                             "numa %u heap", w->numa_id);
 481           clib_mem_set_default_numa_affinity ();
 482           mm->per_numa_mheaps[w->numa_id] = numa_heap;
 483         }
 484       else
 485         {
 486           /* Or, use the main heap */
 487           mm->per_numa_mheaps[w->numa_id] = w->thread_mheap;
 488         }
 489     }
 490
 491       CPU_ZERO (&cpuset);
 492       CPU_SET (cpu_id, &cpuset);
 493
 494       if (pthread_attr_init (&attr))
 495         return clib_error_return_unix (0, "pthread_attr_init");
 496
 497       if (pthread_attr_setstack (&attr, w->thread_stack,
 498                                  VLIB_THREAD_STACK_SIZE))
 499         return clib_error_return_unix (0, "pthread_attr_setstack");
 500
 501       if (pthread_create (&worker, &attr, fp_arg, (void *) w))
 502         return clib_error_return_unix (0, "pthread_create");
 503
 504       if (pthread_setaffinity_np (worker, sizeof (cpu_set_t), &cpuset))
 505         return clib_error_return_unix (0, "pthread_setaffinity_np");
 506
 507       if (pthread_attr_destroy (&attr))
 508         return clib_error_return_unix (0, "pthread_attr_destroy");
 509
 510       return 0;
 511 }
 512
 513 static clib_error_t *
 514 start_workers (vlib_main_t * vm)
 515 {
 516   vlib_global_main_t *vgm = vlib_get_global_main ();
 517   vlib_main_t *fvm = vlib_get_first_main ();
 518   int i, j;
 519   vlib_worker_thread_t *w;
 520   vlib_main_t *vm_clone;
 521   void *oldheap;
 522   vlib_thread_main_t *tm = &vlib_thread_main;
 523   vlib_thread_registration_t *tr;
 524   vlib_node_runtime_t *rt;
 525   u32 n_vlib_mains = tm->n_vlib_mains;
 526   u32 worker_thread_index;
 527   u32 stats_err_entry_index = fvm->error_main.stats_err_entry_index;
 528   clib_mem_heap_t *main_heap = clib_mem_get_per_cpu_heap ();
 529   vlib_stats_register_mem_heap (main_heap);
 530
 531   vec_reset_length (vlib_worker_threads);
 532
 533   /* Set up the main thread */
 534   vec_add2_aligned (vlib_worker_threads, w, 1, CLIB_CACHE_LINE_BYTES);
 535   w->elog_track.name = "main thread";
 536   elog_track_register (vlib_get_elog_main (), &w->elog_track);
 537
 538   if (vec_len (tm->thread_prefix))
 539     {
 540       w->name = format (0, "%v_main%c", tm->thread_prefix, '\0');
 541       vlib_set_thread_name ((char *) w->name);
 542     }
 543
 544   vgm->elog_main.lock =
 545     clib_mem_alloc_aligned (CLIB_CACHE_LINE_BYTES, CLIB_CACHE_LINE_BYTES);
 546   vgm->elog_main.lock[0] = 0;
 547
 548   clib_callback_data_init (&vm->vlib_node_runtime_perf_callbacks,
 549                            &vm->worker_thread_main_loop_callback_lock);
 550
 551   vec_validate_aligned (vgm->vlib_mains, n_vlib_mains - 1,
 552                         CLIB_CACHE_LINE_BYTES);
 553   vec_set_len (vgm->vlib_mains, 0);
 554   vec_add1_aligned (vgm->vlib_mains, vm, CLIB_CACHE_LINE_BYTES);
 555
 556   if (n_vlib_mains > 1)
 557     {
 558       vlib_worker_threads->wait_at_barrier =
 559         clib_mem_alloc_aligned (sizeof (u32), CLIB_CACHE_LINE_BYTES);
 560       vlib_worker_threads->workers_at_barrier =
 561         clib_mem_alloc_aligned (sizeof (u32), CLIB_CACHE_LINE_BYTES);
 562
 563       vlib_worker_threads->node_reforks_required =
 564         clib_mem_alloc_aligned (sizeof (u32), CLIB_CACHE_LINE_BYTES);
 565
 566       /* We'll need the rpc vector lock... */
 567       clib_spinlock_init (&vm->pending_rpc_lock);
 568
 569       /* Ask for an initial barrier sync */
 570       *vlib_worker_threads->workers_at_barrier = 0;
 571       *vlib_worker_threads->wait_at_barrier = 1;
 572
 573       /* Without update or refork */
 574       *vlib_worker_threads->node_reforks_required = 0;
 575       vgm->need_vlib_worker_thread_node_runtime_update = 0;
 576
 577       /* init timing */
 578       vm->barrier_epoch = 0;
 579       vm->barrier_no_close_before = 0;
 580
 581       worker_thread_index = 1;
 582       clib_spinlock_init (&vm->worker_thread_main_loop_callback_lock);
 583
 584       for (i = 0; i < vec_len (tm->registrations); i++)
 585         {
 586           vlib_node_main_t *nm, *nm_clone;
 587           int k;
 588
 589           tr = tm->registrations[i];
 590
 591           if (tr->count == 0)
 592             continue;
 593
 594           for (k = 0; k < tr->count; k++)
 595             {
 596               vlib_node_t *n;
 597               u64 **c;
 598
 599               vec_add2 (vlib_worker_threads, w, 1);
 600               /* Currently unused, may not really work */
 601               if (tr->mheap_size)
 602                 w->thread_mheap = clib_mem_create_heap (0, tr->mheap_size,
 603                                                         /* unlocked */ 0,
 604                                                         "%s%d heap",
 605                                                         tr->name, k);
 606               else
 607                 w->thread_mheap = main_heap;
 608
 609               w->thread_stack =
 610                 vlib_thread_stack_init (w - vlib_worker_threads);
 611               w->thread_function = tr->function;
 612               w->thread_function_arg = w;
 613               w->instance_id = k;
 614               w->registration = tr;
 615
 616               w->elog_track.name =
 617                 (char *) format (0, "%s %d", tr->name, k + 1);
 618               vec_add1 (w->elog_track.name, 0);
 619               elog_track_register (vlib_get_elog_main (), &w->elog_track);
 620
 621               if (tr->no_data_structure_clone)
 622                 continue;
 623
 624               /* Fork vlib_global_main et al. Look for bugs here */
 625               oldheap = clib_mem_set_heap (w->thread_mheap);
 626
 627               vm_clone = clib_mem_alloc_aligned (sizeof (*vm_clone),
 628                                                  CLIB_CACHE_LINE_BYTES);
 629               clib_memcpy (vm_clone, vlib_get_first_main (),
 630                            sizeof (*vm_clone));
 631
 632               vm_clone->thread_index = worker_thread_index;
 633               vm_clone->pending_rpc_requests = 0;
 634               vec_validate (vm_clone->pending_rpc_requests, 0);
 635               vec_set_len (vm_clone->pending_rpc_requests, 0);
 636               clib_memset (&vm_clone->random_buffer, 0,
 637                            sizeof (vm_clone->random_buffer));
 638               clib_spinlock_init
 639                 (&vm_clone->worker_thread_main_loop_callback_lock);
 640               clib_callback_data_init
 641                 (&vm_clone->vlib_node_runtime_perf_callbacks,
 642                  &vm_clone->worker_thread_main_loop_callback_lock);
 643
 644               nm = &vlib_get_first_main ()->node_main;
 645               nm_clone = &vm_clone->node_main;
 646               /* fork next frames array, preserving node runtime indices */
 647               nm_clone->next_frames = vec_dup_aligned (nm->next_frames,
 648                                                        CLIB_CACHE_LINE_BYTES);
 649               for (j = 0; j < vec_len (nm_clone->next_frames); j++)
 650                 {
 651                   vlib_next_frame_t *nf = &nm_clone->next_frames[j];
 652                   u32 save_node_runtime_index;
 653                   u32 save_flags;
 654
 655                   save_node_runtime_index = nf->node_runtime_index;
 656                   save_flags = nf->flags & VLIB_FRAME_NO_FREE_AFTER_DISPATCH;
 657                   vlib_next_frame_init (nf);
 658                   nf->node_runtime_index = save_node_runtime_index;
 659                   nf->flags = save_flags;
 660                 }
 661
 662               /* fork the frame dispatch queue */
 663               nm_clone->pending_frames = 0;
 664               vec_validate (nm_clone->pending_frames, 10);
 665               vec_set_len (nm_clone->pending_frames, 0);
 666
 667               /* fork nodes */
 668               nm_clone->nodes = 0;
 669
 670               /* Allocate all nodes in single block for speed */
 671               n = clib_mem_alloc_no_fail (vec_len (nm->nodes) * sizeof (*n));
 672
 673               for (j = 0; j < vec_len (nm->nodes); j++)
 674                 {
 675                   clib_memcpy (n, nm->nodes[j], sizeof (*n));
 676                   /* none of the copied nodes have enqueue rights given out */
 677                   n->owner_node_index = VLIB_INVALID_NODE_INDEX;
 678                   clib_memset (&n->stats_total, 0, sizeof (n->stats_total));
 679                   clib_memset (&n->stats_last_clear, 0,
 680                                sizeof (n->stats_last_clear));
 681                   vec_add1 (nm_clone->nodes, n);
 682                   n++;
 683                 }
 684               nm_clone->nodes_by_type[VLIB_NODE_TYPE_INTERNAL] =
 685                 vec_dup_aligned (nm->nodes_by_type[VLIB_NODE_TYPE_INTERNAL],
 686                                  CLIB_CACHE_LINE_BYTES);
 687               vec_foreach (rt,
 688                            nm_clone->nodes_by_type[VLIB_NODE_TYPE_INTERNAL])
 689               {
 690                 vlib_node_t *n = vlib_get_node (vm, rt->node_index);
 691                 /* copy initial runtime_data from node */
 692                 if (n->runtime_data && n->runtime_data_bytes > 0)
 693                   clib_memcpy (rt->runtime_data, n->runtime_data,
 694                                clib_min (VLIB_NODE_RUNTIME_DATA_SIZE,
 695                                          n->runtime_data_bytes));
 696               }
 697
 698               nm_clone->nodes_by_type[VLIB_NODE_TYPE_INPUT] =
 699                 vec_dup_aligned (nm->nodes_by_type[VLIB_NODE_TYPE_INPUT],
 700                                  CLIB_CACHE_LINE_BYTES);
 701               clib_interrupt_init (
 702                 &nm_clone->input_node_interrupts,
 703                 vec_len (nm_clone->nodes_by_type[VLIB_NODE_TYPE_INPUT]));
 704               clib_interrupt_init (
 705                 &nm_clone->pre_input_node_interrupts,
 706                 vec_len (nm_clone->nodes_by_type[VLIB_NODE_TYPE_PRE_INPUT]));
 707               vec_foreach (rt, nm_clone->nodes_by_type[VLIB_NODE_TYPE_INPUT])
 708               {
 709                 vlib_node_t *n = vlib_get_node (vm, rt->node_index);
 710                 /* copy initial runtime_data from node */
 711                 if (n->runtime_data && n->runtime_data_bytes > 0)
 712                   clib_memcpy (rt->runtime_data, n->runtime_data,
 713                                clib_min (VLIB_NODE_RUNTIME_DATA_SIZE,
 714                                          n->runtime_data_bytes));
 715               }
 716
 717               nm_clone->nodes_by_type[VLIB_NODE_TYPE_PRE_INPUT] =
 718                 vec_dup_aligned (nm->nodes_by_type[VLIB_NODE_TYPE_PRE_INPUT],
 719                                  CLIB_CACHE_LINE_BYTES);
 720               vec_foreach (rt,
 721                            nm_clone->nodes_by_type[VLIB_NODE_TYPE_PRE_INPUT])
 722               {
 723                 vlib_node_t *n = vlib_get_node (vm, rt->node_index);
 724                 /* copy initial runtime_data from node */
 725                 if (n->runtime_data && n->runtime_data_bytes > 0)
 726                   clib_memcpy (rt->runtime_data, n->runtime_data,
 727                                clib_min (VLIB_NODE_RUNTIME_DATA_SIZE,
 728                                          n->runtime_data_bytes));
 729               }
 730
 731               nm_clone->processes = vec_dup_aligned (nm->processes,
 732                                                      CLIB_CACHE_LINE_BYTES);
 733
 734               /* Create per-thread frame freelist */
 735               nm_clone->frame_sizes = 0;
 736               nm_clone->node_by_error = nm->node_by_error;
 737
 738               /* Packet trace buffers are guaranteed to be empty, nothing to do here */
 739
 740               clib_mem_set_heap (oldheap);
 741               vec_add1_aligned (vgm->vlib_mains, vm_clone,
 742                                 CLIB_CACHE_LINE_BYTES);
 743
 744               /* Switch to the stats segment ... */
 745               vlib_stats_validate (stats_err_entry_index, worker_thread_index,
 746                                    vec_len (fvm->error_main.counters) - 1);
 747               c = vlib_stats_get_entry_data_pointer (stats_err_entry_index);
 748               vm_clone->error_main.counters = c[worker_thread_index];
 749
 750               vm_clone->error_main.counters_last_clear = vec_dup_aligned (
 751                 vlib_get_first_main ()->error_main.counters_last_clear,
 752                 CLIB_CACHE_LINE_BYTES);
 753
 754               worker_thread_index++;
 755             }
 756         }
 757     }
 758   else
 759     {
 760       /* only have non-data-structure copy threads to create... */
 761       for (i = 0; i < vec_len (tm->registrations); i++)
 762         {
 763           tr = tm->registrations[i];
 764
 765           for (j = 0; j < tr->count; j++)
 766             {
 767               vec_add2 (vlib_worker_threads, w, 1);
 768               if (tr->mheap_size)
 769                 {
 770                   w->thread_mheap = clib_mem_create_heap (0, tr->mheap_size,
 771                                                           /* locked */ 0,
 772                                                           "%s%d heap",
 773                                                           tr->name, j);
 774                 }
 775               else
 776                 w->thread_mheap = main_heap;
 777               w->thread_stack =
 778                 vlib_thread_stack_init (w - vlib_worker_threads);
 779               w->thread_function = tr->function;
 780               w->thread_function_arg = w;
 781               w->instance_id = j;
 782               w->elog_track.name =
 783                 (char *) format (0, "%s %d", tr->name, j + 1);
 784               w->registration = tr;
 785               vec_add1 (w->elog_track.name, 0);
 786               elog_track_register (vlib_get_elog_main (), &w->elog_track);
 787             }
 788         }
 789     }
 790
 791   worker_thread_index = 1;
 792
 793   for (i = 0; i < vec_len (tm->registrations); i++)
 794     {
 795       clib_error_t *err;
 796       int j;
 797
 798       tr = tm->registrations[i];
 799
 800       if (tr->use_pthreads || tm->use_pthreads)
 801         {
 802           for (j = 0; j < tr->count; j++)
 803             {
 804               w = vlib_worker_threads + worker_thread_index++;
 805               err = vlib_launch_thread_int (vlib_worker_thread_bootstrap_fn,
 806                                             w, 0);
 807               if (err)
 808                 clib_error_report (err);
 809             }
 810         }
 811       else
 812         {
 813           uword c;
 814           /* *INDENT-OFF* */
 815           clib_bitmap_foreach (c, tr->coremask)  {
 816             w = vlib_worker_threads + worker_thread_index++;
 817             err = vlib_launch_thread_int (vlib_worker_thread_bootstrap_fn,
 818                                           w, c);
 819             if (err)
 820               clib_error_report (err);
 821           }
 822           /* *INDENT-ON* */
 823         }
 824     }
 825   vlib_worker_thread_barrier_sync (vm);
 826   {
 827     clib_error_t *err;
 828     err = vlib_call_init_exit_functions (
 829       vm, &vgm->num_workers_change_function_registrations, 1 /* call_once */,
 830       1 /* is_global */);
 831     if (err)
 832       clib_error_report (err);
 833   }
 834   vlib_worker_thread_barrier_release (vm);
 835   return 0;
 836 }
 837
 838 VLIB_MAIN_LOOP_ENTER_FUNCTION (start_workers);
 839
 840
 841 static inline void
 842 worker_thread_node_runtime_update_internal (void)
 843 {
 844   int i, j;
 845   vlib_main_t *vm;
 846   vlib_node_main_t *nm, *nm_clone;
 847   vlib_main_t *vm_clone;
 848   vlib_node_runtime_t *rt;
 849
 850   ASSERT (vlib_get_thread_index () == 0);
 851
 852   vm = vlib_get_first_main ();
 853   nm = &vm->node_main;
 854
 855   ASSERT (*vlib_worker_threads->wait_at_barrier == 1);
 856
 857   /*
 858    * Scrape all runtime stats, so we don't lose node runtime(s) with
 859    * pending counts, or throw away worker / io thread counts.
 860    */
 861   for (j = 0; j < vec_len (nm->nodes); j++)
 862     {
 863       vlib_node_t *n;
 864       n = nm->nodes[j];
 865       vlib_node_sync_stats (vm, n);
 866     }
 867
 868   for (i = 1; i < vlib_get_n_threads (); i++)
 869     {
 870       vlib_node_t *n;
 871
 872       vm_clone = vlib_get_main_by_index (i);
 873       nm_clone = &vm_clone->node_main;
 874
 875       for (j = 0; j < vec_len (nm_clone->nodes); j++)
 876         {
 877           n = nm_clone->nodes[j];
 878
 879           rt = vlib_node_get_runtime (vm_clone, n->index);
 880           vlib_node_runtime_sync_stats (vm_clone, rt, 0, 0, 0);
 881         }
 882     }
 883
 884   /* Per-worker clone rebuilds are now done on each thread */
 885 }
 886
 887
 888 void
 889 vlib_worker_thread_node_refork (void)
 890 {
 891   vlib_main_t *vm, *vm_clone;
 892   vlib_node_main_t *nm, *nm_clone;
 893   vlib_node_t **old_nodes_clone;
 894   vlib_node_runtime_t *rt, *old_rt;
 895   u64 **c;
 896
 897   vlib_node_t *new_n_clone;
 898
 899   int j;
 900
 901   vm = vlib_get_first_main ();
 902   nm = &vm->node_main;
 903   vm_clone = vlib_get_main ();
 904   nm_clone = &vm_clone->node_main;
 905
 906   /* Re-clone error heap */
 907   u64 *old_counters_all_clear = vm_clone->error_main.counters_last_clear;
 908
 909   clib_memcpy_fast (&vm_clone->error_main, &vm->error_main,
 910                     sizeof (vm->error_main));
 911   j = vec_len (vm->error_main.counters) - 1;
 912
 913   c = vlib_stats_get_entry_data_pointer (vm->error_main.stats_err_entry_index);
 914   vm_clone->error_main.counters = c[vm_clone->thread_index];
 915
 916   vec_validate_aligned (old_counters_all_clear, j, CLIB_CACHE_LINE_BYTES);
 917   vm_clone->error_main.counters_last_clear = old_counters_all_clear;
 918
 919   for (j = 0; j < vec_len (nm_clone->next_frames); j++)
 920     {
 921       vlib_next_frame_t *nf = &nm_clone->next_frames[j];
 922       if ((nf->flags & VLIB_FRAME_IS_ALLOCATED) && nf->frame != NULL)
 923         {
 924           vlib_frame_t *f = nf->frame;
 925           nf->frame = NULL;
 926           vlib_frame_free (vm_clone, f);
 927         }
 928     }
 929
 930   vec_free (nm_clone->next_frames);
 931   nm_clone->next_frames = vec_dup_aligned (nm->next_frames,
 932                                            CLIB_CACHE_LINE_BYTES);
 933
 934   for (j = 0; j < vec_len (nm_clone->next_frames); j++)
 935     {
 936       vlib_next_frame_t *nf = &nm_clone->next_frames[j];
 937       u32 save_node_runtime_index;
 938       u32 save_flags;
 939
 940       save_node_runtime_index = nf->node_runtime_index;
 941       save_flags = nf->flags & VLIB_FRAME_NO_FREE_AFTER_DISPATCH;
 942       vlib_next_frame_init (nf);
 943       nf->node_runtime_index = save_node_runtime_index;
 944       nf->flags = save_flags;
 945     }
 946
 947   old_nodes_clone = nm_clone->nodes;
 948   nm_clone->nodes = 0;
 949
 950   /* re-fork nodes */
 951
 952   /* Allocate all nodes in single block for speed */
 953   new_n_clone =
 954     clib_mem_alloc_no_fail (vec_len (nm->nodes) * sizeof (*new_n_clone));
 955   for (j = 0; j < vec_len (nm->nodes); j++)
 956     {
 957       vlib_node_t *new_n = nm->nodes[j];
 958
 959       clib_memcpy_fast (new_n_clone, new_n, sizeof (*new_n));
 960       /* none of the copied nodes have enqueue rights given out */
 961       new_n_clone->owner_node_index = VLIB_INVALID_NODE_INDEX;
 962
 963       if (j >= vec_len (old_nodes_clone))
 964         {
 965           /* new node, set to zero */
 966           clib_memset (&new_n_clone->stats_total, 0,
 967                        sizeof (new_n_clone->stats_total));
 968           clib_memset (&new_n_clone->stats_last_clear, 0,
 969                        sizeof (new_n_clone->stats_last_clear));
 970         }
 971       else
 972         {
 973           vlib_node_t *old_n_clone = old_nodes_clone[j];
 974           /* Copy stats if the old data is valid */
 975           clib_memcpy_fast (&new_n_clone->stats_total,
 976                             &old_n_clone->stats_total,
 977                             sizeof (new_n_clone->stats_total));
 978           clib_memcpy_fast (&new_n_clone->stats_last_clear,
 979                             &old_n_clone->stats_last_clear,
 980                             sizeof (new_n_clone->stats_last_clear));
 981
 982           /* keep previous node state */
 983           new_n_clone->state = old_n_clone->state;
 984           new_n_clone->flags = old_n_clone->flags;
 985         }
 986       vec_add1 (nm_clone->nodes, new_n_clone);
 987       new_n_clone++;
 988     }
 989   /* Free the old node clones */
 990   clib_mem_free (old_nodes_clone[0]);
 991
 992   vec_free (old_nodes_clone);
 993
 994
 995   /* re-clone internal nodes */
 996   old_rt = nm_clone->nodes_by_type[VLIB_NODE_TYPE_INTERNAL];
 997   nm_clone->nodes_by_type[VLIB_NODE_TYPE_INTERNAL] =
 998     vec_dup_aligned (nm->nodes_by_type[VLIB_NODE_TYPE_INTERNAL],
 999                      CLIB_CACHE_LINE_BYTES);
1000
1001   vec_foreach (rt, nm_clone->nodes_by_type[VLIB_NODE_TYPE_INTERNAL])
1002   {
1003     vlib_node_t *n = vlib_get_node (vm, rt->node_index);
1004     /* copy runtime_data, will be overwritten later for existing rt */
1005     if (n->runtime_data && n->runtime_data_bytes > 0)
1006       clib_memcpy_fast (rt->runtime_data, n->runtime_data,
1007                         clib_min (VLIB_NODE_RUNTIME_DATA_SIZE,
1008                                   n->runtime_data_bytes));
1009   }
1010
1011   for (j = 0; j < vec_len (old_rt); j++)
1012     {
1013       rt = vlib_node_get_runtime (vm_clone, old_rt[j].node_index);
1014       rt->state = old_rt[j].state;
1015       rt->flags = old_rt[j].flags;
1016       clib_memcpy_fast (rt->runtime_data, old_rt[j].runtime_data,
1017                         VLIB_NODE_RUNTIME_DATA_SIZE);
1018     }
1019
1020   vec_free (old_rt);
1021
1022   /* re-clone input nodes */
1023   old_rt = nm_clone->nodes_by_type[VLIB_NODE_TYPE_INPUT];
1024   nm_clone->nodes_by_type[VLIB_NODE_TYPE_INPUT] =
1025     vec_dup_aligned (nm->nodes_by_type[VLIB_NODE_TYPE_INPUT],
1026                      CLIB_CACHE_LINE_BYTES);
1027   clib_interrupt_resize (
1028     &nm_clone->input_node_interrupts,
1029     vec_len (nm_clone->nodes_by_type[VLIB_NODE_TYPE_INPUT]));
1030   clib_interrupt_resize (
1031     &nm_clone->pre_input_node_interrupts,
1032     vec_len (nm_clone->nodes_by_type[VLIB_NODE_TYPE_PRE_INPUT]));
1033
1034   vec_foreach (rt, nm_clone->nodes_by_type[VLIB_NODE_TYPE_INPUT])
1035   {
1036     vlib_node_t *n = vlib_get_node (vm, rt->node_index);
1037     /* copy runtime_data, will be overwritten later for existing rt */
1038     if (n->runtime_data && n->runtime_data_bytes > 0)
1039       clib_memcpy_fast (rt->runtime_data, n->runtime_data,
1040                         clib_min (VLIB_NODE_RUNTIME_DATA_SIZE,
1041                                   n->runtime_data_bytes));
1042   }
1043
1044   for (j = 0; j < vec_len (old_rt); j++)
1045     {
1046       rt = vlib_node_get_runtime (vm_clone, old_rt[j].node_index);
1047       rt->state = old_rt[j].state;
1048       rt->flags = old_rt[j].flags;
1049       clib_memcpy_fast (rt->runtime_data, old_rt[j].runtime_data,
1050                         VLIB_NODE_RUNTIME_DATA_SIZE);
1051     }
1052
1053   vec_free (old_rt);
1054
1055   /* re-clone pre-input nodes */
1056   old_rt = nm_clone->nodes_by_type[VLIB_NODE_TYPE_PRE_INPUT];
1057   nm_clone->nodes_by_type[VLIB_NODE_TYPE_PRE_INPUT] =
1058     vec_dup_aligned (nm->nodes_by_type[VLIB_NODE_TYPE_PRE_INPUT],
1059                      CLIB_CACHE_LINE_BYTES);
1060
1061   vec_foreach (rt, nm_clone->nodes_by_type[VLIB_NODE_TYPE_PRE_INPUT])
1062   {
1063     vlib_node_t *n = vlib_get_node (vm, rt->node_index);
1064     /* copy runtime_data, will be overwritten later for existing rt */
1065     if (n->runtime_data && n->runtime_data_bytes > 0)
1066       clib_memcpy_fast (rt->runtime_data, n->runtime_data,
1067                         clib_min (VLIB_NODE_RUNTIME_DATA_SIZE,
1068                                   n->runtime_data_bytes));
1069   }
1070
1071   for (j = 0; j < vec_len (old_rt); j++)
1072     {
1073       rt = vlib_node_get_runtime (vm_clone, old_rt[j].node_index);
1074       rt->state = old_rt[j].state;
1075       rt->flags = old_rt[j].flags;
1076       clib_memcpy_fast (rt->runtime_data, old_rt[j].runtime_data,
1077                         VLIB_NODE_RUNTIME_DATA_SIZE);
1078     }
1079
1080   vec_free (old_rt);
1081
1082   vec_free (nm_clone->processes);
1083   nm_clone->processes = vec_dup_aligned (nm->processes,
1084                                          CLIB_CACHE_LINE_BYTES);
1085   nm_clone->node_by_error = nm->node_by_error;
1086 }
1087
1088 void
1089 vlib_worker_thread_node_runtime_update (void)
1090 {
1091   /*
1092    * Make a note that we need to do a node runtime update
1093    * prior to releasing the barrier.
1094    */
1095   vlib_global_main.need_vlib_worker_thread_node_runtime_update = 1;
1096 }
1097
1098 u32
1099 unformat_sched_policy (unformat_input_t * input, va_list * args)
1100 {
1101   u32 *r = va_arg (*args, u32 *);
1102
1103   if (0);
1104 #define _(v,f,s) else if (unformat (input, s)) *r = SCHED_POLICY_##f;
1105   foreach_sched_policy
1106 #undef _
1107     else
1108     return 0;
1109   return 1;
1110 }
1111
1112 static clib_error_t *
1113 cpu_config (vlib_main_t * vm, unformat_input_t * input)
1114 {
1115   vlib_thread_registration_t *tr;
1116   uword *p;
1117   vlib_thread_main_t *tm = &vlib_thread_main;
1118   u8 *name;
1119   uword *bitmap;
1120   u32 count;
1121
1122   tm->thread_registrations_by_name = hash_create_string (0, sizeof (uword));
1123
1124   tm->n_thread_stacks = 1;      /* account for main thread */
1125   tm->sched_policy = ~0;
1126   tm->sched_priority = ~0;
1127   tm->main_lcore = ~0;
1128
1129   tr = tm->next;
1130
1131   while (tr)
1132     {
1133       hash_set_mem (tm->thread_registrations_by_name, tr->name, (uword) tr);
1134       tr = tr->next;
1135     }
1136
1137   while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
1138     {
1139       if (unformat (input, "use-pthreads"))
1140         tm->use_pthreads = 1;
1141       else if (unformat (input, "thread-prefix %v", &tm->thread_prefix))
1142         ;
1143       else if (unformat (input, "main-core %u", &tm->main_lcore))
1144         ;
1145       else if (unformat (input, "skip-cores %u", &tm->skip_cores))
1146         ;
1147       else if (unformat (input, "numa-heap-size %U",
1148                          unformat_memory_size, &tm->numa_heap_size))
1149         ;
1150       else if (unformat (input, "coremask-%s %U", &name,
1151                          unformat_bitmap_mask, &bitmap) ||
1152                unformat (input, "corelist-%s %U", &name,
1153                          unformat_bitmap_list, &bitmap))
1154         {
1155           p = hash_get_mem (tm->thread_registrations_by_name, name);
1156           if (p == 0)
1157             return clib_error_return (0, "no such thread type '%s'", name);
1158
1159           tr = (vlib_thread_registration_t *) p[0];
1160
1161           if (tr->use_pthreads)
1162             return clib_error_return (0,
1163                                       "corelist cannot be set for '%s' threads",
1164                                       name);
1165           if (tr->count)
1166             return clib_error_return
1167               (0, "core placement of '%s' threads is already configured",
1168                name);
1169
1170           tr->coremask = bitmap;
1171           tr->count = clib_bitmap_count_set_bits (tr->coremask);
1172         }
1173       else
1174         if (unformat
1175             (input, "scheduler-policy %U", unformat_sched_policy,
1176              &tm->sched_policy))
1177         ;
1178       else if (unformat (input, "scheduler-priority %u", &tm->sched_priority))
1179         ;
1180       else if (unformat (input, "%s %u", &name, &count))
1181         {
1182           p = hash_get_mem (tm->thread_registrations_by_name, name);
1183           if (p == 0)
1184             return clib_error_return (0, "no such thread type 3 '%s'", name);
1185
1186           tr = (vlib_thread_registration_t *) p[0];
1187
1188           if (tr->fixed_count)
1189             return clib_error_return
1190               (0, "number of '%s' threads not configurable", name);
1191           if (tr->count)
1192             return clib_error_return
1193               (0, "number of '%s' threads is already configured", name);
1194
1195           tr->count = count;
1196         }
1197       else
1198         break;
1199     }
1200
1201   if (tm->sched_priority != ~0)
1202     {
1203       if (tm->sched_policy == SCHED_FIFO || tm->sched_policy == SCHED_RR)
1204         {
1205           u32 prio_max = sched_get_priority_max (tm->sched_policy);
1206           u32 prio_min = sched_get_priority_min (tm->sched_policy);
1207           if (tm->sched_priority > prio_max)
1208             tm->sched_priority = prio_max;
1209           if (tm->sched_priority < prio_min)
1210             tm->sched_priority = prio_min;
1211         }
1212       else
1213         {
1214           return clib_error_return
1215             (0,
1216              "scheduling priority (%d) is not allowed for `normal` scheduling policy",
1217              tm->sched_priority);
1218         }
1219     }
1220   tr = tm->next;
1221
1222   if (!tm->thread_prefix)
1223     tm->thread_prefix = format (0, "vpp");
1224
1225   while (tr)
1226     {
1227       tm->n_thread_stacks += tr->count;
1228       tm->n_pthreads += tr->count * tr->use_pthreads;
1229       tm->n_threads += tr->count * (tr->use_pthreads == 0);
1230       tr = tr->next;
1231     }
1232
1233   return 0;
1234 }
1235
1236 VLIB_EARLY_CONFIG_FUNCTION (cpu_config, "cpu");
1237
1238   /*
1239    * Enforce minimum open time to minimize packet loss due to Rx overflow,
1240    * based on a test based heuristic that barrier should be open for at least
1241    * 3 time as long as it is closed (with an upper bound of 1ms because by that
1242    *  point it is probably too late to make a difference)
1243    */
1244
1245 #ifndef BARRIER_MINIMUM_OPEN_LIMIT
1246 #define BARRIER_MINIMUM_OPEN_LIMIT 0.001
1247 #endif
1248
1249 #ifndef BARRIER_MINIMUM_OPEN_FACTOR
1250 #define BARRIER_MINIMUM_OPEN_FACTOR 3
1251 #endif
1252
1253 void
1254 vlib_worker_thread_initial_barrier_sync_and_release (vlib_main_t * vm)
1255 {
1256   f64 deadline;
1257   f64 now = vlib_time_now (vm);
1258   u32 count = vlib_get_n_threads () - 1;
1259
1260   /* No worker threads? */
1261   if (count == 0)
1262     return;
1263
1264   deadline = now + BARRIER_SYNC_TIMEOUT;
1265   *vlib_worker_threads->wait_at_barrier = 1;
1266   while (*vlib_worker_threads->workers_at_barrier != count)
1267     {
1268       if ((now = vlib_time_now (vm)) > deadline)
1269         {
1270           fformat (stderr, "%s: worker thread deadlock\n", __FUNCTION__);
1271           os_panic ();
1272         }
1273       CLIB_PAUSE ();
1274     }
1275   *vlib_worker_threads->wait_at_barrier = 0;
1276 }
1277
1278 /**
1279  * Return true if the wroker thread barrier is held
1280  */
1281 u8
1282 vlib_worker_thread_barrier_held (void)
1283 {
1284   if (vlib_get_n_threads () < 2)
1285     return (1);
1286
1287   return (*vlib_worker_threads->wait_at_barrier == 1);
1288 }
1289
1290 void
1291 vlib_worker_thread_barrier_sync_int (vlib_main_t * vm, const char *func_name)
1292 {
1293   f64 deadline;
1294   f64 now;
1295   f64 t_entry;
1296   f64 t_open;
1297   f64 t_closed;
1298   f64 max_vector_rate;
1299   u32 count;
1300   int i;
1301
1302   if (vlib_get_n_threads () < 2)
1303     return;
1304
1305   ASSERT (vlib_get_thread_index () == 0);
1306
1307   vlib_worker_threads[0].barrier_caller = func_name;
1308   count = vlib_get_n_threads () - 1;
1309
1310   /* Record entry relative to last close */
1311   now = vlib_time_now (vm);
1312   t_entry = now - vm->barrier_epoch;
1313
1314   /* Tolerate recursive calls */
1315   if (++vlib_worker_threads[0].recursion_level > 1)
1316     {
1317       barrier_trace_sync_rec (t_entry);
1318       return;
1319     }
1320
1321   if (PREDICT_FALSE (vec_len (vm->barrier_perf_callbacks) != 0))
1322     clib_call_callbacks (vm->barrier_perf_callbacks, vm,
1323                          vm->clib_time.last_cpu_time, 0 /* enter */ );
1324
1325   /*
1326    * Need data to decide if we're working hard enough to honor
1327    * the barrier hold-down timer.
1328    */
1329   max_vector_rate = 0.0;
1330   for (i = 1; i < vlib_get_n_threads (); i++)
1331     {
1332       vlib_main_t *ovm = vlib_get_main_by_index (i);
1333       max_vector_rate = clib_max (max_vector_rate,
1334                                   (f64) vlib_last_vectors_per_main_loop (ovm));
1335     }
1336
1337   vlib_worker_threads[0].barrier_sync_count++;
1338
1339   /* Enforce minimum barrier open time to minimize packet loss */
1340   ASSERT (vm->barrier_no_close_before <= (now + BARRIER_MINIMUM_OPEN_LIMIT));
1341
1342   /*
1343    * If any worker thread seems busy, which we define
1344    * as a vector rate above 10, we enforce the barrier hold-down timer
1345    */
1346   if (max_vector_rate > 10.0)
1347     {
1348       while (1)
1349         {
1350           now = vlib_time_now (vm);
1351           /* Barrier hold-down timer expired? */
1352           if (now >= vm->barrier_no_close_before)
1353             break;
1354           if ((vm->barrier_no_close_before - now)
1355               > (2.0 * BARRIER_MINIMUM_OPEN_LIMIT))
1356             {
1357               clib_warning
1358                 ("clock change: would have waited for %.4f seconds",
1359                  (vm->barrier_no_close_before - now));
1360               break;
1361             }
1362         }
1363     }
1364   /* Record time of closure */
1365   t_open = now - vm->barrier_epoch;
1366   vm->barrier_epoch = now;
1367
1368   deadline = now + BARRIER_SYNC_TIMEOUT;
1369
1370   *vlib_worker_threads->wait_at_barrier = 1;
1371   while (*vlib_worker_threads->workers_at_barrier != count)
1372     {
1373       if ((now = vlib_time_now (vm)) > deadline)
1374         {
1375           fformat (stderr, "%s: worker thread deadlock\n", __FUNCTION__);
1376           os_panic ();
1377         }
1378     }
1379
1380   t_closed = now - vm->barrier_epoch;
1381
1382   barrier_trace_sync (t_entry, t_open, t_closed);
1383
1384 }
1385
1386 void
1387 vlib_worker_thread_barrier_release (vlib_main_t * vm)
1388 {
1389   vlib_global_main_t *vgm = vlib_get_global_main ();
1390   f64 deadline;
1391   f64 now;
1392   f64 minimum_open;
1393   f64 t_entry;
1394   f64 t_closed_total;
1395   f64 t_update_main = 0.0;
1396   int refork_needed = 0;
1397
1398   if (vlib_get_n_threads () < 2)
1399     return;
1400
1401   ASSERT (vlib_get_thread_index () == 0);
1402
1403
1404   now = vlib_time_now (vm);
1405   t_entry = now - vm->barrier_epoch;
1406
1407   if (--vlib_worker_threads[0].recursion_level > 0)
1408     {
1409       barrier_trace_release_rec (t_entry);
1410       return;
1411     }
1412
1413   /* Update (all) node runtimes before releasing the barrier, if needed */
1414   if (vgm->need_vlib_worker_thread_node_runtime_update)
1415     {
1416       /*
1417        * Lock stat segment here, so we's safe when
1418        * rebuilding the stat segment node clones from the
1419        * stat thread...
1420        */
1421       vlib_stats_segment_lock ();
1422
1423       /* Do stats elements on main thread */
1424       worker_thread_node_runtime_update_internal ();
1425       vgm->need_vlib_worker_thread_node_runtime_update = 0;
1426
1427       /* Do per thread rebuilds in parallel */
1428       refork_needed = 1;
1429       clib_atomic_fetch_add (vlib_worker_threads->node_reforks_required,
1430                              (vlib_get_n_threads () - 1));
1431       now = vlib_time_now (vm);
1432       t_update_main = now - vm->barrier_epoch;
1433     }
1434
1435   deadline = now + BARRIER_SYNC_TIMEOUT;
1436
1437   /*
1438    * Note when we let go of the barrier.
1439    * Workers can use this to derive a reasonably accurate
1440    * time offset. See vlib_time_now(...)
1441    */
1442   vm->time_last_barrier_release = vlib_time_now (vm);
1443   CLIB_MEMORY_STORE_BARRIER ();
1444
1445   *vlib_worker_threads->wait_at_barrier = 0;
1446
1447   while (*vlib_worker_threads->workers_at_barrier > 0)
1448     {
1449       if ((now = vlib_time_now (vm)) > deadline)
1450         {
1451           fformat (stderr, "%s: worker thread deadlock\n", __FUNCTION__);
1452           os_panic ();
1453         }
1454     }
1455
1456   /* Wait for reforks before continuing */
1457   if (refork_needed)
1458     {
1459       now = vlib_time_now (vm);
1460
1461       deadline = now + BARRIER_SYNC_TIMEOUT;
1462
1463       while (*vlib_worker_threads->node_reforks_required > 0)
1464         {
1465           if ((now = vlib_time_now (vm)) > deadline)
1466             {
1467               fformat (stderr, "%s: worker thread refork deadlock\n",
1468                        __FUNCTION__);
1469               os_panic ();
1470             }
1471         }
1472       vlib_stats_segment_unlock ();
1473     }
1474
1475   t_closed_total = now - vm->barrier_epoch;
1476
1477   minimum_open = t_closed_total * BARRIER_MINIMUM_OPEN_FACTOR;
1478
1479   if (minimum_open > BARRIER_MINIMUM_OPEN_LIMIT)
1480     {
1481       minimum_open = BARRIER_MINIMUM_OPEN_LIMIT;
1482     }
1483
1484   vm->barrier_no_close_before = now + minimum_open;
1485
1486   /* Record barrier epoch (used to enforce minimum open time) */
1487   vm->barrier_epoch = now;
1488
1489   barrier_trace_release (t_entry, t_closed_total, t_update_main);
1490
1491   if (PREDICT_FALSE (vec_len (vm->barrier_perf_callbacks) != 0))
1492     clib_call_callbacks (vm->barrier_perf_callbacks, vm,
1493                          vm->clib_time.last_cpu_time, 1 /* leave */ );
1494 }
1495
1496 static void
1497 vlib_worker_sync_rpc (void *args)
1498 {
1499   ASSERT (vlib_thread_is_main_w_barrier ());
1500   vlib_worker_threads->wait_before_barrier = 0;
1501 }
1502
1503 void
1504 vlib_workers_sync (void)
1505 {
1506   if (PREDICT_FALSE (!vlib_num_workers ()))
1507     return;
1508
1509   if (!(*vlib_worker_threads->wait_at_barrier) &&
1510       !clib_atomic_swap_rel_n (&vlib_worker_threads->wait_before_barrier, 1))
1511     {
1512       u32 thread_index = vlib_get_thread_index ();
1513       vlib_rpc_call_main_thread (vlib_worker_sync_rpc, (u8 *) &thread_index,
1514                                  sizeof (thread_index));
1515     }
1516
1517   /* Wait until main thread asks for barrier */
1518   while (!(*vlib_worker_threads->wait_at_barrier))
1519     ;
1520
1521   /* Stop before barrier and make sure all threads are either
1522    * at worker barrier or the barrier before it */
1523   clib_atomic_fetch_add (&vlib_worker_threads->workers_before_barrier, 1);
1524   while (vlib_num_workers () > (*vlib_worker_threads->workers_at_barrier +
1525                                 vlib_worker_threads->workers_before_barrier))
1526     ;
1527 }
1528
1529 void
1530 vlib_workers_continue (void)
1531 {
1532   if (PREDICT_FALSE (!vlib_num_workers ()))
1533     return;
1534
1535   clib_atomic_fetch_add (&vlib_worker_threads->done_work_before_barrier, 1);
1536
1537   /* Wait until all workers are done with work before barrier */
1538   while (vlib_worker_threads->done_work_before_barrier <
1539          vlib_worker_threads->workers_before_barrier)
1540     ;
1541
1542   clib_atomic_fetch_add (&vlib_worker_threads->done_work_before_barrier, -1);
1543   clib_atomic_fetch_add (&vlib_worker_threads->workers_before_barrier, -1);
1544 }
1545
1546 /**
1547  * Wait until each of the workers has been once around the track
1548  */
1549 void
1550 vlib_worker_wait_one_loop (void)
1551 {
1552   vlib_global_main_t *vgm = vlib_get_global_main ();
1553   ASSERT (vlib_get_thread_index () == 0);
1554
1555   if (vlib_get_n_threads () < 2)
1556     return;
1557
1558   if (vlib_worker_thread_barrier_held ())
1559     return;
1560
1561   u32 *counts = 0;
1562   u32 ii;
1563
1564   vec_validate (counts, vlib_get_n_threads () - 1);
1565
1566   /* record the current loop counts */
1567   vec_foreach_index (ii, vgm->vlib_mains)
1568     counts[ii] = vgm->vlib_mains[ii]->main_loop_count;
1569
1570   /* spin until each changes, apart from the main thread, or we'd be
1571    * a while */
1572   for (ii = 1; ii < vec_len (counts); ii++)
1573     {
1574       while (counts[ii] == vgm->vlib_mains[ii]->main_loop_count)
1575         CLIB_PAUSE ();
1576     }
1577
1578   vec_free (counts);
1579   return;
1580 }
1581
1582 void
1583 vlib_worker_thread_fn (void *arg)
1584 {
1585   vlib_global_main_t *vgm = vlib_get_global_main ();
1586   vlib_worker_thread_t *w = (vlib_worker_thread_t *) arg;
1587   vlib_main_t *vm = vlib_get_main ();
1588   clib_error_t *e;
1589
1590   ASSERT (vm->thread_index == vlib_get_thread_index ());
1591
1592   vlib_worker_thread_init (w);
1593   clib_time_init (&vm->clib_time);
1594   clib_mem_set_heap (w->thread_mheap);
1595
1596   vm->worker_init_functions_called = hash_create (0, 0);
1597
1598   e = vlib_call_init_exit_functions_no_sort (
1599     vm, &vgm->worker_init_function_registrations, 1 /* call_once */,
1600     0 /* is_global */);
1601   if (e)
1602     clib_error_report (e);
1603
1604   vlib_worker_loop (vm);
1605 }
1606
1607 /* *INDENT-OFF* */
1608 VLIB_REGISTER_THREAD (worker_thread_reg, static) = {
1609   .name = "workers",
1610   .short_name = "wk",
1611   .function = vlib_worker_thread_fn,
1612 };
1613 /* *INDENT-ON* */
1614
1615 extern clib_march_fn_registration
1616   *vlib_frame_queue_dequeue_with_aux_fn_march_fn_registrations;
1617 extern clib_march_fn_registration
1618   *vlib_frame_queue_dequeue_fn_march_fn_registrations;
1619 u32
1620 vlib_frame_queue_main_init (u32 node_index, u32 frame_queue_nelts)
1621 {
1622   vlib_thread_main_t *tm = vlib_get_thread_main ();
1623   vlib_main_t *vm = vlib_get_main ();
1624   vlib_frame_queue_main_t *fqm;
1625   vlib_frame_queue_t *fq;
1626   vlib_node_t *node;
1627   int i;
1628   u32 num_threads;
1629
1630   if (frame_queue_nelts == 0)
1631     frame_queue_nelts = FRAME_QUEUE_MAX_NELTS;
1632
1633   num_threads = 1 /* main thread */  + tm->n_threads;
1634   ASSERT (frame_queue_nelts >= 8 + num_threads);
1635
1636   vec_add2 (tm->frame_queue_mains, fqm, 1);
1637
1638   node = vlib_get_node (vm, fqm->node_index);
1639   ASSERT (node);
1640   if (node->aux_offset)
1641     {
1642       fqm->frame_queue_dequeue_fn =
1643         CLIB_MARCH_FN_VOID_POINTER (vlib_frame_queue_dequeue_with_aux_fn);
1644     }
1645   else
1646     {
1647       fqm->frame_queue_dequeue_fn =
1648         CLIB_MARCH_FN_VOID_POINTER (vlib_frame_queue_dequeue_fn);
1649     }
1650
1651   fqm->node_index = node_index;
1652   fqm->frame_queue_nelts = frame_queue_nelts;
1653
1654   vec_validate (fqm->vlib_frame_queues, tm->n_vlib_mains - 1);
1655   vec_set_len (fqm->vlib_frame_queues, 0);
1656   for (i = 0; i < tm->n_vlib_mains; i++)
1657     {
1658       fq = vlib_frame_queue_alloc (frame_queue_nelts);
1659       vec_add1 (fqm->vlib_frame_queues, fq);
1660     }
1661
1662   return (fqm - tm->frame_queue_mains);
1663 }
1664
1665 void
1666 vlib_process_signal_event_mt_helper (vlib_process_signal_event_mt_args_t *
1667                                      args)
1668 {
1669   ASSERT (vlib_get_thread_index () == 0);
1670   vlib_process_signal_event (vlib_get_main (), args->node_index,
1671                              args->type_opaque, args->data);
1672 }
1673
1674 void *rpc_call_main_thread_cb_fn;
1675
1676 void
1677 vlib_rpc_call_main_thread (void *callback, u8 * args, u32 arg_size)
1678 {
1679   if (rpc_call_main_thread_cb_fn)
1680     {
1681       void (*fp) (void *, u8 *, u32) = rpc_call_main_thread_cb_fn;
1682       (*fp) (callback, args, arg_size);
1683     }
1684   else
1685     clib_warning ("BUG: rpc_call_main_thread_cb_fn NULL!");
1686 }
1687
1688 clib_error_t *
1689 threads_init (vlib_main_t * vm)
1690 {
1691   const vlib_thread_main_t *tm = vlib_get_thread_main ();
1692
1693   if (tm->main_lcore == ~0 && tm->n_vlib_mains > 1)
1694     return clib_error_return (0, "Configuration error, a main core must "
1695                                  "be specified when using worker threads");
1696
1697   return 0;
1698 }
1699
1700 VLIB_INIT_FUNCTION (threads_init);
1701
1702 static clib_error_t *
1703 show_clock_command_fn (vlib_main_t * vm,
1704                        unformat_input_t * input, vlib_cli_command_t * cmd)
1705 {
1706   int verbose = 0;
1707   clib_timebase_t _tb, *tb = &_tb;
1708
1709   (void) unformat (input, "verbose %=", &verbose, 1);
1710
1711   clib_timebase_init (tb, 0 /* GMT */ , CLIB_TIMEBASE_DAYLIGHT_NONE,
1712                       &vm->clib_time);
1713
1714   vlib_cli_output (vm, "%U, %U GMT", format_clib_time, &vm->clib_time,
1715                    verbose, format_clib_timebase_time,
1716                    clib_timebase_now (tb));
1717
1718   vlib_cli_output (vm, "Time last barrier release %.9f",
1719                    vm->time_last_barrier_release);
1720
1721   foreach_vlib_main ()
1722     {
1723       vlib_cli_output (vm, "%d: %U", this_vlib_main->thread_index,
1724                        format_clib_time, &this_vlib_main->clib_time, verbose);
1725
1726       vlib_cli_output (vm, "Thread %d offset %.9f error %.9f",
1727                        this_vlib_main->thread_index,
1728                        this_vlib_main->time_offset,
1729                        vm->time_last_barrier_release -
1730                          this_vlib_main->time_last_barrier_release);
1731     }
1732   return 0;
1733 }
1734
1735 /* *INDENT-OFF* */
1736 VLIB_CLI_COMMAND (f_command, static) =
1737 {
1738   .path = "show clock",
1739   .short_help = "show clock",
1740   .function = show_clock_command_fn,
1741 };
1742 /* *INDENT-ON* */
1743
1744 vlib_thread_main_t *
1745 vlib_get_thread_main_not_inline (void)
1746 {
1747   return vlib_get_thread_main ();
1748 }
1749
1750 /*
1751  * fd.io coding-style-patch-verification: ON
1752  *
1753  * Local Variables:
1754  * eval: (c-set-style "gnu")
1755  * End:
1756  */