1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 /* CacheFiles tracepoints
4 * Copyright (C) 2021 Red Hat, Inc. All Rights Reserved.
8 #define TRACE_SYSTEM cachefiles
10 #if !defined(_TRACE_CACHEFILES_H) || defined(TRACE_HEADER_MULTI_READ)
11 #define _TRACE_CACHEFILES_H
13 #include <linux/tracepoint.h>
16 * Define enums for tracing information.
18 #ifndef __CACHEFILES_DECLARE_TRACE_ENUMS_ONCE_ONLY
19 #define __CACHEFILES_DECLARE_TRACE_ENUMS_ONCE_ONLY
21 enum cachefiles_obj_ref_trace {
22 cachefiles_obj_get_ioreq,
24 cachefiles_obj_put_alloc_fail,
25 cachefiles_obj_put_detach,
26 cachefiles_obj_put_ioreq,
27 cachefiles_obj_see_clean_commit,
28 cachefiles_obj_see_clean_delete,
29 cachefiles_obj_see_clean_drop_tmp,
30 cachefiles_obj_see_lookup_cookie,
31 cachefiles_obj_see_lookup_failed,
32 cachefiles_obj_see_withdraw_cookie,
33 cachefiles_obj_see_withdrawal,
34 cachefiles_obj_get_ondemand_fd,
35 cachefiles_obj_put_ondemand_fd,
38 enum fscache_why_object_killed {
39 FSCACHE_OBJECT_IS_STALE,
40 FSCACHE_OBJECT_IS_WEIRD,
41 FSCACHE_OBJECT_INVALIDATED,
42 FSCACHE_OBJECT_NO_SPACE,
43 FSCACHE_OBJECT_WAS_RETIRED,
44 FSCACHE_OBJECT_WAS_CULLED,
45 FSCACHE_VOLUME_IS_WEIRD,
48 enum cachefiles_coherency_trace {
49 cachefiles_coherency_check_aux,
50 cachefiles_coherency_check_content,
51 cachefiles_coherency_check_dirty,
52 cachefiles_coherency_check_len,
53 cachefiles_coherency_check_objsize,
54 cachefiles_coherency_check_ok,
55 cachefiles_coherency_check_type,
56 cachefiles_coherency_check_xattr,
57 cachefiles_coherency_set_fail,
58 cachefiles_coherency_set_ok,
59 cachefiles_coherency_vol_check_cmp,
60 cachefiles_coherency_vol_check_ok,
61 cachefiles_coherency_vol_check_resv,
62 cachefiles_coherency_vol_check_xattr,
63 cachefiles_coherency_vol_set_fail,
64 cachefiles_coherency_vol_set_ok,
67 enum cachefiles_trunc_trace {
68 cachefiles_trunc_dio_adjust,
69 cachefiles_trunc_expand_tmpfile,
70 cachefiles_trunc_shrink,
73 enum cachefiles_prepare_read_trace {
74 cachefiles_trace_read_after_eof,
75 cachefiles_trace_read_found_hole,
76 cachefiles_trace_read_found_part,
77 cachefiles_trace_read_have_data,
78 cachefiles_trace_read_no_data,
79 cachefiles_trace_read_no_file,
80 cachefiles_trace_read_seek_error,
81 cachefiles_trace_read_seek_nxio,
84 enum cachefiles_error_trace {
85 cachefiles_trace_fallocate_error,
86 cachefiles_trace_getxattr_error,
87 cachefiles_trace_link_error,
88 cachefiles_trace_lookup_error,
89 cachefiles_trace_mkdir_error,
90 cachefiles_trace_notify_change_error,
91 cachefiles_trace_open_error,
92 cachefiles_trace_read_error,
93 cachefiles_trace_remxattr_error,
94 cachefiles_trace_rename_error,
95 cachefiles_trace_seek_error,
96 cachefiles_trace_setxattr_error,
97 cachefiles_trace_statfs_error,
98 cachefiles_trace_tmpfile_error,
99 cachefiles_trace_trunc_error,
100 cachefiles_trace_unlink_error,
101 cachefiles_trace_write_error,
107 * Define enum -> string mappings for display.
109 #define cachefiles_obj_kill_traces \
110 EM(FSCACHE_OBJECT_IS_STALE, "stale") \
111 EM(FSCACHE_OBJECT_IS_WEIRD, "weird") \
112 EM(FSCACHE_OBJECT_INVALIDATED, "inval") \
113 EM(FSCACHE_OBJECT_NO_SPACE, "no_space") \
114 EM(FSCACHE_OBJECT_WAS_RETIRED, "was_retired") \
115 EM(FSCACHE_OBJECT_WAS_CULLED, "was_culled") \
116 E_(FSCACHE_VOLUME_IS_WEIRD, "volume_weird")
118 #define cachefiles_obj_ref_traces \
119 EM(cachefiles_obj_get_ioreq, "GET ioreq") \
120 EM(cachefiles_obj_new, "NEW obj") \
121 EM(cachefiles_obj_put_alloc_fail, "PUT alloc_fail") \
122 EM(cachefiles_obj_put_detach, "PUT detach") \
123 EM(cachefiles_obj_put_ioreq, "PUT ioreq") \
124 EM(cachefiles_obj_see_clean_commit, "SEE clean_commit") \
125 EM(cachefiles_obj_see_clean_delete, "SEE clean_delete") \
126 EM(cachefiles_obj_see_clean_drop_tmp, "SEE clean_drop_tmp") \
127 EM(cachefiles_obj_see_lookup_cookie, "SEE lookup_cookie") \
128 EM(cachefiles_obj_see_lookup_failed, "SEE lookup_failed") \
129 EM(cachefiles_obj_see_withdraw_cookie, "SEE withdraw_cookie") \
130 E_(cachefiles_obj_see_withdrawal, "SEE withdrawal")
132 #define cachefiles_coherency_traces \
133 EM(cachefiles_coherency_check_aux, "BAD aux ") \
134 EM(cachefiles_coherency_check_content, "BAD cont") \
135 EM(cachefiles_coherency_check_dirty, "BAD dirt") \
136 EM(cachefiles_coherency_check_len, "BAD len ") \
137 EM(cachefiles_coherency_check_objsize, "BAD osiz") \
138 EM(cachefiles_coherency_check_ok, "OK ") \
139 EM(cachefiles_coherency_check_type, "BAD type") \
140 EM(cachefiles_coherency_check_xattr, "BAD xatt") \
141 EM(cachefiles_coherency_set_fail, "SET fail") \
142 EM(cachefiles_coherency_set_ok, "SET ok ") \
143 EM(cachefiles_coherency_vol_check_cmp, "VOL BAD cmp ") \
144 EM(cachefiles_coherency_vol_check_ok, "VOL OK ") \
145 EM(cachefiles_coherency_vol_check_resv, "VOL BAD resv") \
146 EM(cachefiles_coherency_vol_check_xattr,"VOL BAD xatt") \
147 EM(cachefiles_coherency_vol_set_fail, "VOL SET fail") \
148 E_(cachefiles_coherency_vol_set_ok, "VOL SET ok ")
150 #define cachefiles_trunc_traces \
151 EM(cachefiles_trunc_dio_adjust, "DIOADJ") \
152 EM(cachefiles_trunc_expand_tmpfile, "EXPTMP") \
153 E_(cachefiles_trunc_shrink, "SHRINK")
155 #define cachefiles_prepare_read_traces \
156 EM(cachefiles_trace_read_after_eof, "after-eof ") \
157 EM(cachefiles_trace_read_found_hole, "found-hole") \
158 EM(cachefiles_trace_read_found_part, "found-part") \
159 EM(cachefiles_trace_read_have_data, "have-data ") \
160 EM(cachefiles_trace_read_no_data, "no-data ") \
161 EM(cachefiles_trace_read_no_file, "no-file ") \
162 EM(cachefiles_trace_read_seek_error, "seek-error") \
163 E_(cachefiles_trace_read_seek_nxio, "seek-enxio")
165 #define cachefiles_error_traces \
166 EM(cachefiles_trace_fallocate_error, "fallocate") \
167 EM(cachefiles_trace_getxattr_error, "getxattr") \
168 EM(cachefiles_trace_link_error, "link") \
169 EM(cachefiles_trace_lookup_error, "lookup") \
170 EM(cachefiles_trace_mkdir_error, "mkdir") \
171 EM(cachefiles_trace_notify_change_error, "notify_change") \
172 EM(cachefiles_trace_open_error, "open") \
173 EM(cachefiles_trace_read_error, "read") \
174 EM(cachefiles_trace_remxattr_error, "remxattr") \
175 EM(cachefiles_trace_rename_error, "rename") \
176 EM(cachefiles_trace_seek_error, "seek") \
177 EM(cachefiles_trace_setxattr_error, "setxattr") \
178 EM(cachefiles_trace_statfs_error, "statfs") \
179 EM(cachefiles_trace_tmpfile_error, "tmpfile") \
180 EM(cachefiles_trace_trunc_error, "trunc") \
181 EM(cachefiles_trace_unlink_error, "unlink") \
182 E_(cachefiles_trace_write_error, "write")
186 * Export enum symbols via userspace.
190 #define EM(a, b) TRACE_DEFINE_ENUM(a);
191 #define E_(a, b) TRACE_DEFINE_ENUM(a);
193 cachefiles_obj_kill_traces;
194 cachefiles_obj_ref_traces;
195 cachefiles_coherency_traces;
196 cachefiles_trunc_traces;
197 cachefiles_prepare_read_traces;
198 cachefiles_error_traces;
201 * Now redefine the EM() and E_() macros to map the enums to the strings that
202 * will be printed in the output.
206 #define EM(a, b) { a, b },
207 #define E_(a, b) { a, b }
210 TRACE_EVENT(cachefiles_ref,
211 TP_PROTO(unsigned int object_debug_id,
212 unsigned int cookie_debug_id,
214 enum cachefiles_obj_ref_trace why),
216 TP_ARGS(object_debug_id, cookie_debug_id, usage, why),
218 /* Note that obj may be NULL */
220 __field(unsigned int, obj )
221 __field(unsigned int, cookie )
222 __field(enum cachefiles_obj_ref_trace, why )
227 __entry->obj = object_debug_id;
228 __entry->cookie = cookie_debug_id;
229 __entry->usage = usage;
233 TP_printk("c=%08x o=%08x u=%d %s",
234 __entry->cookie, __entry->obj, __entry->usage,
235 __print_symbolic(__entry->why, cachefiles_obj_ref_traces))
238 TRACE_EVENT(cachefiles_lookup,
239 TP_PROTO(struct cachefiles_object *obj,
243 TP_ARGS(obj, dir, de),
246 __field(unsigned int, obj )
247 __field(short, error )
248 __field(unsigned long, dino )
249 __field(unsigned long, ino )
253 __entry->obj = obj ? obj->debug_id : 0;
254 __entry->dino = d_backing_inode(dir)->i_ino;
255 __entry->ino = (!IS_ERR(de) && d_backing_inode(de) ?
256 d_backing_inode(de)->i_ino : 0);
257 __entry->error = IS_ERR(de) ? PTR_ERR(de) : 0;
260 TP_printk("o=%08x dB=%lx B=%lx e=%d",
261 __entry->obj, __entry->dino, __entry->ino, __entry->error)
264 TRACE_EVENT(cachefiles_mkdir,
265 TP_PROTO(struct dentry *dir, struct dentry *subdir),
267 TP_ARGS(dir, subdir),
270 __field(unsigned int, dir )
271 __field(unsigned int, subdir )
275 __entry->dir = d_backing_inode(dir)->i_ino;
276 __entry->subdir = d_backing_inode(subdir)->i_ino;
279 TP_printk("dB=%x sB=%x",
284 TRACE_EVENT(cachefiles_tmpfile,
285 TP_PROTO(struct cachefiles_object *obj, struct inode *backer),
287 TP_ARGS(obj, backer),
290 __field(unsigned int, obj )
291 __field(unsigned int, backer )
295 __entry->obj = obj->debug_id;
296 __entry->backer = backer->i_ino;
299 TP_printk("o=%08x B=%x",
304 TRACE_EVENT(cachefiles_link,
305 TP_PROTO(struct cachefiles_object *obj, struct inode *backer),
307 TP_ARGS(obj, backer),
310 __field(unsigned int, obj )
311 __field(unsigned int, backer )
315 __entry->obj = obj->debug_id;
316 __entry->backer = backer->i_ino;
319 TP_printk("o=%08x B=%x",
324 TRACE_EVENT(cachefiles_unlink,
325 TP_PROTO(struct cachefiles_object *obj,
327 enum fscache_why_object_killed why),
329 TP_ARGS(obj, ino, why),
331 /* Note that obj may be NULL */
333 __field(unsigned int, obj )
334 __field(unsigned int, ino )
335 __field(enum fscache_why_object_killed, why )
339 __entry->obj = obj ? obj->debug_id : UINT_MAX;
344 TP_printk("o=%08x B=%x w=%s",
345 __entry->obj, __entry->ino,
346 __print_symbolic(__entry->why, cachefiles_obj_kill_traces))
349 TRACE_EVENT(cachefiles_rename,
350 TP_PROTO(struct cachefiles_object *obj,
352 enum fscache_why_object_killed why),
354 TP_ARGS(obj, ino, why),
356 /* Note that obj may be NULL */
358 __field(unsigned int, obj )
359 __field(unsigned int, ino )
360 __field(enum fscache_why_object_killed, why )
364 __entry->obj = obj ? obj->debug_id : UINT_MAX;
369 TP_printk("o=%08x B=%x w=%s",
370 __entry->obj, __entry->ino,
371 __print_symbolic(__entry->why, cachefiles_obj_kill_traces))
374 TRACE_EVENT(cachefiles_coherency,
375 TP_PROTO(struct cachefiles_object *obj,
377 enum cachefiles_content content,
378 enum cachefiles_coherency_trace why),
380 TP_ARGS(obj, ino, content, why),
382 /* Note that obj may be NULL */
384 __field(unsigned int, obj )
385 __field(enum cachefiles_coherency_trace, why )
386 __field(enum cachefiles_content, content )
391 __entry->obj = obj->debug_id;
393 __entry->content = content;
397 TP_printk("o=%08x %s B=%llx c=%u",
399 __print_symbolic(__entry->why, cachefiles_coherency_traces),
404 TRACE_EVENT(cachefiles_vol_coherency,
405 TP_PROTO(struct cachefiles_volume *volume,
407 enum cachefiles_coherency_trace why),
409 TP_ARGS(volume, ino, why),
411 /* Note that obj may be NULL */
413 __field(unsigned int, vol )
414 __field(enum cachefiles_coherency_trace, why )
419 __entry->vol = volume->vcookie->debug_id;
424 TP_printk("V=%08x %s B=%llx",
426 __print_symbolic(__entry->why, cachefiles_coherency_traces),
430 TRACE_EVENT(cachefiles_prep_read,
431 TP_PROTO(struct netfs_io_subrequest *sreq,
432 enum netfs_io_source source,
433 enum cachefiles_prepare_read_trace why,
436 TP_ARGS(sreq, source, why, cache_inode),
439 __field(unsigned int, rreq )
440 __field(unsigned short, index )
441 __field(unsigned short, flags )
442 __field(enum netfs_io_source, source )
443 __field(enum cachefiles_prepare_read_trace, why )
444 __field(size_t, len )
445 __field(loff_t, start )
446 __field(unsigned int, netfs_inode )
447 __field(unsigned int, cache_inode )
451 __entry->rreq = sreq->rreq->debug_id;
452 __entry->index = sreq->debug_index;
453 __entry->flags = sreq->flags;
454 __entry->source = source;
456 __entry->len = sreq->len;
457 __entry->start = sreq->start;
458 __entry->netfs_inode = sreq->rreq->inode->i_ino;
459 __entry->cache_inode = cache_inode;
462 TP_printk("R=%08x[%u] %s %s f=%02x s=%llx %zx ni=%x B=%x",
463 __entry->rreq, __entry->index,
464 __print_symbolic(__entry->source, netfs_sreq_sources),
465 __print_symbolic(__entry->why, cachefiles_prepare_read_traces),
467 __entry->start, __entry->len,
468 __entry->netfs_inode, __entry->cache_inode)
471 TRACE_EVENT(cachefiles_read,
472 TP_PROTO(struct cachefiles_object *obj,
473 struct inode *backer,
477 TP_ARGS(obj, backer, start, len),
480 __field(unsigned int, obj )
481 __field(unsigned int, backer )
482 __field(size_t, len )
483 __field(loff_t, start )
487 __entry->obj = obj->debug_id;
488 __entry->backer = backer->i_ino;
489 __entry->start = start;
493 TP_printk("o=%08x B=%x s=%llx l=%zx",
500 TRACE_EVENT(cachefiles_write,
501 TP_PROTO(struct cachefiles_object *obj,
502 struct inode *backer,
506 TP_ARGS(obj, backer, start, len),
509 __field(unsigned int, obj )
510 __field(unsigned int, backer )
511 __field(size_t, len )
512 __field(loff_t, start )
516 __entry->obj = obj->debug_id;
517 __entry->backer = backer->i_ino;
518 __entry->start = start;
522 TP_printk("o=%08x B=%x s=%llx l=%zx",
529 TRACE_EVENT(cachefiles_trunc,
530 TP_PROTO(struct cachefiles_object *obj, struct inode *backer,
531 loff_t from, loff_t to, enum cachefiles_trunc_trace why),
533 TP_ARGS(obj, backer, from, to, why),
536 __field(unsigned int, obj )
537 __field(unsigned int, backer )
538 __field(enum cachefiles_trunc_trace, why )
539 __field(loff_t, from )
544 __entry->obj = obj->debug_id;
545 __entry->backer = backer->i_ino;
546 __entry->from = from;
551 TP_printk("o=%08x B=%x %s l=%llx->%llx",
554 __print_symbolic(__entry->why, cachefiles_trunc_traces),
559 TRACE_EVENT(cachefiles_mark_active,
560 TP_PROTO(struct cachefiles_object *obj,
561 struct inode *inode),
565 /* Note that obj may be NULL */
567 __field(unsigned int, obj )
568 __field(ino_t, inode )
572 __entry->obj = obj ? obj->debug_id : 0;
573 __entry->inode = inode->i_ino;
576 TP_printk("o=%08x B=%lx",
577 __entry->obj, __entry->inode)
580 TRACE_EVENT(cachefiles_mark_failed,
581 TP_PROTO(struct cachefiles_object *obj,
582 struct inode *inode),
586 /* Note that obj may be NULL */
588 __field(unsigned int, obj )
589 __field(ino_t, inode )
593 __entry->obj = obj ? obj->debug_id : 0;
594 __entry->inode = inode->i_ino;
597 TP_printk("o=%08x B=%lx",
598 __entry->obj, __entry->inode)
601 TRACE_EVENT(cachefiles_mark_inactive,
602 TP_PROTO(struct cachefiles_object *obj,
603 struct inode *inode),
607 /* Note that obj may be NULL */
609 __field(unsigned int, obj )
610 __field(ino_t, inode )
614 __entry->obj = obj ? obj->debug_id : 0;
615 __entry->inode = inode->i_ino;
618 TP_printk("o=%08x B=%lx",
619 __entry->obj, __entry->inode)
622 TRACE_EVENT(cachefiles_vfs_error,
623 TP_PROTO(struct cachefiles_object *obj, struct inode *backer,
624 int error, enum cachefiles_error_trace where),
626 TP_ARGS(obj, backer, error, where),
629 __field(unsigned int, obj )
630 __field(unsigned int, backer )
631 __field(enum cachefiles_error_trace, where )
632 __field(short, error )
636 __entry->obj = obj ? obj->debug_id : 0;
637 __entry->backer = backer->i_ino;
638 __entry->error = error;
639 __entry->where = where;
642 TP_printk("o=%08x B=%x %s e=%d",
645 __print_symbolic(__entry->where, cachefiles_error_traces),
649 TRACE_EVENT(cachefiles_io_error,
650 TP_PROTO(struct cachefiles_object *obj, struct inode *backer,
651 int error, enum cachefiles_error_trace where),
653 TP_ARGS(obj, backer, error, where),
656 __field(unsigned int, obj )
657 __field(unsigned int, backer )
658 __field(enum cachefiles_error_trace, where )
659 __field(short, error )
663 __entry->obj = obj ? obj->debug_id : 0;
664 __entry->backer = backer->i_ino;
665 __entry->error = error;
666 __entry->where = where;
669 TP_printk("o=%08x B=%x %s e=%d",
672 __print_symbolic(__entry->where, cachefiles_error_traces),
676 TRACE_EVENT(cachefiles_ondemand_open,
677 TP_PROTO(struct cachefiles_object *obj, struct cachefiles_msg *msg,
678 struct cachefiles_open *load),
680 TP_ARGS(obj, msg, load),
683 __field(unsigned int, obj )
684 __field(unsigned int, msg_id )
685 __field(unsigned int, object_id )
686 __field(unsigned int, fd )
687 __field(unsigned int, flags )
691 __entry->obj = obj ? obj->debug_id : 0;
692 __entry->msg_id = msg->msg_id;
693 __entry->object_id = msg->object_id;
694 __entry->fd = load->fd;
695 __entry->flags = load->flags;
698 TP_printk("o=%08x mid=%x oid=%x fd=%d f=%x",
706 TRACE_EVENT(cachefiles_ondemand_copen,
707 TP_PROTO(struct cachefiles_object *obj, unsigned int msg_id,
710 TP_ARGS(obj, msg_id, len),
713 __field(unsigned int, obj )
714 __field(unsigned int, msg_id )
719 __entry->obj = obj ? obj->debug_id : 0;
720 __entry->msg_id = msg_id;
724 TP_printk("o=%08x mid=%x l=%lx",
730 TRACE_EVENT(cachefiles_ondemand_close,
731 TP_PROTO(struct cachefiles_object *obj, struct cachefiles_msg *msg),
736 __field(unsigned int, obj )
737 __field(unsigned int, msg_id )
738 __field(unsigned int, object_id )
742 __entry->obj = obj ? obj->debug_id : 0;
743 __entry->msg_id = msg->msg_id;
744 __entry->object_id = msg->object_id;
747 TP_printk("o=%08x mid=%x oid=%x",
753 TRACE_EVENT(cachefiles_ondemand_read,
754 TP_PROTO(struct cachefiles_object *obj, struct cachefiles_msg *msg,
755 struct cachefiles_read *load),
757 TP_ARGS(obj, msg, load),
760 __field(unsigned int, obj )
761 __field(unsigned int, msg_id )
762 __field(unsigned int, object_id )
763 __field(loff_t, start )
764 __field(size_t, len )
768 __entry->obj = obj ? obj->debug_id : 0;
769 __entry->msg_id = msg->msg_id;
770 __entry->object_id = msg->object_id;
771 __entry->start = load->off;
772 __entry->len = load->len;
775 TP_printk("o=%08x mid=%x oid=%x s=%llx l=%zx",
783 TRACE_EVENT(cachefiles_ondemand_cread,
784 TP_PROTO(struct cachefiles_object *obj, unsigned int msg_id),
786 TP_ARGS(obj, msg_id),
789 __field(unsigned int, obj )
790 __field(unsigned int, msg_id )
794 __entry->obj = obj ? obj->debug_id : 0;
795 __entry->msg_id = msg_id;
798 TP_printk("o=%08x mid=%x",
803 TRACE_EVENT(cachefiles_ondemand_fd_write,
804 TP_PROTO(struct cachefiles_object *obj, struct inode *backer,
805 loff_t start, size_t len),
807 TP_ARGS(obj, backer, start, len),
810 __field(unsigned int, obj )
811 __field(unsigned int, backer )
812 __field(loff_t, start )
813 __field(size_t, len )
817 __entry->obj = obj ? obj->debug_id : 0;
818 __entry->backer = backer->i_ino;
819 __entry->start = start;
823 TP_printk("o=%08x iB=%x s=%llx l=%zx",
830 TRACE_EVENT(cachefiles_ondemand_fd_release,
831 TP_PROTO(struct cachefiles_object *obj, int object_id),
833 TP_ARGS(obj, object_id),
836 __field(unsigned int, obj )
837 __field(unsigned int, object_id )
841 __entry->obj = obj ? obj->debug_id : 0;
842 __entry->object_id = object_id;
845 TP_printk("o=%08x oid=%x",
850 #endif /* _TRACE_CACHEFILES_H */
852 /* This part must be outside protection */
853 #include <trace/define_trace.h>