diff options
author | Simon Marchi <simon.marchi@efficios.com> | 2020-06-12 16:01:26 -0400 |
---|---|---|
committer | Simon Marchi <simon.marchi@efficios.com> | 2020-06-12 16:01:35 -0400 |
commit | c00094dc7ac4a527ff23b15adc96b4750d8365d7 (patch) | |
tree | 8474598b1b5a50294d84a2573d5fb3b2ef62d894 /gdbserver/README | |
parent | 8118159c69a957292ce701b3d2937f19a0d0f973 (diff) | |
download | binutils-c00094dc7ac4a527ff23b15adc96b4750d8365d7.zip binutils-c00094dc7ac4a527ff23b15adc96b4750d8365d7.tar.gz binutils-c00094dc7ac4a527ff23b15adc96b4750d8365d7.tar.bz2 |
gdbserver: small cleanup of README file
Fix a few outdated or incoherent things in the README:
- Don't mention remote.c nor *-stub.c files as references for the remote
protocol. remote.c is in GDB, not GDBserver, and *-stub.c files don't
exist today. Add a link to the documentation instead.
- In the "server (target) side" section, use `:2345` instead of
`host:2345`. It currently says that using `host:2345` means we would
expect a connection from `host`. That's not what I would expect by
passing a host part here. If I passed `11.22.33.44:2345` as the listen
address, I would expect it to instruct gdbserver to listen only on that
(11.22.33.44) network interface, not to expect a connection from host
`11.22.33.44`. So, remove that part of the sentence.
- Remove the list of supported target, refer to configure.srv instead.
Keeping a list here is bound to lose sync with reality.
- In the cross-compile instructions, I don't think it's necessary to mention
"In a Bourne shell".
- In the cross-compile instructions, I don't know what passing
`your-target-name` to configure does, I don't think it's valid. Use
`make all-gdbserver` as in the instructions just above.
gdbserver/ChangeLog:
* README: Fix a few outdated or incoherent things.
Change-Id: I79349e25bc1bc53447855e0dea6cc7b9630f4553
Diffstat (limited to 'gdbserver/README')
-rw-r--r-- | gdbserver/README | 51 |
1 files changed, 17 insertions, 34 deletions
diff --git a/gdbserver/README b/gdbserver/README index 17d435c..5b47510 100644 --- a/gdbserver/README +++ b/gdbserver/README @@ -5,11 +5,12 @@ Introduction: This is GDBserver, a remote server for Un*x-like systems. It can be used to control the execution of a program on a target system from a GDB on a different -host. GDB and GDBserver communicate using the standard remote serial protocol -implemented in remote.c, and various *-stub.c files. They communicate via -either a serial line or a TCP connection. +host. GDB and GDBserver communicate using the standard remote serial protocol. +They communicate via either a serial line or a TCP connection. -For more information about GDBserver, see the GDB manual. +For more information about GDBserver, see the GDB manual: + + https://sourceware.org/gdb/current/onlinedocs/gdb/Remote-Protocol.html Usage (server (target) side): @@ -38,13 +39,13 @@ To use a TCP connection, you could say: This says pretty much the same thing as the last example, except that we are going to communicate with the host GDB via TCP. The `host:2345' argument means -that we are expecting to see a TCP connection from `host' to local TCP port -2345. (Currently, the `host' part is ignored.) You can choose any number you -want for the port number as long as it does not conflict with any existing TCP -ports on the target system. This same port number must be used in the host -GDBs `target remote' command, which will be described shortly. Note that if -you chose a port number that conflicts with another service, GDBserver will -print an error message and exit. +that we are expecting to see a TCP connection to local TCP port 2345. +(Currently, the `host' part is ignored.) You can choose any number you want for +the port number as long as it does not conflict with any existing TCP ports on +the target system. This same port number must be used in the host GDB's +`target remote' command, which will be described shortly. Note that if you chose +a port number that conflicts with another service, GDBserver will print an error +message and exit. On some targets, GDBserver can also attach to running programs. This is accomplished via the --attach argument. The syntax is: @@ -79,26 +80,8 @@ command, otherwise you may get an error that looks something like Building GDBserver: -The supported targets as of November 2006 are: - arm-*-linux* - bfin-*-uclinux - bfin-*-linux-uclibc - crisv32-*-linux* - cris-*-linux* - i[34567]86-*-cygwin* - i[34567]86-*-linux* - i[34567]86-*-mingw* - ia64-*-linux* - m32r*-*-linux* - m68*-*-linux* - m68*-*-uclinux* - mips*64*-*-linux* - mips*-*-linux* - powerpc[64]-*-linux* - s390[x]-*-linux* - sh-*-linux* - spu*-*-* - x86_64-*-linux* +See the `configure.srv` file for the list of host triplets you can build +GDBserver for. Building GDBserver for your host is very straightforward. If you build GDB natively on a host which GDBserver supports, it will be built @@ -114,11 +97,11 @@ disable other directories when configuring, e.g., binutils, gas, gold, gprof, and ld.) If you prefer to cross-compile to your target, then you can also build -GDBserver that way. In a Bourne shell, for example: +GDBserver that way. For example: % export CC=your-cross-compiler - % path-to-topevel-sources/configure your-target-name --disable-gdb - % make + % path-to-topevel-sources/configure --disable-gdb + % make all-gdbserver Using GDBreplay: |