File: usage.txt

package info (click to toggle)
rustc-web 1.78.0%2Bdfsg1-2~deb11u3
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 1,245,360 kB
  • sloc: xml: 147,985; javascript: 18,022; sh: 11,083; python: 10,265; ansic: 6,172; cpp: 5,023; asm: 4,390; makefile: 4,269
file content (49 lines) | stat: -rw-r--r-- 2,620 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
The build system of cg_clif.

USAGE:
    ./y.sh prepare [--out-dir DIR] [--download-dir DIR]
    ./y.sh build [--debug] [--sysroot none|clif|llvm] [--out-dir DIR] [--download-dir DIR] [--no-unstable-features] [--frozen]
    ./y.sh test [--debug] [--sysroot none|clif|llvm] [--out-dir DIR] [--download-dir DIR] [--no-unstable-features] [--frozen] [--skip-test TESTNAME]
    ./y.sh abi-cafe [--debug] [--sysroot none|clif|llvm] [--out-dir DIR] [--download-dir DIR] [--no-unstable-features] [--frozen]
    ./y.sh bench [--debug] [--sysroot none|clif|llvm] [--out-dir DIR] [--download-dir DIR] [--no-unstable-features] [--frozen]

OPTIONS:
    --debug
            Build cg_clif and the standard library in debug mode rather than release mode.
            Warning: An unoptimized cg_clif is very slow.

    --sysroot none|clif|llvm
            Which sysroot libraries to use:
            `none` will not include any standard library in the sysroot.
            `clif` will build the standard library using Cranelift.
            `llvm` will use the pre-compiled standard library of rustc which is compiled with LLVM.

    --out-dir DIR
            Specify the directory in which the download, build and dist directories are stored.
            By default this is the working directory.

    --download-dir DIR
            Specify the directory in which the download directory is stored. Overrides --out-dir.

    --no-unstable-features
            Some features are not yet ready for production usage. This option will disable these
            features. This includes the JIT mode and inline assembly support.

    --frozen
            Require Cargo.lock and cache are up to date

    --skip-test TESTNAME
            Skip testing the TESTNAME test. The test name format is the same as config.txt.

    --use-backend NAME
            Use the existing Cranelift (or other) backend of the rustc with which we built.
            Warning: This is meant for use in rust's CI only!

REQUIREMENTS:
    * Rustup: By default rustup is used to install the right nightly version. If you don't want to
      use rustup, you can manually install the nightly version indicated by rust-toolchain.toml and
      point the CARGO, RUSTC and RUSTDOC env vars to the right executables.
    * Git: Git is used for applying patches and on Windows for downloading test repos.
    * Curl and tar (non-Windows only): Used by `./y.sh prepare` to download a single commit for
      repos. Git will be used to clone the whole repo when using Windows.
    * [Hyperfine](https://github.com/sharkdp/hyperfine/): Used for benchmarking with `./y.sh bench`.