aboutsummaryrefslogtreecommitdiffhomepage
path: root/doc
diff options
context:
space:
mode:
authorGravatar Sree Kuchibhotla <sreek@google.com>2016-05-03 09:33:13 -0700
committerGravatar Sree Kuchibhotla <sreek@google.com>2016-05-03 09:33:13 -0700
commitb69251c2f6868c4d839dfae05293e10cbb90060e (patch)
tree6ef55ad71ccf3d7c882276de17b49bba9806f559 /doc
parenta2b549578f94de1bf4735a26c9fc4516b96bbdaa (diff)
parent6bac7d3467c99dccc30e8447bc84237bb54b99fe (diff)
Merge branch 'master' into server_channel_affinity
Diffstat (limited to 'doc')
-rw-r--r--doc/fail_fast.md15
1 files changed, 15 insertions, 0 deletions
diff --git a/doc/fail_fast.md b/doc/fail_fast.md
new file mode 100644
index 0000000000..3ed4297194
--- /dev/null
+++ b/doc/fail_fast.md
@@ -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'.
+