diff mbox series

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

Message ID 20220329154931.493851-6-npiggin@gmail.com
State New
Headers show
Series gdbserver multi-threaded debugging and POWER9/10 support | expand

Commit Message

Nicholas Piggin March 29, 2022, 3:48 p.m. UTC 
gdbserver does not robustly deal with the gdb client timing out
and re-sending packets.

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

Patch

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