xref: /aosp_15_r20/external/libtracefs/Documentation/libtracefs.txt (revision 287e80b3a36113050663245e7f2c00d274188f18)
1libtracefs(3)
2=============
3
4NAME
5----
6libtracefs - Linux kernel trace file system library
7
8SYNOPSIS
9--------
10[verse]
11--
12*#include <tracefs.h>*
13
14Locations of tracing files and directories:
15	char pass:[*]*tracefs_get_tracing_file*(const char pass:[*]_name_);
16	void *tracefs_put_tracing_file*(char pass:[*]_name_);
17	const char pass:[*]*tracefs_tracing_dir*(void);
18	const char pass:[*]*tracefs_debug_dir*(void);
19	int *tracefs_set_tracing_dir*(char pass:[*]_tracing_dir_)
20	int *tracefs_tracing_dir_is_mounted*(bool _mount_, const char pass:[**]_path_);
21
22Trace instances:
23	struct tracefs_instance pass:[*]*tracefs_instance_create*(const char pass:[*]_name_);
24	int *tracefs_instance_destroy*(struct tracefs_instance pass:[*]_instance_);
25	struct tracefs_instance pass:[*]*tracefs_instance_alloc*(const char pass:[*]_tracing_dir_, const char pass:[*]_name_);
26	void *tracefs_instance_free*(struct tracefs_instance pass:[*]_instance_);
27	char pass:[**]*tracefs_instances*(const char pass:[*]_regex_);
28	bool *tracefs_instance_is_new*(struct tracefs_instance pass:[*]_instance_);
29	bool *tracefs_file_exists*(struct tracefs_instance pass:[*]_instance_, char pass:[*]_name_);
30	bool *tracefs_dir_exists*(struct tracefs_instance pass:[*]_instance_, char pass:[*]_name_);
31	char pass:[*]*tracefs_instance_get_file*(struct tracefs_instance pass:[*]_instance_, const char pass:[*]_file_);
32	char pass:[*]*tracefs_instance_get_dir*(struct tracefs_instance pass:[*]_instance_);
33	int *tracefs_instance_file_open*(struct tracefs_instance pass:[*]_instance_, const char pass:[*]_file_, int _mode_);
34	int *tracefs_instance_file_write*(struct tracefs_instance pass:[*]_instance_, const char pass:[*]_file_, const char pass:[*]_str_);
35	int *tracefs_instance_file_append*(struct tracefs_instance pass:[*]_instance_, const char pass:[*]_file_, const char pass:[*]_str_);
36	int *tracefs_instance_file_clear*(struct tracefs_instance pass:[*]_instance_, const char pass:[*]_file_);
37	char pass:[*]*tracefs_instance_file_read*(struct tracefs_instance pass:[*]_instance_, const char pass:[*]_file_, int pass:[*]_psize_);
38	int *tracefs_instance_file_read_number*(struct tracefs_instance pass:[*]_instance_, const char pass:[*]_file_, long long int pass:[*]_res_);
39	const char pass:[*]*tracefs_instance_get_name*(struct tracefs_instance pass:[*]_instance_);
40	const char pass:[*]*tracefs_instance_get_trace_dir*(struct tracefs_instance pass:[*]_instance_);
41	int *tracefs_instances_walk*(int (pass:[*]_callback_)(const char pass:[*], void pass:[*]), void pass:[*]_context)_;
42	bool *tracefs_instance_exists*(const char pass:[*]_name_);
43	int *tracefs_instance_set_affinity*(struct tracefs_instance pass:[*]_instance_, const char pass:[*]_cpu_str_);
44	int *tracefs_instance_set_affinity_set*(struct tracefs_instance pass:[*]_instance_, cpu_set_t pass:[*]_set_, size_t _set_size_);
45	int *tracefs_instance_set_affinity_raw*(struct tracefs_instance pass:[*]_instance_, const char pass:[*]_mask_);
46	char pass:[*]*tracefs_instance_get_affinity*(struct tracefs_instance pass:[*]_instance_);
47	int *tracefs_instance_get_affinity_set*(struct tracefs_instance pass:[*]_instance_, cpu_set_t pass:[*]_set_, size_t _set_size_);
48	char pass:[*]*tracefs_instance_get_affinity_raw*(struct tracefs_instance pass:[*]_instance_);
49	size_t *tracefs_instance_get_buffer_size*(struct tracefs_instance pass:[*]_instance_, int _cpu_);
50	int *tracefs_instance_set_buffer_size*(struct tracefs_instance pass:[*]_instance_, size_t _size_, int _cpu_);
51
52Trace events:
53	char pass:[*]pass:[*]*tracefs_event_systems*(const char pass:[*]_tracing_dir_);
54	char pass:[*]pass:[*]*tracefs_system_events*(const char pass:[*]_tracing_dir_, const char pass:[*]_system_);
55	int *tracefs_event_enable*(struct tracefs_instance pass:[*]_instance_, const char pass:[*]_system_,
56                           const char pass:[*]_event_);
57	int *tracefs_event_disable*(struct tracefs_instance pass:[*]_instance_, const char pass:[*]_system_,
58                            const char pass:[*]_event_);
59	enum tracefs_enable_state *tracefs_event_is_enabled*(struct tracefs_instance pass:[*]_instance_,
60				 const char pass:[*]_system_, const char pass:[*]_event_);
61	int *tracefs_iterate_raw_events*(struct tep_handle pass:[*]_tep_, struct tracefs_instance pass:[*]_instance_, cpu_set_t pass:[*]_cpus_, int _cpu_size_, int (pass:[*]_callback_)(struct tep_event pass:[*], struct tep_record pass:[*], int, void pass:[*]), void pass:[*]_callback_context_);
62	void *tracefs_iterate_stop*(struct tracefs_instance pass:[*]_instance_);
63	int *tracefs_follow_event*(struct tep_handle pass:[*]_tep_, struct tracefs_instance pass:[*]_instance_,
64				  const char pass:[*]_system_, const char pass:[*]_event_name_,
65				  int (pass:[*]_callback_)(struct tep_event pass:[*],
66						  struct tep_record pass:[*],
67						  int, void pass:[*]),
68				  void pass:[*]_callback_data_);
69	int *tracefs_follow_missed_events*(struct tracefs_instance pass:[*]_instance_,
70				  int (pass:[*]_callback_)(struct tep_event pass:[*],
71						  struct tep_record pass:[*],
72						  int, void pass:[*]),
73				  void pass:[*]_callback_data_);
74	struct tep_handle pass:[*]*tracefs_local_events*(const char pass:[*]_tracing_dir_);
75	struct tep_handle pass:[*]*tracefs_local_events_system*(const char pass:[*]_tracing_dir_, const char pass:[*] const pass:[*]_sys_names_);
76	int *tracefs_fill_local_events*(const char pass:[*]_tracing_dir_, struct tep_handle pass:[*]_tep_, int pass:[*]_parsing_failures_);
77	int *tracefs_load_cmdlines*(const char pass:[*]_tracing_dir_, struct tep_handle pass:[*]_tep_);
78	char pass:[*]*tracefs_event_get_file*(struct tracefs_instance pass:[*]_instance_, const char pass:[*]_system_, const char pass:[*]_event_,
79			     const char pass:[*]_file_);
80	char pass:[*]*tracefs_event_file_read*(struct tracefs_instance pass:[*]_instance_, const char pass:[*]_system_, const char pass:[*]_event_,
81			      const char pass:[*]_file_, int pass:[*]_psize_);
82	int *tracefs_event_file_write*(struct tracefs_instance pass:[*]_instance_, const char pass:[*]_system_, const char pass:[*]_event_,
83			     const char pass:[*]_file_, const char pass:[*]_str_);
84	int *tracefs_event_file_append*(struct tracefs_instance pass:[*]_instance_, const char pass:[*]_system_, const char pass:[*]_event_,
85			      const char pass:[*]_file_, const char pass:[*]_str_);
86	int *tracefs_event_file_clear*(struct tracefs_instance pass:[*]_instance_, const char pass:[*]_system_, const char pass:[*]_event_,
87			     const char pass:[*]_file_);
88	bool *tracefs_event_file_exists*(struct tracefs_instance pass:[*]_instance_, const char pass:[*]_system_, const char pass:[*]_event_,
89
90Event filters:
91	int *tracefs_filter_string_append*(struct tep_event pass:[*]_event_, char pass:[**]_filter_,
92					 struct tracefs_filter _type_, const char pass:[*]_field_,
93					 enum tracefs_synth_compare _compare_, const char pass:[*]_val_);
94	int *tracefs_filter_string_verify*(struct tep_event pass:[*]_event_, const char pass:[*]_filter_, char pass:[**]_err_);
95	int *tracefs_event_filter_apply*(struct tracefs_instance pass:[*]_instance_, struct tep_event pass:[*]_event_, const char pass:[*]_filter_);
96	int *tracefs_event_filter_clear*(struct tracefs_instance pass:[*]_instance_, struct tep_event pass:[*]_event_);
97
98Function filters:
99	int *tracefs_function_filter*(struct tracefs_instance pass:[*]_instance_, const char pass:[*]_filter_, const char pass:[*]_module_, int _flags_);
100	int *tracefs_function_notrace*(struct tracefs_instance pass:[*]_instance_, const char pass:[*]_filter_, const char pass:[*]_module_, int _flags_);
101	int *tracefs_filter_functions*(const char pass:[*]_filter_, const char pass:[*]_module_, char pass:[*]pass:[*]pass:[*]_list_);
102
103Trace helper functions:
104	void *tracefs_list_free*(char pass:[*]pass:[*]_list_);
105	char pass:[**]*tracefs_list_add*(char **_list_, const char *_string_);
106	int *tracefs_list_size*(char pass:[**]_list_);
107	char pass:[*]*tracefs_get_clock*(struct tracefs_instance pass:[*]_instance_);
108	int *tracefs_trace_is_on*(struct tracefs_instance pass:[*]_instance_);
109	int *tracefs_trace_on*(struct tracefs_instance pass:[*]_instance_);
110	int *tracefs_trace_off*(struct tracefs_instance pass:[*]_instance_);
111	int *tracefs_trace_on_get_fd*(struct tracefs_instance pass:[*]_instance_);
112	int *tracefs_trace_on_fd*(int _fd_);
113	int *tracefs_trace_off_fd*(int _fd_);
114
115Trace stream:
116	ssize_t *tracefs_trace_pipe_stream*(int _fd_, struct tracefs_instance pass:[*]_instance_, int _flags_);
117	ssize_t *tracefs_trace_pipe_print*(struct tracefs_instance pass:[*]_instance_, int _flags_);
118	void *tracefs_trace_pipe_stop*(struct tracefs_instance pass:[*]_instance_);
119
120Trace options:
121	const struct tracefs_options_mask pass:[*]*tracefs_options_get_supported*(struct tracefs_instance pass:[*]_instance_);
122	bool *tracefs_option_is_supported*(struct tracefs_instance pass:[*]_instance_, enum tracefs_option_id _id_);
123	const struct tracefs_options_mask pass:[*]*tracefs_options_get_enabled*(struct tracefs_instance pass:[*]_instance_);
124	bool *tracefs_option_is_enabled*(struct tracefs_instance pass:[*]_instance_, enum tracefs_option_id _id_);
125	bool *tracefs_option_mask_is_set*(const struct tracefs_options_mask *options, enum tracefs_option_id id);
126	int *tracefs_option_enable*(struct tracefs_instance pass:[*]_instance_, enum tracefs_option_id _id_);
127	int *tracefs_option_disable*(struct tracefs_instance pass:[*]_instance_, enum tracefs_option_id _id_);
128	const char pass:[*]*tracefs_option_name*(enum tracefs_option_id _id_);
129	enum tracefs_option_id *tracefs_option_id*(const char pass:[*]_name_);
130
131Ftrace tracers:
132	char pass:[*]pass:[*]*tracefs_tracers*(const char pass:[*]_tracing_dir_);
133	bool *tracefs_tracer_available*(const char pass:[*]_tracing_dir_, const char pass:[*]_tracer_);
134	int *tracefs_tracer_set*(struct tracefs_instance pass:[*]_instance_, enum tracefs_tracers _tracer_);
135	int *tracefs_tracer_set*(struct tracefs_instance pass:[*]_instance_, enum tracefs_tracers _tracer_, const char pass:[*]_name_);
136	int *tracefs_tracer_clear*(struct tracefs_instance pass:[*]_instance_);
137
138Writing data in the trace buffer:
139	int *tracefs_print_init*(struct tracefs_instance pass:[*]_instance_);
140	int *tracefs_printf*(struct tracefs_instance pass:[*]_instance_, const char pass:[*]_fmt_, _..._);
141	int *tracefs_vprintf*(struct tracefs_instance pass:[*]_instance_, const char pass:[*]_fmt_, va_list _ap_);
142	void *tracefs_print_close*(struct tracefs_instance pass:[*]_instance_);
143	int *tracefs_binary_init*(struct tracefs_instance pass:[*]_instance_);
144	int *tracefs_binary_write*(struct tracefs_instance pass:[*]_instance_, void pass:[*]_data_, int _len_);
145	void *tracefs_binary_close*(struct tracefs_instance pass:[*]_instance_);
146
147Control library logs:
148	int *tracefs_set_loglevel*(enum tep_loglevel _level_);
149
150Dynamic event generic APIs:
151	struct *tracefs_dynevent*;
152	enum *tracefs_dynevent_type*;
153	int *tracefs_dynevent_create*(struct tracefs_dynevent pass:[*]_devent_);
154	int *tracefs_dynevent_destroy*(struct tracefs_dynevent pass:[*]_devent_, bool _force_);
155	int *tracefs_dynevent_destroy_all*(unsigned int _types_, bool _force_);
156	void *tracefs_dynevent_free*(struct tracefs_dynevent pass:[*]_devent_);
157	void *tracefs_dynevent_list_free*(struct tracefs_dynevent pass:[*]pass:[*]_events_);
158	struct tracefs_dynevent pass:[*]*tracefs_dynevent_get*(enum tracefs_dynevent_type _type_, const char pass:[*]_system_, const char pass:[*]_event_);
159	struct tracefs_dynevent pass:[*]pass:[*]*tracefs_dynevent_get_all*(unsigned int _types_, const char pass:[*]_system_);
160	enum tracefs_dynevent_type *tracefs_dynevent_info*(struct tracefs_dynevent pass:[*]_dynevent_, char pass:[*]pass:[*]_system_, char pass:[*]pass:[*]_event_, char pass:[*]pass:[*]_prefix_, char pass:[*]pass:[*]_addr_, char pass:[*]pass:[*]_format_);
161	struct tep_event pass:[*]*tracefs_dynevent_get_event*(struct tep_handle pass:[*]_tep_, struct tracefs_dynevent pass:[*]_dynevent_);
162
163Even probes (eprobes):
164	struct tracefs_dynevent pass:[*] *tracefs_eprobe_alloc*(const char pass:[*]_system_, const char pass:[*]_event_, const char pass:[*]_target_system_, const char pass:[*]_target_event_, const char pass:[*]_fetchargs_);
165
166Uprobes, Kprobes and Kretprobes:
167	struct tracefs_dynevent pass:[*] *tracefs_kprobe_alloc*(const char pass:[*]_system_, const char pass:[*]_event_, const char pass:[*]_addr_, const char pass:[*]_format_);
168	struct tracefs_dynevent pass:[*] *tracefs_kretprobe_alloc*(const char pass:[*]_system_, const char pass:[*]_event_, const char pass:[*]_addr_, const char pass:[*]_format_, unsigned int _max_);
169	int *tracefs_kprobe_raw*(const char pass:[*]_system_, const char pass:[*]_event_, const char pass:[*]_addr_, const char pass:[*]_format_);
170	int *tracefs_kretprobe_raw*(const char pass:[*]_system_, const char pass:[*]_event_, const char pass:[*]_addr_, const char pass:[*]_format_);
171	*tracefs_uprobe_alloc*(const char pass:[*]_system_, const char pass:[*]_event_,
172		     const char pass:[*]_file_, unsigned long long _offset_, const char pass:[*]_fetchargs_)
173	*tracefs_uretprobe_alloc*(const char pass:[*]_system_, const char pass:[*]_event_,
174		     const char pass:[*]_file_, unsigned long long _offset_, const char pass:[*]_fetchargs_);
175
176Synthetic events:
177	struct tracefs_synth pass:[*]*tracefs_sql*(struct tep_handle pass:[*]_tep_, const char pass:[*]_name_,
178					const char pass:[*]_sql_buffer_, char pass:[**]_err_);
179	struct tracefs_synth pass:[*]*tracefs_synth_alloc*(struct tep_handle pass:[*]_tep_,
180						 const char pass:[*]_name_,
181						 const char pass:[*]_start_system_,
182						 const char pass:[*]_start_event_,
183						 const char pass:[*]_end_system_,
184						 const char pass:[*]_end_event_,
185						 const char pass:[*]_start_match_field_,
186						 const char pass:[*]_end_match_field_,
187						 const char pass:[*]_match_name_);
188	int *tracefs_synth_add_match_field*(struct tracefs_synth pass:[*]_synth_,
189					  const char pass:[*]_start_match_field_,
190					  const char pass:[*]_end_match_field_,
191					  const char pass:[*]_name_);
192	int *tracefs_synth_add_compare_field*(struct tracefs_synth pass:[*]_synth_,
193					    const char pass:[*]_start_compare_field_,
194					    const char pass:[*]_end_compare_field_,
195					    enum tracefs_synth_calc _calc_,
196					    const char pass:[*]_name_);
197	int *tracefs_synth_add_start_field*(struct tracefs_synth pass:[*]_synth_,
198					  const char pass:[*]_start_field_,
199					  const char pass:[*]_name_);
200	int *tracefs_synth_add_end_field*(struct tracefs_synth pass:[*]_synth_,
201					const char pass:[*]_end_field_,
202					const char pass:[*]_name_);
203	int *tracefs_synth_append_start_filter*(struct tracefs_synth pass:[*]_synth_,
204					      struct tracefs_filter _type_,
205					      const char pass:[*]_field_,
206					      enum tracefs_synth_compare _compare_,
207					      const char pass:[*]_val_);
208	int *tracefs_synth_append_end_filter*(struct tracefs_synth pass:[*]_synth_,
209					    struct tracefs_filter _type_,
210					    const char pass:[*]_field_,
211					    enum tracefs_synth_compare _compare_,
212					    const char pass:[*]_val_);
213	void *tracefs_synth_free*(struct tracefs_synth pass:[*]_synth_);
214	int *tracefs_synth_create*(struct tracefs_synth pass:[*]_synth_);
215	int *tracefs_synth_destroy*(struct tracefs_synth pass:[*]_synth_);
216	int *tracefs_synth_echo_cmd*(struct trace_seq pass:[*]_seq_, struct tracefs_synth pass:[*]_synth_);
217	bool *tracefs_synth_complete*(struct tracefs_synth pass:[*]_synth_);
218	struct tracefs_hist pass:[*]*tracefs_synth_get_start_hist*(struct tracefs_synth pass:[*]_synth_);
219	int *tracefs_synth_trace*(struct tracefs_synth pass:[*]_synth_,
220				enum tracefs_synth_handler _type_, const char pass:[*]_var_);
221	int *tracefs_synth_snapshot*(struct tracefs_synth pass:[*]_synth_,
222				   enum tracefs_synth_handler _type_, const char pass:[*]_var_);
223	int *tracefs_synth_save*(struct tracefs_synth pass:[*]_synth_,
224			       enum tracefs_synth_handler _type_, const char pass:[*]_var_,
225			       char pass:[**]_save_fields_);
226	const char pass:[*]*tracefs_synth_get_name*(struct tracefs_synth pass:[*]_synth_);
227	int *tracefs_synth_raw_fmt*(struct trace_seq pass:[*]_seq_, struct tracefs_synth pass:[*]_synth_);
228	const char pass:[*]*tracefs_synth_show_event*(struct tracefs_synth pass:[*]_synth_);
229	const char pass:[*]*tracefs_synth_show_start_hist*(struct tracefs_synth pass:[*]_synth_);
230	const char pass:[*]*tracefs_synth_show_end_hist*(struct tracefs_synth pass:[*]_synth_);
231	struct tep_event pass:[*]*tracefs_synth_get_event*(struct tep_handle pass:[*]_tep_, struct tracefs_synth pass:[*]_synth_);
232
233Ftrace errors reporting:
234	char pass:[*]*tracefs_error_last*(struct tracefs_instance pass:[*]_instance_);
235	char pass:[*]*tracefs_error_all*(struct tracefs_instance pass:[*]_instance_);
236	int *tracefs_error_clear*(struct tracefs_instance pass:[*]_instance_);
237
238Histograms:
239	struct tracefs_hist pass:[*]*tracefs_hist_alloc*(struct tracefs_tep pass:[*] _tep_,
240				const char pass:[*]_system_, const char pass:[*]_event_,
241				const char pass:[*]_key_, enum tracefs_hist_key_type _type_);
242	struct tracefs_hist pass:[*]*tracefs_hist_alloc_2d*(struct tracefs_tep pass:[*] _tep_,
243				const char pass:[*]_system_, const char pass:[*]_event_,
244				const char pass:[*]_key1_, enum tracefs_hist_key_type _type1_,
245				const char pass:[*]_key2_, enum tracefs_hist_key_type _type2_));
246	struct tracefs_hist pass:[*]*tracefs_hist_alloc_nd*(struct tracefs_tep pass:[*] _tep_,
247				const char pass:[*]_system_, const char pass:[*]_event_,
248				struct tracefs_hist_axis pass:[*]_axes_);
249	struct tracefs_hist pass:[*]*tracefs_hist_alloc_nd_cnt*(struct tep_handle pass:[*]_tep_,
250				  const char pass:[*]_system_, const char pass:[*]_event_name_,
251				  struct tracefs_hist_axis_cnt pass:[*]_axes_);
252	void *tracefs_hist_free*(struct tracefs_hist pass:[*]_hist_);
253	int *tracefs_hist_add_key*(struct tracefs_hist pass:[*]_hist_, const char pass:[*]_key_,
254				 enum tracefs_hist_key_type _type_);
255	int *tracefs_hist_add_key_cnt*(struct tracefs_hist pass:[*]_hist_, const char pass:[*]_key_,
256				 enum tracefs_hist_key_type _type_, int _cnt_);
257	int *tracefs_hist_add_value*(struct tracefs_hist pass:[*]_hist_, const char pass:[*]_value_);
258	int *tracefs_hist_add_sort_key*(struct tracefs_hist pass:[*]_hist_,
259				      const char pass:[*]_sort_key_);
260	int *tracefs_hist_set_sort_key*(struct tracefs_hist pass:[*]_hist_,
261				      const char pass:[*]_sort_key_, _..._);
262	int *tracefs_hist_sort_key_direction*(struct tracefs_hist pass:[*]_hist_,
263					    const char pass:[*]_sort_key_,
264					    enum tracefs_hist_sort_direction _dir_);
265	int *tracefs_hist_add_name*(struct tracefs_hist pass:[*]_hist_, const char pass:[*]_name_);
266	int *tracefs_hist_append_filter*(struct tracefs_hist pass:[*]_hist_,
267				       enum tracefs_filter _type_,
268				       const char pass:[*]_field_,
269				       enum tracefs_compare _compare_,
270				       const char pass:[*]_val_);
271	int *tracefs_hist_echo_cmd*(struct trace_seq pass:[*]_s_, struct tracefs_instance pass:[*]_instance_,
272				  struct tracefs_hist pass:[*]_hist_,
273				  enum tracefs_hist_command _command_);
274	int *tracefs_hist_command*(struct tracefs_instance pass:[*]_instance_,
275				 struct tracefs_hist pass:[*]_hist_,
276				 enum tracefs_hist_command _command_);
277	const char pass:[*]*tracefs_hist_get_name*(struct tracefs_hist pass:[*]_hist_);
278	const char pass:[*]*tracefs_hist_get_event*(struct tracefs_hist pass:[*]_hist_);
279	const char pass:[*]*tracefs_hist_get_system*(struct tracefs_hist pass:[*]_hist_);
280	int *tracefs_hist_start*(struct tracefs_instance pass:[*]_instance_, struct tracefs_hist pass:[*]_hist_);
281	int *tracefs_hist_destroy*(struct tracefs_instance pass:[*]_instance_, struct tracefs_hist pass:[*]_hist_);
282	int *tracefs_hist_pause*(struct tracefs_instance pass:[*]_instance_, struct tracefs_hist pass:[*]_hist_);
283	int *tracefs_hist_continue*(struct tracefs_instance pass:[*]_instance_, struct tracefs_hist pass:[*]_hist_);
284	int *tracefs_hist_reset*(struct tracefs_instance pass:[*]_instance_, struct tracefs_hist pass:[*]_hist_);
285
286Recording of trace_pipe_raw files:
287	struct tracefs_cpu pass:[*]*tracefs_cpu_open*(struct tracefs_instance pass:[*]_instance_,
288					     int _cpu_, bool _nonblock_);
289	struct tracefs_cpu pass:[*]*tracefs_cpu_alloc_fd*(int _fd_, int _subbuf_size_, bool _nonblock_);
290	void *tracefs_cpu_close*(struct tracefs_cpu pass:[*]_tcpu_);
291	void *tracefs_cpu_free_fd*(struct tracefs_cpu pass:[*]_tcpu_);
292	int *tracefs_cpu_read_size*(struct tracefs_cpu pass:[*]_tcpu_);
293	int *tracefs_cpu_read*(struct tracefs_cpu pass:[*]_tcpu_, void pass:[*]_buffer_, bool _nonblock_);
294	int *tracefs_cpu_buffered_read*(struct tracefs_cpu pass:[*]_tcpu_, void pass:[*]_buffer_, bool _nonblock_);
295	int *tracefs_cpu_write*(struct tracefs_cpu pass:[*]_tcpu_, int _wfd_, bool _nonblock_);
296	int *tracefs_cpu_stop*(struct tracefs_cpu pass:[*]_tcpu_);
297	int *tracefs_cpu_flush*(struct tracefs_cpu pass:[*]_tcpu_, void pass:[*]_buffer_);
298	int *tracefs_cpu_flush_write*(struct tracefs_cpu pass:[*]_tcpu_, int _wfd_);
299	int *tracefs_cpu_pipe*(struct tracefs_cpu pass:[*]_tcpu_, int _wfd_, bool _nonblock_);
300
301--
302
303DESCRIPTION
304-----------
305The libtracefs(3) library provides APIs to access kernel trace file system.
306
307FILES
308-----
309[verse]
310--
311*tracefs.h*
312	Header file to include in order to have access to the library APIs.
313*-ltracefs*
314	Linker switch to add when building a program that uses the library.
315--
316
317SEE ALSO
318--------
319*libtraceevent*(3),
320*trace-cmd*(1)
321
322AUTHOR
323------
324[verse]
325--
326*Steven Rostedt* <[email protected]>
327*Tzvetomir Stoyanov* <[email protected]>
328--
329REPORTING BUGS
330--------------
331Report bugs to  <[email protected]>
332
333LICENSE
334-------
335libtracefs is Free Software licensed under the GNU LGPL 2.1
336
337RESOURCES
338---------
339https://git.kernel.org/pub/scm/libs/libtrace/libtracefs.git/
340
341COPYING
342-------
343Copyright \(C) 2020 VMware, Inc. Free use of this software is granted under
344the terms of the GNU Public License (GPL).
345