Changeset 47199 in vbox for trunk/include/iprt

Timestamp:

Jul 16, 2013 3:45:42 PM (11 years ago)

Author:

vboxsync

Message:

IPRT: Kernel thread-context hooks, linux implementation. Extended tstR0ThreadPreemption testcase to test the thread-context hooks.

Location:

trunk/include/iprt

Files:

• mangling.h (modified) (1 diff)
• thread.h (modified) (1 diff)
• types.h (modified) (1 diff)

trunk/include/iprt/mangling.h

@@ -1592 +1592 @@
 # define RTThreadCreateF                                RT_MANGLER(RTThreadCreateF)
 # define RTThreadCreateV                                RT_MANGLER(RTThreadCreateV)
+# define RTThreadCtxHooksCreate                         RT_MANGLER(RTThreadCtxHooksCreate)         /* r0drv */
+# define RTThreadCtxHooksDeregister                     RT_MANGLER(RTThreadCtxHooksDeregister)     /* r0drv */
+# define RTThreadCtxHooksDestroy                        RT_MANGLER(RTThreadCtxHooksDestroy)        /* r0drv */
+# define RTThreadCtxHooksRegister                       RT_MANGLER(RTThreadCtxHooksRegister)       /* r0drv */
 # define RTThreadFromNative                             RT_MANGLER(RTThreadFromNative)
 # define RTThreadGetAffinity                            RT_MANGLER(RTThreadGetAffinity)

trunk/include/iprt/thread.h

@@ -580 +580 @@
 RTDECL(bool) RTThreadIsInInterrupt(RTTHREAD hThread);
 
+
+/**
+ * Thread-context events.
+ */
+typedef enum RTTHREADCTXEVENT
+{
+    /** This thread is about to be preempted. */
+    RTTHREADCTXEVENT_PREEMPTING = 0,
+    /** This thread has just been resumed. */
+    RTTHREADCTXEVENT_RESUMED,
+    /** The usual 32-bit size hack. */
+    RTTHREADCTXEVENT_32BIT_HACK = 0x7fffffff
+} RTTHREADCTXEVENT;
+
+/**
+ * Thread-context hook.
+ *
+ * @returns IPRT status code.
+ * @param   enmEvent    The thread-context event.
+ * @param   pvUser      User argument.
+ *
+ * @remarks This function may be called under different contexts, i.e. with
+ *          different locks held, with/without preemption disabled depending on
+ *          the event in @a enmEvent.
+ */
+typedef DECLCALLBACK(void) FNRTTHREADCTXHOOK(RTTHREADCTXEVENT enmEvent, void *pvUser);
+/** Pointer to a thread-context hook. */
+typedef FNRTTHREADCTXHOOK *PFNRTTHREADCTXHOOK;
+
+/**
+ * Create a handle for a thread-context hook.
+ *
+ * This must be called once per-thread before using RTThreadCtxHooksRegister().
+ *
+ * @returns IPRT status code.
+ * @param   phThreadCtx         Where to store the thread-context handle.
+ */
+RTDECL(int) RTThreadCtxHooksCreate(PRTTHREADCTX phThreadCtx);
+
+/**
+ * Destroy a thread-context hook handle for the current thread.
+ *
+ * This will deregister any thread-context hooks registered under this handle if
+ * required.
+ *
+ * @param   phThreadCtx         Pointer to the thread-context handle.
+ */
+RTDECL(void) RTThreadCtxHooksDestroy(RTTHREADCTX hThreadCtx);
+
+/**
+ * Registers a thread-context hook for the current thread to receive
+ * notifications for all supported thread-context events.
+ *
+ * @returns IPRT status code.
+ * @param   phThreadCtx         Poinner to the thread-context handle.
+ * @param   pfnThreadHook       Pointer to a thread-context hook (a callback)
+ *                              for all thread-context events.
+ * @param   pvUser              User argument (optional, can be NULL).
+ */
+RTDECL(int) RTThreadCtxHooksRegister(RTTHREADCTX hThreadCtx, PFNRTTHREADCTXHOOK pfnThreadHook, void *pvUser);
+
+/**
+ * Deregisters a thread-context hook for the current thread.
+ *
+ * @returns IPRT status code.
+ * @param   phThreadCtx         Pointer to the thread-context handle.
+ */
+RTDECL(int) RTThreadCtxHooksDeregister(RTTHREADCTX hThreadCtx);
+
 # endif /* IN_RING0 */
 

trunk/include/iprt/types.h

@@ -1825 +1825 @@
 #define NIL_RTTHREAD                                0
 
+/** Thread-context handle.*/
+typedef R0PTRTYPE(struct RTTHREADCTXINT *)          RTTHREADCTX;
+/** Pointer to thread handle. */
+typedef RTTHREADCTX                                *PRTTHREADCTX;
+/** Nil thread-context handle. */
+#define NIL_RTTHREADCTX                             0
+
 /** A TLS index. */
 typedef RTHCINTPTR                                  RTTLS;