1 /* Copyright (C) 1998-2022 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 <https://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