resolve comments

Author: celinehoang177

Docker/Dockerfile.e2e

@@ -105,7 +105,7 @@ RUN rustup component add rust-src --toolchain nightly-2026-02-11-x86_64-unknown-
 # Build lind-boot
 FROM base as build-lind-boot
 # NOTE: Using 'make' risks cache invalidation on unrelated Makefile changes
-COPY --parents src/lind-boot src/wasmtime src/rawposix src/cage src/threei src/typemap src/fdtables src/sysdefs Makefile rust-toolchain.toml .
+COPY --parents src/lind-boot src/wasmtime src/rawposix src/cage src/threei src/typemap src/fdtables src/sysdefs src/glibc scripts Makefile rust-toolchain.toml .
 RUN rm -f src/wasmtime/crates/cage \
     src/wasmtime/crates/threei \
     src/wasmtime/crates/fdtables \
@@ -126,7 +126,7 @@ FROM base AS build-glibc
 # NOTE: Using 'make' risks cache invalidation on unrelated Makefile changes
 COPY scripts ./scripts
 COPY tools ./tools
-COPY --parents src/glibc Makefile .
+COPY --parents src/glibc src/sysdefs Makefile .
 COPY --from=build-lind-boot --parents build/lind-boot .
 RUN make sysroot \
  && test -f lindfs/lib/libc.cwasm \

Makefile

@@ -29,12 +29,12 @@ build: generate-syscall-mappings lindfs lind-boot sysroot
 all: build
 
 .PHONY: sysroot
-sysroot: build-dir
+sysroot: build-dir generate-syscall-mappings
 	./scripts/make_glibc_and_sysroot.sh $(if $(WITH_FPCAST),--with-fpcast)
 	$(MAKE) sync-sysroot
 
 .PHONY: lind-boot
-lind-boot: build-dir
+lind-boot: build-dir generate-syscall-mappings
 	# Build lind-boot with `--release` flag for faster runtime (e.g. for tests)
 	cargo build --manifest-path src/lind-boot/Cargo.toml --release
 	cp src/lind-boot/target/release/lind-boot $(LINDBOOT_BIN)
@@ -50,14 +50,15 @@ lindfs:
 	cp -rT scripts/lindfs-conf/usr/share/zoneinfo $(LINDFS_ROOT)/usr/share/zoneinfo
 
 .PHONY: lind-debug
-lind-debug: lindfs build-dir
+lind-debug: lindfs build-dir generate-syscall-mappings
 	# Build lind-boot with the lind_debug feature enabled
 	cargo build --manifest-path src/lind-boot/Cargo.toml --features lind_debug
 	cp src/lind-boot/target/debug/lind-boot $(LINDBOOT_BIN)
 
 	# Build glibc with LIND_DEBUG enabled (by setting the LIND_DEBUG variable)
 	$(MAKE) build_glibc LIND_DEBUG=1
-build_glibc:
+
+build_glibc: generate-syscall-mappings
 	# build sysroot passing -DLIND_DEBUG if LIND_DEBUG is set
 	if [ "$(LIND_DEBUG)" = "1" ]; then \
 		echo "Building glibc with LIND_DEBUG enabled"; \

docs/contribute/testing.md

@@ -34,6 +34,7 @@ docker run --platform=linux/amd64 -v $(PWD):/lind -w /lind -it dev /bin/bash
 5. Build toolchain (glibc and wasmtime)
 ```
 # this may take a while ...
+make generate-syscall-mappings
 make lind-boot sysroot
 ```
 6. Run the test suite 

docs/contribute/toolchain.md

