docs: Add instructions on grate api usage and how to create grate examples by Yaxuan-w · Pull Request #1348 · Lind-Project/lind-wasm

Yaxuan-w · 2026-08-12T18:43:29Z

Summary

Adds a new internal doc page, docs/internal/grate-api.md, documenting the public grate developer API declared in src/glibc/lind_syscall/lind_syscall.h. The existing Grates and Threei pages explain the concepts, but there was no reference for how to actually use the API when writing a grate.

The new page covers:

Common conventions: cage IDs, (value, cageid) argument pairs, GRATE_MEMORY_FLAG, and 3i error codes (ELINDAPIABORTED / ELINDESRCH)
The four API functions — make_threei_call, register_handler, copy_data_between_cages, and copy_handler_table_to_cage — with parameter tables, return-value semantics, and worked examples adapted from tests/grate-tests/
The required pass_fptr_to_wt dispatcher and the handler function signature
A complete minimal C grate (fork / register / exec pattern)
Writing grates in Rust with the grate-rs library from lind-wasm-example-grates, including the GrateBuilder lifecycle and a Rust version of the same example

Also registers the page in the mkdocs nav as "Grate API", after "Grates".

Related issues

Closes #825
Closes #1346

Testing

Compatibility and security impact

Checklist

I have read the contribution guidelines.
I added or updated tests where appropriate.
I ran the relevant tests locally and they pass.
I formatted the code and ran the relevant linters.
I updated documentation for user-visible or architectural changes.
I disclosed security vulnerabilities privately rather than in this PR.

github-actions · 2026-08-12T18:49:08Z

End-to-End Test Report

Test Preview

grate harness

Grate Test Report

Metric	Value
Total	15
Success	15
Failures	0
Compile Failures	0
Runtime Failures	0
Timeout Failures	0
Missing Pair Failures	0

Cases

Test	Status	Output
concurrent-request/geteuid_grate.c	Success	STDOUT: [Grate\|geteuid] Registering geteuid handler for cage 2 in grate 1 with fn ptr addr: 3 [Cage \| geteuid] PASS: 1000000 calls returned 10 [Grate\|geteuid] PASS STDERR:
concurrent-request/race-test_grate.c	Success	STDOUT: pass STDERR:
concurrent-request/thread_race_grate.c	Success	STDOUT: [thread_race] Registering handler for cage 2 in grate 1 with fn ptr addr: 3 [thread_race] PASS: 20 threads x 100000 calls returned 10 [thread_race] PASS STDERR:
copy-data-between-cages/cp-stncpy_grate.c	Success	STDOUT: [cage] pathname addr=0xfffb6ff9 [cage] pathname='random' [Grate\|open] intercepts open call: thiscage=1, arg1cage=2 [Grate\|open] copied pathname: random [cage] fd=10 STDERR:
copy-data-between-cages/cpdata_grate.c	Success	STDOUT: [Grate\|open] intercepts open call: thiscage=1, arg1cage=2 [Grate\|open] copied pathname: random [cage] fd=10 STDERR:
interposing-calls/fork-with-newret_grate.c	Success	STDOUT: [Grate\|interpose-fork] Registering fork handler for cage 2 in grate 1 with fn ptr addr: 3 [Grate\|interpose-fork] Handling function ptr: 3 from cage: 1 [Grate\|interpose-fork] In fork_grate 1 handler for cage: 1 [Cage] Forked process with PID: 10 [Grate\|interpose-fork] PASS STDERR:
interposing-calls/interpose-exec_grate.c	Success	STDOUT: [Grate\|interpose-exec] Registering exec handler for cage 2 in grate 1 with fn ptr addr: 3 [Grate\|interpose-exec] Handling function ptr: 3 from cage: 1 [Grate\|interpose-exec] In exec_grate 1 handler for cage: 1 [Grate\|interpose-exec] Handling function ptr: 3 from cage: 1 [Grate\|interpose-exec] In exec_grate 1 handler for cage: 1 Exec successful, argv[1]: --execd [Grate\|interpose-exec] PASS STDERR:
interposing-calls/interpose-exit_grate.c	Success	STDOUT: [Grate\|interpose-exit] Registering exit handler for cage 2 in grate 1 with fn ptr addr: 3 Exiting... [Grate\|interpose-exit] PASS STDERR:
interposing-calls/interpose-fork_grate.c	Success	STDOUT: [Grate\|interpose-fork] Registering fork handler for cage 2 in grate 1 with fn ptr addr: 3 [Grate\|interpose-fork] Handling function ptr: 3 from cage: 1 [Grate\|interpose-fork] In fork_grate 1 handler for cage: 1 [Grate\|interpose-fork] PASS STDERR:
interposing-calls/interpose-mmap_grate.c	Success	STDOUT: [Grate\|interpose-mmap] Registering mmap handler for cage 2 in grate 1 with fn ptr addr: 3 [Grate\|interpose-mmap] Handling function ptr: 3 from cage: 1 [Grate\|interpose-mmap] In mmap_grate 1 handler for cage: 1 [Grate\|interpose-mmap] Handling function ptr: 3 from cage: 1 [Grate\|interpose-mmap] In mmap_grate 1 handler for cage: 1 [Grate\|interpose-mmap] Handling function ptr: 3 from cage: 1 [Grate\|interpose-mmap] In mmap_grate 1 handler for cage: 1 [Grate\|interpose-mmap] Handling function ptr: 3 from cage: 1 [Grate\|interpose-mmap] In mmap_grate 1 handler for cage: 1 [Grate\|interpose-mmap] Handling function ptr: 3 from cage: 1 [Grate\|interpose-mmap] In mmap_grate 1 handler for cage: 1 mmap test: PASS [Grate\|interpose-mmap] PASS STDERR:
interposing-calls/interpose-register_grate.c	Success	STDOUT: [Grate\|interpose-register] Registering register_handler for cage 2 in grate 1 with fn ptr addr: 4 [cage] registering 107. grateid: 2 cageid: 3 [Grate\|interpose-register] Handling function ptr: 4 from cage: 1 [Grate\|interpose-register] In register_grate 1 handler for cage: 1 [Grate\|geteuid] Registering geteuid handler for cage 1 in grate 1 with fn ptr addr: 3 [Grate\|interpose-register] Handling function ptr: 3 from cage: 1 [Grate\|interpose-register] In register_grate 1 handler for cage: 1 [Grate\|interpose-register] PASS STDERR:
multi-register_grate.c	Success	STDOUT: [Grate\|multi-register_grate] Registering geteuid handler for cage 2 in grate 1 with fn ptr addr: 4 [Grate\|multi-register_grate] Registering getuid handler for cage 2 in grate 1 with fn ptr addr: 3 [Grate\|multi-register_grate] Handling function ptr: 4 from cage: 1 [Grate\|multi-register_grate] In multi-register_grate 1 handler for cage: 1 [Grate\|multi-register_grate] Handling function ptr: 3 from cage: 1 [Grate\|multi-register_grate] In multi-register_grate 1 handler for cage: 1 [Cage \| multi-register] PASS: geteuid=10, getuid=20 [Grate\|multi-register] PASS STDERR:
simple-tests/copy-handler-table_grate.c	Success	STDOUT: [Grate\|copy-handler-table] Registering geteuid handler for cage 2 in grate 1 [Grate\|copy-handler-table] geteuid handler invoked for cage 1 [Grate\|copy-handler-table] geteuid handler invoked for cage 1 [Cage\|copy-handler-table] PASS: child inherited handler, then overwrite changed geteuid to 0 [Cage\|copy-handler-table] PASS: parent=123 child_exit=0 [Grate\|copy-handler-table] PASS STDERR:
simple-tests/diff-cage-args_grate.c	Success	STDOUT: [Grate\|diff-cage-args] Handling function ptr: 3 from cage: 1 [Grate\|diff-cage-args] In open_grate 1 handler for cage: 1 Hello world. FD=-1 [Grate\|diff-cage-args] Handling function ptr: 4 from cage: 1 Goodbye world! ret=4321 buf=helloworld [Grate\|diff-cage-args] PASS STDERR:
simple-tests/geteuid_grate.c	Success	STDOUT: [Grate\|geteuid] Registering geteuid handler for cage 2 in grate 1 with fn ptr addr: 3 [Grate\|geteuid] Handling function ptr: 3 from cage: 1 [Grate\|geteuid] In geteuid_grate 1 handler for cage: 1 [Cage \| geteuid] PASS: geteuid ret = 10 [Grate\|geteuid] PASS STDERR:

