summaryrefslogtreecommitdiff
path: root/anim/scenes/column.zig
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-11-11 23:46:02 -0300
committerGabriel Schneider <[email protected]>2026-11-12 01:40:04 -0300
commit60e07feef401d9044db3a1c925cb9d1f6d20dac9 (patch)
tree98957ba8425193f686c8e8692cd10a10f27dbf4b /anim/scenes/column.zig
parent9c0696447dbc5cf37e56aee562c7ebba4f4d4e6b (diff)
downloadcomputeranim-60e07feef401d9044db3a1c925cb9d1f6d20dac9.tar.gz
computeranim-60e07feef401d9044db3a1c925cb9d1f6d20dac9.zip
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 <[email protected]> Claude-Session: https://claude.ai/code/session_016Y9MNCKgYCGiANnEwcEQxa
Diffstat (limited to 'anim/scenes/column.zig')
-rw-r--r--anim/scenes/column.zig16
1 files changed, 8 insertions, 8 deletions
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\"`" } },