• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /* SPDX-License-Identifier: GPL-2.0 */
2 #undef TRACE_SYSTEM
3 #define TRACE_SYSTEM rcu
4 
5 #if !defined(_TRACE_RCU_H) || defined(TRACE_HEADER_MULTI_READ)
6 #define _TRACE_RCU_H
7 
8 #include <linux/tracepoint.h>
9 
10 #ifdef CONFIG_RCU_TRACE
11 #define TRACE_EVENT_RCU TRACE_EVENT
12 #else
13 #define TRACE_EVENT_RCU TRACE_EVENT_NOP
14 #endif
15 
16 /*
17  * Tracepoint for start/end markers used for utilization calculations.
18  * By convention, the string is of the following forms:
19  *
20  * "Start <activity>" -- Mark the start of the specified activity,
21  *			 such as "context switch".  Nesting is permitted.
22  * "End <activity>" -- Mark the end of the specified activity.
23  *
24  * An "@" character within "<activity>" is a comment character: Data
25  * reduction scripts will ignore the "@" and the remainder of the line.
26  */
27 TRACE_EVENT(rcu_utilization,
28 
29 	TP_PROTO(const char *s),
30 
31 	TP_ARGS(s),
32 
33 	TP_STRUCT__entry(
34 		__field(const char *, s)
35 	),
36 
37 	TP_fast_assign(
38 		__entry->s = s;
39 	),
40 
41 	TP_printk("%s", __entry->s)
42 );
43 
44 #if defined(CONFIG_TREE_RCU)
45 
46 /*
47  * Tracepoint for grace-period events.  Takes a string identifying the
48  * RCU flavor, the grace-period number, and a string identifying the
49  * grace-period-related event as follows:
50  *
51  *	"AccReadyCB": CPU acclerates new callbacks to RCU_NEXT_READY_TAIL.
52  *	"AccWaitCB": CPU accelerates new callbacks to RCU_WAIT_TAIL.
53  *	"newreq": Request a new grace period.
54  *	"start": Start a grace period.
55  *	"cpustart": CPU first notices a grace-period start.
56  *	"cpuqs": CPU passes through a quiescent state.
57  *	"cpuonl": CPU comes online.
58  *	"cpuofl": CPU goes offline.
59  *	"cpuofl-bgp": CPU goes offline while blocking a grace period.
60  *	"reqwait": GP kthread sleeps waiting for grace-period request.
61  *	"reqwaitsig": GP kthread awakened by signal from reqwait state.
62  *	"fqswait": GP kthread waiting until time to force quiescent states.
63  *	"fqsstart": GP kthread starts forcing quiescent states.
64  *	"fqsend": GP kthread done forcing quiescent states.
65  *	"fqswaitsig": GP kthread awakened by signal from fqswait state.
66  *	"end": End a grace period.
67  *	"cpuend": CPU first notices a grace-period end.
68  */
69 TRACE_EVENT_RCU(rcu_grace_period,
70 
71 	TP_PROTO(const char *rcuname, unsigned long gp_seq, const char *gpevent),
72 
73 	TP_ARGS(rcuname, gp_seq, gpevent),
74 
75 	TP_STRUCT__entry(
76 		__field(const char *, rcuname)
77 		__field(long, gp_seq)
78 		__field(const char *, gpevent)
79 	),
80 
81 	TP_fast_assign(
82 		__entry->rcuname = rcuname;
83 		__entry->gp_seq = (long)gp_seq;
84 		__entry->gpevent = gpevent;
85 	),
86 
87 	TP_printk("%s %ld %s",
88 		  __entry->rcuname, __entry->gp_seq, __entry->gpevent)
89 );
90 
91 /*
92  * Tracepoint for future grace-period events.  The caller should pull
93  * the data from the rcu_node structure, other than rcuname, which comes
94  * from the rcu_state structure, and event, which is one of the following:
95  *
96  * "Cleanup": Clean up rcu_node structure after previous GP.
97  * "CleanupMore": Clean up, and another GP is needed.
98  * "EndWait": Complete wait.
99  * "NoGPkthread": The RCU grace-period kthread has not yet started.
100  * "Prestarted": Someone beat us to the request
101  * "Startedleaf": Leaf node marked for future GP.
102  * "Startedleafroot": All nodes from leaf to root marked for future GP.
103  * "Startedroot": Requested a nocb grace period based on root-node data.
104  * "Startleaf": Request a grace period based on leaf-node data.
105  * "StartWait": Start waiting for the requested grace period.
106  */
107 TRACE_EVENT_RCU(rcu_future_grace_period,
108 
109 	TP_PROTO(const char *rcuname, unsigned long gp_seq,
110 		 unsigned long gp_seq_req, u8 level, int grplo, int grphi,
111 		 const char *gpevent),
112 
113 	TP_ARGS(rcuname, gp_seq, gp_seq_req, level, grplo, grphi, gpevent),
114 
115 	TP_STRUCT__entry(
116 		__field(const char *, rcuname)
117 		__field(long, gp_seq)
118 		__field(long, gp_seq_req)
119 		__field(u8, level)
120 		__field(int, grplo)
121 		__field(int, grphi)
122 		__field(const char *, gpevent)
123 	),
124 
125 	TP_fast_assign(
126 		__entry->rcuname = rcuname;
127 		__entry->gp_seq = (long)gp_seq;
128 		__entry->gp_seq_req = (long)gp_seq_req;
129 		__entry->level = level;
130 		__entry->grplo = grplo;
131 		__entry->grphi = grphi;
132 		__entry->gpevent = gpevent;
133 	),
134 
135 	TP_printk("%s %ld %ld %u %d %d %s",
136 		  __entry->rcuname, (long)__entry->gp_seq, (long)__entry->gp_seq_req, __entry->level,
137 		  __entry->grplo, __entry->grphi, __entry->gpevent)
138 );
139 
140 /*
141  * Tracepoint for grace-period-initialization events.  These are
142  * distinguished by the type of RCU, the new grace-period number, the
143  * rcu_node structure level, the starting and ending CPU covered by the
144  * rcu_node structure, and the mask of CPUs that will be waited for.
145  * All but the type of RCU are extracted from the rcu_node structure.
146  */
147 TRACE_EVENT_RCU(rcu_grace_period_init,
148 
149 	TP_PROTO(const char *rcuname, unsigned long gp_seq, u8 level,
150 		 int grplo, int grphi, unsigned long qsmask),
151 
152 	TP_ARGS(rcuname, gp_seq, level, grplo, grphi, qsmask),
153 
154 	TP_STRUCT__entry(
155 		__field(const char *, rcuname)
156 		__field(long, gp_seq)
157 		__field(u8, level)
158 		__field(int, grplo)
159 		__field(int, grphi)
160 		__field(unsigned long, qsmask)
161 	),
162 
163 	TP_fast_assign(
164 		__entry->rcuname = rcuname;
165 		__entry->gp_seq = (long)gp_seq;
166 		__entry->level = level;
167 		__entry->grplo = grplo;
168 		__entry->grphi = grphi;
169 		__entry->qsmask = qsmask;
170 	),
171 
172 	TP_printk("%s %ld %u %d %d %lx",
173 		  __entry->rcuname, __entry->gp_seq, __entry->level,
174 		  __entry->grplo, __entry->grphi, __entry->qsmask)
175 );
176 
177 /*
178  * Tracepoint for expedited grace-period events.  Takes a string identifying
179  * the RCU flavor, the expedited grace-period sequence number, and a string
180  * identifying the grace-period-related event as follows:
181  *
182  *	"snap": Captured snapshot of expedited grace period sequence number.
183  *	"start": Started a real expedited grace period.
184  *	"reset": Started resetting the tree
185  *	"select": Started selecting the CPUs to wait on.
186  *	"selectofl": Selected CPU partially offline.
187  *	"startwait": Started waiting on selected CPUs.
188  *	"end": Ended a real expedited grace period.
189  *	"endwake": Woke piggybackers up.
190  *	"done": Someone else did the expedited grace period for us.
191  */
192 TRACE_EVENT_RCU(rcu_exp_grace_period,
193 
194 	TP_PROTO(const char *rcuname, unsigned long gpseq, const char *gpevent),
195 
196 	TP_ARGS(rcuname, gpseq, gpevent),
197 
198 	TP_STRUCT__entry(
199 		__field(const char *, rcuname)
200 		__field(long, gpseq)
201 		__field(const char *, gpevent)
202 	),
203 
204 	TP_fast_assign(
205 		__entry->rcuname = rcuname;
206 		__entry->gpseq = (long)gpseq;
207 		__entry->gpevent = gpevent;
208 	),
209 
210 	TP_printk("%s %ld %s",
211 		  __entry->rcuname, __entry->gpseq, __entry->gpevent)
212 );
213 
214 /*
215  * Tracepoint for expedited grace-period funnel-locking events.  Takes a
216  * string identifying the RCU flavor, an integer identifying the rcu_node
217  * combining-tree level, another pair of integers identifying the lowest-
218  * and highest-numbered CPU associated with the current rcu_node structure,
219  * and a string.  identifying the grace-period-related event as follows:
220  *
221  *	"nxtlvl": Advance to next level of rcu_node funnel
222  *	"wait": Wait for someone else to do expedited GP
223  */
224 TRACE_EVENT_RCU(rcu_exp_funnel_lock,
225 
226 	TP_PROTO(const char *rcuname, u8 level, int grplo, int grphi,
227 		 const char *gpevent),
228 
229 	TP_ARGS(rcuname, level, grplo, grphi, gpevent),
230 
231 	TP_STRUCT__entry(
232 		__field(const char *, rcuname)
233 		__field(u8, level)
234 		__field(int, grplo)
235 		__field(int, grphi)
236 		__field(const char *, gpevent)
237 	),
238 
239 	TP_fast_assign(
240 		__entry->rcuname = rcuname;
241 		__entry->level = level;
242 		__entry->grplo = grplo;
243 		__entry->grphi = grphi;
244 		__entry->gpevent = gpevent;
245 	),
246 
247 	TP_printk("%s %d %d %d %s",
248 		  __entry->rcuname, __entry->level, __entry->grplo,
249 		  __entry->grphi, __entry->gpevent)
250 );
251 
252 #ifdef CONFIG_RCU_NOCB_CPU
253 /*
254  * Tracepoint for RCU no-CBs CPU callback handoffs.  This event is intended
255  * to assist debugging of these handoffs.
256  *
257  * The first argument is the name of the RCU flavor, and the second is
258  * the number of the offloaded CPU are extracted.  The third and final
259  * argument is a string as follows:
260  *
261  * "AlreadyAwake": The to-be-awakened rcuo kthread is already awake.
262  * "Bypass": rcuo GP kthread sees non-empty ->nocb_bypass.
263  * "CBSleep": rcuo CB kthread sleeping waiting for CBs.
264  * "Check": rcuo GP kthread checking specified CPU for work.
265  * "DeferredWake": Timer expired or polled check, time to wake.
266  * "DoWake": The to-be-awakened rcuo kthread needs to be awakened.
267  * "EndSleep": Done waiting for GP for !rcu_nocb_poll.
268  * "FirstBQ": New CB to empty ->nocb_bypass (->cblist maybe non-empty).
269  * "FirstBQnoWake": FirstBQ plus rcuo kthread need not be awakened.
270  * "FirstBQwake": FirstBQ plus rcuo kthread must be awakened.
271  * "FirstQ": New CB to empty ->cblist (->nocb_bypass maybe non-empty).
272  * "NeedWaitGP": rcuo GP kthread must wait on a grace period.
273  * "Poll": Start of new polling cycle for rcu_nocb_poll.
274  * "Sleep": Sleep waiting for GP for !rcu_nocb_poll.
275  * "Timer": Deferred-wake timer expired.
276  * "WakeEmptyIsDeferred": Wake rcuo kthread later, first CB to empty list.
277  * "WakeEmpty": Wake rcuo kthread, first CB to empty list.
278  * "WakeNot": Don't wake rcuo kthread.
279  * "WakeNotPoll": Don't wake rcuo kthread because it is polling.
280  * "WakeOvfIsDeferred": Wake rcuo kthread later, CB list is huge.
281  * "WokeEmpty": rcuo CB kthread woke to find empty list.
282  */
283 TRACE_EVENT_RCU(rcu_nocb_wake,
284 
285 	TP_PROTO(const char *rcuname, int cpu, const char *reason),
286 
287 	TP_ARGS(rcuname, cpu, reason),
288 
289 	TP_STRUCT__entry(
290 		__field(const char *, rcuname)
291 		__field(int, cpu)
292 		__field(const char *, reason)
293 	),
294 
295 	TP_fast_assign(
296 		__entry->rcuname = rcuname;
297 		__entry->cpu = cpu;
298 		__entry->reason = reason;
299 	),
300 
301 	TP_printk("%s %d %s", __entry->rcuname, __entry->cpu, __entry->reason)
302 );
303 #endif
304 
305 /*
306  * Tracepoint for tasks blocking within preemptible-RCU read-side
307  * critical sections.  Track the type of RCU (which one day might
308  * include SRCU), the grace-period number that the task is blocking
309  * (the current or the next), and the task's PID.
310  */
311 TRACE_EVENT_RCU(rcu_preempt_task,
312 
313 	TP_PROTO(const char *rcuname, int pid, unsigned long gp_seq),
314 
315 	TP_ARGS(rcuname, pid, gp_seq),
316 
317 	TP_STRUCT__entry(
318 		__field(const char *, rcuname)
319 		__field(long, gp_seq)
320 		__field(int, pid)
321 	),
322 
323 	TP_fast_assign(
324 		__entry->rcuname = rcuname;
325 		__entry->gp_seq = (long)gp_seq;
326 		__entry->pid = pid;
327 	),
328 
329 	TP_printk("%s %ld %d",
330 		  __entry->rcuname, __entry->gp_seq, __entry->pid)
331 );
332 
333 /*
334  * Tracepoint for tasks that blocked within a given preemptible-RCU
335  * read-side critical section exiting that critical section.  Track the
336  * type of RCU (which one day might include SRCU) and the task's PID.
337  */
338 TRACE_EVENT_RCU(rcu_unlock_preempted_task,
339 
340 	TP_PROTO(const char *rcuname, unsigned long gp_seq, int pid),
341 
342 	TP_ARGS(rcuname, gp_seq, pid),
343 
344 	TP_STRUCT__entry(
345 		__field(const char *, rcuname)
346 		__field(long, gp_seq)
347 		__field(int, pid)
348 	),
349 
350 	TP_fast_assign(
351 		__entry->rcuname = rcuname;
352 		__entry->gp_seq = (long)gp_seq;
353 		__entry->pid = pid;
354 	),
355 
356 	TP_printk("%s %ld %d", __entry->rcuname, __entry->gp_seq, __entry->pid)
357 );
358 
359 /*
360  * Tracepoint for quiescent-state-reporting events.  These are
361  * distinguished by the type of RCU, the grace-period number, the
362  * mask of quiescent lower-level entities, the rcu_node structure level,
363  * the starting and ending CPU covered by the rcu_node structure, and
364  * whether there are any blocked tasks blocking the current grace period.
365  * All but the type of RCU are extracted from the rcu_node structure.
366  */
367 TRACE_EVENT_RCU(rcu_quiescent_state_report,
368 
369 	TP_PROTO(const char *rcuname, unsigned long gp_seq,
370 		 unsigned long mask, unsigned long qsmask,
371 		 u8 level, int grplo, int grphi, int gp_tasks),
372 
373 	TP_ARGS(rcuname, gp_seq, mask, qsmask, level, grplo, grphi, gp_tasks),
374 
375 	TP_STRUCT__entry(
376 		__field(const char *, rcuname)
377 		__field(long, gp_seq)
378 		__field(unsigned long, mask)
379 		__field(unsigned long, qsmask)
380 		__field(u8, level)
381 		__field(int, grplo)
382 		__field(int, grphi)
383 		__field(u8, gp_tasks)
384 	),
385 
386 	TP_fast_assign(
387 		__entry->rcuname = rcuname;
388 		__entry->gp_seq = (long)gp_seq;
389 		__entry->mask = mask;
390 		__entry->qsmask = qsmask;
391 		__entry->level = level;
392 		__entry->grplo = grplo;
393 		__entry->grphi = grphi;
394 		__entry->gp_tasks = gp_tasks;
395 	),
396 
397 	TP_printk("%s %ld %lx>%lx %u %d %d %u",
398 		  __entry->rcuname, __entry->gp_seq,
399 		  __entry->mask, __entry->qsmask, __entry->level,
400 		  __entry->grplo, __entry->grphi, __entry->gp_tasks)
401 );
402 
403 /*
404  * Tracepoint for quiescent states detected by force_quiescent_state().
405  * These trace events include the type of RCU, the grace-period number
406  * that was blocked by the CPU, the CPU itself, and the type of quiescent
407  * state, which can be "dti" for dyntick-idle mode or "kick" when kicking
408  * a CPU that has been in dyntick-idle mode for too long.
409  */
410 TRACE_EVENT_RCU(rcu_fqs,
411 
412 	TP_PROTO(const char *rcuname, unsigned long gp_seq, int cpu, const char *qsevent),
413 
414 	TP_ARGS(rcuname, gp_seq, cpu, qsevent),
415 
416 	TP_STRUCT__entry(
417 		__field(const char *, rcuname)
418 		__field(long, gp_seq)
419 		__field(int, cpu)
420 		__field(const char *, qsevent)
421 	),
422 
423 	TP_fast_assign(
424 		__entry->rcuname = rcuname;
425 		__entry->gp_seq = (long)gp_seq;
426 		__entry->cpu = cpu;
427 		__entry->qsevent = qsevent;
428 	),
429 
430 	TP_printk("%s %ld %d %s",
431 		  __entry->rcuname, __entry->gp_seq,
432 		  __entry->cpu, __entry->qsevent)
433 );
434 
435 /*
436  * Tracepoint for RCU stall events. Takes a string identifying the RCU flavor
437  * and a string identifying which function detected the RCU stall as follows:
438  *
439  *	"StallDetected": Scheduler-tick detects other CPU's stalls.
440  *	"SelfDetected": Scheduler-tick detects a current CPU's stall.
441  *	"ExpeditedStall": Expedited grace period detects stalls.
442  */
443 TRACE_EVENT(rcu_stall_warning,
444 
445 	TP_PROTO(const char *rcuname, const char *msg),
446 
447 	TP_ARGS(rcuname, msg),
448 
449 	TP_STRUCT__entry(
450 		__field(const char *, rcuname)
451 		__field(const char *, msg)
452 	),
453 
454 	TP_fast_assign(
455 		__entry->rcuname = rcuname;
456 		__entry->msg = msg;
457 	),
458 
459 	TP_printk("%s %s",
460 		  __entry->rcuname, __entry->msg)
461 );
462 
463 #endif /* #if defined(CONFIG_TREE_RCU) */
464 
465 /*
466  * Tracepoint for dyntick-idle entry/exit events.  These take 2 strings
467  * as argument:
468  * polarity: "Start", "End", "StillNonIdle" for entering, exiting or still not
469  *            being in dyntick-idle mode.
470  * context: "USER" or "IDLE" or "IRQ".
471  * NMIs nested in IRQs are inferred with dynticks_nesting > 1 in IRQ context.
472  *
473  * These events also take a pair of numbers, which indicate the nesting
474  * depth before and after the event of interest, and a third number that is
475  * the ->dynticks counter.  Note that task-related and interrupt-related
476  * events use two separate counters, and that the "++=" and "--=" events
477  * for irq/NMI will change the counter by two, otherwise by one.
478  */
479 TRACE_EVENT_RCU(rcu_dyntick,
480 
481 	TP_PROTO(const char *polarity, long oldnesting, long newnesting, int dynticks),
482 
483 	TP_ARGS(polarity, oldnesting, newnesting, dynticks),
484 
485 	TP_STRUCT__entry(
486 		__field(const char *, polarity)
487 		__field(long, oldnesting)
488 		__field(long, newnesting)
489 		__field(int, dynticks)
490 	),
491 
492 	TP_fast_assign(
493 		__entry->polarity = polarity;
494 		__entry->oldnesting = oldnesting;
495 		__entry->newnesting = newnesting;
496 		__entry->dynticks = dynticks;
497 	),
498 
499 	TP_printk("%s %lx %lx %#3x", __entry->polarity,
500 		  __entry->oldnesting, __entry->newnesting,
501 		  __entry->dynticks & 0xfff)
502 );
503 
504 /*
505  * Tracepoint for the registration of a single RCU callback function.
506  * The first argument is the type of RCU, the second argument is
507  * a pointer to the RCU callback itself, the third element is the
508  * number of lazy callbacks queued, and the fourth element is the
509  * total number of callbacks queued.
510  */
511 TRACE_EVENT_RCU(rcu_callback,
512 
513 	TP_PROTO(const char *rcuname, struct rcu_head *rhp, long qlen),
514 
515 	TP_ARGS(rcuname, rhp, qlen),
516 
517 	TP_STRUCT__entry(
518 		__field(const char *, rcuname)
519 		__field(void *, rhp)
520 		__field(void *, func)
521 		__field(long, qlen)
522 	),
523 
524 	TP_fast_assign(
525 		__entry->rcuname = rcuname;
526 		__entry->rhp = rhp;
527 		__entry->func = rhp->func;
528 		__entry->qlen = qlen;
529 	),
530 
531 	TP_printk("%s rhp=%p func=%ps %ld",
532 		  __entry->rcuname, __entry->rhp, __entry->func,
533 		  __entry->qlen)
534 );
535 
536 /*
537  * Tracepoint for the registration of a single RCU callback of the special
538  * kvfree() form.  The first argument is the RCU type, the second argument
539  * is a pointer to the RCU callback, the third argument is the offset
540  * of the callback within the enclosing RCU-protected data structure,
541  * the fourth argument is the number of lazy callbacks queued, and the
542  * fifth argument is the total number of callbacks queued.
543  */
544 TRACE_EVENT_RCU(rcu_kvfree_callback,
545 
546 	TP_PROTO(const char *rcuname, struct rcu_head *rhp, unsigned long offset,
547 		 long qlen),
548 
549 	TP_ARGS(rcuname, rhp, offset, qlen),
550 
551 	TP_STRUCT__entry(
552 		__field(const char *, rcuname)
553 		__field(void *, rhp)
554 		__field(unsigned long, offset)
555 		__field(long, qlen)
556 	),
557 
558 	TP_fast_assign(
559 		__entry->rcuname = rcuname;
560 		__entry->rhp = rhp;
561 		__entry->offset = offset;
562 		__entry->qlen = qlen;
563 	),
564 
565 	TP_printk("%s rhp=%p func=%ld %ld",
566 		  __entry->rcuname, __entry->rhp, __entry->offset,
567 		  __entry->qlen)
568 );
569 
570 /*
571  * Tracepoint for marking the beginning rcu_do_batch, performed to start
572  * RCU callback invocation.  The first argument is the RCU flavor,
573  * the second is the number of lazy callbacks queued, the third is
574  * the total number of callbacks queued, and the fourth argument is
575  * the current RCU-callback batch limit.
576  */
577 TRACE_EVENT_RCU(rcu_batch_start,
578 
579 	TP_PROTO(const char *rcuname, long qlen, long blimit),
580 
581 	TP_ARGS(rcuname, qlen, blimit),
582 
583 	TP_STRUCT__entry(
584 		__field(const char *, rcuname)
585 		__field(long, qlen)
586 		__field(long, blimit)
587 	),
588 
589 	TP_fast_assign(
590 		__entry->rcuname = rcuname;
591 		__entry->qlen = qlen;
592 		__entry->blimit = blimit;
593 	),
594 
595 	TP_printk("%s CBs=%ld bl=%ld",
596 		  __entry->rcuname, __entry->qlen, __entry->blimit)
597 );
598 
599 /*
600  * Tracepoint for the invocation of a single RCU callback function.
601  * The first argument is the type of RCU, and the second argument is
602  * a pointer to the RCU callback itself.
603  */
604 TRACE_EVENT_RCU(rcu_invoke_callback,
605 
606 	TP_PROTO(const char *rcuname, struct rcu_head *rhp),
607 
608 	TP_ARGS(rcuname, rhp),
609 
610 	TP_STRUCT__entry(
611 		__field(const char *, rcuname)
612 		__field(void *, rhp)
613 		__field(void *, func)
614 	),
615 
616 	TP_fast_assign(
617 		__entry->rcuname = rcuname;
618 		__entry->rhp = rhp;
619 		__entry->func = rhp->func;
620 	),
621 
622 	TP_printk("%s rhp=%p func=%ps",
623 		  __entry->rcuname, __entry->rhp, __entry->func)
624 );
625 
626 /*
627  * Tracepoint for the invocation of a single RCU callback of the special
628  * kvfree() form.  The first argument is the RCU flavor, the second
629  * argument is a pointer to the RCU callback, and the third argument
630  * is the offset of the callback within the enclosing RCU-protected
631  * data structure.
632  */
633 TRACE_EVENT_RCU(rcu_invoke_kvfree_callback,
634 
635 	TP_PROTO(const char *rcuname, struct rcu_head *rhp, unsigned long offset),
636 
637 	TP_ARGS(rcuname, rhp, offset),
638 
639 	TP_STRUCT__entry(
640 		__field(const char *, rcuname)
641 		__field(void *, rhp)
642 		__field(unsigned long, offset)
643 	),
644 
645 	TP_fast_assign(
646 		__entry->rcuname = rcuname;
647 		__entry->rhp = rhp;
648 		__entry->offset	= offset;
649 	),
650 
651 	TP_printk("%s rhp=%p func=%ld",
652 		  __entry->rcuname, __entry->rhp, __entry->offset)
653 );
654 
655 /*
656  * Tracepoint for the invocation of a single RCU callback of the special
657  * kfree_bulk() form. The first argument is the RCU flavor, the second
658  * argument is a number of elements in array to free, the third is an
659  * address of the array holding nr_records entries.
660  */
661 TRACE_EVENT_RCU(rcu_invoke_kfree_bulk_callback,
662 
663 	TP_PROTO(const char *rcuname, unsigned long nr_records, void **p),
664 
665 	TP_ARGS(rcuname, nr_records, p),
666 
667 	TP_STRUCT__entry(
668 		__field(const char *, rcuname)
669 		__field(unsigned long, nr_records)
670 		__field(void **, p)
671 	),
672 
673 	TP_fast_assign(
674 		__entry->rcuname = rcuname;
675 		__entry->nr_records = nr_records;
676 		__entry->p = p;
677 	),
678 
679 	TP_printk("%s bulk=0x%p nr_records=%lu",
680 		__entry->rcuname, __entry->p, __entry->nr_records)
681 );
682 
683 /*
684  * Tracepoint for exiting rcu_do_batch after RCU callbacks have been
685  * invoked.  The first argument is the name of the RCU flavor,
686  * the second argument is number of callbacks actually invoked,
687  * the third argument (cb) is whether or not any of the callbacks that
688  * were ready to invoke at the beginning of this batch are still
689  * queued, the fourth argument (nr) is the return value of need_resched(),
690  * the fifth argument (iit) is 1 if the current task is the idle task,
691  * and the sixth argument (risk) is the return value from
692  * rcu_is_callbacks_kthread().
693  */
694 TRACE_EVENT_RCU(rcu_batch_end,
695 
696 	TP_PROTO(const char *rcuname, int callbacks_invoked,
697 		 char cb, char nr, char iit, char risk),
698 
699 	TP_ARGS(rcuname, callbacks_invoked, cb, nr, iit, risk),
700 
701 	TP_STRUCT__entry(
702 		__field(const char *, rcuname)
703 		__field(int, callbacks_invoked)
704 		__field(char, cb)
705 		__field(char, nr)
706 		__field(char, iit)
707 		__field(char, risk)
708 	),
709 
710 	TP_fast_assign(
711 		__entry->rcuname = rcuname;
712 		__entry->callbacks_invoked = callbacks_invoked;
713 		__entry->cb = cb;
714 		__entry->nr = nr;
715 		__entry->iit = iit;
716 		__entry->risk = risk;
717 	),
718 
719 	TP_printk("%s CBs-invoked=%d idle=%c%c%c%c",
720 		  __entry->rcuname, __entry->callbacks_invoked,
721 		  __entry->cb ? 'C' : '.',
722 		  __entry->nr ? 'S' : '.',
723 		  __entry->iit ? 'I' : '.',
724 		  __entry->risk ? 'R' : '.')
725 );
726 
727 /*
728  * Tracepoint for rcutorture readers.  The first argument is the name
729  * of the RCU flavor from rcutorture's viewpoint and the second argument
730  * is the callback address.  The third argument is the start time in
731  * seconds, and the last two arguments are the grace period numbers
732  * at the beginning and end of the read, respectively.  Note that the
733  * callback address can be NULL.
734  */
735 #define RCUTORTURENAME_LEN 8
736 TRACE_EVENT_RCU(rcu_torture_read,
737 
738 	TP_PROTO(const char *rcutorturename, struct rcu_head *rhp,
739 		 unsigned long secs, unsigned long c_old, unsigned long c),
740 
741 	TP_ARGS(rcutorturename, rhp, secs, c_old, c),
742 
743 	TP_STRUCT__entry(
744 		__array(char, rcutorturename, RCUTORTURENAME_LEN)
745 		__field(struct rcu_head *, rhp)
746 		__field(unsigned long, secs)
747 		__field(unsigned long, c_old)
748 		__field(unsigned long, c)
749 	),
750 
751 	TP_fast_assign(
752 		strncpy(__entry->rcutorturename, rcutorturename,
753 			RCUTORTURENAME_LEN);
754 		__entry->rcutorturename[RCUTORTURENAME_LEN - 1] = 0;
755 		__entry->rhp = rhp;
756 		__entry->secs = secs;
757 		__entry->c_old = c_old;
758 		__entry->c = c;
759 	),
760 
761 	TP_printk("%s torture read %p %luus c: %lu %lu",
762 		  __entry->rcutorturename, __entry->rhp,
763 		  __entry->secs, __entry->c_old, __entry->c)
764 );
765 
766 /*
767  * Tracepoint for rcu_barrier() execution.  The string "s" describes
768  * the rcu_barrier phase:
769  *	"Begin": rcu_barrier() started.
770  *	"EarlyExit": rcu_barrier() piggybacked, thus early exit.
771  *	"Inc1": rcu_barrier() piggyback check counter incremented.
772  *	"OfflineNoCBQ": rcu_barrier() found offline no-CBs CPU with callbacks.
773  *	"OnlineQ": rcu_barrier() found online CPU with callbacks.
774  *	"OnlineNQ": rcu_barrier() found online CPU, no callbacks.
775  *	"IRQ": An rcu_barrier_callback() callback posted on remote CPU.
776  *	"IRQNQ": An rcu_barrier_callback() callback found no callbacks.
777  *	"CB": An rcu_barrier_callback() invoked a callback, not the last.
778  *	"LastCB": An rcu_barrier_callback() invoked the last callback.
779  *	"Inc2": rcu_barrier() piggyback check counter incremented.
780  * The "cpu" argument is the CPU or -1 if meaningless, the "cnt" argument
781  * is the count of remaining callbacks, and "done" is the piggybacking count.
782  */
783 TRACE_EVENT_RCU(rcu_barrier,
784 
785 	TP_PROTO(const char *rcuname, const char *s, int cpu, int cnt, unsigned long done),
786 
787 	TP_ARGS(rcuname, s, cpu, cnt, done),
788 
789 	TP_STRUCT__entry(
790 		__field(const char *, rcuname)
791 		__field(const char *, s)
792 		__field(int, cpu)
793 		__field(int, cnt)
794 		__field(unsigned long, done)
795 	),
796 
797 	TP_fast_assign(
798 		__entry->rcuname = rcuname;
799 		__entry->s = s;
800 		__entry->cpu = cpu;
801 		__entry->cnt = cnt;
802 		__entry->done = done;
803 	),
804 
805 	TP_printk("%s %s cpu %d remaining %d # %lu",
806 		  __entry->rcuname, __entry->s, __entry->cpu, __entry->cnt,
807 		  __entry->done)
808 );
809 
810 #endif /* _TRACE_RCU_H */
811 
812 /* This part must be outside protection */
813 #include <trace/define_trace.h>
814