~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

TOMOYO Linux Cross Reference
Linux/include/linux/trace_recursion.h

Version: ~ [ linux-6.12-rc7 ] ~ [ linux-6.11.7 ] ~ [ linux-6.10.14 ] ~ [ linux-6.9.12 ] ~ [ linux-6.8.12 ] ~ [ linux-6.7.12 ] ~ [ linux-6.6.60 ] ~ [ linux-6.5.13 ] ~ [ linux-6.4.16 ] ~ [ linux-6.3.13 ] ~ [ linux-6.2.16 ] ~ [ linux-6.1.116 ] ~ [ linux-6.0.19 ] ~ [ linux-5.19.17 ] ~ [ linux-5.18.19 ] ~ [ linux-5.17.15 ] ~ [ linux-5.16.20 ] ~ [ linux-5.15.171 ] ~ [ linux-5.14.21 ] ~ [ linux-5.13.19 ] ~ [ linux-5.12.19 ] ~ [ linux-5.11.22 ] ~ [ linux-5.10.229 ] ~ [ linux-5.9.16 ] ~ [ linux-5.8.18 ] ~ [ linux-5.7.19 ] ~ [ linux-5.6.19 ] ~ [ linux-5.5.19 ] ~ [ linux-5.4.285 ] ~ [ linux-5.3.18 ] ~ [ linux-5.2.21 ] ~ [ linux-5.1.21 ] ~ [ linux-5.0.21 ] ~ [ linux-4.20.17 ] ~ [ linux-4.19.323 ] ~ [ linux-4.18.20 ] ~ [ linux-4.17.19 ] ~ [ linux-4.16.18 ] ~ [ linux-4.15.18 ] ~ [ linux-4.14.336 ] ~ [ linux-4.13.16 ] ~ [ linux-4.12.14 ] ~ [ linux-4.11.12 ] ~ [ linux-4.10.17 ] ~ [ linux-4.9.337 ] ~ [ linux-4.4.302 ] ~ [ linux-3.10.108 ] ~ [ linux-2.6.32.71 ] ~ [ linux-2.6.0 ] ~ [ linux-2.4.37.11 ] ~ [ unix-v6-master ] ~ [ ccs-tools-1.8.12 ] ~ [ policy-sample ] ~
Architecture: ~ [ i386 ] ~ [ alpha ] ~ [ m68k ] ~ [ mips ] ~ [ ppc ] ~ [ sparc ] ~ [ sparc64 ] ~

Diff markup

