1 /* Copyright (C) 1998, 1999, 2004, 2005 Free Software Foundation, Inc.
2    This file is part of the GNU C Library.
3 
4    The GNU C Library is free software; you can redistribute it and/or
5    modify it under the terms of the GNU Lesser General Public
6    License as published by the Free Software Foundation; either
7    version 2.1 of the License, or (at your option) any later version.
8 
9    The GNU C Library is distributed in the hope that it will be useful,
10    but WITHOUT ANY WARRANTY; without even the implied warranty of
11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12    Lesser General Public License for more details.
13 
14    You should have received a copy of the GNU Lesser General Public
15    License along with the GNU C Library; if not, see
16    <http://www.gnu.org/licenses/>.  */
17 
18 #ifndef _EXECINFO_H
19 #define _EXECINFO_H 1
20 
21 #include <features.h>
22 
23 __BEGIN_DECLS
24 
25 /* Store up to SIZE return address of the current program state in
26    ARRAY and return the exact number of values stored.  */
27 extern int backtrace (void **__array, int __size) __nonnull ((1));
28 
29 
30 /* Return names of functions from the backtrace list in ARRAY in a newly
31    malloc()ed memory block.  */
32 extern char **backtrace_symbols (void *const *__array, int __size)
33      __THROW __nonnull ((1));
34 
35 
36 /* This function is similar to backtrace_symbols() but it writes the result
37    immediately to a file.  */
38 extern void backtrace_symbols_fd (void *const *__array, int __size, int __fd)
39      __THROW __nonnull ((1));
40 
41 __END_DECLS
42 
43 #endif /* execinfo.h  */
44