Bygg LLVM med CMake¶

llvm-spesifikke variabler¶

LLVM_TARGETS_TO_BUILD: STRING Semikolonseparert liste over mål å bygge, eller alle for å bygge alltargets. Case-sensitive. Standard til alle. Eksempel:-DLLVM_TARGETS_TO_BUILD="X86;PowerPC". LLVM_BUILD_TOOLS: BOOL Bygge LLVM verktøy. Standard til PÅ. Mål for å bygge hvert verktøy er genererti alle fall. Du kan bygge et verktøy separat ved å påkalle sitt mål. For eksempel kan du bygge llvm-som Med Et Makefile-basert system ved å utføre makellvm-som ved roten til byggekatalogen din. LLVM_INCLUDE_TOOLS:BOOL Generere bygge mål FOR LLVM verktøy. Standard til PÅ. Du kan bruke thisoption til å deaktivere generering av bygge mål FOR LLVM verktøy. LLVM_INSTALL_BINUTILS_SYMLINKS: BOOL Installerer symlinks fra binutils-verktøynavnene til DE tilsvarende LLVM-verktøyene.For eksempel vil ar bli symlinked til llvm-ar. LLVM_INSTALL_CCTOOLS_SYMLINKS: BOOL Installerer symliks fra cctools-verktøynavnene til DE tilsvarende LLVM-verktøyene.For eksempel vil lipo bli symlinked til llvm-lipo. LLVM_BUILD_EXAMPLES: BOOL Bygge LLVM eksempler. Standard TIL AV. Mål for å bygge hvert eksempel ergenerert i alle fall. Se dokumentasjon FOR LLVM_BUILD_TOOLS ovenfor for moredetails. LLVM_INCLUDE_EXAMPLES: BOOL Generere bygge mål FOR LLVM eksempler. Standard til PÅ. Du kan bruke thisoption til å deaktivere generering av bygge mål FOR LLVM eksempler. LLVM_BUILD_TESTS: BOOL Bygge LLVM enhet tester. Standard TIL AV. Mål for å bygge hver enhetstestgenereres i alle fall. Du kan bygge en bestemt enhetstest ved hjelp av mål som er definert under enhetstester, For Eksempel ADTTests, IRTests,SupportTests, etc. (Søk etteradd_llvm_unittesti underkatalogene til unittestsfor en komplett liste over enhetstester.) Det er mulig å bygge alle enhetstestermed målenhetene. LLVM_INCLUDE_TESTS: BOOL Generere bygge mål FOR LLVM enhet tester. Standard til PÅ. Du kan bruke dette alternativet for å deaktivere genereringen av byggmål for LLVM-enhetene. LLVM_BUILD_BENCHMARKS: BOOL Legger benchmarks til listen over standard mål. Standard TIL AV. LLVM_INCLUDE_BENCHMARKS: BOOL Generere bygge mål FOR LLVM benchmarks. Standard til PÅ. LLVM_APPEND_VC_REV: BOOL Embed versjonskontroll revisjon info (Git revisjon id).Versjonsinformasjonen leveres avLLVM_REVISIONmakroen illvm/include/llvm/Support/VCSRevision.h. Utviklere som bruker git som ikke trenger revisjonsinformasjon, kan deaktivere dette alternativet for å unngå å koble de fleste binariesetter en grenbryter. Standard til PÅ. LLVM_ENABLE_THREADS: BOOL Bygge med tråder støtte, hvis tilgjengelig. Standard til PÅ. LLVM_ENABLE_UNWIND_TABLES: BOOL Aktiver slappe av tabeller i binær. Deaktivering av unwind-tabeller kan reduserestørrelsen på bibliotekene. Standard til PÅ. LLVM_ENABLE_ASSERTIONS: BOOL Aktiverer kode påstander. Som standard PÅ hvis og bare hvis

