ref-manual/ref: Add entry for why binaries are changed in images

Submitted by Richard Purdie on Oct. 28, 2020, 11:29 a.m. | Patch ID: 177616

Details

Message ID 20201028112952.172577-1-richard.purdie@linuxfoundation.org
State Superseded
Headers show

Commit Message

Richard Purdie Oct. 28, 2020, 11:29 a.m.
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
---
 documentation/ref-manual/faq.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

Patch hide | download patch | download mbox

diff --git a/documentation/ref-manual/faq.rst b/documentation/ref-manual/faq.rst
index 7a1614028..b79ba0306 100644
--- a/documentation/ref-manual/faq.rst
+++ b/documentation/ref-manual/faq.rst
@@ -451,3 +451,14 @@  variant. For another example, permissions errors might be caused by a
 Makefile that ignores ``DESTDIR`` or uses a different name for that
 environment variable. Check the the build system to see if these kinds
 of issues exist.
+
+**Q:** I'm adding a binary in a recipe but its different in the image, what is
+changing it?
+
+**A:** The first most obvious change is the system stripping debug symbols from
+it. Setting ``INHIBIT_PACKAGE_STRIP`` to stop debug symbols being stripped and/or
+``INHIBIT_PACKAGE_DEBUG_SPLIT`` to stop debug symbols being split into a separate
+file will ensure the binary is unchanged. The other less obvious thing that can
+happen is prelinking of the image. This is set by default in local.conf via
+``USER_CLASSES`` which can contain 'image-prelink'. If you remove that, the
+image will not be prelinked meaning the binaries would be unchanged.

Comments

Quentin Schulz Oct. 28, 2020, 1:15 p.m.
Hi Richard,

On October 28, 2020 12:29:52 PM GMT+01:00, Richard Purdie <richard.purdie@linuxfoundation.org> wrote:
>Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
>---
> documentation/ref-manual/faq.rst | 11 +++++++++++
> 1 file changed, 11 insertions(+)
>
>diff --git a/documentation/ref-manual/faq.rst
>b/documentation/ref-manual/faq.rst
>index 7a1614028..b79ba0306 100644
>--- a/documentation/ref-manual/faq.rst
>+++ b/documentation/ref-manual/faq.rst
>@@ -451,3 +451,14 @@ variant. For another example, permissions errors
>might be caused by a
> Makefile that ignores ``DESTDIR`` or uses a different name for that
> environment variable. Check the the build system to see if these kinds
> of issues exist.
>+
>+**Q:** I'm adding a binary in a recipe but its different in the image,
>what is

s/its/it's/

>+changing it?
>+
>+**A:** The first most obvious change is the system stripping debug
>symbols from
>+it. Setting ``INHIBIT_PACKAGE_STRIP`` to stop debug symbols being
>stripped and/or
>+``INHIBIT_PACKAGE_DEBUG_SPLIT`` to stop debug symbols being split into
>a separate
>+file will ensure the binary is unchanged. The other less obvious thing
>that can
>+happen is prelinking of the image. This is set by default in
>local.conf via
>+``USER_CLASSES`` which can contain 'image-prelink'. If you remove
>that, the
>+image will not be prelinked meaning the binaries would be unchanged.
>-- 
>2.25.1

I'd use refs to the listed variables to make it easier for people to find exactly what to do with them, e.g. :term:`INHIBIT_PACKAGE_STRIP`.

Quentin
-=-=-=-=-=-=-=-=-=-=-=-
Links: You receive all messages sent to this group.
View/Reply Online (#519): https://lists.yoctoproject.org/g/docs/message/519
Mute This Topic: https://lists.yoctoproject.org/mt/77860690/3617530
Group Owner: docs+owner@lists.yoctoproject.org
Unsubscribe: https://lists.yoctoproject.org/g/docs/unsub [oe-patchwork@oe-patch.openembedded.org]
-=-=-=-=-=-=-=-=-=-=-=-
Richard Purdie Oct. 28, 2020, 1:59 p.m.
On Wed, 2020-10-28 at 14:15 +0100, Quentin Schulz wrote:
> Hi Richard,
> 
> On October 28, 2020 12:29:52 PM GMT+01:00, Richard Purdie <
> richard.purdie@linuxfoundation.org> wrote:
> > Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
> > ---
> > documentation/ref-manual/faq.rst | 11 +++++++++++
> > 1 file changed, 11 insertions(+)
> > 
> > diff --git a/documentation/ref-manual/faq.rst
> > b/documentation/ref-manual/faq.rst
> > index 7a1614028..b79ba0306 100644
> > --- a/documentation/ref-manual/faq.rst
> > +++ b/documentation/ref-manual/faq.rst
> > @@ -451,3 +451,14 @@ variant. For another example, permissions
> > errors
> > might be caused by a
> > Makefile that ignores ``DESTDIR`` or uses a different name for that
> > environment variable. Check the the build system to see if these
> > kinds
> > of issues exist.
> > +
> > +**Q:** I'm adding a binary in a recipe but its different in the
> > image,
> > what is
> 
> s/its/it's/

Thanks, will fix.
> 
> > +changing it?
> > +
> > +**A:** The first most obvious change is the system stripping debug
> > symbols from
> > +it. Setting ``INHIBIT_PACKAGE_STRIP`` to stop debug symbols being
> > stripped and/or
> > +``INHIBIT_PACKAGE_DEBUG_SPLIT`` to stop debug symbols being split
> > into
> > a separate
> > +file will ensure the binary is unchanged. The other less obvious
> > thing
> > that can
> > +happen is prelinking of the image. This is set by default in
> > local.conf via
> > +``USER_CLASSES`` which can contain 'image-prelink'. If you remove
> > that, the
> > +image will not be prelinked meaning the binaries would be
> > unchanged.
> > -- 
> > 2.25.1
> 
> I'd use refs to the listed variables to make it easier for people to
> find exactly what to do with them, e.g.
> :term:`INHIBIT_PACKAGE_STRIP`.

See the second patch I sent! :)

Cheers,

Richard
-=-=-=-=-=-=-=-=-=-=-=-
Links: You receive all messages sent to this group.
View/Reply Online (#520): https://lists.yoctoproject.org/g/docs/message/520
Mute This Topic: https://lists.yoctoproject.org/mt/77860690/3617530
Group Owner: docs+owner@lists.yoctoproject.org
Unsubscribe: https://lists.yoctoproject.org/g/docs/unsub [oe-patchwork@oe-patch.openembedded.org]
-=-=-=-=-=-=-=-=-=-=-=-
Richard Purdie Oct. 28, 2020, 10:31 p.m.
This is a system generated Comment: Patch 177616 was automatically marked as superseded by patch 177617.