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