[project @ 2002-11-28 10:04:15 by simonpj]
[ghc-hetmet.git] / ghc / rts / Capability.h
index e59f495..cb0b09b 100644 (file)
@@ -29,23 +29,33 @@ extern Capability MainCapability;
 #endif
 
 extern void initCapabilities(void);
-extern void grabCapability(Capability** cap);
+extern void grabCapability(Capability** pCap);
 extern void releaseCapability(Capability* cap);
 
+extern nat rts_n_free_capabilities;  
 #if defined(RTS_SUPPORTS_THREADS)
-extern nat rts_n_free_capabilities;  /* total number of available capabilities */
+/* number of worker threads waiting to do good work within
+   the RTS. Used by Task.c (only) to determine whether or not
+   new worker threads needs to be created (when an external call
+   is made).
+ */
+extern nat rts_n_waiting_workers; /* used by Task.c to determine */
 
-static inline nat getFreeCapabilities()
+extern void grabReturnCapability(Mutex* pMutex, Capability** pCap);
+extern void yieldToReturningWorker(Mutex* pMutex, Capability** pCap);
+extern void waitForWorkCapability(Mutex* pMutex, Capability** pCap, rtsBool runnable);
+
+static inline nat getFreeCapabilities (void)
 {
   return rts_n_free_capabilities;
 }
 
-static inline rtsBool noCapabilities()
+static inline rtsBool noCapabilities (void)
 {
   return (rts_n_free_capabilities == 0);
 }
 
-static inline rtsBool allFreeCapabilities()
+static inline rtsBool allFreeCapabilities (void)
 {
 # if defined(SMP)
   return (rts_n_free_capabilities == RtsFlags.ParFlags.nNodes);