1/* SPDX-License-Identifier: GPL-2.0 */
2#ifndef __PERF_DATA_H
3#define __PERF_DATA_H
4
5#include <stdio.h>
6#include <stdbool.h>
7#include <unistd.h>
8#include <linux/types.h>
9
10enum perf_data_mode {
11 PERF_DATA_MODE_WRITE,
12 PERF_DATA_MODE_READ,
13};
14
15enum perf_dir_version {
16 PERF_DIR_SINGLE_FILE = 0,
17 PERF_DIR_VERSION = 1,
18};
19
20struct perf_data_file {
21 char *path;
22 union {
23 int fd;
24 FILE *fptr;
25 };
26 unsigned long size;
27};
28
29struct perf_data {
30 const char *path;
31 struct perf_data_file file;
32 bool is_pipe;
33 bool is_dir;
34 bool force;
35 bool use_stdio;
36 bool in_place_update;
37 enum perf_data_mode mode;
38
39 struct {
40 u64 version;
41 struct perf_data_file *files;
42 int nr;
43 } dir;
44};
45
46static inline bool perf_data__is_read(struct perf_data *data)
47{
48 return data->mode == PERF_DATA_MODE_READ;
49}
50
51static inline bool perf_data__is_write(struct perf_data *data)
52{
53 return data->mode == PERF_DATA_MODE_WRITE;
54}
55
56static inline int perf_data__is_pipe(struct perf_data *data)
57{
58 return data->is_pipe;
59}
60
61static inline bool perf_data__is_dir(struct perf_data *data)
62{
63 return data->is_dir;
64}
65
66static inline bool perf_data__is_single_file(struct perf_data *data)
67{
68 return data->dir.version == PERF_DIR_SINGLE_FILE;
69}
70
71static inline int perf_data__fd(struct perf_data *data)
72{
73 if (data->use_stdio)
74 return fileno(data->file.fptr);
75
76 return data->file.fd;
77}
78
79int perf_data__open(struct perf_data *data);
80void perf_data__close(struct perf_data *data);
81ssize_t perf_data__read(struct perf_data *data, void *buf, size_t size);
82ssize_t perf_data__write(struct perf_data *data,
83 void *buf, size_t size);
84ssize_t perf_data_file__write(struct perf_data_file *file,
85 void *buf, size_t size);
86/*
87 * If at_exit is set, only rename current perf.data to
88 * perf.data.<postfix>, continue write on original data.
89 * Set at_exit when flushing the last output.
90 *
91 * Return value is fd of new output.
92 */
93int perf_data__switch(struct perf_data *data,
94 const char *postfix,
95 size_t pos, bool at_exit, char **new_filepath);
96
97int perf_data__create_dir(struct perf_data *data, int nr);
98int perf_data__open_dir(struct perf_data *data);
99void perf_data__close_dir(struct perf_data *data);
100int perf_data__update_dir(struct perf_data *data);
101unsigned long perf_data__size(struct perf_data *data);
102int perf_data__make_kcore_dir(struct perf_data *data, char *buf, size_t buf_sz);
103bool has_kcore_dir(const char *path);
104char *perf_data__kallsyms_name(struct perf_data *data);
105char *perf_data__guest_kallsyms_name(struct perf_data *data, pid_t machine_pid);
106bool is_perf_data(const char *path);
107#endif /* __PERF_DATA_H */
108

source code of linux/tools/perf/util/data.h