callstack_frame.h

In this header the callstack frame object is defined.

struct callstack_frame

This structure represents a translated callstack frame.

optional_Dl_info_t info

The info of the dynamic loader if it is available.

char* binaryFile

The name of the binary file this frame originates from.

char* binaryFileRelative

The relative path of the name of the binary file.

Only available if C++ exclusive functions are enabled while compiling the library, see here for more information.

char* function

The name of the function this frame originates from.

char* sourceFile

The name of the source file this callstack frame lies in.

Can be NULL if it was not possible to map this frame to a source file.

char* sourceFileRelative

The relative path of the name of the source file.

Only available if C++ exclusive functions are enables while compiling the library, see here for more information.

unsigned long sourceLine

The line number in the source file this frame is mapped to.

Only relevant in conjunction with sourceFile.

optional_ulong_t sourceLineColumn

The source line column number if it could be deducted.

void callstack_frame_create(struct callstack_frame* self)

Initializes the given callstack frame.

struct callstack_frame* callstack_frame_new(void)

Allocates and initializes a new instance of a callstack frame object.

struct callstack_frame* callstack_frame_copy(struct callstack_frame*)

Allocates a new callstack frame object and deeply copies the given callstack frame object.

void callstack_frame_copyHere(struct callstack_frame* destination, const struct callstack_frame* source)

Copies the given callstack frame object into the given destination.

char* callstack_frame_getShortestName(const struct callstack_frame* self)

Returns the shortest binary file name available in the given callstack frame object.

char* callstack_frame_getShortestSourceFile(const struct callstack_frame* self)

Returns the shortest source file name available in the given callstack frame object.

void callstack_frame_destroy(struct callstack_frame* self)

Destructs the given callstack frame object.

void callstack_frame_delete(struct callstack_frame* self)

Destructs and de-allocates the given callstack frame object.