[Pdbg] [PATCH v2 05/38] gdbserver: Document problem and workaround for client remote timeouts

[Nicholas Piggin]

gdbserver does not robustly deal with the gdb client timing out
and re-sending packets.

Signed-off-by: Nicholas Piggin <npiggin at gmail.com>
---
 README.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/README.md b/README.md
index 316976e..be26dc1 100644
--- a/README.md
+++ b/README.md
@@ -546,6 +546,13 @@ $ gdb
 Debugging info:
 (gdb) set debug remote 10
 
+Long-running operations or high latency links:
+The gdb client timeout defaults to 2 seconds after which it re-transmits
+commands. The gdb server does not deal with this robustly today and this
+can cause hangs and other unexpected results. If gdb client stops
+responding, behaves strangely or complains about bad or unexpected remote
+packets, try increasing the timeout. E.g.,
+(gdb) set remotetimeout 60
 
 Notes:
 1. DON'T RUN PDBG OVER FSI WHILE HOSTBOOT IS RUNNING. Weird things seem to
-- 
2.23.0