tep_read_number(3)

tep_read_number3

Reads a number from raw data.

Usage

#include <event-parse.h>
unsigned long long tep_read_number(struct tep_handle *tep, const void *ptr, int size);

Overview

The tep_read_number() function reads an integer from raw data, taking into account the endianness of the raw data and the current host. The tep argument is the trace event parser context. The ptr is a pointer to the raw data, where the integer is, and the size is the size of the integer.

Return value

The tep_read_number() function returns the integer in the byte order of the current host. In case of an error, 0 is returned.

Examples

#include <event-parse.h>
...
struct tep_handle *tep = tep_alloc();
...
void process_record(struct tep_record *record)
{
        int offset = 24;
        int data = tep_read_number(tep, record->data + offset, 4);
        /* Read the 4 bytes at the offset 24 of data as an integer */
}
...

Files

event-parse.h
        Header file to include in order to have access to the library APIs.
-ltraceevent
        Linker switch to add when building a program that uses the library.

Resources

https://git.kernel.org/pub/scm/libs/libtrace/libtraceevent.git/

Notes

Releases

4 releases since Debian 11 (Bullseye); the text changed 3 times.

  1. 11
  2. 12
  3. 13
  4. Arch

Author

Steven Rostedt <[email protected][1]>, author of libtraceevent.
Tzvetomir Stoyanov <[email protected][2]>, author of this man page.

Reporting bugs

Report bugs to <[email protected][3]>

License

libtraceevent is Free Software licensed under the GNU LGPL 2.1

From libtraceevent 1:1.9.1-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.