Beyond Linux® From Scratch (System V Utgave) - Versjon 12.1

Chapter 13. Programmering

Rustc-1.76.0

Introduksjon til Rust

Rust programmeringsspråket er utformet for å være et trygt, samtidig, praktisk språk.

Denne pakken oppdateres i en seksukers utgivelsessyklus. Fordi den er en så stor og treg pakke å bygge, er for øyeblikket bare nødvendig av noen få pakker i denne boken, og spesielt fordi nyere versjoner har en tendens til å bryte eldre mozilla pakker, mener BLFS redaktørene at den skal bare oppdateres når det er nødvendig (enten for å fikse problemer, eller for å la en ny versjon av en pakke bygges).

Som med mange andre programmeringsspråk, rustc (rustkompilatoren) trenger en binær for oppstartssekvensen. Den vil laste ned en stage0 binær ved starten av bygningen, så du kan ikke kompilere den uten en Internett tilkobling.

[Note]

Note

Selv om BLFS vanligvis installeres i /usr, når du senere oppgraderer til en nyere versjon av rust de gamle bibliotekene i /usr/lib/rustlib vil forbli, med div hasher i navnene deres, men vil ikke være brukbare og vil kaste bort plass. Redaktører anbefaler å plassere filene i /opt mappen. Spesielt hvis du har grunn til å gjenoppbygge med en modifisert konfigurasjon (f.eks. ved å bruke sendt LLVM etter å ha bygget med delt LLVM, kanskje for å kompilere crates for arkitekturer som BLFS LLVM bygget ikke støtter) det er mulig for installasjonen å etterlate et ødelagt cargo program. I en slik situasjon, fjern enten den eksisterende installasjonen først, eller bruk et annet prefiks som f.eks /opt/rustc-1.76.0-build2.

Hvis du foretrekker det, kan du selvfølgelig endre prefikset til /usr.

Det nåværende rustbuild byggesystemet vil bruke alle prosessorer, selv om den ikke skalerer godt og ofte faller tilbake til bare å bruke én kjerne mens du venter på at et bibliotek skal kompileres. Imidlertid kan det stort sett begrenses til et spesifisert antall prosessorer av en kombinasjon av å legge til bryteren --jobs <N> (f.eks. '--jobs 4' for å begrense til 4 prosessorer) på hver påkalling av python3 x.py og ved hjelp av en miljøvariabel CARGO_BUILD_JOBS=<N>. For øyeblikket er dette ikke effektivt når noen av rustc testene kjøres.

Den nåværende versjonen av rusts num_cpus crate gjenkjenner nå at cgroups kan brukes til å begrense hvilke prosessorer det er tillatt å bruke. Så hvis din maskin mangler DRAM (vanligvis mindre enn 2 GB DRAM per kjerne) som kan være et alternativ til å ta CPUer offline. Les the section called “Bruk Linux Control Group for å begrense ressursbruken” for hvordan du bruker en cgroup.

For øyeblikket Rust gir ingen garantier for en stabil ABI.

[Note]

Note

Rustc bygger som standard for ALLE støttede arkitekturer, ved å bruke en sendt kopi av LLVM. I BLFS er bygget bare for X86 arkitektur. Hvis du har tenkt å utvikle rust crates, kan det hende at denne konstruksjonen ikke er bra nok til dine formål.

Byggetidene for denne versjonen når den gjentas på samme maskin er ofte rimelig konsekvent, men som med alle kompilatorer som bruker rustc det kan være noen veldig langsomme avvikere.

Denne pakken er kjent for å bygge og fungere riktig ved å bruke en LFS 12.1 plattform.

Pakkeinformasjon

  • Nedlasting (HTTP): https://static.rust-lang.org/dist/rustc-1.76.0-src.tar.xz

  • Nedlasting MD5 sum: 14a8ac688b461a3127090cad513aee05

  • Nedlastingsstørrelse: 155 MB

  • Estimert diskplass som kreves: 8.9 GB (298 MB installert); legg til 6,4 GB hvis du kjører testene

  • Estimert byggetid: 6.7 SBU (inkludert nedlastingstid; legg til 6,2 SBU for tester, begge med parallellisme=8)

