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
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.80.1-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
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.2 plattform.
Pakkeinformasjon
-
Nedlasting (HTTP): https://static.rust-lang.org/dist/rustc-1.80.1-src.tar.xz
-
Nedlasting MD5 sum: 0b00381728b6c005e95194f7e44cff33
-
Nedlastingsstørrelse: 191 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)
Rust Avhengigheter
Påkrevd
CMake-3.30.2 og cURL-8.9.1
Note
En Internett-tilkobling er nødvendig for å bygge denne pakken.
Anbefalt
libssh2-1.11.0, LLVM-18.1.7 (bygget med -D
LLVM_LINK_LLVM_DYLIB=ON slik at rust kan lenke til systemets LLVM i
stedet for å bygge den sendte versjonen), og SQLite-3.46.1
Note
Hvis en anbefalt avhengighet ikke er installert, en sendt kopi i
Rustc kildetarballen blir bygd og brukt.
Valgfri
GDB-15.1
(brukes av testpakken hvis den er til stede), git-2.46.0 (kreves av
testpakken), cranelift,
jemalloc,
libgccjit (les parameterforklaringer i GCC-14.2.0), og libgit2
Redaktørens notater: https://wiki.linuxfromscratch.org/blfs/wiki/rust
Installasjon av Rust
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.80.1 &&
ln -svfn rustc-1.80.1 /opt/rustc
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.
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 = 125535
[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.80.1"
docdir = "share/doc/rustc-1.80.1"
[rust]
channel = "stable"
description = "for BLFS 12.2"
# 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
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; } &&
{ [ ! -e /usr/include/sqlite3.h ] ||
export LIBSQLITE3_SYS_USE_PKG_CONFIG=1; } &&
python3 x.py build
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 --keep-stage-std=1 | \
tee rustc-testlog
Tre tester navngitt tests/run-make/print-cfg
, tests/run-make/print-to-output
, og core::config::tests::download_ci_llvm
er kjent for
å mislykkes.
Som med alle store testserier, kan noen 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
Hvis sudo eller
su er påberopt for
å bytte til root
bruker, sikre at
LIBSSH2_SYS_USE_PKG_CONFIG
og
LIBSQLITE3_SYS_USE_PKG_CONFIG
er
riktig sendt ellers kan følgende kommando gjenoppbygge
cargo med sendte
kopier av libssh2 og sqlite. For sudo, bruk --preserve-env=LIB{SSH2,SQLITE3}_SYS_USE_PKG_CONFIG
alternativet. For su, ikke bruk -
eller --login
alternativene.
python3 x.py install rustc std &&
install -vm755 \
build/host/stage1-tools/*/*/{cargo{,-clippy,-fmt},clippy-driver,rustfmt} \
/opt/rustc-1.80.1/bin &&
install -vDm644 \
src/tools/cargo/src/etc/_cargo \
/opt/rustc-1.80.1/share/zsh/site-functions/_cargo &&
install -vm644 src/tools/cargo/src/etc/man/* \
/opt/rustc-1.80.1/share/man/man1
Fortsatt som root
bruker, fiks
installasjonen av dokumentasjonen og symbolkobling av Zsh fullføringsfilen på riktig plassering:
rm -fv /opt/rustc-1.80.1/share/doc/rustc-1.80.1/*.old &&
install -vm644 README.md \
/opt/rustc-1.80.1/share/doc/rustc-1.80.1 &&
install -vdm755 /usr/share/zsh/site-functions &&
ln -sfv /opt/rustc/share/zsh/site-functions/_cargo \
/usr/share/zsh/site-functions
Til slutt, deaktiver eksporterte miljøvariabler:
unset LIB{SSH2,SQLITE3}_SYS_USE_PKG_CONFIG
Parameterforklaringer
ln -svfn rustc-1.80.1
/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.
export
LIBSQLITE3_SYS_USE_PKG_CONFIG=1: Tillat
cargo for å linke til
systemets sqlite.
SSL_CERT_DIR=/etc/ssl/certs
: Arbeid
rundt et problem som forårsaker testfeil med CA
sertifikatlageroppsettet som brukes av make-ca-1.14.
--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.
--keep-stage-std 1
: denne
bryteren forhindrer x.py
test fra å bygge om hele pakken for en eller annen
ukjent årsak.
install ...
/opt/rustc-1.80.1/...: disse kommandoene
installerer eksplisitt noen Rust komponenter. De brukes i stedet
for å stole på x.py
install fordi de sistnevnte ville gjenoppbygge
disse komponentene av en eller annen ukjent grunn.