83

I am trying to create a static executable with Rust. I am not trying to statically link a particular library, I am trying to create a executable which does not use dynamic linking at all. I have the following (otherwise working) test:

$ cat hello.rs
fn main()
    {
    print!("Hello, world!\n");
    }
$ rustc hello.rs -o hello
$ file hello
hello: ELF 64-bit LSB shared object, x86-64, version 1 (SYSV),
 dynamically linked, interpreter /lib64/ld-linux-x86-64.so.2, [etc]

Note the dynamically linked, interpreter /lib64/ld-linux-x86-64.so.2. Static executables have statically linked instead. (And in my case corrupted section header size, although I would be pleasantly astonished if I can convince Rust to replicate that.)

What options do I need to pass to rustc to get it to generate a actual static executable (for concreteness: one which even file agrees is statically linked).

13
  • Perhaps the -C link-args='...' option can help you?
    – llogiq
    Aug 2, 2015 at 13:49
  • Note that your question only pertains to Linux - AFAIK, you cannot statically link executables on OS X. I'm not sure about Windows.
    – Shepmaster
    Aug 2, 2015 at 14:41
  • 3
    You might want to take a look at using musl instead of glibc wih rust Aug 2, 2015 at 15:14
  • 1
    This internals thread may also be of interest. It also points towards musl.
    – Shepmaster
    Aug 2, 2015 at 16:40
  • 1
    @Mikhail, I don't know the precise details on other systems, but on linux (and give or take register allocation most other unixes) print bottoms out (via either function calls or inlining) to mov eax,1 ; mov ebx,fdout ; mov ecx bufptr ; mov edx buflen. It's probably possible to design a system call interface that truly requires dynamic linking, but only a raging incompetent would do so for a general purpose OS.
    – David X
    Aug 2, 2015 at 22:21

2 Answers 2

68

Since Rust 1.19, you can statically link the C runtime (CRT) to avoid this very common situation on Windows:

The program can't start because VCRUNTIME140.dll is missing from your computer. Try reinstalling the program to fix this problem.

Add this to your .cargo/config file, using the appropriate target triple for your platform:

[target.x86_64-pc-windows-msvc]
rustflags = ["-C", "target-feature=+crt-static"]

An alternative to editing .cargo/config is to pass -C target-feature=+crt-static to rustc by hand.

See also:

3
66

Rust statically links everything but glibc (and libgcc, iirc) by default.

If you want to get a 100% statically linked binary, you can use MUSL with 1.1. https://github.com/rust-lang/rust/pull/24777 is the initial support, we hope to make it much easier to use in the future.


EDIT: It's distributed via rustup now, so you can add x86_64-unknown-linux-musl as a target : rustup target add x86_64-unknown-linux-musl

And then build to this target : cargo build --target=x86_64-unknown-linux-musl

5
  • 9
    In 2019, is musl still the only way to get 100% statically linked binary? Can we get 100% statically linked binary with glibc now?
    – Nawaz
    Apr 11, 2019 at 15:20
  • I don’t believe that glibc really intends to ever support it as a first-class thing, though I could be wrong. Apr 11, 2019 at 15:21
  • Hey Steve, checking in in 2021; any updates that make this easier per your "we hope to make it much easier in the future"?
    – weberc2
    Apr 23, 2021 at 20:35
  • 35
    It's distributed via rustup now, so you can "rustup target add x86_64-unknown-linux-musl" and then "cargo build --target=x86_64-unknown-linux-musl" Apr 25, 2021 at 14:22
  • 2
    @SteveKlabnik that should honestly be its own answer! Thanks.
    – gonzo
    Aug 3, 2021 at 16:15

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.