Skip to content

Commit 4eb113f

Browse files
committed
[docs] update note about musl builds
1 parent c2af250 commit 4eb113f

File tree

2 files changed

+7
-2
lines changed

2 files changed

+7
-2
lines changed

site/src/changelog.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,7 @@ policy](https://nexte.st/docs/stability/) for how versioning works with cargo-ne
4040
### Miscellaneous
4141

4242
- 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.
43+
- 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.
4344

4445
## [0.9.88] - 2024-01-15
4546

site/src/docs/installation/pre-built-binaries.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,12 @@ The instructions below are suitable for both end users and CI. These links will
3232
curl -LsSf https://get.nexte.st/latest/linux | tar zxf - -C ${CARGO_HOME:-~/.cargo}/bin
3333
```
3434

35+
For a statically-linked binary with no runtime library dependencies, based on [musl](https://musl.libc.org/):
36+
37+
```
38+
curl -LsSf https://get.nexte.st/latest/linux-musl | tar zxf - -C ${CARGO_HOME:-~/.cargo}/bin
39+
```
40+
3541
=== ":material-linux: Linux aarch64"
3642

3743
!!! info
@@ -188,14 +194,12 @@ The latest nextest release is available at:
188194

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

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

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

198203
[^glibc]: The standard Linux binaries target glibc, and have a minimum requirement of glibc 2.27 (Ubuntu 18.04).
199-
[^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.
200204

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

0 commit comments

Comments
 (0)