Skip to content

Commit 8281e6a

Browse files
Clarify use of CC and friends for file generation
Add more detail around how generation of configuration-independent files chooses a C compiler. Mention that setting HOSTCC or CC is recommended where there are multiple toolchains. Mention that the fallback location is the cc executable, which may help users troubleshooting when the file generation picks up the wrong toolchain (as in #10360). Signed-off-by: David Horstmann <[email protected]>
1 parent a53d8c5 commit 8281e6a

File tree

1 file changed

+7
-1
lines changed

1 file changed

+7
-1
lines changed

README.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -72,7 +72,13 @@ The following tools are required:
7272
Depending on your Python installation, you may need to invoke `python` instead of `python3`. To install the packages system-wide, omit the `--user` option.
7373
* A C compiler for the host platform, for some test data.
7474
75-
If you are cross-compiling, you must set the `CC` environment variable to a C compiler for the host platform when generating the configuration-independent files.
75+
The scripts that generate the configuration-independent files will look for a host C compiler in the following places (in order of preference):
76+
77+
1. The `HOSTCC` environment variable. This can be used if `CC` is pointing to a cross-compiler.
78+
2. The `CC` environment variable.
79+
3. An executable called `cc` in the current path.
80+
81+
Note: If you have multiple toolchains installed, it is recommended to set `CC` or `HOSTCC` to the intended host compiler before generating the files.
7682
7783
Any of the following methods are available to generate the configuration-independent files:
7884

0 commit comments

Comments
 (0)