guix/doc
Maxime Devos 5378edeab4
utils: Define ‘search-input-file’ procedure.
The procedure ‘which’ from (guix build utils)
is used for two different purposes:

  1. for finding the absolute file name of a binary
     that needs to run during the build process

  2. for finding the absolute file name of a binary,
     for the target system (as in --target=TARGET),
     e.g. for substituting sh->/gnu/store/.../bin/sh,
     python->/gnu/store/.../bin/python.

When compiling natively (target=#f in Guix parlance),
this is perfectly fine.

However, when cross-compiling, there is a problem.
"which" looks in $PATH for binaries.  That's good for purpose (1),
but incorrect for (2), as the $PATH contains binaries from native-inputs
instead of inputs.

This commit defines a ‘search-input-file’ procedure. It functions
like 'which', but instead of searching in $PATH, it searches in
the 'inputs' of the build phase, which must be passed to
‘search-input-file’ as an argument. Also, the file name must
include "bin/" or "sbin/" as appropriate.

* guix/build/utils.scm (search-input-file): New procedure.
* tests/build-utils.scm
  ("search-input-file: exception if not found")
  ("search-input-file: can find if existent"): Test it.
* doc/guix.texi (File Search): Document it.

Partially-Fixes: <https://issues.guix.gnu.org/47869>
Co-Authored-By: Ludovic Courtès <ludo@gnu.org>
Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2021-06-04 22:34:26 +02:00
..
images doc: Update 'Bootstrapping' for further binary seed reduction. 2020-05-22 16:11:52 +02:00
build.scm Merge branch 'master' into core-updates 2021-05-09 21:29:46 +02:00
contributing.texi The #guix channel is hosted by Libera Chat. 2021-05-20 01:58:04 +02:00
environment-gdb.scm
fdl-1.3.texi
guix-cookbook.texi doc: cookbook: Add "Guix System Image API" section. 2021-01-21 14:40:36 +01:00
guix.texi utils: Define ‘search-input-file’ procedure. 2021-06-04 22:34:26 +02:00
htmlxref.cnf doc: Fix cross-reference URL to translated manual. 2021-04-25 14:36:33 +02:00
local.mk nls: Guard against the list of translated Texinfo files becoming stale. 2021-05-03 22:41:35 -04:00
package-hello.json doc: Document building and installing from JSON files. 2020-04-16 23:41:52 +02:00
package-hello.scm