Differences between /include/linux/trace_recursion.h (Version linux-6.12-rc7) and /include/linux/trace_recursion.h (Version linux-5.14.21)


  1 /* SPDX-License-Identifier: GPL-2.0 */              1 /* SPDX-License-Identifier: GPL-2.0 */
  2 #ifndef _LINUX_TRACE_RECURSION_H                    2 #ifndef _LINUX_TRACE_RECURSION_H
  3 #define _LINUX_TRACE_RECURSION_H                    3 #define _LINUX_TRACE_RECURSION_H
  4                                                     4 
  5 #include <linux/interrupt.h>                        5 #include <linux/interrupt.h>
  6 #include <linux/sched.h>                            6 #include <linux/sched.h>
  7                                                     7 
  8 #ifdef CONFIG_TRACING                               8 #ifdef CONFIG_TRACING
  9                                                     9 
 10 /* Only current can touch trace_recursion */       10 /* Only current can touch trace_recursion */
 11                                                    11 
 12 /*                                                 12 /*
 13  * For function tracing recursion:                 13  * For function tracing recursion:
 14  *  The order of these bits are important.         14  *  The order of these bits are important.
 15  *                                                 15  *
 16  *  When function tracing occurs, the followin     16  *  When function tracing occurs, the following steps are made:
 17  *   If arch does not support a ftrace feature     17  *   If arch does not support a ftrace feature:
 18  *    call internal function (uses INTERNAL bi     18  *    call internal function (uses INTERNAL bits) which calls...
 19  *   The function callback, which can use the      19  *   The function callback, which can use the FTRACE bits to
 20  *    check for recursion.                         20  *    check for recursion.
 21  */                                                21  */
 22 enum {                                             22 enum {
 23         /* Function recursion bits */              23         /* Function recursion bits */
 24         TRACE_FTRACE_BIT,                          24         TRACE_FTRACE_BIT,
 25         TRACE_FTRACE_NMI_BIT,                      25         TRACE_FTRACE_NMI_BIT,
 26         TRACE_FTRACE_IRQ_BIT,                      26         TRACE_FTRACE_IRQ_BIT,
 27         TRACE_FTRACE_SIRQ_BIT,                     27         TRACE_FTRACE_SIRQ_BIT,
 28         TRACE_FTRACE_TRANSITION_BIT,               28         TRACE_FTRACE_TRANSITION_BIT,
 29                                                    29 
 30         /* Internal use recursion bits */          30         /* Internal use recursion bits */
 31         TRACE_INTERNAL_BIT,                        31         TRACE_INTERNAL_BIT,
 32         TRACE_INTERNAL_NMI_BIT,                    32         TRACE_INTERNAL_NMI_BIT,
 33         TRACE_INTERNAL_IRQ_BIT,                    33         TRACE_INTERNAL_IRQ_BIT,
 34         TRACE_INTERNAL_SIRQ_BIT,                   34         TRACE_INTERNAL_SIRQ_BIT,
 35         TRACE_INTERNAL_TRANSITION_BIT,             35         TRACE_INTERNAL_TRANSITION_BIT,
 36                                                    36 
 37         TRACE_BRANCH_BIT,                          37         TRACE_BRANCH_BIT,
 38 /*                                                 38 /*
 39  * Abuse of the trace_recursion.                   39  * Abuse of the trace_recursion.
 40  * As we need a way to maintain state if we ar     40  * As we need a way to maintain state if we are tracing the function
 41  * graph in irq because we want to trace a par     41  * graph in irq because we want to trace a particular function that
 42  * was called in irq context but we have irq t     42  * was called in irq context but we have irq tracing off. Since this
 43  * can only be modified by current, we can reu     43  * can only be modified by current, we can reuse trace_recursion.
 44  */                                                44  */
 45         TRACE_IRQ_BIT,                             45         TRACE_IRQ_BIT,
 46                                                    46 
                                                   >>  47         /* Set if the function is in the set_graph_function file */
                                                   >>  48         TRACE_GRAPH_BIT,
                                                   >>  49 
                                                   >>  50         /*
                                                   >>  51          * In the very unlikely case that an interrupt came in
                                                   >>  52          * at a start of graph tracing, and we want to trace
                                                   >>  53          * the function in that interrupt, the depth can be greater
                                                   >>  54          * than zero, because of the preempted start of a previous
                                                   >>  55          * trace. In an even more unlikely case, depth could be 2
                                                   >>  56          * if a softirq interrupted the start of graph tracing,
                                                   >>  57          * followed by an interrupt preempting a start of graph
                                                   >>  58          * tracing in the softirq, and depth can even be 3
                                                   >>  59          * if an NMI came in at the start of an interrupt function
                                                   >>  60          * that preempted a softirq start of a function that
                                                   >>  61          * preempted normal context!!!! Luckily, it can't be
                                                   >>  62          * greater than 3, so the next two bits are a mask
                                                   >>  63          * of what the depth is when we set TRACE_GRAPH_BIT
                                                   >>  64          */
                                                   >>  65 
                                                   >>  66         TRACE_GRAPH_DEPTH_START_BIT,
                                                   >>  67         TRACE_GRAPH_DEPTH_END_BIT,
                                                   >>  68 
                                                   >>  69         /*
                                                   >>  70          * To implement set_graph_notrace, if this bit is set, we ignore
                                                   >>  71          * function graph tracing of called functions, until the return
                                                   >>  72          * function is called to clear it.
                                                   >>  73          */
                                                   >>  74         TRACE_GRAPH_NOTRACE_BIT,
                                                   >>  75 
 47         /* Used to prevent recursion recording     76         /* Used to prevent recursion recording from recursing. */
 48         TRACE_RECORD_RECURSION_BIT,                77         TRACE_RECORD_RECURSION_BIT,
 49 };                                                 78 };
 50                                                    79 
 51 #define trace_recursion_set(bit)        do { (     80 #define trace_recursion_set(bit)        do { (current)->trace_recursion |= (1<<(bit)); } while (0)
 52 #define trace_recursion_clear(bit)      do { (     81 #define trace_recursion_clear(bit)      do { (current)->trace_recursion &= ~(1<<(bit)); } while (0)
 53 #define trace_recursion_test(bit)       ((curr     82 #define trace_recursion_test(bit)       ((current)->trace_recursion & (1<<(bit)))
 54                                                    83 
                                                   >>  84 #define trace_recursion_depth() \
                                                   >>  85         (((current)->trace_recursion >> TRACE_GRAPH_DEPTH_START_BIT) & 3)
                                                   >>  86 #define trace_recursion_set_depth(depth) \
                                                   >>  87         do {                                                            \
                                                   >>  88                 current->trace_recursion &=                             \
                                                   >>  89                         ~(3 << TRACE_GRAPH_DEPTH_START_BIT);            \
                                                   >>  90                 current->trace_recursion |=                             \
                                                   >>  91                         ((depth) & 3) << TRACE_GRAPH_DEPTH_START_BIT;   \
                                                   >>  92         } while (0)
                                                   >>  93 
 55 #define TRACE_CONTEXT_BITS      4                  94 #define TRACE_CONTEXT_BITS      4
 56                                                    95 
 57 #define TRACE_FTRACE_START      TRACE_FTRACE_B     96 #define TRACE_FTRACE_START      TRACE_FTRACE_BIT
 58                                                    97 
 59 #define TRACE_LIST_START        TRACE_INTERNAL     98 #define TRACE_LIST_START        TRACE_INTERNAL_BIT
 60                                                    99 
 61 #define TRACE_CONTEXT_MASK      ((1 << (TRACE_    100 #define TRACE_CONTEXT_MASK      ((1 << (TRACE_LIST_START + TRACE_CONTEXT_BITS)) - 1)
 62                                                   101 
 63 /*                                                102 /*
 64  * Used for setting context                       103  * Used for setting context
 65  *  NMI     = 0                                   104  *  NMI     = 0
 66  *  IRQ     = 1                                   105  *  IRQ     = 1
 67  *  SOFTIRQ = 2                                   106  *  SOFTIRQ = 2
 68  *  NORMAL  = 3                                   107  *  NORMAL  = 3
 69  */                                               108  */
 70 enum {                                            109 enum {
 71         TRACE_CTX_NMI,                            110         TRACE_CTX_NMI,
 72         TRACE_CTX_IRQ,                            111         TRACE_CTX_IRQ,
 73         TRACE_CTX_SOFTIRQ,                        112         TRACE_CTX_SOFTIRQ,
 74         TRACE_CTX_NORMAL,                         113         TRACE_CTX_NORMAL,
 75         TRACE_CTX_TRANSITION,                     114         TRACE_CTX_TRANSITION,
 76 };                                                115 };
 77                                                   116 
 78 static __always_inline int trace_get_context_b    117 static __always_inline int trace_get_context_bit(void)
 79 {                                                 118 {
 80         unsigned char bit = interrupt_context_ !! 119         unsigned long pc = preempt_count();
 81                                                   120 
 82         return TRACE_CTX_NORMAL - bit;         !! 121         if (!(pc & (NMI_MASK | HARDIRQ_MASK | SOFTIRQ_OFFSET)))
                                                   >> 122                 return TRACE_CTX_NORMAL;
                                                   >> 123         else
                                                   >> 124                 return pc & NMI_MASK ? TRACE_CTX_NMI :
                                                   >> 125                         pc & HARDIRQ_MASK ? TRACE_CTX_IRQ : TRACE_CTX_SOFTIRQ;
 83 }                                                 126 }
 84                                                   127 
 85 #ifdef CONFIG_FTRACE_RECORD_RECURSION             128 #ifdef CONFIG_FTRACE_RECORD_RECURSION
 86 extern void ftrace_record_recursion(unsigned l    129 extern void ftrace_record_recursion(unsigned long ip, unsigned long parent_ip);
 87 # define do_ftrace_record_recursion(ip, pip)      130 # define do_ftrace_record_recursion(ip, pip)                            \
 88         do {                                      131         do {                                                            \
 89                 if (!trace_recursion_test(TRAC    132                 if (!trace_recursion_test(TRACE_RECORD_RECURSION_BIT)) { \
 90                         trace_recursion_set(TR    133                         trace_recursion_set(TRACE_RECORD_RECURSION_BIT); \
 91                         ftrace_record_recursio    134                         ftrace_record_recursion(ip, pip);               \
 92                         trace_recursion_clear(    135                         trace_recursion_clear(TRACE_RECORD_RECURSION_BIT); \
 93                 }                                 136                 }                                                       \
 94         } while (0)                               137         } while (0)
 95 #else                                             138 #else
 96 # define do_ftrace_record_recursion(ip, pip)      139 # define do_ftrace_record_recursion(ip, pip)    do { } while (0)
 97 #endif                                            140 #endif
 98                                                   141 
 99 #ifdef CONFIG_FTRACE_VALIDATE_RCU_IS_WATCHING  << 
100 # define trace_warn_on_no_rcu(ip)              << 
101         ({                                     << 
102                 bool __ret = !rcu_is_watching( << 
103                 if (__ret && !trace_recursion_ << 
104                         trace_recursion_set(TR << 
105                         WARN_ONCE(true, "RCU n << 
106                         trace_recursion_clear( << 
107                 }                              << 
108                 __ret;                         << 
109         })                                     << 
110 #else                                          << 
111 # define trace_warn_on_no_rcu(ip)       false  << 
112 #endif                                         << 
113                                                << 
114 /*                                             << 
115  * Preemption is promised to be disabled when  << 
116  */                                            << 
117 static __always_inline int trace_test_and_set_    142 static __always_inline int trace_test_and_set_recursion(unsigned long ip, unsigned long pip,
118                                                   143                                                         int start)
119 {                                                 144 {
120         unsigned int val = READ_ONCE(current->    145         unsigned int val = READ_ONCE(current->trace_recursion);
121         int bit;                                  146         int bit;
122                                                   147 
123         if (trace_warn_on_no_rcu(ip))          << 
124                 return -1;                     << 
125                                                << 
126         bit = trace_get_context_bit() + start;    148         bit = trace_get_context_bit() + start;
127         if (unlikely(val & (1 << bit))) {         149         if (unlikely(val & (1 << bit))) {
128                 /*                                150                 /*
129                  * If an interrupt occurs duri !! 151                  * It could be that preempt_count has not been updated during
130                  * happens in that interrupt b !! 152                  * a switch between contexts. Allow for a single recursion.
131                  * updated to reflect the new  << 
132                  * will think a recursion occu << 
133                  * Let a single instance happe << 
134                  * not drop those events.      << 
135                  */                               153                  */
136                 bit = TRACE_CTX_TRANSITION + s    154                 bit = TRACE_CTX_TRANSITION + start;
137                 if (val & (1 << bit)) {           155                 if (val & (1 << bit)) {
138                         do_ftrace_record_recur    156                         do_ftrace_record_recursion(ip, pip);
139                         return -1;                157                         return -1;
140                 }                                 158                 }
141         }                                         159         }
142                                                   160 
143         val |= 1 << bit;                          161         val |= 1 << bit;
144         current->trace_recursion = val;           162         current->trace_recursion = val;
145         barrier();                                163         barrier();
146                                                   164 
147         preempt_disable_notrace();             << 
148                                                << 
149         return bit;                               165         return bit;
150 }                                                 166 }
151                                                   167 
152 /*                                             << 
153  * Preemption will be enabled (if it was previ << 
154  */                                            << 
155 static __always_inline void trace_clear_recurs    168 static __always_inline void trace_clear_recursion(int bit)
156 {                                                 169 {
157         preempt_enable_notrace();              << 
158         barrier();                                170         barrier();
159         trace_recursion_clear(bit);               171         trace_recursion_clear(bit);
160 }                                                 172 }
161                                                   173 
162 /**                                               174 /**
163  * ftrace_test_recursion_trylock - tests for r    175  * ftrace_test_recursion_trylock - tests for recursion in same context
164  *                                                176  *
165  * Use this for ftrace callbacks. This will de    177  * Use this for ftrace callbacks. This will detect if the function
166  * tracing recursed in the same context (norma    178  * tracing recursed in the same context (normal vs interrupt),
167  *                                                179  *
168  * Returns: -1 if a recursion happened.           180  * Returns: -1 if a recursion happened.
169  *           >= 0 if no recursion.             !! 181  *           >= 0 if no recursion
170  */                                               182  */
171 static __always_inline int ftrace_test_recursi    183 static __always_inline int ftrace_test_recursion_trylock(unsigned long ip,
172                                                   184                                                          unsigned long parent_ip)
173 {                                                 185 {
174         return trace_test_and_set_recursion(ip    186         return trace_test_and_set_recursion(ip, parent_ip, TRACE_FTRACE_START);
175 }                                                 187 }
176                                                   188 
177 /**                                               189 /**
178  * ftrace_test_recursion_unlock - called when     190  * ftrace_test_recursion_unlock - called when function callback is complete
179  * @bit: The return of a successful ftrace_tes    191  * @bit: The return of a successful ftrace_test_recursion_trylock()
180  *                                                192  *
181  * This is used at the end of a ftrace callbac    193  * This is used at the end of a ftrace callback.
182  */                                               194  */
183 static __always_inline void ftrace_test_recurs    195 static __always_inline void ftrace_test_recursion_unlock(int bit)
184 {                                                 196 {
185         trace_clear_recursion(bit);               197         trace_clear_recursion(bit);
186 }                                                 198 }
187                                                   199 
188 #endif /* CONFIG_TRACING */                       200 #endif /* CONFIG_TRACING */
189 #endif /* _LINUX_TRACE_RECURSION_H */             201 #endif /* _LINUX_TRACE_RECURSION_H */
190                                                   202 

~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

kernel.org | git.kernel.org | LWN.net | Project Home | SVN repository | Mail admin

Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.

sflogo.php