gdb/stacktrace.h

Go to the documentation of this file.

/*
    gdb_stacktrace.h
 
    Copyright (C) 2012  ABRT Team
    Copyright (C) 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_GDB_STACKTRACE_H
#define SATYR_GDB_STACKTRACE_H

 
#ifdef __cplusplus
extern "C" {
#endif
 
#include "../report_type.h"
#include <stdbool.h>
#include <stdint.h>
 
struct sr_gdb_thread;
struct sr_gdb_frame;
struct sr_location;

struct sr_gdb_stacktrace
{
    enum sr_report_type type;
 
    struct sr_gdb_thread *threads;

    struct sr_gdb_frame *crash;

    struct sr_gdb_sharedlib *libs;

    uint32_t crash_tid;
};

struct sr_gdb_stacktrace *
sr_gdb_stacktrace_new(void);

void
sr_gdb_stacktrace_init(struct sr_gdb_stacktrace *stacktrace);

void
sr_gdb_stacktrace_free(struct sr_gdb_stacktrace *stacktrace);

struct sr_gdb_stacktrace *
sr_gdb_stacktrace_dup(struct sr_gdb_stacktrace *stacktrace);

int
sr_gdb_stacktrace_get_thread_count(struct sr_gdb_stacktrace *stacktrace);

void
sr_gdb_stacktrace_remove_threads_except_one(struct sr_gdb_stacktrace *stacktrace,
                                            struct sr_gdb_thread *thread);

struct sr_gdb_thread *
sr_gdb_stacktrace_find_crash_thread(struct sr_gdb_stacktrace *stacktrace);

void
sr_gdb_stacktrace_limit_frame_depth(struct sr_gdb_stacktrace *stacktrace,
                                    int depth);

float
sr_gdb_stacktrace_quality_simple(struct sr_gdb_stacktrace *stacktrace);

float
sr_gdb_stacktrace_quality_complex(struct sr_gdb_stacktrace *stacktrace);

char *
sr_gdb_stacktrace_to_text(struct sr_gdb_stacktrace *stacktrace,
                          bool verbose);

struct sr_gdb_frame *
sr_gdb_stacktrace_get_crash_frame(struct sr_gdb_stacktrace *stacktrace);

void
sr_gdb_stacktrace_set_crash_tid(struct sr_gdb_stacktrace *stacktrace,
                                uint32_t tid);

struct sr_gdb_stacktrace *
sr_gdb_stacktrace_parse(const char **input,
                        struct sr_location *location);

bool
sr_gdb_stacktrace_parse_header(const char **input,
                               struct sr_gdb_frame **frame,
                               struct sr_location *location);

void
sr_gdb_stacktrace_set_libnames(struct sr_gdb_stacktrace *stacktrace);

char *
sr_gdb_stacktrace_to_short_text(struct sr_gdb_stacktrace *stacktrace,
                                int max_frames);
 
#ifdef __cplusplus
}
#endif
 
#endif