callstack_frame.h

In this header the callstack frame object is defined.

struct callstack_frame

This structure represents a translated callstack frame.

Note

Added in version 1.1.

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.

bool sourceFileOutdated

Indicates whether the found source file has been modified since it contributed to this callstack frame.

A value of false indicates either that no modification has happened or that the modification information was not available.
A value of true indicates a modification has definitively happened.

Note

Added in version 1.2.

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.

Note

Added in version 1.1.

struct callstack_frame* callstack_frame_new(void)

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

Note

Added in version 1.1.

struct callstack_frame* callstack_frame_copy(struct callstack_frame*)

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

Note

Added in version 1.1.

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

Copies the given callstack frame object into the given destination.

Note

Added in version 1.1.

char* callstack_frame_getShortestName(const struct callstack_frame* self)

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

Note

Added in version 1.1.

char* callstack_frame_getShortestNameOr(const struct callstack_frame* self)

Returns the shortest binary file name of the given callstack frame object.

If the given callstack frame object does not have a binary file name the given fallback is returned.

Note

Added in version 1.2.

char* callstack_frame_getShortestSourceFile(const struct callstack_frame* self)

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

Note

Added in version 1.1.

char* callstack_frame_getShortestSourceFileOr(const struct callstack_frame* self)

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

If the given callstack frame object does not have a source file name the given fallback is returned.

Note

Added in version 1.2.

void callstack_frame_destroy(struct callstack_frame* self)

Destructs the given callstack frame object.

Note

Added in version 1.1.

void callstack_frame_delete(struct callstack_frame* self)

Destructs and de-allocates the given callstack frame object.

Note

Added in version 1.1.