stacktrace.h

Go to the documentation of this file.

/*
    stacktrace.h
 
    Copyright (C) 2013  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_STACKTRACE_H
#define SATYR_STACKTRACE_H


 
#ifdef __cplusplus
extern "C" {
#endif
 
#include "report_type.h"
 
#include <json.h>
 
struct sr_stacktrace
{
    enum sr_report_type type;
};
 
/* Flags that influence how the bthash is computed.
 */
enum sr_bthash_flags
{
    /* Default hashing process.
     */
    SR_BTHASH_NORMAL = 1 << 0,
 
    /* Return the plaintext that would be hashed. Useful mainly for debugging.
     */
    SR_BTHASH_NOHASH = 1 << 1,
};

struct sr_stacktrace *
sr_stacktrace_parse(enum sr_report_type type, const char *input, char **error_message);

char *
sr_stacktrace_to_short_text(struct sr_stacktrace *stacktrace, int max_frames);

struct sr_thread *
sr_stacktrace_find_crash_thread(struct sr_stacktrace *stacktrace);

struct sr_thread *
sr_stacktrace_threads(struct sr_stacktrace *stacktrace);

void
sr_stacktrace_set_threads(struct sr_stacktrace *stacktrace, struct sr_thread *threads);

char *
sr_stacktrace_to_json(struct sr_stacktrace *stacktrace);

struct sr_stacktrace*
sr_stacktrace_from_json(enum sr_report_type, json_object *root, char **error_message);

struct sr_stacktrace*
sr_stacktrace_from_json_text(enum sr_report_type, const char *input, char **error_message);

char *
sr_stacktrace_get_reason(struct sr_stacktrace *stacktrace);

char *
sr_stacktrace_get_bthash(struct sr_stacktrace *stacktrace, enum sr_bthash_flags flags);

void
sr_stacktrace_free(struct sr_stacktrace *stacktrace);
 
#ifdef __cplusplus
}
#endif
 
#endif