Au-delà de Linux® From Scratch (édition System V) - Version r12.4-444-wip

Chapitre 17. Bibliothèques réseaux

cURL-8.16.0

Introduction à cURL

Le paquet cURL contient un utilitaire et une bibliothèque utilisés pour le transfert de fichiers avec la syntaxe URL vers les protocoles suivants : DICT, FILE, FTP, FTPS, GOPHER, GOPHERS, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, MQTT, POP3, POP3S, RTSP, SMB, SMBS, SMTP, SMPTS, TELNET et TFTP. Cette capacité de télécharger et de téléverser des fichiers peut être incorporée à d'autres programmes pour prendre en charge des fonctions comme le streaming de média.

[Note]

Note

Les versions de développement de BLFS peuvent ne pas arriver à contruire ou à exécuter certains paquets correctement si LFS ou des dépendances ont été mises à jour depuis la dernière version stable des livres.

Informations sur le paquet

  • Téléchargement (HTTP) : https://curl.se/download/curl-8.16.0.tar.xz

  • Téléchargement (FTP) :

  • Somme de contrôle MD5 du téléchargement : 3b5aae755714b338af0f66726bceb62a

  • Taille du téléchargement : 2,6 Mo

  • Estimation de l'espace disque requis : 59 Mo (plus 64 Mo pour les tests)

  • Estimation du temps de construction : 0,4 SBU (plus 4,5 SBU pour les tests (sans valgrind, plus 15 SBU avec valgrind) le tout avec parallélisme = 4)

Dépendances de cURL

Recommandées

libpsl-0.21.5

[Note]

Note

Bien qu'il y ait une option pour construire le paquet sans libpsl, les développeurs en amont et les auteurs de BLFS recommandent grandement de ne pas désactiver la prise en charge de libpsl à cause des implications sécuritaires importantes.

Recommandées à l'exécution

make-ca-1.16.1

Facultatives

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.1 (à l'exécution, pour l'authentification NTLM), gsasl, impacket, libmetalink, librtmp, ngtcp2, quiche et SPNEGO

Facultatives pour lancer la suite de tests

Apache-2.4.65et stunnel-5.76 (pour les tests HTTPS et FTPS), OpenSSH-10.2p1 et Valgrind-3.26.0 (ralenti les tests et peut causer des échecs)

Installation de cURL

Installez cURL en exécutant les commandes suivantes : 

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

Pour lancer la suite de tests, lancez : make test. Certains tests sont peu fiables, donc si certains tests échouent il est possible de relancer le test avec : (cd tests; ./runtests.pl <identifiant du test>) (l'identifiant du test est indiqué dans le message « These test cases failed: ») Si vous exécutez les tests après l'installation du paquet, certains tests peuvent échouer à cause de la suppression des paquets de manuel par la commande « find » des instructions d'installation ci-dessous.

Maintenant, en tant qu'utilisateur root : 

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.16.0

Pour lancer quelques tests simples de vérification pour le curl nouvellement installé, exécutez les commandes suivantes : curl --trace-ascii debugdump.txt https://www.example.com/ et curl --trace-ascii d.txt --trace-time https://example.com/. Inspectez les fichiers de traces locaux debugdump.txt et d.txt, qui contiennent la version téléchargée, les informations des fichiers, etc. Un fichier dispose du temps pour chaque action loguée.

Explication des commandes

--disable-static : Ce paramètre empêche l'installation des versions statiques des bibliothèques.

--with-ca-path=/etc/ssl/certs : Ce paramètre met en place l'emplacement de l'ensemble des certificats d'autorité de BLFS.

--with-openssl : ce paramètre choisit OpenSSL comme implémentation SSL/TLS. Ce paramètre n'est pas requis si --with-gnutls est choisi à la place.

--with-gssapi : Ce paramètre ajoute le support de Kerberos 5 à libcurl.

--with-gnutls : utilisez ce paramètre pour compiler avec le support de GnuTLS à la place de OpenSSL pour SSL/TLS.

--with-ca-bundle=/etc/pki/tls/certs/ca-bundle.crt : Utilisez ce paramètre plutôt que --with-ca-path si vous construisez avec le support de GnuTLS au lieu de OpenSSL pour SSL/TLS.

--with-libssh2 : ce paramètre ajoute la prise en charge de SSH à cURL. Elle est désactivée par défaut.

--enable-ares : ce paramètre ajoute la prise en charge de la résolution DNS à travers la bibliothèque c-ares.

find docs ... -exec rm {} \; : Cette commande supprime les Makefiles et les fichiers de manuel du répertoire de documentation qui seraient sinon installés par la commande suivante.

Contenu

Programmes installés: curl et curl-config
Bibliothèque installée: libcurl.so
Répertoires installés: /usr/include/curl et /usr/share/doc/curl-8.16.0

Descriptions courtes

curl

est un outil en ligne de commande pour transférer des fichiers à syntaxe d'URL

curl-config

affiche les informations sur la dernière compilation, comme les bibliothèques liées et le réglage du préfixe

libcurl.so

fournit les fonctions de l'API requises par curl et d'autres programmes