@@ -38,8 +38,7 @@ options.
 3. __Generate syscall mappings__ (see [`make generate-syscall-mappings`](https://github.com/Lind-Project/lind-wasm/blob/main/Makefile))
 
     Auto-generates syscall mapping constants from `src/glibc/lind_syscall/lind_syscall_num.h` 
-    and produces `src/sysdefs/src/constants/syscall_const.rs`. This must run before building *glibc* 
-    and *wasmtime* to ensure Rust code has the correct syscall definitions.
+    and produces `src/sysdefs/src/constants/syscall_const.rs`. This must run before building *lind-boot*, *glibc* and *wasmtime* to ensure Rust code has the correct syscall definitions.
 
     ```bash
     python3 scripts/generate_syscall_mappings.py
@@ -63,10 +62,10 @@ options.
         along with headers and a pre-built C runtime into a
         sysroot directory structure as required by *Clang*.
 
-5. __Build custom wasmtime__ (see [`make wasmtime`](https://github.com/Lind-Project/lind-wasm/blob/main/Makefile))
+5. __Build lind-boot__ (see [`make lind-boot`](https://github.com/Lind-Project/lind-wasm/blob/main/Makefile))
 
-      Builds `src/wasmtime` workspace. Custom dependencies `fdtables`, `RawPOSIX`
-      and `sysdefs` are included in the build automatically.
+      Builds `src/lind-boot` workspace, which provides the *WebAssembly* runtime (`wasmtime`).
+      Custom dependencies `fdtables`, `RawPOSIX` and `sysdefs` are included in the build automatically.
 
 
 A customized `wasm-opt` binary is included in the *lind-wasm* repo under

docs/getting-started.md

@@ -38,9 +38,9 @@ EOF
 
 Lind-wasm runtime must be compiled before running the program. To compile the lind-wasm runtime, you will first go to the `lind-wasm/` directory. At there, you can choose:
 
-3.a. use `make all` to compile both lind-glibc and rust code at once.
+3.a. use `make all` to compile both lind-glibc and rust code at once. (this automatically generates syscall mappings)
 
-3.b. use `make lind-boot` to compile runtime(lind-boot/wasmtime/rawposix/3i/etc.), and `make sysroot` to compile lind-glibc.
+3.b. use `make generate-syscall-mappings` to auto-generate system call constants. Then use `make lind-boot` to compile runtime(lind-boot/wasmtime/rawposix/3i/etc.), and `make sysroot` to compile lind-glibc.
 
 **NOTES: More options can be found in lind-wasm/Makefile**
 

scripts/generate_syscall_mappings.py

@@ -45,6 +45,11 @@ def generate_rust_constants(syscalls: dict[str, int]) -> str:
     lines = [
         "//! Syscall number constants for the Lind platform.",
         "//!",
+        "//! Includes both standard Linux x86_64 syscalls and Lind-specific extensions:",
+        "//!   - REGISTER_HANDLER_SYSCALL (1001)",
+        "//!   - COPY_DATA_BETWEEN_CAGES_SYSCALL (1002)",
+        "//!   - COPY_HANDLER_TABLE_TO_CAGE_SYSCALL (1003)",
+        "//!",
         "//! Source of truth: Linux x86_64 syscall table",
         "//!   https://github.com/torvalds/linux/blob/v6.16-rc1/arch/x86/entry/syscalls/syscall_64.tbl",
         "//! (Historical overview: https://filippo.io/linux-syscall-table/)",

src/glibc/lind_syscall/lind_syscall_num.h

@@ -16,8 +16,8 @@
 #define WRITE_SYSCALL 1
 #define OPEN_SYSCALL 2
 #define CLOSE_SYSCALL 3
-#define XSTAT_SYSCALL 4
-#define FXSTAT_SYSCALL 5
+#define STAT_SYSCALL 4
+#define FSTAT_SYSCALL 5
 #define LSTAT_SYSCALL 6
 
 #define POLL_SYSCALL 7
@@ -46,7 +46,7 @@
 #define DUP_SYSCALL 32
 #define DUP2_SYSCALL 33
 
-#define NANOSLEEP_TIME64_SYSCALL 35
+#define NANOSLEEP_SYSCALL 35
 
 #define SETITIMER_SYSCALL 38
 #define GETPID_SYSCALL 39
@@ -69,7 +69,6 @@
 #define CLONE_SYSCALL 56
 #define FORK_SYSCALL 57
 #define EXEC_SYSCALL 59
-#define EXECVE_SYSCALL 59
 #define EXIT_SYSCALL 60
 #define EXIT_GROUP_SYSCALL 231
 #define WAITPID_SYSCALL 61
@@ -119,7 +118,7 @@
 #define SYMLINKAT_SYSCALL 266
 #define READLINKAT_SYSCALL 267
 #define PPOLL_SYSCALL 271
-#define SYNC_FILE_RANGE 277
+#define SYNC_FILE_RANGE_SYSCALL 277
 #define ACCEPT4_SYSCALL 288
 #define EPOLL_CREATE1_SYSCALL 291
 #define DUP3_SYSCALL 292

src/glibc/sysdeps/unix/sysv/linux/i386/execve.c

@@ -44,7 +44,7 @@ int __execve (const char *__path, char *const __argv[], char *const __envp[])
   uint64_t host_argv_ptr = TRANSLATE_GUEST_POINTER_TO_HOST(host_argv);
   uint64_t host_envp_ptr = TRANSLATE_GUEST_POINTER_TO_HOST(host_envp);
 
-  return MAKE_LEGACY_SYSCALL(EXECVE_SYSCALL, "syscall|execve", host_path, host_argv_ptr, host_envp_ptr, NOTUSED, NOTUSED, NOTUSED, TRANSLATE_ERRNO_ON);
+  return MAKE_LEGACY_SYSCALL(EXEC_SYSCALL, "syscall|execve", host_path, host_argv_ptr, host_envp_ptr, NOTUSED, NOTUSED, NOTUSED, TRANSLATE_ERRNO_ON);
 }
 strong_alias (__execve, execve)
 libc_hidden_def (__execve)

src/sysdefs/src/constants/syscall_const.rs

@@ -1,5 +1,10 @@
 //! Syscall number constants for the Lind platform.
 //!
+//! Includes both standard Linux x86_64 syscalls and Lind-specific extensions:
+//!   - REGISTER_HANDLER_SYSCALL (1001)
+//!   - COPY_DATA_BETWEEN_CAGES_SYSCALL (1002)
+//!   - COPY_HANDLER_TABLE_TO_CAGE_SYSCALL (1003)
+//!
 //! Source of truth: Linux x86_64 syscall table
 //!   https://github.com/torvalds/linux/blob/v6.16-rc1/arch/x86/entry/syscalls/syscall_64.tbl
 //! (Historical overview: https://filippo.io/linux-syscall-table/)
@@ -91,8 +96,8 @@ pub const FSTATFS_SYSCALL: i32 = 138;
 pub const GETHOSTNAME_SYSCALL: i32 = 170;
 pub const FUTEX_SYSCALL: i32 = 202;
 pub const EPOLL_CREATE_SYSCALL: i32 = 213;
-pub const EXIT_GROUP_SYSCALL: i32 = 231;
 pub const CLOCK_GETTIME_SYSCALL: i32 = 228;
+pub const EXIT_GROUP_SYSCALL: i32 = 231;
 pub const EPOLL_WAIT_SYSCALL: i32 = 232;
 pub const EPOLL_CTL_SYSCALL: i32 = 233;
 pub const OPENAT_SYSCALL: i32 = 257;
@@ -102,10 +107,13 @@ pub const READLINKAT_SYSCALL: i32 = 267;
 pub const PPOLL_SYSCALL: i32 = 271;
 pub const SYNC_FILE_RANGE_SYSCALL: i32 = 277;
 pub const ACCEPT4_SYSCALL: i32 = 288;
-pub const PREADV_SYSCALL: i32 = 295;
-pub const PWRITEV_SYSCALL: i32 = 296;
-pub const PRLIMIT64_SYSCALL: i32 = 302;
 pub const EPOLL_CREATE1_SYSCALL: i32 = 291;
 pub const DUP3_SYSCALL: i32 = 292;
 pub const PIPE2_SYSCALL: i32 = 293;
+pub const PREADV_SYSCALL: i32 = 295;
+pub const PWRITEV_SYSCALL: i32 = 296;
+pub const PRLIMIT64_SYSCALL: i32 = 302;
 pub const GETRANDOM_SYSCALL: i32 = 318;
+pub const REGISTER_HANDLER_SYSCALL: i32 = 1001;
+pub const COPY_DATA_BETWEEN_CAGES_SYSCALL: i32 = 1002;
+pub const COPY_HANDLER_TABLE_TO_CAGE_SYSCALL: i32 = 1003;