doc: add missing flags to lind_compile usage

[qianxichen233]

closes #1022

Document -s/--static, --compile-library, and --fpcast-emu in the usage() help text, and expand --compile-grate's description to note its backend compatibility. Add a backend section explaining the three compilation modes (dynamic, static, library) and their mode compatibility.

[github-actions]

End-to-End Test Report

Test Preview

Unified Test Report

grate harness

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

Cases

Test	Status	Error Type	Output
concurrent-request/geteuid_grate.c	Success		STDOUT: [Grate|geteuid] Registering geteuid handler for cage 2 in grate 1 with fn ptr addr: 2 [Cage | geteuid] PASS: 1000000 calls returned 10 [Grate|geteuid] 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: 2 [Grate|interpose-exec] Handling function ptr: 2 from cage: 1 [Grate|interpose-exec] In exec_grate 1 handler for cage: 1 [Grate|interpose-exec] Handling function ptr: 2 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: 2 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: 2 [Grate|interpose-fork] Handling function ptr: 2 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: 2 [Grate|interpose-mmap] Handling function ptr: 2 from cage: 1 [Grate|interpose-mmap] In mmap_grate 1 handler for cage: 1 [Grate|interpose-mmap] Handling function ptr: 2 from cage: 1 [Grate|interpose-mmap] In mmap_grate 1 handler for cage: 1 [Grate|interpose-mmap] Handling function ptr: 2 from cage: 1 [Grate|interpose-mmap] In mmap_grate 1 handler for cage: 1 [Grate|interpose-mmap] Handling function ptr: 2 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: 3 [cage] registering 107. grateid: 2 cageid: 3 [Grate|interpose-register] Handling function ptr: 3 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: 2 [Grate|interpose-register] Handling function ptr: 2 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: 2 [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: 2 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:
race-test_grate.c	Success		STDOUT: pass STDERR:
simple-tests/cpdata_grate.c	Success		STDOUT: [Grate|open] intercepts open call: thiscage=1, arg1cage=2 [Grate|open] copied pathname: random [cage] fd=10 STDERR:
simple-tests/diff-cage-args_grate.c	Success		STDOUT: [Grate|diff-cage-args] Handling function ptr: 2 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: 3 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: 2 [Grate|geteuid] Handling function ptr: 2 from cage: 1 [Grate|geteuid] In geteuid_grate 1 handler for cage: 1 [Cage | geteuid] PASS: geteuid ret = 10 [Grate|geteuid] PASS STDERR:

wasm harness

Test Report

Deterministic Tests

Summary

Metric	Count
Total Test Cases	198
Number of Successes	198
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.046905s	0.189667s	Success
chdir_getcwd.c	Success	None	0.048122s	0.152004s	Success
chmod.c	Success	None	0.053333s	0.160050s	Success
clock_gettime_highlevel.c	Success	None	0.119624s	0.326922s	Success
clock_gettime_simple.c	Success	None	0.042887s	0.139995s	Success
cloexec.c	Success	None	0.051201s	0.214931s	Success
close.c	Success	None	0.058400s	0.176677s	Success
creat_access.c	Success	None	0.051038s	0.145046s	Success
doubleclose.c	Success	None	0.045584s	0.138493s	Success
dup.c	Success	None	0.042812s	0.146192s	Success
dup2.c	Success	None	0.050083s	0.148266s	Success
dup3.c	Success	None	0.046484s	0.152016s	Success
dupwrite.c	Success	None	0.051098s	0.149636s	Success
etc_conf.c	Success	None	0.044225s	0.151049s	Success
fchdir.c	Success	None	0.052718s	0.160529s	Success
fchmod.c	Success	None	0.054001s	0.161000s	Success
fcntl.c	Success	None	0.049026s	0.154751s	Success
fdatasync.c	Success	None	0.049994s	0.140806s	Success
filetest.c	Success	None	0.048269s	0.138320s	Success
filetest1000.c	Success	None	0.057641s	0.159306s	Success
flock.c	Success	None	0.066100s	0.192617s	Success
fstat.c	Success	None	0.051821s	0.157106s	Success
fstatfs.c	Success	None	0.049829s	0.143249s	Success
fsync.c	Success	None	0.049263s	0.141647s	Success
ftruncate.c	Success	None	0.053086s	0.264313s	Success
getcwd.c	Success	None	0.045814s	0.138416s	Success
getrandom.c	Success	None	0.049914s	0.146303s	Success
ioctl.c	Success	None	0.051682s	0.147637s	Success
link.c	Success	None	0.055480s	0.216010s	Success
locale_test.c	Success	None	0.064019s	0.637626s	Success
lseek.c	Success	None	0.054081s	0.267879s	Success
mkdir_rmdir.c	Success	None	0.050395s	0.152934s	Success
mkfifo_test.c	Success	None	0.055938s	0.199731s	Success
mknod.c	Success	None	0.051020s	0.162907s	Success
nocancel_io.c	Success	None	0.052845s	0.176901s	Success
open.c	Success	None	0.048046s	0.139296s	Success
openat.c	Success	None	0.045600s	0.144407s	Success
path_conversion_safety.c	Success	None	0.053619s	0.175187s	Success
pread_pwrite.c	Success	None	0.046755s	0.156675s	Success
printf.c	Success	None	0.041044s	0.126415s	Success
prlimit64.c	Success	None	0.043258s	0.128307s	Success
read.c	Success	None	0.049704s	0.150264s	Success
readbytes.c	Success	None	0.046175s	0.135845s	Success
readdir_basic.c	Success	None	0.054705s	0.168029s	Success
readlink.c	Success	None	0.049683s	0.149013s	Success
readlinkat.c	Success	None	0.050702s	0.157052s	Success
readv_writev_test.c	Success	None	0.054962s	0.170357s	Success
rename.c	Success	None	0.051758s	0.147440s	Success
sc-writev.c	Success	None	0.048729s	0.151683s	Success
stat.c	Success	None	0.050885s	0.156711s	Success
statfs.c	Success	None	0.043597s	0.141039s	Success
sync_file_range.c	Success	None	0.048751s	0.144471s	Success
timespec_time_t_compat.c	Success	None	0.046812s	0.136881s	Success
truncate.c	Success	None	0.052662s	0.170215s	Success
unlink.c	Success	None	0.053309s	0.198120s	Success
unlinkat.c	Success	None	0.053307s	0.175516s	Success
write.c	Success	None	0.044891s	0.140401s	Success
writeloop.c	Success	None	0.054707s	0.143827s	Success
writepartial.c	Success	None	0.052899s	0.138356s	Success
writev.c	Success	None	0.050729s	0.155022s	Success
Math Tests
math_link_smoke.c	Success	None	0.053897s	0.139157s	Success
math_tests.c	Success	None	0.060664s	0.171219s	Success
Memory Tests
brk.c	Success	None	0.047345s	0.140738s	Success
fork_large_memory.c	Success	None	0.078762s	0.406632s	Success
malloc.c	Success	None	0.047679s	0.127130s	Success
malloc_large.c	Success	None	0.046594s	0.134166s	Success
memcpy.c	Success	None	0.044280s	0.131439s	Success
memory_error_test.c	Success	None	0.051489s	0.173536s	Success
mmap.c	Success	None	0.043703s	0.133733s	Success
mmap_aligned.c	Success	None	0.044318s	0.150581s	Success
mmap_complicated.c	Success	None	0.050907s	0.157832s	Success
mmap_file.c	Success	None	0.051234s	0.151245s	Success
mmap_shared.c	Success	None	0.050272s	0.155536s	Success
mmaptest.c	Success	None	0.049959s	0.146041s	Success
mprotect.c	Success	None	0.043843s	0.133535s	Success
mprotect_boundary.c	Success	None	0.043963s	0.150670s	Success
mprotect_end_region.c	Success	None	0.042729s	0.138652s	Success
mprotect_middle_region.c	Success	None	0.044636s	0.143759s	Success
mprotect_multiple_times.c	Success	None	0.042852s	0.146054s	Success
mprotect_same_value.c	Success	None	0.043383s	0.139237s	Success
mprotect_spanning_regions.c	Success	None	0.044968s	0.159167s	Success
sbrk.c	Success	None	0.045753s	0.131828s	Success
segfault.c	Success	None	0.053685s	0.168294s	Success
shm.c	Success	None	0.050339s	0.160196s	Success
shmtest.c	Success	None	0.045927s	0.137567s	Success
thread_malloc_sequential.c	Success	None	0.050618s	0.165811s	Success
vtable.c	Success	None	0.055198s	0.158665s	Success
Networking Tests
accept4.c	Success	None	0.057153s	0.170175s	Success
dns_resolve_test.c	Success	None	0.049388s	0.147378s	Success
dnstest.c	Success	None	0.051118s	0.159827s	Success
epoll_edge_triggered.c	Success	None	0.209071s	0.505475s	Success
epollcreate1.c	Success	None	0.052094s	0.159367s	Success
error_handling_net.c	Success	None	0.059198s	0.270367s	Success
getaddrinfo_test.c	Success	None	0.054615s	0.197872s	Success
getaddrinfo_unspec.c	Success	None	0.055231s	0.162049s	Success
gethostname.c	Success	None	0.043994s	0.132292s	Success
getifaddrs.c	Success	None	0.053099s	0.156979s	Success
getsockname.c	Success	None	0.056136s	0.152299s	Success
getsockopt.c	Success	None	0.055092s	0.207972s	Success
ipv6_basic.c	Success	None	0.056285s	0.210866s	Success
makepipe.c	Success	None	0.044098s	0.129983s	Success
nonblocking_eagain.c	Success	None	0.056349s	0.217498s	Success
pipe.c	Success	None	0.055330s	0.161199s	Success
pipe2.c	Success	None	0.056904s	0.150069s	Success
pipeinput.c	Success	None	0.055835s	0.175812s	Success
pipeinput2.c	Success	None	0.055071s	0.172909s	Success
pipeonestring.c	Success	None	0.054530s	0.173438s	Success
pipepong.c	Success	None	0.055356s	0.184442s	Success
pipewrite.c	Success	None	0.046938s	0.151948s	Success
poll.c	Success	None	0.051798s	0.143933s	Success
recvfrom-sendto.c	Success	None	0.053207s	0.164123s	Success
sendmsg_recvmsg_test.c	Success	None	0.052055s	0.159311s	Success
serverclient.c	Success	None	0.051508s	0.156745s	Success
shutdown.c	Success	None	0.055482s	0.159962s	Success
shutdown_fork.c	Success	None	0.052878s	0.158829s	Success
simple-select.c	Success	None	0.053519s	0.175922s	Success
simple_epoll.c	Success	None	0.053685s	0.158798s	Success
socket.c	Success	None	0.051051s	0.148290s	Success
socket_cloexec.c	Success	None	0.050828s	0.146047s	Success
socket_options_advanced.c	Success	None	0.058164s	0.224320s	Success
socketepoll.c	Success	None	0.051340s	0.149141s	Success
socketpair.c	Success	None	0.050504s	0.156321s	Success
socketselect.c	Success	None	0.051179s	0.151006s	Success
udp_send_recv.c	Success	None	0.158182s	0.324837s	Success
uds-getsockname.c	Success	None	0.052090s	0.146445s	Success
uds-nb-select.c	Success	None	2.060402s	2.223182s	Success
uds-serverclient.c	Success	None	0.057119s	0.189969s	Success
uds-socketselect.c	Success	None	0.052379s	0.155472s	Success
writev_socket.c	Success	None	0.055488s	0.194724s	Success
Process Tests
barrier_test.c	Success	None	0.052722s	0.170816s	Success
chain_thread.c	Success	None	1.051505s	1.156382s	Success
ctor_syscall_test.c	Success	None	0.041795s	0.132194s	Success
cxa_atexit_test.c	Success	None	0.047629s	0.137015s	Success
execve_shebang.c	Success	None	0.051573s	0.148552s	Success
exit.c	Success	None	0.049550s	0.138718s	Success
exit_failure.c	Success	None	0.051125s	0.150409s	Success
exit_group_thread.c	Success	None	0.053192s	0.162169s	Success
flockfile_test.c	Success	None	0.050665s	0.169544s	Success
fork2malloc.c	Success	None	0.053518s	0.153838s	Success
fork_select.c	Success	None	0.050410s	0.164993s	Success
fork_simple.c	Success	None	0.049083s	0.146151s	Success
fork_syscall.c	Success	None	0.059333s	0.309556s	Success
fork_tls_ctype.c	Success	None	0.056588s	0.185135s	Success
forkandopen.c	Success	None	0.054538s	0.177070s	Success
forkdup.c	Success	None	0.054625s	0.166392s	Success
forkexecuid.c	Success	None	0.049826s	0.225884s	Success
forkexecv-arg.c	Success	None	0.050848s	0.206060s	Success
forkexecv.c	Success	None	0.047771s	0.201038s	Success
forkfiles.c	Success	None	0.053386s	0.166568s	Success
forkmalloc.c	Success	None	0.063172s	0.155041s	Success
forknodup.c	Success	None	0.054895s	0.172158s	Success
function-ptr.c	Success	None	0.047620s	0.138471s	Success
getegid_syscall.c	Success	None	0.052197s	0.299356s	Success
getgid_syscall.c	Success	None	0.051886s	0.292874s	Success
getpid.c	Success	None	0.044832s	0.130910s	Success
getpid_syscall.c	Success	None	0.053375s	0.326332s	Success
getppid.c	Success	None	0.051951s	0.153156s	Success
getppid_syscall.c	Success	None	0.054806s	0.270897s	Success
getuid.c	Success	None	0.051955s	0.145591s	Success
getuid_syscall.c	Success	None	0.049814s	0.193089s	Success
hello-arg.c	Success	None	0.041223s	0.132286s	Success
hello.c	Success	None	0.044308s	0.135451s	Success
longjmp.c	Success	None	0.043579s	0.137250s	Success
mutex.c	Success	None	2.054875s	2.163243s	Success
printf_deadlock_smoke.c	Success	None	0.060020s	0.196508s	Success
printf_thread_test.c	Success	None	0.049691s	0.166504s	Success
sem_forks.c	Success	None	0.054577s	0.173574s	Success
setsid.c	Success	None	0.043954s	0.133398s	Success
template.c	Success	None	0.052475s	0.170069s	Success
test_exec_nofork.c	Success	None	0.049511s	0.197297s	Success
test_unlink_open_file.c	Success	None	0.046130s	0.131478s	Success
thread-test.c	Success	None	0.046335s	0.141715s	Success
thread.c	Success	None	0.045703s	0.137239s	Success
thread_cageid_race.c	Success	None	0.047604s	0.198360s	Success
tls_test.c	Success	None	0.048495s	0.161623s	Success
uname.c	Success	None	0.045070s	0.142127s	Success
wait.c	Success	None	2.047790s	2.151081s	Success
waitpid_anychild.c	Success	None	0.051595s	0.154956s	Success
waitpid_syscall.c	Success	None	1.050736s	1.200102s	Success
waitpid_wnohang.c	Success	None	0.051518s	0.150836s	Success
Signal Tests
alarm.c	Success	None	7.051084s	7.171199s	Success
eintr_fork_signal.c	Success	None	1.056110s	1.172812s	Success
kill.c	Success	None	1.050215s	1.152547s	Success
setitimer.c	Success	None	7.052251s	7.174644s	Success
sigalrm.c	Success	None	2.050820s	2.161197s	Success
sigaltstack.c	Success	None	0.052093s	0.160085s	Success
sigchld.c	Success	None	1.055269s	1.156688s	Success
signal-fork.c	Success	None	4.054442s	4.160718s	Success
signal-simple.c	Success	None	0.054384s	0.147589s	Success
signal_SIGCHLD.c	Success	None	0.051102s	0.161372s	Success
signal_fork.c	Success	None	0.047745s	0.162156s	Success
signal_int_ignored.c	Success	None	2.051468s	2.157488s	Success
signal_kill_cleanup.c	Success	None	1.049846s	1.151980s	Success
signal_procmask.c	Success	None	0.046529s	0.154547s	Success
signal_recursive.c	Success	None	0.045250s	0.146032s	Success
signal_sa_mask.c	Success	None	0.047566s	0.145044s	Success
sigpipe.c	Success	None	1.056936s	1.175433s	Success
sigprocmask.c	Success	None	1.050424s	1.153145s	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
Dylink Tests
dlerror.c	Success	None	0.041998s	0.133067s	Success
Memory Tests
mmap-negative1.c	Success	None	0.121610s	0.140048s	Success
mmap-negative2.c	Success	None	0.111782s	0.165716s	Success
Signal Tests
signal_resethand.c	Success	None	1.050449s	1.155272s	Success