Changeset 99120 in vbox for trunk/include

Timestamp:

Mar 22, 2023 5:30:14 PM (2 years ago)

Author:

vboxsync

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

156485

Message:

Guest Control: Added ability of specifying an optional current working directory to started guest processes. This needs Guest Additions which support this. bugref:8053

Location:

trunk/include/VBox

Files:

• GuestHost/GuestControl.h (modified) (2 diffs)
• HostServices/GuestControlSvc.h (modified) (3 diffs)
• VBoxGuestLib.h (modified) (1 diff)

trunk/include/VBox/GuestHost/GuestControl.h

@@ -194 +194 @@
  */
 #define GUEST_PROC_DEF_CMD_LEN        _1K
+#define GUEST_PROC_DEF_CWD_LEN        _1K
 #define GUEST_PROC_DEF_ARGS_LEN       _1K
 #define GUEST_PROC_DEF_ENV_LEN        _1K
@@ -205 +206 @@
  */
 #define GUEST_PROC_MAX_CMD_LEN            _1M
+#define GUEST_PROC_MAX_CWD_LEN            RTPATH_MAX
 #define GUEST_PROC_MAX_ARGS_LEN           _2M
 #define GUEST_PROC_MAX_ENV_LEN            _4M

trunk/include/VBox/HostServices/GuestControlSvc.h

@@ -814 +814 @@
  * The toolbox commands now are being marked as deprecated.
  * @since 7.1 */
-# define VBOX_GUESTCTRL_GF_0_TOOLBOX_AS_CMDS        RT_BIT_64(4)
+#define VBOX_GUESTCTRL_GF_0_TOOLBOX_AS_CMDS         RT_BIT_64(4)
+/** Supports specifying the working directory for run / start. */
+#define VBOX_GUESTCTRL_GF_0_PROCESS_CWD             RT_BIT_64(5)
 /** Bit that must be set in the 2nd parameter, will be cleared if the host reponds
  * correctly (old hosts might not). */
@@ -830 +832 @@
  * @since 6.1.6  */
 #define VBOX_GUESTCTRL_HF_0_PROCESS_ARGV0           RT_BIT_64(1)
+/** Host sends the working directory for run / start, if guest
+ * reports VBOX_GUESTCTRL_GF_0_PROCESS_CWD.
+ * @since 6.1.20 ??  */
+#define VBOX_GUESTCTRL_HF_0_PROCESS_CWD             RT_BIT_64(2)
 /** @} */
 
@@ -1210 +1216 @@
             /** Pointer to process affinity blocks (uint64_t). */
             HGCMFunctionParameter affinity;
+            /** Working directory request, filled if guest
+             *  reports VBOX_GUESTCTRL_GF_0_PROCESS_CWD. */
+            HGCMFunctionParameter cwd;
         } v2;
     } u;

trunk/include/VBox/VBoxGuestLib.h

@@ -1029 +1029 @@
     /** Number of environment variables specified in pszEnv. */
     uint32_t cEnvVars;
+    /** Optional working directory. */
+    char *pszCwd;
+    /** Size (in bytes) of optional working directory string. */
+    uint32_t cbCwd;
     /** User name (account) to start the process under. */
     char *pszUser;