All lessons · Rust scripts and ckb-std · Start here · Glossary
Close spawn pipe descriptors when an IPC channel is freedWorkingFrom one fix
From one fix · Check: right · Checked 2026-11-19
A pipe fd created by ckb_pipe or inherited through spawn stays live until ckb_close is called on it, and the VM limits how many descriptors can be live at once. Code that creates channels repeatedly must therefore close both pipe ends when finished. In ckb-script-ipc, csi_free_channel did not close them before PR #32; it now closes the library-owned pipe fds, and the peer's ckb_read then returns CKB_OTHER_END_CLOSED.
Why it matters: Without closing, a script that repeatedly opens channels leaks pipe descriptors and hits the VM's descriptor limit (the test cycles 160 fds with only four live), so later ckb_pipe calls fail.
A test changed in the same commit
It sits next to the fix. We did not run it.
- XuJiandong/ckb-script-ipc:
c/tests/client.c,c/tests/regression.c,c/tests/server.c,crates/ckb-script-ipc/tests/generate.rs,tests/src/tests_c_impl.rs
- Concepts
- Other
- Evidence
- From one fix: from one project, checked against its commit
- First seen
- 2026-11-09
- Last changed
- 2026-11-09
- Last checked
- 2026-11-19
- Check against the commit
- right: the lesson follows from its commit and still holds in the code today
Sources (1)
- 2026-11-09 · XuJiandong/ckb-script-ipc · more from this project
More about Rust scripts and ckb-std
- Enable molecule bytes_vec so ckb-std scripts contain no atomic instructions
- CKB VM2 READ and INHERITED_FDS syscalls take a length pointer and return status in a0
- Disable overflow checks for ckb-std when using its dummy-atomic polyfills
Do you maintain a project this lesson came from? Confirm or correct it
Cite this lesson
LusoCryptoLabs, "Close spawn pipe descriptors when an IPC channel is freed", CKB lessons, https://pulse.lusocryptolabs.com/learned/scripts/close-spawn-pipe-descriptors-when-an-ipc-channel-is-freed, CC BY 4.0, last changed 2026-11-09.