debug/execinfo.h

   1 /* Copyright (C) 1998, 1999 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 Library General Public License as
   6    published by the Free Software Foundation; either version 2 of the
   7    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    Library General Public License for more details.
  13
  14    You should have received a copy of the GNU Library General Public
  15    License along with the GNU C Library; see the file COPYING.LIB.  If not,
  16    write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  17    Boston, MA 02111-1307, USA.  */
  18
  19 #ifndef _EXECINFO_H
  20 #define _EXECINFO_H 1
  21
  22 #include <features.h>
  23
  24 __BEGIN_DECLS
  25
  26 /* Store up to SIZE return address of the current program state in
  27    ARRAY and return the exact number of values stored.  */
  28 extern int backtrace (void **__array, int __size) __THROW;
  29
  30
  31 /* Return names of functions from the backtrace list in ARRAY in a newly
  32    malloc()ed memory block.  */
  33 extern char **backtrace_symbols (void *__const *__array, int __size) __THROW;
  34
  35
  36 /* This function is similar to backtrace_symbols() but it writes the result
  37    immediately to a file and can therefore also be used in situations where
  38    malloc() is not usable anymore.  */
  39 extern void backtrace_symbols_fd (void *__const *__array, int __size,
  40                                   int __fd) __THROW;
  41
  42 __END_DECLS
  43
  44 #endif /* execinfo.h  */