diff options
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 16 |
1 files changed, 10 insertions, 6 deletions
@@ -873,15 +873,19 @@ renderer migration work and the optional addon boundary. ## The boundary Host and sketch are built by the same `zig build`, so ordinary Zig types cross -it (slices, tagged unions, `std.mem.Allocator`). `abi.hash`, a comptime hash -of every shared type's layout and of the zig version, backend and optimize +it (slices, tagged unions, `std.mem.Allocator`). `abi.hash`, a hash of +every shared type's layout and of the zig version, backend and optimize mode, guards against the real hazards: a host refuses a library built against different definitions, or by another compiler or mode (`zig build run` beside `zig build lib --watch -Doptimize=fast`: Zig's own calling -convention differs between them), and says what differs. Everything that outlives -a call lives in host memory, since host code is never unloaded. Only the -recorded `Event` and the reflected `Layout` are `extern`, because they are -written to disk. +convention differs between them), and says what differs. The layout half +costs half a second of comptime, so a small program (`src/abi_hash.zig`) +computes it once per change of the abi sources, at build time, and host and +sketches import the number; it is computed for the build machine in Debug, +so a layout change seen only by another target or mode is not caught. +Everything that outlives a call lives in host memory, since host code is +never unloaded. Only the recorded `Event` and the reflected `Layout` are +`extern`, because they are written to disk. `zig build test` in this directory runs the unit tests, a headless reload through `dlopen`, where a counter sketch changes its layout mid-run and keeps |
