Changeset 73761 in vbox for trunk/include/iprt

Timestamp:

Aug 19, 2018 1:42:25 PM (6 years ago)

Author:

vboxsync

Message:

IPRT/Dbg: Added simple stack formatter for the current thread.

Location:

trunk/include/iprt

Files:

• dbg.h (modified) (2 diffs)
• mangling.h (modified) (1 diff)

trunk/include/iprt/dbg.h

@@ -269 +269 @@
      */
     DECLCALLBACKMEMBER(int, pfnReadStack)(struct RTDBGUNWINDSTATE *pThis, RTUINTPTR uSp, size_t cbToRead, void *pvDst);
-    /** User argument (usefule for pfnReadStack). */
+    /** User argument (useful for pfnReadStack). */
     void               *pvUser;
 
@@ -425 +425 @@
 
 
+/**
+ * Dump the stack of the current thread into @a pszStack.
+ *
+ * This could be a little slow as it reads image and debug info again for each call.
+ *
+ * @returns Length of string returned in @a pszStack.
+ * @param   pszStack        The output buffer.
+ * @param   cbStack         The size of the output buffer.
+ * @param   fFlags          Future flags, MBZ.
+ *
+ * @remarks Not present on all systems and contexts.
+ */
+RTDECL(size_t)          RTDbgStackDumpSelf(char *pszStack, size_t cbStack, uint32_t fFlags);
+
+
 # ifdef IN_RING3
 

trunk/include/iprt/mangling.h

@@ -758 +758 @@
 # define RTDbgModSymbolCount                            RT_MANGLER(RTDbgModSymbolCount)
 # define RTDbgModUnwindFrame                            RT_MANGLER(RTDbgModUnwindFrame)
+# define RTDbgStackDumpSelf                             RT_MANGLER(RTDbgStackDumpSelf)
 # define RTDbgSymbolAlloc                               RT_MANGLER(RTDbgSymbolAlloc)
 # define RTDbgSymbolDup                                 RT_MANGLER(RTDbgSymbolDup)