tools/perf/util/trace-event.h
Source file repositories/reference/linux-study-clean/tools/perf/util/trace-event.h
File Facts
- System
- Linux kernel
- Corpus path
tools/perf/util/trace-event.h- Extension
.h- Size
- 5045 bytes
- Lines
- 166
- Domain
- Support Tooling And Documentation
- Bucket
- tools
- Inferred role
- Support Tooling And Documentation: implementation source
- Status
- source implementation candidate
Why This File Exists
Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.
- Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
stdbool.hstdio.hsys/types.hlinux/types.hevent-parse.hlinux/compiler.h
Detected Declarations
struct evliststruct machinestruct perf_samplestruct perf_toolstruct threadstruct tep_plugin_liststruct evselstruct tep_format_fieldstruct trace_eventstruct tracing_datastruct addr_locationstruct perf_sessionstruct perf_stat_configstruct scripting_opsstruct scripting_contextfunction tep_field_is_relativefunction tep_field_is_relative
Annotated Snippet
struct trace_event {
struct tep_handle *pevent;
struct tep_plugin_list *plugin_list;
};
/* Computes a version number comparable with LIBTRACEEVENT_VERSION from Makefile.config. */
#define MAKE_LIBTRACEEVENT_VERSION(a, b, c) ((a)*255*255+(b)*255+(c))
typedef char *(tep_func_resolver_t)(void *priv,
unsigned long long *addrp, char **modp);
bool have_tracepoints(struct list_head *evlist);
int trace_event__init(struct trace_event *t);
void trace_event__cleanup(struct trace_event *t);
int trace_event__register_resolver(struct machine *machine,
tep_func_resolver_t *func);
struct tep_event*
trace_event__tp_format(const char *sys, const char *name);
struct tep_event *trace_event__tp_format_id(int id);
void event_format__fprintf(const struct tep_event *event,
int cpu, void *data, int size, FILE *fp);
int parse_ftrace_file(struct tep_handle *pevent, char *buf, unsigned long size);
int parse_event_file(struct tep_handle *pevent,
char *buf, unsigned long size, char *sys);
unsigned long long
raw_field_value(struct tep_event *event, const char *name, void *data);
const char *parse_task_states(struct tep_format_field *state_field);
void parse_proc_kallsyms(struct tep_handle *pevent, char *file, unsigned int size);
void parse_ftrace_printk(struct tep_handle *pevent, char *file, unsigned int size);
void parse_saved_cmdline(struct tep_handle *pevent, char *file, unsigned int size);
ssize_t trace_report(int fd, struct trace_event *tevent, bool repipe);
unsigned long long read_size(struct tep_event *event, void *ptr, int size);
unsigned long long eval_flag(const char *flag);
int read_tracing_data(int fd, struct list_head *pattrs);
/*
* Return the tracepoint name in the format "subsystem:event_name",
* callers should free the returned string.
*/
char *tracepoint_id_to_name(u64 config);
struct tracing_data {
/* size is only valid if temp is 'true' */
ssize_t size;
bool temp;
char temp_file[50];
};
struct tracing_data *tracing_data_get(struct list_head *pattrs,
int fd, bool temp);
int tracing_data_put(struct tracing_data *tdata);
struct addr_location;
struct perf_session;
struct perf_stat_config;
struct scripting_ops {
const char *name;
const char *dirname; /* For script path .../scripts/<dirname>/... */
int (*start_script)(const char *script, int argc, const char **argv,
struct perf_session *session);
int (*flush_script) (void);
int (*stop_script) (void);
void (*process_event) (union perf_event *event,
struct perf_sample *sample,
struct evsel *evsel,
struct addr_location *al,
struct addr_location *addr_al);
void (*process_switch)(union perf_event *event,
struct perf_sample *sample,
struct machine *machine);
void (*process_auxtrace_error)(struct perf_session *session,
union perf_event *event);
void (*process_stat)(struct perf_stat_config *config,
struct evsel *evsel, u64 tstamp);
void (*process_stat_interval)(u64 tstamp);
void (*process_throttle)(union perf_event *event,
struct perf_sample *sample,
Annotation
- Immediate include surface: `stdbool.h`, `stdio.h`, `sys/types.h`, `linux/types.h`, `event-parse.h`, `linux/compiler.h`.
- Detected declarations: `struct evlist`, `struct machine`, `struct perf_sample`, `struct perf_tool`, `struct thread`, `struct tep_plugin_list`, `struct evsel`, `struct tep_format_field`, `struct trace_event`, `struct tracing_data`.
- Atlas domain: Support Tooling And Documentation / tools.
- Implementation status: source implementation candidate.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.