Changeset 86412 in vbox for trunk/include

Timestamp:

Oct 2, 2020 11:39:26 AM (5 years ago)

Author:

vboxsync

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

140713

Message:

IPRT/pipe: Adding RTPipeCloseEx w/ a fLeaveOpen parameter so we can prevent leaks via RTHandleGetStandard. Adding RTPIPE_N_LEAVE_OPEN to RTPipeFromNative. bugref:9841

Location:

trunk/include/iprt

Files:

• mangling.h (modified) (1 diff)
• pipe.h (modified) (2 diffs)

trunk/include/iprt/mangling.h

@@ -1740 +1740 @@
 # define RTPathUserHome                                 RT_MANGLER(RTPathUserHome)
 # define RTPipeClose                                    RT_MANGLER(RTPipeClose)
+# define RTPipeCloseEx                                  RT_MANGLER(RTPipeCloseEx)
 # define RTPipeCreate                                   RT_MANGLER(RTPipeCreate)
 # define RTPipeFlush                                    RT_MANGLER(RTPipeFlush)

trunk/include/iprt/pipe.h

@@ -70 +70 @@
 
 /**
+ * Closes one end of a pipe created by RTPipeCreate, extended version.
+ *
+ * @returns IPRT status code.
+ * @param   hPipe           The pipe end to close.
+ * @param   fLeaveOpen      Wheter to leave the underlying native handle open
+ *                          (for RTPipeClose() this is @c false).
+ */
+RTDECL(int)  RTPipeCloseEx(RTPIPE hPipe, bool fLeaveOpen);
+
+/**
  * Creates an IPRT pipe handle from a native one.
  *
@@ -91 +101 @@
 /** Make sure the pipe is inheritable if set and not inheritable when clear. */
 #define RTPIPE_N_INHERIT            RT_BIT(2)
-/** Mask of valid flags. */
+/** Mask of valid flags for . */
 #define RTPIPE_N_VALID_MASK         UINT32_C(0x00000007)
+/** RTPipeFromNative: Leave the native pipe handle open on close. */
+#define RTPIPE_N_LEAVE_OPEN         RT_BIT(3)
+/** Mask of valid flags for RTPipeFromNative(). */
+#define RTPIPE_N_VALID_MASK_FN      UINT32_C(0x0000000f)
 /** @} */