From a497638cd128804c07c26aded29f800aead8743b Mon Sep 17 00:00:00 2001 From: Oskar Date: Mon, 27 Feb 2023 17:58:25 +0100 Subject: [PATCH] Document install settings for non-glibc systems (#1787) See #1786 --- doc/manual_install.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/doc/manual_install.md b/doc/manual_install.md index f8a6f1ad4a..b9a905f0c6 100644 --- a/doc/manual_install.md +++ b/doc/manual_install.md @@ -7,6 +7,13 @@ Compilation is only tested with very recent stable versions of `rustc`. If you use a distro with older Rust packages, consider using [rustup](https://rustup.rs/) to install a newer toolchain. +On systems using alternative (non-glibc) C standard libraries like `musl`, `cargo` must be configured to not link the libc statically. Otherwise, blocks needing to link to system libraries like `temperature`, `sound` (for pulseaudio) and maybe others will not be usable due to segmentation faults. To configure `cargo` for this, just add this to your `~/.cargo/config.toml`: + +```toml +[build] +rustflags = ["-C", "target-feature=-crt-static"] +``` + ## Build and Install from Source ```shell