Skip to content

Commit

Permalink
Merge pull request grpc#6372 from ctiller/fail_fast
Browse files Browse the repository at this point in the history
Spell out fail fast semantics
ejona86 committed Apr 29, 2016
2 parents f921f2b + 2a932da commit 90b4a87
Showing 1 changed file with 15 additions and 0 deletions.
15 changes: 15 additions & 0 deletions doc/fail_fast.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
gRPC Fail Fast Semantics
========================

Fail fast requests allow terminating requests (with status UNAVAILABLE) prior
to the deadline of the request being met.

gRPC implementations of fail fast can terminate requests whenever a channel is
in the TRANSIENT_FAILURE or SHUTDOWN states. If the channel is in any other
state (CONNECTING, READY, or IDLE) the request should not be terminated.

Fail fast SHOULD be the default for gRPC implementations, with an option to
switch to non fail fast.

The opposite of fail fast is 'ignore connectivity'.

0 comments on commit 90b4a87

Please sign in to comment.