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