Beyond Linux® From Scratch (systemd Utgave) - Versjon r12.4-696

Kapittel 17. Nettverksbiblioteker

cURL-8.17.0

Introduksjon til cURL

cURL pakken inneholder et verktøy og et bibliotek som brukes til å overføre filer med URL syntaks til hvilken som helst av følgende protokoller: DICT, FILE, FTP, FTPS, GOPHER, GOPHERS, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, MQTT, POP3, POP3S, RTSP, SMB, SMBS, SMTP, SMPTS, TELNET og TFTP. Dens evne til både å laste ned og laste opp filer kan integreres i andre programmer for å støtte funsksjoner som å strømme media.

[Notat]

Notat

Utviklingsversjoner av BLFS kan kanskje ikke bygge eller kjøre noen pakker riktig hvis LFS eller avhengigheter har blitt oppdatert siden de siste stabile versjonene av bøkene.

Pakkeinformasjon

  • Nedlasting (HTTP): https://curl.se/download/curl-8.17.0.tar.xz

  • Nedlasting MD5 sum: 7a9d4b772fc56d68479b0416f234105a

  • Nedlastingsstørrelse: 2.7 MB

  • Estimert diskplass som kreves: 49 MB (legg til 64 MB for tester)

  • Estimert byggetid: 0.3 SBU (legg til 4.5 SBU for tester (uten valgrind, legg til 17 SBU med valgrind) alle bruker parallellisme=4)

cURL Avhengigheter

Anbefalt

libpsl-0.21.5

[Notat]

Notat

Mens det er et alternativ for å bygge pakken uten libpsl, begge deler både oppstrømsutviklerne og BLFS redaktørene anbefaler på det sterkeste ikke deaktivere støtte for libpsl på grunn av alvorlige sikkerhetsimplikasjoner.

Anbefalt ved kjøretid

make-ca-1.16.1

Valgfri

Brotli-1.2.0, c-ares-1.34.5, GnuTLS-3.8.10, libidn2-2.3.8, libssh2-1.11.1, MIT Kerberos V5-1.22.1, nghttp2-1.68.0, OpenLDAP-2.6.10, Samba-4.23.3 (kjøretid, for NTLM autentisering), gsasl, impacket, libmetalink, librtmp, ngtcp2, quiche, og SPNEGO

Valgfritt hvis du kjører testpakken

Apache-2.4.65 og stunnel-5.76 (for HTTPS og FTPS tester), OpenSSH-10.2p1, og Valgrind-3.26.0 (dette vil gjøre at testene kjører saktere og kan forårsake feil)

Installasjon av cURL

Først, løs et problem med en sikkerhetsrettelse: 

sed -i 's/2F 5C/%2F %5C/' scripts/wcurl

Installer cURL ved å kjøre følgende kommandoer: 

./configure --prefix=/usr    \
            --disable-static \
            --with-openssl   \
            --with-ca-path=/etc/ssl/certs &&
make

For å teste resultatene, kjør: make test. Noen tester er ustabile, så hvis noen tester har mislyktes er det mulig å kjøre en test igjen med: (cd tests; ./runtests.pl <test ID>) (ID for mislykkede tester vises i «These test cases failed:» beskjeden). Hvis du kjører testene etter at pakken er installert, kan noen tester mislykkes fordi manualsidene ble slettet med 'find' kommandoen i installasjonsinstruksjonene under.

Nå, som root bruker: 

make install &&

rm -rf docs/examples/.deps &&

find docs \( -name Makefile\* -o  \
             -name \*.1       -o  \
             -name \*.3       -o  \
             -name CMakeLists.txt \) -delete &&

cp -v -R docs -T /usr/share/doc/curl-8.17.0

For å kjøre noen enkle verifiseringstester på den nylig installerte curl, utsted følgende kommandoer: curl --trace-ascii debugdump.txt https://www.example.com/ og curl --trace-ascii d.txt --trace-time https://example.com/. Inspiser de lokalt opprettede sporingsfilene debugdump.txt og d.txt, som inneholder versjonsinformasjon, nedlastede filer informasjon, etc. En fil har tiden for hver handling logget.

Parameterforklaringer

--disable-static: Denne bryteren forhindrer installasjon av statiske versjoner av bibliotekene.

--with-ca-path=/etc/ssl/certs: Dette bryteren angir plasseringen til BLFS Certificate Authority lagringsplass.

--with-openssl: Denne parameteren velger OpenSSL som SSL/TLS implementering. Dette alternativet er ikke nødvendig hvis --with-gnutls er valgt i stedet.

--with-gssapi: Denne parameteren legger til Kerberos 5 støtte til libcurl.

--with-gnutls: Brukt denne bryteren for å bygge med GnuTLS støtte i stedet for OpenSSL for SSL/TLS.

--with-ca-bundle=/etc/pki/tls/certs/ca-bundle.crt: Bruk denne bryteren i stedet for --with-ca-path for å bygge med GnuTLS støtte i stedet for OpenSSL for SSL/TLS.

--with-libssh2: Denne parameteren legger til SSH støtte til cURL. Dette er deaktivert som standard.

--enable-ares: Denne parameteren legger til støtte for DNS oppløsning gjennom c-ares biblioteket.

find docs ... -exec rm {} \;: Denne kommandoen fjerner Makefiles og man filer fra dokumentasjonensmappen som ellers ville blitt installert av kommandoene som følger.

Innhold

Installerte Programmer: curl, curl-config, og wcurl
Installert Bibliotek: libcurl.so
Installerte Mapper: /usr/include/curl og /usr/share/doc/curl-8.17.0

Korte Beskrivelser

curl

er et kommandolinjeverktøy for å overføre filer med URL syntaks

curl-config

skriver ut informasjon om den siste kompileringen, som biblioteker koblet til og prefiksinnstilling

wcurl

er en enkel innpakning rundt curl for enkelt å laste ned filer

libcurl.so

gir API funksjonene som kreves av curl og andre programmer