Changeset 32574 in vbox

Timestamp:

Sep 16, 2010 5:44:29 PM (14 years ago)

Author:

vboxsync

Message:

Additions/VBoxGuestLib+Additions/VBoxControl: Guest core dumps (VbglR3WriteCoreDump), untested.

Location:

trunk

Files:

• include/VBox/VBoxGuest.h (modified) (3 diffs)
• include/VBox/VBoxGuestLib.h (modified) (1 diff)
• src/VBox/Additions/common/VBoxControl/VBoxControl.cpp (modified) (4 diffs)
• src/VBox/Additions/common/VBoxGuest/VBoxGuest.cpp (modified) (2 diffs)
• src/VBox/Additions/common/VBoxGuestLib/Makefile.kmk (modified) (1 diff)
• src/VBox/Additions/common/VBoxGuestLib/VBoxGuestR3LibCoreDump.cpp (added)

trunk/include/VBox/VBoxGuest.h

@@ -240 +240 @@
 
 
-/** IOCTL to VBoxGuest to interrupt (cancel) any pending WAITEVENTs and return.
- * Handled inside the guest additions and not seen by the host at all.
- * @see VBOXGUEST_IOCTL_WAITEVENT */
-#define VBOXGUEST_IOCTL_CANCEL_ALL_WAITEVENTS       VBOXGUEST_IOCTL_CODE_(5, 0)
-
-
-
 /** IOCTL to VBoxGuest to perform a VMM request
  * @remark  The data buffer for this IOCtl has an variable size, keep this in mind
@@ -265 +258 @@
 #pragma pack()
 
+/** IOCTL to VBoxGuest to interrupt (cancel) any pending WAITEVENTs and return.
+ * Handled inside the guest additions and not seen by the host at all.
+ * @see VBOXGUEST_IOCTL_WAITEVENT */
+#define VBOXGUEST_IOCTL_CANCEL_ALL_WAITEVENTS       VBOXGUEST_IOCTL_CODE_(5, 0)
+
+/** IOCTL to VBoxGuest to perform backdoor logging.
+ * The argument is a string buffer of the specified size. */
+#define VBOXGUEST_IOCTL_LOG(Size)                   VBOXGUEST_IOCTL_CODE_(6, (Size))
 
 /** IOCTL to VBoxGuest to check memory ballooning.
@@ -303 +304 @@
 AssertCompileSize(VBoxGuestChangeBalloonInfo, 16);
 
-
-/** IOCTL to VBoxGuest to perform backdoor logging.
- * The argument is a string buffer of the specified size. */
-#define VBOXGUEST_IOCTL_LOG(Size)                   VBOXGUEST_IOCTL_CODE_(6, (Size))
+/** IOCTL to VBoxGuest to write guest core. */
+#define VBOXGUEST_IOCTL_WRITE_CORE_DUMP             VBOXGUEST_IOCTL_CODE(9, sizeof(VBoxGuestWriteCoreDump))
+
+/** Input and output buffer layout of the VBOXGUEST_IOCTL_WRITE_CORE
+ *  request. */
+typedef struct VBoxGuestWriteCoreDump
+{
+    /** Flags (reserved, MBZ). */
+    uint32_t fFlags;
+} VBoxGuestWriteCoreDump;
+AssertCompileSize(VBoxGuestWriteCoreDump, 4);
 
 

trunk/include/VBox/VBoxGuestLib.h

@@ -471 +471 @@
 VBGLR3DECL(int)     VbglR3MemBalloonRefresh(uint32_t *pcChunks, bool *pfHandleInR3);
 VBGLR3DECL(int)     VbglR3MemBalloonChange(void *pv, bool fInflate);
+/** @}  */
+
+/** @name Core Dump
+ * @{ */
+VBGLR3DECL(int)     VbglR3WriteCoreDump(void);
+
 /** @}  */
 

trunk/src/VBox/Additions/common/VBoxControl/VBoxControl.cpp

@@ -82 +82 @@
     GUEST_SHAREDFOLDERS,
 #endif
+    WRITE_CORE_DUMP,
     TAKE_SNAPSHOT,
     SAVE_STATE,