Ytterligere Nedlastinger

Rust Avhengigheter

Påkrevd

CMake-3.28.3 og cURL-8.6.0

[Note]

Note

En Internett tilkobling er nødvendig for å bygge denne pakken.

Anbefalt

libssh2-1.11.0 og LLVM-17.0.6 (bygget med -DLLVM_LINK_LLVM_DYLIB=ON slik at rust kan lenke til systemets LLVM i stedet for å bygge den sendte versjonen)

[Note]

Note

Hvis en anbefalt avhengighet ikke er installert, en sendt kopi i Rustc kildetarballen blir bygd og brukt.

Valgfri

GDB-14.1 (brukes av testpakken hvis den er til stede), git-2.44.0 (kreves av testpakken), cranelift, jemalloc, libgccjit (les parameterforklaringer i GCC-13.2.0), og libgit2

Redaktørens notater: https://wiki.linuxfromscratch.org/blfs/wiki/rust

Installasjon av Rust

[Note]

Note

For øyeblikket produserer rustkompilatoren SSE2 instruksjoner for 32-bit x86, som forårsaker at den genererte koden blir ødelagt på 32-bits systemer uten en SSE2 kompatibel prosessor. Alle x86 prosessormodeller utgitt etter 2004 skal være SSE2 kompatibel. Kjør lscpu | grep sse2 som en test. Hvis den gir ut noe, er CPUen din SSE2 kompatibel og OK. Ellers kan du prøve å bygge denne pakken på et SSE2 kompatibelt system med følgende rettelse brukt: 

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

Og kopiere resultatet /opt/rustc-1.76.0 til systemet uten SSE2 kapasitet. Men denne endringen er fortsatt under oppstrøms gjennomgang og ikke testet av BLFS redaktører.

For å installere i /opt mappen, fjerne evt eksisterende /opt/rustc symbolkobling og opprett en ny mappe (dvs. med et annet navn hvis du prøver en modifisert versjon av samme versjon). Som root bruker: 

mkdir -pv /opt/rustc-1.76.0      &&
ln -svfn rustc-1.76.0 /opt/rustc
[Note]

Note

Hvis flere versjoner av Rust er installert i /opt, endre til en annen versjonen krever bare å endre /opt/rustc symbolsk lenke og deretter kjøre ldconfig.

Hvis du kjører testpakken, bruk en oppdatering for å forhindre byggesystemet fra å gjenoppbygge kompilatoren unødvendig: 

patch -Np1 -i ../rustc-1.76.0-testsuite_fix-1.patch

Opprett en passende config.toml fil som vil konfigurere bygget. 

cat << EOF > config.toml
# see config.toml.example for more possible options
# See the 8.4 book for an old example using shipped LLVM
# e.g. if not installing clang, or using a version before 13.0

# 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 = 118703

[llvm]
# by default, rust will build for a myriad of architectures
targets = "X86"

# When using system llvm prefer shared libraries
link-shared = true

[build]
# 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.76.0"
docdir = "share/doc/rustc-1.76.0"

[rust]
channel = "stable"
description = "for BLFS 12.1"

# BLFS used to not install the FileCheck executable from llvm,
# so disabled codegen tests.  The assembly tests rely on FileCheck
# and cannot easily be disabled, so those will anyway fail if
# FileCheck has not been installed.
#codegen-tests = false

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

[target.x86_64-unknown-linux-gnu]
# NB the output of llvm-config (i.e. help options) may be
# dumped to the screen when config.toml is parsed.
llvm-config = "/usr/bin/llvm-config"

[target.i686-unknown-linux-gnu]
# NB the output of llvm-config (i.e. help options) may be
# dumped to the screen when config.toml is parsed.
lvm-config = "/usr/bin/llvm-config"
EOF
[Note]

Note

