master
 1/* Copyright (C) 1998-2025 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.  */
27extern 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.  */
32extern 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.  */
38extern void backtrace_symbols_fd (void *const *__array, int __size, int __fd)
39     __THROW __nonnull ((1));
40
41__END_DECLS
42
43#endif /* execinfo.h  */