tools/lib/perf/include/perf/event.h

File Facts

System

Linux kernel

Corpus path

tools/lib/perf/include/perf/event.h

Extension

.h

Size

14814 bytes

Lines

637

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

• linux/perf_event.h
• linux/types.h
• linux/limits.h
• linux/bpf.h
• sys/types.h
• schedstat-v15.h
• schedstat-v16.h
• schedstat-v17.h

Detected Declarations

• struct perf_record_mmap
• struct perf_record_mmap2
• struct perf_record_comm
• struct perf_record_namespaces
• struct perf_record_fork
• struct perf_record_lost
• struct perf_record_lost_samples
• struct perf_record_lost_samples_and_ids
• struct perf_record_read
• struct perf_record_throttle
• struct perf_record_ksymbol
• struct perf_record_bpf_event
• struct perf_record_cgroup
• struct perf_record_text_poke_event
• struct perf_record_sample
• struct perf_record_switch
• struct perf_record_callchain_deferred
• struct perf_record_header_attr
• struct cpu_map_entries
• struct perf_record_mask_cpu_map32
• struct perf_record_mask_cpu_map64
• struct perf_record_range_cpu_map
• struct perf_record_cpu_map_data
• struct perf_record_cpu_map
• struct perf_record_event_update_cpus
• struct perf_record_event_update_scale
• struct perf_record_event_update
• struct perf_trace_event_type
• struct perf_record_header_event_type
• struct perf_record_header_tracing_data
• struct perf_record_header_build_id
• struct id_index_entry
• struct id_index_entry_2
• struct perf_record_id_index
• struct perf_record_auxtrace_info
• struct perf_record_auxtrace
• struct perf_record_auxtrace_error
• struct perf_record_aux
• struct perf_record_itrace_start
• struct perf_record_aux_output_hw_id
• struct perf_record_thread_map_entry
• struct perf_record_thread_map
• struct perf_record_stat_config_entry
• struct perf_record_stat_config
• struct perf_record_stat
• struct perf_record_stat_round
• struct perf_record_time_conv
• struct perf_record_header_feature

Annotated Snippet

struct perf_record_switch		context_switch;
	struct perf_record_thread_map		thread_map;
	struct perf_record_cpu_map		cpu_map;
	struct perf_record_stat_config		stat_config;
	struct perf_record_stat			stat;
	struct perf_record_stat_round		stat_round;
	struct perf_record_time_conv		time_conv;
	struct perf_record_header_feature	feat;
	struct perf_record_compressed		pack;
	struct perf_record_compressed2		pack2;
	struct perf_record_bpf_metadata		bpf_metadata;
	struct perf_record_schedstat_cpu	schedstat_cpu;
	struct perf_record_schedstat_domain	schedstat_domain;
};

#endif /* __LIBPERF_EVENT_H */

Annotation

• Immediate include surface: `linux/perf_event.h`, `linux/types.h`, `linux/limits.h`, `linux/bpf.h`, `sys/types.h`, `schedstat-v15.h`, `schedstat-v16.h`, `schedstat-v17.h`.
• Detected declarations: `struct perf_record_mmap`, `struct perf_record_mmap2`, `struct perf_record_comm`, `struct perf_record_namespaces`, `struct perf_record_fork`, `struct perf_record_lost`, `struct perf_record_lost_samples`, `struct perf_record_lost_samples_and_ids`, `struct perf_record_read`, `struct perf_record_throttle`.
• 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.