Changeset 89622 in vbox for trunk/include/VBox/vmm

Timestamp:

Jun 11, 2021 9:43:32 AM (4 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

145066

Message:

VMM/DBGFR3SampleReport: Some prototype code to allow creating guest sample reports in order to get more insight into what a guest is doing, bugref:10025

File:

• trunk/include/VBox/vmm/dbgf.h (modified) (1 diff)

trunk/include/VBox/vmm/dbgf.h

@@ -3083 +3083 @@
 /** @} */
 
+
+/** @defgroup grp_dbgf_sample_report DBGF sample report.
+ * @{ */
+
+/** @name Flags to pass to DBGFR3SampleReportCreate().
+ * @{ */
+/** The report creates the call stack in reverse order (bottom to top). */
+#define DBGF_SAMPLE_REPORT_F_UPSIDE_DOWN    RT_BIT(0)
+/** Mask containing the valid flags. */
+#define DBGF_AMPLE_REPORT_F_VALID_MASK      UINT32_C(0x00000001)
 /** @} */
 
+VMMR3DECL(int)      DBGFR3SampleReportCreate(PUVM pUVM, uint32_t cSampleIntervalMs, uint32_t fFlags, PDBGFSAMPLEREPORT phSample);
+VMMR3DECL(uint32_t) DBGFR3SampleReportRetain(DBGFSAMPLEREPORT hSample);
+VMMR3DECL(uint32_t) DBGFR3SampleReportRelease(DBGFSAMPLEREPORT hSample);
+VMMR3DECL(int)      DBGFR3SampleReportStart(DBGFSAMPLEREPORT hSample);
+VMMR3DECL(int)      DBGFR3SampleReportStop(DBGFSAMPLEREPORT hSample);
+VMMR3DECL(int)      DBGFR3SampleReportDumpToFile(DBGFSAMPLEREPORT hSample, const char *pszFilename);
+/** @} */
+
+/** @} */
+
 RT_C_DECLS_END