@@ -132 +133 @@
 #endif
 
+    if (eWhich == WRITE_CORE_DUMP || eWhich == USAGE_ALL)
+        doUsage("", g_pszProgName, "writecoredump");
     if (eWhich == TAKE_SNAPSHOT || eWhich == USAGE_ALL)
         doUsage("", g_pszProgName, "takesnapshot");
@@ -1406 +1409 @@
  * @callback_method_impl{FNVBOXCTRLCMDHANDLER, Command: takesnapshot}
  */
+static RTEXITCODE handleWriteCoreDump(int argc, char *argv[])
+{
+    int rc = VbglR3WriteCoreDump();
+    if (RT_SUCCESS(rc))
+    {
+        RTPrintf("Successfully taking guest core\n");
+        return RTEXITCODE_SUCCESS;
+    }
+    else
+    {
+        VBoxControlError("Error while taking guest core. rc=%Rrc\n", rc);
+        return RTEXITCODE_FAILURE;
+    }
+}
+
+/**
+ * @callback_method_impl{FNVBOXCTRLCMDHANDLER, Command: takesnapshot}
+ */
 static RTEXITCODE handleTakeSnapshot(int argc, char *argv[])
 {
@@ -1484 +1505 @@
 #ifdef VBOX_WITH_SHARED_FOLDERS
     { "sharedfolder",           handleSharedFolder },
+#endif
+#if !defined(VBOX_CONTROL_TEST)
+    { "writecoredump",          handleWriteCoreDump },
 #endif
     { "takesnapshot",           handleTakeSnapshot },

trunk/src/VBox/Additions/common/VBoxGuest/VBoxGuest.cpp

@@ -1990 +1990 @@
 
 
+/**
+ * Handle a request for writing a core dump of the guest on the host.
+ *
+ * @returns VBox status code.
+ *
+ * @param pDevExt               The device extension.
+ * @param pInfo                 The output buffer.
+ */
+static int VBoxGuestCommonIOCtl_WriteCoreDump(PVBOXGUESTDEVEXT pDevExt, VBoxGuestWriteCoreDump *pInfo)
+{
+    VMMDevReqWriteCoreDump *pReq = NULL;
+    int rc = VbglGRAlloc((VMMDevRequestHeader **)&pReq, sizeof(*pReq), VMMDevReq_WriteCoreDump);
+    if (RT_FAILURE(rc))
+    {
+        Log(("VBoxGuestCommonIOCtl: WRITE_CORE_DUMP: failed to allocate %u (%#x) bytes to cache the request. rc=%Rrc!!\n",
+             sizeof(*pReq), sizeof(*pReq), rc));
+        return rc;
+    }
+
+    pReq->fFlags = pInfo->fFlags;
+    rc = VbglGRPerform(&pReq->header);
+    if (RT_FAILURE(rc))
+        Log(("VBoxGuestCommonIOCtl: WRITE_CORE_DUMP: VbglGRPerform failed, rc=%Rrc!\n", rc));
+
+    VbglGRFree(&pReq->header);
+    return rc;
+}
+
+
 #ifdef VBOX_WITH_VRDP_SESSION_HANDLING
 /**
@@ -2213 +2242 @@
                 break;
 
+            case VBOXGUEST_IOCTL_WRITE_CORE_DUMP:
+                CHECKRET_MIN_SIZE("WRITE_CORE_DUMP", sizeof(VBoxGuestWriteCoreDump));
+                rc = VBoxGuestCommonIOCtl_WriteCoreDump(pDevExt, (VBoxGuestWriteCoreDump *)pvData);
+                break;
+
 #ifdef VBOX_WITH_VRDP_SESSION_HANDLING
             case VBOXGUEST_IOCTL_ENABLE_VRDP_SESSION:

trunk/src/VBox/Additions/common/VBoxGuestLib/Makefile.kmk

@@ -94 +94 @@
         VBoxGuestR3LibBalloon.cpp \
         VBoxGuestR3LibClipboard.cpp \
+        VBoxGuestR3LibCoreDump.cpp \
         VBoxGuestR3LibCpuHotPlug.cpp \
         VBoxGuestR3LibCredentials.cpp \