Au-delà de Linux® From Scratch (édition systemd) - Version 10.0

Chapitre 13. Programmation

LLVM-10.0.1

Introduction à LLVM

Le paquet LLVM contient une collection de compilateur modulaire et réutilisable et des technologies de chaînes d'outils. Le cœur des bibliothèques Low Level Virtual Machine (LLVM) fournit un optimiseur moderne indépendant de la source et de la cible, ainsi que le support de génération de code pour beaucoup des processeurs populaires (ainsi que quelques autres moins courants !). Ces bibliothèques sont construites autour d'une représentation du code connu sous le nom de représentation LLVM intermédiaire ("LLVM IR").

Les paquets facultatifs Clang et Compiler RT fournissent de nouvelles interfaces C, C++, Objective C et Objective C++ et des bibliothèques d'exécution pour LLVM et sont requis par certains paquets qui utilisent Rust, par exemple firefox.

Ce paquet est connu pour se construire correctement sur une plateforme LFS-1.0.

Informations sur le paquet

  • Téléchargement (HTTP) : https://github.com/llvm/llvm-project/releases/download/llvmorg-10.0.1/llvm-10.0.1.src.tar.xz

  • Téléchargement (FTP) :

  • Somme de contrôle MD5 du téléchargement : 71c68c526cbbf1674b5aafc5542b336c

  • Taille du téléchargement : 34 Mo

  • Estimation de l'espace disque requis : 2,8 Go (avec Clang, 659 Mo installé, plus 16 Go pour les tests)

  • Estimation du temps de construction : 30 SBU (avec Clang et parallélisme = 4, plus 15 SBU pour les tests)

Téléchargements facultatifs

Clang

Compiler RT

Dépendances de LLVM

Requises

CMake-3.18.1

Facultatives

Doxygen-1.8.19, git-2.28.0, Graphviz-2.44.1, libxml2-2.9.10, Python-2.7.18, rsync-3.2.3 (pour les tests), texlive-20200406 (ou install-tl-unx), Valgrind-3.16.1, PyYAML-5.3.1, Zip-3.0, OCaml, psutil, recommonmark, Sphinx et Z3

Notes utilisateur : http://wiki.linuxfromscratch.org/blfs/wiki/llvm

Installation de LLVM

Si vous avez téléchargé les paquets facultatifs, installez-les dans l'arborescence des sources : 

tar -xf ../clang-10.0.1.src.tar.xz -C tools          &&
tar -xf ../compiler-rt-10.0.1.src.tar.xz -C projects &&

mv tools/clang-10.0.1.src tools/clang &&
mv projects/compiler-rt-10.0.1.src projects/compiler-rt

Installez LLVM en lançant les commandes suivantes : 

mkdir -v build &&
cd       build &&

CC=gcc CXX=g++                                  \
cmake -DCMAKE_INSTALL_PREFIX=/usr               \
      -DLLVM_ENABLE_FFI=ON                      \
      -DCMAKE_BUILD_TYPE=Release                \
      -DLLVM_BUILD_LLVM_DYLIB=ON                \
      -DLLVM_LINK_LLVM_DYLIB=ON                 \
      -DLLVM_ENABLE_RTTI=ON                     \
      -DLLVM_TARGETS_TO_BUILD="host;AMDGPU;BPF" \
      -DLLVM_BUILD_TESTS=ON                     \
      -Wno-dev -G Ninja ..                      &&
ninja

Si vous avez installé Sphinx et recommonmark et que vous souhaitez générer la documentation html et les pages de manuel, tapez les commandes suivantes : 

cmake -DLLVM_ENABLE_SPHINX=ON         \
      -DSPHINX_WARNINGS_AS_ERRORS=OFF \
      -Wno-dev -G Ninja ..            &&
ninja docs-llvm-html  docs-llvm-man

Si vous avez téléchargé les paquets facultatifs, la documentation de clang peut être aussi construite : 

ninja docs-clang-html docs-clang-man

