Back to index

glibc  2.9
execinfo.h
Go to the documentation of this file.
00001 /* Copyright (C) 1998, 1999, 2004, 2005 Free Software Foundation, Inc.
00002    This file is part of the GNU C Library.
00003 
00004    The GNU C Library is free software; you can redistribute it and/or
00005    modify it under the terms of the GNU Lesser General Public
00006    License as published by the Free Software Foundation; either
00007    version 2.1 of the License, or (at your option) any later version.
00008 
00009    The GNU C Library is distributed in the hope that it will be useful,
00010    but WITHOUT ANY WARRANTY; without even the implied warranty of
00011    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00012    Lesser General Public License for more details.
00013 
00014    You should have received a copy of the GNU Lesser General Public
00015    License along with the GNU C Library; if not, write to the Free
00016    Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
00017    02111-1307 USA.  */
00018 
00019 #ifndef _EXECINFO_H
00020 #define _EXECINFO_H 1
00021 
00022 #include <features.h>
00023 
00024 __BEGIN_DECLS
00025 
00026 /* Store up to SIZE return address of the current program state in
00027    ARRAY and return the exact number of values stored.  */
00028 extern int backtrace (void **__array, int __size) __nonnull ((1));
00029 
00030 
00031 /* Return names of functions from the backtrace list in ARRAY in a newly
00032    malloc()ed memory block.  */
00033 extern char **backtrace_symbols (void *__const *__array, int __size)
00034      __THROW __nonnull ((1));
00035 
00036 
00037 /* This function is similar to backtrace_symbols() but it writes the result
00038    immediately to a file.  */
00039 extern void backtrace_symbols_fd (void *__const *__array, int __size, int __fd)
00040      __THROW __nonnull ((1));
00041 
00042 __END_DECLS
00043 
00044 #endif /* execinfo.h  */