libtraceevent(3)

# libtraceevent(3) Manual Page

## NAME

tep_find_function,tep_find_function_address,tep_find_function_info - Find function name / start address.

## SYNOPSIS

    #include <event-parse.h>

    const char *tep_find_function(struct tep_handle *tep, unsigned long long addr);
    unsigned long long tep_find_function_address(struct tep_handle *tep, unsigned long long addr);
    int tep_find_function_info(struct tep_handle *tep, unsigned long long addr, const char **name,
                               unsigned long long *start, unsigned long *size);

## DESCRIPTION

These functions can be used to find function name and start address, by given address. The given address does not have to be exact, it will select the function that would contain it.

The tep_find_function() function returns the function name, which contains the given address addr. The tep argument is the trace event parser context.

The tep_find_function_address() function returns the function start address, by given address addr. The addr does not have to be exact, it will select the function that would contain it. The tep argument is the trace event parser context.

The tep_find_function_info() function retrieves the name, starting address (start), and the function text size of the function at address, if it is found. Note, if the tep handle has a function resolver (used by perf), then size is set to zero.

## RETURN VALUE

The tep_find_function() function returns the function name, or NULL in case it cannot be found.

The tep_find_function_address() function returns the function start address, or 0 in case it cannot be found.

The tep_find_function_info() function returns 1 if a function is found for the given address, or 0 if it is not.

## EXAMPLE

## 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.

## SEE ALSO

libtraceevent(3), trace-cmd(1)

## AUTHOR

    Steven Rostedt <rostedt@goodmis.org>, author of libtraceevent.
    Tzvetomir Stoyanov <tz.stoyanov@gmail.com>, author of this man page.

## REPORTING BUGS

Report bugs to <linux-trace-devel@vger.kernel.org>

## LICENSE

libtraceevent is Free Software licensed under the GNU LGPL 2.1

## RESOURCES

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