This is an automated email from the ASF dual-hosted git repository.

GUIDINGLI pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/nuttx.git

commit 9a901103b9723a0732da7baafc51de75cad42635
Author: Marco Casaroli <[email protected]>
AuthorDate: Wed Nov 18 19:42:11 2026 +0100

    Documentation/os/networking: Describe what a reset of the peer gives.
    
    The TCP state machine page: what the application gets after a RST of
    the peer (connect(), receive, send, SO_ERROR and poll()).
    
    Assisted-by: Claude Code:claude-opus-5-5
    Signed-off-by: Marco Casaroli <[email protected]>
---
 Documentation/os/networking/tcp_state_machine.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/Documentation/os/networking/tcp_state_machine.rst 
b/Documentation/os/networking/tcp_state_machine.rst
index 287c603536e..2b14070b383 100644
--- a/Documentation/os/networking/tcp_state_machine.rst
+++ b/Documentation/os/networking/tcp_state_machine.rst
@@ -306,6 +306,21 @@ The TCP timer handler in ``net/tcp/tcp_timer.c`` drives:
                connection is closed, the socket is notified 
(``TCP_TIMEDOUT``), and a
                RST may be sent.
 
+Reset by the peer
+-----------------
+
+A RST from the peer closes the connection (``TCP_ABORT`` callback).  In
+``TCP_SYN_SENT`` it refuses the connection: ``connect()`` and ``SO_ERROR``
+give ``ECONNREFUSED``.  In ``TCP_ESTABLISHED``, ``TCP_FIN_WAIT_1`` and
+``TCP_FIN_WAIT_2`` the application gets the reset once.  The data that came
+before the RST is read first.  Then the first receive without data, the first
+send or ``getsockopt(SO_ERROR)`` gives ``ECONNRESET``.  After that a receive
+gives end-of-file and a send gives ``EPIPE`` (and ``SIGPIPE`` without
+``MSG_NOSIGNAL``).  ``poll()`` gives ``POLLHUP`` and ``POLLIN``, and
+``POLLERR`` while the ``ECONNRESET`` is not yet reported.  After the FIN of
+the peer the application already read the end of the stream: a RST does not
+change what a receive (end-of-file) or a send (``EPIPE``) gives.
+
 Deviations and Notable Simplifications
 ======================================
 

Reply via email to