xref: /aosp_15_r20/external/grpc-grpc/doc/status_ordering.md (revision cc02d7e222339f7a4f6ba5f422e6413f4bd931f2)
1Ordering Status and Reads in the gRPC API
2-----------------------------------------
3
4Rules for implementors:
51. Reads and Writes Must not succeed after Status has been delivered.
62. Status is only delivered after all buffered messages are read.
73. Reads May continue to succeed after a failing write.
8   However, once a write fails, all subsequent writes Must fail,
9   and similarly, once a read fails, all subsequent reads Must fail.
104. A non-OK status received from the server is not considered an error status.
115. When an error status is known to the library, if the user asks for status,
12   the library Should discard messages received in the library but not delivered
13   to the user and then deliver the status. If the user does not ask for status
14   but continues reading, the library Should deliver buffered messages before
15   delivering status. The library MAY choose to implement the stricter version
16   where errors cause all buffered messages to be dropped, but this is not a
17   requirement.
18