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