Skip to content

sockets: Update documentation#884

Open
badeend wants to merge 3 commits intomainfrom
bind-always-reuseaddr
Open

sockets: Update documentation#884
badeend wants to merge 3 commits intomainfrom
bind-always-reuseaddr

Conversation

@badeend
Copy link
Member

@badeend badeend commented Feb 15, 2026

Update sockets documentation:

@badeend badeend requested a review from a team as a code owner February 15, 2026 09:13
@github-actions github-actions bot added the P-sockets Proposal: wasi-sockets label Feb 15, 2026
@badeend badeend enabled auto-merge February 15, 2026 09:13
- Limit the prose to about 80 characters per line.
- Describe POSIX equivalents of the error codes.
- Removed outdated `stream` info from:
    - `resolve-addresses`
    - `tcp-socket::receive`
- Describe shared ownership semantics of sockets and their streams/futures as we landed on in #870
- Capture the "lessons learned" so far:
    - TCP & UDP `connect` may update the socket's local address. See bytecodealliance/wasmtime#12589
    - TCP `bind` should always set SO_REUSEADDR. See bytecodealliance/wasmtime#12402
    - send/receive buffer sizes may be dynamically adjusted by the OS. See bytecodealliance/wasmtime#12561
    - Windows does not perform an implicit bind on UDP `send`.
@badeend badeend force-pushed the bind-always-reuseaddr branch from f301996 to a71263a Compare February 24, 2026 21:40
@badeend badeend changed the title tcp-socket::bind: Drop the "When binding to a non-zero port" condition sockets: Update documentation Feb 24, 2026
badeend and others added 2 commits February 25, 2026 19:42
Co-authored-by: Bailey Hayes <ricochet@users.noreply.github.com>
Co-authored-by: Bailey Hayes <ricochet@users.noreply.github.com>
@badeend
Copy link
Member Author

badeend commented Feb 25, 2026

@ricochet Thanks for the textual improvements. I've accepted them all.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

P-sockets Proposal: wasi-sockets

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants