From 401da8c6ec57d61134a519c0f98c8554ee17b7b8 Mon Sep 17 00:00:00 2001
From: Nathan Flurry <git@nathanflurry.com>
Date: Sun, 19 Jul 2026 00:52:47 -0700
Subject: [PATCH] chore(kernel): add opt-in AGENTOS_DEBUG_EBADF mapped-fd
 backtrace

---
 crates/kernel/src/fd_table.rs | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/crates/kernel/src/fd_table.rs b/crates/kernel/src/fd_table.rs
index 38af512e3f..a262af6ec8 100644
--- a/crates/kernel/src/fd_table.rs
+++ b/crates/kernel/src/fd_table.rs
@@ -143,6 +143,14 @@ impl FdTableError {
     }
 
     fn bad_file_descriptor(fd: u32) -> Self {
+        // TEMPORARY DIAGNOSTIC (load-testing LT-024): capture where a mapped
+        // host fd (>= MAPPED_HOST_FD_START) reaches the kernel fd table.
+        if std::env::var("AGENTOS_DEBUG_EBADF").as_deref() == Ok("1") && fd >= 1_000_000_000 {
+            eprintln!(
+                "AGENTOS_DEBUG_EBADF fd={fd}\n{}",
+                std::backtrace::Backtrace::force_capture()
+            );
+        }
         Self {
             code: "EBADF",
             message: format!("bad file descriptor {fd}"),