diff options
author | Scott Rifenbark <srifenbark@gmail.com> | 2017-05-01 17:50:10 -0700 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2017-05-10 12:13:32 +0100 |
commit | d815dfbea379b427bdad10f6f8cdaf6a3d484306 (patch) | |
tree | 3b8402f4d9f6d38cc10a928715a5f0e55b2a714b /documentation | |
parent | cbea3d8b6b1964fc3e6b4f6d30123300863d7237 (diff) | |
download | poky-d815dfbea379b427bdad10f6f8cdaf6a3d484306.tar.gz |
dev-manual: Cleaned up "Gdbserver" term
This should be "gdbserver" when referred to generically.
(From yocto-docs rev: 83b2be50e34b0c07cce1f27b55e595752b80b3ea)
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation')
-rw-r--r-- | documentation/dev-manual/dev-manual-common-tasks.xml | 32 |
1 files changed, 16 insertions, 16 deletions
diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml index 15530b2fcd..d63df4d1c4 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml | |||
@@ -10665,16 +10665,16 @@ | |||
10665 | </para> | 10665 | </para> |
10666 | 10666 | ||
10667 | <para> | 10667 | <para> |
10668 | To help get past the previously mentioned constraints, you can use Gdbserver. | 10668 | To help get past the previously mentioned constraints, you can use |
10669 | Gdbserver runs on the remote target and does not load any debugging information | 10669 | gdbserver, which runs on the remote target and does not load any |
10670 | from the debugged process. | 10670 | debugging information from the debugged process. |
10671 | Instead, a GDB instance processes the debugging information that is run on a | 10671 | Instead, a GDB instance processes the debugging information that is run on a |
10672 | remote computer - the host GDB. | 10672 | remote computer - the host GDB. |
10673 | The host GDB then sends control commands to Gdbserver to make it stop or start the debugged | 10673 | The host GDB then sends control commands to gdbserver to make it stop or start the debugged |
10674 | program, as well as read or write memory regions of that debugged program. | 10674 | program, as well as read or write memory regions of that debugged program. |
10675 | All the debugging information loaded and processed as well | 10675 | All the debugging information loaded and processed as well |
10676 | as all the heavy debugging is done by the host GDB. | 10676 | as all the heavy debugging is done by the host GDB. |
10677 | Offloading these processes gives the Gdbserver running on the target a chance to remain | 10677 | Offloading these processes gives the gdbserver running on the target a chance to remain |
10678 | small and fast. | 10678 | small and fast. |
10679 | </para> | 10679 | </para> |
10680 | 10680 | ||
@@ -10685,7 +10685,7 @@ | |||
10685 | with their debugging information and also be sure the target is compiled with no optimizations. | 10685 | with their debugging information and also be sure the target is compiled with no optimizations. |
10686 | The host GDB must also have local access to all the libraries used by the | 10686 | The host GDB must also have local access to all the libraries used by the |
10687 | debugged program. | 10687 | debugged program. |
10688 | Because Gdbserver does not need any local debugging information, the binaries on | 10688 | Because gdbserver does not need any local debugging information, the binaries on |
10689 | the remote target can remain stripped. | 10689 | the remote target can remain stripped. |
10690 | However, the binaries must also be compiled without optimization | 10690 | However, the binaries must also be compiled without optimization |
10691 | so they match the host's binaries. | 10691 | so they match the host's binaries. |
@@ -10728,7 +10728,7 @@ | |||
10728 | the partial filesystem with the full filesystem. | 10728 | the partial filesystem with the full filesystem. |
10729 | </para></listitem> | 10729 | </para></listitem> |
10730 | <listitem><para> | 10730 | <listitem><para> |
10731 | <emphasis>Configure the system to include Gdbserver in | 10731 | <emphasis>Configure the system to include gdbserver in |
10732 | the target filesystem:</emphasis></para> | 10732 | the target filesystem:</emphasis></para> |
10733 | 10733 | ||
10734 | <para>Make the following addition in either your | 10734 | <para>Make the following addition in either your |
@@ -10825,18 +10825,18 @@ | |||
10825 | <listitem><para> | 10825 | <listitem><para> |
10826 | <emphasis>Debug a program:</emphasis></para> | 10826 | <emphasis>Debug a program:</emphasis></para> |
10827 | 10827 | ||
10828 | <para>Debugging a program involves running Gdbserver | 10828 | <para>Debugging a program involves running gdbserver |
10829 | on the target and then running Gdb on the host. | 10829 | on the target and then running Gdb on the host. |
10830 | The example in this step debugs | 10830 | The example in this step debugs |
10831 | <filename>gzip</filename>: | 10831 | <filename>gzip</filename>: |
10832 | <literallayout class='monospaced'> | 10832 | <literallayout class='monospaced'> |
10833 | root@qemux86:~# gdbserver localhost:1234 /bin/gzip —help | 10833 | root@qemux86:~# gdbserver localhost:1234 /bin/gzip —help |
10834 | </literallayout> | 10834 | </literallayout> |
10835 | For additional Gdbserver options, see the | 10835 | For additional gdbserver options, see the |
10836 | <ulink url='https://www.gnu.org/software/gdb/documentation/'>Gdb Server Documentation</ulink>. | 10836 | <ulink url='https://www.gnu.org/software/gdb/documentation/'>GDB Server Documentation</ulink>. |
10837 | </para> | 10837 | </para> |
10838 | 10838 | ||
10839 | <para>After running Gdbserver on the target, you need | 10839 | <para>After running gdbserver on the target, you need |
10840 | to run Gdb on the host and configure it and connect to | 10840 | to run Gdb on the host and configure it and connect to |
10841 | the target. | 10841 | the target. |
10842 | Use these commands: | 10842 | Use these commands: |
@@ -10906,10 +10906,10 @@ | |||
10906 | </section> | 10906 | </section> |
10907 | 10907 | ||
10908 | <section id="platdev-gdb-remotedebug-launch-gdbserver"> | 10908 | <section id="platdev-gdb-remotedebug-launch-gdbserver"> |
10909 | <title>Launch Gdbserver on the Target</title> | 10909 | <title>Launch gdbserver on the Target</title> |
10910 | 10910 | ||
10911 | <para> | 10911 | <para> |
10912 | Make sure Gdbserver is installed on the target. | 10912 | Make sure gdbserver is installed on the target. |
10913 | If it is not, install the package | 10913 | If it is not, install the package |
10914 | <filename>gdbserver</filename>, which needs the | 10914 | <filename>gdbserver</filename>, which needs the |
10915 | <filename>libthread-db1</filename> package. | 10915 | <filename>libthread-db1</filename> package. |
@@ -10917,15 +10917,15 @@ | |||
10917 | 10917 | ||
10918 | <para> | 10918 | <para> |
10919 | Here is an example, that when entered from the host, | 10919 | Here is an example, that when entered from the host, |
10920 | connects to the target and launches Gdbserver in order to | 10920 | connects to the target and launches gdbserver in order to |
10921 | "debug" a binary named <filename>helloworld</filename>: | 10921 | "debug" a binary named <filename>helloworld</filename>: |
10922 | <literallayout class='monospaced'> | 10922 | <literallayout class='monospaced'> |
10923 | $ gdbserver localhost:2345 /usr/bin/helloworld | 10923 | $ gdbserver localhost:2345 /usr/bin/helloworld |
10924 | </literallayout> | 10924 | </literallayout> |
10925 | Gdbserver should now be listening on port 2345 for debugging | 10925 | gdbserver should now be listening on port 2345 for debugging |
10926 | commands coming from a remote GDB process that is running on | 10926 | commands coming from a remote GDB process that is running on |
10927 | the host computer. | 10927 | the host computer. |
10928 | Communication between Gdbserver and the host GDB are done | 10928 | Communication between gdbserver and the host GDB are done |
10929 | using TCP. | 10929 | using TCP. |
10930 | To use other communication protocols, please refer to the | 10930 | To use other communication protocols, please refer to the |
10931 | <ulink url='http://www.gnu.org/software/gdb/'>Gdbserver documentation</ulink>. | 10931 | <ulink url='http://www.gnu.org/software/gdb/'>Gdbserver documentation</ulink>. |