static harness

Test Report

Deterministic Tests

Summary

Metric	Count
Total Test Cases	3
Number of Successes	3
Number of Failures	0
Number of Compilation Failure Native	0
Number of Runtime Failure Native	0
Number of Segmentation Fault Native	0
Number of Timeout During Native	0
Number of Lind Wasm Compile Failure	0
Number of Lind Wasm Runtime Failure	0
Number of Lind Wasm Segmentation Failure	0
Number of Timeout During Lind Wasm run	0
Number of Unknown Failure	0
Number of C Compiler and Wasm Output mismatch	0
Number of Fail Test: Native Succeeded (Should Fail)	0
Number of Fail Test: Wasm Succeeded (Should Fail)	0
Number of Fail Test: Both Native and Wasm Succeeded (Should Fail)	0
Number of Fail Test: Native Compilation Failure (Should Succeed)	0
Number of Fail Test: Wasm Compilation Failure (Should Succeed)	0

Test Results by Category

Test Case	Status	Error Type	Native Time	Wasm Time	Output
Static Tests
fork_simple.c	Success	None	0.060027s	4.020841s	Success
thread.c	Success	None	0.051759s	4.075328s	Success
tls_test.c	Success	None	0.058726s	4.091577s	Success

Fail Tests

Summary

Metric	Count
Total Test Cases	0
Number of Successes	0
Number of Failures	0
Number of Compilation Failure Native	0
Number of Runtime Failure Native	0
Number of Segmentation Fault Native	0
Number of Timeout During Native	0
Number of Lind Wasm Compile Failure	0
Number of Lind Wasm Runtime Failure	0
Number of Lind Wasm Segmentation Failure	0
Number of Timeout During Lind Wasm run	0
Number of Unknown Failure	0
Number of C Compiler and Wasm Output mismatch	0
Number of Fail Test: Native Succeeded (Should Fail)	0
Number of Fail Test: Wasm Succeeded (Should Fail)	0
Number of Fail Test: Both Native and Wasm Succeeded (Should Fail)	0
Number of Fail Test: Native Compilation Failure (Should Succeed)	0
Number of Fail Test: Wasm Compilation Failure (Should Succeed)	0

wasm-math harness

Test Report

Deterministic Tests

Summary

