aboutsummaryrefslogtreecommitdiff
path: root/include/sframe-backtrace-api.h
blob: b9537bf5435df6470a4547d9a97e7c6275a73857 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
/* Public API to SFrame backtrace.

   Copyright (C) 2022 Free Software Foundation, Inc.

   This file is part of libsframebt.

   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 3 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, see <http://www.gnu.org/licenses/>.  */

#ifndef	_SFRAME_BACKTRACE_API_H
#define	_SFRAME_BACKTRACE_API_H

#ifdef	__cplusplus
extern "C"
{
#endif

enum sframe_bt_errcode
{
  SFRAME_BT_OK,
  SFRAME_BT_ERR_NOTPRESENT,
  SFRAME_BT_ERR_ARG,
  SFRAME_BT_ERR_MALLOC,
  SFRAME_BT_ERR_REALLOC,
  SFRAME_BT_ERR_OPEN,
  SFRAME_BT_ERR_READLINK,
  SFRAME_BT_ERR_LSEEK,
  SFRAME_BT_ERR_READ,
  SFRAME_BT_ERR_GETCONTEXT,
  SFRAME_BT_ERR_DECODE,
  SFRAME_BT_ERR_CFA_OFFSET,
};

#define NUM_OF_DSOS	32			/* Number of DSOs.  */

#define ENUM_ARRAY_SIZE(a) (sizeof (a) / sizeof ((a)[0]))

/* Get the backtrace of the calling program by storing return addresses
   in BUFFER. The SIZE argument specifies the maximum number of addresses
   that can be stored in the buffer. Return the number of return addresses
   collected or -1 if there is any error.  */
extern int sframe_backtrace (void **buffer, int size, int *errp);

extern const char *sframe_bt_errmsg (enum sframe_bt_errcode ecode);

#ifdef	__cplusplus
}
#endif

#endif				/* _SFRAME_BACKTRACE_API_H */