docs: document the audit, scaffold, scalar-args and headless debug additions

2026-08-29 14:24:52 +02:00
parent 7a30e902fc
commit 568c553986
1 changed files with 5 additions and 0 deletions
@@ -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