Changeset 22114 in vbox for trunk/src/VBox/Runtime/common

Timestamp:

Aug 9, 2009 11:07:56 PM (15 years ago)

Author:

vboxsync

Message:

RTDbgMod: Added module tagging so the diggers can tell which modules are theirs when refreshing.

File:

• trunk/src/VBox/Runtime/common/dbg/dbgmod.cpp (modified) (1 diff)

trunk/src/VBox/Runtime/common/dbg/dbgmod.cpp

@@ -552 +552 @@
 
 /**
+ * Gets the module tag value if any.
+ *
+ * @returns The tag. 0 if hDbgMod is invalid.
+ *
+ * @param   hDbgMod         The module handle.
+ */
+RTDECL(uint64_t) RTDbgModGetTag(RTDBGMOD hDbgMod)
+{
+    PRTDBGMODINT pDbgMod = hDbgMod;
+    RTDBGMOD_VALID_RETURN_RC(pDbgMod, 0);
+    return pDbgMod->uTag;
+}
+RT_EXPORT_SYMBOL(RTDbgModGetTag);
+
+
+/**
+ * Tags or untags the module.
+ *
+ * @returns IPRT status code.
+ * @retval  VERR_INVALID_HANDLE if hDbgMod is invalid.
+ *
+ * @param   hDbgMod         The module handle.
+ * @param   uTag            The tag value.  The convention is that 0 is no tag
+ *                          and any other value means it's tagged.  It's adviced
+ *                          to use some kind of unique number like an address
+ *                          (global or string cache for instance) to avoid
+ *                          collisions with other users
+ */
+RTDECL(int) RTDbgModSetTag(RTDBGMOD hDbgMod, uint64_t uTag)
+{
+    PRTDBGMODINT pDbgMod = hDbgMod;
+    RTDBGMOD_VALID_RETURN_RC(pDbgMod, VERR_INVALID_HANDLE);
+    RTDBGMOD_LOCK(pDbgMod);
+
+    pDbgMod->uTag = uTag;
+
+    RTDBGMOD_UNLOCK(pDbgMod);
+    return VINF_SUCCESS;
+}
+RT_EXPORT_SYMBOL(RTDbgModSetTag);
+
+
+/**
  * Adds a segment to the module. Optional feature.
  *