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][3] 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][3] 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.