Skip to content

Commit

Permalink
[docs] update note about musl builds
Browse files Browse the repository at this point in the history
  • Loading branch information
sunshowers committed Feb 10, 2025
1 parent c2af250 commit 4eb113f
Show file tree
Hide file tree
Showing 2 changed files with 7 additions and 2 deletions.
1 change: 1 addition & 0 deletions site/src/changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,7 @@ policy](https://nexte.st/docs/stability/) for how versioning works with cargo-ne
### Miscellaneous

- Nextest now documents the safety of [altering the environment within tests](https://nexte.st/docs/configuration/env-vars/#altering-the-environment-within-tests). As a result of nextest's [process-per-test model](https://nexte.st/docs/design/why-process-per-test/), it is generally safe to call [`std::env::set_var`](https://doc.rust-lang.org/std/env/fn.set_var.html) and [`remove_var`](https://doc.rust-lang.org/std/env/fn.remove_var.html) at the beginning of tests.
- With Rust 1.84 and above, builds using [musl](https://musl.libc.org) no longer have [slow process spawns](https://github.com/rust-lang/rust/issues/99740). With this improvement, glibc and musl builds of nextest are now roughly at par, and should have similar performance characteristics.

## [0.9.88] - 2024-01-15

Expand Down
8 changes: 6 additions & 2 deletions site/src/docs/installation/pre-built-binaries.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,12 @@ The instructions below are suitable for both end users and CI. These links will
curl -LsSf https://get.nexte.st/latest/linux | tar zxf - -C ${CARGO_HOME:-~/.cargo}/bin
```

For a statically-linked binary with no runtime library dependencies, based on [musl](https://musl.libc.org/):

```
curl -LsSf https://get.nexte.st/latest/linux-musl | tar zxf - -C ${CARGO_HOME:-~/.cargo}/bin
```

=== ":material-linux: Linux aarch64"

!!! info
Expand Down Expand Up @@ -188,14 +194,12 @@ The latest nextest release is available at:

Nextest's CI isn't run on these platforms -- these binaries most likely work but aren't guaranteed to do so.

- [**get.nexte.st/latest/linux-musl**](https://get.nexte.st/latest/linux-musl) for Linux x86_64, with musl libc[^musl]
- [**get.nexte.st/latest/windows-x86**](https://get.nexte.st/latest/windows-x86) for Windows i686
- [**get.nexte.st/latest/freebsd**](https://get.nexte.st/latest/freebsd) for FreeBSD x86_64
- [**get.nexte.st/latest/illumos**](https://get.nexte.st/latest/illumos) for illumos x86_64

These archives contain a single binary called `cargo-nextest` (`cargo-nextest.exe` on Windows). Add this binary to a location on your PATH.

[^glibc]: The standard Linux binaries target glibc, and have a minimum requirement of glibc 2.27 (Ubuntu 18.04).
[^musl]: Rust's musl target currently has [a bug](https://github.com/rust-lang/rust/issues/99740) that Rust's glibc target doesn't have. This bug means that nextest's linux-musl binary has slower test runs and is susceptible to signal-related races. Only use the linux-musl binary if the standard Linux binary doesn't work in your environment.

For a full specification of release URLs, see [_Release URLs_](release-urls.md).

0 comments on commit 4eb113f

Please sign in to comment.