Metric	Count
Total Test Cases	3
Number of Successes	3
Number of Failures	0
Number of Compilation Failure Native	0
Number of Runtime Failure Native	0
Number of Segmentation Fault Native	0
Number of Timeout During Native	0
Number of Lind Wasm Compile Failure	0
Number of Lind Wasm Runtime Failure	0
Number of Lind Wasm Segmentation Failure	0
Number of Timeout During Lind Wasm run	0
Number of Unknown Failure	0
Number of C Compiler and Wasm Output mismatch	0
Number of Fail Test: Native Succeeded (Should Fail)	0
Number of Fail Test: Wasm Succeeded (Should Fail)	0
Number of Fail Test: Both Native and Wasm Succeeded (Should Fail)	0
Number of Fail Test: Native Compilation Failure (Should Succeed)	0
Number of Fail Test: Wasm Compilation Failure (Should Succeed)	0

Test Results by Category

Test Case	Status	Error Type	Native Time	Wasm Time	Output
Math Tests
math_link_smoke.c	Success	None	0.059647s	0.119418s	Success
math_tests.c	Success	None	0.062742s	0.144372s	Success
printf_float.c	Success	None	0.061384s	0.141796s	Success

Fail Tests

Summary

Metric	Count
Total Test Cases	0
Number of Successes	0
Number of Failures	0
Number of Compilation Failure Native	0
Number of Runtime Failure Native	0
Number of Segmentation Fault Native	0
Number of Timeout During Native	0
Number of Lind Wasm Compile Failure	0
Number of Lind Wasm Runtime Failure	0
Number of Lind Wasm Segmentation Failure	0
Number of Timeout During Lind Wasm run	0
Number of Unknown Failure	0
Number of C Compiler and Wasm Output mismatch	0
Number of Fail Test: Native Succeeded (Should Fail)	0
Number of Fail Test: Wasm Succeeded (Should Fail)	0
Number of Fail Test: Both Native and Wasm Succeeded (Should Fail)	0
Number of Fail Test: Native Compilation Failure (Should Succeed)	0
Number of Fail Test: Wasm Compilation Failure (Should Succeed)	0

wasm-filesystem harness

Test Report

Deterministic Tests

Summary

Metric	Count
Total Test Cases	74
Number of Successes	74
Number of Failures	0
Number of Compilation Failure Native	0
Number of Runtime Failure Native	0
Number of Segmentation Fault Native	0
Number of Timeout During Native	0
Number of Lind Wasm Compile Failure	0
Number of Lind Wasm Runtime Failure	0
Number of Lind Wasm Segmentation Failure	0
Number of Timeout During Lind Wasm run	0
Number of Unknown Failure	0
Number of C Compiler and Wasm Output mismatch	0
Number of Fail Test: Native Succeeded (Should Fail)	0
Number of Fail Test: Wasm Succeeded (Should Fail)	0
Number of Fail Test: Both Native and Wasm Succeeded (Should Fail)	0
Number of Fail Test: Native Compilation Failure (Should Succeed)	0
Number of Fail Test: Wasm Compilation Failure (Should Succeed)	0

Test Results by Category

Test Case	Status	Error Type	Native Time	Wasm Time	Output
File Tests
chartests.c	Success	None	0.051063s	0.153168s	Success
chdir_getcwd.c	Success	None	0.052111s	0.124051s	Success
chmod.c	Success	None	0.058771s	0.138936s	Success
clock_gettime_highlevel.c	Success	None	0.125189s	0.181652s	Success
clock_gettime_simple.c	Success	None	0.046370s	0.119933s	Success
cloexec.c	Success	None	0.055121s	0.150752s	Success
close.c	Success	None	0.065943s	0.154349s	Success
copy_file_range.c	Success	None	0.054553s	0.148254s	Success
creat_access.c	Success	None	0.055346s	0.124630s	Success
cross_cage_fd_bruteforce.c	Success	None	0.056580s	0.199640s	Success
doubleclose.c	Success	None	0.048131s	0.108207s	Success
dup.c	Success	None	0.049278s	0.127438s	Success
dup2.c	Success	None	0.054169s	0.122391s	Success
dup3.c	Success	None	0.051804s	0.127003s	Success
dupwrite.c	Success	None	0.055429s	0.135235s	Success
etc_conf.c	Success	None	0.050492s	0.129240s	Success
faccessat.c	Success	None	0.053656s	0.132603s	Success
fchdir.c	Success	None	0.057387s	0.142818s	Success
fchmod.c	Success	None	0.056302s	0.144404s	Success
fchmodat.c	Success	None	0.052097s	0.125388s	Success
fcntl.c	Success	None	0.054900s	0.143559s	Success
fcntl_dupfd.c	Success	None	0.050368s	0.124093s	Success
fdatasync.c	Success	None	0.054143s	0.125442s	Success
filetest.c	Success	None	0.055988s	0.120238s	Success
filetest1000.c	Success	None	0.065344s	0.141585s	Success
flock.c	Success	None	0.067047s	0.181325s	Success
fstat.c	Success	None	0.056587s	0.139655s	Success
fstatfs.c	Success	None	0.049974s	0.116716s	Success
fsync.c	Success	None	0.053880s	0.122517s	Success
ftruncate.c	Success	None	0.058963s	0.219020s	Success
getcwd.c	Success	None	0.051748s	0.119500s	Success
getcwd_null.c	Success	None	0.056310s	0.128777s	Success
getpgid.c	Success	None	0.050179s	0.117291s	Success
getrandom.c	Success	None	0.054841s	0.137946s	Success
ioctl.c	Success	None	0.058916s	0.137138s	Success
link.c	Success	None	0.058311s	0.166144s	Success
locale_test.c	Success	None	0.065779s	0.322029s	Success
lseek.c	Success	None	0.059390s	0.199145s	Success
lstat.c	Success	None	0.058655s	0.150084s	Success
mkdir_rmdir.c	Success	None	0.055000s	0.131957s	Success
mkfifo_test.c	Success	None	0.061148s	0.186439s	Success
mknod.c	Success	None	0.055171s	0.133238s	Success
nocancel_io.c	Success	None	0.058384s	0.171687s	Success
open.c	Success	None	0.050658s	0.115243s	Success
openat.c	Success	None	0.052023s	0.127382s	Success
path_conversion_safety.c	Success	None	0.059679s	0.144465s	Success
ppoll.c	Success	None	0.058747s	0.134968s	Success
pread_pwrite.c	Success	None	0.053337s	0.129869s	Success
preadv_pwritev.c	Success	None	0.057033s	0.140832s	Success
printf.c	Success	None	0.048863s	0.117978s	Success
prlimit64.c	Success	None	0.048984s	0.118066s	Success
read.c	Success	None	0.056135s	0.137227s	Success
readbytes.c	Success	None	0.051754s	0.117667s	Success
readdir_basic.c	Success	None	0.059703s	0.161034s	Success
readlink.c	Success	None	0.055785s	0.133988s	Success
readlinkat.c	Success	None	0.057859s	0.138682s	Success
readv_writev_test.c	Success	None	0.057153s	0.140412s	Success
rename.c	Success	None	0.057082s	0.127544s	Success
renameat.c	Success	None	0.057912s	0.140447s	Success
sc-writev.c	Success	None	0.054488s	0.128272s	Success
stat.c	Success	None	0.056542s	0.135161s	Success
statfs.c	Success	None	0.050207s	0.117079s	Success
symlink.c	Success	None	0.057771s	0.155281s	Success
sync_file_range.c	Success	None	0.054708s	0.120803s	Success
timespec_time_t_compat.c	Success	None	0.053112s	0.119233s	Success
trailing_slash.c	Success	None	0.054456s	0.134059s	Success
truncate.c	Success	None	0.056877s	0.147453s	Success
unlink.c	Success	None	0.058374s	0.160143s	Success
unlinkat.c	Success	None	0.057182s	0.143780s	Success
utimensat.c	Success	None	0.054375s	0.144687s	Success
write.c	Success	None	0.048965s	0.111795s	Success
writeloop.c	Success	None	0.057279s	0.126322s	Success
writepartial.c	Success	None	0.056015s	0.116704s	Success
writev.c	Success	None	0.056889s	0.133278s	Success

