Rustc-1.82.0

Installation of Rust

Note

Currently the rust compiler produces SSE2 instructions for 32-bit x86, causing the generated code to be broken on 32-bit systems without a SSE2-capable processor. All x86 processor models released after 2004 should be SSE2-capable. Run lscpu | grep sse2 as a test. If it outputs anything, your CPU is SSE2-capable and OK. Otherwise you may try to build this package on a SSE2-capable system with the following fix applied:

sed 's@pentium4@pentiumpro@' -i \
  compiler/rustc_target/src/spec/targets/i686_unknown_linux_gnu.rs

And copy the resulting /opt/rustc-1.82.0 to the system without SSE2 capability. But this change is still under upstream review and not tested by GLFS editors.

To install into the /opt directory, remove any existing /opt/rustc symlink and create a new directory (i.e. with a different name if trying a modified build of the same version). As the root user:

mkdir -pv /opt/rustc-1.82.0      &&
ln -svfn rustc-1.82.0 /opt/rustc

Note

If multiple versions of Rust are installed in /opt, changing to another version only requires changing the /opt/rustc symbolic link and then running ldconfig.

Create a suitable config.toml file which will configure the build.

cat > config.toml << "EOF" &&
# see config.toml.example for more possible options.
# Tell x.py the editors have reviewed the content of this file
# and updated it to follow the major changes of the building system,
# so x.py will not warn us to do such a review.
change-id = 129295

[llvm]
EOF
if [ ! -f /usr/lib32/libc.so.6 ]; then
cat >> config.toml << "EOF"
targets = "X86"

EOF
fi &&
cat >> config.toml << "EOF" &&
# When using system llvm prefer shared libraries
link-shared = true

EOF
if [ -f /usr/lib32/libc.so.6 ]; then
cat >> config.toml << "EOF"
[build]
target = [
  "x86_64-unknown-linux-gnu",
  "i686-unknown-linux-gnu",
]

EOF
fi &&
cat >> config.toml << "EOF" &&
# omit docs to save time and space (default is to build them)
docs = false

# install extended tools: cargo, clippy, etc
extended = true

# Do not query new versions of dependencies online.
locked-deps = true

# Specify which extended tools (those from the default install).
tools = ["cargo", "clippy", "rustdoc", "rustfmt"]

# Use the source code shipped in the tarball for the dependencies.
# The combination of this and the "locked-deps" entry avoids downloading
# many crates from Internet, and makes the Rustc build more stable.
vendor = true

[install]
prefix = "/opt/rustc-1.82.0"
docdir = "share/doc/rustc-1.82.0"

[rust]
channel = "stable"
description = "for GLFS #154e"

# Uncomment if FileCheck has been installed.
#codegen-tests = false

# Enable the same optimizations as the official upstream build.
lto = "thin"
codegen-units = 1

EOF
if [ -f /usr/lib32/libc.so.6 ]; then
cat >> config.toml << "EOF"
[target.x86_64-unknown-linux-gnu]
cc = "/usr/bin/gcc"
cxx = "/usr/bin/g++"
ar = "/usr/bin/gcc-ar"
ranlib = "/usr/bin/gcc-ranlib"
llvm-config = "/usr/bin/llvm-config"

[target.i686-unknown-linux-gnu]
cc = "/usr/bin/gcc"
cxx = "/usr/bin/g++"
ar = "/usr/bin/gcc-ar"
ranlib = "/usr/bin/gcc-ranlib"
EOF
else
cat >> config.toml << "EOF"
[target.x86_64-unknown-linux-gnu]
llvm-config = "/usr/bin/llvm-config"

[target.i686-unknown-linux-gnu]
llvm-config = "/usr/bin/llvm-config"
EOF
fi

Note

The above commands will create config.toml differently depending on if a few checks pass/fail. This was done to avoid confusion.

Note

The python3 x.py commands may output a warning message complaining “no codegen-backends config matched the requested path to build a codegen backend”. And the provided “suggestion” (add backend to codegen-backends in config.toml) will not silence it. This warning is bogus and it should be ignored.

Compile Rust by running the following commands:

python3 x.py build

Now, as the root user, install the package:

python3 x.py install rustc std &&
python3 x.py install --stage=1 cargo clippy rustfmt

Still as the root user, fix the installation of the documentation and symlink a Zsh completion file into the correct location and move a Bash completion file into the location recommended by the Bash completion maintainers:

rm -fv /opt/rustc-1.82.0/share/doc/rustc-1.82.0/*.old   &&
install -vm644 README.md                                \
               /opt/rustc-1.82.0/share/doc/rustc-1.82.0 &&

install -vdm755 /usr/share/zsh/site-functions      &&
ln -sfv /opt/rustc/share/zsh/site-functions/_cargo \
        /usr/share/zsh/site-functions
    
mv -v /etc/bash_completion.d/cargo \
      /usr/share/bash-completion/completions