Changeset 102749 in vbox

Timestamp:

Jan 3, 2024 3:17:55 PM (13 months ago)

Author:

vboxsync

Message:

Guest Control/VBoxManage: Implemented a "mount" sub command for the new GetMountPoints API. bugref:10415

Location:

trunk

Files:

• doc/manual/en_US/man_VBoxManage-guestcontrol.xml (modified) (3 diffs)
• doc/manual/user_ChangeLogImpl.xml (modified) (1 diff)
• src/VBox/Frontends/VBoxManage/VBoxManageGuestCtrl.cpp (modified) (2 diffs)

trunk/doc/manual/en_US/man_VBoxManage-guestcontrol.xml

@@ -258 +258 @@
     </cmdsynopsis>
 
+    <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-mount">
+      <command>VBoxManage guestcontrol</command>
+      <group choice="req">
+        <arg choice="plain"><replaceable>uuid</replaceable></arg>
+        <arg choice="plain"><replaceable>vmname</replaceable></arg>
+      </group>
+      <arg choice="plain">mount</arg>
+      <group>
+        <arg choice="plain">--passwordfile=<replaceable>password-file</replaceable></arg>
+        <arg choice="plain">--password=<replaceable>password</replaceable></arg>
+      </group>
+      <arg>--username=<replaceable>username</replaceable></arg>
+      <arg>--verbose</arg>
+    </cmdsynopsis>
+
     <cmdsynopsis id="synopsis-vboxmanage-guestcontrol-fsinfo">
       <command>VBoxManage guestcontrol</command>
@@ -416 +431 @@
         <command>fsinfo</command>,
         <command>mkdir</command>, <command>mktemp</command>,
+        <command>mount</command>,
         <command>mv</command>, <command>rmdir</command>,
         <command>rm</command>, <command>run</command>,
@@ -1066 +1082 @@
         </varlistentry>
       </variablelist>
+    </refsect2>
+    <refsect2 id="vboxmanage-guestcontrol-mount">
+      <title>Shows mount points on the guest</title>
+      <remark role="help-copy-synopsis"/>
+      <para>
+        The <command>VBoxManage guestcontrol
+        <replaceable>vmname</replaceable> mount</command> command
+        enables you to the current mount points on
+        the guest VM. For Windows guests this shows the mapped drives.
+      </para>
     </refsect2>
     <refsect2 id="vboxmanage-guestcontrol-stat">

trunk/doc/manual/user_ChangeLogImpl.xml

@@ -113 +113 @@
       </listitem>
 
+      <listitem>
+       <para>VBoxManage: Added the ability to query the guest's mount points via a new "mount"
+         Guest Control sub command. Requires at least 7.1 Guest Additions</para>
+      </listitem>
+
     </itemizedlist>
   </sect1>

trunk/src/VBox/Frontends/VBoxManage/VBoxManageGuestCtrl.cpp

@@ -2417 +2417 @@
 }
 
+static DECLCALLBACK(RTEXITCODE) gctlHandleMount(PGCTLCMDCTX pCtx, int argc, char **argv)
+{
+    AssertPtrReturn(pCtx, RTEXITCODE_FAILURE);
+
+    static const RTGETOPTDEF s_aOptions[] =
+    {
+        GCTLCMD_COMMON_OPTION_DEFS()
+    };
+
+    int ch;
+    RTGETOPTUNION ValueUnion;
+    RTGETOPTSTATE GetState;
+    RTGetOptInit(&GetState, argc, argv, s_aOptions, RT_ELEMENTS(s_aOptions), 1, RTGETOPTINIT_FLAGS_OPTS_FIRST);
+
+    while ((ch = RTGetOpt(&GetState, &ValueUnion)) != 0)
+    {
+        /* For options that require an argument, ValueUnion has received the value. */
+        switch (ch)
+        {
+            GCTLCMD_COMMON_OPTION_CASES(pCtx, ch, &ValueUnion);
+
+            default:
+                return errorGetOpt(ch, &ValueUnion);
+        }
+    }
+
+    RTEXITCODE rcExit = gctlCtxPostOptionParsingInit(pCtx);
+    if (rcExit != RTEXITCODE_SUCCESS)
+        return rcExit;
+
+    HRESULT hrc = S_OK;
+
+    com::SafeArray<BSTR> mountPoints;
+    CHECK_ERROR(pCtx->pGuestSession, COMGETTER(MountPoints)(ComSafeArrayAsOutParam(mountPoints)));
+
+    for (size_t i = 0; i < mountPoints.size(); ++i)
+        RTPrintf("%ls\n", mountPoints[i]);
+
+    if (pCtx->cVerbose)
+        RTPrintf("Found %zu mount points\n", mountPoints.size());
+
+    return FAILED(hrc) ? RTEXITCODE_FAILURE : RTEXITCODE_SUCCESS;
+}
+
 static DECLCALLBACK(RTEXITCODE) gctlHandleFsInfo(PGCTLCMDCTX pCtx, int argc, char **argv)
 {
@@ -3802 +3846 @@
         { "createtemporary",    gctlHandleMkTemp,           HELP_SCOPE_GUESTCONTROL_MKTEMP,    0 },
 
+        { "mount",              gctlHandleMount,            HELP_SCOPE_GUESTCONTROL_MOUNT,     0 },
+
         { "df",                 gctlHandleFsInfo,           HELP_SCOPE_GUESTCONTROL_FSINFO,    0 },
         { "fsinfo",             gctlHandleFsInfo,           HELP_SCOPE_GUESTCONTROL_FSINFO,    0 },