Au-delà de Linux® From Scratch (édition systemd) - Version 2017-08-22

Chapitre 13. Programmation

LLVM-4.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.

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

Informations sur le paquet

  • Téléchargement (HTTP) : http://llvm.org/releases/4.0.1/llvm-4.0.1.src.tar.xz

  • Téléchargement (FTP) :

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

  • Taille du téléchargement : 20 Mo

  • Estimation de l'espace disque requis : 1.8 Go (avec Clang, plus 8.2 Go pour les tests)

  • Estimation du temps de construction : 19 SBU (avec Clang et parallélisme=4, plus 14 SBU pour les tests en utilisant 12 cœurs)

Téléchargements facultatifs

Clang

Compiler RT

Dépendances de LLVM

Requises

CMake-3.9.1

Recommandées

libffi-3.2.1 et Python-2.7.13

Facultatives

Doxygen-1.8.13, Graphviz-2.38.0, libxml2-2.9.4, texlive-20170524 (ou install-tl-unx), Valgrind-3.13.0, Zip-3.0, OCaml et Sphinx

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 ../cfe-4.0.1.src.tar.xz -C tools &&
tar -xf ../compiler-rt-4.0.1.src.tar.xz -C projects &&

mv tools/cfe-4.0.1.src tools/clang &&
mv projects/compiler-rt-4.0.1.src projects/compiler-rt

patch -Np1 -d projects/compiler-rt < ../compiler-rt-4.0.1-glibc-2.26-1.patch

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_TARGETS_TO_BUILD="host;AMDGPU" \
      -Wno-dev ..                           &&
make

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

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

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

make docs-clang-html docs-clang-man

Pour tester les résultats, tapez : make check-all. Les tests sont lancés avec le nombre maximum de processeur/thread disponible. Remarquez que les tests Address Sanitizer sont connus pour échouer.

Maintenant, en tant qu'utilisateur root : 

make install

Si vous avez construit la documentation, installez-la en lançant la commande suivante en tant qu'utilisateur root : 

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

La documentatino de clang peut être installée de la même manière (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-4.0.1/clang-html    &&
cp -Rv tools/clang/docs/html/* /usr/share/doc/llvm-4.0.1/clang-html

Explication des commandes

-DLLVM_ENABLE-FFI=ON : Ce paramètre permet à LLVM d'utiliser libffi. Effacez-le si vous n'avez pas installé 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" : 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 de Mesa et radeonsi. 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_BUILD_LLVM_DYLIB=ON : Si utilisé en même temps que -DLLVM_BUILD_LLVM_DYLIB=ON, ce paramètre permet de lier les outils à la bibliothèque partagée plutôt que les bibliothèques statiques.

-DBUILD_SHARED_LIBS=ON : S'il est utilisé à la place de -DLLVM_BUILD_LLVM_DYLIB=ON, 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.13. 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-format, git-clang-format, llc, lli, llvm-ar, llvm-as, llvm-bcanalyzer, llvm-config, llvm-cov, llvm-c-test, llvm-cxxdump, llvm-diff, llvm-dis, llvm-dsymutil, llvm-dwarfdump, llvm-dwp, llvm-extract, llvm-lib (lien vers llvm-ar), llvm-link, llvm-lto, llvm-mc, llvm-mcmarkup, llvm-nm, llvm-objdump, llvm-pdbdump, llvm-profdata, llvm-ranlib (lien vers llvm-ar), llvm-readobj, llvm-rtdyld, llvm-size, llvm-split, llvm-stress, llvm-symbolizer, llvm-tblgen, obj2yaml, opt, sancov, sanstats, scan-build, scan-view, verify-uselistorder et yaml2obj
Bibliothèques installées: BugpointPasses.so, LLVMHello.so, libLLVM.so, libLLVM*.a (57 bibliothèques), libLTO.so, libclang.so and libclang*.a (24 bibliothèques)
Répertoires installés: /usr/include/{clang,clang-c,llvm,llvm-c}, /usr/lib/{clang,cmake/{clang,llvm}} et /usr/share/{clang,scan-build,scan-view,doc/llvm-4.0.1}

Descriptions courtes

bugpoint

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

clang

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

clang-format

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

llc

est le compilateur statique LLVM.

lli

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

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-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-cxxdump

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

llvm-diff

est le diff de LLVM.

llvm-dis

est le désassembleur LLVM.

llvm-dsymutil

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

llvm-dwarfdump

affiche le contenu des sections DWARF dans les fichiers objet.

llvm-dwp

fusionne des fichiers DWARF séparés.

llvm-extract

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

llvm-link

est le linker LLVM.

llvm-lto

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

llvm-mc

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

llvm-nm

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

llvm-objdump

est un afficheur de fichiers objets LLVM.

llvm-pdbdump

est utilisé comme un enregistreur PDB.

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-readobj

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

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

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 2017-08-20 00:23:24 +0200