6 ./miri install <flags>:
7 Installs the miri driver and cargo-miri. <flags> are passed to `cargo
8 install`. Sets up the rpath such that the installed binary should work in any
12 Just build miri. <flags> are passed to `cargo build`.
15 Just check miri. <flags> are passed to `cargo check`.
18 Build miri, set up a sysroot and then run the test suite. <flags> are passed
19 to the final `cargo test` invocation.
22 Build miri, set up a sysroot and then run the driver with the given <flags>.
24 The commands above also exist in a "-debug" variant (e.g. "./miri run-debug
25 <flags>") which uses debug builds instead of release builds, for faster build
26 times and slower execution times.
29 Format all sources and tests. <flags> are passed to `rustfmt`.
31 ./miri clippy <flags>:
32 Format all sources and tests. <flags> are passed to `cargo clippy`.
37 If already set, the "sysroot setup" step is skipped.
40 Pass extra flags to all cargo invocations.
45 TARGET=$(rustc --version --verbose | grep "^host:" | cut -d ' ' -f 2)
46 SYSROOT=$(rustc --print sysroot)
47 LIBDIR=$SYSROOT/lib/rustlib/$TARGET/lib
48 # macOS does not have a useful readlink/realpath so we have to use Python instead...
49 MIRIDIR=$(dirname "$(python3 -c 'import os, sys; print(os.path.realpath(sys.argv[1]))' "$0")")
50 if ! test -d "$LIBDIR"; then
51 echo "Something went wrong determining the library dir."
52 echo "I got $LIBDIR but that does not exist."
53 echo "Please report a bug at https://github.com/rust-lang/miri/issues."
56 if [ -z "$CARGO_INCREMENTAL" ]; then
57 # Default CARGO_INCREMENTAL to 1.
58 export CARGO_INCREMENTAL=1
60 if [ -z "$CARGO_TARGET_DIR" ]; then
61 # Share target dir between `miri` and `cargo-miri`.
62 export CARGO_TARGET_DIR="$MIRIDIR/target"
64 # We set the rpath so that Miri finds the private rustc libraries it needs.
65 # We enable debug-assertions to get tracing.
66 # We enable line-only debuginfo for backtraces.
67 export RUSTFLAGS="-C link-args=-Wl,-rpath,$LIBDIR -C debug-assertions -C debuginfo=1 $RUSTFLAGS"
71 # Build a sysroot and set MIRI_SYSROOT to use it. Arguments are passed to `cargo miri setup`.
73 # Build once, for the user to see.
74 cargo run $CARGO_BUILD_FLAGS --manifest-path "$MIRIDIR"/cargo-miri/Cargo.toml -- miri setup "$@"
75 # Call again, to just set env var.
76 export MIRI_SYSROOT="$(cargo run $CARGO_BUILD_FLAGS --manifest-path "$MIRIDIR"/cargo-miri/Cargo.toml -q -- miri setup --print-sysroot "$@")"
79 # Prepare and set MIRI_SYSROOT. Respects `MIRI_TEST_TARGET` and takes into account
80 # locally built vs. distributed rustc.
82 if [ -n "$MIRI_SYSROOT" ]; then
83 # Sysroot already set, use that.
86 # We need to build a sysroot.
87 if [ -n "$MIRI_TEST_TARGET" ]; then
88 build_sysroot --target "$MIRI_TEST_TARGET"
100 # Determine flags passed to all cargo invocations.
101 # This is a bit more annoying that one would hope due to
102 # <https://github.com/rust-lang/cargo/issues/6992>.
105 CARGO_INSTALL_FLAGS="--target $TARGET --debug $CARGO_EXTRA_FLAGS"
106 CARGO_BUILD_FLAGS="--target $TARGET $CARGO_EXTRA_FLAGS"
109 CARGO_INSTALL_FLAGS="--target $TARGET $CARGO_EXTRA_FLAGS"
110 CARGO_BUILD_FLAGS="--target $TARGET --release $CARGO_EXTRA_FLAGS"
116 install|install-debug)
117 # "--locked" to respect the Cargo.lock file if it exists,
118 # "--offline" to avoid querying the registry (for yanked packages).
119 cargo install $CARGO_INSTALL_FLAGS --path "$MIRIDIR" --force --locked --offline "$@"
120 cargo install $CARGO_INSTALL_FLAGS --path "$MIRIDIR"/cargo-miri --force --locked --offline "$@"
123 # Check, and let caller control flags.
124 cargo check $CARGO_BUILD_FLAGS --manifest-path "$MIRIDIR"/Cargo.toml --all-targets "$@"
125 cargo check $CARGO_BUILD_FLAGS --manifest-path "$MIRIDIR"/cargo-miri/Cargo.toml "$@"
128 # Build, and let caller control flags.
129 cargo build $CARGO_BUILD_FLAGS --manifest-path "$MIRIDIR"/Cargo.toml "$@"
130 cargo build $CARGO_BUILD_FLAGS --manifest-path "$MIRIDIR"/cargo-miri/Cargo.toml "$@"
132 test|test-debug|bless|bless-debug)
133 # First build and get a sysroot.
134 cargo build $CARGO_BUILD_FLAGS
138 export MIRI_BLESS="Gesundheit"
141 # Then test, and let caller control flags.
142 # Only in root project and ui_test as `cargo-miri` has no tests.
143 cargo test $CARGO_BUILD_FLAGS "$@"
144 cargo test $CARGO_BUILD_FLAGS --manifest-path ui_test/Cargo.toml "$@"
147 # Scan for "--target" to set the "MIRI_TEST_TARGET" env var so
148 # that we set the MIRI_SYSROOT up the right way.
149 if [ -z "$MIRI_TEST_TARGET" ]; then
151 if [ "$LAST_ARG" = "--target" ]; then
153 export MIRI_TEST_TARGET="$ARG"
159 # First build and get a sysroot.
160 cargo build $CARGO_BUILD_FLAGS
162 # Then run the actual command.
163 exec cargo run $CARGO_BUILD_FLAGS -- --sysroot "$MIRI_SYSROOT" "$@"
166 find "$MIRIDIR" -not \( -name target -prune \) -name '*.rs' \
167 | xargs rustfmt --edition=2021 --config-path "$MIRIDIR/rustfmt.toml" "$@"
170 cargo clippy $CARGO_BUILD_FLAGS --manifest-path "$MIRIDIR"/Cargo.toml --all-targets "$@"
171 cargo clippy $CARGO_BUILD_FLAGS --manifest-path "$MIRIDIR"/ui_test/Cargo.toml --all-targets "$@"
172 cargo clippy $CARGO_BUILD_FLAGS --manifest-path "$MIRIDIR"/cargo-miri/Cargo.toml "$@"
175 if [ -n "$COMMAND" ]; then
176 echo "Unknown command: $COMMAND"