From 60e07feef401d9044db3a1c925cb9d1f6d20dac9 Mon Sep 17 00:00:00 2001 From: Gabriel Schneider Date: Wed, 11 Nov 2026 23:46:02 -0300 Subject: canim: relations as one data-oriented subsystem; aim; the ASan pair; the introduction's chapters From the user. Relations between panes are one subsystem: per-frame tables of places and values in struct-of-arrays, owned by the frame; the kinds one table of data; a resolver of pure passes (join, filter, priority, cut) unit-tested on hand-written tables. Ported kinds draw byte-identical frames; a synthetic map of 4000 places and 6000 values resolves in 0.56 ms against the old table's 5.7. aim, a word holding a code address tied to its row, is the first new kind, off unless a scene turns it on. The ASan pair: one overflow built plain and with ASan, recorded by instruction; the frame as bytes eight a row; the plain run goes on alone in the column, its return address aimed at main's row until the letters reach it; the fault at ret. The introduction's three chapters are built and tested, not yet exported. Annotations, rows and scrolls that changed in one frame now fade; captions stand twelve seconds at most. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_016Y9MNCKgYCGiANnEwcEQxa --- anim/scenes/column.zig | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) (limited to 'anim/scenes/column.zig') diff --git a/anim/scenes/column.zig b/anim/scenes/column.zig index b1a8df7..db211a7 100644 --- a/anim/scenes/column.zig +++ b/anim/scenes/column.zig @@ -55,40 +55,40 @@ fn frame(s: *anim.Frame) void { // C2: the arguments, beside the rows that set them. col.beat(s, .{ .panes = &.{ .{ .source, 3 }, .{ .disasm, 11 }, .{ .registers, regs } }, - .say = "main puts open's arguments where the convention says: \"note\" in `rdi`, 0 (O_RDONLY) in `rsi`.", + .say = "main puts open's arguments in registers: \"note\" in `rdi`, O_RDONLY in `rsi`.", .notes = &.{ .{ .band, "none yet" }, .{ .view, "no call crossing" } }, }); cur.walk(s, .moment, stub - 1); // C3: the call goes down; the stack under the descent. col.beat(s, .{ .panes = &.{ .{ .source, 3 }, .{ .disasm, 11 }, .{ .stack, rest } }, - .say = "The call pushes where to come back to, `main+45`, and goes down to open's stub.", + .say = "The call pushes the way back, `main+45`, and goes down to the stub.", }); canim.descent.step(cur, s, .moment); s.wait(t.phrase_rest); // C4: the stub's jmp: the stack holds still. - col.beat(s, .{ .say = "The stub in the PLT is one jump: it reads `open@got`, where the loader wrote libc's `open`. It pushes nothing.", .panes = &.{ .{ .source, 3 }, .{ .disasm, 11 }, .{ .stack, rest } } }); + col.beat(s, .{ .say = "The stub is one jump through `open@got`: it pushes nothing.", .panes = &.{ .{ .source, 3 }, .{ .disasm, 11 }, .{ .stack, rest } } }); canim.descent.step(cur, s, .moment); s.wait(t.phrase_rest); // C5: the wrapper at a run, the bubble level with its window's head. col.beat(s, .{ - .panes = &.{ .{ .source, 3 }, .{ .disasm, 11 }, .{ .stack, rest } }, + .panes = &.{ .{ .source, 2 }, .{ .disasm, 11 }, .{ .stack, rest } }, .say = "libc's `open` is a wrapper: a few lines of C around the one instruction that calls the kernel.", .level = .{ .head = "open" }, }); cur.hurry(s, .moment, crossing - 3, .{}); // C6: its last three, beside the registers they set. col.beat(s, .{ - .panes = &.{ .{ .source, 3 }, .{ .disasm, 11 }, .{ .registers, regs } }, - .say = "Its last three set the kernel's arguments: AT_FDCWD in `rdi`, and 257, openat's number, in `rax`.", + .panes = &.{ .{ .source, 2 }, .{ .disasm, 11 }, .{ .registers, regs } }, + .say = "Its last three set the kernel's arguments, and openat's number, 257, in `rax`.", .stem = .none, - .notes = &.{ .{ .band, "none yet" }, .{ .view, "`\"note\"`" } }, + .notes = &.{ .{ .band, "none yet" }, .{ .view, "`\"note\"` handed in" }, .{ .stack, "open's frame, 16 words" } }, }); cur.walk(s, .moment, crossing); // C7: the crossing, the kernel at the descent's floor. col.beat(s, .{ .panes = &.{ .{ .source, 3 }, .{ .disasm, 24 } }, - .say = "`syscall` crosses down. The kernel opens \"note\" and answers 3: the file's descriptor, in `rax`.", + .say = "`syscall` crosses down; the kernel opens \"note\" and answers 3 in `rax`.", .level = .floor, .stem = .none, .notes = &.{ .{ .band, "none yet" }, .{ .view, "`\"note\"`" } }, -- cgit v1.3