Single frame of core stack trace thread.
More...
#include "../report_type.h"
#include <inttypes.h>
#include <json.h>
#include <stdbool.h>
#include <glib.h>
Go to the source code of this file.
Single frame of core stack trace thread.
Definition in file core/frame.h.
◆ sr_core_frame_append()
Appends 'item' at the end of the list 'dest'.
- Returns
- This function returns the 'dest' frame. If 'dest' is NULL, it returns the 'item' frame.
◆ sr_core_frame_append_to_str()
void sr_core_frame_append_to_str |
( |
struct sr_core_frame * |
frame, |
|
|
GString * |
dest |
|
) |
| |
Appends textual representation of the frame to the string buffer dest.
◆ sr_core_frame_calls_func()
bool sr_core_frame_calls_func |
( |
struct sr_core_frame * |
frame, |
|
|
const char * |
function_name, |
|
|
|
... |
|
) |
| |
Checks whether the frame represents a call of function with certain function name.
- Parameters
-
frame | A stack trace frame. |
... | Names of executables or shared libaries that should contain the function name. The list needs to be terminated by NULL. Just NULL will cause ANY file name to match and succeed. The name of file is searched as a substring. |
- Returns
- True if the frame corresponds to a function with function_name, residing in a specified executable or shared binary.
◆ sr_core_frame_cmp()
Compares two frames.
- Parameters
-
frame1 | It must be non-NULL pointer. It's not modified by calling this function. |
frame2 | It must be non-NULL pointer. It's not modified by calling this function. |
- Returns
- Returns 0 if the frames are same. Returns negative number if frame1 is found to be 'less' than frame2. Returns positive number if frame1 is found to be 'greater' than frame2.
◆ sr_core_frame_cmp_distance()
Compares two frames for thread distance calculations.
- Parameters
-
frame1 | It must be non-NULL pointer. It's not modified by calling this function. |
frame2 | It must be non-NULL pointer. It's not modified by calling this function. |
- Returns
- Returns 0 if the frames are same. Returns negative number if frame1 is found to be 'less' than frame2. Returns positive number if frame1 is found to be 'greater' than frame2.
◆ sr_core_frame_dup()
Creates a duplicate of the frame.
- Parameters
-
frame | It must be non-NULL pointer. The frame is not modified by calling this function. |
siblings | Whether to duplicate also siblings referenced by frame->next. If false, frame->next is not duplicated for the new frame, but it is set to NULL. |
- Returns
- This function never returns NULL. If the returned duplicate is not shallow, it must be released by calling the function sr_gdb_frame_free().
◆ sr_core_frame_free()
Releases the memory held by the frame. The frame siblings are not released.
- Parameters
-
frame | If the frame is NULL, no operation is performed. |
◆ sr_core_frame_from_json()
struct sr_core_frame * sr_core_frame_from_json |
( |
json_object * |
root, |
|
|
char ** |
error_message |
|
) |
| |
Deserializes frame structure from JSON representation.
- Parameters
-
root | JSON value to be deserialized. |
error_message | On error, *error_message will contain the description of the error. |
- Returns
- Resulting frame, or NULL on error.
◆ sr_core_frame_init()
Initializes all members of the frame structure to their default values. No memory is released, members are simply overwritten. This is useful for initializing a frame structure placed on the stack.
◆ sr_core_frame_new()
Creates and initializes a new frame structure.
- Returns
- It never returns NULL. The returned pointer must be released by calling the function sr_core_frame_free().
◆ sr_core_frame_to_json()
Returns a textual representation of the frame.
- Parameters
-
frame | It must be a non-NULL pointer. It's not modified by calling this function. |