Linux Audio

Check our new training course

Loading...
v4.17
  1/* SPDX-License-Identifier: GPL-2.0 */
  2#ifndef __PERF_HEADER_H
  3#define __PERF_HEADER_H
  4
 
  5#include <linux/perf_event.h>
  6#include <sys/types.h>
 
  7#include <stdbool.h>
  8#include <linux/bitmap.h>
  9#include <linux/types.h>
 10#include "event.h"
 11#include "env.h"
 12#include "pmu.h"
 13
 14enum {
 15	HEADER_RESERVED		= 0,	/* always cleared */
 16	HEADER_FIRST_FEATURE	= 1,
 17	HEADER_TRACING_DATA	= 1,
 18	HEADER_BUILD_ID,
 19
 20	HEADER_HOSTNAME,
 21	HEADER_OSRELEASE,
 22	HEADER_VERSION,
 23	HEADER_ARCH,
 24	HEADER_NRCPUS,
 25	HEADER_CPUDESC,
 26	HEADER_CPUID,
 27	HEADER_TOTAL_MEM,
 28	HEADER_CMDLINE,
 29	HEADER_EVENT_DESC,
 30	HEADER_CPU_TOPOLOGY,
 31	HEADER_NUMA_TOPOLOGY,
 32	HEADER_BRANCH_STACK,
 33	HEADER_PMU_MAPPINGS,
 34	HEADER_GROUP_DESC,
 35	HEADER_AUXTRACE,
 36	HEADER_STAT,
 37	HEADER_CACHE,
 38	HEADER_SAMPLE_TIME,
 39	HEADER_MEM_TOPOLOGY,
 
 
 
 
 
 
 
 
 
 40	HEADER_LAST_FEATURE,
 41	HEADER_FEAT_BITS	= 256,
 42};
 43
 44enum perf_header_version {
 45	PERF_HEADER_VERSION_1,
 46	PERF_HEADER_VERSION_2,
 47};
 48
 49struct perf_file_section {
 50	u64 offset;
 51	u64 size;
 52};
 53
 54struct perf_file_header {
 55	u64				magic;
 56	u64				size;
 57	u64				attr_size;
 58	struct perf_file_section	attrs;
 59	struct perf_file_section	data;
 60	/* event_types is ignored */
 61	struct perf_file_section	event_types;
 62	DECLARE_BITMAP(adds_features, HEADER_FEAT_BITS);
 63};
 64
 65struct perf_pipe_file_header {
 66	u64				magic;
 67	u64				size;
 68};
 69
 70struct perf_header;
 71
 72int perf_file_header__read(struct perf_file_header *header,
 73			   struct perf_header *ph, int fd);
 74
 75struct perf_header {
 76	enum perf_header_version	version;
 77	bool				needs_swap;
 78	u64				data_offset;
 79	u64				data_size;
 80	u64				feat_offset;
 81	DECLARE_BITMAP(adds_features, HEADER_FEAT_BITS);
 82	struct perf_env 	env;
 83};
 84
 85struct perf_evlist;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 86struct perf_session;
 
 
 87
 88int perf_session__read_header(struct perf_session *session);
 
 
 89int perf_session__write_header(struct perf_session *session,
 90			       struct perf_evlist *evlist,
 91			       int fd, bool at_exit);
 92int perf_header__write_pipe(int fd);
 93
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 94void perf_header__set_feat(struct perf_header *header, int feat);
 95void perf_header__clear_feat(struct perf_header *header, int feat);
 96bool perf_header__has_feat(const struct perf_header *header, int feat);
 97
 98int perf_header__set_cmdline(int argc, const char **argv);
 99
