Skip to content

Correctly document rustup defaults on Windows #1753

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
nrc merged 1 commit into from
Apr 15, 2019
Merged

Correctly document rustup defaults on Windows #1753

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 16 additions & 8 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -423,17 +423,25 @@ of Visual Studio 2013 (or later) or the Visual C++ Build Tools
check the "C++ tools" option. No additional software installation is
necessary for basic use of the GNU build.

By default rustup on Windows configures Rust to target the 32-bit MSVC
ABI, that is the `i686-pc-windows-msvc` target triple. More
specifically, the toolchains that rustup chooses to install, unless
By default rustup on Windows configures Rust to target the MSVC
ABI, that is a target triple of either `i686-pc-windows-msvc` or
`x86_64-pc-windows-msvc` depending on the CPU architecture of the
host Windows OS. The toolchains that rustup chooses to install, unless
told otherwise through the [toolchain specification], will be compiled
to run on a `i686-pc-windows-msvc` host, and will target that platform
by default. When you write `rustup update nightly`, rustup interprets
it as `rustup update nightly-i686-pc-windows-msvc`. You can change this
behavior with `rustup set default-host` or during installation.
to run on that target triple host and will target that triple by default.

You can change this behavior with `rustup set default-host` or during installation.

For example, to explicitly select the 32-bit MSVC host:

```console
$ rustup set default-host i686-pc-windows-msvc
```

Or to choose the 64 bit GNU toolchain:

```console
$ rustup set default-host x86_64-pc-windows-msvc
$ rustup set default-host x86_64-pc-windows-gnu
```

[toolchain specification]: #toolchain-specification
Expand Down
⚡