1 // SPDX-License-Identifier: GPL-2.0
3 * trace_events_synth - synthetic trace events
5 * Copyright (C) 2015, 2020 Tom Zanussi <tom.zanussi@linux.intel.com>
8 #include <linux/module.h>
9 #include <linux/kallsyms.h>
10 #include <linux/security.h>
11 #include <linux/mutex.h>
12 #include <linux/slab.h>
13 #include <linux/stacktrace.h>
14 #include <linux/rculist.h>
15 #include <linux/tracefs.h>
17 /* for gfp flag names */
18 #include <linux/trace_events.h>
19 #include <trace/events/mmflags.h>
21 #include "trace_synth.h"
25 C(BAD_NAME, "Illegal name"), \
26 C(CMD_INCOMPLETE, "Incomplete command"), \
27 C(EVENT_EXISTS, "Event already exists"), \
28 C(TOO_MANY_FIELDS, "Too many fields"), \
29 C(INCOMPLETE_TYPE, "Incomplete type"), \
30 C(INVALID_TYPE, "Invalid type"), \
31 C(INVALID_FIELD, "Invalid field"), \
32 C(CMD_TOO_LONG, "Command too long"),
35 #define C(a, b) SYNTH_ERR_##a
42 static const char *err_text
[] = { ERRORS
};
44 static char last_cmd
[MAX_FILTER_STR_VAL
];
46 static int errpos(const char *str
)
48 return err_pos(last_cmd
, str
);
51 static void last_cmd_set(char *str
)
56 strncpy(last_cmd
, str
, MAX_FILTER_STR_VAL
- 1);
59 static void synth_err(u8 err_type
, u8 err_pos
)
61 tracing_log_err(NULL
, "synthetic_events", last_cmd
, err_text
,
65 static int create_synth_event(int argc
, const char **argv
);
66 static int synth_event_show(struct seq_file
*m
, struct dyn_event
*ev
);
67 static int synth_event_release(struct dyn_event
*ev
);
68 static bool synth_event_is_busy(struct dyn_event
*ev
);
69 static bool synth_event_match(const char *system
, const char *event
,
70 int argc
, const char **argv
, struct dyn_event
*ev
);
72 static struct dyn_event_operations synth_event_ops
= {
73 .create
= create_synth_event
,
74 .show
= synth_event_show
,
75 .is_busy
= synth_event_is_busy
,
76 .free
= synth_event_release
,
77 .match
= synth_event_match
,
80 static bool is_synth_event(struct dyn_event
*ev
)
82 return ev
->ops
== &synth_event_ops
;
85 static struct synth_event
*to_synth_event(struct dyn_event
*ev
)
87 return container_of(ev
, struct synth_event
, devent
);
90 static bool synth_event_is_busy(struct dyn_event
*ev
)
92 struct synth_event
*event
= to_synth_event(ev
);
94 return event
->ref
!= 0;
97 static bool synth_event_match(const char *system
, const char *event
,
98 int argc
, const char **argv
, struct dyn_event
*ev
)
100 struct synth_event
*sev
= to_synth_event(ev
);
102 return strcmp(sev
->name
, event
) == 0 &&
103 (!system
|| strcmp(system
, SYNTH_SYSTEM
) == 0);
106 struct synth_trace_event
{
107 struct trace_entry ent
;
111 static int synth_event_define_fields(struct trace_event_call
*call
)
113 struct synth_trace_event trace
;
114 int offset
= offsetof(typeof(trace
), fields
);
115 struct synth_event
*event
= call
->data
;
116 unsigned int i
, size
, n_u64
;
121 for (i
= 0, n_u64
= 0; i
< event
->n_fields
; i
++) {
122 size
= event
->fields
[i
]->size
;
123 is_signed
= event
->fields
[i
]->is_signed
;
124 type
= event
->fields
[i
]->type
;
125 name
= event
->fields
[i
]->name
;
126 ret
= trace_define_field(call
, type
, name
, offset
, size
,
127 is_signed
, FILTER_OTHER
);
131 event
->fields
[i
]->offset
= n_u64
;
133 if (event
->fields
[i
]->is_string
&& !event
->fields
[i
]->is_dynamic
) {
134 offset
+= STR_VAR_LEN_MAX
;
135 n_u64
+= STR_VAR_LEN_MAX
/ sizeof(u64
);
137 offset
+= sizeof(u64
);
142 event
->n_u64
= n_u64
;
147 static bool synth_field_signed(char *type
)
149 if (str_has_prefix(type
, "u"))
151 if (strcmp(type
, "gfp_t") == 0)
157 static int synth_field_is_string(char *type
)
159 if (strstr(type
, "char[") != NULL
)
165 static int synth_field_string_size(char *type
)
167 char buf
[4], *end
, *start
;
171 start
= strstr(type
, "char[");
174 start
+= sizeof("char[") - 1;
176 end
= strchr(type
, ']');
177 if (!end
|| end
< start
|| type
+ strlen(type
) > end
+ 1)
185 return 0; /* variable-length string */
187 strncpy(buf
, start
, len
);
190 err
= kstrtouint(buf
, 0, &size
);
194 if (size
> STR_VAR_LEN_MAX
)
200 static int synth_field_size(char *type
)
204 if (strcmp(type
, "s64") == 0)
206 else if (strcmp(type
, "u64") == 0)
208 else if (strcmp(type
, "s32") == 0)
210 else if (strcmp(type
, "u32") == 0)
212 else if (strcmp(type
, "s16") == 0)
214 else if (strcmp(type
, "u16") == 0)
216 else if (strcmp(type
, "s8") == 0)
218 else if (strcmp(type
, "u8") == 0)
220 else if (strcmp(type
, "char") == 0)
222 else if (strcmp(type
, "unsigned char") == 0)
223 size
= sizeof(unsigned char);
224 else if (strcmp(type
, "int") == 0)
226 else if (strcmp(type
, "unsigned int") == 0)
227 size
= sizeof(unsigned int);
228 else if (strcmp(type
, "long") == 0)
230 else if (strcmp(type
, "unsigned long") == 0)
231 size
= sizeof(unsigned long);
232 else if (strcmp(type
, "bool") == 0)
234 else if (strcmp(type
, "pid_t") == 0)
235 size
= sizeof(pid_t
);
236 else if (strcmp(type
, "gfp_t") == 0)
237 size
= sizeof(gfp_t
);
238 else if (synth_field_is_string(type
))
239 size
= synth_field_string_size(type
);
244 static const char *synth_field_fmt(char *type
)
246 const char *fmt
= "%llu";
248 if (strcmp(type
, "s64") == 0)
250 else if (strcmp(type
, "u64") == 0)
252 else if (strcmp(type
, "s32") == 0)
254 else if (strcmp(type
, "u32") == 0)
256 else if (strcmp(type
, "s16") == 0)
258 else if (strcmp(type
, "u16") == 0)
260 else if (strcmp(type
, "s8") == 0)
262 else if (strcmp(type
, "u8") == 0)
264 else if (strcmp(type
, "char") == 0)
266 else if (strcmp(type
, "unsigned char") == 0)
268 else if (strcmp(type
, "int") == 0)
270 else if (strcmp(type
, "unsigned int") == 0)
272 else if (strcmp(type
, "long") == 0)
274 else if (strcmp(type
, "unsigned long") == 0)
276 else if (strcmp(type
, "bool") == 0)
278 else if (strcmp(type
, "pid_t") == 0)
280 else if (strcmp(type
, "gfp_t") == 0)
282 else if (synth_field_is_string(type
))
288 static void print_synth_event_num_val(struct trace_seq
*s
,
289 char *print_fmt
, char *name
,
290 int size
, u64 val
, char *space
)
294 trace_seq_printf(s
, print_fmt
, name
, (u8
)val
, space
);
298 trace_seq_printf(s
, print_fmt
, name
, (u16
)val
, space
);
302 trace_seq_printf(s
, print_fmt
, name
, (u32
)val
, space
);
306 trace_seq_printf(s
, print_fmt
, name
, val
, space
);
311 static enum print_line_t
print_synth_event(struct trace_iterator
*iter
,
313 struct trace_event
*event
)
315 struct trace_array
*tr
= iter
->tr
;
316 struct trace_seq
*s
= &iter
->seq
;
317 struct synth_trace_event
*entry
;
318 struct synth_event
*se
;
319 unsigned int i
, n_u64
;
323 entry
= (struct synth_trace_event
*)iter
->ent
;
324 se
= container_of(event
, struct synth_event
, call
.event
);
326 trace_seq_printf(s
, "%s: ", se
->name
);
328 for (i
= 0, n_u64
= 0; i
< se
->n_fields
; i
++) {
329 if (trace_seq_has_overflowed(s
))
332 fmt
= synth_field_fmt(se
->fields
[i
]->type
);
334 /* parameter types */
335 if (tr
&& tr
->trace_flags
& TRACE_ITER_VERBOSE
)
336 trace_seq_printf(s
, "%s ", fmt
);
338 snprintf(print_fmt
, sizeof(print_fmt
), "%%s=%s%%s", fmt
);
340 /* parameter values */
341 if (se
->fields
[i
]->is_string
) {
342 if (se
->fields
[i
]->is_dynamic
) {
343 u32 offset
, data_offset
;
346 offset
= (u32
)entry
->fields
[n_u64
];
347 data_offset
= offset
& 0xffff;
349 str_field
= (char *)entry
+ data_offset
;
351 trace_seq_printf(s
, print_fmt
, se
->fields
[i
]->name
,
354 i
== se
->n_fields
- 1 ? "" : " ");
357 trace_seq_printf(s
, print_fmt
, se
->fields
[i
]->name
,
359 (char *)&entry
->fields
[n_u64
],
360 i
== se
->n_fields
- 1 ? "" : " ");
361 n_u64
+= STR_VAR_LEN_MAX
/ sizeof(u64
);
364 struct trace_print_flags __flags
[] = {
365 __def_gfpflag_names
, {-1, NULL
} };
366 char *space
= (i
== se
->n_fields
- 1 ? "" : " ");
368 print_synth_event_num_val(s
, print_fmt
,
371 entry
->fields
[n_u64
],
374 if (strcmp(se
->fields
[i
]->type
, "gfp_t") == 0) {
375 trace_seq_puts(s
, " (");
376 trace_print_flags_seq(s
, "|",
377 entry
->fields
[n_u64
],
379 trace_seq_putc(s
, ')');
385 trace_seq_putc(s
, '\n');
387 return trace_handle_return(s
);
390 static struct trace_event_functions synth_event_funcs
= {
391 .trace
= print_synth_event
394 static unsigned int trace_string(struct synth_trace_event
*entry
,
395 struct synth_event
*event
,
398 unsigned int data_size
,
401 unsigned int len
= 0;
407 data_offset
= offsetof(typeof(*entry
), fields
);
408 data_offset
+= event
->n_u64
* sizeof(u64
);
409 data_offset
+= data_size
;
411 str_field
= (char *)entry
+ data_offset
;
413 len
= strlen(str_val
) + 1;
414 strscpy(str_field
, str_val
, len
);
416 data_offset
|= len
<< 16;
417 *(u32
*)&entry
->fields
[*n_u64
] = data_offset
;
421 str_field
= (char *)&entry
->fields
[*n_u64
];
423 strscpy(str_field
, str_val
, STR_VAR_LEN_MAX
);
424 (*n_u64
) += STR_VAR_LEN_MAX
/ sizeof(u64
);
430 static notrace
void trace_event_raw_event_synth(void *__data
,
432 unsigned int *var_ref_idx
)
434 unsigned int i
, n_u64
, val_idx
, len
, data_size
= 0;
435 struct trace_event_file
*trace_file
= __data
;
436 struct synth_trace_event
*entry
;
437 struct trace_event_buffer fbuffer
;
438 struct trace_buffer
*buffer
;
439 struct synth_event
*event
;
442 event
= trace_file
->event_call
->data
;
444 if (trace_trigger_soft_disabled(trace_file
))
447 fields_size
= event
->n_u64
* sizeof(u64
);
449 for (i
= 0; i
< event
->n_dynamic_fields
; i
++) {
450 unsigned int field_pos
= event
->dynamic_fields
[i
]->field_pos
;
453 val_idx
= var_ref_idx
[field_pos
];
454 str_val
= (char *)(long)var_ref_vals
[val_idx
];
456 len
= strlen(str_val
) + 1;
462 * Avoid ring buffer recursion detection, as this event
463 * is being performed within another event.
465 buffer
= trace_file
->tr
->array_buffer
.buffer
;
466 ring_buffer_nest_start(buffer
);
468 entry
= trace_event_buffer_reserve(&fbuffer
, trace_file
,
469 sizeof(*entry
) + fields_size
);
473 for (i
= 0, n_u64
= 0; i
< event
->n_fields
; i
++) {
474 val_idx
= var_ref_idx
[i
];
475 if (event
->fields
[i
]->is_string
) {
476 char *str_val
= (char *)(long)var_ref_vals
[val_idx
];
478 len
= trace_string(entry
, event
, str_val
,
479 event
->fields
[i
]->is_dynamic
,
481 data_size
+= len
; /* only dynamic string increments */
483 struct synth_field
*field
= event
->fields
[i
];
484 u64 val
= var_ref_vals
[val_idx
];
486 switch (field
->size
) {
488 *(u8
*)&entry
->fields
[n_u64
] = (u8
)val
;
492 *(u16
*)&entry
->fields
[n_u64
] = (u16
)val
;
496 *(u32
*)&entry
->fields
[n_u64
] = (u32
)val
;
500 entry
->fields
[n_u64
] = val
;
507 trace_event_buffer_commit(&fbuffer
);
509 ring_buffer_nest_end(buffer
);
512 static void free_synth_event_print_fmt(struct trace_event_call
*call
)
515 kfree(call
->print_fmt
);
516 call
->print_fmt
= NULL
;
520 static int __set_synth_event_print_fmt(struct synth_event
*event
,
527 /* When len=0, we just calculate the needed length */
528 #define LEN_OR_ZERO (len ? len - pos : 0)
530 pos
+= snprintf(buf
+ pos
, LEN_OR_ZERO
, "\"");
531 for (i
= 0; i
< event
->n_fields
; i
++) {
532 fmt
= synth_field_fmt(event
->fields
[i
]->type
);
533 pos
+= snprintf(buf
+ pos
, LEN_OR_ZERO
, "%s=%s%s",
534 event
->fields
[i
]->name
, fmt
,
535 i
== event
->n_fields
- 1 ? "" : ", ");
537 pos
+= snprintf(buf
+ pos
, LEN_OR_ZERO
, "\"");
539 for (i
= 0; i
< event
->n_fields
; i
++) {
540 if (event
->fields
[i
]->is_string
&&
541 event
->fields
[i
]->is_dynamic
)
542 pos
+= snprintf(buf
+ pos
, LEN_OR_ZERO
,
543 ", __get_str(%s)", event
->fields
[i
]->name
);
545 pos
+= snprintf(buf
+ pos
, LEN_OR_ZERO
,
546 ", REC->%s", event
->fields
[i
]->name
);
551 /* return the length of print_fmt */
555 static int set_synth_event_print_fmt(struct trace_event_call
*call
)
557 struct synth_event
*event
= call
->data
;
561 /* First: called with 0 length to calculate the needed length */
562 len
= __set_synth_event_print_fmt(event
, NULL
, 0);
564 print_fmt
= kmalloc(len
+ 1, GFP_KERNEL
);
568 /* Second: actually write the @print_fmt */
569 __set_synth_event_print_fmt(event
, print_fmt
, len
+ 1);
570 call
->print_fmt
= print_fmt
;
575 static void free_synth_field(struct synth_field
*field
)
582 static struct synth_field
*parse_synth_field(int argc
, const char **argv
,
585 struct synth_field
*field
;
586 const char *prefix
= NULL
, *field_type
= argv
[0], *field_name
, *array
;
587 int len
, ret
= -ENOMEM
;
591 if (field_type
[0] == ';')
594 if (!strcmp(field_type
, "unsigned")) {
596 synth_err(SYNTH_ERR_INCOMPLETE_TYPE
, errpos(field_type
));
597 return ERR_PTR(-EINVAL
);
599 prefix
= "unsigned ";
600 field_type
= argv
[1];
601 field_name
= argv
[2];
604 field_name
= argv
[1];
608 field
= kzalloc(sizeof(*field
), GFP_KERNEL
);
610 return ERR_PTR(-ENOMEM
);
612 len
= strlen(field_name
);
613 array
= strchr(field_name
, '[');
615 len
-= strlen(array
);
616 else if (field_name
[len
- 1] == ';')
619 field
->name
= kmemdup_nul(field_name
, len
, GFP_KERNEL
);
623 if (!is_good_name(field
->name
)) {
624 synth_err(SYNTH_ERR_BAD_NAME
, errpos(field_name
));
629 if (field_type
[0] == ';')
631 len
= strlen(field_type
) + 1;
634 len
+= strlen(array
);
637 len
+= strlen(prefix
);
639 field
->type
= kzalloc(len
, GFP_KERNEL
);
643 seq_buf_init(&s
, field
->type
, len
);
645 seq_buf_puts(&s
, prefix
);
646 seq_buf_puts(&s
, field_type
);
648 seq_buf_puts(&s
, array
);
649 if (s
.buffer
[s
.len
- 1] == ';')
652 if (WARN_ON_ONCE(!seq_buf_buffer_left(&s
)))
655 s
.buffer
[s
.len
] = '\0';
657 size
= synth_field_size(field
->type
);
659 synth_err(SYNTH_ERR_INVALID_TYPE
, errpos(field_type
));
662 } else if (size
== 0) {
663 if (synth_field_is_string(field
->type
)) {
666 len
= sizeof("__data_loc ") + strlen(field
->type
) + 1;
667 type
= kzalloc(len
, GFP_KERNEL
);
671 seq_buf_init(&s
, type
, len
);
672 seq_buf_puts(&s
, "__data_loc ");
673 seq_buf_puts(&s
, field
->type
);
675 if (WARN_ON_ONCE(!seq_buf_buffer_left(&s
)))
677 s
.buffer
[s
.len
] = '\0';
682 field
->is_dynamic
= true;
685 synth_err(SYNTH_ERR_INVALID_TYPE
, errpos(field_type
));
692 if (synth_field_is_string(field
->type
))
693 field
->is_string
= true;
695 field
->is_signed
= synth_field_signed(field
->type
);
699 free_synth_field(field
);
700 field
= ERR_PTR(ret
);
704 static void free_synth_tracepoint(struct tracepoint
*tp
)
713 static struct tracepoint
*alloc_synth_tracepoint(char *name
)
715 struct tracepoint
*tp
;
717 tp
= kzalloc(sizeof(*tp
), GFP_KERNEL
);
719 return ERR_PTR(-ENOMEM
);
721 tp
->name
= kstrdup(name
, GFP_KERNEL
);
724 return ERR_PTR(-ENOMEM
);
730 struct synth_event
*find_synth_event(const char *name
)
732 struct dyn_event
*pos
;
733 struct synth_event
*event
;
735 for_each_dyn_event(pos
) {
736 if (!is_synth_event(pos
))
738 event
= to_synth_event(pos
);
739 if (strcmp(event
->name
, name
) == 0)
746 static struct trace_event_fields synth_event_fields_array
[] = {
747 { .type
= TRACE_FUNCTION_TYPE
,
748 .define_fields
= synth_event_define_fields
},
752 static int register_synth_event(struct synth_event
*event
)
754 struct trace_event_call
*call
= &event
->call
;
757 event
->call
.class = &event
->class;
758 event
->class.system
= kstrdup(SYNTH_SYSTEM
, GFP_KERNEL
);
759 if (!event
->class.system
) {
764 event
->tp
= alloc_synth_tracepoint(event
->name
);
765 if (IS_ERR(event
->tp
)) {
766 ret
= PTR_ERR(event
->tp
);
771 INIT_LIST_HEAD(&call
->class->fields
);
772 call
->event
.funcs
= &synth_event_funcs
;
773 call
->class->fields_array
= synth_event_fields_array
;
775 ret
= register_trace_event(&call
->event
);
780 call
->flags
= TRACE_EVENT_FL_TRACEPOINT
;
781 call
->class->reg
= trace_event_reg
;
782 call
->class->probe
= trace_event_raw_event_synth
;
784 call
->tp
= event
->tp
;
786 ret
= trace_add_event_call(call
);
788 pr_warn("Failed to register synthetic event: %s\n",
789 trace_event_name(call
));
793 ret
= set_synth_event_print_fmt(call
);
795 trace_remove_event_call(call
);
801 unregister_trace_event(&call
->event
);
805 static int unregister_synth_event(struct synth_event
*event
)
807 struct trace_event_call
*call
= &event
->call
;
810 ret
= trace_remove_event_call(call
);
815 static void free_synth_event(struct synth_event
*event
)
822 for (i
= 0; i
< event
->n_fields
; i
++)
823 free_synth_field(event
->fields
[i
]);
825 kfree(event
->fields
);
826 kfree(event
->dynamic_fields
);
828 kfree(event
->class.system
);
829 free_synth_tracepoint(event
->tp
);
830 free_synth_event_print_fmt(&event
->call
);
834 static struct synth_event
*alloc_synth_event(const char *name
, int n_fields
,
835 struct synth_field
**fields
)
837 unsigned int i
, j
, n_dynamic_fields
= 0;
838 struct synth_event
*event
;
840 event
= kzalloc(sizeof(*event
), GFP_KERNEL
);
842 event
= ERR_PTR(-ENOMEM
);
846 event
->name
= kstrdup(name
, GFP_KERNEL
);
849 event
= ERR_PTR(-ENOMEM
);
853 event
->fields
= kcalloc(n_fields
, sizeof(*event
->fields
), GFP_KERNEL
);
854 if (!event
->fields
) {
855 free_synth_event(event
);
856 event
= ERR_PTR(-ENOMEM
);
860 for (i
= 0; i
< n_fields
; i
++)
861 if (fields
[i
]->is_dynamic
)
864 if (n_dynamic_fields
) {
865 event
->dynamic_fields
= kcalloc(n_dynamic_fields
,
866 sizeof(*event
->dynamic_fields
),
868 if (!event
->dynamic_fields
) {
869 free_synth_event(event
);
870 event
= ERR_PTR(-ENOMEM
);
875 dyn_event_init(&event
->devent
, &synth_event_ops
);
877 for (i
= 0, j
= 0; i
< n_fields
; i
++) {
878 event
->fields
[i
] = fields
[i
];
880 if (fields
[i
]->is_dynamic
) {
881 event
->dynamic_fields
[j
] = fields
[i
];
882 event
->dynamic_fields
[j
]->field_pos
= i
;
883 event
->dynamic_fields
[j
++] = fields
[i
];
884 event
->n_dynamic_fields
++;
887 event
->n_fields
= n_fields
;
892 static int synth_event_check_arg_fn(void *data
)
894 struct dynevent_arg_pair
*arg_pair
= data
;
897 size
= synth_field_size((char *)arg_pair
->lhs
);
899 if (strstr((char *)arg_pair
->lhs
, "["))
903 return size
? 0 : -EINVAL
;
907 * synth_event_add_field - Add a new field to a synthetic event cmd
908 * @cmd: A pointer to the dynevent_cmd struct representing the new event
909 * @type: The type of the new field to add
910 * @name: The name of the new field to add
912 * Add a new field to a synthetic event cmd object. Field ordering is in
913 * the same order the fields are added.
915 * See synth_field_size() for available types. If field_name contains
916 * [n] the field is considered to be an array.
918 * Return: 0 if successful, error otherwise.
920 int synth_event_add_field(struct dynevent_cmd
*cmd
, const char *type
,
923 struct dynevent_arg_pair arg_pair
;
926 if (cmd
->type
!= DYNEVENT_TYPE_SYNTH
)
932 dynevent_arg_pair_init(&arg_pair
, 0, ';');
937 ret
= dynevent_arg_pair_add(cmd
, &arg_pair
, synth_event_check_arg_fn
);
941 if (++cmd
->n_fields
> SYNTH_FIELDS_MAX
)
946 EXPORT_SYMBOL_GPL(synth_event_add_field
);
949 * synth_event_add_field_str - Add a new field to a synthetic event cmd
950 * @cmd: A pointer to the dynevent_cmd struct representing the new event
951 * @type_name: The type and name of the new field to add, as a single string
953 * Add a new field to a synthetic event cmd object, as a single
954 * string. The @type_name string is expected to be of the form 'type
955 * name', which will be appended by ';'. No sanity checking is done -
956 * what's passed in is assumed to already be well-formed. Field
957 * ordering is in the same order the fields are added.
959 * See synth_field_size() for available types. If field_name contains
960 * [n] the field is considered to be an array.
962 * Return: 0 if successful, error otherwise.
964 int synth_event_add_field_str(struct dynevent_cmd
*cmd
, const char *type_name
)
966 struct dynevent_arg arg
;
969 if (cmd
->type
!= DYNEVENT_TYPE_SYNTH
)
975 dynevent_arg_init(&arg
, ';');
979 ret
= dynevent_arg_add(cmd
, &arg
, NULL
);
983 if (++cmd
->n_fields
> SYNTH_FIELDS_MAX
)
988 EXPORT_SYMBOL_GPL(synth_event_add_field_str
);
991 * synth_event_add_fields - Add multiple fields to a synthetic event cmd
992 * @cmd: A pointer to the dynevent_cmd struct representing the new event
993 * @fields: An array of type/name field descriptions
994 * @n_fields: The number of field descriptions contained in the fields array
996 * Add a new set of fields to a synthetic event cmd object. The event
997 * fields that will be defined for the event should be passed in as an
998 * array of struct synth_field_desc, and the number of elements in the
999 * array passed in as n_fields. Field ordering will retain the
1000 * ordering given in the fields array.
1002 * See synth_field_size() for available types. If field_name contains
1003 * [n] the field is considered to be an array.
1005 * Return: 0 if successful, error otherwise.
1007 int synth_event_add_fields(struct dynevent_cmd
*cmd
,
1008 struct synth_field_desc
*fields
,
1009 unsigned int n_fields
)
1014 for (i
= 0; i
< n_fields
; i
++) {
1015 if (fields
[i
].type
== NULL
|| fields
[i
].name
== NULL
) {
1020 ret
= synth_event_add_field(cmd
, fields
[i
].type
, fields
[i
].name
);
1027 EXPORT_SYMBOL_GPL(synth_event_add_fields
);
1030 * __synth_event_gen_cmd_start - Start a synthetic event command from arg list
1031 * @cmd: A pointer to the dynevent_cmd struct representing the new event
1032 * @name: The name of the synthetic event
1033 * @mod: The module creating the event, NULL if not created from a module
1034 * @args: Variable number of arg (pairs), one pair for each field
1036 * NOTE: Users normally won't want to call this function directly, but
1037 * rather use the synth_event_gen_cmd_start() wrapper, which
1038 * automatically adds a NULL to the end of the arg list. If this
1039 * function is used directly, make sure the last arg in the variable
1042 * Generate a synthetic event command to be executed by
1043 * synth_event_gen_cmd_end(). This function can be used to generate
1044 * the complete command or only the first part of it; in the latter
1045 * case, synth_event_add_field(), synth_event_add_field_str(), or
1046 * synth_event_add_fields() can be used to add more fields following
1049 * There should be an even number variable args, each pair consisting
1050 * of a type followed by a field name.
1052 * See synth_field_size() for available types. If field_name contains
1053 * [n] the field is considered to be an array.
1055 * Return: 0 if successful, error otherwise.
1057 int __synth_event_gen_cmd_start(struct dynevent_cmd
*cmd
, const char *name
,
1058 struct module
*mod
, ...)
1060 struct dynevent_arg arg
;
1064 cmd
->event_name
= name
;
1065 cmd
->private_data
= mod
;
1067 if (cmd
->type
!= DYNEVENT_TYPE_SYNTH
)
1070 dynevent_arg_init(&arg
, 0);
1072 ret
= dynevent_arg_add(cmd
, &arg
, NULL
);
1076 va_start(args
, mod
);
1078 const char *type
, *name
;
1080 type
= va_arg(args
, const char *);
1083 name
= va_arg(args
, const char *);
1087 if (++cmd
->n_fields
> SYNTH_FIELDS_MAX
) {
1092 ret
= synth_event_add_field(cmd
, type
, name
);
1100 EXPORT_SYMBOL_GPL(__synth_event_gen_cmd_start
);
1103 * synth_event_gen_cmd_array_start - Start synthetic event command from an array
1104 * @cmd: A pointer to the dynevent_cmd struct representing the new event
1105 * @name: The name of the synthetic event
1106 * @fields: An array of type/name field descriptions
1107 * @n_fields: The number of field descriptions contained in the fields array
1109 * Generate a synthetic event command to be executed by
1110 * synth_event_gen_cmd_end(). This function can be used to generate
1111 * the complete command or only the first part of it; in the latter
1112 * case, synth_event_add_field(), synth_event_add_field_str(), or
1113 * synth_event_add_fields() can be used to add more fields following
1116 * The event fields that will be defined for the event should be
1117 * passed in as an array of struct synth_field_desc, and the number of
1118 * elements in the array passed in as n_fields. Field ordering will
1119 * retain the ordering given in the fields array.
1121 * See synth_field_size() for available types. If field_name contains
1122 * [n] the field is considered to be an array.
1124 * Return: 0 if successful, error otherwise.
1126 int synth_event_gen_cmd_array_start(struct dynevent_cmd
*cmd
, const char *name
,
1128 struct synth_field_desc
*fields
,
1129 unsigned int n_fields
)
1131 struct dynevent_arg arg
;
1135 cmd
->event_name
= name
;
1136 cmd
->private_data
= mod
;
1138 if (cmd
->type
!= DYNEVENT_TYPE_SYNTH
)
1141 if (n_fields
> SYNTH_FIELDS_MAX
)
1144 dynevent_arg_init(&arg
, 0);
1146 ret
= dynevent_arg_add(cmd
, &arg
, NULL
);
1150 for (i
= 0; i
< n_fields
; i
++) {
1151 if (fields
[i
].type
== NULL
|| fields
[i
].name
== NULL
)
1154 ret
= synth_event_add_field(cmd
, fields
[i
].type
, fields
[i
].name
);
1161 EXPORT_SYMBOL_GPL(synth_event_gen_cmd_array_start
);
1163 static int save_cmdstr(int argc
, const char *name
, const char **argv
)
1169 buf
= kzalloc(MAX_DYNEVENT_CMD_LEN
, GFP_KERNEL
);
1173 seq_buf_init(&s
, buf
, MAX_DYNEVENT_CMD_LEN
);
1175 seq_buf_puts(&s
, name
);
1177 for (i
= 0; i
< argc
; i
++) {
1178 seq_buf_putc(&s
, ' ');
1179 seq_buf_puts(&s
, argv
[i
]);
1182 if (!seq_buf_buffer_left(&s
)) {
1183 synth_err(SYNTH_ERR_CMD_TOO_LONG
, 0);
1194 static int __create_synth_event(int argc
, const char *name
, const char **argv
)
1196 struct synth_field
*field
, *fields
[SYNTH_FIELDS_MAX
];
1197 struct synth_event
*event
= NULL
;
1198 int i
, consumed
= 0, n_fields
= 0, ret
= 0;
1200 ret
= save_cmdstr(argc
, name
, argv
);
1206 * - Add synthetic event: <event_name> field[;field] ...
1207 * - Remove synthetic event: !<event_name> field[;field] ...
1208 * where 'field' = type field_name
1211 if (name
[0] == '\0' || argc
< 1) {
1212 synth_err(SYNTH_ERR_CMD_INCOMPLETE
, 0);
1216 mutex_lock(&event_mutex
);
1218 if (!is_good_name(name
)) {
1219 synth_err(SYNTH_ERR_BAD_NAME
, errpos(name
));
1224 event
= find_synth_event(name
);
1226 synth_err(SYNTH_ERR_EVENT_EXISTS
, errpos(name
));
1231 for (i
= 0; i
< argc
- 1; i
++) {
1232 if (strcmp(argv
[i
], ";") == 0)
1234 if (n_fields
== SYNTH_FIELDS_MAX
) {
1235 synth_err(SYNTH_ERR_TOO_MANY_FIELDS
, 0);
1240 field
= parse_synth_field(argc
- i
, &argv
[i
], &consumed
);
1241 if (IS_ERR(field
)) {
1242 ret
= PTR_ERR(field
);
1245 fields
[n_fields
++] = field
;
1249 if (i
< argc
&& strcmp(argv
[i
], ";") != 0) {
1250 synth_err(SYNTH_ERR_INVALID_FIELD
, errpos(argv
[i
]));
1255 event
= alloc_synth_event(name
, n_fields
, fields
);
1256 if (IS_ERR(event
)) {
1257 ret
= PTR_ERR(event
);
1261 ret
= register_synth_event(event
);
1263 dyn_event_add(&event
->devent
);
1265 free_synth_event(event
);
1267 mutex_unlock(&event_mutex
);
1271 for (i
= 0; i
< n_fields
; i
++)
1272 free_synth_field(fields
[i
]);
1278 * synth_event_create - Create a new synthetic event
1279 * @name: The name of the new synthetic event
1280 * @fields: An array of type/name field descriptions
1281 * @n_fields: The number of field descriptions contained in the fields array
1282 * @mod: The module creating the event, NULL if not created from a module
1284 * Create a new synthetic event with the given name under the
1285 * trace/events/synthetic/ directory. The event fields that will be
1286 * defined for the event should be passed in as an array of struct
1287 * synth_field_desc, and the number elements in the array passed in as
1288 * n_fields. Field ordering will retain the ordering given in the
1291 * If the new synthetic event is being created from a module, the mod
1292 * param must be non-NULL. This will ensure that the trace buffer
1293 * won't contain unreadable events.
1295 * The new synth event should be deleted using synth_event_delete()
1296 * function. The new synthetic event can be generated from modules or
1297 * other kernel code using trace_synth_event() and related functions.
1299 * Return: 0 if successful, error otherwise.
1301 int synth_event_create(const char *name
, struct synth_field_desc
*fields
,
1302 unsigned int n_fields
, struct module
*mod
)
1304 struct dynevent_cmd cmd
;
1308 buf
= kzalloc(MAX_DYNEVENT_CMD_LEN
, GFP_KERNEL
);
1312 synth_event_cmd_init(&cmd
, buf
, MAX_DYNEVENT_CMD_LEN
);
1314 ret
= synth_event_gen_cmd_array_start(&cmd
, name
, mod
,
1319 ret
= synth_event_gen_cmd_end(&cmd
);
1325 EXPORT_SYMBOL_GPL(synth_event_create
);
1327 static int destroy_synth_event(struct synth_event
*se
)
1334 ret
= unregister_synth_event(se
);
1336 dyn_event_remove(&se
->devent
);
1337 free_synth_event(se
);
1345 * synth_event_delete - Delete a synthetic event
1346 * @event_name: The name of the new sythetic event
1348 * Delete a synthetic event that was created with synth_event_create().
1350 * Return: 0 if successful, error otherwise.
1352 int synth_event_delete(const char *event_name
)
1354 struct synth_event
*se
= NULL
;
1355 struct module
*mod
= NULL
;
1358 mutex_lock(&event_mutex
);
1359 se
= find_synth_event(event_name
);
1362 ret
= destroy_synth_event(se
);
1364 mutex_unlock(&event_mutex
);
1367 mutex_lock(&trace_types_lock
);
1369 * It is safest to reset the ring buffer if the module
1370 * being unloaded registered any events that were
1371 * used. The only worry is if a new module gets
1372 * loaded, and takes on the same id as the events of
1373 * this module. When printing out the buffer, traced
1374 * events left over from this module may be passed to
1375 * the new module events and unexpected results may
1378 tracing_reset_all_online_cpus();
1379 mutex_unlock(&trace_types_lock
);
1384 EXPORT_SYMBOL_GPL(synth_event_delete
);
1386 static int create_or_delete_synth_event(int argc
, char **argv
)
1388 const char *name
= argv
[0];
1391 /* trace_run_command() ensures argc != 0 */
1392 if (name
[0] == '!') {
1393 ret
= synth_event_delete(name
+ 1);
1397 ret
= __create_synth_event(argc
- 1, name
, (const char **)argv
+ 1);
1398 return ret
== -ECANCELED
? -EINVAL
: ret
;
1401 static int synth_event_run_command(struct dynevent_cmd
*cmd
)
1403 struct synth_event
*se
;
1406 ret
= trace_run_command(cmd
->seq
.buffer
, create_or_delete_synth_event
);
1410 se
= find_synth_event(cmd
->event_name
);
1414 se
->mod
= cmd
->private_data
;
1420 * synth_event_cmd_init - Initialize a synthetic event command object
1421 * @cmd: A pointer to the dynevent_cmd struct representing the new event
1422 * @buf: A pointer to the buffer used to build the command
1423 * @maxlen: The length of the buffer passed in @buf
1425 * Initialize a synthetic event command object. Use this before
1426 * calling any of the other dyenvent_cmd functions.
1428 void synth_event_cmd_init(struct dynevent_cmd
*cmd
, char *buf
, int maxlen
)
1430 dynevent_cmd_init(cmd
, buf
, maxlen
, DYNEVENT_TYPE_SYNTH
,
1431 synth_event_run_command
);
1433 EXPORT_SYMBOL_GPL(synth_event_cmd_init
);
1436 __synth_event_trace_init(struct trace_event_file
*file
,
1437 struct synth_event_trace_state
*trace_state
)
1441 memset(trace_state
, '\0', sizeof(*trace_state
));
1444 * Normal event tracing doesn't get called at all unless the
1445 * ENABLED bit is set (which attaches the probe thus allowing
1446 * this code to be called, etc). Because this is called
1447 * directly by the user, we don't have that but we still need
1448 * to honor not logging when disabled. For the iterated
1449 * trace case, we save the enabled state upon start and just
1450 * ignore the following data calls.
1452 if (!(file
->flags
& EVENT_FILE_FL_ENABLED
) ||
1453 trace_trigger_soft_disabled(file
)) {
1454 trace_state
->disabled
= true;
1459 trace_state
->event
= file
->event_call
->data
;
1465 __synth_event_trace_start(struct trace_event_file
*file
,
1466 struct synth_event_trace_state
*trace_state
,
1467 int dynamic_fields_size
)
1469 int entry_size
, fields_size
= 0;
1472 fields_size
= trace_state
->event
->n_u64
* sizeof(u64
);
1473 fields_size
+= dynamic_fields_size
;
1476 * Avoid ring buffer recursion detection, as this event
1477 * is being performed within another event.
1479 trace_state
->buffer
= file
->tr
->array_buffer
.buffer
;
1480 ring_buffer_nest_start(trace_state
->buffer
);
1482 entry_size
= sizeof(*trace_state
->entry
) + fields_size
;
1483 trace_state
->entry
= trace_event_buffer_reserve(&trace_state
->fbuffer
,
1486 if (!trace_state
->entry
) {
1487 ring_buffer_nest_end(trace_state
->buffer
);
1495 __synth_event_trace_end(struct synth_event_trace_state
*trace_state
)
1497 trace_event_buffer_commit(&trace_state
->fbuffer
);
1499 ring_buffer_nest_end(trace_state
->buffer
);
1503 * synth_event_trace - Trace a synthetic event
1504 * @file: The trace_event_file representing the synthetic event
1505 * @n_vals: The number of values in vals
1506 * @args: Variable number of args containing the event values
1508 * Trace a synthetic event using the values passed in the variable
1511 * The argument list should be a list 'n_vals' u64 values. The number
1512 * of vals must match the number of field in the synthetic event, and
1513 * must be in the same order as the synthetic event fields.
1515 * All vals should be cast to u64, and string vals are just pointers
1516 * to strings, cast to u64. Strings will be copied into space
1517 * reserved in the event for the string, using these pointers.
1519 * Return: 0 on success, err otherwise.
1521 int synth_event_trace(struct trace_event_file
*file
, unsigned int n_vals
, ...)
1523 unsigned int i
, n_u64
, len
, data_size
= 0;
1524 struct synth_event_trace_state state
;
1528 ret
= __synth_event_trace_init(file
, &state
);
1531 ret
= 0; /* just disabled, not really an error */
1535 if (state
.event
->n_dynamic_fields
) {
1536 va_start(args
, n_vals
);
1538 for (i
= 0; i
< state
.event
->n_fields
; i
++) {
1539 u64 val
= va_arg(args
, u64
);
1541 if (state
.event
->fields
[i
]->is_string
&&
1542 state
.event
->fields
[i
]->is_dynamic
) {
1543 char *str_val
= (char *)(long)val
;
1545 data_size
+= strlen(str_val
) + 1;
1552 ret
= __synth_event_trace_start(file
, &state
, data_size
);
1556 if (n_vals
!= state
.event
->n_fields
) {
1563 va_start(args
, n_vals
);
1564 for (i
= 0, n_u64
= 0; i
< state
.event
->n_fields
; i
++) {
1567 val
= va_arg(args
, u64
);
1569 if (state
.event
->fields
[i
]->is_string
) {
1570 char *str_val
= (char *)(long)val
;
1572 len
= trace_string(state
.entry
, state
.event
, str_val
,
1573 state
.event
->fields
[i
]->is_dynamic
,
1575 data_size
+= len
; /* only dynamic string increments */
1577 struct synth_field
*field
= state
.event
->fields
[i
];
1579 switch (field
->size
) {
1581 *(u8
*)&state
.entry
->fields
[n_u64
] = (u8
)val
;
1585 *(u16
*)&state
.entry
->fields
[n_u64
] = (u16
)val
;
1589 *(u32
*)&state
.entry
->fields
[n_u64
] = (u32
)val
;
1593 state
.entry
->fields
[n_u64
] = val
;
1601 __synth_event_trace_end(&state
);
1605 EXPORT_SYMBOL_GPL(synth_event_trace
);
1608 * synth_event_trace_array - Trace a synthetic event from an array
1609 * @file: The trace_event_file representing the synthetic event
1610 * @vals: Array of values
1611 * @n_vals: The number of values in vals
1613 * Trace a synthetic event using the values passed in as 'vals'.
1615 * The 'vals' array is just an array of 'n_vals' u64. The number of
1616 * vals must match the number of field in the synthetic event, and
1617 * must be in the same order as the synthetic event fields.
1619 * All vals should be cast to u64, and string vals are just pointers
1620 * to strings, cast to u64. Strings will be copied into space
1621 * reserved in the event for the string, using these pointers.
1623 * Return: 0 on success, err otherwise.
1625 int synth_event_trace_array(struct trace_event_file
*file
, u64
*vals
,
1626 unsigned int n_vals
)
1628 unsigned int i
, n_u64
, field_pos
, len
, data_size
= 0;
1629 struct synth_event_trace_state state
;
1633 ret
= __synth_event_trace_init(file
, &state
);
1636 ret
= 0; /* just disabled, not really an error */
1640 if (state
.event
->n_dynamic_fields
) {
1641 for (i
= 0; i
< state
.event
->n_dynamic_fields
; i
++) {
1642 field_pos
= state
.event
->dynamic_fields
[i
]->field_pos
;
1643 str_val
= (char *)(long)vals
[field_pos
];
1644 len
= strlen(str_val
) + 1;
1649 ret
= __synth_event_trace_start(file
, &state
, data_size
);
1653 if (n_vals
!= state
.event
->n_fields
) {
1660 for (i
= 0, n_u64
= 0; i
< state
.event
->n_fields
; i
++) {
1661 if (state
.event
->fields
[i
]->is_string
) {
1662 char *str_val
= (char *)(long)vals
[i
];
1664 len
= trace_string(state
.entry
, state
.event
, str_val
,
1665 state
.event
->fields
[i
]->is_dynamic
,
1667 data_size
+= len
; /* only dynamic string increments */
1669 struct synth_field
*field
= state
.event
->fields
[i
];
1672 switch (field
->size
) {
1674 *(u8
*)&state
.entry
->fields
[n_u64
] = (u8
)val
;
1678 *(u16
*)&state
.entry
->fields
[n_u64
] = (u16
)val
;
1682 *(u32
*)&state
.entry
->fields
[n_u64
] = (u32
)val
;
1686 state
.entry
->fields
[n_u64
] = val
;
1693 __synth_event_trace_end(&state
);
1697 EXPORT_SYMBOL_GPL(synth_event_trace_array
);
1700 * synth_event_trace_start - Start piecewise synthetic event trace
1701 * @file: The trace_event_file representing the synthetic event
1702 * @trace_state: A pointer to object tracking the piecewise trace state
1704 * Start the trace of a synthetic event field-by-field rather than all
1707 * This function 'opens' an event trace, which means space is reserved
1708 * for the event in the trace buffer, after which the event's
1709 * individual field values can be set through either
1710 * synth_event_add_next_val() or synth_event_add_val().
1712 * A pointer to a trace_state object is passed in, which will keep
1713 * track of the current event trace state until the event trace is
1714 * closed (and the event finally traced) using
1715 * synth_event_trace_end().
1717 * Note that synth_event_trace_end() must be called after all values
1718 * have been added for each event trace, regardless of whether adding
1719 * all field values succeeded or not.
1721 * Note also that for a given event trace, all fields must be added
1722 * using either synth_event_add_next_val() or synth_event_add_val()
1723 * but not both together or interleaved.
1725 * Return: 0 on success, err otherwise.
1727 int synth_event_trace_start(struct trace_event_file
*file
,
1728 struct synth_event_trace_state
*trace_state
)
1735 ret
= __synth_event_trace_init(file
, trace_state
);
1738 ret
= 0; /* just disabled, not really an error */
1742 if (trace_state
->event
->n_dynamic_fields
)
1745 ret
= __synth_event_trace_start(file
, trace_state
, 0);
1749 EXPORT_SYMBOL_GPL(synth_event_trace_start
);
1751 static int __synth_event_add_val(const char *field_name
, u64 val
,
1752 struct synth_event_trace_state
*trace_state
)
1754 struct synth_field
*field
= NULL
;
1755 struct synth_trace_event
*entry
;
1756 struct synth_event
*event
;
1764 /* can't mix add_next_synth_val() with add_synth_val() */
1766 if (trace_state
->add_next
) {
1770 trace_state
->add_name
= true;
1772 if (trace_state
->add_name
) {
1776 trace_state
->add_next
= true;
1779 if (trace_state
->disabled
)
1782 event
= trace_state
->event
;
1783 if (trace_state
->add_name
) {
1784 for (i
= 0; i
< event
->n_fields
; i
++) {
1785 field
= event
->fields
[i
];
1786 if (strcmp(field
->name
, field_name
) == 0)
1794 if (trace_state
->cur_field
>= event
->n_fields
) {
1798 field
= event
->fields
[trace_state
->cur_field
++];
1801 entry
= trace_state
->entry
;
1802 if (field
->is_string
) {
1803 char *str_val
= (char *)(long)val
;
1806 if (field
->is_dynamic
) { /* add_val can't do dynamic strings */
1816 str_field
= (char *)&entry
->fields
[field
->offset
];
1817 strscpy(str_field
, str_val
, STR_VAR_LEN_MAX
);
1819 switch (field
->size
) {
1821 *(u8
*)&trace_state
->entry
->fields
[field
->offset
] = (u8
)val
;
1825 *(u16
*)&trace_state
->entry
->fields
[field
->offset
] = (u16
)val
;
1829 *(u32
*)&trace_state
->entry
->fields
[field
->offset
] = (u32
)val
;
1833 trace_state
->entry
->fields
[field
->offset
] = val
;
1842 * synth_event_add_next_val - Add the next field's value to an open synth trace
1843 * @val: The value to set the next field to
1844 * @trace_state: A pointer to object tracking the piecewise trace state
1846 * Set the value of the next field in an event that's been opened by
1847 * synth_event_trace_start().
1849 * The val param should be the value cast to u64. If the value points
1850 * to a string, the val param should be a char * cast to u64.
1852 * This function assumes all the fields in an event are to be set one
1853 * after another - successive calls to this function are made, one for
1854 * each field, in the order of the fields in the event, until all
1855 * fields have been set. If you'd rather set each field individually
1856 * without regard to ordering, synth_event_add_val() can be used
1859 * Note however that synth_event_add_next_val() and
1860 * synth_event_add_val() can't be intermixed for a given event trace -
1861 * one or the other but not both can be used at the same time.
1863 * Note also that synth_event_trace_end() must be called after all
1864 * values have been added for each event trace, regardless of whether
1865 * adding all field values succeeded or not.
1867 * Return: 0 on success, err otherwise.
1869 int synth_event_add_next_val(u64 val
,
1870 struct synth_event_trace_state
*trace_state
)
1872 return __synth_event_add_val(NULL
, val
, trace_state
);
1874 EXPORT_SYMBOL_GPL(synth_event_add_next_val
);
1877 * synth_event_add_val - Add a named field's value to an open synth trace
1878 * @field_name: The name of the synthetic event field value to set
1879 * @val: The value to set the next field to
1880 * @trace_state: A pointer to object tracking the piecewise trace state
1882 * Set the value of the named field in an event that's been opened by
1883 * synth_event_trace_start().
1885 * The val param should be the value cast to u64. If the value points
1886 * to a string, the val param should be a char * cast to u64.
1888 * This function looks up the field name, and if found, sets the field
1889 * to the specified value. This lookup makes this function more
1890 * expensive than synth_event_add_next_val(), so use that or the
1891 * none-piecewise synth_event_trace() instead if efficiency is more
1894 * Note however that synth_event_add_next_val() and
1895 * synth_event_add_val() can't be intermixed for a given event trace -
1896 * one or the other but not both can be used at the same time.
1898 * Note also that synth_event_trace_end() must be called after all
1899 * values have been added for each event trace, regardless of whether
1900 * adding all field values succeeded or not.
1902 * Return: 0 on success, err otherwise.
1904 int synth_event_add_val(const char *field_name
, u64 val
,
1905 struct synth_event_trace_state
*trace_state
)
1907 return __synth_event_add_val(field_name
, val
, trace_state
);
1909 EXPORT_SYMBOL_GPL(synth_event_add_val
);
1912 * synth_event_trace_end - End piecewise synthetic event trace
1913 * @trace_state: A pointer to object tracking the piecewise trace state
1915 * End the trace of a synthetic event opened by
1916 * synth_event_trace__start().
1918 * This function 'closes' an event trace, which basically means that
1919 * it commits the reserved event and cleans up other loose ends.
1921 * A pointer to a trace_state object is passed in, which will keep
1922 * track of the current event trace state opened with
1923 * synth_event_trace_start().
1925 * Note that this function must be called after all values have been
1926 * added for each event trace, regardless of whether adding all field
1927 * values succeeded or not.
1929 * Return: 0 on success, err otherwise.
1931 int synth_event_trace_end(struct synth_event_trace_state
*trace_state
)
1936 __synth_event_trace_end(trace_state
);
1940 EXPORT_SYMBOL_GPL(synth_event_trace_end
);
1942 static int create_synth_event(int argc
, const char **argv
)
1944 const char *name
= argv
[0];
1947 if (name
[0] != 's' || name
[1] != ':')
1951 /* This interface accepts group name prefix */
1952 if (strchr(name
, '/')) {
1953 len
= str_has_prefix(name
, SYNTH_SYSTEM
"/");
1958 return __create_synth_event(argc
- 1, name
, argv
+ 1);
1961 static int synth_event_release(struct dyn_event
*ev
)
1963 struct synth_event
*event
= to_synth_event(ev
);
1969 ret
= unregister_synth_event(event
);
1973 dyn_event_remove(ev
);
1974 free_synth_event(event
);
1978 static int __synth_event_show(struct seq_file
*m
, struct synth_event
*event
)
1980 struct synth_field
*field
;
1984 seq_printf(m
, "%s\t", event
->name
);
1986 for (i
= 0; i
< event
->n_fields
; i
++) {
1987 field
= event
->fields
[i
];
1990 t
= strstr(type
, "__data_loc");
1991 if (t
) { /* __data_loc belongs in format but not event desc */
1992 t
+= sizeof("__data_loc");
1996 /* parameter values */
1997 seq_printf(m
, "%s %s%s", type
, field
->name
,
1998 i
== event
->n_fields
- 1 ? "" : "; ");
2006 static int synth_event_show(struct seq_file
*m
, struct dyn_event
*ev
)
2008 struct synth_event
*event
= to_synth_event(ev
);
2010 seq_printf(m
, "s:%s/", event
->class.system
);
2012 return __synth_event_show(m
, event
);
2015 static int synth_events_seq_show(struct seq_file
*m
, void *v
)
2017 struct dyn_event
*ev
= v
;
2019 if (!is_synth_event(ev
))
2022 return __synth_event_show(m
, to_synth_event(ev
));
2025 static const struct seq_operations synth_events_seq_op
= {
2026 .start
= dyn_event_seq_start
,
2027 .next
= dyn_event_seq_next
,
2028 .stop
= dyn_event_seq_stop
,
2029 .show
= synth_events_seq_show
,
2032 static int synth_events_open(struct inode
*inode
, struct file
*file
)
2036 ret
= security_locked_down(LOCKDOWN_TRACEFS
);
2040 if ((file
->f_mode
& FMODE_WRITE
) && (file
->f_flags
& O_TRUNC
)) {
2041 ret
= dyn_events_release_all(&synth_event_ops
);
2046 return seq_open(file
, &synth_events_seq_op
);
2049 static ssize_t
synth_events_write(struct file
*file
,
2050 const char __user
*buffer
,
2051 size_t count
, loff_t
*ppos
)
2053 return trace_parse_run_command(file
, buffer
, count
, ppos
,
2054 create_or_delete_synth_event
);
2057 static const struct file_operations synth_events_fops
= {
2058 .open
= synth_events_open
,
2059 .write
= synth_events_write
,
2061 .llseek
= seq_lseek
,
2062 .release
= seq_release
,
2066 * Register dynevent at core_initcall. This allows kernel to setup kprobe
2067 * events in postcore_initcall without tracefs.
2069 static __init
int trace_events_synth_init_early(void)
2073 err
= dyn_event_register(&synth_event_ops
);
2075 pr_warn("Could not register synth_event_ops\n");
2079 core_initcall(trace_events_synth_init_early
);
2081 static __init
int trace_events_synth_init(void)
2083 struct dentry
*entry
= NULL
;
2085 err
= tracing_init_dentry();
2089 entry
= tracefs_create_file("synthetic_events", 0644, NULL
,
2090 NULL
, &synth_events_fops
);
2098 pr_warn("Could not create tracefs 'synthetic_events' entry\n");
2103 fs_initcall(trace_events_synth_init
);