diff options
author | Harmen Stoppels <me@harmenstoppels.nl> | 2023-11-06 23:49:54 +0100 |
---|---|---|
committer | GitHub <noreply@github.com> | 2023-11-06 14:49:54 -0800 |
commit | e7372a54a16c1ddc81383d5cad2bb77d4b78423d (patch) | |
tree | 886854a44aca7e3f24b630a1b6e56dd643220f84 | |
parent | 5074b7e922fed8276367755832e3263885c8e884 (diff) | |
download | spack-e7372a54a16c1ddc81383d5cad2bb77d4b78423d.tar.gz spack-e7372a54a16c1ddc81383d5cad2bb77d4b78423d.tar.bz2 spack-e7372a54a16c1ddc81383d5cad2bb77d4b78423d.tar.xz spack-e7372a54a16c1ddc81383d5cad2bb77d4b78423d.zip |
docs: expand section about relocation, suggest padding (#40909)
-rw-r--r-- | lib/spack/docs/binary_caches.rst | 37 |
1 files changed, 27 insertions, 10 deletions
diff --git a/lib/spack/docs/binary_caches.rst b/lib/spack/docs/binary_caches.rst index 00194fc96e..eeb6c4b783 100644 --- a/lib/spack/docs/binary_caches.rst +++ b/lib/spack/docs/binary_caches.rst @@ -155,6 +155,33 @@ List of popular build caches * `Extreme-scale Scientific Software Stack (E4S) <https://e4s-project.github.io/>`_: `build cache <https://oaciss.uoregon.edu/e4s/inventory.html>`_ +---------- +Relocation +---------- + +When using buildcaches across different machines, it is likely that the install +root will be different from the one used to build the binaries. + +To address this issue, Spack automatically relocates all paths encoded in binaries +and scripts to their new location upon install. + +Note that there are some cases where this is not possible: if binaries are built in +a relatively short path, and then installed to a longer path, there may not be enough +space in the binary to encode the new path. In this case, Spack will fail to install +the package from the build cache, and a source build is required. + +To reduce the likelihood of this happening, it is highly recommended to add padding to +the install root during the build, as specified in the :ref:`config <config-yaml>` +section of the configuration: + +.. code-block:: yaml + + config: + install_tree: + root: /opt/spack + padded_length: 128 + + ----------------------------------------- OCI / Docker V2 registries as build cache @@ -305,16 +332,6 @@ which lets you get started quickly. See the following resources for more informa * `spack/github-actions-buildcache <https://github.com/spack/github-actions-buildcache>`_ ----------- -Relocation ----------- - -Initial build and later installation do not necessarily happen at the same -location. Spack provides a relocation capability and corrects for RPATHs and -non-relocatable scripts. However, many packages compile paths into binary -artifacts directly. In such cases, the build instructions of this package would -need to be adjusted for better re-locatability. - .. _cmd-spack-buildcache: -------------------- |