Fail Tests

Summary

Metric	Count
Total Test Cases	0
Number of Successes	0
Number of Failures	0
Number of Compilation Failure Native	0
Number of Runtime Failure Native	0
Number of Segmentation Fault Native	0
Number of Timeout During Native	0
Number of Lind Wasm Compile Failure	0
Number of Lind Wasm Runtime Failure	0
Number of Lind Wasm Segmentation Failure	0
Number of Timeout During Lind Wasm run	0
Number of Unknown Failure	0
Number of C Compiler and Wasm Output mismatch	0
Number of Fail Test: Native Succeeded (Should Fail)	0
Number of Fail Test: Wasm Succeeded (Should Fail)	0
Number of Fail Test: Both Native and Wasm Succeeded (Should Fail)	0
Number of Fail Test: Native Compilation Failure (Should Succeed)	0
Number of Fail Test: Wasm Compilation Failure (Should Succeed)	0

wasm-memory harness

Test Report

Deterministic Tests

Summary

Metric	Count
Total Test Cases	28
Number of Successes	28
Number of Failures	0
Number of Compilation Failure Native	0
Number of Runtime Failure Native	0
Number of Segmentation Fault Native	0
Number of Timeout During Native	0
Number of Lind Wasm Compile Failure	0
Number of Lind Wasm Runtime Failure	0
Number of Lind Wasm Segmentation Failure	0
Number of Timeout During Lind Wasm run	0
Number of Unknown Failure	0
Number of C Compiler and Wasm Output mismatch	0
Number of Fail Test: Native Succeeded (Should Fail)	0
Number of Fail Test: Wasm Succeeded (Should Fail)	0
Number of Fail Test: Both Native and Wasm Succeeded (Should Fail)	0
Number of Fail Test: Native Compilation Failure (Should Succeed)	0
Number of Fail Test: Wasm Compilation Failure (Should Succeed)	0

Test Results by Category

