Changeset View
Changeset View
Standalone View
Standalone View
contrib/guix/README.md
Show First 20 Lines • Show All 101 Lines • ▼ Show 20 Lines | |||||
### Building a subset of platform triples | ### Building a subset of platform triples | ||||
Sometimes you only want to build a subset of the supported platform triples, in | Sometimes you only want to build a subset of the supported platform triples, in | ||||
which case you can override the default list by setting the space-separated | which case you can override the default list by setting the space-separated | ||||
`HOSTS` environment variable: | `HOSTS` environment variable: | ||||
```sh | ```sh | ||||
env HOSTS='x86_64-w64-mingw32 x86_64-apple-darwin' ./contrib/guix/guix-build | env HOSTS='x86_64-w64-mingw32 x86_64-apple-darwin19' ./contrib/guix/guix-build | ||||
``` | ``` | ||||
See the [recognized environment variables][env-vars-list] section for more | See the [recognized environment variables][env-vars-list] section for more | ||||
details. | details. | ||||
### Controlling the number of threads used by `guix` build commands | ### Controlling the number of threads used by `guix` build commands | ||||
Depending on your system's RAM capacity, you may want to decrease the number of | Depending on your system's RAM capacity, you may want to decrease the number of | ||||
▲ Show 20 Lines • Show All 47 Lines • ▼ Show 20 Lines | |||||
## Recognized environment variables | ## Recognized environment variables | ||||
* _**HOSTS**_ | * _**HOSTS**_ | ||||
Override the space-separated list of platform triples for which to perform a | Override the space-separated list of platform triples for which to perform a | ||||
bootstrappable build. | bootstrappable build. | ||||
_(defaults to "x86\_64-linux-gnu arm-linux-gnueabihf aarch64-linux-gnu | _(defaults to "x86\_64-linux-gnu arm-linux-gnueabihf aarch64-linux-gnu | ||||
x86\_64-w64-mingw32 x86\_64-apple-darwin arm64-apple-darwin")_ | x86\_64-w64-mingw32 x86\_64-apple-darwin19")_ | ||||
* _**SOURCES_PATH**_ | * _**SOURCES_PATH**_ | ||||
Set the depends tree download cache for sources. This is passed through to the | Set the depends tree download cache for sources. This is passed through to the | ||||
depends tree. Setting this to the same directory across multiple builds of the | depends tree. Setting this to the same directory across multiple builds of the | ||||
depends tree can eliminate unnecessary redownloading of package sources. | depends tree can eliminate unnecessary redownloading of package sources. | ||||
The path that this environment variable points to **must be a directory**, and | The path that this environment variable points to **must be a directory**, and | ||||
**NOT a symlink to a directory**. | **NOT a symlink to a directory**. | ||||
* _**BASE_CACHE**_ | * _**BASE_CACHE**_ | ||||
Set the depends tree cache for built packages. This is passed through to the | Set the depends tree cache for built packages. This is passed through to the | ||||
depends tree. Setting this to the same directory across multiple builds of the | depends tree. Setting this to the same directory across multiple builds of the | ||||
depends tree can eliminate unnecessary building of packages. | depends tree can eliminate unnecessary building of packages. | ||||
The path that this environment variable points to **must be a directory**, and | The path that this environment variable points to **must be a directory**, and | ||||
**NOT a symlink to a directory**. | **NOT a symlink to a directory**. | ||||
* _**SDK_PATH**_ | * _**SDK_PATH**_ | ||||
Set the path where _extracted_ SDKs can be found. This is passed through to | Set the path where _extracted_ SDKs can be found. This is passed through to | ||||
the depends tree. Note that this is should be set to the _parent_ directory of | the depends tree. Note that this is should be set to the _parent_ directory of | ||||
the actual SDK (e.g. `SDK_PATH=$HOME/Downloads/macOS-SDKs` instead of | the actual SDK (e.g. `SDK_PATH=$HOME/Downloads/macOS-SDKs` instead of | ||||
`$HOME/Downloads/macOS-SDKs/Xcode-12.2-12B45b-extracted-SDK-with-libcxx-headers`). | `$HOME/Downloads/macOS-SDKs/Xcode-12.1-12A7403-extracted-SDK-with-libcxx-headers`). | ||||
The path that this environment variable points to **must be a directory**, and | The path that this environment variable points to **must be a directory**, and | ||||
**NOT a symlink to a directory**. | **NOT a symlink to a directory**. | ||||
* _**JOBS**_ | * _**JOBS**_ | ||||
Override the number of jobs to run simultaneously, you might want to do so on | Override the number of jobs to run simultaneously, you might want to do so on | ||||
a memory-limited machine. This may be passed to: | a memory-limited machine. This may be passed to: | ||||
▲ Show 20 Lines • Show All 175 Lines • Show Last 20 Lines |