CMAKE_BUILD_TYPEEr Feilsøking. LLVM_ENABLE_EH: BOOL Bygge LLVM med unntak-håndtering støtte. Dette er nødvendig hvis du ønsker tolink mot LLVM biblioteker og gjøre bruk Av c++ unntak i din egen kodesom må forplante SEG GJENNOM LLVM kode. Standard TIL AV. LLVM_ENABLE_EXPENSIVE_CHECKS: BOOL Aktiver ekstra tid / minne dyrt kontroll. Standard TIL AV. LLVM_ENABLE_IDE: BOOL Forteller byggesystemet at EN IDE blir brukt. Dette i sin tur deaktiverer thecreation av visse bekvemmelighet bygge systemmål, slik som de ulikeinstall-*ogcheck-*mål, Siden IDEs ikke alltid avtale godt witha stort antall mål. Dette er vanligvis autodetected, men det kan værekonfigurert manuelt for å eksplisitt kontrollere genereringen av disse målene. Onescenario hvor en manuell overstyring kan være ønskelig, er når Du bruker Visual Studio2017s CMake-integrasjon, som ikke ville bli oppdaget som EN IDE ellers. LLVM_ENABLE_MODULES: BOOL Kompilere Med Clang Header Moduler. LLVM_ENABLE_PIC: BOOL Legg til-fPIC– flagget i kompilatorens kommandolinje, hvis kompilatoren støtter dette flagget. Noen systemer, Som Windows, trenger ikke dette flagget. Standard til PÅ. LLVM_ENABLE_RTTI: BOOL Bygge LLVM med run-time type informasjon. Standard TIL AV. LLVM_ENABLE_WARNINGS: BOOL Aktiver alle kompilator advarsler. Standard til PÅ. LLVM_ENABLE_PEDANTIC: BOOL Aktiver pedantisk modus. Dette deaktiverer kompilatorspesifikke utvidelser, ifpossible. Standard til PÅ. LLVM_ENABLE_WERROR: BOOL Stoppe og mislykkes bygge, hvis en kompilator advarsel utløses. Standard TIL AV. LLVM_ABI_BREAKING_CHECKS: STRENG Brukes til å avgjøre OM LLVM skal bygges MED ABI bryte sjekker ornot. Tillatte verdier ER WITH_ASSERTS (standard), FORCE_ON andFORCE_OFF. WITH_ASSERTS slår PÅ ABI bryte sjekker i anassertion aktivert bygge. FORCE_ON (FORCE_OFF) slår dem på (av) uavhengig av om normale (NDEBUG-baserte) påstander er aktivert eller ikke. EN VERSJON AV LLVM bygget MED ABI breaking checker IKKE ABI kompatibel med en versjon bygget uten den. LLVM_BUILD_32_BITS: BOOL Bygger 32-biters kjørbare filer og biblioteker på 64-biters systemer. Dette alternativet er bare tilgjengelig på noen 64-biters Unix-systemer. Standard TIL AV. LLVM_TARGET_ARCH: STRENG LLVM mål å bruke for innfødt kodegenerering. Dette kreves For Jitgenerasjon. Den er standard «vert», noe som betyr at den skal velge arkitekturen av maskinen DER LLVM bygges. Hvis du er kryss-kompilering, sett den inntil målarkitekturnavnet. LLVM_TABLEGEN: STRING Full bane til en innfødt TableGen kjørbar (vanligvis kalt

llvm-tblgen). Dette er ment for krysskompilering: hvis brukeren setter denne variabelen, vil ingen nativeTableGen bli opprettet. LLVM_LIT_ARGS: STRENGARGUMENTER gitt til lit.make checkogmake clang-tester affected.By standard,'-sv --no-progress-bar'På Visual C++ og Xcode,'-sv'påandre. LLVM_LIT_TOOLS_DIR: STI banen Til GnuWin32 verktøy for tester. Gyldig På Windows host. Standard den tomme strengen, i så fall lyser, vil se etter verktøy som trengs for tester(f. eks.grep,sort, etc.) i % BANEN%. Hvis GnuWin32 ikke er i % PATH%, kan du sette denne variabelen Til GnuWin32-katalogen slik at det kan finne verktøy som trengs for tester i den katalogen. LLVM_ENABLE_FFI: BOOL Angir om LLVM-Tolken skal kobles til libffi (Foreign FunctionInterface library) for å aktivere kall av eksterne funksjoner.Hvis biblioteket eller dets overskrifter er installert i en customlocation, kan du også sette variablene FFI_INCLUDE_DIR ogffi_library_dir til katalogene der ffi.h og libffi.so kan bli funnet,henholdsvis. Standard TIL AV. LLVM_EXTERNAL_{CLANG,LLD,POLLY}_source_dir:STI disse variablene angir banen til kildekatalogen for henholdsvis externalLLVM-prosjektene Clang, lld og Polly i forhold til top-levelsource-katalogen. Llvm / verktøy / klang For Klang), vil den tilsvarende variablevil ikke bli brukt. Hvis variabelen for et eksternt prosjekt ikke poengtil en gyldig bane, vil ikke prosjektet bygges. LLVM_ENABLE_PROJECTS:STRING Semikolon-separert liste over prosjekter å bygge, eller alle for å bygge alle (clang, libcxx, libcxxabi, lldb, compiler-rt, lld, polly, etc) prosjekter.Dette flagget forutsetter at prosjekter er sjekket ut side ved side og ikke nestet, dvs. clang må være parallelt med llvm i stedet for nestet i llvm / verktøy.Denne funksjonen gjør det mulig å ha en bygge for BARE LLVM og en annen for clang + llvmusing samme kilde kassa.DEN fullstendige listen er:clang;clang-tools-extra;compiler-rt;debuginfo-tests;libc;libclc;libcxx;libcxxabi;libunwind;lld;lldb;openmp;parallel-libs;polly;pstlLLVM_EXTERNAL_PROJECTS: STRING Semikolonseparert liste over flere eksterne prosjekter å bygge som en del avllvm. FOR hvert prosjekt MÅ LLVM_EXTERNAL_ < NAVN> _source_dir spesifiseres med banen for kildekoden til prosjektet. Eksempel:-DLLVM_EXTERNAL_PROJECTS="Foo;Bar"-DLLVM_EXTERNAL_FOO_SOURCE_DIR=/src/foo-DLLVM_EXTERNAL_BAR_SOURCE_DIR=/src/bar. LLVM_USE_OPROFILE: BOOL Aktiver bygge oprofile jit støtte. Standard TIL AV. LLVM_PROFDATA_FILE: STI Bane til en profdata-fil for å passere inn i clang ‘ s-fprofile-instr-use flagg. Thiscan bare spesifiseres hvis du bygger med clang. LLVM_USE_INTEL_JITEVENTS: BOOL Aktiver bygge støtte For Intel Jit Hendelser API. Standard TIL AV. LLVM_ENABLE_LIBPFM: BOOL Aktiver bygningen med libpfm å støtte maskinvare teller målinger I LLVMtools.Standard til PÅ. LLVM_USE_PERF: BOOL Aktiver bygge støtte For Perf (linux profilering verktøy) jit støtte. Standard TIL AV. LLVM_ENABLE_ZLIB: BOOL Aktiver bygning med zlib for å støtte komprimering / ukomprimering I LLVM-verktøy.Standard til PÅ. LLVM_ENABLE_DIA_SDK: BOOL Aktiver bygning MED MSVC DIA SDK for PDB debugging støtte. Tilgjengelig bare MED MSVC. Standard til PÅ. LLVM_USE_SANITIZER: STRENG Definere sanitizer brukes til å bygge LLVM binærfiler og tester. Mulige verdierer

