summaryrefslogtreecommitdiffstats
path: root/documentation/overview-manual
diff options
context:
space:
mode:
authorMichael Opdenacker <michael.opdenacker@bootlin.com>2022-02-14 17:20:08 +0100
committerRichard Purdie <richard.purdie@linuxfoundation.org>2022-03-04 09:39:37 +0000
commit6df5aa347544bb52e72d641524aaaeffd8b8f6c3 (patch)
tree4fe04bfd89e8c36921caba8d76b17f278ef07e9e /documentation/overview-manual
parent0966ba1ebb5ca9feb60eb41316a9abc5d242ffe8 (diff)
downloadpoky-6df5aa347544bb52e72d641524aaaeffd8b8f6c3.tar.gz
documentation: remove references to prelink support
Fixing documentation and updating examples containing "prelink" in their output. (From yocto-docs rev: 8927b8fff55fac1bd1fefcff2d16141dbd1ebc51) Signed-off-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/overview-manual')
-rw-r--r--documentation/overview-manual/concepts.rst8
-rw-r--r--documentation/overview-manual/yp-intro.rst33
2 files changed, 3 insertions, 38 deletions
diff --git a/documentation/overview-manual/concepts.rst b/documentation/overview-manual/concepts.rst
index 5c6364129d..47493786d9 100644
--- a/documentation/overview-manual/concepts.rst
+++ b/documentation/overview-manual/concepts.rst
@@ -1036,12 +1036,10 @@ for example, to determine whether or not to run specific tests. See the
1036:term:`IMAGE_MANIFEST` 1036:term:`IMAGE_MANIFEST`
1037variable for additional information. 1037variable for additional information.
1038 1038
1039Optimizing processes that are run across the image include ``mklibs``, 1039Optimizing processes that are run across the image include ``mklibs``
1040``prelink``, and any other post-processing commands as defined by the 1040and any other post-processing commands as defined by the
1041:term:`ROOTFS_POSTPROCESS_COMMAND` 1041:term:`ROOTFS_POSTPROCESS_COMMAND`
1042variable. The ``mklibs`` process optimizes the size of the libraries, 1042variable. The ``mklibs`` process optimizes the size of the libraries.
1043while the ``prelink`` process optimizes the dynamic linking of shared
1044libraries to reduce start up time of executables.
1045 1043
1046After the root filesystem is built, processing begins on the image 1044After the root filesystem is built, processing begins on the image
1047through the :ref:`ref-tasks-image` 1045through the :ref:`ref-tasks-image`
diff --git a/documentation/overview-manual/yp-intro.rst b/documentation/overview-manual/yp-intro.rst
index ce2aed519e..a863a7d16e 100644
--- a/documentation/overview-manual/yp-intro.rst
+++ b/documentation/overview-manual/yp-intro.rst
@@ -387,39 +387,6 @@ Yocto Project:
387 You can learn more about the AutoBuilder used by the Yocto Project 387 You can learn more about the AutoBuilder used by the Yocto Project
388 Autobuilder :doc:`here </test-manual/understand-autobuilder>`. 388 Autobuilder :doc:`here </test-manual/understand-autobuilder>`.
389 389
390- *Cross-Prelink:* Prelinking is the process of pre-computing the load
391 addresses and link tables generated by the dynamic linker as compared
392 to doing this at runtime. Doing this ahead of time results in
393 performance improvements when the application is launched and reduced
394 memory usage for libraries shared by many applications.
395
396 Historically, cross-prelink is a variant of prelink, which was
397 conceived by `Jakub
398 JelĂ­nek <https://people.redhat.com/jakub/prelink.pdf>`__ a number of
399 years ago. Both prelink and cross-prelink are maintained in the same
400 repository albeit on separate branches. By providing an emulated
401 runtime dynamic linker (i.e. ``glibc``-derived ``ld.so`` emulation),
402 the cross-prelink project extends the prelink software's ability to
403 prelink a sysroot environment. Additionally, the cross-prelink
404 software enables the ability to work in sysroot style environments.
405
406 The dynamic linker determines standard load address calculations
407 based on a variety of factors such as mapping addresses, library
408 usage, and library function conflicts. The prelink tool uses this
409 information, from the dynamic linker, to determine unique load
410 addresses for executable and linkable format (ELF) binaries that are
411 shared libraries and dynamically linked. The prelink tool modifies
412 these ELF binaries with the pre-computed information. The result is
413 faster loading and often lower memory consumption because more of the
414 library code can be re-used from shared Copy-On-Write (COW) pages.
415
416 The original upstream prelink project only supports running prelink
417 on the end target device due to the reliance on the target device's
418 dynamic linker. This restriction causes issues when developing a
419 cross-compiled system. The cross-prelink adds a synthesized dynamic
420 loader that runs on the host, thus permitting cross-prelinking
421 without ever having to run on a read-write target filesystem.
422
423- *Pseudo:* Pseudo is the Yocto Project implementation of 390- *Pseudo:* Pseudo is the Yocto Project implementation of
424 `fakeroot <http://man.he.net/man1/fakeroot>`__, which is used to run 391 `fakeroot <http://man.he.net/man1/fakeroot>`__, which is used to run
425 commands in an environment that seemingly has root privileges. 392 commands in an environment that seemingly has root privileges.