Configurable trace buffer sizes.

Change-Id: I6b1616da00cc6f30b2e6bade5011a3a2869b4660
Reviewed-on: http://gfw160.austin.ibm.com:8080/gerrit/571
Tested-by: Jenkins Server
Reviewed-by: Monte K. Copeland <copelanm@us.ibm.com>

1 files changed, 13 insertions, 6 deletions

diff --git a/src/include/usr/trace/trace.H b/src/include/usr/trace/trace.H
index 6450a42a1..ccc3449f0 100644
--- a/src/include/usr/trace/trace.H
+++ b/src/include/usr/trace/trace.H
@@ -149,7 +149,12 @@ public:
     static Trace& getTheInstance();
 
     /**
-     *  @brief  Initialize a trace buffer
+     *  @brief  Initialize a trace buffer. 
+     *
+     *  Size is capped at 2KB. You can request larger, but
+     *  the code in src/usr/trace/trace.C imposes 
+     *  a maximum size of 2KB. Sizes smaller than 2KB
+     *  will save space.  
      *
      *  @param [out] o_td Trace descriptor to initialize
      *  @param [in] i_comp Component name for trace buffer
@@ -159,7 +164,7 @@ public:
      */
     void initBuffer(trace_desc_t **o_td,
                     const char* i_comp,
-                    const size_t i_size );
+                    size_t i_size );
 
     /**
      *  @brief  Write component trace out to input buffer
@@ -261,13 +266,15 @@ private:
      * trace buffer.
      *
      * @param [out] o_buf Trace descriptor of component buffer to initialize.
-     * @param [in] i_comp Component name
+     * @param [in]  i_comp Component name
+     * @param [in]  i_size Size of buffer
      *
      * @return void
      *
      */
     void initValuesBuffer(trace_desc_t *o_buf,
-                          const char *i_comp);
+                          const char *i_comp,
+                          size_t i_size);
 
 
     /**
@@ -308,11 +315,11 @@ private:
     /**
      *  @brief  Reset all trace buffers
      *
-     *  TODO - Not Supported Yet
+     *  TODO - Not Supported, may have no need in Hostboot for it.
      *
      *  @return Non-zero return code on error
      */
-    int32_t resetBuf(void);
+    // int32_t resetBuf(void);
 
     /**
      *  @brief  Convert timestamp