Pour tester les résultats, lancez : ninja check-all. Les tests sont construits avec tous les cœurs disponibles, mais lancés avec le nombre de cœurs en ligne (la différence c'est que les cœurs disponibles peuvent être limités avec taskset, mais les rendre hors ligne demande d'écrire 0 dans /sys/devices/system/cpu/cpu<N>/online en tant qu'utilisateur root et les rend temporairement indisponibles pour toutes les taches du système). Remarquez que plusieurs tests du simplificateur (6 sur plus de 41 000 tests lancés) sont connus pour échouer.

Maintenant, en tant qu'utilisateur root : 

ninja install

Si vous avez construit la documentation de llvm, installez-la en lançant les commandes suivantes en tant qu'utilisateur root : 

install -v -m644 docs/man/* /usr/share/man/man1             &&
install -v -d -m755 /usr/share/doc/llvm-10.0.1/llvm-html     &&
cp -Rv docs/html/* /usr/share/doc/llvm-10.0.1/llvm-html

Si vous avez construit la documentation de clang, installez-la en lançant les commandes suivantes (de nouveau en tant qu'utilisateur root) : 

install -v -m644 tools/clang/docs/man/* /usr/share/man/man1 &&
install -v -d -m755 /usr/share/doc/llvm-10.0.1/clang-html    &&
cp -Rv tools/clang/docs/html/* /usr/share/doc/llvm-10.0.1/clang-html

Explication des commandes

-DLLVM_ENABLE-FFI=ON : Ce paramètre permet à LLVM d'utiliser libffi.

-DLLVM_BUILD_LLVM_DYLIB=ON : Construit les bibliothèques en statique et les lie toutes en une unique bibliothèque partagée. C'est la méthode recommandée pour la construction de la bibliothèque partagée.

-DCMAKE_BUILD_TYPE=Release : ce paramètre active les optimisations du compilateur pour augmenter la vitesse du code et diminuer sa taille. Il désactive aussi quelques vérifications de compilation, non nécessaires à un système en production.

-DLLVM_TARGETS_TO_BUILD="host;AMDGPU;BPF" : Ce paramètre active la construction des mêmes cibles que l'hôte. et aussi pour le GPU r600 AMD utilisé par les pilotes r600 et radeonsi de Mesa. La cible BPF est reqise pour construire v4l-utils-1.20.0. Par défaut tout est activé. Vous pouvez indiquer une liste de cibles séparées par des virgules. Les cibles valides sont : host, X86, Sparc, PowerPC, ARM, AArch64, Mips, Hexagon, Xcore, MSP430, NVPTX, SystemZ, AMDGPU, BPF, CppBackend ou all.

-DLLVM_LINK_LLVM_DYLIB=ON : Utilisé avec -DLLVM_BUILD_LLVM_DYLIB=ON, ce paramètre active la liaison des outils avec la bibliothèque partagée plutôt que des bibliothèques statiques. Il réduit aussi légèrement leur taille et s'assure que llvm-config utilisera bien libLLVM-10.0.so.

-DLLVM_ENABLE_RTTI=ON : Utilisé pour construire LLVM avec des informations de type à l'exécution. Cela est requis pour la construction de Mesa-20.1.5.

-DBUILD_SHARED_LIBS=ON : S'il est utilisé à la place de -DLLVM_BUILD_LLVM_DYLIB=ON et -DLLVM_LINK_LLVM_DYLIB=ON, ce paramètre construit les bibliothèques LLVM (environ 60) en tant que bibliothèques partagées plutôt que statiques.

-DLLVM_ENABLE_DOXYGEN : Active la génération de la documentation HTML navigable si vous avez installé Doxygen-1.8.19. Vous devriez lancer make doxygen-html ensuite, et installer la documentation générée à la main.

Contenu

Programmes installés: bugpoint, c-index-test, clang, clang++ (liens symboliques vers clang-<version>), clang-<version>, clang-check, clang-cl, clang-cpp (les deux derniers étant des liens symboliques vers clang), clang-format, clang-extdef-mapping, clang-import-test, clang-offload-bundler, clang-offload-wrapper, clang-refactor, clang-rename, clang-scan-deps, diagtool, dsymutil, git-clang-format, hmap-tool, llc, lli, llvm-addr2line, llvm-ar, llvm-as, llvm-bcanalyzer, llvm-cat, llvm-cfi-verify, llvm-config, llvm-cov, llvm-c-test, llvm-cvtres, llvm-cxxdump, llvm-cxxfilt, llvm-cxxmap, llvm-diff, llvm-dis, llvm-dlltool (lien vers llvm-ar), llvm-dwarfdump, llvm-dwp, llvm-elfabi, llvm-exegenesis, llvm-extract, llvm-ifs, llvm-install-name-tool (lien vers llvm-objcopy), llvm-jitlink, llvm-lib (lien vers llvm-ar), llvm-link, llvm-lipo, llvm-lto, llvm-lto2, llvm-mc, llvm-mca, llvm-modextract, llvm-mt, llvm-nm, llvm-objcopy, llvm-objdump, llvm-opt-report, llvm-pdbutil, llvm-profdata, llvm-ranlib (symlink to llvm-ar), llvm-rc, llvm-readelf (lien vers llvm-readobj), llvm-readobj, llvm-reduce, llvm-rtdyld, llvm-size, llvm-split, llvm-stress, llvm-strings, llvm-strip (lien vers llvm-objcopy), llvm-symbolizer, llvm-tblgen, llvm-undname, llvm-xray, obj2yaml, opt, sancov, sanstats, scan-build, scan-view, verify-uselistorder et yaml2obj
Bibliothèques installées: libLLVM.so, libLLVM*.a (75 bibliothèques), libLTO.so, libRemarks.so, libclang.so et libclang*.a (63 bibliothèques)
Répertoires installés: /usr/include/{clang,clang-c,llvm,llvm-c}, /usr/lib/{clang,cmake/{clang,llvm}}, /usr/share/{clang,opt-viewer,scan-build,scan-view} et /usr/share/doc/llvm-10.0.1

Descriptions courtes

bugpoint

est l'outil de réduction de cas de test automatique.

c-index-test

est utilisé pour tester l'API libclang et montrer son utilisation.

clang

est le compilateur Clang C, C++ et Objective-C.

clang-check

est un outil pour effectuer une analyse de code statique et afficher des arbres de syntaxe abstraite (AST).

clang-extdef-mapping

est un outil pour récupérer le nom USR et l'emplacement des définitions externes dans un fichier source.

clang-format

est un outil pour formater du code C/C++/Java/JavaScript/Objective-C/Protobuf.

clang-offload-bundler

est un outil pour rassembler/désassembler des fichiers reçus d'OpenMP associés avec un fichier source commun.

clang-offload-bundler

est un outil pour créer des enveloppes en bitcode pour charger des binaires cibles.

clang-refactor

est un outil de réusinage basé sur Clang pour C, C++ et Objective-C.

clang-rename

est un outil pour renommer des symboles dans les programmes C/C++.

clang-scan-deps

est un outil pour scanner les dépendances dans un fichier source.

diagtool

est une combinaison d'outils pour gérer les diagnostics de clang.

dsymutil

et un outil utilisé pour manipuler les fichiers de symboles de débogage DWARF archivés, compatible avec la commande Darwin dsymutil.

git-clang-format

lance clang-format sur des correctifs générés par git (requiert git-2.28.0)

hmaptool

est un outil Python pour décharger et construire des correspondances d'en-têtes.

llc

est le compilateur statique LLVM.

lli

est utilisé pour exécuter directement des programmes en bytecode LLVM.

llvm-addr2line

est un outil utilisé pour convertir les adresses en noms de fichiers et en numéro de ligne.

llvm-ar

est le créateur d'archive de LLVM.

llvm-as

est l'assembleur de LLVM.

llvm-bcanalyzer

est l'analyseur de bytecode LLVM.

llvm-cat

est un outil pour concaténer des modules llvm.

llvm-cfi-verify

identifie si les l'intégrité du flot de contrôle protège toutes les instructions de flot de contrôle indirect dans le fichier objet, DSO ou binaire fournit.

llvm-config

Affiche les options de compilation de LLVM.

llvm-cov

est utilisé pour émettre des informations de couverture.

llvm-c-test

est un désassembleur de bytecode.

llvm-cvtres

est un outil pour convertir des fichiers de resource Microsoft en COFF.

llvm-cxxdump

est utilisé pour l'afficheur de donnée C++ ABI.

llvm-cxxfilt

est utilisé pour réassembler les symboles C++ dans le code llvm.

llvm-cxxmap

est utilisé pour réassembler les symboles C++ mutilés.

llvm-diff

est le diff de LLVM.

llvm-dis

est le désassembleur LLVM.

llvm-dwarfdump

affiche le contenu des sections DWARF dans les fichiers objet.

llvm-dwp

fusionne des fichiers DWARF séparés.

llvm-elfabi

est utilisé pour lire des informations sur l'ABI d'un binaire ELF.

llvm-exegesis

est un outil de test de performance qui utilise les informations disponibles dans LLVM pour mesurer les caractéristiques des instructions de la machine hôte comme la latence ou le décomposition de port.

llvm-extract

est utilisé pour extraire une fonction depuis un module LLVM.

llvm-ifs

est utilisé pour fusionner les interfaces avec les fichiers objets.

llvm-install-name-tool

est utilisé pour réécrire les commandes de chargement vers le format binaire MachO.

llvm-jitlink

est utilisé pour analyser des fichiers objet relocalisables pour rendre leur contenu exécutable dans un processus cible.

llvm-link

est le linker LLVM.

llvm-lipo

est utilisé pour créer des binaires universels à partir de fichiers MachO.

llvm-lto

est l'éditeur de lien LLVM LTO (optimisation à l'édition de lien).

llvm-lto2

est un banc de test pour l'interface LTO basée sur la résolution.

llvm-mc

est un assembleur / désassembleur de code machine distinct.

llvm-mca

est un outil d'analyse de performance pour mesurer statiquement les performances du code machine.

llvm-modextract

est un outil pour extraire un module de fichiers de code binaire multi-modules.

llvm-mt

est un outil pour générer des fichiers et des catalogues signés à partir d'un manifeste d'assemblage (utilisé par le SDK de Microsoft).

llvm-nm

est utilisé pour lister les tables de symboles des fichiers objets et bytecode LLVM.

llvm-objcopy

est la version de LLVM d'un outil objcopy.

llvm-objdump

est un afficheur de fichiers objets LLVM.

llvm-opt-report

est un outil pour générer un rapport d'optimisation depuis les fichiers d'enregistrement d'optimisations YAML.

llvm-pdbutil

est un afficheur de PDB (Program Database). PDB est un format de Microsoft.

llvm-profdata

est un petit outil pour manipuler et afficher des fichiers de données de profil.

llvm-ranlib

est utilisé pour générer un index pour une archive LLVM.

llvm-rc

est un outil indépendant de la plateforme pour compiler des scripts de ressources en fichiers de ressources binaires.

llvm-readobj

affiche des informations bas niveau et spécifiques au format à propos de fichiers objets.

llvm-reduce

est utilisé pour automatiquement réduire les cas de tests lors du lancement d'une suite de tests.

llvm-rtdyld

est l'outil MC-JIT LLVM.

llvm-size

est l'afficheur de taille d'objet de LLVM.

llvm-split

est le séparateur de module de LLVM.

llvm-stress

est utilisé pour générer des fichier .ll aléatoires.

llvm-strings

affiche les chaînes contenues dans un binaire (fichier objet, exécutable ou bibliothèque archivée)

llvm-symbolizer

convertit des adresses en emplacement dans le code source.

llvm-tblgen

est le générateur de code C++ depuis la description de la cible de LLVM.

llvm-undname

est un outil pour recomposer les noms.

llvm-xray

est une implémentation du système de traçage des appels de fonction XRay de Google.

obj2yaml

prends un fichier objet, et produit une représentation YAML de ce fichier.

opt

est l'optimiseur LLVM.

sancov

est l'outil de traitement de la couverture du simplificateur.

sanstats

est l'outil de traitement de la couverture du simplificateur.

scan-build

est un script Perl qui invoque l'analyseur statique Clang.

scan-view

est une visonneuse de résultats d'analyse statique de Clang.

verify-uselistorder

est l'outil de LLVM pour vérifier l'ordre d'utilisation des listes.

yaml2obj

prend une représentation YAML d'un fichier objet et le convertit en un fichier binaire.

Last updated on 2020-08-17 04:12:39 +0000