feat(ke): logging and consoles

This commit is contained in:
Loïc Grégoire
2026-03-28 01:01:36 -04:00
parent 76e13c3b7a
commit a589b5a56f
7 changed files with 653 additions and 29 deletions
+66 -16
View File
@@ -1,33 +1,52 @@
const std = @import("std");
const b = @import("base");
const rtl = @import("rtl");
const pl = b.pl;
const ke = b.ke;
const ki = ke.private;
pub var debug_lock = ke.SpinLock.init();
var console_lock = ke.SpinLock.init();
var console_list: rtl.List = .{ .head = .{ .next = &console_list.head, .prev = &console_list.head } };
pub fn print(bytes: []const u8) void {
for (bytes) |c| {
pl.debug_write(c);
}
/// Represents a console device.
/// This is used as an output device.
pub const Console = struct {
last_seq: u64,
write: WriteFn,
link: rtl.List.Entry,
pub const WriteFn = *const fn (self: *Console, data: []const u8) void;
};
/// Register a console.
pub fn register_console(console: *Console) void {
const ipl = console_lock.acquire();
console_list.insert_tail(&console.link);
console_lock.release(ipl);
flush();
}
const LogWriter = struct {
const ConsoleWriter = struct {
interface: std.Io.Writer,
console: *Console,
pub fn init() LogWriter {
pub fn init(console: *Console) ConsoleWriter {
return .{
.interface = .{
.vtable = &.{ .drain = drain },
.buffer = &.{},
.end = 0,
},
.console = console,
};
}
fn drain(_: *std.Io.Writer, data: []const []const u8, _: usize) std.Io.Writer.Error!usize {
fn drain(w: *std.Io.Writer, data: []const []const u8, _: usize) std.Io.Writer.Error!usize {
const self: *ConsoleWriter = @fieldParentPtr("interface", w);
var total_written: usize = 0;
for (data) |slice| {
print(slice);
self.console.write(self.console, slice);
total_written += slice.len;
}
@@ -35,6 +54,34 @@ const LogWriter = struct {
}
};
var ringbuffer = ki.log_ring.RingBuffer(14, 5).init();
fn flush() void {
var buf: [512]u8 = undefined;
// Note: we trylock here because if the lock is already held, that means
// someone else is already flushing the logs.
if (console_lock.try_acquire()) |ipl| {
var it = console_list.iterator();
while (it.next()) : (it.advance()) {
const console: *Console = @fieldParentPtr("link", it.get());
var writer = ConsoleWriter.init(console);
while (true) {
const info = ringbuffer.read(console.last_seq, &buf) catch break;
writer.interface.print("[{:>5}.{:06}] ", .{ info.timestamp / std.time.ns_per_s, info.timestamp / std.time.ns_per_us }) catch break;
console.write(console, buf[0..info.length]);
console.last_seq = info.sequence + 1;
}
}
console_lock.release(ipl);
}
}
pub fn log(
comptime level: std.log.Level,
comptime scope: @EnumLiteral(),
@@ -44,14 +91,17 @@ pub fn log(
_ = level;
_ = scope;
const ipl = debug_lock.acquire();
var discarder: std.Io.Writer.Discarding = .init(&.{});
discarder.writer.print(fmt ++ "\n", args) catch return;
var writer = LogWriter.init();
var res = ringbuffer.reserve(discarder.fullCount()) catch return;
writer.interface.print(
fmt ++ "\r\n",
args,
) catch unreachable;
res.info.timestamp = ke.timecounter.read_time_nano();
res.info.length = @truncate(discarder.fullCount());
debug_lock.release(ipl);
res.buf = std.fmt.bufPrint(res.buf, fmt ++ "\n", args) catch return;
ringbuffer.publish(res);
flush();
}