100int perf_header__process_sections(struct perf_header *header, int fd,
101				  void *data,
102				  int (*process)(struct perf_file_section *section,
103				  struct perf_header *ph,
104				  int feat, int fd, void *data));
105
106int perf_header__fprintf_info(struct perf_session *s, FILE *fp, bool full);
107
108int perf_event__synthesize_features(struct perf_tool *tool,
109				    struct perf_session *session,
110				    struct perf_evlist *evlist,
111				    perf_event__handler_t process);
112
113int perf_event__synthesize_extra_attr(struct perf_tool *tool,
114				      struct perf_evlist *evsel_list,
115				      perf_event__handler_t process,
116				      bool is_pipe);
117
118int perf_event__process_feature(struct perf_tool *tool,
119				union perf_event *event,
120				struct perf_session *session);
121
122int perf_event__synthesize_attr(struct perf_tool *tool,
123				struct perf_event_attr *attr, u32 ids, u64 *id,
124				perf_event__handler_t process);
125int perf_event__synthesize_attrs(struct perf_tool *tool,
126				 struct perf_session *session,
127				 perf_event__handler_t process);
128int perf_event__synthesize_event_update_unit(struct perf_tool *tool,
129					     struct perf_evsel *evsel,
130					     perf_event__handler_t process);
131int perf_event__synthesize_event_update_scale(struct perf_tool *tool,
132					      struct perf_evsel *evsel,
133					      perf_event__handler_t process);
134int perf_event__synthesize_event_update_name(struct perf_tool *tool,
135					     struct perf_evsel *evsel,
136					     perf_event__handler_t process);
137int perf_event__synthesize_event_update_cpus(struct perf_tool *tool,
138					     struct perf_evsel *evsel,
139					     perf_event__handler_t process);
140int perf_event__process_attr(struct perf_tool *tool, union perf_event *event,
141			     struct perf_evlist **pevlist);
142int perf_event__process_event_update(struct perf_tool *tool,
143				     union perf_event *event,
144				     struct perf_evlist **pevlist);
145size_t perf_event__fprintf_event_update(union perf_event *event, FILE *fp);
146
147int perf_event__synthesize_tracing_data(struct perf_tool *tool,
148					int fd, struct perf_evlist *evlist,
149					perf_event__handler_t process);
150int perf_event__process_tracing_data(struct perf_tool *tool,
151				     union perf_event *event,
152				     struct perf_session *session);
153
154int perf_event__synthesize_build_id(struct perf_tool *tool,
155				    struct dso *pos, u16 misc,
156				    perf_event__handler_t process,
157				    struct machine *machine);
158int perf_event__process_build_id(struct perf_tool *tool,
159				 union perf_event *event,
160				 struct perf_session *session);
161bool is_perf_magic(u64 magic);
162
163#define NAME_ALIGN 64
164
165struct feat_fd;
166
167int do_write(struct feat_fd *fd, const void *buf, size_t size);
168
169int write_padded(struct feat_fd *fd, const void *bf,
170		 size_t count, size_t count_aligned);
 
 
 
 
 
