Johnathan Corgan d7f079618f Document that an empty datagram sent just before a close reads as the close on Linux ...

The native API's receive rule cannot tell a zero-length datagram that is
the last message before a close from the close itself on SOCK_SEQPACKET,
which Linux uses: reading it drains the queue, and every observation
then matches a bare end of file. macOS and FreeBSD carry the flow on
SOCK_DGRAM, where the empty datagram is delivered and the close is
reported by the read after it.

The doc comment on Received::Datagram said an empty datagram is never a
close, which contradicted the limitation stated a few hundred lines
below it. It now says where the exception applies, and the recv_once
rationale, the FipsStream::recv rustdoc, the native API reference and
the client how-to scope the limitation to Linux. The reference page's
list of places where data disappears gains the send-side consequence:
a program that sends an empty datagram and then drops its stream may
have the daemon read it as the close, so it never reaches the peer. The
datagram how-to, which counts those places, is updated to match.

A new test pins the behaviour per socket type, branching on the
module's socket-type constant rather than on the OS, so the
documentation and the test cannot drift apart.

2026-09-27 19:35:11 +00:00

..

client

Document that an empty datagram sent just before a close reads as the close on Linux

2026-09-27 19:35:11 +00:00

dgram_probe.rs

Record what the FreeBSD run measured, since the comments said it was unmeasured

2026-08-22 13:42:28 +01:00

fdpass.rs

Build the native datagram API on macOS, over SOCK_DGRAM

2026-08-21 05:48:39 +00:00

link.rs

Add an experimental native datagram API addressed by public key

2026-08-21 05:48:23 +00:00

mod.rs

Stop using SOCK_SEQPACKET on FreeBSD, which is not a record socket there

2026-08-22 12:55:52 +01:00

protocol.rs

Add an experimental native datagram API addressed by public key

2026-08-21 05:48:23 +00:00

registry.rs

Add an experimental native datagram API addressed by public key

2026-08-21 05:48:23 +00:00

seqpacket.rs

Document that an empty datagram sent just before a close reads as the close on Linux

2026-09-27 19:35:11 +00:00