/*
 * libpst.h
 *
 * External interface to libpst
 *
 *  Created on: Dec 28, 2019
 *      Author: nnosov
 */

#ifndef __LIBPST_EXTERNAL_H_
#define __LIBPST_EXTERNAL_H_

//system
#include <ucontext.h>
#include <stdio.h>
#include <stdint.h>

typedef struct pst_handler pst_handler;

// allocate and initialize libpst handler.
pst_handler* pst_new_handler(ucontext_t* hctx);

// deallocate libpst handler
void pst_del_handler(pst_handler* h);


//
// Base unwind routines.
// Unwinds current stack trace using base information about program (i.e. print out address, function name)
//

// write stack trace information to provided file descriptor
int pst_unwind_simple(pst_handler* h, FILE* fd);

// save stack trace information to provided buffer in RAM
int pst_unwind_simple(pst_handler* h, char* buff, uint32_t buff_size);


// Advanced unwind routines.
// Unwinds current stack trace using DWARF debug sections in file if they present and print it to provided file descriptor.
// Additionally to pst_unwind_simple(...) provides types of parameters and variables in functions and their values
//

// write stack trace information to provided file descriptor
int pst_unwind_pretty(pst_handler* h, FILE* fd);

// save stack trace information to provided buffer in RAM
int pst_unwind_pretty(pst_handler* h, char* buff, uint32_t buff_size);

#endif /* __LIBPST_EXTERNAL_H_ */