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