Error Log Backtrace Support

	This code collects the addresses for each of the frames, but does not
	parse the data.  The support to do this isn't available in the errl
	parser as of yet.

Change-Id: I4804ab100fc376e26ef908c472c94202b4642aac
Reviewed-on: http://gfw160.austin.ibm.com:8080/gerrit/515
Tested-by: Jenkins Server
Reviewed-by: Terry J. Opie <opiet@us.ibm.com>

1 files changed, 60 insertions, 0 deletions

diff --git a/src/include/usr/errl/backtrace.H b/src/include/usr/errl/backtrace.H
new file mode 100755
index 000000000..5db0081d3
--- /dev/null
+++ b/src/include/usr/errl/backtrace.H
@@ -0,0 +1,60 @@
+//  IBM_PROLOG_BEGIN_TAG
+//  This is an automatically generated prolog.
+//
+//  $Source: src/include/usr/errl/backtrace.H $
+//
+//  IBM CONFIDENTIAL
+//
+//  COPYRIGHT International Business Machines Corp. 2011
+//
+//  p1
+//
+//  Object Code Only (OCO) source materials
+//  Licensed Internal Code Source Materials
+//  IBM HostBoot Licensed Internal Code
+//
+//  The source code for this program is not published or other-
+//  wise divested of its trade secrets, irrespective of what has
+//  been deposited with the U.S. Copyright Office.
+//
+//  Origin: 30
+//
+//  IBM_PROLOG_END
+#ifndef __BACKTRACE_H
+#define __BACKTRACE_H
+/**
+ *  @file backtrace.H
+ *
+ *  @brief  Backtrace support for errorlog classes.
+ *  This header provides the interfaces for errorlog, or any other user
+ *  code to gather backtraces for the current location in the code.
+ *
+ */
+
+/*****************************************************************************/
+// I n c l u d e s
+/*****************************************************************************/
+#include <stdint.h>
+#include <errl/errltypes.H>
+#include <vector>
+
+
+namespace ERRORLOG
+{
+
+/**
+* @brief This function will be called during errorlog creation and will
+*       add an FFDC section that contains the addresses needed for
+*       decoding the backtrace at a later time.  The later time would be
+*       when error log details are printed.
+*
+* @param[out] i_addrVector - Vector of addresses collected.
+*
+* @return None.
+*/
+void collectBacktrace ( std::vector<uint64_t> & o_addrVector );
+
+
+} // End namespace
+
+#endif //__BACKTRACE_H