io-event 1.7.5 → 1.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ab271a1de3eb0f5d21b0b7c92cafcc226e5ca218e7b87ebaa80f93a54fd7b945
-  data.tar.gz: fa6227d0b4218b277903fb1c6f1889e51bcfb7e8d8f83086edc30a336a065eff
+  metadata.gz: ac3ad1ac294041242bb2f44d9c34bf6871f36b7ae01faaf49b83989b75058e84
+  data.tar.gz: e622ec2203010b41c260a763c97cac8025bf86d1d5b04b0ff916f3cf7d7eb467
 SHA512:
-  metadata.gz: d5afc83ef6364791d86b14bdf130d68fda3a7a1c720349dce6bb2140a2ee9f69015e542dbf5c724a0daa338e5f13c87f1dee566e8a36a1b0847ce5e86e1fa92b
-  data.tar.gz: 7d09237e5141123bf251fe686e25fca7d8391a7c25fe331e8882d7e43bf87ff9c5e89bc5c5f90d0731705b923eade10c4667344ad06d04a08544bb9a944baa28
+  metadata.gz: dd0ba1be23b1c113af78c07d7d8aab84759d984ba1a0569cdfe31c427e34de7d97a8a7fc5598dd4cfe0ec650709c24bf764c1d5c385b8de34cf70157195dc4e7
+  data.tar.gz: 91936ec8d38c517cfdd6a22a72199067f49933811522eb71e4d23df49046725c1708f23481fb5f9430852143093594793f3635fd7a58624e539d97555eafb18a

checksums.yaml.gz.sig

