clang : comment lister les architectures cibles supportées ?

Question

Actuellement, je m'intéresse à ARM en général et plus particulièrement aux cibles iphone/Android. Mais je veux juste en savoir plus sur clang, car il semble jouer un rôle important dans les années à venir.

J'ai essayé

clang -cc1 --help|grep -i list
clang -cc1 --help|grep arch|grep -v search
clang -cc1 --help|grep target

 -triple <value>         Specify target triple (e.g. i686-apple-darwin9)

Je sais que clang a un paramètre -triplet, mais comment puis-je lister toutes les valeurs possibles pour ce paramètre ? J'ai découvert que clang est très différent de gcc en ce qui concerne la compilation croisée, dans le monde de GCC vous devriez avoir un binaire séparé pour tout, comme PLATFORM_make ou PLATFORM_ld (i*86-pc-cygwin i*86-*-linux-gnu etc.). http://git.savannah.gnu.org/cgit/libtool.git/tree/doc/PLATFORMS )

dans le monde clang, il n'y a qu'un seul binaire (comme je l'ai lu sur certains forums). Mais comment puis-je obtenir la liste des cibles supportées ? Et si ma cible n'est pas supportée sur ma distro (linux/Windows/macos/quelque chose) comment puis-je obtenir celle qui supporte plus de plateforme ?

si je fais la dernière version SVN de clang comme ceci :

svn co http://llvm.org/svn/llvm-project/cfe/trunk clang

Est-ce que j'obtiendrai la plupart des plateformes ? Il semble que Clang n'ait pas été construit avec la compilation croisée à l'esprit dès le départ, mais comme il est basé sur llvm, il devrait être très convivial en théorie ? merci !

Answer 1

Pour autant que je sache, il n'existe pas d'option de ligne de commande permettant de répertorier les architectures pour lesquelles un système de gestion de l'environnement donné est utilisé. clang supports binaires, et même l'exécution strings sur elle n'aide pas vraiment. Clang n'est essentiellement qu'un traducteur C vers LLVM, et c'est LLVM lui-même qui s'occupe des détails de la génération du code machine réel, il n'est donc pas vraiment surprenant que Clang ne prête pas beaucoup d'attention à l'architecture sous-jacente.

Comme d'autres l'ont déjà noté, vous pouvez demander llc les architectures qu'il prend en charge. Ce n'est pas très utile, non seulement parce que ces composants LLVM peuvent ne pas être installés, mais aussi à cause des caprices des chemins de recherche et des systèmes d'empaquetage. llc y clang peuvent ne pas correspondre à la même version de LLVM.

Cependant, pour les besoins de l'argumentation, disons que vous avez compilé LLVM et Clang vous-même ou que vous êtes heureux d'accepter vos binaires LLVM comme suffisants :

• llc --version donnera une liste de toutes les architectures qu'il prend en charge. B
• Pour chacune des architectures listées, llc -march=ARCH -mattr=help listera les "processeurs disponibles" et les "fonctionnalités disponibles". Les unités centrales ne sont généralement qu'un moyen pratique de définir une collection de fonctions par défaut.

Mais maintenant, les mauvaises nouvelles. Il n'y a pas de table pratique de triples dans Clang ou LLVM qui peut être vidée, parce que les backends spécifiques à l'architecture ont l'option d'analyser la chaîne de triple dans un fichier llvm::Triple (défini dans include/llvm/ADT/Triple.h ). En d'autres termes, pour vider tous les triples disponibles, il faut résoudre le problème de Halting. Voir, par exemple, llvm::ARM_MC::ParseARMTriple(...) qui traite de manière particulière l'analyse de la chaîne de caractères "generic" .

En fin de compte, cependant, le "triple" est principalement une fonctionnalité de compatibilité ascendante pour faire de Clang un remplacement immédiat de GCC, donc vous n'avez généralement pas besoin d'y prêter attention à moins que vous ne portiez Clang ou LLVM sur une nouvelle plate-forme ou architecture. Au lieu de cela, vous trouverez probablement la sortie de llc -march=arm -mattr=help et de s'étonner de l'immense éventail des différentes fonctionnalités d'ARM pour être plus utile dans vos enquêtes.

Bonne chance dans vos recherches !

Answer 2

À partir de Clang 11 (trunk), la liste des architectures cibles supportées peut être facilement imprimée en utilisant le nouvel élément suivant -print-targets drapeau :

$ clang-11 -print-targets
  Registered Targets:
    aarch64    - AArch64 (little endian)
    aarch64_32 - AArch64 (little endian ILP32)
    aarch64_be - AArch64 (big endian)
    amdgcn     - AMD GCN GPUs
    arm        - ARM
    arm64      - ARM64 (little endian)
    arm64_32   - ARM64 (little endian ILP32)
    armeb      - ARM (big endian)
    avr        - Atmel AVR Microcontroller
    bpf        - BPF (host endian)
    bpfeb      - BPF (big endian)
    bpfel      - BPF (little endian)
    hexagon    - Hexagon
    lanai      - Lanai
    mips       - MIPS (32-bit big endian)
    mips64     - MIPS (64-bit big endian)
    mips64el   - MIPS (64-bit little endian)
    mipsel     - MIPS (32-bit little endian)
    msp430     - MSP430 [experimental]
    nvptx      - NVIDIA PTX 32-bit
    nvptx64    - NVIDIA PTX 64-bit
    ppc32      - PowerPC 32
    ppc64      - PowerPC 64
    ppc64le    - PowerPC 64 LE
    r600       - AMD GPUs HD2XXX-HD6XXX
    riscv32    - 32-bit RISC-V
    riscv64    - 64-bit RISC-V
    sparc      - Sparc
    sparcel    - Sparc LE
    sparcv9    - Sparc V9
    systemz    - SystemZ
    thumb      - Thumb
    thumbeb    - Thumb (big endian)
    wasm32     - WebAssembly 32-bit
    wasm64     - WebAssembly 64-bit
    x86        - 32-bit X86: Pentium-Pro and above
    x86-64     - 64-bit X86: EM64T and AMD64
    xcore      - XCore

Références : LLVM PR , LLVM commit , Documentation sur Clang 11 .

Answer 3

J'utilise Clang 3.3, je pense que la meilleure façon d'obtenir la réponse est de lire le code source. dans llvm/ADT/Triple.h ( http://llvm.org/doxygen/Triple_8h_source.html ) :

  enum ArchType {
    UnknownArch,

    arm,     // ARM: arm, armv.*, xscale
    aarch64, // AArch64: aarch64
    hexagon, // Hexagon: hexagon
    mips,    // MIPS: mips, mipsallegrex
    mipsel,  // MIPSEL: mipsel, mipsallegrexel
    mips64,  // MIPS64: mips64
    mips64el,// MIPS64EL: mips64el
    msp430,  // MSP430: msp430
    ppc,     // PPC: powerpc
    ppc64,   // PPC64: powerpc64, ppu
    r600,    // R600: AMD GPUs HD2XXX - HD6XXX
    sparc,   // Sparc: sparc
    sparcv9, // Sparcv9: Sparcv9
    systemz, // SystemZ: s390x
    tce,     // TCE (http://tce.cs.tut.fi/): tce
    thumb,   // Thumb: thumb, thumbv.*
    x86,     // X86: i[3-9]86
    x86_64,  // X86-64: amd64, x86_64
    xcore,   // XCore: xcore
    mblaze,  // MBlaze: mblaze
    nvptx,   // NVPTX: 32-bit
    nvptx64, // NVPTX: 64-bit
    le32,    // le32: generic little-endian 32-bit CPU (PNaCl / Emscripten)
    amdil,   // amdil: amd IL
    spir,    // SPIR: standard portable IR for OpenCL 32-bit version
    spir64   // SPIR: standard portable IR for OpenCL 64-bit version
  };

et dans clang/lib/Driver/ToolChains.cpp , il y a quelque chose à propos de arm.

static const char *GetArmArchForMArch(StringRef Value) {
  return llvm::StringSwitch<const char*>(Value)
    .Case("armv6k", "armv6")
    .Case("armv6m", "armv6m")
    .Case("armv5tej", "armv5")
    .Case("xscale", "xscale")
    .Case("armv4t", "armv4t")
    .Case("armv7", "armv7")
    .Cases("armv7a", "armv7-a", "armv7")
    .Cases("armv7r", "armv7-r", "armv7")
    .Cases("armv7em", "armv7e-m", "armv7em")
    .Cases("armv7f", "armv7-f", "armv7f")
    .Cases("armv7k", "armv7-k", "armv7k")
    .Cases("armv7m", "armv7-m", "armv7m")
    .Cases("armv7s", "armv7-s", "armv7s")
    .Default(0);
}

static const char *GetArmArchForMCpu(StringRef Value) {
  return llvm::StringSwitch<const char *>(Value)
    .Cases("arm9e", "arm946e-s", "arm966e-s", "arm968e-s", "arm926ej-s","armv5")
    .Cases("arm10e", "arm10tdmi", "armv5")
    .Cases("arm1020t", "arm1020e", "arm1022e", "arm1026ej-s", "armv5")
    .Case("xscale", "xscale")
    .Cases("arm1136j-s", "arm1136jf-s", "arm1176jz-s", "arm1176jzf-s", "armv6")
    .Case("cortex-m0", "armv6m")
    .Cases("cortex-a8", "cortex-r4", "cortex-a9", "cortex-a15", "armv7")
    .Case("cortex-a9-mp", "armv7f")
    .Case("cortex-m3", "armv7m")
    .Case("cortex-m4", "armv7em")
    .Case("swift", "armv7s")
    .Default(0);
}

Answer 4

Une astuce que vous pouvez faire : si vous essayez de trouver une cible triple particulière, est d'installer llvm sur ce système puis faire un

$ llc --version | grep Default
  Default target: x86_64-apple-darwin16.1.0

ou alternativement :

$ llvm-config --host-target
x86_64-apple-darwin16.0.0
or
$ clang -v 2>&1 | grep Target
Target: x86_64-apple-darwin16.1.0

Vous saurez alors comment le cibler lors de la compilation croisée de toute façon.

Apparemment, il y a "beaucoup" de cibles, voici une liste, n'hésitez pas à la compléter, dans le style wiki communautaire :

arm-none-eabi
armv7a-none-eabi
arm-linux-gnueabihf 
arm-none-linux-gnueabi
i386-pc-linux-gnu 
x86_64-apple-darwin10
i686-w64-windows-gnu # same as i686-w64-mingw32
x86_64-pc-linux-gnu # from ubuntu 64 bit
x86_64-unknown-windows-cygnus # cygwin 64-bit
x86_64-w64-windows-gnu # same as x86_64-w64-mingw32
i686-pc-windows-gnu # MSVC
x86_64-pc-windows-gnu # MSVC 64-BIT

Voici ce que le docs (apparemment, il s'agit d'un quadruple [ou quintuple ?] au lieu d'un triple de nos jours) :

The triple has the general format <arch>-<vendor>-<sys>-<abi>, where:
arch = x86, arm, thumb, mips, etc.
sub = for ex. on ARM: v5, v6m, v7a, v7m, etc.
vendor = pc, apple, nvidia, ibm, etc.
sys = none, linux, win32, darwin, cuda, etc.
abi = eabi, gnu, android, macho, elf, etc.

et vous pouvez même spécifier un cpu cible au-delà de cette valeur, bien qu'il utilise un défaut raisonnable pour le cpu cible basé sur le triple.

Parfois les cibles se "résolvent" à la même chose, donc pour voir ce qu'une cible est réellement traitée comme :

 $ clang -target x86_64-w64-mingw32 -v 2>&1 | grep Target
 Target: x86_64-w64-windows-gnu

Answer 5

Selon Jonathan Roelofs dans cette conférence "Quelles cibles Clang supporte-t-il ?" :

$ llc --version
LLVM (http://llvm.org/):
  LLVM version 3.6.0
  Optimized build with assertions.
  Built Apr  2 2015 (01:25:22).
  Default target: x86_64-apple-darwin12.6.0
  Host CPU: corei7-avx

  Registered Targets:
    aarch64    - AArch64 (little endian)
    aarch64_be - AArch64 (big endian)
    amdgcn     - AMD GCN GPUs
    arm        - ARM
    arm64      - ARM64 (little endian)
    armeb      - ARM (big endian)
    cpp        - C++ backend
    hexagon    - Hexagon
    mips       - Mips
    mips64     - Mips64 [experimental]
    mips64el   - Mips64el [experimental]
    mipsel     - Mipsel
    msp430     - MSP430 [experimental]
    nvptx      - NVIDIA PTX 32-bit
    nvptx64    - NVIDIA PTX 64-bit
    ppc32      - PowerPC 32
    ppc64      - PowerPC 64
    ppc64le    - PowerPC 64 LE
    r600       - AMD GPUs HD2XXX-HD6XXX
    sparc      - Sparc
    sparcv9    - Sparc V9
    systemz    - SystemZ
    thumb      - Thumb
    thumbeb    - Thumb (big endian)
    x86        - 32-bit X86: Pentium-Pro and above
    x86-64     - 64-bit X86: EM64T and AMD64
    xcore      - XCore

Les futures versions de Clang pourront fournir les éléments suivants. Ils sont listés comme "proposés" mais pas encore disponibles, du moins à partir de la version 3.9.0 :

$ clang -target <target_from_list_above> --print-multi-libs
$ clang -print-supported-archs
$ clang -march x86 -print-supported-systems 
$ clang -march x86 -print-available-systems