summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-11-11 21:45:12 -0300
committerGabriel Schneider <[email protected]>2026-11-11 22:10:47 -0300
commit479d4914ecd8c7bfea68f9357ace1a4a6d0006ab (patch)
tree4ea06494a9deb8bdb28be2fe60a6cbfc3fa55f71
parent15de88cf82c187635c1989e91bfa639a10304066 (diff)
downloadcomputeranim-479d4914ecd8c7bfea68f9357ace1a4a6d0006ab.tar.gz
computeranim-479d4914ecd8c7bfea68f9357ace1a4a6d0006ab.zip
design: the column as a form of the language; the ASan pair and the introduction storyboarded
From the user: the column style is a tool a scene's author can use. It is a standard form beside the working frame (which stays the default): for stories of rows going down and back. A scene changes form in a rest, in a fixed order, about 70 frames each way. Bubbles fit their reading in their lead and steps; panes change only when the subject moves. The ASan pair (112 s) uses the pair, then the column while plain runs on alone, then the pair for the fault; the introduction (123 s) mixes the frame at x2, the column for the address space and the stack, and text above the aligned code. Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_016Y9MNCKgYCGiANnEwcEQxa
-rw-r--r--design/README.md217
-rw-r--r--design/mock/49-column-call-480.pngbin28172 -> 27010 bytes
-rw-r--r--design/mock/49-column-call.pngbin191880 -> 184799 bytes
-rw-r--r--design/mock/49-column-call.svg9
-rw-r--r--design/mock/50-column-stub-480.pngbin29831 -> 27462 bytes
-rw-r--r--design/mock/50-column-stub.pngbin196916 -> 187159 bytes
-rw-r--r--design/mock/50-column-stub.svg11
-rw-r--r--design/mock/51-column-args-480.pngbin27318 -> 25766 bytes
-rw-r--r--design/mock/51-column-args.pngbin154753 -> 146051 bytes
-rw-r--r--design/mock/51-column-args.svg12
-rw-r--r--design/mock/52-column-cross-480.pngbin26759 -> 24836 bytes
-rw-r--r--design/mock/52-column-cross.pngbin166439 -> 158837 bytes
-rw-r--r--design/mock/52-column-cross.svg12
-rw-r--r--design/mock/53-column-back-480.pngbin28740 -> 28013 bytes
-rw-r--r--design/mock/53-column-back.pngbin190377 -> 186572 bytes
-rw-r--r--design/mock/53-column-back.svg5
-rw-r--r--design/mock/54-column-present.pngbin419583 -> 410915 bytes
-rw-r--r--design/mock/column.py41
-rw-r--r--design/motion.md254
19 files changed, 301 insertions, 260 deletions
diff --git a/design/README.md b/design/README.md
index 60e6cea..253be7a 100644
--- a/design/README.md
+++ b/design/README.md
@@ -93,8 +93,8 @@ this table.
| | [`map`](#the-map-and-the-minimap) | the working frame unfolded, every panel whole: 3840 by 2160 | the key |
| | [`minimap`](#the-map-and-the-minimap) | a pane's whole column of the map, small, in a strip at its right | its window, marks, `flash` |
| | [`clock`](#clock-and-caption) | where in the recording | |
-| | [`column`](#column-an-experiment) | an experiment: the panes a beat is about in one column, its narration in the other | the `shelf` of folded panes |
-| | [`bubble`](#column-an-experiment) | a piece of narration placed in the frame, level with what it speaks of | `beside`, `below`, `above`, `on`; newest, older; its `stem` |
+| | [`column`](#column) | the second form a scene is composed in: the panes a beat is about in one column, its narration in the other | the `shelf` of folded panes; text on the right, or on the left while the program column is empty |
+| | [`bubble`](#column) | a piece of narration placed in the frame, level with what it speaks of | `beside`, `below`, `above`, `on`; newest, older; its `stem` |
| | [`caption`](#clock-and-caption) | the narrator | |
| | [`veil`](#clock-and-caption) | page over what a beat does not touch, or a pace cannot show | |
| | [`card`](#clock-and-caption) | a title, the legend: no program running | |
@@ -1359,7 +1359,7 @@ give way: where a step draws a link and a projection it is an echo (the word's
mark with the row's, at the same frame), its two ends being side by side and
the name and the digits saying already that they are one. rsp never takes a
link: its pin is on the window's top row by construction.
-[`establish`](#6-verbs) draws no lines. In the [`column`](#column-an-experiment)
+[`establish`](#6-verbs) draws no lines. In the [`column`](#column)
a bubble's stem stands only in the rest before a step, never with its ties.
**Off the window.** A link whose target is outside its panel's window (a
@@ -1880,23 +1880,53 @@ caption's and the clock's.
band), x2 (896 by 420: sixteen rows), x4 (448 by 210: one chain). It is
for reading, and always comes back.
-### column (an experiment)
+### column
-A second way to compose a scene, beside the working frame, to be tried on one
-scene and judged against it (the trial: [`open` followed down in the
-column](motion.md#a-scene-in-the-column-open-followed-down); mocks 49 to 55).
-It is not the language's default. The working frame shows the whole context
-and a caption under it; the column shows, beat by beat, the panes the beat is
-about and says what they do beside them, where they do it. It is an author's
-instrument: the scene says for every beat which panes stand, where each bubble
-sits and what it is tied to; the defaults below only spare typing, and never
-decide against what the scene wrote.
+The second way to compose a scene, beside the working frame, which stays the
+default where a scene chooses nothing. The working frame shows the whole
+context with a caption under it; the column shows the panes a beat is about
+in one column and says what they do beside them, level with where they do it
+([a scene built this way](motion.md#a-scene-in-the-column-open-followed-down);
+mocks 49 to 55; the renders `column-1080` beside `syscalls-1080`, and
+`column_sort-1080`). It is an author's instrument: the scene says for every
+beat its form, which panes stand, where its text sits and what it is tied to;
+the defaults below only spare typing, and never decide against what the scene
+wrote.
+
+**When to reach for it.** When the story is a column of rows that goes down
+and comes back: a call followed down to the kernel and back up, a recursion,
+the stack growing and shrinking, a frame filling byte by byte, a loop told
+turn by turn beside its rows. There the text, level with its row, moves as
+the story does, and the panes the beat needs get the height (a descent of 24
+rows where the working frame gives 17). **When the working frame serves
+better**: when every step acts on the program and the state at once (sort's
+swaps with the array, the heap scene's nodes over their bytes, a `continue`
+whose registers all change), when two runs face each other (the
+[`pair`](#pair)), and for a scene's opening and close, where the whole
+context is the point. Most scenes mix the two.
+
+**Mixing them.** A scene in the working frame takes the column for a few
+beats and comes back; the change is made in a rest, between beats, in one
+order and never in one frame. Into the column: the caption leaves (12 f); the
+panes the column will not keep fold to their tags where they stand (rows out
+6 f, then the panel closes as its tag travels to the shelf, 18 f, `glide`),
+so that no panel ever crosses another, empty or not; then the panes that stay
+glide and resize to their boxes (24 f), their rows riding with them; the
+text column opens and the first bubble arrives (18 f). Back to the working
+frame: the bubbles leave together (12 f); the panes glide to their working
+frame's boxes (24 f); the folded panes unfold from the shelf in their places
+(18 f, rows in 6 f); the caption arrives. About 70 f each way. A drawing that
+changes size between the forms keeps its labels inside its box at every frame:
+it scales as one (24 f) and its tag's note crossfades if it no longer fits.
**The frame.** Two columns of 880, the working frame's own: the panes on the
left (x 64), where the program column is in the working frame, so that a scene
going between the two keeps its source and disassembly where they were; the
text on the right (x 976), as an assembler's comment and the row's annotation
-sit right of the code they speak of. The gutter between keeps its lanes.
+sit right of the code they speak of. While the program column has nothing in
+it yet (an introduction building the state first, each part in the place it
+will keep) the text may stand on the left instead, beside the panes on the
+right. The gutter between keeps its lanes.
| Part | Where | |
| --- | --- | --- |
@@ -1913,28 +1943,40 @@ current one, when the beat changes line) and the pane where its effect lands
(the registers for a register, the stack for a stack word or a call's push,
the drawing when the idea changes); the cause's pane gets the rows its window
needs (a descent all its windows, the disassembly 11), the effect's the rest.
-A beat about the idea shows its drawing as large as the column lets it, or
-across both columns with its text above, below or on it (placements, below).
+Change the panes only where the beat's subject moves to another pane: each
+change costs about 1.4 s (the built scene changed them seven times, 9.5 s of
+its 23% more), so a column scene of eight beats should change them three or
+four times, not at every beat.
**Panes between beats.** What persists slides; nothing appears or vanishes in
one frame. In the rest between two beats, in this order: the last bubble
-dims; the panes that leave fold (their rows fade, 12 f, then the panel
-closes to its tag as the tag travels to its place on the shelf, 24 f,
-`glide`); the panes that stay glide to their new boxes (24 f); the panes that
-come unfold (the tag travels from the shelf to its box as the panel opens,
-24 f, then the rows fade in, 12 f); then an older bubble in the way glides out
-of it (24 f) and the next arrives. Never a fold and an unfold in one place at
-once: what leaves has left. About 70 f for the panes, 96 f more than a
-caption's change in all, and only in a rest (motion.md has the frames).
+dims; the panes that leave fold (rows out 6 f, the panel closing as its tag
+travels to the shelf, 18 f, `glide`); the panes that stay glide to their new
+boxes (24 f); the panes that come unfold (the tag from the shelf as the panel
+opens, 18 f, rows in 6 f); then an older bubble in the way glides out of it
+(24 f) and the next arrives. Never a fold and an unfold in one place at once.
+**A pane that stays and changes height keeps its rows** the whole way: its
+frame glides and its window gains or gives up rows at the edge that moves (the
+rows it loses fade as the edge reaches them, those it gains fade in behind
+it); it is never drawn empty, not for a frame (the built scene emptied its
+descent for 40 f while it grew).
-**`bubble`.** A piece of narration: one to three lines of at most 40
-characters, Go 40 on 54 as the caption is, code in mono 35; 16 of padding,
-812 wide at most. The newest is on `raised` paper, primary: the one being
-said. An older one loses its paper and dims to `dim` (18 f, as the next
-arrives), and stays as the account the viewer can glance back at. Three stand
-at most; a fourth's arrival makes the oldest leave first (12 f, `exit`).
-All leave at a chapter's end.
+**`bubble`.** A piece of narration: Go 40 on 54 as the caption is, code in
+mono 35, lines of at most 40 characters, 16 of padding, 812 wide at most. The
+newest is on `raised` paper, primary: the one being said. An older one loses
+its paper and dims to `dim` (18 f, as the next arrives), and stays as the
+account the viewer can glance back at. Three stand at most; a fourth's
+arrival makes the oldest leave first (12 f, `exit`). All leave at a chapter's
+end.
+- **How long**: its reading time (90 f + 3.6 f a character) is covered by its
+ beat: the 60 f lead, the beat's steps and a hold of at most 84 f, so that it
+ is never still being read while nothing moves (the built scene's 104
+ characters over a single step left 4.9 s of stillness). For one walked step
+ that is about 64 characters, two lines; three lines only for a beat whose
+ steps last as long as they take to read (a run, a crossing, a store at a
+ time). A held rest the scene means (a poster's picture) is said so, and is
+ the one exception.
- **Where it sits**: its first line level with the thing it speaks of (the
row's centre on the line's), so that the eye crosses on one line. The
author may name another level; the default is the row of the beat's first
@@ -1956,63 +1998,58 @@ All leave at a chapter's end.
bubble no stem; its level is then the tie.
- **The caption's rules, restated**: it arrives (18 f, rising 8) in a rest,
60 f before the step it describes fires (120 f for a scene's first); it is
- the newest at least 90 f + 3.6 f a character and at most 720 f; nothing
- arrives, moves or dims under a moving thing; it names only what is on
- screen at the pace it plays.
+ the newest at most 720 f; nothing arrives, moves or dims under a moving
+ thing; it names only what is on screen at the pace it plays.
**Placements.** Where a beat's text is, chosen per beat (or per scene):
| Placement | Where | For |
| --- | --- | --- |
-| `beside` | the text column; the panes in one column | a subject made of rows, or tall: the disassembly, a descent, the stack, the source and its instructions. The experiment's main form |
-| `below` | the caption band under the working frame (the present frame, every pane as it is) | a beat that needs the program and the state side by side: the scene's opening, which establishes everything; a `continue`; a step whose effects land in both columns at once |
-| `above` | a band of 120 over a wide subject at the stage's top, the subject under it | a wide drawing whose story runs down it (a calls tree growing, a graph in `layers`): the text leads the eye in at the top |
-| `on` | in the subject's own free space | a wide drawing with room inside it (a ring's interior, the corners round the rings, the gaps of the map's columns); tied by a stem to the part it speaks of |
+| `beside` | the text column; the panes in one column | a subject made of rows, or tall: the disassembly, a descent, the stack, a frame as bytes, the source and its instructions, the address space |
+| `below` | the caption band under the working frame (every pane as it is) | a beat that needs the program and the state side by side: a scene's opening, which establishes everything; a `continue`; a step whose effects land in both columns at once; a `pair` |
+| `above` | a band of 120 over a wide subject at the stage's top, the subject under it | a wide drawing whose story runs down it (a calls tree growing, a graph in `layers`, the `aligned` source and code): the text leads the eye in at the top |
+| `on` | in the subject's own free space | a wide drawing with room inside it (a ring's interior, the corners round the rings, the map's key and the gaps of its columns); tied by a stem to the part it speaks of |
The choice follows the subject's shape (rows: `beside`; wide: `above`, `below`
or `on`), where its free space is, and the way the story moves (text leads:
above when it runs down, below when the result arrives at the foot). A bubble
`on` a drawing keeps 16 clear of every element, every edge's path and every
-path a mark will travel while it stands (the renderer knows the beat's
-steps); its stem crosses nothing, going round the drawing's outside where it
-must (mock 55); where no such place holds it, the beat is `above`. A bubble
-never travels between placements: the last leaves (12 f), the frame changes
-(a [`relayout`](#6-verbs), 48 f), the next arrives (18 f). A scene that
-otherwise uses the column may stand the working frame as it is, both columns
-of panes, with its text below or above, for the beats that need both; the
-change is that relayout, between beats.
+path a mark will travel while it stands; its stem crosses nothing, going round
+the drawing's outside where it must (mock 55); where no such place holds it,
+the beat is `above`. The renderer finds the place and checks it from the
+beat's steps; a scene does not place it by hand. A bubble never travels
+between placements: the last leaves (12 f), the frame changes, the next
+arrives (18 f).
**Ties and paces in the column.** The step's ties are the frame's: the
-thread, a link, a projection, a touch. A touch from the disassembly to the
-stack under it leaves the row's right rule, goes down the gutter's middle lane
-and ends on the stack's right rule, its head pointing left (mock 49). At a
-run the panes keep their places and only the newest bubble stands; at a
-sprint the scene surfaces to the map as ever, and a bubble set `on` the map
-is the sprint's caption.
+thread, a link, a projection, a touch, a carry. A touch from the disassembly
+to the stack under it leaves the row's right rule, goes down the gutter's
+middle lane and ends on the stack's right rule, its head pointing left (mock
+49). At a run the panes keep their places and only the newest bubble stands;
+at a sprint the scene surfaces to the map as ever, and a bubble set `on` the
+map is the sprint's caption.
-**Reaching the whole context.** "We don't want to hide info" holds by three
-means: the shelf (every pane's tag, and each change in it struck there); a
-beat the author spends on the whole (`below`, the working frame), which the
-scene's opening is by default; and the map and `unroll`, as in the working
-frame.
+**Reaching the whole context.** Nothing is hidden: the shelf (every pane's
+tag, and each change in it struck there); the beats spent on the whole
+(`below`, the working frame), a scene's opening and close by default; and the
+map and `unroll`, as in the working frame.
-**What it costs and gains**, measured on the trial (the working frame's
-`beside` against the column at the same instant, mock 54):
+**Measures, as built** (`open` followed down, the working frame against the
+column at the crossing, mock 54 and the render):
| | The working frame | The column |
| --- | --- | --- |
-| the descent at the crossing | 17 rows (main 3, the stub 1, open 8, the kernel 2, heads 3) | 24 (main 5, open 13), and up to 27 with its floor above 888 |
-| source | 8 lines | 3 (the line and its neighbours) |
-| registers, stack, the log, its bytes | on screen, 14 rows, 11 words, 152, 152 | on the shelf, a tag each; rax 3 struck on its tag |
-| narration | 2 lines of 64 under the stage, 1792 by 120 | up to three bubbles of three lines of 40 beside the rows, 880 by 840 |
-| height for panes | 840 (48 to 888), shared by both columns' seven panes | 948 (84 to 1032), shared by the beat's two or three; 144 of it the floor |
+| the descent at the crossing | 17 rows (main 3, the stub 1, open 8, the kernel 2, heads 3) | 24 (main 5, open 13), up to 27 with its floor above 888 |
+| source | 8 lines | 3 |
+| registers, stack, the log, its bytes | on screen: 14 rows, 11 words, 152, 152 | on the shelf, a tag each; rax 3 struck on its tag |
+| narration | 2 lines of 64 under the stage | up to three bubbles of lines of 40 beside the rows; the newest level with its row in most beats |
+| height for panes | 840, shared by seven panes | 948 (84 to 1032), shared by two or three; 144 of it the floor |
+| length | 84 s | about a quarter longer (the renderer counts 23%): seven pane changes, about 9.5 s of it |
-The caption band is not gained as narrated rows: it is under a paused
-player's controls in either form, and the column keeps narrated rows above
-888. What is gained is the right column (the state panes' 880 by 840) given
-to the narration and the left one given to fewer panes: a descent half again
-as tall, a stack of nineteen words beside a call, and text that says where it
-speaks.
+The caption band is not gained as narrated rows (it is under a paused
+player's controls in either form); what is gained is the state column given
+to the narration and the program column to fewer, taller panes, and text
+that says where it speaks.
## 6. Verbs
@@ -2163,7 +2200,7 @@ recording of `mock/heap.c`; `mock/intro.py` draws the introduction and
its blocks (29 to 37) from the same list recording and its mappings;
`mock/gen.py` draws 1 to 8; `mock/touch.py` draws the disassembly tied to the
stack (44 to 48) and the carry (56) from a fresh recording of `reverse` and its call; `mock/column.py`
-the column experiment (49 to 55) from a fresh recording of `hello`. Each working
+the column (49 to 55) from a fresh recording of `hello`. Each working
frame has a `-480.png` beside it; the map has its 1080p (`19-map-1080.png`).
```sh
@@ -2503,6 +2540,27 @@ is not checked here. The tokens are under [Token changes](#token-changes).
instruction's own annotation saying the move (`rsp -0x18 3 words`,
`rbp = rsp`, `rsp +8 · saved rbp`); at a run the pins over the veil.
+15. **The column** ([column](#column)), now a form every scene may use, per
+ scene or per beat, the working frame its default. Built (`column`,
+ `column_sort`): the two columns, the shelf, the bubbles level with their
+ rows, the placements, the scene API. To fix, as the renders show them:
+ **a pane that stays and resizes keeps its rows** (the descent was drawn
+ empty for about 40 f while it grew: its frame must glide with its rows
+ in it, rows lost at the moving edge fading as it reaches them, rows gained
+ fading in behind it); **no panel crosses another in a change of form**
+ (the working frame's panels slid over each other, empty, on the way into
+ the column, and the graph shrank with its tag's note over the shelf on the
+ way out of it in `column_sort`): the leaving panes fold to the shelf in
+ place first, then the stayers move, a drawing scaling as one inside its
+ box; **an `on` bubble is placed and checked by the renderer** (16 clear of
+ every element and every path the beat's marks take; else `above`), not by
+ the scene; **a bubble about a folded pane points at its tag**; and the
+ instruments' CAPTION check extended to bubbles: a bubble whose reading
+ time is longer than its lead, its beat's steps and an 84 f hold is
+ flagged (the 104-character one left AIR of 4.9 s at 28.9 s), unless the
+ scene marks the rest as held. Then the two scenes motion.md storyboards
+ for it: the ASan pair and the introduction.
+
16. **The carry** ([`carry`](#4-ties)), a scene's knob `carry` (`.off`,
the default; `.arrow`; `.value` for the introduction's one walked load):
2 units in primary, an open chevron, the gutter's right lane, from the
@@ -2511,23 +2569,6 @@ is not checked here. The tokens are under [Token changes](#token-changes).
no touch; nothing for a move between registers; a stub to a folded or
off-window end.
-15. **The column, an experiment** ([column](#column-an-experiment); the trial's
- storyboard in [motion.md](motion.md#a-scene-in-the-column-open-followed-down)),
- built for the trial scene beside its present form, not in place of it:
- the stage as two columns of 880 (panes at 64, text at 976); the `shelf`
- of folded tags at y 48 with each tag's note and its strikes; the beat's
- panes from 84, narrated rows and rip above 888; the clock under the text
- column; the `bubble` (Go 40 on 54, three lines of 40 at most, the newest
- on raised paper, older ones dim, three at most) placed level with what it
- speaks of, older ones gliding out of its way and riding with their rows;
- its stem in the rest only; the placements `beside`, `below`, `above` and
- `on`, a relayout between them; the fold and unfold of panes between beats
- in the order the section gives; the touch in the column down the gutter
- onto the stack's right rule. And a scene API in which the author says, per
- beat, the panes (with rows or `rest`), the bubble's text, its placement,
- its level and its stem, every one optional and defaulted as the section
- says (motion.md has a beat written that way).
-
**What the recordings must hold**, with the tracer's options:
- For the map, as before: `--stack 1024`, `--disasm 69`, `--around 256`;
diff --git a/design/mock/49-column-call-480.png b/design/mock/49-column-call-480.png
index aa6899a..0916509 100644
--- a/design/mock/49-column-call-480.png
+++ b/design/mock/49-column-call-480.png
Binary files differ
diff --git a/design/mock/49-column-call.png b/design/mock/49-column-call.png
index d856574..067f8f2 100644
--- a/design/mock/49-column-call.png
+++ b/design/mock/49-column-call.png
Binary files differ
diff --git a/design/mock/49-column-call.svg b/design/mock/49-column-call.svg
index 7fdb518..af8b8e7 100644
--- a/design/mock/49-column-call.svg
+++ b/design/mock/49-column-call.svg
@@ -300,12 +300,11 @@
<rect x="52.5" y="138.0" width="3.0" height="280.0" fill="#e8c46a"/>
<path d="M944.0,408.0 L950.0,408.0 Q956.0,408.0 956.0,414.0 L956.0,569.5 Q956.0,572.0 953.5,572.0 L951.0,572.0" fill="none" stroke="#ff6a4a" stroke-width="2" stroke-linejoin="round" stroke-linecap="butt"/>
<path d="M946.0,572.0 L953.0,568.0 L953.0,576.0 Z" fill="#ff6a4a"/>
-<text x="1000.0" y="221.0" font-size="40" xml:space="preserve"><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">main </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">puts </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">open's </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">arguments </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">where </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">the </tspan></text>
-<text x="1000.0" y="275.0" font-size="40" xml:space="preserve"><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">convention </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">says: </tspan><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#9aa6d9" font-size="35">"note" </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">in </tspan><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#9aa6d9" font-size="35">rdi</tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">, </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">0 </tspan></text>
-<text x="1000.0" y="329.0" font-size="40" xml:space="preserve"><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">(O_RDONLY) </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">in </tspan><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#9aa6d9" font-size="35">rsi</tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">.</tspan></text>
+<text x="1000.0" y="275.0" font-size="40" xml:space="preserve"><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">main </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">puts </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">open's </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">arguments </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">in </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">registers: </tspan></text>
+<text x="1000.0" y="329.0" font-size="40" xml:space="preserve"><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#9aa6d9" font-size="35">"note" </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">in </tspan><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#9aa6d9" font-size="35">rdi</tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">, </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">O_RDONLY </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">in </tspan><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#9aa6d9" font-size="35">rsi</tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">.</tspan></text>
<rect x="984.0" y="368.0" width="812.0" height="134.0" fill="#16245f"/>
-<text x="1000.0" y="421.0" font-size="40" xml:space="preserve"><tspan font-family="Go" font-weight="normal" fill="#eee6d2">The </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">call </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">pushes </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">where </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">to </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">come </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">back </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">to, </tspan></text>
-<text x="1000.0" y="475.0" font-size="40" xml:space="preserve"><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#eee6d2" font-size="35">main+45</tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">, </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">and </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">goes </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">down </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">to </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">open's </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">stub.</tspan></text>
+<text x="1000.0" y="421.0" font-size="40" xml:space="preserve"><tspan font-family="Go" font-weight="normal" fill="#eee6d2">The </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">call </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">pushes </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">the </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">way </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">back, </tspan><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#eee6d2" font-size="35">main+45</tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">, </tspan></text>
+<text x="1000.0" y="475.0" font-size="40" xml:space="preserve"><tspan font-family="Go" font-weight="normal" fill="#eee6d2">and </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">goes </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">down </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">to </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">the </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">stub.</tspan></text>
<rect x="976.0" y="899.0" width="880.0" height="2.0" fill="#3a4a8a"/>
<rect x="976.0" y="898.0" width="133.9" height="4.0" fill="#e8c46a"/>
<text x="1688.0 1700.0 1712.0 1724.0 1736.0 1748.0 1760.0 1772.0 1784.0 1796.0 1808.0 1820.0 1832.0 1844.0" y="934.0" font-family="JetBrains Mono NL" font-size="20" fill="#6a7ab8" xml:space="preserve" font-weight="500">moment 7 of 46</text>
diff --git a/design/mock/50-column-stub-480.png b/design/mock/50-column-stub-480.png
index e5e4657..360c41a 100644
--- a/design/mock/50-column-stub-480.png
+++ b/design/mock/50-column-stub-480.png
Binary files differ
diff --git a/design/mock/50-column-stub.png b/design/mock/50-column-stub.png
index 60c3187..d873481 100644
--- a/design/mock/50-column-stub.png
+++ b/design/mock/50-column-stub.png
Binary files differ
diff --git a/design/mock/50-column-stub.svg b/design/mock/50-column-stub.svg
index 886dd88..8e2058f 100644
--- a/design/mock/50-column-stub.svg
+++ b/design/mock/50-column-stub.svg
@@ -302,12 +302,11 @@
<rect x="53.0" y="302.0" width="9.0" height="2.0" fill="#eee6d2"/>
<rect x="53.0" y="392.0" width="9.0" height="2.0" fill="#eee6d2"/>
<rect x="53.0" y="138.0" width="2.0" height="256.0" fill="#eee6d2"/>
-<text x="1000.0" y="323.0" font-size="40" xml:space="preserve"><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">The </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">call </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">pushes </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">where </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">to </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">come </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">back </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">to, </tspan></text>
-<text x="1000.0" y="377.0" font-size="40" xml:space="preserve"><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#9aa6d9" font-size="35">main+45</tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">, </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">and </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">goes </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">down </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">to </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">open's </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">stub.</tspan></text>
-<rect x="984.0" y="416.0" width="812.0" height="188.0" fill="#16245f"/>
-<text x="1000.0" y="469.0" font-size="40" xml:space="preserve"><tspan font-family="Go" font-weight="normal" fill="#eee6d2">The </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">stub </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">in </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">the </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">PLT </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">is </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">one </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">jump: </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">it </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">reads </tspan></text>
-<text x="1000.0" y="523.0" font-size="40" xml:space="preserve"><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#eee6d2" font-size="35">open@got</tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">, </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">where </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">the </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">loader </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">wrote </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">libc's </tspan></text>
-<text x="1000.0" y="577.0" font-size="40" xml:space="preserve"><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#eee6d2" font-size="35">open</tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">. </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">It </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">pushes </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">nothing.</tspan></text>
+<text x="1000.0" y="323.0" font-size="40" xml:space="preserve"><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">The </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">call </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">pushes </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">the </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">way </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">back, </tspan><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#9aa6d9" font-size="35">main+45</tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">, </tspan></text>
+<text x="1000.0" y="377.0" font-size="40" xml:space="preserve"><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">and </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">goes </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">down </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">to </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">the </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">stub.</tspan></text>
+<rect x="984.0" y="416.0" width="812.0" height="134.0" fill="#16245f"/>
+<text x="1000.0" y="469.0" font-size="40" xml:space="preserve"><tspan font-family="Go" font-weight="normal" fill="#eee6d2">The </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">stub </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">is </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">one </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">jump </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">through </tspan><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#eee6d2" font-size="35">open@got</tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">: </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">it </tspan></text>
+<text x="1000.0" y="523.0" font-size="40" xml:space="preserve"><tspan font-family="Go" font-weight="normal" fill="#eee6d2">pushes </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">nothing.</tspan></text>
<path d="M984.0,456.0 L950.0,456.0" fill="none" stroke="#9aa6d9" stroke-width="2" stroke-linejoin="round" stroke-linecap="butt"/>
<path d="M945.0,456.0 L952.0,452.0 L952.0,460.0 Z" fill="#9aa6d9"/>
<rect x="976.0" y="899.0" width="880.0" height="2.0" fill="#3a4a8a"/>
diff --git a/design/mock/51-column-args-480.png b/design/mock/51-column-args-480.png
index 193a0e7..7207706 100644
--- a/design/mock/51-column-args-480.png
+++ b/design/mock/51-column-args-480.png
Binary files differ
diff --git a/design/mock/51-column-args.png b/design/mock/51-column-args.png
index cc51162..dc5e7a2 100644
--- a/design/mock/51-column-args.png
+++ b/design/mock/51-column-args.png
Binary files differ
diff --git a/design/mock/51-column-args.svg b/design/mock/51-column-args.svg
index 276d047..6aaf57d 100644
--- a/design/mock/51-column-args.svg
+++ b/design/mock/51-column-args.svg
@@ -231,13 +231,11 @@
<rect x="53.0" y="230.0" width="9.0" height="2.0" fill="#eee6d2"/>
<rect x="53.0" y="248.0" width="9.0" height="2.0" fill="#eee6d2"/>
<rect x="53.0" y="138.0" width="2.0" height="112.0" fill="#eee6d2"/>
-<text x="1000.0" y="197.0" font-size="40" xml:space="preserve"><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">The </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">stub </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">in </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">the </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">PLT </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">is </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">one </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">jump. </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">It </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">reads </tspan></text>
-<text x="1000.0" y="251.0" font-size="40" xml:space="preserve"><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#9aa6d9" font-size="35">open@got</tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">, </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">where </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">the </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">loader </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">wrote </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">libc's </tspan></text>
-<text x="1000.0" y="305.0" font-size="40" xml:space="preserve"><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#9aa6d9" font-size="35">open</tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">.</tspan></text>
-<rect x="984.0" y="344.0" width="812.0" height="188.0" fill="#16245f"/>
-<text x="1000.0" y="397.0" font-size="40" xml:space="preserve"><tspan font-family="Go" font-weight="normal" fill="#eee6d2">Its </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">last </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">three </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">set </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">the </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">kernel's </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">arguments: </tspan></text>
-<text x="1000.0" y="451.0" font-size="40" xml:space="preserve"><tspan font-family="Go" font-weight="normal" fill="#eee6d2">AT_FDCWD </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">in </tspan><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#eee6d2" font-size="35">rdi</tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">, </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">and </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">257, </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">openat's </tspan></text>
-<text x="1000.0" y="505.0" font-size="40" xml:space="preserve"><tspan font-family="Go" font-weight="normal" fill="#eee6d2">number, </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">in </tspan><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#eee6d2" font-size="35">rax</tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">.</tspan></text>
+<text x="1000.0" y="251.0" font-size="40" xml:space="preserve"><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">The </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">stub </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">is </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">one </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">jump </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">through </tspan><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#9aa6d9" font-size="35">open@got</tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">: </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">it </tspan></text>
+<text x="1000.0" y="305.0" font-size="40" xml:space="preserve"><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">pushes </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">nothing.</tspan></text>
+<rect x="984.0" y="344.0" width="812.0" height="134.0" fill="#16245f"/>
+<text x="1000.0" y="397.0" font-size="40" xml:space="preserve"><tspan font-family="Go" font-weight="normal" fill="#eee6d2">Its </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">last </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">three </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">set </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">the </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">kernel's </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">arguments, </tspan></text>
+<text x="1000.0" y="451.0" font-size="40" xml:space="preserve"><tspan font-family="Go" font-weight="normal" fill="#eee6d2">and </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">openat's </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">number, </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">257, </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">in </tspan><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#eee6d2" font-size="35">rax</tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">.</tspan></text>
<rect x="976.0" y="899.0" width="880.0" height="2.0" fill="#3a4a8a"/>
<rect x="976.0" y="898.0" width="593.0" height="4.0" fill="#e8c46a"/>
<text x="1676.0 1688.0 1700.0 1712.0 1724.0 1736.0 1748.0 1760.0 1772.0 1784.0 1796.0 1808.0 1820.0 1832.0 1844.0" y="934.0" font-family="JetBrains Mono NL" font-size="20" fill="#6a7ab8" xml:space="preserve" font-weight="500">moment 31 of 46</text>
diff --git a/design/mock/52-column-cross-480.png b/design/mock/52-column-cross-480.png
index ef5f705..7dc0380 100644
--- a/design/mock/52-column-cross-480.png
+++ b/design/mock/52-column-cross-480.png
Binary files differ
diff --git a/design/mock/52-column-cross.png b/design/mock/52-column-cross.png
index c79b82b..eebe049 100644
--- a/design/mock/52-column-cross.png
+++ b/design/mock/52-column-cross.png
Binary files differ
diff --git a/design/mock/52-column-cross.svg b/design/mock/52-column-cross.svg
index cd9cef3..6e0a753 100644
--- a/design/mock/52-column-cross.svg
+++ b/design/mock/52-column-cross.svg
@@ -201,13 +201,11 @@
<rect x="53.0" y="302.0" width="9.0" height="2.0" fill="#eee6d2"/>
<rect x="53.0" y="320.0" width="9.0" height="2.0" fill="#eee6d2"/>
<rect x="53.0" y="138.0" width="2.0" height="184.0" fill="#eee6d2"/>
-<text x="1000.0" y="541.0" font-size="40" xml:space="preserve"><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">Its </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">last </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">three </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">set </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">the </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">kernel's </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">arguments: </tspan></text>
-<text x="1000.0" y="595.0" font-size="40" xml:space="preserve"><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">AT_FDCWD </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">in </tspan><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#9aa6d9" font-size="35">rdi</tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">, </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">and </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">257, </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">openat's </tspan></text>
-<text x="1000.0" y="649.0" font-size="40" xml:space="preserve"><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">number, </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">in </tspan><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#9aa6d9" font-size="35">rax</tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">.</tspan></text>
-<rect x="984.0" y="700.0" width="812.0" height="188.0" fill="#16245f"/>
-<text x="1000.0" y="753.0" font-size="40" xml:space="preserve"><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#eee6d2" font-size="35">syscall </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">crosses </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">down. </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">The </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">kernel </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">opens </tspan></text>
-<text x="1000.0" y="807.0" font-size="40" xml:space="preserve"><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#eee6d2" font-size="35">"note" </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">and </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">answers </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">3: </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">the </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">file's </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">descriptor, </tspan></text>
-<text x="1000.0" y="861.0" font-size="40" xml:space="preserve"><tspan font-family="Go" font-weight="normal" fill="#eee6d2">in </tspan><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#eee6d2" font-size="35">rax</tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">.</tspan></text>
+<text x="1000.0" y="541.0" font-size="40" xml:space="preserve"><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">Its </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">last </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">three </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">set </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">the </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">kernel's </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">arguments, </tspan></text>
+<text x="1000.0" y="595.0" font-size="40" xml:space="preserve"><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">and </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">openat's </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">number, </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">257, </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">in </tspan><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#9aa6d9" font-size="35">rax</tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">.</tspan></text>
+<rect x="984.0" y="704.0" width="812.0" height="134.0" fill="#16245f"/>
+<text x="1000.0" y="757.0" font-size="40" xml:space="preserve"><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#eee6d2" font-size="35">syscall </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">crosses </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">down; </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">the </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">kernel </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">opens </tspan></text>
+<text x="1000.0" y="811.0" font-size="40" xml:space="preserve"><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#eee6d2" font-size="35">"note" </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">and </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">answers </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">3 </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">in </tspan><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#eee6d2" font-size="35">rax</tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">.</tspan></text>
<rect x="976.0" y="899.0" width="880.0" height="2.0" fill="#3a4a8a"/>
<rect x="976.0" y="898.0" width="669.6" height="4.0" fill="#e8c46a"/>
<text x="1676.0 1688.0 1700.0 1712.0 1724.0 1736.0 1748.0 1760.0 1772.0 1784.0 1796.0 1808.0 1820.0 1832.0 1844.0" y="934.0" font-family="JetBrains Mono NL" font-size="20" fill="#6a7ab8" xml:space="preserve" font-weight="500">moment 35 of 46</text>
diff --git a/design/mock/53-column-back-480.png b/design/mock/53-column-back-480.png
index 294b7cd..4ca4faa 100644
--- a/design/mock/53-column-back-480.png
+++ b/design/mock/53-column-back-480.png
Binary files differ
diff --git a/design/mock/53-column-back.png b/design/mock/53-column-back.png
index aae5ff1..ffc3719 100644
--- a/design/mock/53-column-back.png
+++ b/design/mock/53-column-back.png
Binary files differ
diff --git a/design/mock/53-column-back.svg b/design/mock/53-column-back.svg
index 7292e57..3759984 100644
--- a/design/mock/53-column-back.svg
+++ b/design/mock/53-column-back.svg
@@ -289,9 +289,8 @@
<rect x="52.5" y="138.0" width="3.0" height="280.0" fill="#e8c46a"/>
<path d="M944.0,408.0 L950.0,408.0 Q956.0,408.0 956.0,414.0 L956.0,665.5 Q956.0,668.0 953.5,668.0 L951.0,668.0" fill="none" stroke="#ff6a4a" stroke-width="2" stroke-linejoin="round" stroke-linecap="butt"/>
<path d="M946.0,668.0 L953.0,664.0 L953.0,672.0 Z" fill="#ff6a4a"/>
-<text x="1000.0" y="753.0" font-size="40" xml:space="preserve"><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#9aa6d9" font-size="35">syscall </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">crosses </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">down. </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">The </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">kernel </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">opens </tspan></text>
-<text x="1000.0" y="807.0" font-size="40" xml:space="preserve"><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#9aa6d9" font-size="35">"note" </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">and </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">answers </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">3: </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">the </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">file's </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">descriptor, </tspan></text>
-<text x="1000.0" y="861.0" font-size="40" xml:space="preserve"><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">in </tspan><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#9aa6d9" font-size="35">rax</tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">.</tspan></text>
+<text x="1000.0" y="807.0" font-size="40" xml:space="preserve"><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#9aa6d9" font-size="35">syscall </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">crosses </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">down; </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">the </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">kernel </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">opens </tspan></text>
+<text x="1000.0" y="861.0" font-size="40" xml:space="preserve"><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#9aa6d9" font-size="35">"note" </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">and </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">answers </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">3 </tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">in </tspan><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#9aa6d9" font-size="35">rax</tspan><tspan font-family="Go" font-weight="normal" fill="#9aa6d9">.</tspan></text>
<rect x="984.0" y="344.0" width="812.0" height="188.0" fill="#16245f"/>
<text x="1000.0" y="397.0" font-size="40" xml:space="preserve"><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#eee6d2" font-size="35">open</tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">'s </tspan><tspan font-family="JetBrains Mono NL" font-weight="normal" fill="#eee6d2" font-size="35">ret </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">comes </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">straight </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">back </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">to </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">main: </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">the </tspan></text>
<text x="1000.0" y="451.0" font-size="40" xml:space="preserve"><tspan font-family="Go" font-weight="normal" fill="#eee6d2">stub </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">was </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">a </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">jump, </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">not </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">a </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">call. </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">main </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">keeps </tspan><tspan font-family="Go" font-weight="normal" fill="#eee6d2">the </tspan></text>
diff --git a/design/mock/54-column-present.png b/design/mock/54-column-present.png
index e9421e9..91a6f6e 100644
--- a/design/mock/54-column-present.png
+++ b/design/mock/54-column-present.png
Binary files differ
diff --git a/design/mock/column.py b/design/mock/column.py
index de00e6f..cf0b8d1 100644
--- a/design/mock/column.py
+++ b/design/mock/column.py
@@ -361,11 +361,10 @@ def beat_call(g):
# the touch, in the column: out of the call row's right rule, down the gutter, onto the stack's rule at its word
gen.arrow(g, [(944, at[0x4011a8] + 12), (956, at[0x4011a8] + 12), (956, sy[0] + 12), (946, sy[0] + 12)], VERM, 2,
r=6, hl=7, hw=8)
- say(g, [(at[0x40119c] + 12, [("main puts open's arguments where the convention says: ", "sans"), ('"note"', "mono"),
- (" in ", "sans"), ("rdi", "mono"), (", 0 (O_RDONLY) in ", "sans"), ("rsi", "mono"),
- (".", "sans")], None),
- (at[0x4011a8] + 12, [("The call pushes where to come back to, ", "sans"), ("main+45", "mono"),
- (", and goes down to open's stub.", "sans")], None)])
+ say(g, [(at[0x40119c] + 12, [("main puts open's arguments in registers: ", "sans"), ('"note"', "mono"), (" in ", "sans"),
+ ("rdi", "mono"), (", O_RDONLY in ", "sans"), ("rsi", "mono"), (".", "sans")], None),
+ (at[0x4011a8] + 12, [("The call pushes the way back, ", "sans"), ("main+45", "mono"),
+ (", and goes down to the stub.", "sans")], None)])
column_clock(g, 7, 46)
@@ -406,11 +405,10 @@ def beat_stub(g):
stack_panel(g, ys_, n, 38, 0x7fffffffeca8, 0x7fffffffeca8, 0x7fffffffed00, {0x7fffffffeca8: {1: "tick"}},
[("open@plt", 0x7fffffffeca8)], base=("rsp", 0x7fffffffeca8))
C.thread(g, ys, [(at[0x40119c], at[0x4011a8] + ROW)], VELLUM, 2)
- say(g, [(at[0x4011a8] + 12, [("The call pushes where to come back to, ", "sans"), ("main+45", "mono"),
- (", and goes down to open's stub.", "sans")], None),
- (at[0x401070] + 12, [("The stub in the PLT is one jump: it reads ", "sans"), ("open@got", "mono"),
- (", where the loader wrote libc's ", "sans"), ("open", "mono"),
- (". It pushes nothing.", "sans")], at[0x401070])])
+ say(g, [(at[0x4011a8] + 12, [("The call pushes the way back, ", "sans"), ("main+45", "mono"),
+ (", and goes down to the stub.", "sans")], None),
+ (at[0x401070] + 12, [("The stub is one jump through ", "sans"), ("open@got", "mono"),
+ (": it pushes nothing.", "sans")], at[0x401070])])
column_clock(g, 8, 46)
@@ -443,10 +441,10 @@ def beat_args(g):
"rsi": {0: "tick"}}, QUIET)
M.strip(False)
C.thread(g, ys, [(at[0x4011a8], at[0x4011a8] + ROW)], VELLUM, 2)
- say(g, [(at["open@plt"] + 12, [("The stub in the PLT is one jump. It reads ", "sans"), ("open@got", "mono"),
- (", where the loader wrote libc's ", "sans"), ("open", "mono"), (".", "sans")], None),
- (at[L + 0x110fb6] + 12, [("Its last three set the kernel's arguments: AT_FDCWD in ", "sans"), ("rdi", "mono"),
- (", and 257, openat's number, in ", "sans"), ("rax", "mono"), (".", "sans")], None)])
+ say(g, [(at["open@plt"] + 12, [("The stub is one jump through ", "sans"), ("open@got", "mono"),
+ (": it pushes nothing.", "sans")], None),
+ (at[L + 0x110fb6] + 12, [("Its last three set the kernel's arguments, and openat's number, 257, in ", "sans"),
+ ("rax", "mono"), (".", "sans")], None)])
column_clock(g, 31, 46)
@@ -482,12 +480,10 @@ def beat_cross(g, bubbles=True):
M.strip(False)
C.thread(g, ys, [(at[0x4011a8], at[0x4011a8] + ROW)], VELLUM, 2)
if bubbles:
- say(g, [(at[L + 0x110fb6] + 12, [("Its last three set the kernel's arguments: AT_FDCWD in ", "sans"),
- ("rdi", "mono"), (", and 257, openat's number, in ", "sans"), ("rax", "mono"),
- (".", "sans")], None),
- (at["kernel"] + 12, [("syscall", "mono"), (" crosses down. The kernel opens ", "sans"), ('"note"', "mono"),
- (" and answers 3: the file's descriptor, in ", "sans"), ("rax", "mono"),
- (".", "sans")], None)])
+ say(g, [(at[L + 0x110fb6] + 12, [("Its last three set the kernel's arguments, and openat's number, 257, in ", "sans"),
+ ("rax", "mono"), (".", "sans")], None),
+ (at["kernel"] + 12, [("syscall", "mono"), (" crosses down; the kernel opens ", "sans"), ('"note"', "mono"),
+ (" and answers 3 in ", "sans"), ("rax", "mono"), (".", "sans")], None)])
column_clock(g, 35, 46)
return at
@@ -514,9 +510,8 @@ def beat_back(g):
C.thread(g, ys, [(at[0x40119c], at[0x4011ad] + ROW)])
gen.arrow(g, [(944, at[0x4011ad] + 12), (956, at[0x4011ad] + 12), (956, sy[3] + 12), (946, sy[3] + 12)], VERM, 2,
r=6, hl=7, hw=8)
- say(g, [(at[0x4011ad] + 12 + 400, [("syscall", "mono"), (" crosses down. The kernel opens ", "sans"), ('"note"', "mono"),
- (" and answers 3: the file's descriptor, in ", "sans"), ("rax", "mono"),
- (".", "sans")], None),
+ say(g, [(at[0x4011ad] + 12 + 400, [("syscall", "mono"), (" crosses down; the kernel opens ", "sans"), ('"note"', "mono"),
+ (" and answers 3 in ", "sans"), ("rax", "mono"), (".", "sans")], None),
(at[0x4011a8] + 12, [("open", "mono"), ("'s ", "sans"), ("ret", "mono"),
(" comes straight back to main: the stub was a jump, not a call. main keeps the answer in ",
"sans"), ("f", "mono"), (".", "sans")], None)])
diff --git a/design/motion.md b/design/motion.md
index 461f2a8..d026ffe 100644
--- a/design/motion.md
+++ b/design/motion.md
@@ -1325,8 +1325,10 @@ loop overwrites them and runs on to the end of the stack, faulting at a
store. This scene's program has a constant bound and is built with clang,
which puts `i` below `buf` (rbp-0x14): the overflow reaches the saved rbp
and the return address and the fault is the classic one, at `ret`. The
-target should become [`mock/overflow.c`](mock/overflow.c) with those
-flags. The ASan build is shown as a user meets it, with the fake stack
+scene's program is [`mock/overflow.c`](mock/overflow.c), built in `anim/`
+with clang `-O0 -g -fno-omit-frame-pointer -no-pie -fno-stack-protector`
+(and `-fsanitize=address` for its second run); the tracer's own
+`targets/overflow.c` stays as it is. The ASan build is shown as a user meets it, with the fake stack
(the default); with `detect_stack_use_after_return=0` the frame would be
on the real stack between the same redzones, a simpler picture and a
second scene.
@@ -1382,43 +1384,65 @@ second scene.
to the report's call, then about 4.75 million to write the report and
exit.
-**The beats**, with the captions on the rules (frames from the scene's
-first; a caption lands, leads its step by at least 60 f, 120 for the
-first, and leaves only in a rest; every one up its reading time and at
-most 642 f). Each step is a source line in both builds, or one turn of the
-loop; inside it each side walks its own rows (README, `pair`).
+**The beats**, each in the form that serves it: the [`pair`](README.md#pair)
+while the two runs face each other, its text `below`; the
+[column](README.md#column) while plain goes on alone, its frame as bytes the
+height of the column and each bubble level with the field the turn's letter
+lands in, so that the narration climbs the frame with the overflow; the pair
+again for the poster and the end, a fault on the left and a report on the
+right. Frames from the scene's first; every text lands in a rest, leads its
+step by 60 f (120 for the first), is up its reading time (90 f + 3.6 f a
+character) and at most 720 f, and is covered by its lead, its steps and a
+hold of at most 84 f, but for the poster's rest, which is meant.
-| Lands | Leaves | Caption | The step, firing at | What plays |
-| --- | --- | --- | --- | --- |
-| 78 | 452 | Plain against AddressSanitizer: one loop writes 32 bytes into a 16-byte buffer. | `fill()` called in both, 198 | the call, as any; `establish` before it |
-| 470 | 884 | ASan's prologue moves buf to a fake frame and poisons its shadow: f1 before buf, f3 after. | line 2, the prologues, 530 | plain: two rows walked. ASan: its 38 rows at a run inside the step, `__asan_stack_malloc_0` stepped over; the fake frame's rows come in (12 f), the header's words struck; the shadow's cells struck 2 f apart, `f1 f1 f1 f1 f8 f8 f3 f3` |
-| 902 | 1255 | Line 3 is ASan's alone: buf's scope begins, its shadow f8 f8 turns 00 00. | line 3, 962 | ASan's one row, `only here`; plain holds; the two cells struck |
-| 1273 | 1651 | Before each store ASan reads buf[i]'s byte of shadow, at (addr >> 3) + 7fff8000. | i = 0, the check, 1333 | ASan's address and check rows walked, 36 f a row, the shadow cell framed as read when its load runs; plain's plaque waits on the row facing them |
-| 1669 | 2076 | It is 00: the store may go. Both write 'A'; plain in one instruction, ASan in seventeen. | i = 0, the stores, 1729 | both stores strike together (6 f apart, plain first), each side's `i++` |
-| 2094 | 2736 | Fourteen more turns, at a run: buf fills on both sides. | i = 1 to 14, a run, 2154 | a run: no strikes, no corners; buf's bytes change in place; settled at the end |
-| 2754 | 3118 | i = 15, the last byte of buf. Still 00 on ASan's side; still buf on plain's. | i = 15, walked, 2814 | both walked; the last 00 read; each `buf` reads `"AAAAAAAAAAAAAAAA"` across its two rows (mock 26 is the instant before the store) |
-| 3136 | 3528 | i = 16, one past buf. Plain writes 41, an 'A', into the saved rbp; ASan reads f3, a redzone. | i = 16, they part, 3196 | the chart below (mock 28) |
-| 3546 | 3967 | ASan's branch to the store is not taken: it calls the report, which names buf and the write. | the report, 3606 | ASan's partial check and its call walked; its run stops: its registers give way to its stderr, the report's lines, the three the caption names framed |
-| 3985 | 4320 | Plain goes on alone, a byte a turn: the A's fill the saved rbp. | i = 17 to 23, a run, 4045 | plain alone at a run, 18 f a turn: each turn's byte changes in place (8 f), a letter crossing the saved rbp's bytes one by one, its reading changing with them; settled at `0x4141414141414141`, `differs` on the row; ASan's side holds its last picture |
-| 4338 | 4706 | i = 24: the first A reaches the return address. It reads fill+1: still code. | i = 24, walked, 4398 | the return address's eight stores are the plain side's climax, each walked as its own step (the chart below), never at a run: the first struck, `34` to `41`; the reading `→ 401134 main+20` crossfades to `→ 401141 fill+1`, still code's ink |
-| 4724 | 5042 | Each turn makes it stranger: 404141 is data, 414141 is nowhere. | i = 25 and 26, walked, 4784 and 4880 | `→ 404141` in data's ink, no name; then `0x414141`: the arrow and the ink gone, a number |
-| 5060 | 5506 | Half written: 41414141, no longer an address. On the right, ASan stopped at the first byte past buf. | i = 27, walked, 5120 | its store struck, the reading `0x41414141`; then the step's hold runs on to the caption's end (5216 to 5506, 4.8 s): the half-written word held, the struck byte solid, the plaque on the store, ASan's side standing stopped on its report. The scene's poster, mock 38 |
-| 5524 | 6016 | Four more turns: the last A lands, and it reads 4141414141414141. | i = 28 to 31, walked, 5584 | four steps of 96 f, to 5968: `0x4141414141`, `0x414141414141`, `0x41414141414141`, `0x4141414141414141` |
-| 6034 | 6424 | The loop ends; pop rbp, then ret to 4141414141414141: the CPU faults. SIGSEGV. | the loop's exit, `pop`, `ret`, 6094 | walked: rbp struck; `ret` faults: the `fault` mark on its row, hazard bands round an ink plaque, `SIGSEGV`; rip stays |
+*The pair's panes* (mock 26), the same in every pair beat: the shared source,
+6 lines, each run's mark on its side; each run's disassembly, 10 rows,
+aligned by line; each run's frame as bytes (`hexdump` `eight`), eight a row,
+read by its fields (plain: `i`, `buf`, the saved rbp, the return address;
+ASan: the fake frame's header, `buf`, its redzone, each row's shadow byte
+beside it); each run's registers folded to the rows the loop moves.
+*The column's panes* (A10 to A13): plain's source, 3 lines (3 to 5); plain's
+disassembly, 10 rows, the loop's turn; plain's frame as bytes, `rest` (13
+rows: `i`'s word, `buf`'s two, the saved rbp, the return address, then
+main's frame, which only the floor holds). On the shelf: `ASan · stopped:
+stack-buffer-overflow, WRITE of size 1` (its report's first line on the tag)
+and plain's registers (`rax` the turn's `i`).
+
+| | Form · text | Level (column) | The step, and what plays | Text (characters) | Lands | Fires | Leaves |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| A1 | pair · below | | `fill()` called in both, as any call; `establish` before it | Plain against AddressSanitizer: a loop writes 32 bytes into 16. (63) | 78 | 198 | 395 |
+| A2 | pair · below | | line 2, the prologues: plain's two rows walked; ASan's 38 at a run inside the step, `__asan_stack_malloc_0` stepped over; the fake frame's rows come in (12 f), the header's words struck; the shadow's cells struck 2 f apart, `f1 f1 f1 f1 f8 f8 f3 f3` | ASan's prologue moves buf to a fake frame and poisons its shadow: f1 before buf, f3 after. (90) | 413 | 473 | 827 |
+| A3 | pair · below | | line 3: ASan's one row, `only here`; plain holds; the two cells struck | Line 3 is ASan's alone: buf's shadow f8 f8 turns 00 00. (55) | 845 | 905 | 1133 |
+| A4 | pair · below | | i = 0, the check: ASan's address and check rows walked, 36 f a row, the shadow cell framed as read when its load runs; plain's plaque waits on the row facing them | Before each store ASan reads buf[i]'s shadow byte, at (addr >> 3) + 7fff8000. (77) | 1151 | 1211 | 1518 |
+| A5 | pair · below | | i = 0, the stores: ASan's rows after the check walked, then both stores strike (6 f apart, plain first), each side's `i++` | It is 00: the store may go. Both write 'A'; plain in one instruction, ASan in seventeen. (88) | 1536 | 1596 | 1943 |
+| A6 | pair · below | | i = 1 to 14, a run: no strikes, no corners; `buf`'s bytes change in place; settled at the end | Fourteen more turns, at a run: buf fills on both sides. (55) | 1961 | 2021 | 2387 |
+| A7 | pair · below | | i = 15, walked on both sides; the last `00` read; each `buf` reads `"AAAAAAAAAAAAAAAA"` across its two rows | i = 15, buf's last byte: still 00 on ASan's side, still buf on plain's. (71) | 2405 | 2465 | 2750 |
+| A8 | pair · below | | i = 16, they part: the chart below (mock 28) | i = 16, one past buf: plain writes an A into the saved rbp; ASan reads f3, a redzone. (85) | 2768 | 2828 | 3164 |
+| A9 | pair · below | | ASan's partial check and its call walked; its run stops: its registers give way to its stderr, the report's lines, the three the text names framed | ASan does not store: it calls its report, which names buf and the write. (72) | 3182 | 3242 | 3532 |
+| | | | 3550 to 3646, into the column (README, column, "Mixing them"): the text leaves; ASan's side folds to one tag on the shelf, its report's first line on it; plain's panes glide left and its frame's bytes open to the column's height | | | | |
+| A10 | column · beside | the saved rbp's row | i = 17 to 20, each walked as a store (the chart below, 96 f): a letter a turn crossing the saved rbp's bytes, its reading changing with them | Plain goes on alone, an A a turn, into the saved rbp. (53) | 3646 | 3706 | 4126 |
+| A11 | column · beside | the saved rbp's row (A10's glides up) | i = 21 to 23, walked: the saved rbp all letters, `0x4141414141414141`, `differs` gone with ASan folded | The saved rbp fills: 4141414141414141, no longer an address. (60) | 4144 | 4204 | 4528 |
+| A12 | column · beside | the return address's row, a row lower | i = 24, walked: the first struck, `34` to `41`; the reading `→ 401134 main+20` crossfades to `→ 401141 fill+1`, still code's ink | i = 24, the return address: it reads fill+1, still code. (56) | 4546 | 4606 | 4837 |
+| A13 | column · beside | the return address's row | i = 25 and 26, walked: `→ 404141` in data's ink, no name; then `0x414141`, the arrow and the ink gone, a number | Each turn makes it stranger: 404141 is data, 414141 is nowhere. (63) | 4855 | 4915 | 5172 |
+| | | | 5190 to 5286, back to the pair: the bubbles leave together; plain's panes glide back to their side; ASan's side unfolds from the shelf, stopped on its report, as it was | | | | |
+| A14 | pair · below | | i = 27, walked: its store struck, the reading `0x41414141`; then the held rest, 5442 to 5736 (4.9 s): the half-written word, the struck byte solid, the plaque on the store, ASan standing on its report. The scene's poster, mock 38 | Half written: 41414141, no longer an address. On the right, ASan stopped at the first byte past buf. (100) | 5286 | 5346 | 5736 |
+| A15 | pair · below | | i = 28 to 31, walked, 96 f each: `0x4141414141` to `0x4141414141414141` | Four more turns: the last A lands, and it reads 4141414141414141. (65) | 5754 | 5814 | 6234 |
+| A16 | pair · below | | the loop's exit, `pop rbp` (rsp's pin falls, rbp's flies to `4141414141414141`, off every window: a stub), `ret` (the touch to the return address, read; the fault: the `fault` mark on its row, hazard bands round an ink plaque, `SIGSEGV`; rip stays) | The loop ends: pop rbp, then ret to 4141414141414141: the CPU faults. SIGSEGV. (78) | 6252 | 6312 | 6623 |
-The cut at 6544, 109.1 s, after 2 s on the two last pictures: a fault on
+The cut at 6743, 112.4 s, after 2 s on the two last pictures: a fault on
the left, a report on the right. The scene's poster (the thumbnail, the
still that stands for it) is mock 38: the return address half written,
-the report beside it.
+the report beside it. The two changes of form cost 192 f, 3.2 s; the walked
+stores past `buf` (sixteen, A8 and A10 to A15) are the scene's middle, 30 s.
-**A store into the return address**, walked (i = 24 to 31), from its fire:
+**A store past `buf`**, walked, each of i = 17 to 31 (into the saved rbp, then the return address), from its fire:
| Frames | |
| --- | --- |
| 0 to 12 | fire on line 4; plain's turn walks its rows 6 f apart to the store |
-| 12 to 24, 24 | arm, strike the store's one byte, `41`, in a string's ink among the return address's code-ink bytes |
+| 12 to 24, 24 | arm, strike the store's one byte, `41`, in a string's ink among the field's pointer-ink bytes; in the column the touch first (12 to 24, down the gutter onto the frame's right rule) and the arm and strike after it (24 to 36, 36), every row below 6 f later; in the pair the touch is its echo, the seam between the runs keeping no line |
| 30 to 42 | the field's reading crossfades to what the bytes now make: an address in its region's ink and its name; or, once it is none, the number, the arrow and the name fading with the old reading |
-| 42 to 78 | hold, the struck byte solid (at i = 27 the hold runs on under its own caption, 290 f) |
+| 42 to 78 | hold, the struck byte solid (at i = 27 the hold runs on under its own text, 294 f) |
| 78 to 90 | advance: the strike cools to its held corner, the plaque goes on through `i++` |
| 90 to 96 | rest: 1.6 s a store |
@@ -1460,7 +1484,7 @@ The frame built from its bytes up, on the recording mocks 9 to 21 use
(`targets/list`, stopped at the load in `reverse`). Three short scenes,
not one: each is a chapter with its own opening and its own last picture,
which the next opens from, so a viewer can stop between them; together
-124 s. Each view grows out of the rawer thing under it, in the order the
+123 s. Each view grows out of the rawer thing under it, in the order the
direction rule gives: memory first (the deepest), then the stack that is
made of it, then the code that acts on it, and the idea last, at the top.
Nothing cuts to a finished panel: the same bytes become the word, the
@@ -1471,61 +1495,82 @@ finished frame, never centred and moved later: the bytes where the stack
will stand (the state column), the address space in the program column,
which is empty until the code comes. The camera frames the part being
built (x2 for the bytes and the words, x1 for the address space beside
-them, x1.25 for the stack and registers), so the frame's empty parts are
+them and for the stack and registers, whose text stands in the program
+column while it is empty), so the frame's empty parts are
out of shot until the parts that fill them come. An introduction earns
that emptiness; nothing else does. A panel's tag and rule come last
(`frame up`): first the rows, then what they are called.
-**I. Memory** (63.8 s)
+**Forms.** Each part is built in the place it keeps, so the forms follow the
+parts: the working frame with its text `below` while the bytes stand in the
+state column under the camera; the [column](README.md#column) for the
+address space, a tall subject (the bar is the column's height, to scale), its
+bubbles level with each end as it is enlarged, so the chapter goes down the
+address space with them, while the bytes wait on the shelf; the working
+frame again to tie the bytes to their place; in chapter II the text `beside`
+on the left, in the program column, which is empty until III, level with the
+stack's rows it speaks of; in III `above` the aligned source and code, which
+span both columns and read down, then `below` as the working frame assembles,
+and `on` the map. Every text lands in a rest, leads its step by 60 f (120 for
+a chapter's first), is up its reading time and at most 720 f, and is covered
+by its lead, its steps and a hold of at most 84 f.
-| Lands | Leaves | Caption | Step, at | What plays |
-| --- | --- | --- | --- | --- |
-| 78 | 474 | A running program is bytes in memory. These are 128 of them, at the top of the stack. | 198 | the bytes fade in a row at a time (12 f, 2 f apart), no ink, the addresses faint; the camera at x2 (mock 29) |
-| 492 | 986 | Eight bytes make a word, stored low byte first: the byte at the lowest address is the word's last two digits. | 552 | `regroup`: sixteen a row to eight, the return address walked, the other fifteen at a run, 552 to 938 ([chart](#a-word-read), mock 37) |
-| 1004 | 1360 | Some words are addresses: numbers that name a place in this same memory. | 1064 | one word framed as read, `10018b0` |
-| 1378 | 1840 | The places are its mappings, drawn to scale: 128 TiB, and all that is mapped is a hairline at each end. | 1438 | the camera out to x1 (72 f, `glide`); `segments`' whole builds in the program column, 1510 to 1552 |
-| 1858 | 2334 | Enlarged, each end has names: the stack and the libraries at the top, the program and its heap at the foot. | 1918 | `enlarge`, the stack's box, the libraries' at 1996, the program's at 2074, their names to about 2210 ([chart](#the-address-space-enlarged)) |
-| 2352 | 2846 | These 128 bytes are here. If the bar were the Eiffel Tower, they would be about an atom thick, at its very top. | 2412 | the dump's place: its bracket, the `link` over the top onto the stack's box, 2412 to 2466 |
-| 2864 | 3308 | A word takes the ink of the mapping it points into: 10018b0 is in list's code, 1001000 to 1002000. | 2924 | `ink` on the return address, walked: its digits, its band and its row framed (an echo), held to 3002; the rest at a run, 2 f apart; the link quiets (mock 30) |
-| 3326 | 3708 | Follow an address and you reach another word: the arrow, and the chain it makes. | 3386 | the words glide to their field's left (24 f, `glide`) to give their chains room; three grow their chains (`extend`), walked |
+**I. Memory** (66.2 s)
-**II. The stack** (27.7 s), opening on I's last picture
+| | Form · text | Panes (rows) · shelf | Level | The step, and what plays | Text (characters) | Lands | Fires | Leaves |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| I1 | working frame · below; the camera at x2 on the state column | the dump of 128 bytes, sixteen a row, eight rows, no ink, the addresses faint (mock 29) | | the bytes fade in a row at a time (18 f, 12 f apart) | A running program is bytes in memory: here, 128 of them at the top of the stack. (80) | 78 | 198 | 456 |
+| I2 | the same | the dump | | `regroup`: sixteen a row to eight, the return address walked, the other fifteen at a run (mock 37, [chart](#a-word-read)) | Eight bytes make a word, stored low byte first: the lowest byte is its last two digits. (87) | 474 | 534 | 956 |
+| I3 | the same | the dump, sixteen words | | three words that hold addresses framed as read, one at a time, 30 f apart | Some words are addresses: they name a place in memory. (54) | 974 | 1034 | 1258 |
+| | | | | 1276 to 1384, into the column: the camera out to x1 (72 f); the dump folds to its tag (`the stack's 128 bytes`) on the shelf; the program column opens to the column's height for `segments` | | | | |
+| I4 | column · beside | `segments` (treatment A, mock 34), the panes' column from 84 to 888: a slim bar the column's height, true scale | the bar's middle | the whole builds, deliberately: the bar grows from the top down (48 f), its two ends' addresses and its size, then the lines of every mapping at its ends (48 f) | Its address space, 128 TiB, to scale: mapped only at each end. (62) | 1384 | 1444 | 1698 |
+| I5 | column · beside | `segments` | the stack's box, at the top | `enlarge`: the stack's box rides out (78 f) and its names come, each band with its start and end addresses and its size; then the libraries' box the same | Enlarged, the top end: the stack, then the libraries, each band with its addresses and size. (92) | 1716 | 1776 | 2137 |
+| I6 | column · beside | `segments` | the program's box, at the foot (the bubble's way down) | `enlarge`: the program's box, by segment (code, read-only data, data, the heap), its names | At the foot, the program: its code, its data, its heap. (55) | 2155 | 2215 | 2443 |
+| | | | | 2461 to 2557, back to the working frame: the bubbles leave; `segments` keeps the program column, its height eased to the stage's (24 f, the drawing scaling as one); the dump unfolds from the shelf in the state column, at x1 | | | | |
+| I7 | working frame · below | `segments` in the program column; the dump in the state column | | the dump's place: the `tie` bracket on its rows (6 f), the `link` over the top onto the stack's box (36 f), the band framed bright as it lands (mock 30) | These 128 bytes are here, at the very top of the stack. (55) | 2557 | 2617 | 2845 |
+| I8 | working frame · below | the same | | a camera `visit` at x4 to the top of the stack's box, where the link lands, and back (72 f each way) | Were the bar the Eiffel Tower, they would be an atom thick, at its top. (71) | 2863 | 2923 | 3208 |
+| I9 | working frame · below | the same | | `ink` on the return address, walked: its digits, its band and its row framed (an echo); the rest at a run, 2 f apart; the link quiets | A word takes the ink of where it points: 10018b0 is list's code. (64) | 3226 | 3286 | 3547 |
+| I10 | working frame · below | the same | | the words glide to their field's left (24 f) to give their chains room; three chains grow (`extend`), walked | Follow an address and you reach another word: a chain. (54) | 3565 | 3625 | 3849 |
-| Lands | Leaves | Caption | Step, at | What plays |
-| --- | --- | --- | --- | --- |
-| 78 | 478 | rsp holds the address of the top of the stack, this word. A push moves it down a word. | 198 | the address space and the dump's link fade (18 f) as the camera goes to x1.25 on the state column; rsp's row arrives above, its pin lands on the top word; from the recording by instruction, the `push rbp` of `reverse`'s prologue replayed: rsp struck, the window sliding a slot |
-| 496 | 791 | A call pushes the address to come back to: here, main+80. | 556 | the word `10018b0 main+80` framed; the offsets (`column`) |
-| 809 | 1198 | A function's words are its frame: the caller's rbp saved, its locals, the way back. | 869 | roles (`column`), the spans, the rbp pin; the stack's tag (`frame up`) |
-| 1216 | 1540 | The registers are the other place values live: seventeen of them. | 1276 | the registers built a row at a time over the stack, top down, then their tag, its legend the inks of I (mock 31) |
+The chapter's last picture, 2 s, to 3969.
-**III. Code and meaning** (32.1 s)
+**II. The stack** (26.5 s), opening on I's last picture
-| Lands | Leaves | Caption | Step, at | What plays |
-| --- | --- | --- | --- | --- |
-| 78 | 378 | Code is bytes too. 48 8b 7f 08 is one instruction. | 198 | the code's bytes as a dump row in code's ink; one instruction's bytes framed |
-| 396 | 796 | Decoded: mov rdi, [rdi + 8]. It came from line 21: each line sits level with its code. | 456 | `decode`, the instruction walked and its neighbours at a run; the source's lines arrive level with their runs: `aligned`, `interleaved` (mock 32) |
-| 814 | 1160 | rdi pointed at a list node on the heap. Its bytes, and drawn, the node. | 874 | `stack`: the aligned columns become the program column; the heap's dump arrives in the band's right half, then the nodes drawn from it (`establish`) |
-| 1178 | 1491 | This is the whole frame. Every view in it is these same bytes. | 1238 | the camera out to x1; each pane's minimap draws itself last, top down: the working frame of mock 9, assembled |
-| 1509 | 1809 | And all of it at once: the map. | 1569 | `surface` |
+| | Form · text | Panes (rows) · shelf | Level | The step, and what plays | Text (characters) | Lands | Fires | Leaves |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| II1 | working frame, text beside on the left (the program column, empty until III) | the address space and the dump's link fade (18 f); the words become the stack panel in the state column, 16 slots, the headroom over rsp | rsp's row | rsp's row arrives over the stack, its pin landing on the top word; `reverse`'s `push rbp` replayed from the recording by instruction: the touch, the word, rsp's pin climbing onto it (README, stack) | rsp holds the address of the top of the stack. A push moves it down a word. (75) | 78 | 198 | 438 |
+| II2 | the same | the stack | the return address's row | the word `10018b0 main+80` framed; the offsets arrive (`column`), counted from the frame's base | A call pushes the address to come back to: here, main+80. (57) | 456 | 516 | 751 |
+| II3 | the same | the stack | the frame's span | roles (`column`), the spans, rbp's pin; the stack's tag (`frame up`) | A function's words are its frame: the saved rbp, its locals, the way back. (74) | 769 | 829 | 1126 |
+| II4 | the same | the registers built over the stack, a row at a time, top down, then their tag, its legend the inks of I (mock 31) | rax's row | the build | The registers are the other place values live: seventeen of them. (65) | 1144 | 1204 | 1468 |
-Every caption is up its reading time and at most 450 f, leads its step
-by 60 f (120 for a chapter's first), and changes only in a rest. The
-rests are the chapters' ends: 2 s on each last picture.
+The chapter's last picture, 2 s, to 1588.
+
+**III. Code and meaning** (30.3 s)
+
+| | Form · text | Panes (rows) · shelf | Level | The step, and what plays | Text (characters) | Lands | Fires | Leaves |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| III1 | working frame · above | the code's bytes as a dump row in code's ink, across the stage | | the row arrives (12 f), its sixteen bytes take code's ink 2 f apart, one instruction's four bytes framed | Code is bytes too: 48 8b 7f 08 is one instruction. (50) | 78 | 198 | 348 |
+| III2 | `aligned` · above | `aligned`, `interleaved`, across both columns (mock 32) | | `decode`, the instruction walked and its neighbours at a run; the source's lines arrive level with their runs | Decoded: mov rdi, [rdi + 8], from line 21. Each line sits level with its code. (78) | 366 | 426 | 737 |
+| | | | | 755 to 803: the text above leaves; `stack`: the aligned columns become the program column | | | | |
+| III3 | working frame · below | the program column, the state column as II left it; the band | | the heap's dump arrives in the band's right half, then the nodes drawn from it (`establish`) | rdi pointed at a list node on the heap: its bytes, and drawn, the node. (71) | 803 | 863 | 1148 |
+| III4 | working frame · below | the working frame of mock 9 | | the camera out to x1; each pane's minimap draws itself last, top down | This is the whole frame. Every view in it is these same bytes. (62) | 1166 | 1226 | 1480 |
+| III5 | the map · on, in the key's corner | the map | | `surface` | And all of it at once: the map. (31) | 1498 | 1558 | 1699 |
+
+The last picture, 2 s, to 1819. Together 123 s.
## A scene in the column: `open` followed down
-The trial of the [column](README.md#column-an-experiment): the syscalls
-scene's first part, `open` followed down from main through the PLT and libc
-into the kernel and back, built as a variant beside the scene as it is
-(`anim/scenes/syscalls.zig`), on the same recording (`hello`, by instruction
-from main; the moments below are a fresh recording's, `ztrace record --by insn
---from main`, and move with the build). Vertical position has a meaning here
-that it has nowhere else: the story goes down a call at a time to the kernel
-and comes back up, and each bubble, level with its row, goes down with it.
-Mocks 49 to 53 are five of its beats, 54 the crossing in both forms.
+The syscalls scene's first part in the [column](README.md#column): `open`
+followed down from main through the PLT and libc into the kernel and back,
+built beside the scene as it is (`column-1080` beside `syscalls-1080`), on
+the same recording (`hello`, by instruction from main; the moments below are a
+fresh recording's and move with the build). Vertical position has a meaning
+here that it has nowhere else: the story goes down a call at a time to the
+kernel and comes back up, and each bubble, level with its row, goes down with
+it. Mocks 49 to 53 are five of its beats, 54 the crossing in both forms.
-**As it is** (the present frame, `beside`, the descent in 17 rows, a caption
-of two lines under the stage):
+**In the working frame** (`beside`, the descent in 17 rows, a caption of two
+lines under the stage):
| | Moments | Step | The caption |
| --- | --- | --- | --- |
@@ -1538,7 +1583,7 @@ of two lines under the stage):
| P7 | 64 to 65 | `cross` | `syscall` crosses down. The kernel opens the file / and answers in rax: 3, the descriptor. |
| P8 | 65 to 75 | a run, then `ascend` | `open`'s ret comes straight back to main: the stub / was a jump, not a call. The windows close up. |
-**In the column**: the author's choices, a beat a row, as a scene file is
+**In the column**: the author's choices, a beat a row, as the scene file is
written from them. *Panes* are in the column's order with their rows (`rest`:
what the column has left above the floor); everything else is on the shelf,
its note given. *Level* is the row a bubble's first line sits beside;
@@ -1549,12 +1594,12 @@ there.
| | Moments, step | Placement | Panes | Shelf (notes) | The bubble | Level | Stem |
| --- | --- | --- | --- | --- | --- | --- | --- |
| C1 | 30 to 34, walk by line | `below` | the working frame whole (`beside`) | | A program cannot open a file itself. / It asks the kernel, and waits. (the caption, as P1) | | |
-| C2 | 34 to 37, three walked | `beside` | source 3 (5 to 7), disassembly 11, registers (14 rows, all) | system calls · its bytes · stack | main puts open's arguments where the convention says: "note" in rdi, 0 (O_RDONLY) in rsi. | default: the `lea` row, the beat's first | default: the same |
-| C3 | 37 to 38, `descend` | `beside` | source 3, disassembly 11 becoming the descent, stack `rest` (19 words) | system calls · its bytes · registers (rsp struck) | The call pushes where to come back to, main+45, and goes down to open's stub. | the call row | the call row |
-| C4 | 38 to 39, the stub's jmp | `beside` | source 3 (line 6 waiting), the descent (main 8, the stub 3), stack `rest` | system calls · its bytes · registers | The stub in the PLT is one jump: it reads open@got, where the loader wrote libc's open. It pushes nothing. | the stub's `jmp` | the same |
+| C2 | 34 to 37, three walked | `beside` | source 3 (5 to 7), disassembly 11, registers (14 rows, all) | system calls · its bytes · stack | main puts open's arguments in registers: "note" in rdi, O_RDONLY in rsi. | default: the `lea` row, the beat's first | default: the same |
+| C3 | 37 to 38, `descend` | `beside` | source 3, disassembly 11 becoming the descent, stack `rest` (19 words) | system calls · its bytes · registers (rsp struck) | The call pushes the way back, main+45, and goes down to the stub. | the call row | the call row |
+| C4 | 38 to 39, the stub's jmp | `beside` | source 3 (line 6 waiting), the descent (main 8, the stub 3), stack `rest` | system calls · its bytes · registers | The stub is one jump through open@got: it pushes nothing. | the stub's `jmp` | the same |
| C5 | 39 to 61, a run | `beside` | source 2, the descent (main 3, the stub 1, open's window following the pc), stack `rest` (open's frame growing: its pins travel over the veil) | system calls · its bytes · registers | libc's open is a wrapper: a few lines of C around the one instruction that calls the kernel. | open's head row | open's head row |
-| C6 | 61 to 64, three walked | `beside` | source 2, the descent (main 3, the stub 1, open 6), registers 14 | system calls · its bytes ("note" handed in) · stack (open's frame, 16 words) | Its last three set the kernel's arguments: AT_FDCWD in rdi, and 257, openat's number, in rax. | the first of the three (`xor r8d`) | none |
-| C7 | 64 to 65, `cross` | `beside` | source 3 (waiting), the descent with the kernel at its floor (24 rows) | system calls (its row arriving) · its bytes · registers (rax 3 struck, rcx, r11) · stack | syscall crosses down. The kernel opens "note" and answers 3: the file's descriptor, in rax. | the kernel's head | none |
+| C6 | 61 to 64, three walked | `beside` | source 2, the descent (main 3, the stub 1, open 6), registers 14 | system calls · its bytes ("note" handed in) · stack (open's frame, 16 words) | Its last three set the kernel's arguments, and openat's number, 257, in rax. | the first of the three (`xor r8d`) | none |
+| C7 | 64 to 65, `cross` | `beside` | source 3 (waiting), the descent with the kernel at its floor (24 rows) | system calls (its row arriving) · its bytes · registers (rax 3 struck, rcx, r11) · stack | syscall crosses down; the kernel opens "note" and answers 3 in rax. | the kernel's head | none |
| C8 | 65 to 73 a run, 73 `leave`, 74 `ascend`, 75 the store | `beside` | source 3, the descent closing to main's window (13), stack `rest` (open's frame released as rsp's pin falls) | system calls · its bytes · registers (rax 3) | open's ret comes straight back to main: the stub was a jump, not a call. main keeps the answer in f. | main's call row (the bubble climbs back) | none |
| C9 to C11 | `read`, `close`, `write`, each stepped over | `beside` | its bytes (buf, 3 rows) over the source 3, main's disassembly with the kernel's window under the call row | system calls · registers · stack | the present captions for the three | each call row | each call row |
| C12 | to main's return | `below` | the working frame whole | | the present closing | | |
@@ -1587,7 +1632,7 @@ catalogue says, never against what it wrote:
// C3: the call goes down. The stack under the descent, the rest on the shelf.
col.beat(s, .{
.panes = &.{ .{ .source, 3 }, .{ .disasm, 11 }, .{ .stack, .rest } },
- .say = "The call pushes where to come back to, `main+45`,\nand goes down to open's stub.",
+ .say = "The call pushes the way back, `main+45`,\nand goes down to the stub.",
.at = .beside, // .below .above .on; default .beside in a column scene
.level = .{ .row = call }, // default: the row of the beat's first step
.stem = .{ .row = call }, // default: what it is level with; .none
@@ -1613,49 +1658,16 @@ the stack's pin when the stack stands, and the registers' tag when it does
not. The context is whole at C1 and C12 (`below`), on the shelf throughout,
and on the map.
-**How the render is to be judged**, both variants played to the same viewer
-(the user, on the device the videos are watched on), at 1080p and at 480p:
-
-- At each beat's hold, with the sound off: can one say what the step did and
- where, from the frame alone? Count the beats where the column's answer is
- quicker, and where something wanted was folded.
-- Eye travel: the distance from the bubble's first line to the step's mark
- (the current row, the struck value); within two rows for most of each
- beat in the column, against the caption's 300 to 800 in the working frame.
-- The account: after the crossing, can the viewer find what the call row's
- bubble said without rewinding?
-- The motion instruments (CROWD, POP, METRONOME, CAPTION, AIR): no POP from
- a fold or an unfold, no CROWD from the beat changes.
-- Time: the scene no more than a sixth longer.
-- Taste, said plainly: whether the frame with half its panes folded feels
- like canim (the whole context, pwndbg's density) or like a slide deck.
-
-**What I think.** A style for some scenes and some beats, not the way every
-scene is made: it wins where the story is a column of rows that goes down and
-comes back (a call followed down, a recursion, the stack growing, a loop told
-turn by turn beside its rows), and loses where every step acts on the program
-and the state at once (sort's swaps with the array, the heap scene's two rows
-of nodes and their bytes): there the working frame is the subject and its text
-belongs `below` or `above`. So the placements are the instrument: a scene
-mixes `below` and `beside` beat by beat, `on` for a drawing with room, and the
-working frame stays the language's default and a column scene's opening and
-close.
-
-**If it wins**, what changes in the two storyboards waiting for it. *The ASan
-pair*: its facing beats need both runs side by side and stay `below` (or
-`above`, the seam undisturbed); from i = 16, when they part, plain goes on
-alone: its frame's bytes (`hexdump` `eight`) stand in the panes' column the
-height of the stage, and each bubble sits level with the field the turn's
-letter lands in, `buf`, the saved rbp, the return address, so the narration
-climbs the frame as the overflow does; ASan's report is unfolded as the
-subject of its own beat, a bubble level with each line it explains (`WRITE of
-size 1`, `[32, 48) 'buf'`). *The introduction*: `segments` is a tall subject,
-`beside`, a bubble level with each band as it is enlarged, the stack's at the
-top and the program's at the foot, so the chapters go down the address space;
-`regroup` at x2 is a drawing with room, its bubble `on` it beside the walked
-word; `aligned` spans both columns and keeps its text `above`; the stack panel
-built over the words is `beside`; and its one walked load is the beat for
-`carry = .value`.
+**As built.** The render keeps the newest bubble level with its row in most
+beats and runs 23% longer than the working frame's (seven pane changes, about
+9.5 s). Three of its beats break the rules the [column](README.md#column)
+now states: C4's bubble (104 characters) was still being read 4.9 s after its
+one step had played; the descent stood empty about 40 f while it grew at C7; and
+the change into the column at C2 slid the working frame's empty panels across
+each other. The bubbles in the table above are cut to the lengths the rule allows (C4's
+from 104 characters to 57). And the scene could change its panes twice less:
+C6's registers can stay through the crossing (rax is struck in them there),
+and C7's stack can stay folded until C8 needs it.
## Stills