WebAssembly / WebAssembly/WASI
Document that set_fd_flags can't set most flags
Nobody has claimed this yet.
- Dominant language
- Rust
- Stars
- 5.8k
- Forks
- 333
- Avg merge
- 2d 13h
- Merged PRs (30d)
- 3
Description
Many OS's don't support changing most of the descriptor flags on an open descriptor. The two flags WASI has that do seem like they might be portable to allow setting are append and nonblock (though of course nonblock is not implemented for files in most situations anyway).
We should at least document this.
And perhaps we should even remove set-fd-flags and replace it with just set-append and set-nonblock which operate on individual flags.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Locate the WASI documentation for set-fd-flags and read its current flag semantics. Document that most descriptor flags cannot be changed on open descriptors, including the append and nonblock context; treat replacing the API with set-append and set-nonblock as a separate design question.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- wasm
- Domain
- documentation, operating-systems
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100