Changeset 106020 in vbox for trunk/include

Timestamp:

Sep 12, 2024 9:23:00 AM (3 months ago)

Author:

vboxsync

Message:

IPRT: Added RTCritSectInitNamed and RTCritSectRwInitNamed to simplify naming critical sections w/o sabotaging automatic lock order validation.

Location:

trunk/include/iprt

Files:

• critsect.h (modified) (4 diffs)
• mangling.h (modified) (2 diffs)

trunk/include/iprt/critsect.h

@@ -134 +134 @@
 
 /**
+ * Initialize a critical section with a simple name,
+ */
+RTDECL(int) RTCritSectInitNamed(PRTCRITSECT pCritSect, const char *pszName);
+
+/**
  * Initialize a critical section.
  *
@@ -376 +381 @@
 /* Strict lock order: Automatically classify locks by init location. */
 #if defined(RT_LOCK_STRICT_ORDER) && defined(IN_RING3) && !defined(RTCRITSECT_WITHOUT_REMAPPING) && !defined(RT_WITH_MANGLING)
+# undef  RTCritSectInit
 # define RTCritSectInit(pCritSect) \
     RTCritSectInitEx((pCritSect), 0 /*fFlags*/, \
                      RTLockValidatorClassForSrcPos(RT_SRC_POS, NULL), \
                      RTLOCKVAL_SUB_CLASS_NONE, NULL)
+
+# undef  RTCritSectInitNamed
+# define RTCritSectInitNamed(a_pCritSect, a_pszName) \
+    RTCritSectInitEx((a_pCritSect), 0 /*fFlags*/, \
+                     RTLockValidatorClassForSrcPos(RT_SRC_POS, NULL), \
+                     RTLOCKVAL_SUB_CLASS_NONE, "%s", a_pszName)
 #endif
 
@@ -485 +497 @@
 
 /**
- * Initialize a critical section.
+ * Initialize a read/write critical section.
  */
 RTDECL(int) RTCritSectRwInit(PRTCRITSECTRW pThis);
 
 /**
- * Initialize a critical section.
+ * Initialize a read/write critical section with a simple name.
+ */
+RTDECL(int) RTCritSectRwInitNamed(PRTCRITSECTRW pThis, const char *pszName);
+
+/**
+ * Initialize a read/write critical section.
  *
  * @returns IPRT status code.
@@ -758 +775 @@
     RTCritSectRwInitEx((a_pThis), 0 /*fFlags*/, \
                        RTLockValidatorClassForSrcPos(RT_SRC_POS, NULL), \
-                        RTLOCKVAL_SUB_CLASS_NONE, NULL)
+                       RTLOCKVAL_SUB_CLASS_NONE, NULL)
+
+# define RTCritSectRwInitNamed(a_pThis, a_pszName) \
+    RTCritSectRwInitEx((a_pThis), 0 /*fFlags*/, \
+                       RTLockValidatorClassForSrcPos(RT_SRC_POS, NULL), \
+                       RTLOCKVAL_SUB_CLASS_NONE, "%s", a_pszName)
 #endif
 

trunk/include/iprt/mangling.h

@@ -667 +667 @@
 # define RTCritSectInit                                 RT_MANGLER(RTCritSectInit)
 # define RTCritSectInitEx                               RT_MANGLER(RTCritSectInitEx)
+# define RTCritSectInitNamed                            RT_MANGLER(RTCritSectInitNamed)
 # define RTCritSectLeave                                RT_MANGLER(RTCritSectLeave)
 # define RTCritSectLeaveMultiple                        RT_MANGLER(RTCritSectLeaveMultiple)
@@ -682 +683 @@
 # define RTCritSectRwInit                               RT_MANGLER(RTCritSectRwInit)
 # define RTCritSectRwInitEx                             RT_MANGLER(RTCritSectRwInitEx)
+# define RTCritSectRwInitNamed                          RT_MANGLER(RTCritSectRwInitNamed)
 # define RTCritSectRwIsReadOwner                        RT_MANGLER(RTCritSectRwIsReadOwner)
 # define RTCritSectRwIsWriteOwner                       RT_MANGLER(RTCritSectRwIsWriteOwner)