@@ -1 +1,2 @@
-g�󉨤xIꩅ,�D~���s�A�R�XxI��̳׿8k�(.����z��;���}��5%��d3x����=�&�5���P�o�Ծ�7��zGK�Z��Zl�%K������s�B��4d ��[3/��2�C�\�z�����=i�c$��#
+ug���YՐ�2�����f�i:�I\
b��L�Aua�:;�����n]���ܥ���y^�����}}1���Jge�t=܋�󠵙ES� qy��l�S�2`��‘��.�H=��_���ەolZT��c��<�©
+��fc�$��=BL}f�Ի����O���

data/ext/extconf.rb

@@ -22,7 +22,7 @@ if ENV.key?("RUBY_DEBUG")
 	$CFLAGS << " -DRUBY_DEBUG -O0"
 end
 
-$srcs = ["io/event/event.c", "io/event/selector/selector.c"]
+$srcs = ["io/event/event.c", "io/event/selector/selector.c", "io/event/time.c", "io/event/profile.c"]
 $VPATH << "$(srcdir)/io/event"
 $VPATH << "$(srcdir)/io/event/selector"
 

data/ext/io/event/{selector/array.h → array.h}

@@ -28,7 +28,7 @@ struct IO_Event_Array {
 	void (*element_free)(void*);
 };
 
-inline static int IO_Event_Array_allocate(struct IO_Event_Array *array, size_t count, size_t element_size)
+inline static int IO_Event_Array_initialize(struct IO_Event_Array *array, size_t count, size_t element_size)
 {
 	array->limit = 0;
 	array->element_size = element_size;
@@ -153,6 +153,12 @@ inline static void* IO_Event_Array_lookup(struct IO_Event_Array *array, size_t i
 	return *element;
 }
 
+inline static void* IO_Event_Array_last(struct IO_Event_Array *array)
+{
+	if (array->limit == 0) return NULL;
+	else return array->base[array->limit - 1];
+}
+
 // Push a new element onto the end of the array.
 inline static void* IO_Event_Array_push(struct IO_Event_Array *array)
 {

data/ext/io/event/event.c

@@ -1,22 +1,5 @@
-// Copyright, 2021, by Samuel G. D. Williams. <http://www.codeotaku.com>
-// 
-// Permission is hereby granted, free of charge, to any person obtaining a copy
-// of this software and associated documentation files (the "Software"), to deal
-// in the Software without restriction, including without limitation the rights
-// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-// copies of the Software, and to permit persons to whom the Software is
-// furnished to do so, subject to the following conditions:
-// 
-// The above copyright notice and this permission notice shall be included in
-// all copies or substantial portions of the Software.
-// 
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-// THE SOFTWARE.
+// Released under the MIT License.
+// Copyright, 2021-2025, by Samuel Williams.
 
 #include "event.h"
 #include "selector/selector.h"

data/ext/io/event/event.h

@@ -1,22 +1,5 @@
-// Copyright, 2021, by Samuel G. D. Williams. <http://www.codeotaku.com>
-// 
-// Permission is hereby granted, free of charge, to any person obtaining a copy
-// of this software and associated documentation files (the "Software"), to deal
-// in the Software without restriction, including without limitation the rights
-// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-// copies of the Software, and to permit persons to whom the Software is
-// furnished to do so, subject to the following conditions:
-// 
-// The above copyright notice and this permission notice shall be included in
-// all copies or substantial portions of the Software.
-// 
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-// THE SOFTWARE.
+// Released under the MIT License.
+// Copyright, 2021-2025, by Samuel Williams.
 
 #pragma once
 

data/ext/io/event/interrupt.c

@@ -1,24 +1,5 @@
-// Copyright, 2021, by Samuel G. D. Williams. <http://www.codeotaku.com>
-// 
-// Permission is hereby granted, free of charge, to any person obtaining a copy
-// of this software and associated documentation files (the "Software"), to deal
-// in the Software without restriction, including without limitation the rights
-// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-// copies of the Software, and to permit persons to whom the Software is
-// furnished to do so, subject to the following conditions:
-// 
-// The above copyright notice and this permission notice shall be included in
-// all copies or substantial portions of the Software.
-// 
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-// THE SOFTWARE.
-
-// static const int DEBUG = 0;
+// Released under the MIT License.
+// Copyright, 2021-2025, by Samuel Williams.
 
 #include "interrupt.h"
 #include <unistd.h>
@@ -95,9 +76,11 @@ void IO_Event_Interrupt_signal(struct IO_Event_Interrupt *interrupt)
 	ssize_t result = write(interrupt->descriptor[1], ".", 1);
 	
 	if (result == -1) {
-		if (errno == EAGAIN || errno == EWOULDBLOCK) return;
-		
-		rb_sys_fail("IO_Event_Interrupt_signal:write");
+		if (errno == EAGAIN || errno == EWOULDBLOCK) {
+			// If we can't write to the pipe, it means the other end is full. In that case, we can be sure that the other end has already been woken up or is about to be woken up.
+		} else {
+			rb_sys_fail("IO_Event_Interrupt_signal:write");
+		}
 	}
 }
 
@@ -107,9 +90,11 @@ void IO_Event_Interrupt_clear(struct IO_Event_Interrupt *interrupt)
 	ssize_t result = read(interrupt->descriptor[0], buffer, sizeof(buffer));
 	
 	if (result == -1) {
-		if (errno == EAGAIN || errno == EWOULDBLOCK) return;
-		
-		rb_sys_fail("IO_Event_Interrupt_clear:read");
+		if (errno == EAGAIN || errno == EWOULDBLOCK) {
+			// If we can't read from the pipe, it means the other end is empty. In that case, we can be sure that the other end is already clear.
+		} else {
+			rb_sys_fail("IO_Event_Interrupt_clear:read");
+		}
 	}
 }
 #endif

data/ext/io/event/interrupt.h

@@ -1,22 +1,5 @@
-// Copyright, 2021, by Samuel G. D. Williams. <http://www.codeotaku.com>
-// 
-// Permission is hereby granted, free of charge, to any person obtaining a copy
-// of this software and associated documentation files (the "Software"), to deal
-// in the Software without restriction, including without limitation the rights
-// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-// copies of the Software, and to permit persons to whom the Software is
-// furnished to do so, subject to the following conditions:
-// 
-// The above copyright notice and this permission notice shall be included in
-// all copies or substantial portions of the Software.
-// 
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-// THE SOFTWARE.
+// Released under the MIT License.
+// Copyright, 2021-2025, by Samuel Williams.
 
 #pragma once
 

data/ext/io/event/{selector/list.h → list.h}

@@ -1,5 +1,5 @@
 // Released under the MIT License.
-// Copyright, 2023, by Samuel Williams.
+// Copyright, 2023-2025, by Samuel Williams.
 
 #include <ruby.h>
 #include <stdio.h>

data/ext/io/event/profile.c

@@ -0,0 +1,154 @@
+// Released under the MIT License.
+// Copyright, 2025, by Samuel Williams.
+
+#include "profile.h"
+#include "time.h"
+
+#include <ruby/debug.h>
+
+#include <stdio.h>
+
+void IO_Event_Profile_Event_initialize(struct IO_Event_Profile_Event *event) {
+	event->time.tv_sec = 0;
+	event->time.tv_nsec = 0;
+	event->nesting = 0;
+	
+	event->event_flag = 0;
+	event->id = 0;
+	
+	event->path = NULL;
+	event->line = 0;
+}
+
+void IO_Event_Profile_Event_free(struct IO_Event_Profile_Event *event) {
+	if (event->path) {
+		free((void*)event->path);
+	}
+}
+
+static const char *event_flag_name(rb_event_flag_t event_flag) {
+	switch (event_flag) {
+		case RUBY_EVENT_LINE:
+			return "line";
+		case RUBY_EVENT_CALL:
+		case RUBY_EVENT_C_CALL:
+			return "call";
+		case RUBY_EVENT_RETURN:
+		case RUBY_EVENT_C_RETURN:
+			return "return";
+		default:
+			return "unknown";
+	}
+}
+
+int event_flag_call_p(rb_event_flag_t event_flags) {
+	return event_flags & (RUBY_EVENT_CALL | RUBY_EVENT_C_CALL);
+}
+
+int event_flag_return_p(rb_event_flag_t event_flags) {
+	return event_flags & (RUBY_EVENT_RETURN | RUBY_EVENT_C_RETURN);
+}
+
+static void profile_event_callback(rb_event_flag_t event_flag, VALUE data, VALUE self, ID id, VALUE klass) {
+	struct IO_Event_Profile *profile = (struct IO_Event_Profile*)data;
+	struct IO_Event_Profile_Event *event = IO_Event_Array_push(&profile->events);
+	
+	IO_Event_Time_current(&event->time);
+	
+	event->event_flag = event_flag;
+	
+	if (event_flag_call_p(event_flag)) {
+		event->parent = profile->current;
+		profile->current = event;
+		
+		event->nesting = profile->nesting;
+		profile->nesting += 1;
+		
+		if (id) {
+			event->id = id;
+			event->klass = klass;
+		} else {
+			rb_frame_method_id_and_class(&event->id, &event->klass);
+		}
+		
+		const char *path = rb_sourcefile();
+		if (path) {
+			event->path = strdup(path);
+		}
+		event->line = rb_sourceline();
+	} else if (event_flag_return_p(event_flag)) {
+		// Set up the call/return pair:
+		profile->current->pair = event;
+		event->pair = profile->current;
+		
+		profile->current = profile->current->parent;
+		event->parent = profile->current;
+		
+		profile->nesting -= 1;
+		event->nesting = profile->nesting;
+	}
+}
+
+void IO_Event_Profile_initialize(struct IO_Event_Profile *profile, VALUE fiber) {
+	profile->fiber = fiber;
+	
+	profile->events.element_initialize = (void (*)(void*))IO_Event_Profile_Event_initialize;
+	profile->events.element_free = (void (*)(void*))IO_Event_Profile_Event_free;
+	
+	IO_Event_Array_initialize(&profile->events, 0, sizeof(struct IO_Event_Profile_Event));
+}
+
+void IO_Event_Profile_start(struct IO_Event_Profile *profile) {
+	IO_Event_Time_current(&profile->start_time);
+	profile->nesting = 0;
+	profile->current = NULL;
+	
+	// Since fibers are currently limited to a single thread, we use this in the hope that it's a little more efficient:
+	VALUE thread = rb_thread_current();
+	rb_thread_add_event_hook(thread, profile_event_callback, RUBY_EVENT_CALL | RUBY_EVENT_C_CALL | RUBY_EVENT_RETURN | RUBY_EVENT_C_RETURN, (VALUE)profile);
+}
+
+void IO_Event_Profile_stop(struct IO_Event_Profile *profile) {
+	IO_Event_Time_current(&profile->stop_time);
+	
+	VALUE thread = rb_thread_current();
+	rb_thread_remove_event_hook_with_data(thread, profile_event_callback, (VALUE)profile);
+}
+
+void IO_Event_Profile_free(struct IO_Event_Profile *profile) {
+	IO_Event_Array_free(&profile->events);
+}
+
+static const float IO_EVENT_PROFILE_PRINT_MINIMUM_PROPORTION = 0.01;
+
+void IO_Event_Profile_print(FILE *restrict stream, struct IO_Event_Profile *profile) {
+	struct timespec total_duration = {};
+	IO_Event_Time_elapsed(&profile->start_time, &profile->stop_time, &total_duration);
+	
+	size_t skipped = 0;
+	
+	for (size_t i = 0; i < profile->events.limit; i += 1) {
+		struct IO_Event_Profile_Event *event = profile->events.base[i];
+		
+		if (event_flag_call_p(event->event_flag)) {
+			struct timespec duration = {};
+			
+			if (event->pair) {
+				IO_Event_Time_elapsed(&event->time, &event->pair->time, &duration);
+				
+				// Skip events that are too short to be meaningful:
+				if (IO_Event_Time_proportion(&duration, &total_duration) < IO_EVENT_PROFILE_PRINT_MINIMUM_PROPORTION) {
+					skipped += 1;
+					continue;
+				}
+			}
+			
+			for (size_t i = 0; i < event->nesting; i += 1) {
+				fputc('\t', stream);
+			}
+			
+			const char *name = rb_id2name(event->id);
+			fprintf(stream, "\t%s:%d in '%s#%s' (" IO_EVENT_TIME_PRINTF_TIMESPEC "s)\n", event->path, event->line, RSTRING_PTR(rb_inspect(event->klass)), name, IO_EVENT_TIME_PRINTF_TIMESPEC_ARGUMENTS(duration));
+		}
+	}
+}

data/ext/io/event/profile.h

@@ -0,0 +1,54 @@
+// Released under the MIT License.
+// Copyright, 2025, by Samuel Williams.
+
+#pragma once
+
+#include <ruby.h>
+#include "array.h"
+#include "time.h"
+
+struct IO_Event_Profile_Event {
+	struct timespec time;
+	size_t nesting;
+	
+	rb_event_flag_t event_flag;
+	ID id;
+	
+	VALUE klass;
+	const char *path;
+	int line;
+	
+	struct IO_Event_Profile_Event *parent;
+	struct IO_Event_Profile_Event *pair;
+};
+
+struct IO_Event_Profile {
+	VALUE fiber;
+	
+	struct timespec start_time;
+	struct timespec stop_time;
+	
+	// The depth of the call stack:
+	size_t nesting;
+	
+	// The current call frame:
+	struct IO_Event_Profile_Event *current;
+	
+	struct IO_Event_Array events;
+};
+
+void IO_Event_Profile_initialize(struct IO_Event_Profile *profile, VALUE fiber);
+
+void IO_Event_Profile_start(struct IO_Event_Profile *profile);
+void IO_Event_Profile_stop(struct IO_Event_Profile *profile);
+
+void IO_Event_Profile_free(struct IO_Event_Profile *profile);
+void IO_Event_Profile_print(FILE *restrict stream, struct IO_Event_Profile *profile);
+
+static inline float IO_Event_Profile_duration(struct IO_Event_Profile *profile) {
+	struct timespec duration;
+	
+	IO_Event_Time_elapsed(&profile->start_time, &profile->stop_time, &duration);
+	
+	return IO_Event_Time_duration(&duration);
+}

data/ext/io/event/selector/epoll.c

@@ -1,27 +1,10 @@
-// Copyright, 2021, by Samuel G. D. Williams. <http://www.codeotaku.com>
-// 
-// Permission is hereby granted, free of charge, to any person obtaining a copy
-// of this software and associated documentation files (the "Software"), to deal
-// in the Software without restriction, including without limitation the rights
-// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-// copies of the Software, and to permit persons to whom the Software is
-// furnished to do so, subject to the following conditions:
-// 
-// The above copyright notice and this permission notice shall be included in
-// all copies or substantial portions of the Software.
-// 
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-// THE SOFTWARE.
+// Released under the MIT License.
+// Copyright, 2021-2025, by Samuel Williams.
 
 #include "epoll.h"
 #include "selector.h"
-#include "list.h"
-#include "array.h"
+#include "../list.h"
+#include "../array.h"
 
 #include <sys/epoll.h>
 #include <time.h>
@@ -337,9 +320,9 @@ VALUE IO_Event_Selector_EPoll_allocate(VALUE self) {
 	
 	selector->descriptors.element_initialize = IO_Event_Selector_EPoll_Descriptor_initialize;
 	selector->descriptors.element_free = IO_Event_Selector_EPoll_Descriptor_free;
-	int result = IO_Event_Array_allocate(&selector->descriptors, IO_EVENT_ARRAY_DEFAULT_COUNT, sizeof(struct IO_Event_Selector_EPoll_Descriptor));
+	int result = IO_Event_Array_initialize(&selector->descriptors, IO_EVENT_ARRAY_DEFAULT_COUNT, sizeof(struct IO_Event_Selector_EPoll_Descriptor));
 	if (result < 0) {
-		rb_sys_fail("IO_Event_Selector_EPoll_allocate:IO_Event_Array_allocate");
+		rb_sys_fail("IO_Event_Selector_EPoll_allocate:IO_Event_Array_initialize");
 	}
 	
 	return instance;
@@ -435,7 +418,7 @@ VALUE IO_Event_Selector_EPoll_push(VALUE self, VALUE fiber)
 	struct IO_Event_Selector_EPoll *selector = NULL;
 	TypedData_Get_Struct(self, struct IO_Event_Selector_EPoll, &IO_Event_Selector_EPoll_Type, selector);
 	
-	IO_Event_Selector_queue_push(&selector->backend, fiber);
+	IO_Event_Selector_ready_push(&selector->backend, fiber);
 	
 	return Qnil;
 }
@@ -584,7 +567,7 @@ VALUE IO_Event_Selector_EPoll_io_wait(VALUE self, VALUE fiber, VALUE io, VALUE e
 	
 	if (result == -1) {
 		if (errno == EPERM) {
-			IO_Event_Selector_queue_push(&selector->backend, fiber);
+			IO_Event_Selector_ready_push(&selector->backend, fiber);
 			IO_Event_Selector_yield(&selector->backend);
 			return events;
 		}
@@ -942,7 +925,7 @@ int IO_Event_Selector_EPoll_handle(struct IO_Event_Selector_EPoll *selector, con
 			
 			// Resume the fiber:
 			waiting->ready = matching_events;
-			IO_Event_Selector_fiber_transfer(waiting->fiber, 0, NULL);
+			IO_Event_Selector_fiber_transfer_user(waiting->fiber, 0, NULL);
 			
 			node = saved->tail;
 			IO_Event_List_pop(saved);
@@ -994,7 +977,7 @@ VALUE IO_Event_Selector_EPoll_select(VALUE self, VALUE duration) {
 	selector->idle_duration.tv_sec = 0;
 	selector->idle_duration.tv_nsec = 0;
 	
-	int ready = IO_Event_Selector_queue_flush(&selector->backend);
+	int ready = IO_Event_Selector_ready_flush(&selector->backend);
 	
 	struct select_arguments arguments = {
 		.selector = selector,
@@ -1020,14 +1003,14 @@ VALUE IO_Event_Selector_EPoll_select(VALUE self, VALUE duration) {
 		
 		if (!timeout_nonblocking(arguments.timeout)) {
 			struct timespec start_time;
-			IO_Event_Selector_current_time(&start_time);
+			IO_Event_Time_current(&start_time);
 			
 			// Wait for events to occur:
 			select_internal_without_gvl(&arguments);
 			
 			struct timespec end_time;
-			IO_Event_Selector_current_time(&end_time);
-			IO_Event_Selector_elapsed_time(&start_time, &end_time, &selector->idle_duration);
+			IO_Event_Time_current(&end_time);
+			IO_Event_Time_elapsed(&start_time, &end_time, &selector->idle_duration);
 		}
 	}
 	

data/ext/io/event/selector/epoll.h

@@ -1,22 +1,5 @@
-// Copyright, 2021, by Samuel G. D. Williams. <http://www.codeotaku.com>
-// 
-// Permission is hereby granted, free of charge, to any person obtaining a copy
-// of this software and associated documentation files (the "Software"), to deal
-// in the Software without restriction, including without limitation the rights
-// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-// copies of the Software, and to permit persons to whom the Software is
-// furnished to do so, subject to the following conditions:
-// 
-// The above copyright notice and this permission notice shall be included in
-// all copies or substantial portions of the Software.
-// 
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-// THE SOFTWARE.
+// Released under the MIT License.
+// Copyright, 2021-2025, by Samuel Williams.
 
 #pragma once
 

data/ext/io/event/selector/kqueue.c

@@ -1,27 +1,10 @@
-// Copyright, 2021, by Samuel G. D. Williams. <http://www.codeotaku.com>
-// 
-// Permission is hereby granted, free of charge, to any person obtaining a copy
-// of this software and associated documentation files (the "Software"), to deal
-// in the Software without restriction, including without limitation the rights
-// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-// copies of the Software, and to permit persons to whom the Software is
-// furnished to do so, subject to the following conditions:
-// 
-// The above copyright notice and this permission notice shall be included in
-// all copies or substantial portions of the Software.
-// 
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-// THE SOFTWARE.
+// Released under the MIT License.
+// Copyright, 2021-2025, by Samuel Williams.
 
 #include "kqueue.h"
 #include "selector.h"
-#include "list.h"
-#include "array.h"
+#include "../list.h"
+#include "../array.h"
 
 #include <sys/event.h>
 #include <sys/ioctl.h>
@@ -312,9 +295,9 @@ VALUE IO_Event_Selector_KQueue_allocate(VALUE self) {
 	selector->descriptors.element_initialize = IO_Event_Selector_KQueue_Descriptor_initialize;
 	selector->descriptors.element_free = IO_Event_Selector_KQueue_Descriptor_free;
 	
-	int result = IO_Event_Array_allocate(&selector->descriptors, IO_EVENT_ARRAY_DEFAULT_COUNT, sizeof(struct IO_Event_Selector_KQueue_Descriptor));
+	int result = IO_Event_Array_initialize(&selector->descriptors, IO_EVENT_ARRAY_DEFAULT_COUNT, sizeof(struct IO_Event_Selector_KQueue_Descriptor));
 	if (result < 0) {
-		rb_sys_fail("IO_Event_Selector_KQueue_allocate:IO_Event_Array_allocate");
+		rb_sys_fail("IO_Event_Selector_KQueue_allocate:IO_Event_Array_initialize");
 	}
 	
 	return instance;
@@ -422,7 +405,7 @@ VALUE IO_Event_Selector_KQueue_push(VALUE self, VALUE fiber)
 	struct IO_Event_Selector_KQueue *selector = NULL;
 	TypedData_Get_Struct(self, struct IO_Event_Selector_KQueue, &IO_Event_Selector_KQueue_Type, selector);
 	
-	IO_Event_Selector_queue_push(&selector->backend, fiber);
+	IO_Event_Selector_ready_push(&selector->backend, fiber);
 	
 	return Qnil;
 }
@@ -914,7 +897,7 @@ int IO_Event_Selector_KQueue_handle(struct IO_Event_Selector_KQueue *selector, u
 			IO_Event_List_append(node, saved);
 			
 			waiting->ready = matching_events;
-			IO_Event_Selector_fiber_transfer(waiting->fiber, 0, NULL);
+			IO_Event_Selector_fiber_transfer_user(waiting->fiber, 0, NULL);
 			
 			node = saved->tail;
 			IO_Event_List_pop(saved);
@@ -971,7 +954,7 @@ VALUE IO_Event_Selector_KQueue_select(VALUE self, VALUE duration) {
 	selector->idle_duration.tv_sec = 0;
 	selector->idle_duration.tv_nsec = 0;
 	
-	int ready = IO_Event_Selector_queue_flush(&selector->backend);
+	int ready = IO_Event_Selector_ready_flush(&selector->backend);
 	
 	struct select_arguments arguments = {
 		.selector = selector,
@@ -1008,14 +991,14 @@ VALUE IO_Event_Selector_KQueue_select(VALUE self, VALUE duration) {
 			arguments.count = KQUEUE_MAX_EVENTS;
 			
 			struct timespec start_time;
-			IO_Event_Selector_current_time(&start_time);
+			IO_Event_Time_current(&start_time);
 			
 			if (DEBUG) fprintf(stderr, "IO_Event_Selector_KQueue_select timeout=" IO_EVENT_PRINTF_TIMESPEC "\n", IO_EVENT_PRINTF_TIMESPEC_ARGUMENTS(arguments.storage));
 			select_internal_without_gvl(&arguments);
 			
 			struct timespec end_time;
-			IO_Event_Selector_current_time(&end_time);
-			IO_Event_Selector_elapsed_time(&start_time, &end_time, &selector->idle_duration);
+			IO_Event_Time_current(&end_time);
+			IO_Event_Time_elapsed(&start_time, &end_time, &selector->idle_duration);
 		}
 	}
 	

data/ext/io/event/selector/kqueue.h

@@ -1,22 +1,5 @@
-// Copyright, 2021, by Samuel G. D. Williams. <http://www.codeotaku.com>
-// 
-// Permission is hereby granted, free of charge, to any person obtaining a copy
-// of this software and associated documentation files (the "Software"), to deal
-// in the Software without restriction, including without limitation the rights
-// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-// copies of the Software, and to permit persons to whom the Software is
-// furnished to do so, subject to the following conditions:
-// 
-// The above copyright notice and this permission notice shall be included in
-// all copies or substantial portions of the Software.
-// 
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-// THE SOFTWARE.
+// Released under the MIT License.
+// Copyright, 2021-2025, by Samuel Williams.
 
 #pragma once
 

data/ext/io/event/selector/pidfd.c

@@ -1,22 +1,5 @@
-// Copyright, 2021, by Samuel G. D. Williams. <http://www.codeotaku.com>
-// 
-// Permission is hereby granted, free of charge, to any person obtaining a copy
-// of this software and associated documentation files (the "Software"), to deal
-// in the Software without restriction, including without limitation the rights
-// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-// copies of the Software, and to permit persons to whom the Software is
-// furnished to do so, subject to the following conditions:
-// 
-// The above copyright notice and this permission notice shall be included in
-// all copies or substantial portions of the Software.
-// 
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-// THE SOFTWARE.
+// Released under the MIT License.
+// Copyright, 2021-2025, by Samuel Williams.
 
 #include <ruby.h>
 

data/ext/io/event/selector/selector.c

@@ -1,30 +1,18 @@
-// Copyright, 2021, by Samuel G. D. Williams. <http://www.codeotaku.com>
-// 
-// Permission is hereby granted, free of charge, to any person obtaining a copy
-// of this software and associated documentation files (the "Software"), to deal
-// in the Software without restriction, including without limitation the rights
-// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-// copies of the Software, and to permit persons to whom the Software is
-// furnished to do so, subject to the following conditions:
-// 
-// The above copyright notice and this permission notice shall be included in
-// all copies or substantial portions of the Software.
-// 
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-// THE SOFTWARE.
+// Released under the MIT License.
+// Copyright, 2021-2025, by Samuel Williams.
 
 #include "selector.h"
+#include "../profile.h"
+
 #include <fcntl.h>
+#include <stdlib.h>
 
 static const int DEBUG = 0;
 
 static ID id_transfer, id_alive_p;
 
+static float IO_Event_Selector_stall_log_threshold = 0;
+
 VALUE IO_Event_Selector_fiber_transfer(VALUE fiber, int argc, VALUE *argv) {
 	// TODO Consider introducing something like `rb_fiber_scheduler_transfer(...)`.
 #ifdef HAVE__RB_FIBER_TRANSFER
@@ -43,6 +31,31 @@ VALUE IO_Event_Selector_fiber_transfer(VALUE fiber, int argc, VALUE *argv) {
 	return Qnil;
 }
 
+VALUE IO_Event_Selector_fiber_transfer_user(VALUE fiber, int argc, VALUE *argv) {
+	// Bypass if the threshold is not set:
+	if (IO_Event_Selector_stall_log_threshold == 0) {
+		return IO_Event_Selector_fiber_transfer(fiber, argc, argv);
+	}
+	
+	struct IO_Event_Profile profile;
+	IO_Event_Profile_initialize(&profile, fiber);
+	IO_Event_Profile_start(&profile);
+	
+	// Transfer control to the fiber:
+	VALUE result = IO_Event_Selector_fiber_transfer(fiber, argc, argv);
+	
+	IO_Event_Profile_stop(&profile);
+	
+	float duration = IO_Event_Profile_duration(&profile);
+	
+	if (duration > IO_Event_Selector_stall_log_threshold) {
+		fprintf(stderr, "Fiber stalled for %.3f seconds\n", duration);
+		IO_Event_Profile_print(stderr, &profile);
+	}
+	
+	return result;
+}
+
 #ifndef HAVE__RB_FIBER_RAISE
 static ID id_raise;
 
@@ -156,8 +169,25 @@ void Init_IO_Event_Selector(VALUE IO_Event_Selector) {
 	rb_Process_Status = rb_const_get_at(rb_mProcess, rb_intern("Status"));
 	rb_gc_register_mark_object(rb_Process_Status);
 #endif
-
+	
 	rb_define_singleton_method(IO_Event_Selector, "nonblock", IO_Event_Selector_nonblock, 1);
+	
+	// Extract the stall log threshold if specified:
+	
+	char *stall_log_threshold = getenv("IO_EVENT_SELECTOR_STALL_LOG_THRESHOLD");
+	// Can be true, false or a floating point time in seconds:
+	
+	if (stall_log_threshold) {
+		if (strcmp(stall_log_threshold, "true") == 0) {
+			IO_Event_Selector_stall_log_threshold = 0.001;
+		} else if (strcmp(stall_log_threshold, "false") == 0) {
+			IO_Event_Selector_stall_log_threshold = 0;
+		} else {
+			IO_Event_Selector_stall_log_threshold = strtof(stall_log_threshold, NULL);
+		}
+		
+		if (DEBUG) fprintf(stderr, "IO_EVENT_SELECTOR_STALL_LOG_THRESHOLD = %.3f\n", IO_Event_Selector_stall_log_threshold);
+	}
 }
 
 struct wait_and_transfer_arguments {
@@ -211,7 +241,7 @@ static VALUE wait_and_transfer(VALUE _arguments) {
 	int argc = arguments->argc - 1;
 	VALUE *argv = arguments->argv + 1;
 	
-	return IO_Event_Selector_fiber_transfer(fiber, argc, argv);
+	return IO_Event_Selector_fiber_transfer_user(fiber, argc, argv);
 }
 
 static VALUE wait_and_transfer_ensure(VALUE _arguments) {
@@ -282,7 +312,7 @@ VALUE IO_Event_Selector_raise(struct IO_Event_Selector *backend, int argc, VALUE
 	return rb_ensure(wait_and_raise, (VALUE)&arguments, wait_and_transfer_ensure, (VALUE)&arguments);
 }
 
-void IO_Event_Selector_queue_push(struct IO_Event_Selector *backend, VALUE fiber)
+void IO_Event_Selector_ready_push(struct IO_Event_Selector *backend, VALUE fiber)
 {
 	struct IO_Event_Selector_Queue *waiting = malloc(sizeof(struct IO_Event_Selector_Queue));
 	assert(waiting);
@@ -297,26 +327,26 @@ void IO_Event_Selector_queue_push(struct IO_Event_Selector *backend, VALUE fiber
 }
 
 static inline
-void IO_Event_Selector_queue_pop(struct IO_Event_Selector *backend, struct IO_Event_Selector_Queue *ready)
+void IO_Event_Selector_ready_pop(struct IO_Event_Selector *backend, struct IO_Event_Selector_Queue *ready)
 {
-	if (DEBUG) fprintf(stderr, "IO_Event_Selector_queue_pop -> %p\n", (void*)ready->fiber);
+	if (DEBUG) fprintf(stderr, "IO_Event_Selector_ready_pop -> %p\n", (void*)ready->fiber);
 	
-	if (ready->flags & IO_EVENT_SELECTOR_QUEUE_FIBER) {
-		IO_Event_Selector_fiber_transfer(ready->fiber, 0, NULL);
-	} else if (ready->flags & IO_EVENT_SELECTOR_QUEUE_INTERNAL) {
-		VALUE fiber = ready->fiber;
+	VALUE fiber = ready->fiber;
+	
+	if (ready->flags & IO_EVENT_SELECTOR_QUEUE_INTERNAL) {
+		// This means that the fiber was added to the ready queue by the selector itself, and we need to transfer control to it, but before we do that, we need to remove it from the queue, as there is no expectation that returning from `transfer` will remove it.
 		queue_pop(backend, ready);
 		free(ready);
-		
-		if (RTEST(rb_funcall(fiber, id_alive_p, 0))) {
-			rb_funcall(fiber, id_transfer, 0);
-		}
+	} else if (ready->flags & IO_EVENT_SELECTOR_QUEUE_FIBER) {
+		// This means the fiber added itself to the ready queue, and we need to transfer control back to it. Transferring control back to the fiber will call `queue_pop` and remove it from the queue.
 	} else {
 		rb_raise(rb_eRuntimeError, "Unknown queue type!");
 	}
+	
+	IO_Event_Selector_fiber_transfer_user(fiber, 0, NULL);
 }
 
-int IO_Event_Selector_queue_flush(struct IO_Event_Selector *backend)
+int IO_Event_Selector_ready_flush(struct IO_Event_Selector *backend)
 {
 	int count = 0;
 	
@@ -324,7 +354,7 @@ int IO_Event_Selector_queue_flush(struct IO_Event_Selector *backend)
 	
 	// Get the current tail and head of the queue:
 	struct IO_Event_Selector_Queue *waiting = backend->waiting;
-	if (DEBUG) fprintf(stderr, "IO_Event_Selector_queue_flush waiting = %p\n", waiting);
+	if (DEBUG) fprintf(stderr, "IO_Event_Selector_ready_flush waiting = %p\n", waiting);
 	
 	// Process from head to tail in order:
 	// During this, more items may be appended to tail.
@@ -333,25 +363,10 @@ int IO_Event_Selector_queue_flush(struct IO_Event_Selector *backend)
 		struct IO_Event_Selector_Queue *ready = backend->ready;
 		
 		count += 1;
-		IO_Event_Selector_queue_pop(backend, ready);
+		IO_Event_Selector_ready_pop(backend, ready);
 		
 		if (ready == waiting) break;
 	}
 	
 	return count;
 }
-
-void IO_Event_Selector_elapsed_time(struct timespec* start, struct timespec* stop, struct timespec *duration)
-{
-	if ((stop->tv_nsec - start->tv_nsec) < 0) {
-		duration->tv_sec = stop->tv_sec - start->tv_sec - 1;
-		duration->tv_nsec = stop->tv_nsec - start->tv_nsec + 1000000000;
-	} else {
-		duration->tv_sec = stop->tv_sec - start->tv_sec;
-		duration->tv_nsec = stop->tv_nsec - start->tv_nsec;
-	}
-}
-
-void IO_Event_Selector_current_time(struct timespec *time) {
-	clock_gettime(CLOCK_MONOTONIC, time);
-}

data/ext/io/event/selector/selector.h

@@ -1,22 +1,5 @@
-// Copyright, 2021, by Samuel G. D. Williams. <http://www.codeotaku.com>
-// 
-// Permission is hereby granted, free of charge, to any person obtaining a copy
-// of this software and associated documentation files (the "Software"), to deal
-// in the Software without restriction, including without limitation the rights
-// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-// copies of the Software, and to permit persons to whom the Software is
-// furnished to do so, subject to the following conditions:
-// 
-// The above copyright notice and this permission notice shall be included in
-// all copies or substantial portions of the Software.
-// 
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-// THE SOFTWARE.
+// Released under the MIT License.
+// Copyright, 2021-2025, by Samuel Williams.
 
 #pragma once
 
@@ -24,6 +7,8 @@
 #include <ruby/thread.h>
 #include <ruby/io.h>
 
+#include "../time.h"
+
 #ifdef HAVE_RUBY_IO_BUFFER_H
 #include <ruby/io/buffer.h>
 #include <ruby/fiber/scheduler.h>
@@ -33,8 +18,6 @@
 #define RUBY_FIBER_SCHEDULER_VERSION 1
 #endif
 
-#include <time.h>
-
 #ifdef HAVE_SYS_WAIT_H
 #include <sys/wait.h>
 #endif
@@ -58,6 +41,9 @@ static inline int IO_Event_try_again(int error) {
 
 VALUE IO_Event_Selector_fiber_transfer(VALUE fiber, int argc, VALUE *argv);
 
+// Specifically for transferring control to a user fiber.
+VALUE IO_Event_Selector_fiber_transfer_user(VALUE fiber, int argc, VALUE *argv);
+
 #ifdef HAVE__RB_FIBER_RAISE
 #define IO_Event_Selector_fiber_raise(fiber, argc, argv) rb_fiber_raise(fiber, argc, argv)
 #else
@@ -146,11 +132,8 @@ VALUE IO_Event_Selector_yield(struct IO_Event_Selector *backend)
 	return IO_Event_Selector_resume(backend, 1, &backend->loop);
 }
 
-void IO_Event_Selector_queue_push(struct IO_Event_Selector *backend, VALUE fiber);
-int IO_Event_Selector_queue_flush(struct IO_Event_Selector *backend);
-
-void IO_Event_Selector_elapsed_time(struct timespec* start, struct timespec* stop, struct timespec *duration);
-void IO_Event_Selector_current_time(struct timespec *time);
+// Append to the ready queue.
+void IO_Event_Selector_ready_push(struct IO_Event_Selector *backend, VALUE fiber);
 
-#define IO_EVENT_PRINTF_TIMESPEC "%lld.%.9ld"
-#define IO_EVENT_PRINTF_TIMESPEC_ARGUMENTS(ts) (long long)((ts).tv_sec), (ts).tv_nsec
+// Flush the ready queue by transferring control one at a time.
+int IO_Event_Selector_ready_flush(struct IO_Event_Selector *backend);

data/ext/io/event/selector/uring.c

@@ -1,27 +1,10 @@
-// Copyright, 2021, by Samuel G. D. Williams. <http://www.codeotaku.com>
-// 
-// Permission is hereby granted, free of charge, to any person obtaining a copy
-// of this software and associated documentation files (the "Software"), to deal
-// in the Software without restriction, including without limitation the rights
-// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-// copies of the Software, and to permit persons to whom the Software is
-// furnished to do so, subject to the following conditions:
-// 
-// The above copyright notice and this permission notice shall be included in
-// all copies or substantial portions of the Software.
-// 
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-// THE SOFTWARE.
+// Released under the MIT License.
+// Copyright, 2021-2025, by Samuel Williams.
 
 #include "uring.h"
 #include "selector.h"
-#include "list.h"
-#include "array.h"
+#include "../list.h"
+#include "../array.h"
 
 #include <liburing.h>
 #include <poll.h>
@@ -238,9 +221,9 @@ VALUE IO_Event_Selector_URing_allocate(VALUE self) {
 	
 	selector->completions.element_initialize = IO_Event_Selector_URing_Completion_initialize;
 	selector->completions.element_free = IO_Event_Selector_URing_Completion_free;
-	int result = IO_Event_Array_allocate(&selector->completions, IO_EVENT_ARRAY_DEFAULT_COUNT, sizeof(struct IO_Event_Selector_URing_Completion));
+	int result = IO_Event_Array_initialize(&selector->completions, IO_EVENT_ARRAY_DEFAULT_COUNT, sizeof(struct IO_Event_Selector_URing_Completion));
 	if (result < 0) {
-		rb_sys_fail("IO_Event_Selector_URing_allocate:IO_Event_Array_allocate");
+		rb_sys_fail("IO_Event_Selector_URing_allocate:IO_Event_Array_initialize");
 	}
 	
 	return instance;
@@ -318,7 +301,7 @@ VALUE IO_Event_Selector_URing_push(VALUE self, VALUE fiber)
 	struct IO_Event_Selector_URing *selector = NULL;
 	TypedData_Get_Struct(self, struct IO_Event_Selector_URing, &IO_Event_Selector_URing_Type, selector);
 	
-	IO_Event_Selector_queue_push(&selector->backend, fiber);
+	IO_Event_Selector_ready_push(&selector->backend, fiber);
 	
 	return Qnil;
 }
@@ -1103,7 +1086,7 @@ unsigned select_process_completions(struct IO_Event_Selector_URing *selector) {
 		if (waiting && waiting->fiber) {
 			assert(waiting->result != -ECANCELED);
 			
-			IO_Event_Selector_fiber_transfer(waiting->fiber, 0, NULL);
+			IO_Event_Selector_fiber_transfer_user(waiting->fiber, 0, NULL);
 		}
 	}
 	
@@ -1122,7 +1105,7 @@ VALUE IO_Event_Selector_URing_select(VALUE self, VALUE duration) {
 	// Flush any pending events:
 	io_uring_submit_flush(selector);
 	
-	int ready = IO_Event_Selector_queue_flush(&selector->backend);
+	int ready = IO_Event_Selector_ready_flush(&selector->backend);
 	
 	int result = select_process_completions(selector);
 	
@@ -1142,14 +1125,14 @@ VALUE IO_Event_Selector_URing_select(VALUE self, VALUE duration) {
 		
 		if (!selector->backend.ready && !timeout_nonblocking(arguments.timeout)) {
 			struct timespec start_time;
-			IO_Event_Selector_current_time(&start_time);
+			IO_Event_Time_current(&start_time);
 			
 			// This is a blocking operation, we wait for events:
 			result = select_internal_without_gvl(&arguments);
 			
 			struct timespec end_time;
-			IO_Event_Selector_current_time(&end_time);
-			IO_Event_Selector_elapsed_time(&start_time, &end_time, &selector->idle_duration);
+			IO_Event_Time_current(&end_time);
+			IO_Event_Time_elapsed(&start_time, &end_time, &selector->idle_duration);
 			
 			// After waiting/flushing the SQ, check if there are any completions:
 			if (result > 0) {

data/ext/io/event/selector/uring.h

@@ -1,22 +1,5 @@
-// Copyright, 2021, by Samuel G. D. Williams. <http://www.codeotaku.com>
-// 
-// Permission is hereby granted, free of charge, to any person obtaining a copy
-// of this software and associated documentation files (the "Software"), to deal
-// in the Software without restriction, including without limitation the rights
-// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-// copies of the Software, and to permit persons to whom the Software is
-// furnished to do so, subject to the following conditions:
-// 
-// The above copyright notice and this permission notice shall be included in
-// all copies or substantial portions of the Software.
-// 
-// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-// THE SOFTWARE.
+// Released under the MIT License.
+// Copyright, 2021-2025, by Samuel Williams.
 
 #pragma once
 

data/ext/io/event/time.c

@@ -0,0 +1,28 @@
+// Released under the MIT License.
+// Copyright, 2025, by Samuel Williams.
+
+#include "time.h"
+
+void IO_Event_Time_elapsed(struct timespec* start, struct timespec* stop, struct timespec *duration)
+{
+	if ((stop->tv_nsec - start->tv_nsec) < 0) {
+		duration->tv_sec = stop->tv_sec - start->tv_sec - 1;
+		duration->tv_nsec = stop->tv_nsec - start->tv_nsec + 1000000000;
+	} else {
+		duration->tv_sec = stop->tv_sec - start->tv_sec;
+		duration->tv_nsec = stop->tv_nsec - start->tv_nsec;
+	}
+}
+
+float IO_Event_Time_duration(struct timespec *duration)
+{
+	return duration->tv_sec + duration->tv_nsec / 1000000000.0;
+}
+
+void IO_Event_Time_current(struct timespec *time) {
+	clock_gettime(CLOCK_MONOTONIC, time);
+}
+
+float IO_Event_Time_proportion(struct timespec *duration, struct timespec *total_duration) {
+	return IO_Event_Time_duration(duration) / IO_Event_Time_duration(total_duration);
+}

data/ext/io/event/time.h

@@ -0,0 +1,16 @@
+// Released under the MIT License.
+// Copyright, 2025, by Samuel Williams.
+
+#pragma once
+
+#include <ruby.h>
+#include <time.h>
+
+void IO_Event_Time_elapsed(struct timespec* start, struct timespec* stop, struct timespec *duration);
+float IO_Event_Time_duration(struct timespec *duration);
+void IO_Event_Time_current(struct timespec *time);
+
+float IO_Event_Time_proportion(struct timespec *duration, struct timespec *total_duration);
+
+#define IO_EVENT_TIME_PRINTF_TIMESPEC "%.3g"
+#define IO_EVENT_TIME_PRINTF_TIMESPEC_ARGUMENTS(ts) ((double)(ts).tv_sec + (ts).tv_nsec / 1e9)

data/lib/io/event/version.rb

@@ -7,6 +7,6 @@
 class IO
 	# @namespace
 	module Event
-		VERSION = "1.7.5"
+		VERSION = "1.8.0"
 	end
 end

data/readme.md

@@ -18,6 +18,10 @@ Please see the [project documentation](https://socketry.github.io/io-event/) for
 
 Please see the [project releases](https://socketry.github.io/io-event/releases/index) for all releases.
 
+### v1.8.0
+
+  - [Detecing fibers that are stalling the event loop.](https://socketry.github.io/io-event/releases/index#detecing-fibers-that-are-stalling-the-event-loop.)
+
 ### v1.7.5
 
   - Fix `process_wait` race condition on EPoll that could cause a hang.

data/releases.md

@@ -1,5 +1,31 @@
 # Releases
 
+## v1.8.0
+
+### Detecing fibers that are stalling the event loop.
+
+A new (experimental) feature for detecting fiber stalls has been added. This feature is disabled by default and can be enabled by setting the `IO_EVENT_SELECTOR_STALL_LOG_THRESHOLD` to `true` or a floating point number representing the threshold in seconds.
+
+When enabled, the event loop will measure and profile user code when resuming a fiber. If the fiber takes too long to return back to the event loop, the event loop will log a warning message with a profile of the fiber's execution.
+
+    > cat test.rb 
+    #!/usr/bin/env ruby
+    
+    require_relative "lib/async"
+    
+    Async do
+    	Fiber.blocking do
+    		sleep 1
+    	end
+    end
+    
+    > IO_EVENT_SELECTOR_STALL_LOG_THRESHOLD=true bundle exec ./test.rb
+    Fiber stalled for 1.003 seconds
+    	/home/samuel/Developer/socketry/async/test.rb:6 in '#<Class:Fiber>#blocking' (1s)
+    		/home/samuel/Developer/socketry/async/test.rb:7 in 'Kernel#sleep' (1s)
+
+There is a performance overhead to this feature, so it is recommended to only enable it when debugging performance issues.
+
 ## v1.7.5
 
   - Fix `process_wait` race condition on EPoll that could cause a hang.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: io-event
 version: !ruby/object:Gem::Version
-  version: 1.7.5
+  version: 1.8.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -13,7 +13,6 @@ authors:
 - Anthony Ross
 - Delton Ding
 - Pavel Rosický
-autorequire:
 bindir: bin
 cert_chain:
 - |
@@ -45,10 +44,8 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2024-12-15 00:00:00.000000000 Z
+date: 2025-02-05 00:00:00.000000000 Z
 dependencies: []
-description:
-email:
 executables: []
 extensions:
 - ext/extconf.rb
@@ -56,21 +53,25 @@ extra_rdoc_files: []
 files:
 - design.md
 - ext/extconf.rb
+- ext/io/event/array.h
 - ext/io/event/event.c
 - ext/io/event/event.h
 - ext/io/event/interrupt.c
 - ext/io/event/interrupt.h
-- ext/io/event/selector/array.h
+- ext/io/event/list.h
+- ext/io/event/profile.c
+- ext/io/event/profile.h
 - ext/io/event/selector/epoll.c
 - ext/io/event/selector/epoll.h
 - ext/io/event/selector/kqueue.c
 - ext/io/event/selector/kqueue.h
-- ext/io/event/selector/list.h
 - ext/io/event/selector/pidfd.c
 - ext/io/event/selector/selector.c
 - ext/io/event/selector/selector.h
 - ext/io/event/selector/uring.c
 - ext/io/event/selector/uring.h
+- ext/io/event/time.c
+- ext/io/event/time.h
 - lib/io/event.rb
 - lib/io/event/debug/selector.rb
 - lib/io/event/interrupt.rb
@@ -90,7 +91,6 @@ licenses:
 metadata:
   documentation_uri: https://socketry.github.io/io-event/
   source_code_uri: https://github.com/socketry/io-event.git
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -105,8 +105,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
 summary: An event loop.
 test_files: []