From 568c553986762e43fec2c850553171398f423cdd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Petr=20Balv=C3=ADn?= Date: Sat, 29 Aug 2026 14:24:52 +0200 Subject: [PATCH] docs: document the audit, scaffold, scalar-args and headless debug additions --- README.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/README.md b/README.md index 8df973a..0a9021e 100644 --- a/README.md +++ b/README.md @@ -119,7 +119,12 @@ gasm asm --format elf -o k.o k.s # assemble to a linkable ELF object gasm verify kernel_amd64.s # JIT-load and report functions gasm verify --ground-truth k.s # byte-for-byte vs go tool asm gasm verify --call decodeBlockAVX2 --buf src:64:hex...,dst:256:zero k.s +gasm verify --call sumTo --args n=57,base=0x1f k.s # scalar arguments gasm debug --func name k.s # interactive debugger +gasm debug --func name --script cmds.txt --timeout 30s k.s # headless run +gasm debug --func name --cover k.s # which labels did execution reach? +gasm audit-instructions # encoder vs go tool asm name diff +gasm scaffold differential k.s # generate a differential test skeleton gasm diff a.s b.s # compare machine code byte-for-byte gasm diff --map wideCopyAVX2=wideCopyAVX512 avx2.s avx512.s gasm profile k.s # show basic-block structure