python3 x.py kommandoer kan gi en advarselsmelding klagende på “no codegen-backends config matched the requested path to build a codegen backend”. Og det gitte “forslaget” (add backend to codegen-backends in config.toml) vil ikke stilne det. Denne advarselen er bogus og det bør ignoreres.

Kompiler Rust ved å kjøre følgende kommandoer: 

{ [ ! -e /usr/include/libssh2.h ] ||
  export LIBSSH2_SYS_USE_PKG_CONFIG=1; } &&
python3 x.py build
[Note]

Note

Testpakken vil generere noen meldinger i system log for feller på ugyldige opkoder, og for segmenteringsfeil. I seg selv er disse ingenting å bekymre seg for, bare en måte for test å avslutte.

Å kjøre testene (igjen ved å bruke alle tilgjengelige CPUer) utsted: 

SSL_CERT_DIR=/etc/ssl/certs \
python3 ./x.py test --verbose --no-fail-fast | tee rustc-testlog

To tester,tests/ui/issues/issue-21763.rs og tests/debuginfo/regression-bad-location-list-67992.rs, er kjent for å mislykkes.

Hvis FileCheck fra LLVM ikke har blitt installert, alle 47 tester fra “assembly” pakken vil mislykkes.

Som med alle store testserier, kan andre tester mislykkes på noen maskiner - hvis antallet ekstra feil er lavt, sjekk loggen for "failures:" og se gjennom linjene over det, spesielt 'stderr:' linjer. Enhver omtale av SIGSEGV eller signal 11 i en sviktende test er en grunn til bekymring.

Hvis du får noen andre sviktende tester som rapporterer et utgavenummer, så bør du søke etter det problemet. For eksempel når rustc >= 1.41.1 ble bygget med en versjon av sysllvm før 10.0 testen for problem 69225 mislyktes https://github.com/rust-lang/rust/issues/69225 og det burde være betraktet som en kritisk feil (de ga ut 1.41.1 på grunn av det). De fleste andre feil vil ikke være kritiske.

Derfor bør du bestemme antall feil.

Antall tester som har bestått og ikke bestått finner du ved å kjøre: 

grep '^test result:' rustc-testlog |
 awk '{sum1 += $4; sum2 += $6} END { print sum1 " passed; " sum2 " failed" }'

De andre tilgjengelige feltene er $8 for de som ble ignorert (dvs. hoppet over), $10 for "målt" og $12 for "filtrert ut", men begge de to siste er sannsynligvis null.

Nå, som root bruker, installer pakken:

[Note]

Note

Hvis sudo eller su er påberopt for å bytte til root bruker, sikre at LIBSSH2_SYS_USE_PKG_CONFIG er korrekt sendt ellers vil følgende kommando gjenoppbygge denne pakken fullstendig. For sudo, bruk --preserve-env=LIBSSH2_SYS_USE_PKG_CONFIG alternativet. For su, ikke bruk - eller --login alternativene. 

python3 x.py install

Bygningssystemet prøver å installere noen filer to ganger, og under det andre forsøket gir det nytt navn til den gamle (installert i det første forsøk) med .old suffiks. Som root bruker, fjern disse filene: 

find /opt/rustc-1.76.0 -name "*.old" -delete

Fortsatt som root bruker, symbolkoble en Zsh fullføringsfilen på riktig plassering: 

install -vdm755 /usr/share/zsh/site-functions      &&
ln -sfv /opt/rustc/share/zsh/site-functions/_cargo \
        /usr/share/zsh/site-functions

Til slutt, deaktiver LIBSSH2_SYS_USE_PKG_CONFIG variabelen: 

unset LIBSSH2_SYS_USE_PKG_CONFIG

Parameterforklaringer

ln -svfn rustc-1.76.0 /opt/rustc: hvis dette ikke er den første bruken av /opt/rustc symbolkobling, overskriv den ved å tvinge, og bruk '-n'-flagget for å unngå å få forvirrende resultater fra f.eks. ls -l.