171
172/*
173 * arch specific callback
174 */
175int get_cpuid(char *buffer, size_t sz);
176
177char *get_cpuid_str(struct perf_pmu *pmu __maybe_unused);
178int strcmp_cpuid_str(const char *s1, const char *s2);
179#endif /* __PERF_HEADER_H */
v6.8
  1/* SPDX-License-Identifier: GPL-2.0 */
  2#ifndef __PERF_HEADER_H
  3#define __PERF_HEADER_H
  4
  5#include <linux/stddef.h>
  6#include <linux/perf_event.h>
  7#include <sys/types.h>
  8#include <stdio.h> // FILE
  9#include <stdbool.h>
 10#include <linux/bitmap.h>
 11#include <linux/types.h>
 
 12#include "env.h"
 13#include "pmu.h"
 14
 15enum {
 16	HEADER_RESERVED		= 0,	/* always cleared */
 17	HEADER_FIRST_FEATURE	= 1,
 18	HEADER_TRACING_DATA	= 1,
 19	HEADER_BUILD_ID,
 20
 21	HEADER_HOSTNAME,
 22	HEADER_OSRELEASE,
 23	HEADER_VERSION,
 24	HEADER_ARCH,
 25	HEADER_NRCPUS,
 26	HEADER_CPUDESC,
 27	HEADER_CPUID,
 28	HEADER_TOTAL_MEM,
 29	HEADER_CMDLINE,
 30	HEADER_EVENT_DESC,
 31	HEADER_CPU_TOPOLOGY,
 32	HEADER_NUMA_TOPOLOGY,
 33	HEADER_BRANCH_STACK,
 34	HEADER_PMU_MAPPINGS,
 35	HEADER_GROUP_DESC,
 36	HEADER_AUXTRACE,
 37	HEADER_STAT,
 38	HEADER_CACHE,
 39	HEADER_SAMPLE_TIME,
 40	HEADER_MEM_TOPOLOGY,
 41	HEADER_CLOCKID,
 42	HEADER_DIR_FORMAT,
 43	HEADER_BPF_PROG_INFO,
 44	HEADER_BPF_BTF,
 45	HEADER_COMPRESSED,
 46	HEADER_CPU_PMU_CAPS,
 47	HEADER_CLOCK_DATA,
 48	HEADER_HYBRID_TOPOLOGY,
 49	HEADER_PMU_CAPS,
 50	HEADER_LAST_FEATURE,
 51	HEADER_FEAT_BITS	= 256,
 52};
 53
 54enum perf_header_version {
 55	PERF_HEADER_VERSION_1,
 56	PERF_HEADER_VERSION_2,
 57};
 58
 59struct perf_file_section {
 60	u64 offset;
 61	u64 size;
 62};
 63
 64struct perf_file_header {
 65	u64				magic;
 66	u64				size;
 67	u64				attr_size;
 68	struct perf_file_section	attrs;
 69	struct perf_file_section	data;
 70	/* event_types is ignored */
 71	struct perf_file_section	event_types;
 72	DECLARE_BITMAP(adds_features, HEADER_FEAT_BITS);
 73};
 74
 75struct perf_pipe_file_header {
 76	u64				magic;
 77	u64				size;
 78};
 79
 80struct perf_header;
 81
 82int perf_file_header__read(struct perf_file_header *header,
 83			   struct perf_header *ph, int fd);
 84
 85struct perf_header {
 86	enum perf_header_version	version;
 87	bool				needs_swap;
 88	u64				data_offset;
 89	u64				data_size;
 90	u64				feat_offset;
 91	DECLARE_BITMAP(adds_features, HEADER_FEAT_BITS);
 92	struct perf_env 	env;
 93};
 94
 95struct feat_fd {
 96	struct perf_header *ph;
 97	int		   fd;
 98	void		   *buf;	/* Either buf != NULL or fd >= 0 */
 99	ssize_t		   offset;
100	size_t		   size;
101	struct evsel	   *events;
102};
103
104struct perf_header_feature_ops {
105	int	   (*write)(struct feat_fd *ff, struct evlist *evlist);
106	void	   (*print)(struct feat_fd *ff, FILE *fp);
107	int	   (*process)(struct feat_fd *ff, void *data);
108	const char *name;
109	bool	   full_only;
110	bool	   synthesize;
111};
112
113struct evlist;
114struct perf_session;
115struct perf_tool;
116union perf_event;
117
118extern const char perf_version_string[];
119
120int perf_session__read_header(struct perf_session *session, int repipe_fd);
121int perf_session__write_header(struct perf_session *session,
122			       struct evlist *evlist,
123			       int fd, bool at_exit);
124int perf_header__write_pipe(int fd);
125
126/* feat_writer writes a feature section to output */
127struct feat_writer {
128	int (*write)(struct feat_writer *fw, void *buf, size_t sz);
129};
130
131/* feat_copier copies a feature section using feat_writer to output */
132struct feat_copier {
133	int (*copy)(struct feat_copier *fc, int feat, struct feat_writer *fw);
134};
135
136int perf_session__inject_header(struct perf_session *session,
137				struct evlist *evlist,
138				int fd,
139				struct feat_copier *fc);
140
141size_t perf_session__data_offset(const struct evlist *evlist);
142
143void perf_header__set_feat(struct perf_header *header, int feat);
144void perf_header__clear_feat(struct perf_header *header, int feat);
145bool perf_header__has_feat(const struct perf_header *header, int feat);
146
147int perf_header__set_cmdline(int argc, const char **argv);
148
149int perf_header__process_sections(struct perf_header *header, int fd,
150				  void *data,
151				  int (*process)(struct perf_file_section *section,
152				  struct perf_header *ph,
153				  int feat, int fd, void *data));
154
155int perf_header__fprintf_info(struct perf_session *s, FILE *fp, bool full);
156
157int perf_event__process_feature(struct perf_session *session,
158				union perf_event *event);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
159int perf_event__process_attr(struct perf_tool *tool, union perf_event *event,
160			     struct evlist **pevlist);
161int perf_event__process_event_update(struct perf_tool *tool,
162				     union perf_event *event,
163				     struct evlist **pevlist);
164size_t perf_event__fprintf_event_update(union perf_event *event, FILE *fp);
165#ifdef HAVE_LIBTRACEEVENT
166int perf_event__process_tracing_data(struct perf_session *session,
167				     union perf_event *event);
168#endif
169int perf_event__process_build_id(struct perf_session *session,
170				 union perf_event *event);
 
 
 
 
 
 
 
 
 
171bool is_perf_magic(u64 magic);
172
173#define NAME_ALIGN 64
174
175struct feat_fd;
176
177int do_write(struct feat_fd *fd, const void *buf, size_t size);
178
179int write_padded(struct feat_fd *fd, const void *bf,
180		 size_t count, size_t count_aligned);
181
182#define MAX_CACHE_LVL 4
183
184int is_cpu_online(unsigned int cpu);
185int build_caches_for_cpu(u32 cpu, struct cpu_cache_level caches[], u32 *cntp);
186
187/*
188 * arch specific callback
189 */
190int get_cpuid(char *buffer, size_t sz);
191
192char *get_cpuid_str(struct perf_pmu *pmu __maybe_unused);
193int strcmp_cpuid_str(const char *s1, const char *s2);
194#endif /* __PERF_HEADER_H */