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