kernel/trace/trace_clock.c

   1 // SPDX-License-Identifier: GPL-2.0
   2 /*
   3  * tracing clocks
   4  *
   5  *  Copyright (C) 2009 Red Hat, Inc., Ingo Molnar <mingo@redhat.com>
   6  *
   7  * Implements 3 trace clock variants, with differing scalability/precision
   8  * tradeoffs:
   9  *
  10  *  -   local: CPU-local trace clock
  11  *  -  medium: scalable global clock with some jitter
  12  *  -  global: globally monotonic, serialized clock
  13  *
  14  * Tracer plugins will chose a default from these clocks.
  15  */
  16 #include <linux/spinlock.h>
  17 #include <linux/irqflags.h>
  18 #include <linux/hardirq.h>
  19 #include <linux/module.h>
  20 #include <linux/percpu.h>
  21 #include <linux/sched.h>
  22 #include <linux/sched/clock.h>
  23 #include <linux/ktime.h>
  24 #include <linux/trace_clock.h>
  25
  26 /*
  27  * trace_clock_local(): the simplest and least coherent tracing clock.
  28  *
  29  * Useful for tracing that does not cross to other CPUs nor
  30  * does it go through idle events.
  31  */
  32 u64 notrace trace_clock_local(void)
  33 {
  34         u64 clock;
  35
  36         /*
  37          * sched_clock() is an architecture implemented, fast, scalable,
  38          * lockless clock. It is not guaranteed to be coherent across
  39          * CPUs, nor across CPU idle events.
  40          */
  41         preempt_disable_notrace();
  42         clock = sched_clock();
  43         preempt_enable_notrace();
  44
  45         return clock;
  46 }
  47 EXPORT_SYMBOL_GPL(trace_clock_local);
  48
  49 /*
  50  * trace_clock(): 'between' trace clock. Not completely serialized,
  51  * but not completely incorrect when crossing CPUs either.
  52  *
  53  * This is based on cpu_clock(), which will allow at most ~1 jiffy of
  54  * jitter between CPUs. So it's a pretty scalable clock, but there
  55  * can be offsets in the trace data.
  56  */
  57 u64 notrace trace_clock(void)
  58 {
  59         return local_clock();
  60 }
  61 EXPORT_SYMBOL_GPL(trace_clock);
  62
  63 /*
  64  * trace_jiffy_clock(): Simply use jiffies as a clock counter.
  65  * Note that this use of jiffies_64 is not completely safe on
  66  * 32-bit systems. But the window is tiny, and the effect if
  67  * we are affected is that we will have an obviously bogus
  68  * timestamp on a trace event - i.e. not life threatening.
  69  */
  70 u64 notrace trace_clock_jiffies(void)
  71 {
  72         return jiffies_64_to_clock_t(jiffies_64 - INITIAL_JIFFIES);
  73 }
  74 EXPORT_SYMBOL_GPL(trace_clock_jiffies);
  75
  76 /*
  77  * trace_clock_global(): special globally coherent trace clock
  78  *
  79  * It has higher overhead than the other trace clocks but is still
  80  * an order of magnitude faster than GTOD derived hardware clocks.
  81  *
  82  * Used by plugins that need globally coherent timestamps.
  83  */
  84
  85 /* keep prev_time and lock in the same cacheline. */
  86 static struct {
  87         u64 prev_time;
  88         arch_spinlock_t lock;
  89 } trace_clock_struct ____cacheline_aligned_in_smp =
  90         {
  91                 .lock = (arch_spinlock_t)__ARCH_SPIN_LOCK_UNLOCKED,
  92         };
  93
  94 u64 notrace trace_clock_global(void)
  95 {
  96         unsigned long flags;
  97         int this_cpu;
  98         u64 now;
  99
 100         raw_local_irq_save(flags);
 101
 102         this_cpu = raw_smp_processor_id();
 103         now = sched_clock_cpu(this_cpu);
 104         /*
 105          * If in an NMI context then dont risk lockups and return the
 106          * cpu_clock() time:
 107          */
 108         if (unlikely(in_nmi()))
 109                 goto out;
 110
 111         arch_spin_lock(&trace_clock_struct.lock);
 112
 113         /*
 114          * TODO: if this happens often then maybe we should reset
 115          * my_scd->clock to prev_time+1, to make sure
 116          * we start ticking with the local clock from now on?
 117          */
 118         if ((s64)(now - trace_clock_struct.prev_time) < 0)
 119                 now = trace_clock_struct.prev_time + 1;
 120
 121         trace_clock_struct.prev_time = now;
 122
 123         arch_spin_unlock(&trace_clock_struct.lock);
 124
 125  out:
 126         raw_local_irq_restore(flags);
 127
 128         return now;
 129 }
 130 EXPORT_SYMBOL_GPL(trace_clock_global);
 131
 132 static atomic64_t trace_counter;
 133
 134 /*
 135  * trace_clock_counter(): simply an atomic counter.
 136  * Use the trace_counter "counter" for cases where you do not care
 137  * about timings, but are interested in strict ordering.
 138  */
 139 u64 notrace trace_clock_counter(void)
 140 {
 141         return atomic64_add_return(1, &trace_counter);
 142 }