Changeset 99109 in vbox for trunk/include

Timestamp:

Mar 22, 2023 10:13:00 AM (2 years ago)

Author:

vboxsync

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

156474

Message:

IPRT/process: Added RTPROC_FLAGS_CWD to RTProcCreateEx(), to be able to set the current working directory for created processes. bugref:8053

File:

• trunk/include/iprt/process.h (modified) (3 diffs)

trunk/include/iprt/process.h

@@ -193 +193 @@
  *                          - RTPROC_FLAGS_DESIRED_SESSION_ID: Pointing to a
  *                            uint32_t variable with the desired session ID.
+ *                          - RTPROC_FLAGS_CWD: Pointing to a string constant
+ *                            with the directory to chdir() to under the final
+ *                            execution ID, before starting the process.
+ *                          - These flags cannot be used in the same call.
  * @param   phProcess   Where to store the process handle on successful return.
  *                      The content is not changed on failure.  NULL is allowed.
@@ -253 +257 @@
  * (Windows only, ignored elsewhere).  The @a pvExtraData argument points to
  * a uint32_t containing the session ID, UINT32_MAX means any session.
- * Can not be set with RTPROC_FLAGS_TOKEN_SUPPLIED */
+ * Cannot be set with RTPROC_FLAGS_TOKEN_SUPPLIED or RTPROC_FLAGS_CWD. */
 #define RTPROC_FLAGS_DESIRED_SESSION_ID     RT_BIT(11)
 /** This is a modifier to RTPROC_FLAGS_PROFILE on unix systems that makes it
@@ -263 +267 @@
 /** Create process using supplied token. The @a pvExtraData argument points to
  * a HANDLE containing the token used as user credentials for process creation.
- * Can not be set with RTPROC_FLAGS_DESIRED_SESSION_ID.
+ * Cannot be set with RTPROC_FLAGS_DESIRED_SESSION_ID or RTPROC_FLAGS_CWD.
  * Windows only flag, ignored everywhere else. */
 #define RTPROC_FLAGS_TOKEN_SUPPLIED         RT_BIT(14)
+/** The @a pvExtraData argument points to a string containing the directory
+ * to chdir() to, under the final execution ID, before starting the process.
+ * Cannot be set with RTPROC_FLAGS_DESIRED_SESSION_ID or
+ * RTPROC_FLAGS_TOKEN_SUPPLIED. */
+#define RTPROC_FLAGS_CWD                    RT_BIT(15)
 
 /** Valid flag mask. */
-#define RTPROC_FLAGS_VALID_MASK             UINT32_C(0x7fff)
+#define RTPROC_FLAGS_VALID_MASK             UINT32_C(0xffff)
 /** @}  */