diff options
author | Nicolas Dechesne <nicolas.dechesne@linaro.org> | 2020-09-15 11:21:58 +0200 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2020-09-17 10:09:35 +0100 |
commit | c526975d28102905d4eddc1cf3520a71f0971ea9 (patch) | |
tree | e6d218ffe47ea24259103e06b7cb3cd14ee0ac5f /documentation/profile-manual/profile-manual-intro.rst | |
parent | 9f0a31c6073fc9832a5119875b1a4a1032e525eb (diff) | |
download | poky-c526975d28102905d4eddc1cf3520a71f0971ea9.tar.gz |
sphinx: profile-manual: convert profile-manual
Last round of manual fixes for remaining links and conversion problems
left after the automatic conversion.
(From yocto-docs rev: 071bca4573bc8c60aef1d89896d6536867fe46e5)
Signed-off-by: Nicolas Dechesne <nicolas.dechesne@linaro.org>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/profile-manual/profile-manual-intro.rst')
-rw-r--r-- | documentation/profile-manual/profile-manual-intro.rst | 40 |
1 files changed, 25 insertions, 15 deletions
diff --git a/documentation/profile-manual/profile-manual-intro.rst b/documentation/profile-manual/profile-manual-intro.rst index 5d51df74dc..994b1c5086 100644 --- a/documentation/profile-manual/profile-manual-intro.rst +++ b/documentation/profile-manual/profile-manual-intro.rst | |||
@@ -38,12 +38,19 @@ General Setup | |||
38 | Most of the tools are available only in 'sdk' images or in images built | 38 | Most of the tools are available only in 'sdk' images or in images built |
39 | after adding 'tools-profile' to your local.conf. So, in order to be able | 39 | after adding 'tools-profile' to your local.conf. So, in order to be able |
40 | to access all of the tools described here, please first build and boot | 40 | to access all of the tools described here, please first build and boot |
41 | an 'sdk' image e.g. $ bitbake core-image-sato-sdk or alternatively by | 41 | an 'sdk' image e.g. :: |
42 | adding 'tools-profile' to the EXTRA_IMAGE_FEATURES line in your | 42 | |
43 | local.conf: EXTRA_IMAGE_FEATURES = "debug-tweaks tools-profile" If you | 43 | $ bitbake core-image-sato-sdk |
44 | use the 'tools-profile' method, you don't need to build an sdk image - | 44 | |
45 | the tracing and profiling tools will be included in non-sdk images as | 45 | or alternatively by adding 'tools-profile' to the EXTRA_IMAGE_FEATURES line in |
46 | well e.g.: $ bitbake core-image-sato | 46 | your local.conf: :: |
47 | |||
48 | EXTRA_IMAGE_FEATURES = "debug-tweaks tools-profile" | ||
49 | |||
50 | If you use the 'tools-profile' method, you don't need to build an sdk image - | ||
51 | the tracing and profiling tools will be included in non-sdk images as well e.g.: :: | ||
52 | |||
53 | $ bitbake core-image-sato | ||
47 | 54 | ||
48 | .. note:: | 55 | .. note:: |
49 | 56 | ||
@@ -52,18 +59,21 @@ well e.g.: $ bitbake core-image-sato | |||
52 | 59 | ||
53 | You can prevent that by setting the | 60 | You can prevent that by setting the |
54 | :term:`INHIBIT_PACKAGE_STRIP` | 61 | :term:`INHIBIT_PACKAGE_STRIP` |
55 | variable to "1" in your ``local.conf`` when you build the image: | 62 | variable to "1" in your ``local.conf`` when you build the image: :: |
56 | 63 | ||
57 | INHIBIT_PACKAGE_STRIP = "1" The above setting will noticeably increase | 64 | INHIBIT_PACKAGE_STRIP = "1" |
58 | the size of your image. | 65 | |
66 | The above setting will noticeably increase the size of your image. | ||
59 | 67 | ||
60 | If you've already built a stripped image, you can generate debug | 68 | If you've already built a stripped image, you can generate debug |
61 | packages (xxx-dbg) which you can manually install as needed. | 69 | packages (xxx-dbg) which you can manually install as needed. |
62 | 70 | ||
63 | To generate debug info for packages, you can add dbg-pkgs to | 71 | To generate debug info for packages, you can add dbg-pkgs to |
64 | EXTRA_IMAGE_FEATURES in local.conf. For example: EXTRA_IMAGE_FEATURES = | 72 | EXTRA_IMAGE_FEATURES in local.conf. For example: :: |
65 | "debug-tweaks tools-profile dbg-pkgs" Additionally, in order to generate | 73 | |
66 | the right type of debuginfo, we also need to set | 74 | EXTRA_IMAGE_FEATURES = "debug-tweaks tools-profile dbg-pkgs" |
67 | :term:`PACKAGE_DEBUG_SPLIT_STYLE` | 75 | |
68 | in the ``local.conf`` file: PACKAGE_DEBUG_SPLIT_STYLE = | 76 | Additionally, in order to generate the right type of debuginfo, we also need to |
69 | 'debug-file-directory' | 77 | set :term:`PACKAGE_DEBUG_SPLIT_STYLE` in the ``local.conf`` file: :: |
78 | |||
79 | PACKAGE_DEBUG_SPLIT_STYLE = 'debug-file-directory' | ||