Test Case	Status	Error Type	Native Time	Wasm Time	Output
Memory Tests
brk.c	Success	None	0.067975s	0.131583s	Success
fork_large_memory.c	Success	None	0.084620s	0.491395s	Success
malloc.c	Success	None	0.052853s	0.117699s	Success
malloc_large.c	Success	None	0.052441s	0.112475s	Success
memcpy.c	Success	None	0.052555s	0.123494s	Success
memory_error_test.c	Success	None	0.062530s	0.150345s	Success
mmap.c	Success	None	0.050664s	0.128314s	Success
mmap_address_truncation.c	Success	None	0.050912s	0.122450s	Success
mmap_aligned.c	Success	None	0.050392s	0.130150s	Success
mmap_complicated.c	Success	None	0.056609s	0.180220s	Success
mmap_file.c	Success	None	0.058912s	0.128887s	Success
mmap_shared.c	Success	None	0.057697s	0.161333s	Success
mmaptest.c	Success	None	0.050085s	0.119928s	Success
mprotect.c	Success	None	0.050975s	0.172442s	Success
mprotect_boundary.c	Success	None	0.063513s	0.157171s	Success
mprotect_end_region.c	Success	None	0.051231s	0.127445s	Success
mprotect_middle_region.c	Success	None	0.098830s	0.131964s	Success
mprotect_multiple_times.c	Success	None	0.081364s	0.190236s	Success
mprotect_same_value.c	Success	None	0.049444s	0.118859s	Success
mprotect_spanning_regions.c	Success	None	0.055063s	0.142833s	Success
munmap_adjacent_shm.c	Success	None	0.099729s	0.268757s	Success
sbrk.c	Success	None	0.053825s	0.124456s	Success
segfault.c	Success	None	0.064261s	0.358360s	Success
shm.c	Success	None	0.058543s	0.172274s	Success
shmtest.c	Success	None	0.060480s	0.128719s	Success
thread_malloc_sequential.c	Success	None	0.071244s	0.228649s	Success
vmmap_escape.c	Success	None	0.066523s	0.222496s	Success
vtable.c	Success	None	0.059596s	0.133351s	Success

Fail Tests

Summary

Metric	Count
Total Test Cases	4
Number of Successes	4
Number of Failures	0
Number of Compilation Failure Native	0
Number of Runtime Failure Native	0
Number of Segmentation Fault Native	0
Number of Timeout During Native	0
Number of Lind Wasm Compile Failure	0
Number of Lind Wasm Runtime Failure	0
Number of Lind Wasm Segmentation Failure	0
Number of Timeout During Lind Wasm run	0
Number of Unknown Failure	0
Number of C Compiler and Wasm Output mismatch	0
Number of Fail Test: Native Succeeded (Should Fail)	0
Number of Fail Test: Wasm Succeeded (Should Fail)	0
Number of Fail Test: Both Native and Wasm Succeeded (Should Fail)	0
Number of Fail Test: Native Compilation Failure (Should Succeed)	0
Number of Fail Test: Wasm Compilation Failure (Should Succeed)	0

Test Results by Category

Test Case	Status	Error Type	Native Time	Wasm Time	Output
Memory Tests
invalid_access_direct.c	Success	None	0.125028s	0.128998s	Success
invalid_access_fork.c	Success	None	0.144752s	0.158568s	Success
mmap-negative1.c	Success	None	0.170438s	0.259290s	Success
mmap-negative2.c	Success	None	0.140353s	0.175272s	Success

wasm-process harness

Test Report

Deterministic Tests

Summary

Metric	Count
Total Test Cases	57
Number of Successes	57
Number of Failures	0
Number of Compilation Failure Native	0
Number of Runtime Failure Native	0
Number of Segmentation Fault Native	0
Number of Timeout During Native	0
Number of Lind Wasm Compile Failure	0
Number of Lind Wasm Runtime Failure	0
Number of Lind Wasm Segmentation Failure	0
Number of Timeout During Lind Wasm run	0
Number of Unknown Failure	0
Number of C Compiler and Wasm Output mismatch	0
Number of Fail Test: Native Succeeded (Should Fail)	0
Number of Fail Test: Wasm Succeeded (Should Fail)	0
Number of Fail Test: Both Native and Wasm Succeeded (Should Fail)	0
Number of Fail Test: Native Compilation Failure (Should Succeed)	0
Number of Fail Test: Wasm Compilation Failure (Should Succeed)	0

Test Results by Category

Test Case	Status	Error Type	Native Time	Wasm Time	Output
Process Tests
barrier_test.c	Success	None	0.053454s	0.153415s	Success
chain_thread.c	Success	None	1.054948s	1.155556s	Success
ctor_syscall_test.c	Success	None	0.047468s	0.114165s	Success
cxa_atexit_test.c	Success	None	0.052133s	0.121388s	Success
exec_non_utf8.c	Success	None	0.055536s	0.123648s	Success
execve_shebang.c	Success	None	0.056427s	0.126219s	Success
exit.c	Success	None	0.052294s	0.119606s	Success
exit_failure.c	Success	None	0.055636s	0.148529s	Success
exit_group_thread.c	Success	None	0.055976s	0.174634s	Success
exit_status_first_wins.c	Success	None	0.058083s	0.180380s	Success
flockfile_test.c	Success	None	0.055502s	0.159765s	Success
fork2malloc.c	Success	None	0.057022s	0.149743s	Success
fork_select.c	Success	None	0.054646s	0.158911s	Success
fork_simple.c	Success	None	0.054121s	0.141160s	Success
fork_syscall.c	Success	None	0.059328s	0.676522s	Success
fork_tls_ctype.c	Success	None	0.058445s	0.170021s	Success
forkandopen.c	Success	None	0.057233s	0.159829s	Success
forkdup.c	Success	None	0.057094s	0.160005s	Success
forkexecuid.c	Success	None	0.053939s	0.169798s	Success
forkexecv-arg.c	Success	None	0.053740s	0.163976s	Success
forkexecv.c	Success	None	0.053843s	0.157584s	Success
forkfiles.c	Success	None	0.062311s	0.160492s	Success
forkmalloc.c	Success	None	0.055410s	0.144958s	Success
forknodup.c	Success	None	0.056100s	0.157011s	Success
function-ptr.c	Success	None	0.052323s	0.114457s	Success
getegid_syscall.c	Success	None	0.055298s	0.494246s	Success
getgid_syscall.c	Success	None	0.055993s	0.515603s	Success
getpid.c	Success	None	0.049183s	0.112439s	Success
getpid_syscall.c	Success	None	0.060452s	0.602061s	Success
getppid.c	Success	None	0.056536s	0.145602s	Success
getppid_syscall.c	Success	None	0.059368s	0.435237s	Success
getuid.c	Success	None	0.056165s	0.121085s	Success
getuid_syscall.c	Success	None	0.053975s	0.265400s	Success
hello-arg.c	Success	None	0.047067s	0.122106s	Success
hello.c	Success	None	0.046174s	0.112664s	Success
longjmp.c	Success	None	0.048270s	0.121238s	Success
mutex.c	Success	None	2.063011s	2.158732s	Success
printf_deadlock_smoke.c	Success	None	0.063509s	0.183465s	Success
printf_thread_test.c	Success	None	0.053971s	0.154478s	Success
sem_forks.c	Success	None	0.056833s	0.195860s	Success
sem_slow_path.c	Success	None	1.057375s	1.157882s	Success
setjmp_edge.c	Success	None	0.051774s	0.211767s	Success
setsid.c	Success	None	0.049345s	0.116053s	Success
template.c	Success	None	0.054205s	0.200495s	Success
test_crossmodule_longjmp.c	Success	None	0.055753s	0.156580s	Success
test_exec_nofork.c	Success	None	0.053591s	0.144090s	Success
test_unlink_open_file.c	Success	None	0.051690s	0.114642s	Success
thread-guard.c	Success	None	0.054207s	0.141447s	Success
thread-test.c	Success	None	0.051833s	0.133739s	Success
thread.c	Success	None	0.052348s	0.131883s	Success
thread_cageid_race.c	Success	None	0.052166s	0.308699s	Success
tls_test.c	Success	None	0.054414s	0.174926s	Success
uname.c	Success	None	0.049538s	0.114512s	Success
wait.c	Success	None	0.051747s	0.164448s	Success
waitpid_anychild.c	Success	None	0.055808s	0.146471s	Success
waitpid_syscall.c	Success	None	1.056000s	1.248872s	Success
waitpid_wnohang.c	Success	None	0.055929s	0.156053s	Success

