LibdwPool: Use poolTryTake
authorBen Gamari <ben@smart-cactus.org>
Thu, 26 Nov 2015 11:02:47 +0000 (12:02 +0100)
committerBen Gamari <ben@smart-cactus.org>
Thu, 26 Nov 2015 13:48:50 +0000 (14:48 +0100)
rts/LibdwPool.c

index f625c0f..b0de8ac 100644 (file)
 
 #include "Pool.h"
 
+/*
+ * Note [libdw session pool]
+ * ~~~~~~~~~~~~~~~~~~~~~~~~~
+ *
+ * Building a libdw session requires a number of rather expensive steps,
+ *
+ *   - Examine the object files mapped into the address space
+ *   - Find them on disk
+ *   - Open them and map their debugging information
+ *   - Build various index structures necessary for quick lookup
+ *
+ * The time to setup a session can be several milliseconds. In order to avoid
+ * incurring this cost too often, we keep a pool of warm sessions around which
+ * can be shared between capabilities.
+ *
+ */
+
 static Pool *pool = NULL;
 static nat pool_size = 10; // TODO
 
@@ -26,7 +43,7 @@ void libdwPoolInit(void) {
 }
 
 LibdwSession *libdwPoolTake(void) {
-    return poolTake(pool);
+    return poolTryTake(pool);
 }
 
 void libdwPoolRelease(LibdwSession *sess) {