diff options
| author |   Scott Rifenbark <srifenbark@gmail.com> | 2019-03-07 10:26:34 -0800 |
|---|---|---|
| committer |   Richard Purdie <richard.purdie@linuxfoundation.org> | 2019-03-19 23:54:02 +0000 |
| commit | 5c2dca7e75a9b35a148258d913343e625961bb44 (patch) | |
| tree | 9cb00f780f51a882d7371be88efc68bd4f5abbef /documentation | |
| parent | 8c7ec72e6d1af59d36aebeadb5df43da2a04a0dd (diff) | |
| download | openembedded-core-contrib-5c2dca7e75a9b35a148258d913343e625961bb44.tar.gz | |
ref-manual: Added INIHIBIT_SYSROOT_STRIP variable desc.
(From yocto-docs rev: 867c5affcecff77ec4b36f026baba80a6bf4fe62)
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/ref-manual/ref-variables.xml | 38 |
1 files changed, 38 insertions, 0 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml index bbfa37675f..3ffa92c866 100644 --- a/documentation/ref-manual/ref-variables.xml +++ b/documentation/ref-manual/ref-variables.xml @@ -6919,6 +6919,44 @@ </glossdef> </glossentry> + <glossentry id='var-INHIBIT_SYSROOT_STRIP'><glossterm>INHIBIT_SYSROOT_STRIP</glossterm> + <info> + INHIBIT_SYSROOT_STRIP[doc] = "If set to "1", causes the build to not strip binaries in the resulting sysroot." + </info> + <glossdef> + <para role="glossdeffirst"> +<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> --> + If set to "1", causes the build to not strip binaries in + the resulting sysroot. + </para> + + <para> + By default, the OpenEmbedded build system strips + binaries in the resulting sysroot. + When you specifically set the + <filename>INHIBIT_SYSROOT_STRIP</filename> variable to + "1" in your recipe, you inhibit this stripping. + </para> + + <para> + If you want to use this variable, include the + <link linkend='ref-classes-staging'><filename>staging</filename></link> + class. + This class uses a <filename>sys_strip()</filename> + function to test for the variable and acts accordingly. + <note> + Use of the <filename>INHIBIT_SYSROOT_STRIP</filename> + variable occurs in rare and special circumstances. + For example, suppose you are building bare-metal + firmware by using an external GCC toolchain. + Furthermore, even if the toolchain's binaries are + strippable, other files exist that are needed for the + build that are not strippable. + </note> + </para> + </glossdef> + </glossentry> + <glossentry id='var-INITRAMFS_FSTYPES'><glossterm>INITRAMFS_FSTYPES</glossterm> <info> INITRAMFS_FSTYPES[doc] = "Defines the format for the output image of an initial RAM filesystem (initramfs), which is used during boot." |