xref: /openbmc/linux/include/trace/events/rcu.h (revision ca48739e)
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 #endif /* #if defined(CONFIG_TREE_RCU) */
436 
437 /*
438  * Tracepoint for dyntick-idle entry/exit events.  These take 2 strings
439  * as argument:
440  * polarity: "Start", "End", "StillNonIdle" for entering, exiting or still not
441  *            being in dyntick-idle mode.
442  * context: "USER" or "IDLE" or "IRQ".
443  * NMIs nested in IRQs are inferred with dynticks_nesting > 1 in IRQ context.
444  *
445  * These events also take a pair of numbers, which indicate the nesting
446  * depth before and after the event of interest, and a third number that is
447  * the ->dynticks counter.  Note that task-related and interrupt-related
448  * events use two separate counters, and that the "++=" and "--=" events
449  * for irq/NMI will change the counter by two, otherwise by one.
450  */
451 TRACE_EVENT_RCU(rcu_dyntick,
452 
453 	TP_PROTO(const char *polarity, long oldnesting, long newnesting, int dynticks),
454 
455 	TP_ARGS(polarity, oldnesting, newnesting, dynticks),
456 
457 	TP_STRUCT__entry(
458 		__field(const char *, polarity)
459 		__field(long, oldnesting)
460 		__field(long, newnesting)
461 		__field(int, dynticks)
462 	),
463 
464 	TP_fast_assign(
465 		__entry->polarity = polarity;
466 		__entry->oldnesting = oldnesting;
467 		__entry->newnesting = newnesting;
468 		__entry->dynticks = dynticks;
469 	),
470 
471 	TP_printk("%s %lx %lx %#3x", __entry->polarity,
472 		  __entry->oldnesting, __entry->newnesting,
473 		  __entry->dynticks & 0xfff)
474 );
475 
476 /*
477  * Tracepoint for the registration of a single RCU callback function.
478  * The first argument is the type of RCU, the second argument is
479  * a pointer to the RCU callback itself, the third element is the
480  * number of lazy callbacks queued, and the fourth element is the
481  * total number of callbacks queued.
482  */
483 TRACE_EVENT_RCU(rcu_callback,
484 
485 	TP_PROTO(const char *rcuname, struct rcu_head *rhp, long qlen),
486 
487 	TP_ARGS(rcuname, rhp, qlen),
488 
489 	TP_STRUCT__entry(
490 		__field(const char *, rcuname)
491 		__field(void *, rhp)
492 		__field(void *, func)
493 		__field(long, qlen)
494 	),
495 
496 	TP_fast_assign(
497 		__entry->rcuname = rcuname;
498 		__entry->rhp = rhp;
499 		__entry->func = rhp->func;
500 		__entry->qlen = qlen;
501 	),
502 
503 	TP_printk("%s rhp=%p func=%ps %ld",
504 		  __entry->rcuname, __entry->rhp, __entry->func,
505 		  __entry->qlen)
506 );
507 
508 TRACE_EVENT_RCU(rcu_segcb_stats,
509 
510 		TP_PROTO(struct rcu_segcblist *rs, const char *ctx),
511 
512 		TP_ARGS(rs, ctx),
513 
514 		TP_STRUCT__entry(
515 			__field(const char *, ctx)
516 			__array(unsigned long, gp_seq, RCU_CBLIST_NSEGS)
517 			__array(long, seglen, RCU_CBLIST_NSEGS)
518 		),
519 
520 		TP_fast_assign(
521 			__entry->ctx = ctx;
522 			memcpy(__entry->seglen, rs->seglen, RCU_CBLIST_NSEGS * sizeof(long));
523 			memcpy(__entry->gp_seq, rs->gp_seq, RCU_CBLIST_NSEGS * sizeof(unsigned long));
524 
525 		),
526 
527 		TP_printk("%s seglen: (DONE=%ld, WAIT=%ld, NEXT_READY=%ld, NEXT=%ld) "
528 			  "gp_seq: (DONE=%lu, WAIT=%lu, NEXT_READY=%lu, NEXT=%lu)", __entry->ctx,
529 			  __entry->seglen[0], __entry->seglen[1], __entry->seglen[2], __entry->seglen[3],
530 			  __entry->gp_seq[0], __entry->gp_seq[1], __entry->gp_seq[2], __entry->gp_seq[3])
531 
532 );
533 
534 /*
535  * Tracepoint for the registration of a single RCU callback of the special
536  * kvfree() form.  The first argument is the RCU type, the second argument
537  * is a pointer to the RCU callback, the third argument is the offset
538  * of the callback within the enclosing RCU-protected data structure,
539  * the fourth argument is the number of lazy callbacks queued, and the
540  * fifth argument is the total number of callbacks queued.
541  */
542 TRACE_EVENT_RCU(rcu_kvfree_callback,
543 
544 	TP_PROTO(const char *rcuname, struct rcu_head *rhp, unsigned long offset,
545 		 long qlen),
546 
547 	TP_ARGS(rcuname, rhp, offset, qlen),
548 
549 	TP_STRUCT__entry(
550 		__field(const char *, rcuname)
551 		__field(void *, rhp)
552 		__field(unsigned long, offset)
553 		__field(long, qlen)
554 	),
555 
556 	TP_fast_assign(
557 		__entry->rcuname = rcuname;
558 		__entry->rhp = rhp;
559 		__entry->offset = offset;
560 		__entry->qlen = qlen;
561 	),
562 
563 	TP_printk("%s rhp=%p func=%ld %ld",
564 		  __entry->rcuname, __entry->rhp, __entry->offset,
565 		  __entry->qlen)
566 );
567 
568 /*
569  * Tracepoint for marking the beginning rcu_do_batch, performed to start
570  * RCU callback invocation.  The first argument is the RCU flavor,
571  * the second is the number of lazy callbacks queued, the third is
572  * the total number of callbacks queued, and the fourth argument is
573  * the current RCU-callback batch limit.
574  */
575 TRACE_EVENT_RCU(rcu_batch_start,
576 
577 	TP_PROTO(const char *rcuname, long qlen, long blimit),
578 
579 	TP_ARGS(rcuname, qlen, blimit),
580 
581 	TP_STRUCT__entry(
582 		__field(const char *, rcuname)
583 		__field(long, qlen)
584 		__field(long, blimit)
585 	),
586 
587 	TP_fast_assign(
588 		__entry->rcuname = rcuname;
589 		__entry->qlen = qlen;
590 		__entry->blimit = blimit;
591 	),
592 
593 	TP_printk("%s CBs=%ld bl=%ld",
594 		  __entry->rcuname, __entry->qlen, __entry->blimit)
595 );
596 
597 /*
598  * Tracepoint for the invocation of a single RCU callback function.
599  * The first argument is the type of RCU, and the second argument is
600  * a pointer to the RCU callback itself.
601  */
602 TRACE_EVENT_RCU(rcu_invoke_callback,
603 
604 	TP_PROTO(const char *rcuname, struct rcu_head *rhp),
605 
606 	TP_ARGS(rcuname, rhp),
607 
608 	TP_STRUCT__entry(
609 		__field(const char *, rcuname)
610 		__field(void *, rhp)
611 		__field(void *, func)
612 	),
613 
614 	TP_fast_assign(
615 		__entry->rcuname = rcuname;
616 		__entry->rhp = rhp;
617 		__entry->func = rhp->func;
618 	),
619 
620 	TP_printk("%s rhp=%p func=%ps",
621 		  __entry->rcuname, __entry->rhp, __entry->func)
622 );
623 
624 /*
625  * Tracepoint for the invocation of a single RCU callback of the special
626  * kvfree() form.  The first argument is the RCU flavor, the second
627  * argument is a pointer to the RCU callback, and the third argument
628  * is the offset of the callback within the enclosing RCU-protected
629  * data structure.
630  */
631 TRACE_EVENT_RCU(rcu_invoke_kvfree_callback,
632 
633 	TP_PROTO(const char *rcuname, struct rcu_head *rhp, unsigned long offset),
634 
635 	TP_ARGS(rcuname, rhp, offset),
636 
637 	TP_STRUCT__entry(
638 		__field(const char *, rcuname)
639 		__field(void *, rhp)
640 		__field(unsigned long, offset)
641 	),
642 
643 	TP_fast_assign(
644 		__entry->rcuname = rcuname;
645 		__entry->rhp = rhp;
646 		__entry->offset	= offset;
647 	),
648 
649 	TP_printk("%s rhp=%p func=%ld",
650 		  __entry->rcuname, __entry->rhp, __entry->offset)
651 );
652 
653 /*
654  * Tracepoint for the invocation of a single RCU callback of the special
655  * kfree_bulk() form. The first argument is the RCU flavor, the second
656  * argument is a number of elements in array to free, the third is an
657  * address of the array holding nr_records entries.
658  */
659 TRACE_EVENT_RCU(rcu_invoke_kfree_bulk_callback,
660 
661 	TP_PROTO(const char *rcuname, unsigned long nr_records, void **p),
662 
663 	TP_ARGS(rcuname, nr_records, p),
664 
665 	TP_STRUCT__entry(
666 		__field(const char *, rcuname)
667 		__field(unsigned long, nr_records)
668 		__field(void **, p)
669 	),
670 
671 	TP_fast_assign(
672 		__entry->rcuname = rcuname;
673 		__entry->nr_records = nr_records;
674 		__entry->p = p;
675 	),
676 
677 	TP_printk("%s bulk=0x%p nr_records=%lu",
678 		__entry->rcuname, __entry->p, __entry->nr_records)
679 );
680 
681 /*
682  * Tracepoint for exiting rcu_do_batch after RCU callbacks have been
683  * invoked.  The first argument is the name of the RCU flavor,
684  * the second argument is number of callbacks actually invoked,
685  * the third argument (cb) is whether or not any of the callbacks that
686  * were ready to invoke at the beginning of this batch are still
687  * queued, the fourth argument (nr) is the return value of need_resched(),
688  * the fifth argument (iit) is 1 if the current task is the idle task,
689  * and the sixth argument (risk) is the return value from
690  * rcu_is_callbacks_kthread().
691  */
692 TRACE_EVENT_RCU(rcu_batch_end,
693 
694 	TP_PROTO(const char *rcuname, int callbacks_invoked,
695 		 char cb, char nr, char iit, char risk),
696 
697 	TP_ARGS(rcuname, callbacks_invoked, cb, nr, iit, risk),
698 
699 	TP_STRUCT__entry(
700 		__field(const char *, rcuname)
701 		__field(int, callbacks_invoked)
702 		__field(char, cb)
703 		__field(char, nr)
704 		__field(char, iit)
705 		__field(char, risk)
706 	),
707 
708 	TP_fast_assign(
709 		__entry->rcuname = rcuname;
710 		__entry->callbacks_invoked = callbacks_invoked;
711 		__entry->cb = cb;
712 		__entry->nr = nr;
713 		__entry->iit = iit;
714 		__entry->risk = risk;
715 	),
716 
717 	TP_printk("%s CBs-invoked=%d idle=%c%c%c%c",
718 		  __entry->rcuname, __entry->callbacks_invoked,
719 		  __entry->cb ? 'C' : '.',
720 		  __entry->nr ? 'S' : '.',
721 		  __entry->iit ? 'I' : '.',
722 		  __entry->risk ? 'R' : '.')
723 );
724 
725 /*
726  * Tracepoint for rcutorture readers.  The first argument is the name
727  * of the RCU flavor from rcutorture's viewpoint and the second argument
728  * is the callback address.  The third argument is the start time in
729  * seconds, and the last two arguments are the grace period numbers
730  * at the beginning and end of the read, respectively.  Note that the
731  * callback address can be NULL.
732  */
733 #define RCUTORTURENAME_LEN 8
734 TRACE_EVENT_RCU(rcu_torture_read,
735 
736 	TP_PROTO(const char *rcutorturename, struct rcu_head *rhp,
737 		 unsigned long secs, unsigned long c_old, unsigned long c),
738 
739 	TP_ARGS(rcutorturename, rhp, secs, c_old, c),
740 
741 	TP_STRUCT__entry(
742 		__field(char, rcutorturename[RCUTORTURENAME_LEN])
743 		__field(struct rcu_head *, rhp)
744 		__field(unsigned long, secs)
745 		__field(unsigned long, c_old)
746 		__field(unsigned long, c)
747 	),
748 
749 	TP_fast_assign(
750 		strncpy(__entry->rcutorturename, rcutorturename,
751 			RCUTORTURENAME_LEN);
752 		__entry->rcutorturename[RCUTORTURENAME_LEN - 1] = 0;
753 		__entry->rhp = rhp;
754 		__entry->secs = secs;
755 		__entry->c_old = c_old;
756 		__entry->c = c;
757 	),
758 
759 	TP_printk("%s torture read %p %luus c: %lu %lu",
760 		  __entry->rcutorturename, __entry->rhp,
761 		  __entry->secs, __entry->c_old, __entry->c)
762 );
763 
764 /*
765  * Tracepoint for rcu_barrier() execution.  The string "s" describes
766  * the rcu_barrier phase:
767  *	"Begin": rcu_barrier() started.
768  *	"EarlyExit": rcu_barrier() piggybacked, thus early exit.
769  *	"Inc1": rcu_barrier() piggyback check counter incremented.
770  *	"OfflineNoCBQ": rcu_barrier() found offline no-CBs CPU with callbacks.
771  *	"OnlineQ": rcu_barrier() found online CPU with callbacks.
772  *	"OnlineNQ": rcu_barrier() found online CPU, no callbacks.
773  *	"IRQ": An rcu_barrier_callback() callback posted on remote CPU.
774  *	"IRQNQ": An rcu_barrier_callback() callback found no callbacks.
775  *	"CB": An rcu_barrier_callback() invoked a callback, not the last.
776  *	"LastCB": An rcu_barrier_callback() invoked the last callback.
777  *	"Inc2": rcu_barrier() piggyback check counter incremented.
778  * The "cpu" argument is the CPU or -1 if meaningless, the "cnt" argument
779  * is the count of remaining callbacks, and "done" is the piggybacking count.
780  */
781 TRACE_EVENT_RCU(rcu_barrier,
782 
783 	TP_PROTO(const char *rcuname, const char *s, int cpu, int cnt, unsigned long done),
784 
785 	TP_ARGS(rcuname, s, cpu, cnt, done),
786 
787 	TP_STRUCT__entry(
788 		__field(const char *, rcuname)
789 		__field(const char *, s)
790 		__field(int, cpu)
791 		__field(int, cnt)
792 		__field(unsigned long, done)
793 	),
794 
795 	TP_fast_assign(
796 		__entry->rcuname = rcuname;
797 		__entry->s = s;
798 		__entry->cpu = cpu;
799 		__entry->cnt = cnt;
800 		__entry->done = done;
801 	),
802 
803 	TP_printk("%s %s cpu %d remaining %d # %lu",
804 		  __entry->rcuname, __entry->s, __entry->cpu, __entry->cnt,
805 		  __entry->done)
806 );
807 
808 #endif /* _TRACE_RCU_H */
809 
810 /* This part must be outside protection */
811 #include <trace/define_trace.h>
812