Address,Memory,MemoryWithOrigins,Undefined,Thread,DataFlow, ogAddress;Undefined. Standard til tom streng. LLVM_UBSAN_FLAGS:STRING Definerer settet med kompileringsflagg som brukes til a aktivere UBSan. Brukes kun hvisLLVM_USE_SANITIZERinneholderUndefined. Dette kan brukes til å overstyrestandardsettet Av UBSan-flagg. LLVM_ENABLE_LTO: STRING Legg til-fltoeller-flto=flagg til kommandolinjene compile and link, som muliggjør optimalisering av koblingstid. Mulige verdier erOff,On,ThinogFull. Standard TIL AV. LLVM_USE_LINKER: STRENG Legg til-fuse-ld={name}til koblingsanrop. Den mulige verdien avhenger avdin kompilator, for clang verdien kan være en absolutt bane til customlinker, ellers clang vil prefiks navnet medld.og bruke sin usualsearch. For eksempel for å koble LLVM Med Gold linker, kan cmake invokedwith-DLLVM_USE_LINKER=gold. LLVM_ENABLE_LIBCXX: BOOL hvis vert kompilatoren og linker støtter stdlib flagget, – stdlib=libc++ ispassed til besvergelser av begge slik at prosjektet er bygget med libc++i stedet for stdlibc++. Standard TIL AV. LLVM_STATIC_LINK_CXX_STDLIB: BOOL Statisk lenke til C++ standardbiblioteket hvis mulig. Dette bruker flagget» – static-libstdc++», men En clang host-kompilator vil statisk lenke til libc++hvis den brukes sammen med LLVM_ENABLE_LIBCXX-flagget. Standard TIL AV. LLVM_ENABLE_LLD:BOOL dette alternativet tilsvarer-DLLVM_USE_LINKER=lld, unntatt i en 2-stagebuild der en avhengighet legges fra første trinn til den andre sikre at lld bygges før stage2 begynner. LLVM_PARALLEL_COMPILE_JOBS: STRENG Definerer maksimalt antall samtidige kompileringsjobber. LLVM_PARALLEL_LINK_JOBS: STRENG Definerer maksimalt antall samtidige koblingsjobber. LLVM_EXTERNALIZE_DEBUGINFO: BOOL Genererer dsym-filer og stripper kjørbare filer og biblioteker(Bare Darwin).Standard TIL AV. LLVM_USE_CRT_{target}: STRENG På Windows, forteller hvilken versjon Av c runtime library (CRT) som skal brukes.FOR eksempel-DLLVM_USE_CRT_RELEASE=MT ville statisk koble CRT til thellvm verktøy og bibliotek. LLVM_INTEGRATED_CRT_ALLOC: PATH