Fail Tests

Summary

Metric	Count
Total Test Cases	0
Number of Successes	0
Number of Failures	0
Number of Compilation Failure Native	0
Number of Runtime Failure Native	0
Number of Segmentation Fault Native	0
Number of Timeout During Native	0
Number of Lind Wasm Compile Failure	0
Number of Lind Wasm Runtime Failure	0
Number of Lind Wasm Segmentation Failure	0
Number of Timeout During Lind Wasm run	0
Number of Unknown Failure	0
Number of C Compiler and Wasm Output mismatch	0
Number of Fail Test: Native Succeeded (Should Fail)	0
Number of Fail Test: Wasm Succeeded (Should Fail)	0
Number of Fail Test: Both Native and Wasm Succeeded (Should Fail)	0
Number of Fail Test: Native Compilation Failure (Should Succeed)	0
Number of Fail Test: Wasm Compilation Failure (Should Succeed)	0

wasm-signals harness

Test Report

Deterministic Tests

Summary

Metric	Count
Total Test Cases	24
Number of Successes	24
Number of Failures	0
Number of Compilation Failure Native	0
Number of Runtime Failure Native	0
Number of Segmentation Fault Native	0
Number of Timeout During Native	0
Number of Lind Wasm Compile Failure	0
Number of Lind Wasm Runtime Failure	0
Number of Lind Wasm Segmentation Failure	0
Number of Timeout During Lind Wasm run	0
Number of Unknown Failure	0
Number of C Compiler and Wasm Output mismatch	0
Number of Fail Test: Native Succeeded (Should Fail)	0
Number of Fail Test: Wasm Succeeded (Should Fail)	0
Number of Fail Test: Both Native and Wasm Succeeded (Should Fail)	0
Number of Fail Test: Native Compilation Failure (Should Succeed)	0
Number of Fail Test: Wasm Compilation Failure (Should Succeed)	0

Test Results by Category

Test Case	Status	Error Type	Native Time	Wasm Time	Output
Signal Tests
alarm.c	Success	None	7.053559s	7.165024s	Success
eintr_fork_signal.c	Success	None	1.058329s	1.158918s	Success
kill.c	Success	None	1.054390s	1.150703s	Success
pause_test.c	Success	None	1.054893s	1.150327s	Success
setitimer.c	Success	None	7.055982s	7.157356s	Success
sigalrm.c	Success	None	2.054527s	2.147454s	Success
sigaltstack.c	Success	None	0.057318s	0.141044s	Success
sigchld.c	Success	None	1.055948s	1.148510s	Success
signal-fork.c	Success	None	4.056684s	4.146217s	Success
signal-simple.c	Success	None	0.055368s	0.127167s	Success
signal_SIGCHLD.c	Success	None	0.053076s	0.160175s	Success
signal_fork.c	Success	None	0.052238s	0.152073s	Success
signal_int_ignored.c	Success	None	2.055594s	2.149607s	Success
signal_kill_cleanup.c	Success	None	1.052672s	1.139067s	Success
signal_procmask.c	Success	None	0.051292s	0.131544s	Success
signal_read_interrupt.c	Success	None	0.557855s	0.669469s	Success
signal_recursive.c	Success	None	0.051461s	0.133870s	Success
signal_sa_mask.c	Success	None	0.050969s	0.126184s	Success
signal_select_interrupt.c	Success	None	0.558273s	0.652474s	Success
signal_write_interrupt.c	Success	None	1.056937s	1.141893s	Success
sigpipe.c	Success	None	1.058335s	1.154563s	Success
sigprocmask.c	Success	None	1.057216s	1.133300s	Success
sigsuspend_test.c	Success	None	1.053565s	1.152924s	Success
test_sigsetjmp.c	Success	None	0.055144s	0.155055s	Success

