debug/execinfo.h

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