Man page - tep_record_print_fields(3)
Packages contains this manual
- tep_plugin_kvm_put_func(3)
- tep_register_event_handler(3)
- trace_seq_do_fprintf(3)
- tep_print_func_field(3)
- tep_set_file_bigendian(3)
- trace_seq_reset(3)
- tep_filter_free(3)
- tep_ref(3)
- tep_list_events_copy(3)
- tep_get_any_field_val(3)
- kbuffer_missed_events(3)
- tep_load_plugins_hook(3)
- tep_set_page_size(3)
- kbuffer_event_size(3)
- tep_filter_strerror(3)
- tep_print_event(3)
- kbuffer_subbuffer(3)
- tep_set_test_filters(3)
- kbuffer_read_event(3)
- tep_filter_reset(3)
- tep_filter_compare(3)
- tep_kbuffer(3)
- tep_data_pid_from_comm(3)
- tep_find_any_field(3)
- tep_list_events(3)
- tep_get_long_size(3)
- tep_data_pid(3)
- tep_clear_flag(3)
- tep_get_sub_buffer_size(3)
- tep_print_field_content(3)
- tep_get_first_event(3)
- kbuffer_alloc(3)
- tep_find_function(3)
- tep_get_header_page_size(3)
- tep_register_comm(3)
- trace_seq_putc(3)
- kbuffer_curr_index(3)
- kbuffer_refresh(3)
- tep_record_is_event(3)
- tep_parse_kallsyms(3)
- tep_print_printk(3)
- tep_event_fields(3)
- tep_find_function_info(3)
- tep_get_events_count(3)
- tep_read_number(3)
- trace_seq_vprintf(3)
- tep_get_field_val(3)
- tep_set_function_resolver(3)
- tep_parse_saved_cmdlines(3)
- tep_parse_header_page(3)
- tep_get_page_size(3)
- tep_override_comm(3)
- tep_data_flags(3)
- kbuffer_subbuf_timestamp(3)
- kbuffer_subbuffer_size(3)
- tep_get_ref(3)
- tep_get_event(3)
- tep_alloc(3)
- tep_is_old_format(3)
- tep_find_event(3)
- kbuffer_dup(3)
- tep_unref(3)
- trace_seq_destroy(3)
- trace_seq_init(3)
- trace_seq_terminate(3)
- kbuffer_curr_offset(3)
- tep_get_field_raw(3)
- tep_plugin_kvm_get_func(3)
- tep_set_cpus(3)
- tep_set_local_bigendian(3)
- tep_data_comm_from_pid(3)
- tep_event_common_fields(3)
- tep_plugin_add_option(3)
- tep_test_flag(3)
- tep_filter_make_string(3)
- tep_unregister_event_handler(3)
- kbuffer_curr_size(3)
- tep_find_event_by_record(3)
- tep_filter_remove_event(3)
- tep_print_num_field(3)
- tep_cmdline_pid(3)
- tep_free(3)
- tep_get_sub_buffer_data_size(3)
- tep_load_plugins(3)
- tep_print_fields(3)
- tep_register_function(3)
- tep_record_print_fields(3)
- kbuffer_load_subbuffer(3)
- tep_data_preempt_count(3)
- tep_find_common_field(3)
- tep_find_event_by_name(3)
- tep_set_long_size(3)
- tep_reset_function_resolver(3)
- tep_filter_alloc(3)
- kbuffer_timestamp(3)
- tep_find_field(3)
- tep_get_header_timestamp_size(3)
- tep_plugin_print_options(3)
- trace_seq_printf(3)
- tep_set_flag(3)
- tep_unload_plugins(3)
- tep_is_bigendian(3)
- trace_seq_puts(3)
- kbuffer_read_buffer(3)
- tep_unregister_print_function(3)
- tep_get_cpus(3)
- tep_get_common_field_val(3)
- kbuffer_start_of_data(3)
- tep_is_local_bigendian(3)
- tep_print_funcs(3)
- tep_is_file_bigendian(3)
- tep_filter_copy(3)
- tep_set_loglevel(3)
- tep_filter_add_filter_str(3)
- tep_data_type(3)
- tep_register_print_string(3)
- tep_filter_match(3)
- kbuffer_next_event(3)
- tep_read_number_field(3)
- tep_get_function_count(3)
- tep_find_function_address(3)
- tep_add_plugin_path(3)
- tep_parse_event(3)
- trace_seq_do_printf(3)
- kbuffer_free(3)
- tep_record_print_selected_fields(3)
- tep_parse_printk_formats(3)
- libtraceevent(3)
- tep_is_pid_registered(3)
- tep_parse_format(3)
- tep_strerror(3)
- tep_register_print_function(3)
- tep_event_filtered(3)
apt-get install libtraceevent-doc
Manual
LIBTRACEEVENT
NAMESYNOPSIS
DESCRIPTION
RETURN VALUE
EXAMPLE
FILES
SEE ALSO
AUTHOR
REPORTING BUGS
LICENSE
RESOURCES
NOTES
NAME
tep_print_field_content, tep_print_fields, tep_print_num_field, tep_print_func_field, tep_record_print_fields, tep_record_print_selected_fields - Print the field content.
SYNOPSIS
#include
<event-parse.h>
#include <trace-seq.h>
void
tep_print_field_content
(struct trace_seq *
s
,
void *
data
, int size, struct tep_format_field
*
field
);
void
tep_print_fields
(struct trace_seq *
s
,
void *
data
, int
size
, struct tep_event
*
event
);
int
tep_print_num_field
(struct trace_seq *
s
,
const char *
fmt
, struct tep_event *
event
,
const char *
name
, struct tep_record *
record
,
int
err
);
int
tep_print_func_field
(struct trace_seq *
s
,
const char *
fmt
, struct tep_event *
event
,
const char *
name
, struct tep_record *
record
,
int
err
);
void
tep_record_print_fields
(struct trace_seq
*
s
, struct tep_record *
record
, struct
tep_event *
event
);
void
tep_record_print_selected_fields
(struct
trace_seq *
s
, struct tep_record *
record
,
struct tep_event *
event
, int
select_mask
);
DESCRIPTION
These functions print recorded fieldās data, according to the fieldās type.
The tep_print_field_content() function extracts from the recorded raw data value of the field and prints it into s , according to the field type.
The tep_print_fields() prints each field name followed by the recordās field value according to the fieldās type:
"field1_name=field1_value field2_name=field2_value ..."
It iterates all fields of the event , and calls tep_print_field_content() for each of them.
The tep_print_num_field() function prints a numeric field with given format string. A search is performed in the event for a field with name . If such field is found, its value is extracted from the record and is printed in the s , according to the given format string fmt . If the argument err is non-zero, and an error occures - it is printed in the s .
The tep_print_func_field() function prints a function field with given format string. A search is performed in the event for a field with name . If such field is found, its value is extracted from the record . The value is assumed to be a function address, and a search is perform to find the name of this function. The function name (if found) and its address are printed in the s , according to the given format string fmt . If the argument err is non-zero, and an error occures - it is printed in s .
The tep_record_print_fields() prints the fieldās name followed by its value for all recordās field.
The tep_record_print_selected_fields() prints the fieldās name followed by its value for selected subset of record field. The fields to be printed are defined by the select_mask bit mask.
RETURN VALUE
The tep_print_num_field() and tep_print_func_field() functions return 1 on success, -1 in case of an error or 0 if the print buffer s is full.
EXAMPLE
#include
<event-parse.h>
#include <trace-seq.h>
...
struct tep_handle *tep = tep_alloc();
...
struct trace_seq seq;
trace_seq_init(&seq);
struct tep_event *event = tep_find_event_by_name(tep,
"timer", "hrtimer_start");
...
void process_record(struct tep_record *record)
{
struct tep_format_field *field_pid =
tep_find_common_field(event, "common_pid");
trace_seq_reset(&seq);
/* Print the
value of "common_pid" */
tep_print_field_content(&seq, record->data,
record->size, field_pid);
/* Print all
fields of the "hrtimer_start" event */
tep_print_fields(&seq, record->data, record->size,
event);
/* Print the
value of "expires" field with custom format string
*/
tep_print_num_field(&seq, " timer expires in %llu
", event, "expires", record, 0);
/* Print the
address and the name of "function" field with
custom format string */
tep_print_func_field(&seq, " timer function is %s
", event, "function", record, 0);
}
...
FILES
event-parse.h
Header file to include in order to have access to the
library APIs.
trace-seq.h
Header file to include in order to have access to trace
sequences related APIs.
Trace sequences are used to allow a function to call several
other functions
to create a string of data to use.
-ltraceevent
Linker switch to add when building a program that uses the
library.
SEE ALSO
libtraceevent (3), trace-cmd (1)
AUTHOR
Steven
Rostedt
<
rostedt@goodmis.org
[1]
>, author of
libtraceevent
.
Tzvetomir Stoyanov
<
tz.stoyanov@gmail.com
[2]
>, author of this man
page.
REPORTING BUGS
Report bugs to < linux-trace-devel@vger.kernel.org [3] >
LICENSE
libtraceevent is Free Software licensed under the GNU LGPL 2.1
RESOURCES
https://git.kernel.org/pub/scm/libs/libtrace/libtraceevent.git/
NOTES
|
1. |
rostedt@goodmis.org |
mailto:rostedt@goodmis.org
|
2. |
tz.stoyanov@gmail.com |
mailto:tz.stoyanov@gmail.com
|
3. |
linux-trace-devel@vger.kernel.org |
mailto:linux-trace-devel@vger.kernel.org