Fail Tests

Summary

Metric	Count
Total Test Cases	1
Number of Successes	1
Number of Failures	0
Number of Compilation Failure Native	0
Number of Runtime Failure Native	0
Number of Segmentation Fault Native	0
Number of Timeout During Native	0
Number of Lind Wasm Compile Failure	0
Number of Lind Wasm Runtime Failure	0
Number of Lind Wasm Segmentation Failure	0
Number of Timeout During Lind Wasm run	0
Number of Unknown Failure	0
Number of C Compiler and Wasm Output mismatch	0
Number of Fail Test: Native Succeeded (Should Fail)	0
Number of Fail Test: Wasm Succeeded (Should Fail)	0
Number of Fail Test: Both Native and Wasm Succeeded (Should Fail)	0
Number of Fail Test: Native Compilation Failure (Should Succeed)	0
Number of Fail Test: Wasm Compilation Failure (Should Succeed)	0

Test Results by Category

Test Case	Status	Error Type	Native Time	Wasm Time	Output
Signal Tests
signal_resethand.c	Success	None	1.054021s	1.145289s	Success

wasm-networking harness

Test Report

Deterministic Tests

Summary

Metric	Count
Total Test Cases	44
Number of Successes	44
Number of Failures	0
Number of Compilation Failure Native	0
Number of Runtime Failure Native	0
Number of Segmentation Fault Native	0
Number of Timeout During Native	0
Number of Lind Wasm Compile Failure	0
Number of Lind Wasm Runtime Failure	0
Number of Lind Wasm Segmentation Failure	0
Number of Timeout During Lind Wasm run	0
Number of Unknown Failure	0
Number of C Compiler and Wasm Output mismatch	0
Number of Fail Test: Native Succeeded (Should Fail)	0
Number of Fail Test: Wasm Succeeded (Should Fail)	0
Number of Fail Test: Both Native and Wasm Succeeded (Should Fail)	0
Number of Fail Test: Native Compilation Failure (Should Succeed)	0
Number of Fail Test: Wasm Compilation Failure (Should Succeed)	0

Test Results by Category

Test Case	Status	Error Type	Native Time	Wasm Time	Output
Networking Tests
accept4.c	Success	None	0.060878s	0.141354s	Success
dns_resolve_test.c	Success	None	0.055312s	0.131468s	Success
dnstest.c	Success	None	0.055610s	0.126617s	Success
epoll_badfd.c	Success	None	0.052145s	0.115670s	Success
epoll_edge_triggered.c	Success	None	0.212402s	0.387489s	Success
epollcreate1.c	Success	None	0.055157s	0.137065s	Success
error_handling_net.c	Success	None	0.063808s	0.198849s	Success
getaddrinfo_test.c	Success	None	0.058544s	0.164242s	Success
getaddrinfo_unspec.c	Success	None	0.063493s	0.137404s	Success
gethostname.c	Success	None	0.050894s	0.116024s	Success
getifaddrs.c	Success	None	0.058190s	0.133138s	Success
getsockname.c	Success	None	0.057875s	0.132816s	Success
getsockopt.c	Success	None	0.057422s	0.164292s	Success
ipv6_basic.c	Success	None	0.059523s	0.163547s	Success
makepipe.c	Success	None	0.050444s	0.114698s	Success
nonblocking_eagain.c	Success	None	0.058706s	0.172984s	Success
pipe.c	Success	None	0.057519s	0.135509s	Success
pipe2.c	Success	None	0.058087s	0.126872s	Success
pipeinput.c	Success	None	0.058955s	0.163736s	Success
pipeinput2.c	Success	None	0.059077s	0.167945s	Success
pipeonestring.c	Success	None	0.059002s	0.162479s	Success
pipepong.c	Success	None	0.059037s	0.168248s	Success
pipewrite.c	Success	None	0.051967s	0.124884s	Success
poll.c	Success	None	0.055373s	0.121069s	Success
recvfrom-sendto.c	Success	None	0.056991s	0.137838s	Success
sendmsg_recvmsg_test.c	Success	None	0.057354s	0.137138s	Success
serverclient.c	Success	None	0.057379s	0.142877s	Success
shutdown.c	Success	None	0.057321s	0.139965s	Success
shutdown_fork.c	Success	None	0.057262s	0.154704s	Success
simple-select.c	Success	None	0.058940s	0.166732s	Success
simple_epoll.c	Success	None	0.055159s	0.133536s	Success
socket.c	Success	None	0.056328s	0.126925s	Success
socket_cloexec.c	Success	None	0.054593s	0.121222s	Success
socket_options_advanced.c	Success	None	0.060955s	0.179915s	Success
socketepoll.c	Success	None	0.053237s	0.124045s	Success
socketpair.c	Success	None	0.054992s	0.151532s	Success
socketselect.c	Success	None	0.056271s	0.129740s	Success
udp_send_recv.c	Success	None	0.162650s	0.285854s	Success
uds-getsockname.c	Success	None	0.055978s	0.124005s	Success
uds-nb-select.c	Success	None	2.063886s	2.204388s	Success
uds-serverclient.c	Success	None	0.060705s	0.170312s	Success
uds-socketselect.c	Success	None	0.057344s	0.132696s	Success
uds_listen_poll.c	Success	None	1.061831s	1.179789s	Success
writev_socket.c	Success	None	0.059709s	0.162403s	Success