På Windows, kan bygge inn en annen c runtime allocator I LLVMtools og biblioteker. Ved hjelp av en låsefri allokator som de som er oppført nedenforreduserer ThinLTO-koblingstiden med omtrent en størrelsesorden. Det forbedrer også klang byggetider, med ca 5-10%. For øyeblikket støttes rpmalloc, snmalloc og mimalloc. Bruk banen til git clone å velgeden respektive tildeleren, for eksempel:

$ D:\git> git clone https://github.com/mjansson/rpmalloc$ D:\llvm-project> cmake ... -DLLVM_INTEGRATED_CRT_ALLOC=D:\git\rpmalloc

dette flagget må brukes sammen med den statiske CRT, dvs. hvis du bygger theRelease mål, legg TIL-DLLVM_USE_CRT_RELEASE=MT.

LLVM_BUILD_DOCS: BOOL Legger til alle aktiverte dokumentasjonsmål (dvs. Dette resulterer i at alle (aktiverte)dokumentasjonsmålene er en del av en normal konstruksjon. Hvis måletinstallkjøres, gjør dette også at alle innebygde dokumentasjonsmål kan installeres. Standard TIL AV. For å aktivere et bestemt dokumentasjonsmål, seesee LLVM_ENABLE_SPHINX OG LLVM_ENABLE_DOXYGEN. LLVM_ENABLE_DOXYGEN: BOOL Muliggjør generering AV søkbar HTML-dokumentasjon ved hjelp av doxygen.Standard TIL AV. LLVM_ENABLE_DOXYGEN_QT_HELP: BOOL Muliggjør generering av En Qt Komprimert Hjelpefil. Standard TIL AV.Dette påvirker make-måletdoxygen-llvm. Når aktivert, bortsett fra den normale HTML-utgangen generert av doxygen, vil dette produsere EN QCH filnavnorg.llvm.qch. Du kan deretter laste denne filen inn I Qt Creator.Dette alternativet er bare nyttig i kombinasjon med-DLLVM_ENABLE_DOXYGEN=ON; ellers har dette ingen effekt. LLVM_DOXYGEN_QCH_FILENAME: STRENG filnavnet Til Qt Komprimert Hjelpefilen som vil bli generert når-DLLVM_ENABLE_DOXYGEN=ONog-DLLVM_ENABLE_DOXYGEN_QT_HELP=ONer gitt. Standardinnstillingene erorg.llvm.qch.Dette alternativet er bare nyttig i kombinasjon med-DLLVM_ENABLE_DOXYGEN_QT_HELP=ON; ellers har det ingen effekt. LLVM_DOXYGEN_QHP_NAMESPACE: STRING Namespace der den mellomliggende Qt-Hjelpeprosjektfilen lever. Se QtHelp Projectfor mer informasjon. Standard til » org.llvm». Dette alternativet er bare nyttig ikombinasjon med-DLLVM_ENABLE_DOXYGEN_QT_HELP=ON; ellersdet har ingen effekt. LLVM_DOXYGEN_QHP_CUST_FILTER_NAME: STRENG Se Qt Hjelp Prosjekt formore informasjon. Standard CMake-variabelen${PACKAGE_STRING}som er en kombinasjon av pakkenavnet og versjonstrengen. Dette filteret kan thenbe brukes I Qt Creator å velge bare dokumentasjon FRA LLVM når browsingthrough alle hjelpefilene som du kanskje har lastet. Dette alternativet er barenyttig i kombinasjon med-DLLVM_ENABLE_DOXYGEN_QT_HELP=ON; ellers har det ingen effekt. LLVM_DOXYGEN_QHELPGENERATOR_PATH: STRENG banen tilqhelpgeneratorkjørbar. Standard til hva CMake erfind_program()kan finne. Dette alternativet er bare nyttig i kombinasjon med-DLLVM_ENABLE_DOXYGEN_QT_HELP=ON; ellers har det noeffect. LLVM_DOXYGEN_SVG: BOOL Bruker .svg-filer i stedet for .png-filer for grafer I Doxygen utgang.Standard TIL AV. LLVM_INSTALL_DOXYGEN_HTML_DIR: STRENG banen for å installere Doxygen-generert HTML-dokumentasjon til. Denne banen kan være absolutt eller i forhold TIL CMAKE_INSTALL_PREFIX. Standard toshare / doc / llvm / doxygen-html. LLVM_ENABLE_SPHINX: BOOL Hvis spesifisert, Vil CMake søke etter

sphinx-buildkjørbar og vil gjøreSPHINX_OUTPUT_HTMLOgSPHINX_OUTPUT_MANCMake alternativer tilgjengelig.Standard TIL AV. SPHINX_EXECUTABLE: STRENG banen tilsphinx-buildkjørbar oppdaget Av CMake.For installasjonsinstruksjoner, sehttps: / / www.sphinx-doc. org/no/master/bruk / installasjon.html SPHINX_OUTPUT_HTML: BOOL hvis aktivert (ogLLVM_ENABLE_SPHINXer aktivert), blir målene for å bygge dokumentasjonen som html lagt til (men ikke bygget som standard med mindreLLVM_BUILD_DOCSer aktivert). Det er et mål for hvert prosjekt i kildetreet som bruker sfinx (f. eks.docs-llvm-html,docs-clang-htmlogdocs-lld-html). Standard til PÅ. SPHINX_OUTPUT_MAN: BOOL hvis aktivert (ogLLVM_ENABLE_SPHINXer aktivert) målene for buildthe man sidene er lagt til (men ikke bygget som standard med mindreLLVM_BUILD_DOCSer aktivert). Foreløpig er det eneste målet lagt tildocs-llvm-man. Defaultsto PÅ. SPHINX_WARNINGS_AS_ERRORS:BOOL hvis aktivert da sphinx dokumentasjon advarsler vil bli behandlet aserrors. Standard til PÅ. LLVM_INSTALL_SPHINX_HTML_DIR: STRENG banen for å installere Sphinx-generert HTML-dokumentasjon til. Denne banen kan være absolutt eller i forhold TIL CMAKE_INSTALL_PREFIX. Standard toshare / doc / llvm / html. LLVM_INSTALL_OCAMLDOC_HTML_DIR: STRENG banen for å installere OCamldoc-generert HTML-dokumentasjon til. Denne banen kan være absolutt eller i forhold TIL CMAKE_INSTALL_PREFIX. Standard toshare / doc / llvm / ocaml-html. LLVM_CREATE_XCODE_TOOLCHAIN: BARE bool macOS: Hvis aktivert CMake vil generere et mål kalt ‘install-xcode-toolchain’. Dette målet vil opprette en katalog på$CMAKE_INSTALL_PREFIX / Toolchains som inneholder en xctoolchain-katalog som kan brukes til å overstyre standard systemverktøy. LLVM_BUILD_LLVM_DYLIB: BOOL hvis aktivert, er målet for å bygge libLLVM delt bibliotek lagt til.Dette biblioteket inneholder ALLE LLVMS komponenter i et enkelt delt bibliotek.Standard TIL AV. DETTE kan ikke brukes sammen MED BUILD_SHARED_LIBS.Verktøy vil bare være knyttet til librllvm delt bibliotek Hvis LLVM_LINK_LLVM_DYLIBis også PÅ.Komponentene i biblioteket kan tilpasses ved å sette LLVM_DYLIB_COMPONENTSto en liste over de ønskede komponentene.Dette alternativet er ikke tilgjengelig På Windows. LLVM_LINK_LLVM_DYLIB: BOOL hvis aktivert, vil verktøy bli koblet til libLLVM delt bibliotek. Defaultsto AV. Innstilling LLVM_LINK_LLVM_DYLIB TIL ON setter Også LLVM_BUILD_LLVM_DYLIBto PÅ.Dette alternativet er ikke tilgjengelig På Windows. BUILD_SHARED_LIBS: BOOL

Flagg som indikerer om HVER LLVM-komponent (F. Eks. Støtte) er bygget som en sharedlibrary (PÅ) eller som et statisk bibliotek (AV). Standardverdien ER AV. På windows kan delte biblioteker brukes når du bygger Med MinGW, inkludert mingw-w64, men ikke når du bygger Med Microsoft toolchain.

LLVM_OPTIMIZED_TABLEGEN: BOOL hvis aktivert Og bygge en debug eller hevder bygge CMake bygge systemet vilgenerere En Utgivelse bygge tre for å bygge en fullt optimalisert tablegen for using the build. Aktivering av dette alternativet kan øke byggetiden betydelig, spesielt når DU bygger LLVM i Feilsøkingskonfigurasjoner. LLVM_REVERSE_ITERATION: BOOL hvis aktivert, vil alle støttede uordnede llvm-beholdere bli iterert i omvendt rekkefølge. Dette er nyttig for å avdekke ikke-determinisme forårsaket avlitterasjon av uordnede beholdere. LLVM_BUILD_INSTRUMENTED_COVERAGE: BOOL hvis aktivert, er kildebasert kodedekning instrumentation aktivert mens du bygger llvm. LLVM_CCACHE_BUILD: BOOL hvis aktivert og programmetccacheer tilgjengelig, VIL LLVM bebuilt brukeccachefor å øke hastigheten på gjenoppbygginger AV LLVM og dets komponenter.Standard TIL AV. Størrelsen og plasseringen av cache maintainedbyccachekan justeres via LLVM_CCACHE_MAXSIZE Og LLVM_CCACHE_DIRoptions, som sendes til CCACHE_MAXSIZE og CCACHE_DIR environmentvariables, henholdsvis. LLVM_FORCE_USE_OLD_TOOLCHAIN: BOOL hvis aktivert, vil kompilatoren og standard bibliotekversjonene ikke bli sjekket. Llvmmkan ikke kompilere i det hele tatt, eller kan mislykkes under kjøring på grunn av kjente feil i disse verktøyene. LLVM_TEMPORARILY_ALLOW_OLD_TOOLCHAIN:BOOL hvis aktivert, vil kompilatoren versjonskontroll bare advare når du bruker en verktøykjedesom er i ferd med å bli foreldet, i stedet for å sende ut en feil. LLVM_USE_NEWPM: BOOL hvis aktivert, bruk eksperimentell ny pass manager. LLVM_ENABLE_BINDINGS: BOOL hvis deaktivert, ikke prøv å bygge OCaml og gå bindinger. LLVM_ENABLE_Z3_SOLVER: BOOL hvis aktivert, er z3 constraint solver aktivert For Clang statisk analysator.En nyere versjon av z3 biblioteket må være tilgjengelig på systemet. LLVM_USE_RELATIVE_PATHS_IN_DEBUG_INFO: BOOL Omskrive absolutte kilde stier i debug info til relative seg. Kildeinnstillingen kan justeres via VARIABELEN LLVM_SOURCE_PREFIX. LLVM_USE_RELATIVE_PATHS_IN_FILES: BOOL Omskrive absolutte kilde stier i kilder og debug info til relative seg. Thesource prefiks kan justeres via VARIABELEN LLVM_SOURCE_PREFIX. LLVM_INSTALL_UTILS: BOOL hvis aktivert, vil verktøybinærfiler somFileCheckognotbli installert til CMAKE_INSTALL_PREFIX.