core/frame.h

Go to the documentation of this file.

/*
    core_frame.h
 
    Copyright (C) 2011, 2012  Red Hat, Inc.
 
    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.
 
    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.
 
    You should have received a copy of the GNU General Public License along
    with this program; if not, write to the Free Software Foundation, Inc.,
    51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*/
#ifndef SATYR_CORE_FRAME_H
#define SATYR_CORE_FRAME_H

 
#ifdef __cplusplus
extern "C" {
#endif
 
#include "../report_type.h"
#include <inttypes.h>
#include <json.h>
#include <stdbool.h>
#include <glib.h>
 
struct sr_location;

struct sr_core_frame
{
    enum sr_report_type type;

    uint64_t address;

    char *build_id;
    // in ELF section
    uint64_t build_id_offset;
    // function name
    char *function_name;
    // so or executable
    char *file_name;
    char *fingerprint;

    bool fingerprint_hashed;

    struct sr_core_frame *next;
};

struct sr_core_frame *
sr_core_frame_new(void);

void
sr_core_frame_init(struct sr_core_frame *frame);

void
sr_core_frame_free(struct sr_core_frame *frame);

struct sr_core_frame *
sr_core_frame_dup(struct sr_core_frame *frame,
                  bool siblings);

bool
sr_core_frame_calls_func(struct sr_core_frame *frame,
                         const char *function_name,
                         ...);

int
sr_core_frame_cmp(struct sr_core_frame *frame1,
                  struct sr_core_frame *frame2);

int
sr_core_frame_cmp_distance(struct sr_core_frame *frame1,
                           struct sr_core_frame *frame2);

struct sr_core_frame *
sr_core_frame_append(struct sr_core_frame *dest,
                     struct sr_core_frame *item);

char *
sr_core_frame_to_json(struct sr_core_frame *frame);

struct sr_core_frame *
sr_core_frame_from_json(json_object *root,
                        char **error_message);

void
sr_core_frame_append_to_str(struct sr_core_frame *frame,
                            GString *dest);
 
#ifdef __cplusplus
}
#endif
 
#endif