Fail Tests

Summary

Metric	Count
Total Test Cases	0
Number of Successes	0
Number of Failures	0
Number of Compilation Failure Native	0
Number of Runtime Failure Native	0
Number of Segmentation Fault Native	0
Number of Timeout During Native	0
Number of Lind Wasm Compile Failure	0
Number of Lind Wasm Runtime Failure	0
Number of Lind Wasm Segmentation Failure	0
Number of Timeout During Lind Wasm run	0
Number of Unknown Failure	0
Number of C Compiler and Wasm Output mismatch	0
Number of Fail Test: Native Succeeded (Should Fail)	0
Number of Fail Test: Wasm Succeeded (Should Fail)	0
Number of Fail Test: Both Native and Wasm Succeeded (Should Fail)	0
Number of Fail Test: Native Compilation Failure (Should Succeed)	0
Number of Fail Test: Wasm Compilation Failure (Should Succeed)	0

wasm-dynamic-linking harness

Test Report

Deterministic Tests

Summary

Metric	Count
Total Test Cases	7
Number of Successes	7
Number of Failures	0
Number of Compilation Failure Native	0
Number of Runtime Failure Native	0
Number of Segmentation Fault Native	0
Number of Timeout During Native	0
Number of Lind Wasm Compile Failure	0
Number of Lind Wasm Runtime Failure	0
Number of Lind Wasm Segmentation Failure	0
Number of Timeout During Lind Wasm run	0
Number of Unknown Failure	0
Number of C Compiler and Wasm Output mismatch	0
Number of Fail Test: Native Succeeded (Should Fail)	0
Number of Fail Test: Wasm Succeeded (Should Fail)	0
Number of Fail Test: Both Native and Wasm Succeeded (Should Fail)	0
Number of Fail Test: Native Compilation Failure (Should Succeed)	0
Number of Fail Test: Wasm Compilation Failure (Should Succeed)	0

Test Results by Category

Test Case	Status	Error Type	Native Time	Wasm Time	Output
Dylink Tests
basic.c	Success	None	0.050677s	0.128614s	Success
dlopen_fork.c	Success	None	0.053304s	0.152515s	Success
dlopen_thread.c	Success	None	0.054556s	0.156504s	Success
double_fork_dlopen.c	Success	None	0.056928s	0.205264s	Success
fork_dlopen.c	Success	None	0.054538s	0.152046s	Success
longjmp_dlopen.c	Success	None	0.052256s	0.138961s	Success
rdynamic_main.c	Success	None	0.053264s	0.148788s	Success

Fail Tests

Summary

Metric	Count
Total Test Cases	1
Number of Successes	1
Number of Failures	0
Number of Compilation Failure Native	0
Number of Runtime Failure Native	0
Number of Segmentation Fault Native	0
Number of Timeout During Native	0
Number of Lind Wasm Compile Failure	0
Number of Lind Wasm Runtime Failure	0
Number of Lind Wasm Segmentation Failure	0
Number of Timeout During Lind Wasm run	0
Number of Unknown Failure	0
Number of C Compiler and Wasm Output mismatch	0
Number of Fail Test: Native Succeeded (Should Fail)	0
Number of Fail Test: Wasm Succeeded (Should Fail)	0
Number of Fail Test: Both Native and Wasm Succeeded (Should Fail)	0
Number of Fail Test: Native Compilation Failure (Should Succeed)	0
Number of Fail Test: Wasm Compilation Failure (Should Succeed)	0

Test Results by Category

Test Case	Status	Error Type	Native Time	Wasm Time	Output
Dylink Tests
dlerror.c	Success	None	0.046686s	0.121450s	Success

Blzzxrd

Looks good to me

Add instructions on grate api usage and how to create grate examples

b8d6a09

Yaxuan-w requested review from Blzzxrd, lionne99 and vidyalakshmir August 12, 2026 18:43

Yaxuan-w requested a review from rishabhBudhouliya August 13, 2026 04:14

Blzzxrd reviewed Aug 13, 2026

View reviewed changes

Blzzxrd approved these changes Aug 13, 2026

View reviewed changes

Yaxuan-w merged commit 40ed9aa into main Aug 16, 2026
5 checks passed

Yaxuan-w deleted the add-grate-api-doc branch August 16, 2026 19:28

Conversation

Yaxuan-w commented Aug 12, 2026

Summary

Related issues

Testing

Compatibility and security impact

Checklist

Uh oh!

github-actions Bot commented Aug 12, 2026

End-to-End Test Report

Grate Test Report

Cases

Test Report

Deterministic Tests

Summary

Test Results by Category

Fail Tests

Summary

Test Report

Deterministic Tests

Summary

Test Results by Category

Fail Tests

Summary

Test Report

Deterministic Tests

Summary

Test Results by Category

Fail Tests

Summary

Test Report

Deterministic Tests

Summary

Test Results by Category

Fail Tests

Summary

Test Results by Category

Test Report

Deterministic Tests

Summary

Test Results by Category

Fail Tests

Summary

Test Report

Deterministic Tests

Summary

Test Results by Category

Fail Tests

Summary

Test Results by Category

Test Report

Deterministic Tests

Summary

Test Results by Category

Fail Tests

Summary

Test Report

Deterministic Tests

Summary

Test Results by Category

Fail Tests

Summary

Test Results by Category

Uh oh!

Blzzxrd left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants