Skip to content

Commit

Permalink
Update notes about static linking and MUSL
Browse files Browse the repository at this point in the history
People often use the edition guide as general documentation of
capabilities, not just for Rust 2018. There is extensive information
on the web suggesting that Rust *only* supports static linking with
MUSL. Add a note documenting current capabilities, so that people know
they have a choice of libc implementations even if they need static
linking.
  • Loading branch information
joshtriplett committed Nov 19, 2020
1 parent b91a9a8 commit d387919
Show file tree
Hide file tree
Showing 2 changed files with 4 additions and 0 deletions.
1 change: 1 addition & 0 deletions src/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -84,6 +84,7 @@
- [Global allocators](rust-2018/platform-and-target-support/global-allocators.md)
- [MSVC toolchain support](rust-2018/platform-and-target-support/msvc-toolchain-support.md)
- [MUSL support for fully static binaries](rust-2018/platform-and-target-support/musl-support-for-fully-static-binaries.md)
- Note: current Rust (as of 1.48) supports static binaries with either glibc or MUSL, so you can select whichever libc you need or prefer.
- [`cdylib` crates for C interoperability](rust-2018/platform-and-target-support/cdylib-crates-for-c-interoperability.md)

## The Next Edition
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,9 @@

![Minimum Rust version: 1.1](https://img.shields.io/badge/Minimum%20Rust%20Version-1.1-brightgreen.svg)

(Note: current Rust (as of 1.48) supports static linking with either glibc or
MUSL, so you can select whichever libc you need or prefer.)

By default, Rust will statically link all Rust code. However, if you use the
standard library, it will dynamically link to the system's `libc`
implementation.
Expand Down

0 comments on commit d387919

Please sign in to comment.