summaryrefslogtreecommitdiffstats
path: root/doc/rtems_gdb/trouble.t
diff options
context:
space:
mode:
authorJoel Sherrill <joel.sherrill@OARcorp.com>1999-02-10 18:33:15 +0000
committerJoel Sherrill <joel.sherrill@OARcorp.com>1999-02-10 18:33:15 +0000
commit387f41adcd32dff7b7de7fe34a8637692ee7c7b1 (patch)
tree677a23401bc9494034f2e95f9f74f1adcaa78a4b /doc/rtems_gdb/trouble.t
parentchanged version to 19990210 (diff)
downloadrtems-387f41adcd32dff7b7de7fe34a8637692ee7c7b1.tar.bz2
Base version.
Diffstat (limited to '')
-rw-r--r--doc/rtems_gdb/trouble.t48
1 files changed, 48 insertions, 0 deletions
diff --git a/doc/rtems_gdb/trouble.t b/doc/rtems_gdb/trouble.t
new file mode 100644
index 0000000000..28999aac67
--- /dev/null
+++ b/doc/rtems_gdb/trouble.t
@@ -0,0 +1,48 @@
+@c
+@c COPYRIGHT (c) 1988-1998.
+@c On-Line Applications Research Corporation (OAR).
+@c All rights reserved.
+@c
+@c $Id$
+@c
+
+
+@section Troubleshooting
+
+This section describes symptoms in some situations where the debugger does not
+work correctly, and it gives guidelines for resolving the problems encountered.
+
+
+@subsection Target machine name unknown on the host
+
+RTEMS/GDB fails to connect to target machine named my_target:
+
+@example
+(gdb) target rtems my_target
+
+Attaching remote machine across net... Invalid hostname. Couldn't find remote
+host address.
+@end example
+
+@i{==> Ask your system administrator to add an entry with the
+Internet number of machine my_target in the file /etc/hosts on your host machine. }
+
+
+@subsection{Debug server not present
+
+The target rtems command fails:
+
+@example
+
+(gdb) target rtems my\_target
+
+Attaching remote machine across net... RPC timed out. Couldn't connect
+to remote target
+
+@end example
+
+
+@i{==> Verify that the target system is properly configured,
+and is running the debugging daemon and communication stack.}
+
+