From 8767dbecb45bbe5f748952fb9171b1a96c173f67 Mon Sep 17 00:00:00 2001
From: salmonik <salmonik@tuta.io>
Date: Thu, 27 Aug 2026 17:16:04 +0200
Subject: tool migration: v2 exports + 10 external CLI binaries
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

rsapi v2: 14 new ABI function pointers appended after v1 — fs_resolve,
fs_dir_next (iterator), fs_create, fs_remove, fs_read, fs_write,
fs_size, fs_close, rtc_now, mem_stats, pci_probe, pci_device,
klog_dump, kernel_version.  New C-repr structs: DirEntry, RtcTime,
MemStats, PciDevice, KernelVersion.  ABI_VERSION bumped to 2.

Shell-side: build_exports() constructs the full table at runtime per
invocation (replaces static const).  14 kernel-side wrapper functions
bridge rsapi types to rsnix kernel APIs; fs_dir_next maintains a
per-handle cache of children() results for iteration.

Tool binaries (10 crates, all linked against rsapi only):
- date: rtc_now → formatted YYYY-MM-DD HH:MM:SS
- mem: heap/pages free/total via mem_stats
- pci: pci_probe + pci_device enumerate all devices
- cat: fs_read paths or get_line stdin; put_line output
- ls: fs_resolve + fs_dir_next iteration; trailing / for dirs
- mkdir: fs_create(path, true)
- touch: fs_create(path, false)
- rm: fs_remove(path)
- klog: klog_dump 2048 bytes → put_line
- info: rtc_now + kernel_version (minimal; mem/pci deferred)

Gate verified: date prints RTC; pci lists all 4 QEMU devices
(8086:29c0, 1234:1111, 8086:10d3, 8086:2918); hello/boom/count
still work; test-disk PASS; poweroff clean.
---
 bins/ls/src/main.rs | 47 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 bins/ls/src/main.rs

(limited to 'bins/ls/src/main.rs')

diff --git a/bins/ls/src/main.rs b/bins/ls/src/main.rs
new file mode 100644
index 0000000..956bf18
--- /dev/null
+++ b/bins/ls/src/main.rs
@@ -0,0 +1,47 @@
+//! ls — list directory contents via the exports table.
+//!
+//! Args: [path] — defaults to "." (root).
+
+#![no_std]
+#![no_main]
+
+#[panic_handler]
+fn panic(_info: &core::panic::PanicInfo) -> ! {
+    loop { core::hint::spin_loop(); }
+}
+
+fn put(exports: &rsapi::Exports, buf: &[u8]) {
+    (exports.put_line)(rsapi::Line { ptr: buf.as_ptr(), len: buf.len() });
+}
+
+#[unsafe(no_mangle)]
+pub extern "C" fn efi_main(exports: &'static rsapi::Exports, argc: usize, argv: *const rsapi::Arg) -> i32 {
+    let path_str = if argc > 0 {
+        let a = unsafe { &*argv };
+        unsafe { core::str::from_utf8_unchecked(core::slice::from_raw_parts(a.ptr, a.len)) }
+    } else {
+        "/"
+    };
+    let h = (exports.fs_resolve)(rsapi::Line { ptr: path_str.as_ptr(), len: path_str.len() });
+    if h < 0 { return 1; }
+    let mut entry = rsapi::DirEntry {
+        name: rsapi::Line { ptr: core::ptr::null(), len: 0 },
+        is_dir: false,
+        _pad: 0,
+        size: 0,
+    };
+    while (exports.fs_dir_next)(h, &mut entry) {
+        let name = unsafe { core::str::from_utf8_unchecked(core::slice::from_raw_parts(entry.name.ptr, entry.name.len)) };
+        if entry.is_dir {
+            let mut buf = [0u8; 64];
+            let nb = name.as_bytes();
+            buf[..nb.len()].copy_from_slice(nb);
+            buf[nb.len()] = b'/';
+            put(exports, &buf[..nb.len() + 1]);
+        } else {
+            put(exports, name.as_bytes());
+        }
+    }
+    (exports.fs_close)(h);
+    0
+}
-- 
cgit v1.2.3