trace.cpp.hpp

Go to the documentation of this file.

 
#include "fl/system/trace.h"
 
#include "fl/stl/vector.h"
#include "fl/stl/string.h"
#include "fl/stl/chrono.h"
#include "fl/log/log.h"
#include "fl/stl/singleton.h"
#include "fl/stl/stdio.h"
#include "fl/stl/noexcept.h"
 
// Configuration: Maximum stack depth (can be overridden at compile time)
#ifndef FL_STACK_TRACE_MAX_DEPTH
#define FL_STACK_TRACE_MAX_DEPTH 32
#endif
 
namespace fl {

struct TraceEntry {
    const char* function;
    int line;
 
    TraceEntry() FL_NO_EXCEPT : function(nullptr), line(0) {}
    TraceEntry(const char* f, int l) FL_NO_EXCEPT : function(f), line(l) {}
};

struct TraceStorage {
    // Call stack storage using FixedVector for bounds checking
    FixedVector<TraceEntry, FL_STACK_TRACE_MAX_DEPTH> callStack;
 
    // Separate depth counter to track actual stack depth (can exceed capacity)
    // This allows us to detect overflow conditions without corrupting the stack
    fl::size stackDepth = 0;
};
 
// Thread-local storage for trace data
// When trace functions are not used, the optimizer can eliminate this entirely
static TraceStorage& getTraceStorage() FL_NO_EXCEPT {
    return SingletonThreadLocal<TraceStorage>::instance();
}
 
// ScopedTrace static method implementations
void ScopedTrace::push(const char* function, int line) FL_NO_EXCEPT {
    if (!function) {
        return;  // Ignore null function names
    }
 
    auto& storage = getTraceStorage();
 
    // Always increment depth counter (tracks true depth even on overflow)
    storage.stackDepth++;
 
    // Only push to storage if we have capacity
    if (storage.callStack.size() < FL_STACK_TRACE_MAX_DEPTH) {
        storage.callStack.push_back(TraceEntry(function, line));
    }
    // If size >= MAX_DEPTH, we're in overflow - just track depth
}
 
void ScopedTrace::pop() FL_NO_EXCEPT {
    auto& storage = getTraceStorage();
 
    // Guard against underflow
    if (storage.stackDepth == 0) {
        return;
    }
 
    // Decrement depth counter first
    storage.stackDepth--;
 
    // Pop from callStack only if:
    // 1. We have entries in the stack
    // 2. After decrement, depth matches or is less than callStack size
    //    (this handles both normal operation and overflow recovery)
    if (!storage.callStack.empty() && storage.stackDepth < storage.callStack.size()) {
        // Use manual pop since FixedVector doesn't have pop_back
        storage.callStack.resize(storage.callStack.size() - 1);
    }
}
 
fl::size ScopedTrace::depth() FL_NO_EXCEPT {
    return getTraceStorage().stackDepth;
}
 
fl::string ScopedTrace::dump() FL_NO_EXCEPT {
    auto& storage = getTraceStorage();
    fl::string result = "Stack trace (depth ";
 
    char depth_str[32];
    fl::snprintf(depth_str, sizeof(depth_str), "%zu", (size_t)storage.stackDepth);
    result += depth_str;
    result += "):\n";
 
    if (storage.callStack.empty()) {
        result += "  <empty>\n";
        return result;
    }
 
    // Show overflow warning if depth exceeds capacity
    if (storage.stackDepth > FL_STACK_TRACE_MAX_DEPTH) {
        result += "  <WARNING: Stack overflow - showing last ";
        char max_str[32];
        fl::snprintf(max_str, sizeof(max_str), "%d", FL_STACK_TRACE_MAX_DEPTH);
        result += max_str;
        result += " of ";
        result += depth_str;
        result += " entries>\n";
    }
 
    // Dump all stored entries in format: functionName(lineNo)
    for (fl::size i = 0; i < storage.callStack.size(); ++i) {
        const auto& entry = storage.callStack[i];
        char line_buf[256];
        if (entry.line > 0) {
            fl::snprintf(line_buf, sizeof(line_buf), "  [%zu] %s(%d)\n", (size_t)i, entry.function, entry.line);
        } else {
            fl::snprintf(line_buf, sizeof(line_buf), "  [%zu] %s\n", (size_t)i, entry.function);
        }
        result += line_buf;
    }
 
    return result;
}
 
void ScopedTrace::dump(fl::vector<TracePoint>* out) FL_NO_EXCEPT {
    if (!out) {
        return;
    }
 
    auto& storage = getTraceStorage();
    out->clear();
 
    // Copy all stored entries to the output vector as TracePoints
    for (fl::size i = 0; i < storage.callStack.size(); ++i) {
        const auto& entry = storage.callStack[i];
        // TracePoint is tuple<const char*, int, fl::u32> (file, line, timestamp)
        // Since we don't store file or timestamp, we'll use the function name and line
        out->push_back(fl::make_tuple(entry.function, entry.line, fl::u32(0)));
    }
}
 
void ScopedTrace::clear() FL_NO_EXCEPT {
    auto& storage = getTraceStorage();
    storage.callStack.resize(0);
    storage.stackDepth = 0;
}
 
// ScopedTrace RAII implementation
ScopedTrace::ScopedTrace(const char* function, int line) FL_NO_EXCEPT {
    push(function, line);
}
 
ScopedTrace::~ScopedTrace() FL_NO_EXCEPT {
    pop();
}
 
} // namespace fl