summaryrefslogtreecommitdiffstats
path: root/documentation/dev-manual/debugging.rst
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/dev-manual/debugging.rst')
-rw-r--r--documentation/dev-manual/debugging.rst22
1 files changed, 11 insertions, 11 deletions
diff --git a/documentation/dev-manual/debugging.rst b/documentation/dev-manual/debugging.rst
index f433e8e6a9..921022475f 100644
--- a/documentation/dev-manual/debugging.rst
+++ b/documentation/dev-manual/debugging.rst
@@ -297,11 +297,11 @@ If you are unsure whether a variable dependency is being picked up
297automatically for a given task, you can list the variable dependencies 297automatically for a given task, you can list the variable dependencies
298BitBake has determined by doing the following: 298BitBake has determined by doing the following:
299 299
3001. Build the recipe containing the task:: 300#. Build the recipe containing the task::
301 301
302 $ bitbake recipename 302 $ bitbake recipename
303 303
3042. Inside the :term:`STAMPS_DIR` 304#. Inside the :term:`STAMPS_DIR`
305 directory, find the signature data (``sigdata``) file that 305 directory, find the signature data (``sigdata``) file that
306 corresponds to the task. The ``sigdata`` files contain a pickled 306 corresponds to the task. The ``sigdata`` files contain a pickled
307 Python database of all the metadata that went into creating the input 307 Python database of all the metadata that went into creating the input
@@ -319,7 +319,7 @@ BitBake has determined by doing the following:
319 the cached task output. The ``siginfo`` files contain exactly the 319 the cached task output. The ``siginfo`` files contain exactly the
320 same information as ``sigdata`` files. 320 same information as ``sigdata`` files.
321 321
3223. Run ``bitbake-dumpsig`` on the ``sigdata`` or ``siginfo`` file. Here 322#. Run ``bitbake-dumpsig`` on the ``sigdata`` or ``siginfo`` file. Here
323 is an example:: 323 is an example::
324 324
325 $ bitbake-dumpsig ${BUILDDIR}/tmp/stamps/i586-poky-linux/db/6.0.30-r1.do_fetch.sigdata.7c048c18222b16ff0bcee2000ef648b1 325 $ bitbake-dumpsig ${BUILDDIR}/tmp/stamps/i586-poky-linux/db/6.0.30-r1.do_fetch.sigdata.7c048c18222b16ff0bcee2000ef648b1
@@ -992,7 +992,7 @@ site <https://sourceware.org/gdb/documentation/>`__.
992The following steps show you how to debug using the GNU project 992The following steps show you how to debug using the GNU project
993debugger. 993debugger.
994 994
9951. *Configure your build system to construct the companion debug 995#. *Configure your build system to construct the companion debug
996 filesystem:* 996 filesystem:*
997 997
998 In your ``local.conf`` file, set the following:: 998 In your ``local.conf`` file, set the following::
@@ -1012,7 +1012,7 @@ debugger.
1012 the full filesystem for debugging. Subsequent steps in this procedure 1012 the full filesystem for debugging. Subsequent steps in this procedure
1013 show how to combine the partial filesystem with the full filesystem. 1013 show how to combine the partial filesystem with the full filesystem.
1014 1014
10152. *Configure the system to include gdbserver in the target filesystem:* 1015#. *Configure the system to include gdbserver in the target filesystem:*
1016 1016
1017 Make the following addition in your ``local.conf`` file:: 1017 Make the following addition in your ``local.conf`` file::
1018 1018
@@ -1021,7 +1021,7 @@ debugger.
1021 The change makes 1021 The change makes
1022 sure the ``gdbserver`` package is included. 1022 sure the ``gdbserver`` package is included.
1023 1023
10243. *Build the environment:* 1024#. *Build the environment:*
1025 1025
1026 Use the following command to construct the image and the companion 1026 Use the following command to construct the image and the companion
1027 Debug Filesystem:: 1027 Debug Filesystem::
@@ -1057,7 +1057,7 @@ debugger.
1057 the actual image (e.g. ``gdb-cross-i586``). The suggestion is usually the 1057 the actual image (e.g. ``gdb-cross-i586``). The suggestion is usually the
1058 actual name you want to use. 1058 actual name you want to use.
1059 1059
10604. *Set up the* ``debugfs``\ *:* 1060#. *Set up the* ``debugfs``\ *:*
1061 1061
1062 Run the following commands to set up the ``debugfs``:: 1062 Run the following commands to set up the ``debugfs``::
1063 1063
@@ -1066,7 +1066,7 @@ debugger.
1066 $ tar xvfj build-dir/tmp/deploy/images/machine/image.rootfs.tar.bz2 1066 $ tar xvfj build-dir/tmp/deploy/images/machine/image.rootfs.tar.bz2
1067 $ tar xvfj build-dir/tmp/deploy/images/machine/image-dbg.rootfs.tar.bz2 1067 $ tar xvfj build-dir/tmp/deploy/images/machine/image-dbg.rootfs.tar.bz2
1068 1068
10695. *Set up GDB:* 1069#. *Set up GDB:*
1070 1070
1071 Install the SDK (if you built one) and then source the correct 1071 Install the SDK (if you built one) and then source the correct
1072 environment file. Sourcing the environment file puts the SDK in your 1072 environment file. Sourcing the environment file puts the SDK in your
@@ -1075,7 +1075,7 @@ debugger.
1075 If you are using the build system, Gdb is located in 1075 If you are using the build system, Gdb is located in
1076 `build-dir`\ ``/tmp/sysroots/``\ `host`\ ``/usr/bin/``\ `architecture`\ ``/``\ `architecture`\ ``-gdb`` 1076 `build-dir`\ ``/tmp/sysroots/``\ `host`\ ``/usr/bin/``\ `architecture`\ ``/``\ `architecture`\ ``-gdb``
1077 1077
10786. *Boot the target:* 1078#. *Boot the target:*
1079 1079
1080 For information on how to run QEMU, see the `QEMU 1080 For information on how to run QEMU, see the `QEMU
1081 Documentation <https://wiki.qemu.org/Documentation/GettingStartedDevelopers>`__. 1081 Documentation <https://wiki.qemu.org/Documentation/GettingStartedDevelopers>`__.
@@ -1084,7 +1084,7 @@ debugger.
1084 1084
1085 Be sure to verify that your host can access the target via TCP. 1085 Be sure to verify that your host can access the target via TCP.
1086 1086
10877. *Debug a program:* 1087#. *Debug a program:*
1088 1088
1089 Debugging a program involves running gdbserver on the target and then 1089 Debugging a program involves running gdbserver on the target and then
1090 running Gdb on the host. The example in this step debugs ``gzip``: 1090 running Gdb on the host. The example in this step debugs ``gzip``:
@@ -1116,7 +1116,7 @@ debugger.
1116 users ``~/.gdbinit`` file. Upon starting, Gdb automatically runs whatever 1116 users ``~/.gdbinit`` file. Upon starting, Gdb automatically runs whatever
1117 commands are in that file. 1117 commands are in that file.
1118 1118
11198. *Deploying without a full image rebuild:* 1119#. *Deploying without a full image rebuild:*
1120 1120
1121 In many cases, during development you want a quick method to deploy a 1121 In many cases, during development you want a quick method to deploy a
1122 new binary to the target and debug it, without waiting for a full 1122 new binary to the target and debug it, without waiting for a full