targets = "X86": dette unngår å bygge alt tilgjengelig linux krysskompilatorer (AArch64, MIPS, PowerPC, SystemZ, etc). Dessverre, rust insisterer på å installere kildefiler for disse nedenfor /opt/rustc/lib/src.

extended = true: dette installerer flere verktøy (spesifisert av tools oppføring) ved siden av rustc.

tools = ["cargo", "clippy", "rustdoc", "rustfmt"]: bygg bare verktøyene fra 'standard' profilen i binær kommando rustup som anbefales for de fleste brukere. De andre verktøyene er neppe nyttige med mindre du bruker (gammel) kode analysatorer eller redigering av standardbiblioteket.

channel = "stable": dette sikrer at kun stabile funksjoner kan brukes, standard i config.toml er å bruke utviklingsfunksjoner, som ikke passer for en utgitt versjon.

[target.x86_64-unknown-linux-gnu]: syntaksen til config.toml krever en llvm-config oppføring for hvert mål som system-llvm skal brukes for. Endre målet til [target.i686-unknown-linux-gnu] hvis du bygger på 32-bit x86. Hele denne delen kan utelates hvis du ønsker å bygge mot den sendte llvm, eller ikke har clang, men den resulterende bygget vil være større og ta lengre tid.

export LIBSSH2_SYS_USE_PKG_CONFIG=1: tillat cargo å koble til systemets libssh2.

SSL_CERT_DIR=/etc/ssl/certs: Arbeid rundt et problem som forårsaker testfeil med CA sertifikatlageroppsettet som brukes av make-ca-1.13.

--verbose: denne bryteren kan noen ganger gi mer informasjon om en test som mislykkes.

--no-fail-fast: denne bryteren sikrer at testpakken ikke vil stoppe ved den første feilen.

Konfigurere Rust

Konfigurasjonsinformasjon

Hvis du har installert rustc i /opt, må du oppdatere følgende konfigurasjonsfiler slik at rustc er riktig funnet av andre pakker og systemprosesser.

Som root bruker, opprett /etc/profile.d/rustc.sh filen: 

cat > /etc/profile.d/rustc.sh << "EOF"
# Begin /etc/profile.d/rustc.sh

pathprepend /opt/rustc/bin           PATH

# Include /opt/rustc/man in the MANPATH variable to access manual pages
pathappend  /opt/rustc/share/man     MANPATH

# End /etc/profile.d/rustc.sh
EOF

Oppdater gjeldende PATH umiddelbart etter installasjonen for ditt nåværende skall som en vanlig bruker: 

source /etc/profile.d/rustc.sh

Innhold

Installerte Programmer: cargo-clippy, cargo-fmt, cargo, clippy-driver, rust-gdb, rust-gdbgui, rust-lldb, rustc, rustdoc, og rustfmt
Installerte Biblioteker: librustc-driver-<16-byte-hash>.so, libstd-<16-byte-hash>.so, og libtest-<16-byte-hash>.so
Installerte Mapper: ~/.cargo, /opt/rustc, symbolsk lenke til /opt/rustc-1.76.0

Korte Beskrivelser

cargo-clippy

gir lint sjekker for en cargo pakke

cargo-fmt

formaterer alle bin og lib filer i gjeldende crate ved hjelp av rustfmt

cargo

er Pakkebehandler for Rust

clippy-driver

gir lint sjekker for rust

rust-gdb

er et innpakningsskript for gdb, som trekker inn Python pretty-printing moduler installert i /opt/rustc-1.76.0/lib/rustlib/etc

rust-gdbgui

er et innpakningsskript for et grafisk grensesnitt til gdb som kjører i en nettleser

rust-lldb

er et innpakningsskript for LLDB (LLVM-feilsøkeren) rekke inn Python pretty-printing modulene

rustc

er rust kompilatoren

rustdoc

genererer dokumentasjon fra rust kildekode

rustfmt

formaterer rust kode

libstd-<16-byte-hash>.so

er Rust Standard Bibliotek, grunnlaget for flyttbar Rust programvare