From evan.cheng at apple.com Mon May 3 01:17:00 2010 From: evan.cheng at apple.com (Evan Cheng) Date: Mon, 03 May 2010 06:17:00 -0000 Subject: [llvm-commits] [test-suite] r102897 - /test-suite/trunk/Makefile.programs Message-ID: <20100503061700.6FAE3312800A@llvm.org> Author: evancheng Date: Mon May 3 01:17:00 2010 New Revision: 102897 URL: http://llvm.org/viewvc/llvm-project?rev=102897&view=rev Log: Test -combiner-alias-analysis as llcbeta. Modified: test-suite/trunk/Makefile.programs Modified: test-suite/trunk/Makefile.programs URL: http://llvm.org/viewvc/llvm-project/test-suite/trunk/Makefile.programs?rev=102897&r1=102896&r2=102897&view=diff ============================================================================== --- test-suite/trunk/Makefile.programs (original) +++ test-suite/trunk/Makefile.programs Mon May 3 01:17:00 2010 @@ -232,19 +232,19 @@ LLCBETAOPTION := -sched=simple endif ifeq ($(ARCH),x86_64) -LLCBETAOPTION := +LLCBETAOPTION := -combiner-alias-analysis endif ifeq ($(ARCH),x86) -LLCBETAOPTION := +LLCBETAOPTION := -combiner-alias-analysis endif ifeq ($(ARCH),Sparc) LLCBETAOPTION := -enable-sparc-v9-insts endif ifeq ($(ARCH),ARM) -LLCBETAOPTION := +LLCBETAOPTION := -combiner-alias-analysis endif ifeq ($(ARCH),THUMB) -LLCBETAOPTION := +LLCBETAOPTION := -combiner-alias-analysis endif print-llcbeta-option: From baldrick at free.fr Mon May 3 06:32:05 2010 From: baldrick at free.fr (Duncan Sands) Date: Mon, 03 May 2010 11:32:05 -0000 Subject: [llvm-commits] [dragonegg] r102899 - /dragonegg/trunk/llvm-backend.cpp Message-ID: <20100503113205.C1547312800A@llvm.org> Author: baldrick Date: Mon May 3 06:32:05 2010 New Revision: 102899 URL: http://llvm.org/viewvc/llvm-project?rev=102899&view=rev Log: Reorganize initialization code in an attempt to make it more logical. No intended functionality change. Modified: dragonegg/trunk/llvm-backend.cpp Modified: dragonegg/trunk/llvm-backend.cpp URL: http://llvm.org/viewvc/llvm-project/dragonegg/trunk/llvm-backend.cpp?rev=102899&r1=102898&r2=102899&view=diff ============================================================================== --- dragonegg/trunk/llvm-backend.cpp (original) +++ dragonegg/trunk/llvm-backend.cpp Mon May 3 06:32:05 2010 @@ -427,43 +427,15 @@ Args.push_back(0); // Null terminator. int pseudo_argc = Args.size()-1; llvm::cl::ParseCommandLineOptions(pseudo_argc, const_cast(&Args[0])); -} - -/// LazilyInitializeModule - Create a module to output LLVM IR to, if it wasn't -/// already created. -static void LazilyInitializeModule(void) { - static bool Initialized = false; - if (Initialized) - return; - - ConfigureLLVM(); - - TheModule = new Module("", getGlobalContext()); - - if (main_input_filename) - TheModule->setModuleIdentifier(main_input_filename); - - // Insert a special .ident directive to identify the version of the plugin - // which compiled this code. The format of the .ident string is patterned - // after the ones produced by GCC. -#ifdef IDENT_ASM_OP - if (!flag_no_ident) { - const char *pkg_version = "(GNU) "; - if (strcmp ("(GCC) ", pkgversion_string)) - pkg_version = pkgversion_string; - - std::string IdentString = IDENT_ASM_OP; - IdentString += "\"GCC: "; - IdentString += pkg_version; - IdentString += version_string; - IdentString += " LLVM: "; - IdentString += REVISION; - IdentString += "\""; - TheModule->setModuleInlineAsm(IdentString); - } -#endif + if (optimize) + RegisterRegAlloc::setDefault(createLinearScanRegisterAllocator); + else + RegisterRegAlloc::setDefault(createLocalRegisterAllocator); +} +/// ComputeTargetTriple - Determine the target triple to use. +static std::string ComputeTargetTriple() { // If the target wants to override the architecture, e.g. turning // powerpc-darwin-... into powerpc64-darwin-... when -m64 is enabled, do so // now. @@ -483,11 +455,11 @@ if (OverRidden) TargetTriple = std::string(NewTriple); #endif - TheModule->setTargetTriple(TargetTriple); - - TheTypeConverter = new TypeConverter(); + return TargetTriple; +} - // Create the TargetMachine we will be generating code with. +/// CreateTargetMachine - Create the TargetMachine we will generate code with. +static void CreateTargetMachine(const std::string &TargetTriple) { // FIXME: Figure out how to select the target and pass down subtarget info. std::string Err; const Target *TME = @@ -506,18 +478,61 @@ #endif TheTarget = TME->createTargetMachine(TargetTriple, FeatureStr); assert(TheTarget->getTargetData()->isBigEndian() == BYTES_BIG_ENDIAN); +} - TheFolder = new TargetFolder(TheTarget->getTargetData()); +/// CreateModule - Create and initialize a module to output LLVM IR to. +static void CreateModule(const std::string &TargetTriple) { + // Create the module itself. + StringRef ModuleID = main_input_filename ? main_input_filename : ""; + TheModule = new Module(ModuleID, getGlobalContext()); + + // Insert a special .ident directive to identify the version of the plugin + // which compiled this code. The format of the .ident string is patterned + // after the ones produced by GCC. +#ifdef IDENT_ASM_OP + if (!flag_no_ident) { + const char *pkg_version = "(GNU) "; + + if (strcmp ("(GCC) ", pkgversion_string)) + pkg_version = pkgversion_string; + + std::string IdentString = IDENT_ASM_OP; + IdentString += "\"GCC: "; + IdentString += pkg_version; + IdentString += version_string; + IdentString += " LLVM: "; + IdentString += REVISION; + IdentString += "\""; + TheModule->setModuleInlineAsm(IdentString); + } +#endif - // Install information about target datalayout stuff into the module for - // optimizer use. + // Install information about the target triple and data layout into the module + // for optimizer use. + TheModule->setTargetTriple(TargetTriple); TheModule->setDataLayout(TheTarget->getTargetData()-> getStringRepresentation()); +} - if (optimize) - RegisterRegAlloc::setDefault(createLinearScanRegisterAllocator); - else - RegisterRegAlloc::setDefault(createLocalRegisterAllocator); +/// InitializeBackend - Initialize the GCC to LLVM conversion machinery. +/// Can safely be called multiple times. +static void InitializeBackend(void) { + static bool Initialized = false; + if (Initialized) + return; + + // Initialize and configure LLVM. + ConfigureLLVM(); + + // Create the target machine to generate code for. + const std::string TargetTriple = ComputeTargetTriple(); + CreateTargetMachine(TargetTriple); + + // Create a module to hold the generated LLVM IR. + CreateModule(TargetTriple); + + TheTypeConverter = new TypeConverter(); + TheFolder = new TargetFolder(TheTarget->getTargetData()); if (debug_info_level > DINFO_LEVEL_NONE) TheDebugInfo = new DebugInfo(TheModule); @@ -1837,7 +1852,7 @@ if (errorcount || sorrycount) return; // Do not process broken code. - LazilyInitializeModule(); + InitializeBackend(); // Visit each function with a body, outputting it only once (the same function // can appear in multiple cgraph nodes due to cloning). @@ -1900,7 +1915,7 @@ if (errorcount || sorrycount) return; // Do not process broken code. - LazilyInitializeModule(); + InitializeBackend(); // Output all externally visible global variables, whether they are used in // this compilation unit or not, as well as any internal variables explicitly @@ -1995,7 +2010,7 @@ if (!quiet_flag) errs() << "Finishing compilation unit\n"; - LazilyInitializeModule(); + InitializeBackend(); //TODO timevar_push(TV_LLVM_PERFILE); LLVMContext &Context = getGlobalContext(); From baldrick at free.fr Mon May 3 07:21:54 2010 From: baldrick at free.fr (Duncan Sands) Date: Mon, 03 May 2010 12:21:54 -0000 Subject: [llvm-commits] [dragonegg] r102900 - in /dragonegg/trunk: bits_and_bobs.cpp bits_and_bobs.h llvm-backend.cpp llvm-convert.cpp llvm-debug.cpp llvm-internal.h llvm-types.cpp Message-ID: <20100503122154.428CA312800A@llvm.org> Author: baldrick Date: Mon May 3 07:21:53 2010 New Revision: 102900 URL: http://llvm.org/viewvc/llvm-project?rev=102900&view=rev Log: Create a place for installing language specific configuration settings. Use it to set flag_odr for C++. Removed: dragonegg/trunk/bits_and_bobs.h Modified: dragonegg/trunk/bits_and_bobs.cpp dragonegg/trunk/llvm-backend.cpp dragonegg/trunk/llvm-convert.cpp dragonegg/trunk/llvm-debug.cpp dragonegg/trunk/llvm-internal.h dragonegg/trunk/llvm-types.cpp Modified: dragonegg/trunk/bits_and_bobs.cpp URL: http://llvm.org/viewvc/llvm-project/dragonegg/trunk/bits_and_bobs.cpp?rev=102900&r1=102899&r2=102900&view=diff ============================================================================== --- dragonegg/trunk/bits_and_bobs.cpp (original) +++ dragonegg/trunk/bits_and_bobs.cpp Mon May 3 07:21:53 2010 @@ -1,7 +1,5 @@ #include -bool flag_odr = false; - int ix86_regparm; union tree_node; Removed: dragonegg/trunk/bits_and_bobs.h URL: http://llvm.org/viewvc/llvm-project/dragonegg/trunk/bits_and_bobs.h?rev=102899&view=auto ============================================================================== --- dragonegg/trunk/bits_and_bobs.h (original) +++ dragonegg/trunk/bits_and_bobs.h (removed) @@ -1,7 +0,0 @@ -// Place to keep various things that will need to be sorted out someday. -#ifndef BITS_AND_BOBS_H -#define BITS_AND_BOBS_H - -extern bool flag_odr; - -#endif Modified: dragonegg/trunk/llvm-backend.cpp URL: http://llvm.org/viewvc/llvm-project/dragonegg/trunk/llvm-backend.cpp?rev=102900&r1=102899&r2=102900&view=diff ============================================================================== --- dragonegg/trunk/llvm-backend.cpp (original) +++ dragonegg/trunk/llvm-backend.cpp Mon May 3 07:21:53 2010 @@ -88,7 +88,6 @@ #include "llvm-debug.h" #include "llvm-target.h" #include "llvm-os.h" -#include "bits_and_bobs.h" extern "C" { #include "llvm-cache.h" } @@ -514,6 +513,32 @@ getStringRepresentation()); } +/// flag_odr - Whether the language being compiled obeys the One Definition Rule +/// (i.e. if the same function is defined in multiple compilation units, all the +/// definitions are equivalent). +bool flag_odr; + +/// InstallLanguageSettings - Do any language-specific back-end configuration. +static void InstallLanguageSettings() { + // The principal here is that not doing any language-specific configuration + // should still result in correct code. The language-specific settings are + // only for obtaining better code, but exploiting language-specific features. + StringRef LanguageName = lang_hooks.name; + + if (LanguageName == "GNU Ada") { + flag_odr = true; // Ada obeys the one-definition-rule. + } else if (LanguageName == "GNU C") { + } else if (LanguageName == "GNU C++") { + flag_odr = true; // C++ obeys the one-definition-rule. + } else if (LanguageName == "GNU Fortran") { + } else if (LanguageName == "GNU GIMPLE") { // LTO gold plugin. + } else if (LanguageName == "GNU Java") { + } else if (LanguageName == "GNU Objective-C") { + } else if (LanguageName == "GNU Objective-C++") { + flag_odr = true; // Objective C++ obeys the one-definition-rule. + } +} + /// InitializeBackend - Initialize the GCC to LLVM conversion machinery. /// Can safely be called multiple times. static void InitializeBackend(void) { @@ -539,6 +564,9 @@ if (TheDebugInfo) TheDebugInfo->Initialize(); + // Perform language specific configuration. + InstallLanguageSettings(); + Initialized = true; } Modified: dragonegg/trunk/llvm-convert.cpp URL: http://llvm.org/viewvc/llvm-project/dragonegg/trunk/llvm-convert.cpp?rev=102900&r1=102899&r2=102900&view=diff ============================================================================== --- dragonegg/trunk/llvm-convert.cpp (original) +++ dragonegg/trunk/llvm-convert.cpp Mon May 3 07:21:53 2010 @@ -84,7 +84,6 @@ #include "llvm-abi.h" #include "llvm-internal.h" #include "llvm-debug.h" -#include "bits_and_bobs.h" static LLVMContext &Context = getGlobalContext(); Modified: dragonegg/trunk/llvm-debug.cpp URL: http://llvm.org/viewvc/llvm-project/dragonegg/trunk/llvm-debug.cpp?rev=102900&r1=102899&r2=102900&view=diff ============================================================================== --- dragonegg/trunk/llvm-debug.cpp (original) +++ dragonegg/trunk/llvm-debug.cpp Mon May 3 07:21:53 2010 @@ -59,7 +59,6 @@ #include "llvm-abi.h" #include "llvm-debug.h" #include "llvm-internal.h" -#include "bits_and_bobs.h" using namespace llvm; using namespace llvm::dwarf; Modified: dragonegg/trunk/llvm-internal.h URL: http://llvm.org/viewvc/llvm-project/dragonegg/trunk/llvm-internal.h?rev=102900&r1=102899&r2=102900&view=diff ============================================================================== --- dragonegg/trunk/llvm-internal.h (original) +++ dragonegg/trunk/llvm-internal.h Mon May 3 07:21:53 2010 @@ -87,6 +87,11 @@ /// getTargetData - Return the current TargetData object from TheTarget. const TargetData &getTargetData(); +/// flag_odr - Whether the language being compiled obeys the One Definition Rule +/// (i.e. if the same function is defined in multiple compilation units, all the +/// definitions are equivalent). +extern bool flag_odr; + /// AttributeUsedGlobals - The list of globals that are marked attribute(used). extern SmallSetVector AttributeUsedGlobals; Modified: dragonegg/trunk/llvm-types.cpp URL: http://llvm.org/viewvc/llvm-project/dragonegg/trunk/llvm-types.cpp?rev=102900&r1=102899&r2=102900&view=diff ============================================================================== --- dragonegg/trunk/llvm-types.cpp (original) +++ dragonegg/trunk/llvm-types.cpp Mon May 3 07:21:53 2010 @@ -56,7 +56,6 @@ extern "C" { #include "llvm-cache.h" } -#include "bits_and_bobs.h" static LLVMContext &Context = getGlobalContext(); From baldrick at free.fr Mon May 3 07:44:40 2010 From: baldrick at free.fr (Duncan Sands) Date: Mon, 03 May 2010 12:44:40 -0000 Subject: [llvm-commits] [dragonegg] r102901 - in /dragonegg/trunk: llvm-backend.cpp llvm-convert.cpp llvm-internal.h Message-ID: <20100503124440.45D42312800A@llvm.org> Author: baldrick Date: Mon May 3 07:44:40 2010 New Revision: 102901 URL: http://llvm.org/viewvc/llvm-project?rev=102901&view=rev Log: Move the language test for turning "T foo() {}" into "T foo(void) {}" into the common language specific configuration routine. Modified: dragonegg/trunk/llvm-backend.cpp dragonegg/trunk/llvm-convert.cpp dragonegg/trunk/llvm-internal.h Modified: dragonegg/trunk/llvm-backend.cpp URL: http://llvm.org/viewvc/llvm-project/dragonegg/trunk/llvm-backend.cpp?rev=102901&r1=102900&r2=102901&view=diff ============================================================================== --- dragonegg/trunk/llvm-backend.cpp (original) +++ dragonegg/trunk/llvm-backend.cpp Mon May 3 07:44:40 2010 @@ -518,6 +518,11 @@ /// definitions are equivalent). bool flag_odr; +/// flag_vararg_requires_arguments - Do not consider functions with no arguments +/// to take a variable number of arguments (...). If set then a function like +/// "T foo() {}" will be treated like "T foo(void) {}" and not "T foo(...) {}". +bool flag_vararg_requires_arguments; + /// InstallLanguageSettings - Do any language-specific back-end configuration. static void InstallLanguageSettings() { // The principal here is that not doing any language-specific configuration @@ -528,12 +533,14 @@ if (LanguageName == "GNU Ada") { flag_odr = true; // Ada obeys the one-definition-rule. } else if (LanguageName == "GNU C") { + flag_vararg_requires_arguments = true; // "T foo() {}" -> "T foo(void) {}" } else if (LanguageName == "GNU C++") { flag_odr = true; // C++ obeys the one-definition-rule. } else if (LanguageName == "GNU Fortran") { } else if (LanguageName == "GNU GIMPLE") { // LTO gold plugin. } else if (LanguageName == "GNU Java") { } else if (LanguageName == "GNU Objective-C") { + flag_vararg_requires_arguments = true; // "T foo() {}" -> "T foo(void) {}" } else if (LanguageName == "GNU Objective-C++") { flag_odr = true; // Objective C++ obeys the one-definition-rule. } Modified: dragonegg/trunk/llvm-convert.cpp URL: http://llvm.org/viewvc/llvm-project/dragonegg/trunk/llvm-convert.cpp?rev=102901&r1=102900&r2=102901&view=diff ============================================================================== --- dragonegg/trunk/llvm-convert.cpp (original) +++ dragonegg/trunk/llvm-convert.cpp Mon May 3 07:44:40 2010 @@ -525,19 +525,6 @@ return false; } -/// LanguageIsC - Return true if we are compiling C or Objective-C. -static bool LanguageIsC() { - // If we've already determined this, return it. - static unsigned Val = 2; - if (Val != 2) return (bool)Val; - - StringRef LanguageName = lang_hooks.name; - - if (LanguageName == "GNU C" || LanguageName == "GNU Objective-C") - return (Val = true); - return (Val = false); -} - void TreeToLLVM::StartFunctionBody() { std::string Name = getLLVMAssemblerName(FnDecl).str(); // TODO: Add support for dropping the leading '\1' in order to support @@ -558,7 +545,7 @@ // // Note that we only do this in C/Objective-C. Doing this in C++ for // functions explicitly declared as taking (...) is bad. - if (TYPE_ARG_TYPES(TREE_TYPE(FnDecl)) == 0 && LanguageIsC()) { + if (TYPE_ARG_TYPES(TREE_TYPE(FnDecl)) == 0 && flag_vararg_requires_arguments){ FTy = TheTypeConverter->ConvertArgListToFnType(TREE_TYPE(FnDecl), DECL_ARGUMENTS(FnDecl), static_chain, Modified: dragonegg/trunk/llvm-internal.h URL: http://llvm.org/viewvc/llvm-project/dragonegg/trunk/llvm-internal.h?rev=102901&r1=102900&r2=102901&view=diff ============================================================================== --- dragonegg/trunk/llvm-internal.h (original) +++ dragonegg/trunk/llvm-internal.h Mon May 3 07:44:40 2010 @@ -92,6 +92,11 @@ /// definitions are equivalent). extern bool flag_odr; +/// flag_vararg_requires_arguments - Do not consider functions with no arguments +/// to take a variable number of arguments (...). If set then a function like +/// "T foo() {}" will be treated like "T foo(void) {}" and not "T foo(...) {}". +extern bool flag_vararg_requires_arguments; + /// AttributeUsedGlobals - The list of globals that are marked attribute(used). extern SmallSetVector AttributeUsedGlobals; From baldrick at free.fr Mon May 3 09:09:08 2010 From: baldrick at free.fr (Duncan Sands) Date: Mon, 03 May 2010 14:09:08 -0000 Subject: [llvm-commits] [dragonegg] r102903 - in /dragonegg/trunk: llvm-backend.cpp llvm-internal.h Message-ID: <20100503140908.6099A312800A@llvm.org> Author: baldrick Date: Mon May 3 09:09:08 2010 New Revision: 102903 URL: http://llvm.org/viewvc/llvm-project?rev=102903&view=rev Log: Do not zero initialize global variables without an initial value when compiling Ada. Modified: dragonegg/trunk/llvm-backend.cpp dragonegg/trunk/llvm-internal.h Modified: dragonegg/trunk/llvm-backend.cpp URL: http://llvm.org/viewvc/llvm-project/dragonegg/trunk/llvm-backend.cpp?rev=102903&r1=102902&r2=102903&view=diff ============================================================================== --- dragonegg/trunk/llvm-backend.cpp (original) +++ dragonegg/trunk/llvm-backend.cpp Mon May 3 09:09:08 2010 @@ -513,6 +513,10 @@ getStringRepresentation()); } +/// flag_default_initialize_globals - Whether global variables with no explicit +/// initial value should be zero initialized. +bool flag_default_initialize_globals = true; // GCC always initializes to zero + /// flag_odr - Whether the language being compiled obeys the One Definition Rule /// (i.e. if the same function is defined in multiple compilation units, all the /// definitions are equivalent). @@ -531,18 +535,19 @@ StringRef LanguageName = lang_hooks.name; if (LanguageName == "GNU Ada") { - flag_odr = true; // Ada obeys the one-definition-rule. + flag_default_initialize_globals = false; // Uninitialized means what it says + flag_odr = true; // Ada obeys the one-definition-rule } else if (LanguageName == "GNU C") { flag_vararg_requires_arguments = true; // "T foo() {}" -> "T foo(void) {}" } else if (LanguageName == "GNU C++") { - flag_odr = true; // C++ obeys the one-definition-rule. + flag_odr = true; // C++ obeys the one-definition-rule } else if (LanguageName == "GNU Fortran") { - } else if (LanguageName == "GNU GIMPLE") { // LTO gold plugin. + } else if (LanguageName == "GNU GIMPLE") { // LTO gold plugin } else if (LanguageName == "GNU Java") { } else if (LanguageName == "GNU Objective-C") { flag_vararg_requires_arguments = true; // "T foo() {}" -> "T foo(void) {}" } else if (LanguageName == "GNU Objective-C++") { - flag_odr = true; // Objective C++ obeys the one-definition-rule. + flag_odr = true; // Objective C++ obeys the one-definition-rule } } @@ -1002,10 +1007,14 @@ // Convert the initializer over. Constant *Init; if (DECL_INITIAL(decl) == 0 || DECL_INITIAL(decl) == error_mark_node) { - // This global should be zero initialized. Reconvert the type in case the - // forward def of the global and the real def differ in type (e.g. declared - // as 'int A[]', and defined as 'int A[100]'). - Init = Constant::getNullValue(ConvertType(TREE_TYPE(decl))); + // Reconvert the type in case the forward def of the global and the real def + // differ in type (e.g. declared as 'int A[]', and defined as 'int A[100]'). + const Type *Ty = ConvertType(TREE_TYPE(decl)); + + if (flag_default_initialize_globals) + Init = Constant::getNullValue(Ty); + else + Init = UndefValue::get(Ty); } else { assert((TREE_CONSTANT(DECL_INITIAL(decl)) || TREE_CODE(DECL_INITIAL(decl)) == STRING_CST) && Modified: dragonegg/trunk/llvm-internal.h URL: http://llvm.org/viewvc/llvm-project/dragonegg/trunk/llvm-internal.h?rev=102903&r1=102902&r2=102903&view=diff ============================================================================== --- dragonegg/trunk/llvm-internal.h (original) +++ dragonegg/trunk/llvm-internal.h Mon May 3 09:09:08 2010 @@ -87,6 +87,10 @@ /// getTargetData - Return the current TargetData object from TheTarget. const TargetData &getTargetData(); +/// flag_default_initialize_globals - Whether global variables with no explicit +/// initial value should be zero initialized. +extern bool flag_default_initialize_globals; + /// flag_odr - Whether the language being compiled obeys the One Definition Rule /// (i.e. if the same function is defined in multiple compilation units, all the /// definitions are equivalent). From baldrick at free.fr Mon May 3 09:11:22 2010 From: baldrick at free.fr (Duncan Sands) Date: Mon, 03 May 2010 14:11:22 -0000 Subject: [llvm-commits] [dragonegg] r102904 - /dragonegg/trunk/llvm-backend.cpp Message-ID: <20100503141122.712E0312800A@llvm.org> Author: baldrick Date: Mon May 3 09:11:22 2010 New Revision: 102904 URL: http://llvm.org/viewvc/llvm-project?rev=102904&view=rev Log: Turn off flag_odr for C++ to see if it fixes the self-host build. Modified: dragonegg/trunk/llvm-backend.cpp Modified: dragonegg/trunk/llvm-backend.cpp URL: http://llvm.org/viewvc/llvm-project/dragonegg/trunk/llvm-backend.cpp?rev=102904&r1=102903&r2=102904&view=diff ============================================================================== --- dragonegg/trunk/llvm-backend.cpp (original) +++ dragonegg/trunk/llvm-backend.cpp Mon May 3 09:11:22 2010 @@ -540,7 +540,7 @@ } else if (LanguageName == "GNU C") { flag_vararg_requires_arguments = true; // "T foo() {}" -> "T foo(void) {}" } else if (LanguageName == "GNU C++") { - flag_odr = true; // C++ obeys the one-definition-rule +//FIXME flag_odr = true; // C++ obeys the one-definition-rule } else if (LanguageName == "GNU Fortran") { } else if (LanguageName == "GNU GIMPLE") { // LTO gold plugin } else if (LanguageName == "GNU Java") { From gohman at apple.com Mon May 3 09:31:00 2010 From: gohman at apple.com (Dan Gohman) Date: Mon, 03 May 2010 14:31:00 -0000 Subject: [llvm-commits] [llvm] r102906 - /llvm/trunk/lib/Target/README.txt Message-ID: <20100503143100.936B4312800A@llvm.org> Author: djg Date: Mon May 3 09:31:00 2010 New Revision: 102906 URL: http://llvm.org/viewvc/llvm-project?rev=102906&view=rev Log: Add a README entry. Modified: llvm/trunk/lib/Target/README.txt Modified: llvm/trunk/lib/Target/README.txt URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Target/README.txt?rev=102906&r1=102905&r2=102906&view=diff ============================================================================== --- llvm/trunk/lib/Target/README.txt (original) +++ llvm/trunk/lib/Target/README.txt Mon May 3 09:31:00 2010 @@ -1835,3 +1835,16 @@ //===---------------------------------------------------------------------===// +In this code: + +long foo(long x) { + return x > 1 ? x : 1; +} + +LLVM emits a comparison with 1 instead of 0. 0 would be equivalent +and cheaper on most targets. + +LLVM prefers comparisons with zero over non-zero in general, but in this +case it choses instead to keep the max operation obvious. + +//===---------------------------------------------------------------------===// From gohman at apple.com Mon May 3 09:35:47 2010 From: gohman at apple.com (Dan Gohman) Date: Mon, 03 May 2010 14:35:47 -0000 Subject: [llvm-commits] [llvm] r102907 - in /llvm/trunk: lib/CodeGen/BranchFolding.cpp test/CodeGen/ARM/ifcvt2.ll test/CodeGen/ARM/ifcvt5.ll test/CodeGen/Thumb2/2009-10-15-ITBlockBranch.ll test/CodeGen/Thumb2/thumb2-branch.ll test/CodeGen/X86/tail-opts.ll Message-ID: <20100503143547.A1811312800A@llvm.org> Author: djg Date: Mon May 3 09:35:47 2010 New Revision: 102907 URL: http://llvm.org/viewvc/llvm-project?rev=102907&view=rev Log: Fix a bug which prevented tail merging of return instructions in beneficial cases. See the changes in test/CodeGen/X86/tail-opts.ll and test/CodeGen/ARM/ifcvt2.ll for details. The fix is to change HashEndOfMBB to hash at most one instruction, instead of trying to apply heuristics about when it will be profitable to consider more than one instruction. The regular tail-merging heuristics are already prepared to handle the same cases, and they're more precise. Also, make test/CodeGen/ARM/ifcvt5.ll and test/CodeGen/Thumb2/thumb2-branch.ll slightly more complex so that they continue to test what they're intended to test. And, this eliminates the problem in test/CodeGen/Thumb2/2009-10-15-ITBlockBranch.ll, the testcase from PR5204. Update it accordingly. Modified: llvm/trunk/lib/CodeGen/BranchFolding.cpp llvm/trunk/test/CodeGen/ARM/ifcvt2.ll llvm/trunk/test/CodeGen/ARM/ifcvt5.ll llvm/trunk/test/CodeGen/Thumb2/2009-10-15-ITBlockBranch.ll llvm/trunk/test/CodeGen/Thumb2/thumb2-branch.ll llvm/trunk/test/CodeGen/X86/tail-opts.ll Modified: llvm/trunk/lib/CodeGen/BranchFolding.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/CodeGen/BranchFolding.cpp?rev=102907&r1=102906&r2=102907&view=diff ============================================================================== --- llvm/trunk/lib/CodeGen/BranchFolding.cpp (original) +++ llvm/trunk/lib/CodeGen/BranchFolding.cpp Mon May 3 09:35:47 2010 @@ -264,14 +264,8 @@ return Hash; } -/// HashEndOfMBB - Hash the last few instructions in the MBB. For blocks -/// with no successors, we hash two instructions, because cross-jumping -/// only saves code when at least two instructions are removed (since a -/// branch must be inserted). For blocks with a successor, one of the -/// two blocks to be tail-merged will end with a branch already, so -/// it gains to cross-jump even for one instruction. -static unsigned HashEndOfMBB(const MachineBasicBlock *MBB, - unsigned minCommonTailLength) { +/// HashEndOfMBB - Hash the last instruction in the MBB. +static unsigned HashEndOfMBB(const MachineBasicBlock *MBB) { MachineBasicBlock::const_iterator I = MBB->end(); if (I == MBB->begin()) return 0; // Empty MBB. @@ -283,20 +277,8 @@ return 0; // MBB empty except for debug info. --I; } - unsigned Hash = HashMachineInstr(I); - if (I == MBB->begin() || minCommonTailLength == 1) - return Hash; // Single instr MBB. - - --I; - while (I->isDebugValue()) { - if (I==MBB->begin()) - return Hash; // MBB with single non-debug instr. - --I; - } - // Hash in the second-to-last instruction. - Hash ^= HashMachineInstr(I) << 2; - return Hash; + return HashMachineInstr(I); } /// ComputeCommonTailLength - Given two machine basic blocks, compute the number @@ -811,7 +793,7 @@ MergePotentials.clear(); for (MachineFunction::iterator I = MF.begin(), E = MF.end(); I != E; ++I) { if (I->succ_empty()) - MergePotentials.push_back(MergePotentialsElt(HashEndOfMBB(I, 2U), I)); + MergePotentials.push_back(MergePotentialsElt(HashEndOfMBB(I), I)); } // See if we can do any tail merging on those. @@ -897,8 +879,7 @@ // reinsert conditional branch only, for now TII->InsertBranch(*PBB, (TBB == IBB) ? FBB : TBB, 0, NewCond); } - MergePotentials.push_back(MergePotentialsElt(HashEndOfMBB(PBB, 1U), - *P)); + MergePotentials.push_back(MergePotentialsElt(HashEndOfMBB(PBB), *P)); } } if (MergePotentials.size() >= 2) Modified: llvm/trunk/test/CodeGen/ARM/ifcvt2.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/ARM/ifcvt2.ll?rev=102907&r1=102906&r2=102907&view=diff ============================================================================== --- llvm/trunk/test/CodeGen/ARM/ifcvt2.ll (original) +++ llvm/trunk/test/CodeGen/ARM/ifcvt2.ll Mon May 3 09:35:47 2010 @@ -1,7 +1,8 @@ -; RUN: llc < %s -march=arm -; RUN: llc < %s -march=arm | grep bxlt | count 1 -; RUN: llc < %s -march=arm | grep bxgt | count 1 -; RUN: llc < %s -march=arm | grep bxge | count 1 +; RUN: llc < %s -march=arm > %t +; RUN: grep bxlt %t | count 1 +; RUN: grep bxgt %t | count 1 +; RUN: not grep bxge %t +; RUN: not grep bxle %t define i32 @t1(i32 %a, i32 %b, i32 %c, i32 %d) { %tmp2 = icmp sgt i32 %c, 10 Modified: llvm/trunk/test/CodeGen/ARM/ifcvt5.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/ARM/ifcvt5.ll?rev=102907&r1=102906&r2=102907&view=diff ============================================================================== --- llvm/trunk/test/CodeGen/ARM/ifcvt5.ll (original) +++ llvm/trunk/test/CodeGen/ARM/ifcvt5.ll Mon May 3 09:35:47 2010 @@ -9,7 +9,7 @@ ret void } -define void @t1(i32 %a, i32 %b) { +define i32 @t1(i32 %a, i32 %b) { ; CHECK: t1: ; CHECK: ldmialt sp!, {r7, pc} entry: @@ -18,8 +18,8 @@ cond_true: ; preds = %entry tail call void @foo( i32 %b ) - ret void + ret i32 0 UnifiedReturnBlock: ; preds = %entry - ret void + ret i32 1 } Modified: llvm/trunk/test/CodeGen/Thumb2/2009-10-15-ITBlockBranch.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/Thumb2/2009-10-15-ITBlockBranch.ll?rev=102907&r1=102906&r2=102907&view=diff ============================================================================== --- llvm/trunk/test/CodeGen/Thumb2/2009-10-15-ITBlockBranch.ll (original) +++ llvm/trunk/test/CodeGen/Thumb2/2009-10-15-ITBlockBranch.ll Mon May 3 09:35:47 2010 @@ -1,6 +1,5 @@ ; RUN: llc < %s -mtriple=thumbv7-eabi -mcpu=cortex-a8 -float-abi=hard | FileCheck %s - -; A fix for PR5204 will require this check to be changed. +; PR5204 %"struct.__gnu_cxx::__normal_iterator, std::allocator > >" = type { i8* } %"struct.__gnu_cxx::new_allocator" = type <{ i8 }> @@ -11,11 +10,9 @@ define weak arm_aapcs_vfpcc i32 @_ZNKSs7compareERKSs(%"struct.std::basic_string,std::allocator >"* %this, %"struct.std::basic_string,std::allocator >"* %__str) { ; CHECK: _ZNKSs7compareERKSs: -; CHECK: it ne -; CHECK-NEXT: ldmiane.w -; CHECK-NEXT: itt eq -; CHECK-NEXT: subeq.w -; CHECK-NEXT: ldmiaeq.w +; CHECK: it eq +; CHECK-NEXT: subeq.w r0, r6, r8 +; CHECK-NEXT: ldmia.w sp, {r4, r5, r6, r8, r9, pc} entry: %0 = tail call arm_aapcs_vfpcc i32 @_ZNKSs4sizeEv(%"struct.std::basic_string,std::allocator >"* %this) ; [#uses=3] %1 = tail call arm_aapcs_vfpcc i32 @_ZNKSs4sizeEv(%"struct.std::basic_string,std::allocator >"* %__str) ; [#uses=3] Modified: llvm/trunk/test/CodeGen/Thumb2/thumb2-branch.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/Thumb2/thumb2-branch.ll?rev=102907&r1=102906&r2=102907&view=diff ============================================================================== --- llvm/trunk/test/CodeGen/Thumb2/thumb2-branch.ll (original) +++ llvm/trunk/test/CodeGen/Thumb2/thumb2-branch.ll Mon May 3 09:35:47 2010 @@ -1,6 +1,6 @@ ; RUN: llc < %s -mtriple=thumbv7-apple-darwin -mattr=+thumb2 | FileCheck %s -define void @f1(i32 %a, i32 %b, i32* %v) { +define i32 @f1(i32 %a, i32 %b, i32* %v) { entry: ; CHECK: f1: ; CHECK: bne LBB @@ -9,13 +9,13 @@ cond_true: ; preds = %entry store i32 0, i32* %v - ret void + ret i32 0 return: ; preds = %entry - ret void + ret i32 1 } -define void @f2(i32 %a, i32 %b, i32* %v) { +define i32 @f2(i32 %a, i32 %b, i32* %v) { entry: ; CHECK: f2: ; CHECK: bge LBB @@ -24,13 +24,13 @@ cond_true: ; preds = %entry store i32 0, i32* %v - ret void + ret i32 0 return: ; preds = %entry - ret void + ret i32 1 } -define void @f3(i32 %a, i32 %b, i32* %v) { +define i32 @f3(i32 %a, i32 %b, i32* %v) { entry: ; CHECK: f3: ; CHECK: bhs LBB @@ -39,13 +39,13 @@ cond_true: ; preds = %entry store i32 0, i32* %v - ret void + ret i32 0 return: ; preds = %entry - ret void + ret i32 1 } -define void @f4(i32 %a, i32 %b, i32* %v) { +define i32 @f4(i32 %a, i32 %b, i32* %v) { entry: ; CHECK: f4: ; CHECK: blo LBB @@ -54,8 +54,8 @@ cond_true: ; preds = %entry store i32 0, i32* %v - ret void + ret i32 0 return: ; preds = %entry - ret void + ret i32 1 } Modified: llvm/trunk/test/CodeGen/X86/tail-opts.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/X86/tail-opts.ll?rev=102907&r1=102906&r2=102907&view=diff ============================================================================== --- llvm/trunk/test/CodeGen/X86/tail-opts.ll (original) +++ llvm/trunk/test/CodeGen/X86/tail-opts.ll Mon May 3 09:35:47 2010 @@ -406,3 +406,26 @@ return: ret void } + +; Tail-merging should merge the two ret instructions since one side +; can fall-through into the ret and the other side has to branch anyway. + +; CHECK: TESTE: +; CHECK: imulq +; CHECK-NEXT: LBB8_2: +; CHECK-NEXT: ret + +define i64 @TESTE(i64 %parami, i64 %paraml) nounwind readnone { +entry: + %cmp = icmp slt i64 %parami, 1 ; [#uses=1] + %varx.0 = select i1 %cmp, i64 1, i64 %parami ; [#uses=1] + %cmp410 = icmp slt i64 %paraml, 1 ; [#uses=1] + br i1 %cmp410, label %for.end, label %bb.nph + +bb.nph: ; preds = %entry + %tmp15 = mul i64 %paraml, %parami ; [#uses=1] + ret i64 %tmp15 + +for.end: ; preds = %entry + ret i64 %varx.0 +} From gohman at apple.com Mon May 3 09:51:43 2010 From: gohman at apple.com (Dan Gohman) Date: Mon, 03 May 2010 14:51:43 -0000 Subject: [llvm-commits] [llvm] r102908 - /llvm/trunk/docs/LangRef.html Message-ID: <20100503145143.CCC78312800A@llvm.org> Author: djg Date: Mon May 3 09:51:43 2010 New Revision: 102908 URL: http://llvm.org/viewvc/llvm-project?rev=102908&view=rev Log: Say "operations" instead of "instructions", as nsw can be applied to constant expressions as well as instructions. Modified: llvm/trunk/docs/LangRef.html Modified: llvm/trunk/docs/LangRef.html URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/LangRef.html?rev=102908&r1=102907&r2=102908&view=diff ============================================================================== --- llvm/trunk/docs/LangRef.html (original) +++ llvm/trunk/docs/LangRef.html Mon May 3 09:51:43 2010 @@ -2337,7 +2337,7 @@ behavior.

There is currently no way of representing a trap value in the IR; they - only exist when produced by instructions such as + only exist when produced by operations such as add with the nsw flag.

Trap value behavior is defined in terms of value dependence:

From gohman at apple.com Mon May 3 09:55:22 2010 From: gohman at apple.com (Dan Gohman) Date: Mon, 03 May 2010 14:55:22 -0000 Subject: [llvm-commits] [llvm] r102909 - /llvm/trunk/docs/LangRef.html Message-ID: <20100503145523.4AD2A312800A@llvm.org> Author: djg Date: Mon May 3 09:55:22 2010 New Revision: 102909 URL: http://llvm.org/viewvc/llvm-project?rev=102909&view=rev Log: Describe invoke instruction dependencies. Generalize the text for terminator instructions so that it applies to all terminators with multiple successors, including invoke. Modified: llvm/trunk/docs/LangRef.html Modified: llvm/trunk/docs/LangRef.html URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/LangRef.html?rev=102909&r1=102908&r2=102909&view=diff ============================================================================== --- llvm/trunk/docs/LangRef.html (original) +++ llvm/trunk/docs/LangRef.html Mon May 3 09:55:22 2010 @@ -2357,6 +2357,11 @@ ret instructions that dynamically transfer control back to them. +
  • Invoke instructions depend on the + ret, unwind, + or exception-throwing call instructions that dynamically transfer control + back to them.
    • +
  • Non-volatile loads and stores depend on the most recent stores to all of the referenced memory addresses, following the order in the IR (including loads and stores implied by intrinsics such as @@ -2374,15 +2379,11 @@ recent preceding instruction with externally visible side effects, following the order in the IR. (This includes volatile loads and stores.)
    • -
  • An instruction control-depends on a br, - switch, or - indirectbr if the br, - switch, or indirectbr has multiple successors and the - instruction is always executed when control transfers to one of the - successors, and may not be executed when control is transfered to - another.
    • - - +
  • An instruction control-depends on a + terminator instruction + if the terminator instruction has multiple successors and the instruction + is always executed when control transfers to one of the successors, and + may not be executed when control is transfered to another.
  • Dependence is transitive.
    • From gohman at apple.com Mon May 3 09:58:14 2010 From: gohman at apple.com (Dan Gohman) Date: Mon, 03 May 2010 14:58:14 -0000 Subject: [llvm-commits] [llvm] r102910 - /llvm/trunk/docs/LangRef.html Message-ID: <20100503145814.A2532312800A@llvm.org> Author: djg Date: Mon May 3 09:58:14 2010 New Revision: 102910 URL: http://llvm.org/viewvc/llvm-project?rev=102910&view=rev Log: Delete this comment. The behavior of struct loads and stores with respect to padding bytes isn't something that the dependence text needs to spell out. Modified: llvm/trunk/docs/LangRef.html Modified: llvm/trunk/docs/LangRef.html URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/LangRef.html?rev=102910&r1=102909&r2=102910&view=diff ============================================================================== --- llvm/trunk/docs/LangRef.html (original) +++ llvm/trunk/docs/LangRef.html Mon May 3 09:58:14 2010 @@ -2367,8 +2367,6 @@ (including loads and stores implied by intrinsics such as @llvm.memcpy.) - - From gohman at apple.com Mon May 3 09:59:34 2010 From: gohman at apple.com (Dan Gohman) Date: Mon, 03 May 2010 14:59:34 -0000 Subject: [llvm-commits] [llvm] r102911 - /llvm/trunk/docs/LangRef.html Message-ID: <20100503145934.D310E312800A@llvm.org> Author: djg Date: Mon May 3 09:59:34 2010 New Revision: 102911 URL: http://llvm.org/viewvc/llvm-project?rev=102911&view=rev Log: Update this comment to note its relationship with the "happens-before" concept in the proposed memory model changes. Modified: llvm/trunk/docs/LangRef.html Modified: llvm/trunk/docs/LangRef.html URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/LangRef.html?rev=102911&r1=102910&r2=102911&view=diff ============================================================================== --- llvm/trunk/docs/LangRef.html (original) +++ llvm/trunk/docs/LangRef.html Mon May 3 09:59:34 2010 @@ -2367,9 +2367,8 @@ (including loads and stores implied by intrinsics such as @llvm.memcpy.) - + From gohman at apple.com Mon May 3 11:35:17 2010 From: gohman at apple.com (Dan Gohman) Date: Mon, 03 May 2010 16:35:17 -0000 Subject: [llvm-commits] [llvm] r102922 - /llvm/trunk/lib/Analysis/ScalarEvolution.cpp Message-ID: <20100503163517.7D047312800A@llvm.org> Author: djg Date: Mon May 3 11:35:17 2010 New Revision: 102922 URL: http://llvm.org/viewvc/llvm-project?rev=102922&view=rev Log: Factor out the new <= and >= analysis code into SimplifyICmpOperands. Modified: llvm/trunk/lib/Analysis/ScalarEvolution.cpp Modified: llvm/trunk/lib/Analysis/ScalarEvolution.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Analysis/ScalarEvolution.cpp?rev=102922&r1=102921&r2=102922&view=diff ============================================================================== --- llvm/trunk/lib/Analysis/ScalarEvolution.cpp (original) +++ llvm/trunk/lib/Analysis/ScalarEvolution.cpp Mon May 3 11:35:17 2010 @@ -3908,6 +3908,9 @@ Cond = ICmpInst::getSwappedPredicate(Cond); } + // Simplify the operands before analyzing them. + (void)SimplifyICmpOperands(Cond, LHS, RHS); + // If we have a comparison of a chrec against a constant, try to use value // ranges to answer this query. if (const SCEVConstant *RHSC = dyn_cast(RHS)) @@ -3921,57 +3924,6 @@ if (!isa(Ret)) return Ret; } - // If possible, canonicalize GE/LE comparisons to GT/LT comparisons, by - // adding or subtracting 1 from one of the operands. - switch (Cond) { - case ICmpInst::ICMP_SLE: - if (!getSignedRange(RHS).getSignedMax().isMaxSignedValue()) { - RHS = getAddExpr(getConstant(RHS->getType(), 1, true), RHS, - /*HasNUW=*/false, /*HasNSW=*/true); - Cond = ICmpInst::ICMP_SLT; - } else if (!getSignedRange(LHS).getSignedMin().isMinSignedValue()) { - LHS = getAddExpr(getConstant(RHS->getType(), (uint64_t)-1, true), LHS, - /*HasNUW=*/false, /*HasNSW=*/true); - Cond = ICmpInst::ICMP_SLT; - } - break; - case ICmpInst::ICMP_SGE: - if (!getSignedRange(RHS).getSignedMin().isMinSignedValue()) { - RHS = getAddExpr(getConstant(RHS->getType(), (uint64_t)-1, true), RHS, - /*HasNUW=*/false, /*HasNSW=*/true); - Cond = ICmpInst::ICMP_SGT; - } else if (!getSignedRange(LHS).getSignedMax().isMaxSignedValue()) { - LHS = getAddExpr(getConstant(RHS->getType(), 1, true), LHS, - /*HasNUW=*/false, /*HasNSW=*/true); - Cond = ICmpInst::ICMP_SGT; - } - break; - case ICmpInst::ICMP_ULE: - if (!getUnsignedRange(RHS).getUnsignedMax().isMaxValue()) { - RHS = getAddExpr(getConstant(RHS->getType(), 1, true), RHS, - /*HasNUW=*/true, /*HasNSW=*/false); - Cond = ICmpInst::ICMP_ULT; - } else if (!getUnsignedRange(LHS).getUnsignedMin().isMinValue()) { - LHS = getAddExpr(getConstant(RHS->getType(), (uint64_t)-1, true), LHS, - /*HasNUW=*/true, /*HasNSW=*/false); - Cond = ICmpInst::ICMP_ULT; - } - break; - case ICmpInst::ICMP_UGE: - if (!getUnsignedRange(RHS).getUnsignedMin().isMinValue()) { - RHS = getAddExpr(getConstant(RHS->getType(), (uint64_t)-1, true), RHS, - /*HasNUW=*/true, /*HasNSW=*/false); - Cond = ICmpInst::ICMP_UGT; - } else if (!getUnsignedRange(LHS).getUnsignedMax().isMaxValue()) { - LHS = getAddExpr(getConstant(RHS->getType(), 1, true), LHS, - /*HasNUW=*/true, /*HasNSW=*/false); - Cond = ICmpInst::ICMP_UGT; - } - break; - default: - break; - } - switch (Cond) { case ICmpInst::ICMP_NE: { // while (X != Y) // Convert to: while (X-Y != 0) @@ -4987,6 +4939,65 @@ goto trivially_false; } + // If possible, canonicalize GE/LE comparisons to GT/LT comparisons, by + // adding or subtracting 1 from one of the operands. + switch (Pred) { + case ICmpInst::ICMP_SLE: + if (!getSignedRange(RHS).getSignedMax().isMaxSignedValue()) { + RHS = getAddExpr(getConstant(RHS->getType(), 1, true), RHS, + /*HasNUW=*/false, /*HasNSW=*/true); + Pred = ICmpInst::ICMP_SLT; + Changed = true; + } else if (!getSignedRange(LHS).getSignedMin().isMinSignedValue()) { + LHS = getAddExpr(getConstant(RHS->getType(), -1, true), LHS, + /*HasNUW=*/false, /*HasNSW=*/true); + Pred = ICmpInst::ICMP_SLT; + Changed = true; + } + break; + case ICmpInst::ICMP_SGE: + if (!getSignedRange(RHS).getSignedMin().isMinSignedValue()) { + RHS = getAddExpr(getConstant(RHS->getType(), -1, true), RHS, + /*HasNUW=*/false, /*HasNSW=*/true); + Pred = ICmpInst::ICMP_SGT; + Changed = true; + } else if (!getSignedRange(LHS).getSignedMax().isMaxSignedValue()) { + LHS = getAddExpr(getConstant(RHS->getType(), 1, true), LHS, + /*HasNUW=*/false, /*HasNSW=*/true); + Pred = ICmpInst::ICMP_SGT; + Changed = true; + } + break; + case ICmpInst::ICMP_ULE: + if (!getUnsignedRange(RHS).getUnsignedMax().isMaxValue()) { + RHS = getAddExpr(getConstant(RHS->getType(), 1, false), RHS, + /*HasNUW=*/true, /*HasNSW=*/false); + Pred = ICmpInst::ICMP_ULT; + Changed = true; + } else if (!getUnsignedRange(LHS).getUnsignedMin().isMinValue()) { + LHS = getAddExpr(getConstant(RHS->getType(), -1, false), LHS, + /*HasNUW=*/true, /*HasNSW=*/false); + Pred = ICmpInst::ICMP_ULT; + Changed = true; + } + break; + case ICmpInst::ICMP_UGE: + if (!getUnsignedRange(RHS).getUnsignedMin().isMinValue()) { + RHS = getAddExpr(getConstant(RHS->getType(), -1, false), RHS, + /*HasNUW=*/true, /*HasNSW=*/false); + Pred = ICmpInst::ICMP_UGT; + Changed = true; + } else if (!getUnsignedRange(LHS).getUnsignedMax().isMaxValue()) { + LHS = getAddExpr(getConstant(RHS->getType(), 1, false), LHS, + /*HasNUW=*/true, /*HasNSW=*/false); + Pred = ICmpInst::ICMP_UGT; + Changed = true; + } + break; + default: + break; + } + // TODO: More simplifications are possible here. return Changed; From gohman at apple.com Mon May 3 12:00:11 2010 From: gohman at apple.com (Dan Gohman) Date: Mon, 03 May 2010 17:00:11 -0000 Subject: [llvm-commits] [llvm] r102924 - /llvm/trunk/lib/Analysis/ScalarEvolution.cpp Message-ID: <20100503170012.07EA6312800A@llvm.org> Author: djg Date: Mon May 3 12:00:11 2010 New Revision: 102924 URL: http://llvm.org/viewvc/llvm-project?rev=102924&view=rev Log: In SimplifyICmpOperands, avoid needlessly swapping the operands in the case where both are addrecs in unrelated loops. Modified: llvm/trunk/lib/Analysis/ScalarEvolution.cpp Modified: llvm/trunk/lib/Analysis/ScalarEvolution.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Analysis/ScalarEvolution.cpp?rev=102924&r1=102923&r2=102924&view=diff ============================================================================== --- llvm/trunk/lib/Analysis/ScalarEvolution.cpp (original) +++ llvm/trunk/lib/Analysis/ScalarEvolution.cpp Mon May 3 12:00:11 2010 @@ -4783,13 +4783,16 @@ } // If we're comparing an addrec with a value which is loop-invariant in the - // addrec's loop, put the addrec on the left. - if (const SCEVAddRecExpr *AR = dyn_cast(RHS)) - if (LHS->isLoopInvariant(AR->getLoop())) { + // addrec's loop, put the addrec on the left. Also make a dominance check, + // as both operands could be addrecs loop-invariant in each other's loop. + if (const SCEVAddRecExpr *AR = dyn_cast(RHS)) { + const Loop *L = AR->getLoop(); + if (LHS->isLoopInvariant(L) && LHS->properlyDominates(L->getHeader(), DT)) { std::swap(LHS, RHS); Pred = ICmpInst::getSwappedPredicate(Pred); Changed = true; } + } // If there's a constant operand, canonicalize comparisons with boundary // cases, and canonicalize *-or-equal comparisons to regular comparisons. From gohman at apple.com Mon May 3 12:03:23 2010 From: gohman at apple.com (Dan Gohman) Date: Mon, 03 May 2010 17:03:23 -0000 Subject: [llvm-commits] [llvm] r102925 - /llvm/trunk/lib/Analysis/ScalarEvolution.cpp Message-ID: <20100503170323.48E6D312800A@llvm.org> Author: djg Date: Mon May 3 12:03:23 2010 New Revision: 102925 URL: http://llvm.org/viewvc/llvm-project?rev=102925&view=rev Log: In ScalarEvolution::print, don't bother printing out the SCEVs for comparison instructions, since they aren't interesting, despite having integer result types. Modified: llvm/trunk/lib/Analysis/ScalarEvolution.cpp Modified: llvm/trunk/lib/Analysis/ScalarEvolution.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Analysis/ScalarEvolution.cpp?rev=102925&r1=102924&r2=102925&view=diff ============================================================================== --- llvm/trunk/lib/Analysis/ScalarEvolution.cpp (original) +++ llvm/trunk/lib/Analysis/ScalarEvolution.cpp Mon May 3 12:03:23 2010 @@ -5767,7 +5767,7 @@ WriteAsOperand(OS, F, /*PrintType=*/false); OS << "\n"; for (inst_iterator I = inst_begin(F), E = inst_end(F); I != E; ++I) - if (isSCEVable(I->getType())) { + if (isSCEVable(I->getType()) && !isa(*I)) { OS << *I << '\n'; OS << " --> "; const SCEV *SV = SE.getSCEV(&*I); From gohman at apple.com Mon May 3 13:00:24 2010 From: gohman at apple.com (Dan Gohman) Date: Mon, 03 May 2010 18:00:24 -0000 Subject: [llvm-commits] [llvm] r102927 - /llvm/trunk/lib/Analysis/ScalarEvolution.cpp Message-ID: <20100503180024.ED44F312800A@llvm.org> Author: djg Date: Mon May 3 13:00:24 2010 New Revision: 102927 URL: http://llvm.org/viewvc/llvm-project?rev=102927&view=rev Log: Use isTrueWhenEqual and isFalseWhenEqual instead of assuming that SimplifyICmpOperands will simplify such cases to EQ or NE. This makes the correcntess of the code independent on SimplifyICmpOperands doing certain simplifications. Modified: llvm/trunk/lib/Analysis/ScalarEvolution.cpp Modified: llvm/trunk/lib/Analysis/ScalarEvolution.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Analysis/ScalarEvolution.cpp?rev=102927&r1=102926&r2=102927&view=diff ============================================================================== --- llvm/trunk/lib/Analysis/ScalarEvolution.cpp (original) +++ llvm/trunk/lib/Analysis/ScalarEvolution.cpp Mon May 3 13:00:24 2010 @@ -5260,10 +5260,10 @@ // canonicalized the comparison. if (SimplifyICmpOperands(Pred, LHS, RHS)) if (LHS == RHS) - return Pred == ICmpInst::ICMP_EQ; + return CmpInst::isTrueWhenEqual(Pred); if (SimplifyICmpOperands(FoundPred, FoundLHS, FoundRHS)) if (FoundLHS == FoundRHS) - return Pred == ICmpInst::ICMP_NE; + return CmpInst::isFalseWhenEqual(Pred); // Check to see if we can make the LHS or RHS match. if (LHS == FoundRHS || RHS == FoundLHS) { From dpatel at apple.com Mon May 3 13:06:58 2010 From: dpatel at apple.com (Devang Patel) Date: Mon, 03 May 2010 18:06:58 -0000 Subject: [llvm-commits] [llvm] r102928 - in /llvm/trunk: lib/Transforms/Scalar/LoopIndexSplit.cpp test/Transforms/LoopIndexSplit/PR4174-2.ll test/Transforms/LoopIndexSplit/PR4174.ll Message-ID: <20100503180658.B5800312800A@llvm.org> Author: dpatel Date: Mon May 3 13:06:58 2010 New Revision: 102928 URL: http://llvm.org/viewvc/llvm-project?rev=102928&view=rev Log: Check for side effects before splitting loop. Patch by Jakub Staszak! Added: llvm/trunk/test/Transforms/LoopIndexSplit/PR4174-2.ll llvm/trunk/test/Transforms/LoopIndexSplit/PR4174.ll Modified: llvm/trunk/lib/Transforms/Scalar/LoopIndexSplit.cpp Modified: llvm/trunk/lib/Transforms/Scalar/LoopIndexSplit.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Transforms/Scalar/LoopIndexSplit.cpp?rev=102928&r1=102927&r2=102928&view=diff ============================================================================== --- llvm/trunk/lib/Transforms/Scalar/LoopIndexSplit.cpp (original) +++ llvm/trunk/lib/Transforms/Scalar/LoopIndexSplit.cpp Mon May 3 13:06:58 2010 @@ -948,6 +948,25 @@ if (!IVBasedValues.count(SplitCondition->getOperand(!SVOpNum))) return false; + // Check for side effects. + for (Loop::block_iterator I = L->block_begin(), E = L->block_end(); + I != E; ++I) { + BasicBlock *BB = *I; + + assert(DT->dominates(Header, BB)); + if (DT->properlyDominates(SplitCondition->getParent(), BB)) + continue; + + for (BasicBlock::iterator BI = BB->begin(), BE = BB->end(); + BI != BE; ++BI) { + Instruction *Inst = BI; + + if (!Inst->isSafeToSpeculativelyExecute() && !isa(Inst) + && !isa(Inst) && !isa(Inst)) + return false; + } + } + // Normalize loop conditions so that it is easier to calculate new loop // bounds. if (IVisGT(*ExitCondition) || IVisGE(*ExitCondition)) { Added: llvm/trunk/test/Transforms/LoopIndexSplit/PR4174-2.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/Transforms/LoopIndexSplit/PR4174-2.ll?rev=102928&view=auto ============================================================================== --- llvm/trunk/test/Transforms/LoopIndexSplit/PR4174-2.ll (added) +++ llvm/trunk/test/Transforms/LoopIndexSplit/PR4174-2.ll Mon May 3 13:06:58 2010 @@ -0,0 +1,38 @@ +; RUN: llvm-as < %s | opt -loop-index-split | llvm-dis | not grep clone + +declare void @f() + +define fastcc i32 @main() nounwind { +entry: + br label %bb1552 + +bb1552: + %j295.0.reg2mem.0 = phi i32 [ %storemerge110, %bb1669 ], [ 0, %entry ] + br label %bb1553 + +bb1553: + call void @f() + %tmp1628 = icmp sgt i32 %j295.0.reg2mem.0, -3 + br i1 %tmp1628, label %bb1588, label %bb1616 + +bb1588: + br label %bb1616 + +bb1616: + %tmp1629 = icmp sgt i32 %j295.0.reg2mem.0, -3 + br i1 %tmp1629, label %bb1649, label %bb1632 + +bb1632: + br label %bb1669 + +bb1649: + br label %bb1669 + +bb1669: + %storemerge110 = add i32 %j295.0.reg2mem.0, 1 + %tmp1672 = icmp sgt i32 %storemerge110, 3 + br i1 %tmp1672, label %bb1678, label %bb1552 + +bb1678: + ret i32 0 +} Added: llvm/trunk/test/Transforms/LoopIndexSplit/PR4174.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/Transforms/LoopIndexSplit/PR4174.ll?rev=102928&view=auto ============================================================================== --- llvm/trunk/test/Transforms/LoopIndexSplit/PR4174.ll (added) +++ llvm/trunk/test/Transforms/LoopIndexSplit/PR4174.ll Mon May 3 13:06:58 2010 @@ -0,0 +1,23 @@ +; RUN: llvm-as < %s | opt -loop-index-split | llvm-dis | not grep clone + +declare void @f() + +define i32 @main() { +entry: + br label %head +head: + %i = phi i32 [0, %entry], [%i1, %tail] + call void @f() + %splitcond = icmp slt i32 %i, 2 + br i1 %splitcond, label %yes, label %no +yes: + br label %tail +no: + br label %tail +tail: + %i1 = add i32 %i, 1 + %exitcond = icmp slt i32 %i1, 4 + br i1 %exitcond, label %head, label %exit +exit: + ret i32 0 +} From daniel at zuster.org Mon May 3 14:08:09 2010 From: daniel at zuster.org (Daniel Dunbar) Date: Mon, 03 May 2010 19:08:09 -0000 Subject: [llvm-commits] [zorg] r102934 - /zorg/trunk/zorg/buildbot/commands/StandardizedTest.py Message-ID: <20100503190809.DBDA5312800A@llvm.org> Author: ddunbar Date: Mon May 3 14:08:09 2010 New Revision: 102934 URL: http://llvm.org/viewvc/llvm-project?rev=102934&view=rev Log: StandardizedTest: Add support for external lists of "flaky" tests, which we just ignore. Modified: zorg/trunk/zorg/buildbot/commands/StandardizedTest.py Modified: zorg/trunk/zorg/buildbot/commands/StandardizedTest.py URL: http://llvm.org/viewvc/llvm-project/zorg/trunk/zorg/buildbot/commands/StandardizedTest.py?rev=102934&r1=102933&r2=102934&view=diff ============================================================================== --- zorg/trunk/zorg/buildbot/commands/StandardizedTest.py (original) +++ zorg/trunk/zorg/buildbot/commands/StandardizedTest.py Mon May 3 14:08:09 2010 @@ -9,20 +9,23 @@ knownCodes = ['FAIL', 'XFAIL', 'PASS', 'XPASS', 'UNRESOLVED', 'UNSUPPORTED'] failingCodes = set(['FAIL', 'XPASS', 'UNRESOLVED']) - warningCodes = set(['IGN PASS', 'IGN XFAIL']) + warningCodes = set(['IGNORE PASS', 'IGNORE XFAIL']) - # The list of all possible codes, including ignored codes. This is the - # display order, as well. - allKnownCodes = knownCodes + ['IGN ' + c for c in knownCodes] + # The list of all possible codes, including flaky and ignored codes. This is + # the display order, as well. + allKnownCodes = (knownCodes + ['IGNORE ' + c for c in knownCodes] + + ['FLAKY ' + c for c in knownCodes]) testLogName = 'stdio' - def __init__(self, ignore=[], max_logs=20, + def __init__(self, ignore=[], flaky=[], max_logs=20, *args, **kwargs): buildbot.steps.shell.Test.__init__(self, *args, **kwargs) + self.flakyTests = set(flaky) self.ignoredTests = set(ignore) self.maxLogs = int(max_logs) + self.addFactoryArguments(flaky=list(flaky)) self.addFactoryArguments(ignore=list(ignore)) self.addFactoryArguments(max_logs=max_logs) @@ -34,13 +37,18 @@ results_by_code = {} logs = [] lines = self.getLog(self.testLogName).readlines() + hasIgnored = False for result,test,log in self.parseLog(lines): if result not in self.knownCodes: raise ValueError,'test command return invalid result code!' - # Convert externally expected failures. - if test in self.ignoredTests: - result = 'IGN ' + result + # Convert codes for flaky and ignored tests. + if test in self.flakyTests: + result = 'FLAKY ' + result + hasIgnored = True + elif test in self.ignoredTests: + result = 'IGNORE ' + result + hasIgnored = True if result not in results_by_code: results_by_code[result] = set() @@ -83,9 +91,10 @@ for test, log in logs: self.addCompleteLog(test, log) - # Always fail if the command itself failed, unless we have ignored - # tests. - if not self.ignoredTests and cmd.rc != 0: + # Always fail if the command itself failed, unless we have ignored some + # test results (which presumably would have caused the actual test + # runner to fail). + if not hasIgnored and cmd.rc != 0: return buildbot.status.builder.FAILURE # Report failure/warnings beased on the test status. From daniel at zuster.org Mon May 3 14:09:01 2010 From: daniel at zuster.org (Daniel Dunbar) Date: Mon, 03 May 2010 19:09:01 -0000 Subject: [llvm-commits] [zorg] r102935 - /zorg/trunk/zorg/buildbot/builders/ChrootSetup.py Message-ID: <20100503190901.418C8312800A@llvm.org> Author: ddunbar Date: Mon May 3 14:09:01 2010 New Revision: 102935 URL: http://llvm.org/viewvc/llvm-project?rev=102935&view=rev Log: buildbot: Add ChrootSetup, a Darwin based builder for setting up a chroot build environment from one or more disk images. Added: zorg/trunk/zorg/buildbot/builders/ChrootSetup.py Added: zorg/trunk/zorg/buildbot/builders/ChrootSetup.py URL: http://llvm.org/viewvc/llvm-project/zorg/trunk/zorg/buildbot/builders/ChrootSetup.py?rev=102935&view=auto ============================================================================== --- zorg/trunk/zorg/buildbot/builders/ChrootSetup.py (added) +++ zorg/trunk/zorg/buildbot/builders/ChrootSetup.py Mon May 3 14:09:01 2010 @@ -0,0 +1,101 @@ +import buildbot +from buildbot.steps.shell import ShellCommand +from buildbot.process.properties import WithProperties + +def addDarwinChrootSetup(f, build_root_images=[], + build_root_name="BuildRoot", clean_build_root=False, + dirs_to_clean=[]): + # Destroy the old build root, if requested. + if clean_build_root: + f.addStep(ShellCommand(name="rm.buildroot", + command=["sudo", "rm", "-rf", build_root_name], + haltOnFailure=False, + description="rm build root", + workdir=".")) + + # Clear out any requested directories. + for i,name in enumerate(dirs_to_clean): + f.addStep(ShellCommand(name="rm.buildroot_dir.%d" % i, + command=["sudo", "rm", "-rf", name], + description=["rm build root",repr(name)], + haltOnFailure=True, + workdir=build_root_name)) + + # Unmount /dev, so we don't try to restore it. + # + # FIXME: This shouldn't fail, except that it might not exist. + f.addStep(ShellCommand(name="chroot.init.umount.devfs", + command=["sudo", "umount", "dev"], + warnOnFailure=True, + flunkOnFailure=False, + haltOnFailure=False, + description="umount devfs", + workdir=build_root_name)) + + # For each image... + for i,image in enumerate(build_root_images): + # Setup the build root we will build projects in. + f.addStep(ShellCommand( + name="attach.buildroot", + command=("hdiutil attach -noverify -plist -mountrandom . %s | " + "tee mount_info.plist") % image, + description="attach build root image", + haltOnFailure=True, + workdir="mounts")) + + mount_point_property = "mount_point.%d" % i + f.addStep(buildbot.steps.shell.SetProperty( + name="get.mount_point.%d" % i, + property=mount_point_property, + command=["python", "-c", """\ +import plistlib +data = plistlib.readPlist(open("mount_info.plist")) +items = [i['mount-point'] for i in data.get('system-entities',[]) + if 'mount-point' in i] +if len(items) != 1: + raise SystemExit,'unable to determine mount point!' +print items[0] +"""], + description="get mount point", + haltOnFailure=True, + workdir="mounts")) + + # Restore the build root. + cmd = ["sudo", "rsync", "-arv"] + if i == 0: + cmd.append("--delete") + cmd.extend([WithProperties("%%(%s)s/" % mount_point_property), "./"]) + f.addStep(ShellCommand( + name="init.buildroot.%d" % i, + command=cmd, + warnOnFailure=True, + flunkOnFailure=False, + haltOnFailure=False, + description="init build root", + workdir=build_root_name)) + + # Unmount the image. + f.addStep(ShellCommand( + name="detach.buildroot.%d" % i, + command=["hdiutil", "detach", + WithProperties("%%(%s)s" % mount_point_property)], + warnOnFailure=True, + flunkOnFailure=False, + haltOnFailure=False, + description="detach build root image", + workdir=".")) + + # Remove the buildroot shared cache. + f.addStep(ShellCommand(name="chroot.init.rm.cache", + command=["sudo", "rm", "-rf", "var/db/dyld"], + haltOnFailure=True, + description="rm chroot shared cache", + workdir=build_root_name)) + + # Initialize /dev/. + f.addStep(ShellCommand(name="chroot.init.mount.devfs", + command=["sudo", "mount", "-t", "devfs", + "devfs", "dev"], + haltOnFailure=True, + description="mount devfs", + workdir=build_root_name)) From daniel at zuster.org Mon May 3 14:09:23 2010 From: daniel at zuster.org (Daniel Dunbar) Date: Mon, 03 May 2010 19:09:23 -0000 Subject: [llvm-commits] [zorg] r102936 - /zorg/trunk/zorg/buildbot/builders/LLVMGCCBuilder.py Message-ID: <20100503190923.F3648312800A@llvm.org> Author: ddunbar Date: Mon May 3 14:09:23 2010 New Revision: 102936 URL: http://llvm.org/viewvc/llvm-project?rev=102936&view=rev Log: buildbot/LLVMGCCBuilder: Add defaultBranch forwarding argument. Modified: zorg/trunk/zorg/buildbot/builders/LLVMGCCBuilder.py Modified: zorg/trunk/zorg/buildbot/builders/LLVMGCCBuilder.py URL: http://llvm.org/viewvc/llvm-project/zorg/trunk/zorg/buildbot/builders/LLVMGCCBuilder.py?rev=102936&r1=102935&r2=102936&view=diff ============================================================================== --- zorg/trunk/zorg/buildbot/builders/LLVMGCCBuilder.py (original) +++ zorg/trunk/zorg/buildbot/builders/LLVMGCCBuilder.py Mon May 3 14:09:23 2010 @@ -13,7 +13,8 @@ triple=None, build=None, host=None, target=None, useTwoStage=True, stage1_config='Release', stage2_config='Release', make='make', - extra_configure_args=[], verbose=False, env = {}): + extra_configure_args=[], verbose=False, env = {}, + defaultBranch='trunk'): if build or host or target: if not build or not host or not target: raise ValueError,"Must specify all of 'build', 'host', 'target' if used." @@ -35,11 +36,11 @@ if update: f.addStep(SVN(name='svn-llvm', mode='update', baseURL='http://llvm.org/svn/llvm-project/llvm/', - defaultBranch='trunk', + defaultBranch=defaultBranch, workdir="llvm.src")) f.addStep(SVN(name='svn-llvm-gcc', mode='update', baseURL='http://llvm.org/svn/llvm-project/llvm-gcc-4.2/', - defaultBranch='trunk', + defaultBranch=defaultBranch, workdir="llvm-gcc.src")) # Clean up llvm (stage 1). From echristo at apple.com Mon May 3 14:54:02 2010 From: echristo at apple.com (Eric Christopher) Date: Mon, 03 May 2010 19:54:02 -0000 Subject: [llvm-commits] [llvm] r102941 - /llvm/trunk/lib/Target/X86/X86TargetMachine.cpp Message-ID: <20100503195402.621A7312800A@llvm.org> Author: echristo Date: Mon May 3 14:54:02 2010 New Revision: 102941 URL: http://llvm.org/viewvc/llvm-project?rev=102941&view=rev Log: Add an option, defaulting to off, to disable the sse domain crossing opts. Modified: llvm/trunk/lib/Target/X86/X86TargetMachine.cpp Modified: llvm/trunk/lib/Target/X86/X86TargetMachine.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Target/X86/X86TargetMachine.cpp?rev=102941&r1=102940&r2=102941&view=diff ============================================================================== --- llvm/trunk/lib/Target/X86/X86TargetMachine.cpp (original) +++ llvm/trunk/lib/Target/X86/X86TargetMachine.cpp Mon May 3 14:54:02 2010 @@ -20,8 +20,14 @@ #include "llvm/Support/FormattedStream.h" #include "llvm/Target/TargetOptions.h" #include "llvm/Target/TargetRegistry.h" +#include "llvm/Support/CommandLine.h" + using namespace llvm; +static cl::opt DisableSSEDomain("disable-sse-domain", + cl::init(false), cl::Hidden, + cl::desc("Disable SSE Domain Fixing")); + static MCAsmInfo *createMCAsmInfo(const Target &T, StringRef TT) { Triple TheTriple(TT); switch (TheTriple.getOS()) { @@ -172,7 +178,8 @@ bool X86TargetMachine::addPreEmitPass(PassManagerBase &PM, CodeGenOpt::Level OptLevel) { - if (OptLevel != CodeGenOpt::None && Subtarget.hasSSE2()) { + if (OptLevel != CodeGenOpt::None && Subtarget.hasSSE2() && + !DisableSSEDomain) { PM.add(createSSEDomainFixPass()); return true; } From gohman at apple.com Mon May 3 15:23:48 2010 From: gohman at apple.com (Dan Gohman) Date: Mon, 03 May 2010 20:23:48 -0000 Subject: [llvm-commits] [llvm] r102946 - /llvm/trunk/lib/Analysis/ScalarEvolution.cpp Message-ID: <20100503202348.1CA79312800A@llvm.org> Author: djg Date: Mon May 3 15:23:47 2010 New Revision: 102946 URL: http://llvm.org/viewvc/llvm-project?rev=102946&view=rev Log: Silence warnings about -1 being converted to an unsigned value. Also, pass true for isSigned even when creating constants for unsigned comparisons, because the point is to create an all-ones constant, rather than UINT64_MAX, even for integers wider than 64 bits. Modified: llvm/trunk/lib/Analysis/ScalarEvolution.cpp Modified: llvm/trunk/lib/Analysis/ScalarEvolution.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Analysis/ScalarEvolution.cpp?rev=102946&r1=102945&r2=102946&view=diff ============================================================================== --- llvm/trunk/lib/Analysis/ScalarEvolution.cpp (original) +++ llvm/trunk/lib/Analysis/ScalarEvolution.cpp Mon May 3 15:23:47 2010 @@ -4952,7 +4952,7 @@ Pred = ICmpInst::ICMP_SLT; Changed = true; } else if (!getSignedRange(LHS).getSignedMin().isMinSignedValue()) { - LHS = getAddExpr(getConstant(RHS->getType(), -1, true), LHS, + LHS = getAddExpr(getConstant(RHS->getType(), (uint64_t)-1, true), LHS, /*HasNUW=*/false, /*HasNSW=*/true); Pred = ICmpInst::ICMP_SLT; Changed = true; @@ -4960,7 +4960,7 @@ break; case ICmpInst::ICMP_SGE: if (!getSignedRange(RHS).getSignedMin().isMinSignedValue()) { - RHS = getAddExpr(getConstant(RHS->getType(), -1, true), RHS, + RHS = getAddExpr(getConstant(RHS->getType(), (uint64_t)-1, true), RHS, /*HasNUW=*/false, /*HasNSW=*/true); Pred = ICmpInst::ICMP_SGT; Changed = true; @@ -4973,12 +4973,12 @@ break; case ICmpInst::ICMP_ULE: if (!getUnsignedRange(RHS).getUnsignedMax().isMaxValue()) { - RHS = getAddExpr(getConstant(RHS->getType(), 1, false), RHS, + RHS = getAddExpr(getConstant(RHS->getType(), 1, true), RHS, /*HasNUW=*/true, /*HasNSW=*/false); Pred = ICmpInst::ICMP_ULT; Changed = true; } else if (!getUnsignedRange(LHS).getUnsignedMin().isMinValue()) { - LHS = getAddExpr(getConstant(RHS->getType(), -1, false), LHS, + LHS = getAddExpr(getConstant(RHS->getType(), (uint64_t)-1, true), LHS, /*HasNUW=*/true, /*HasNSW=*/false); Pred = ICmpInst::ICMP_ULT; Changed = true; @@ -4986,12 +4986,12 @@ break; case ICmpInst::ICMP_UGE: if (!getUnsignedRange(RHS).getUnsignedMin().isMinValue()) { - RHS = getAddExpr(getConstant(RHS->getType(), -1, false), RHS, + RHS = getAddExpr(getConstant(RHS->getType(), (uint64_t)-1, true), RHS, /*HasNUW=*/true, /*HasNSW=*/false); Pred = ICmpInst::ICMP_UGT; Changed = true; } else if (!getUnsignedRange(LHS).getUnsignedMax().isMaxValue()) { - LHS = getAddExpr(getConstant(RHS->getType(), 1, false), LHS, + LHS = getAddExpr(getConstant(RHS->getType(), 1, true), LHS, /*HasNUW=*/true, /*HasNSW=*/false); Pred = ICmpInst::ICMP_UGT; Changed = true; From isanbard at gmail.com Mon May 3 15:39:04 2010 From: isanbard at gmail.com (Bill Wendling) Date: Mon, 03 May 2010 20:39:04 -0000 Subject: [llvm-commits] [llvm-gcc-4.2] r102947 - in /llvm-gcc-4.2/trunk/gcc: llvm-backend.cpp llvm-convert.cpp Message-ID: <20100503203904.9A3C1312800A@llvm.org> Author: void Date: Mon May 3 15:39:04 2010 New Revision: 102947 URL: http://llvm.org/viewvc/llvm-project?rev=102947&view=rev Log: Some things actually do want to follow the ODR'ness flag -- like thunks. When GCC marks something as "one_only", it also marks it as "weak". So make the check of marking something as "non-odr weak" a bit more restrictive. Modified: llvm-gcc-4.2/trunk/gcc/llvm-backend.cpp llvm-gcc-4.2/trunk/gcc/llvm-convert.cpp Modified: llvm-gcc-4.2/trunk/gcc/llvm-backend.cpp URL: http://llvm.org/viewvc/llvm-project/llvm-gcc-4.2/trunk/gcc/llvm-backend.cpp?rev=102947&r1=102946&r2=102947&view=diff ============================================================================== --- llvm-gcc-4.2/trunk/gcc/llvm-backend.cpp (original) +++ llvm-gcc-4.2/trunk/gcc/llvm-backend.cpp Mon May 3 15:39:04 2010 @@ -1379,8 +1379,12 @@ } else if (!TREE_PUBLIC(decl)) { Linkage = GlobalValue::InternalLinkage; } else if (DECL_WEAK(decl)) { - // The user may have explicitly asked for weak linkage - ignore flag_odr. - Linkage = GlobalValue::WeakAnyLinkage; + if (DECL_ONE_ONLY(decl) && + !lookup_attribute("weak", DECL_ATTRIBUTES(decl))) + Linkage = GlobalValue::getWeakLinkage(flag_odr); + else + // The user may have explicitly asked for weak linkage - ignore flag_odr. + Linkage = GlobalValue::WeakAnyLinkage; } else if (DECL_ONE_ONLY(decl)) { Linkage = GlobalValue::getWeakLinkage(flag_odr); } else if (DECL_COMMON(decl) && // DECL_COMMON is only meaningful if no init Modified: llvm-gcc-4.2/trunk/gcc/llvm-convert.cpp URL: http://llvm.org/viewvc/llvm-project/llvm-gcc-4.2/trunk/gcc/llvm-convert.cpp?rev=102947&r1=102946&r2=102947&view=diff ============================================================================== --- llvm-gcc-4.2/trunk/gcc/llvm-convert.cpp (original) +++ llvm-gcc-4.2/trunk/gcc/llvm-convert.cpp Mon May 3 15:39:04 2010 @@ -545,8 +545,12 @@ } else if (DECL_COMDAT(FnDecl)) { Fn->setLinkage(Function::getLinkOnceLinkage(flag_odr)); } else if (DECL_WEAK(FnDecl)) { - // The user may have explicitly asked for weak linkage - ignore flag_odr. - Fn->setLinkage(Function::WeakAnyLinkage); + if (DECL_ONE_ONLY(FnDecl) && + !lookup_attribute("weak", DECL_ATTRIBUTES(FnDecl))) + Fn->setLinkage(Function::getWeakLinkage(flag_odr)); + else + // The user may have explicitly asked for weak linkage - ignore flag_odr. + Fn->setLinkage(Function::WeakAnyLinkage); } else if (DECL_ONE_ONLY(FnDecl)) { Fn->setLinkage(Function::getWeakLinkage(flag_odr)); } From isanbard at gmail.com Mon May 3 15:39:35 2010 From: isanbard at gmail.com (Bill Wendling) Date: Mon, 03 May 2010 20:39:35 -0000 Subject: [llvm-commits] [llvm] r102948 - /llvm/trunk/test/FrontendC++/thunk-weak-odr.cpp Message-ID: <20100503203935.D5F5C312800A@llvm.org> Author: void Date: Mon May 3 15:39:35 2010 New Revision: 102948 URL: http://llvm.org/viewvc/llvm-project?rev=102948&view=rev Log: Testcase for r102947. Added: llvm/trunk/test/FrontendC++/thunk-weak-odr.cpp Added: llvm/trunk/test/FrontendC++/thunk-weak-odr.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/FrontendC%2B%2B/thunk-weak-odr.cpp?rev=102948&view=auto ============================================================================== --- llvm/trunk/test/FrontendC++/thunk-weak-odr.cpp (added) +++ llvm/trunk/test/FrontendC++/thunk-weak-odr.cpp Mon May 3 15:39:35 2010 @@ -0,0 +1,32 @@ +// RUN: %llvmgxx %s -S -emit-llvm -O0 -o - | FileCheck %s +// + +// Thunks should be marked as "ODR". + +struct A { + virtual int f() { return 1; } +}; + +struct B { + virtual int f() { return 2; } +}; + +struct C : A, B { + virtual int f() { return 3; } +}; + +struct D : C { + virtual int f() { return 4; } +}; + +static int f(D* d) { + B* b = d; + return b->f(); +}; + +int g() { + D d; + return f(&d); +} + +// CHECK: define weak_odr {{.*}} @_ZThn8_N1D1fEv From enderby at apple.com Mon May 3 15:45:05 2010 From: enderby at apple.com (Kevin Enderby) Date: Mon, 03 May 2010 20:45:05 -0000 Subject: [llvm-commits] [llvm] r102951 - in /llvm/trunk: lib/Target/X86/X86InstrInfo.td test/MC/AsmParser/X86/x86_32-encoding.s Message-ID: <20100503204505.86CAA312800A@llvm.org> Author: enderby Date: Mon May 3 15:45:05 2010 New Revision: 102951 URL: http://llvm.org/viewvc/llvm-project?rev=102951&view=rev Log: Fixed the encoding of the x86 push instructions. Using a 32-bit immediate value caused the a pushl instruction to be incorrectly encoding using only two bytes of immediate, causing the following 2 instruction bytes to be part of the 32-bit immediate value. Also fixed the one byte form of push to be used when the immediate would fit in a signed extended byte. Lastly changed the names to not include the 32 of PUSH32 since they actually push the size of the stack pointer. Modified: llvm/trunk/lib/Target/X86/X86InstrInfo.td llvm/trunk/test/MC/AsmParser/X86/x86_32-encoding.s Modified: llvm/trunk/lib/Target/X86/X86InstrInfo.td URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Target/X86/X86InstrInfo.td?rev=102951&r1=102950&r2=102951&view=diff ============================================================================== --- llvm/trunk/lib/Target/X86/X86InstrInfo.td (original) +++ llvm/trunk/lib/Target/X86/X86InstrInfo.td Mon May 3 15:45:05 2010 @@ -753,11 +753,11 @@ } let Defs = [ESP], Uses = [ESP], neverHasSideEffects = 1, mayStore = 1 in { -def PUSH32i8 : Ii8<0x6a, RawFrm, (outs), (ins i8imm:$imm), - "push{l}\t$imm", []>; -def PUSH32i16 : Ii16<0x68, RawFrm, (outs), (ins i16imm:$imm), +def PUSHi8 : Ii8<0x6a, RawFrm, (outs), (ins i32i8imm:$imm), "push{l}\t$imm", []>; -def PUSH32i32 : Ii32<0x68, RawFrm, (outs), (ins i32imm:$imm), +def PUSHi16 : Ii16<0x68, RawFrm, (outs), (ins i16imm:$imm), + "push{w}\t$imm", []>, OpSize; +def PUSHi32 : Ii32<0x68, RawFrm, (outs), (ins i32imm:$imm), "push{l}\t$imm", []>; } Modified: llvm/trunk/test/MC/AsmParser/X86/x86_32-encoding.s URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/MC/AsmParser/X86/x86_32-encoding.s?rev=102951&r1=102950&r2=102951&view=diff ============================================================================== --- llvm/trunk/test/MC/AsmParser/X86/x86_32-encoding.s (original) +++ llvm/trunk/test/MC/AsmParser/X86/x86_32-encoding.s Mon May 3 15:45:05 2010 @@ -9984,3 +9984,16 @@ // CHECK: bsrw 305419896, %bx // CHECK: encoding: [0x66,0x0f,0xbd,0x1d,0x78,0x56,0x34,0x12] bsrw 305419896, %bx + +// radr://7901779 +// CHECK: pushl $127 +// CHECK: encoding: [0x6a,0xfe] + pushl $127 + +// CHECK: pushw $254 +// CHECK: encoding: [0x66,0x68,0xfe,0x00] + pushw $254 + +// CHECK: pushl $254 +// CHECK: encoding: [0x68,0xfe,0x00,0x00,0x00] + pushl $254 From enderby at apple.com Mon May 3 16:03:31 2010 From: enderby at apple.com (Kevin Enderby) Date: Mon, 03 May 2010 21:03:31 -0000 Subject: [llvm-commits] [llvm] r102952 - in /llvm/trunk: lib/Target/X86/X86Instr64bit.td lib/Target/X86/X86InstrMMX.td test/MC/AsmParser/X86/x86_32-encoding.s Message-ID: <20100503210331.89655312800A@llvm.org> Author: enderby Date: Mon May 3 16:03:31 2010 New Revision: 102952 URL: http://llvm.org/viewvc/llvm-project?rev=102952&view=rev Log: Fixed the encoding of two of the X86 movq instuctions. The Move quadword from mm to mm/m64 and the Move quadword from xmm2/mem64 to xmm1 had the incorrect encodings. Modified: llvm/trunk/lib/Target/X86/X86Instr64bit.td llvm/trunk/lib/Target/X86/X86InstrMMX.td llvm/trunk/test/MC/AsmParser/X86/x86_32-encoding.s Modified: llvm/trunk/lib/Target/X86/X86Instr64bit.td URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Target/X86/X86Instr64bit.td?rev=102952&r1=102951&r2=102952&view=diff ============================================================================== --- llvm/trunk/lib/Target/X86/X86Instr64bit.td (original) +++ llvm/trunk/lib/Target/X86/X86Instr64bit.td Mon May 3 16:03:31 2010 @@ -2284,7 +2284,7 @@ def MOV64toSDrr : RPDI<0x6E, MRMSrcReg, (outs FR64:$dst), (ins GR64:$src), "mov{d|q}\t{$src, $dst|$dst, $src}", [(set FR64:$dst, (bitconvert GR64:$src))]>; -def MOV64toSDrm : RPDI<0x6E, MRMSrcMem, (outs FR64:$dst), (ins i64mem:$src), +def MOV64toSDrm : S3SI<0x6E, MRMSrcMem, (outs FR64:$dst), (ins i64mem:$src), "movq\t{$src, $dst|$dst, $src}", [(set FR64:$dst, (bitconvert (loadi64 addr:$src)))]>; Modified: llvm/trunk/lib/Target/X86/X86InstrMMX.td URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Target/X86/X86InstrMMX.td?rev=102952&r1=102951&r2=102952&view=diff ============================================================================== --- llvm/trunk/lib/Target/X86/X86InstrMMX.td (original) +++ llvm/trunk/lib/Target/X86/X86InstrMMX.td Mon May 3 16:03:31 2010 @@ -117,7 +117,7 @@ "movd\t{$src, $dst|$dst, $src}", []>; def MMX_MOVD64grr : MMXI<0x7E, MRMDestReg, (outs), (ins GR32:$dst, VR64:$src), "movd\t{$src, $dst|$dst, $src}", []>; -def MMX_MOVQ64gmr : MMXRI<0x7E, MRMDestMem, (outs), +def MMX_MOVQ64gmr : MMXRI<0x7F, MRMDestMem, (outs), (ins i64mem:$dst, VR64:$src), "movq\t{$src, $dst|$dst, $src}", []>; Modified: llvm/trunk/test/MC/AsmParser/X86/x86_32-encoding.s URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/MC/AsmParser/X86/x86_32-encoding.s?rev=102952&r1=102951&r2=102952&view=diff ============================================================================== --- llvm/trunk/test/MC/AsmParser/X86/x86_32-encoding.s (original) +++ llvm/trunk/test/MC/AsmParser/X86/x86_32-encoding.s Mon May 3 16:03:31 2010 @@ -9997,3 +9997,20 @@ // CHECK: pushl $254 // CHECK: encoding: [0x68,0xfe,0x00,0x00,0x00] pushl $254 + +// radr://7928400 +// CHECK: movq %mm3, 3735928559(%ebx,%ecx,8) +// CHECK: encoding: [0x0f,0x7f,0x9c,0xcb,0xef,0xbe,0xad,0xde] + movq %mm3, 3735928559(%ebx,%ecx,8) + +// CHECK: movd %mm3, 3735928559(%ebx,%ecx,8) +// CHECK: encoding: [0x0f,0x7e,0x9c,0xcb,0xef,0xbe,0xad,0xde] + movd %mm3, 3735928559(%ebx,%ecx,8) + +// CHECK: movq 3735928559(%ebx,%ecx,8), %xmm5 +// CHECK: encoding: [0xf3,0x0f,0x7e,0xac,0xcb,0xef,0xbe,0xad,0xde] + movq 3735928559(%ebx,%ecx,8), %xmm5 + +// CHECK: movd 3735928559(%ebx,%ecx,8), %xmm5 +// CHECK: encoding: [0x66,0x0f,0x6e,0xac,0xcb,0xef,0xbe,0xad,0xde] + movd 3735928559(%ebx,%ecx,8), %xmm5 From stuart at apple.com Mon May 3 16:28:37 2010 From: stuart at apple.com (Stuart Hastings) Date: Mon, 03 May 2010 21:28:37 -0000 Subject: [llvm-commits] [llvm-gcc-4.2] r102957 - /llvm-gcc-4.2/trunk/gcc/c-typeck.c Message-ID: <20100503212837.2312E312800A@llvm.org> Author: stuart Date: Mon May 3 16:28:36 2010 New Revision: 102957 URL: http://llvm.org/viewvc/llvm-project?rev=102957&view=rev Log: Diagnose and avoid ICE for 'extern int bar[]; &(&bar)[0] == 0;'. Radar 7216288. Modified: llvm-gcc-4.2/trunk/gcc/c-typeck.c Modified: llvm-gcc-4.2/trunk/gcc/c-typeck.c URL: http://llvm.org/viewvc/llvm-project/llvm-gcc-4.2/trunk/gcc/c-typeck.c?rev=102957&r1=102956&r2=102957&view=diff ============================================================================== --- llvm-gcc-4.2/trunk/gcc/c-typeck.c (original) +++ llvm-gcc-4.2/trunk/gcc/c-typeck.c Mon May 3 16:28:36 2010 @@ -2137,6 +2137,14 @@ || TREE_CODE(ty) == QUAL_UNION_TYPE) ty = TYPE_MAIN_VARIANT (ty); + if (TYPE_SIZE_UNIT (ty) == 0) { + /* We don't know the size of the array elements, so we can't + index it. Invoke the usual GCC routine; it will diagnose + the error and return a tree that won't ICE. */ + return build_indirect_ref (build_binary_op (PLUS_EXPR, ar, index, 0), + "array indexing"); + } + ar = build4 (ARRAY_REF, ty, ar, index, NULL_TREE, NULL_TREE); /* Mirror logic from build_indirect_ref to set TREE_THIS_VOLATILE and * other flags. From enderby at apple.com Mon May 3 16:31:40 2010 From: enderby at apple.com (Kevin Enderby) Date: Mon, 03 May 2010 21:31:40 -0000 Subject: [llvm-commits] [llvm] r102958 - in /llvm/trunk: lib/Target/X86/X86InstrFPStack.td test/MC/AsmParser/X86/x86_32-encoding.s Message-ID: <20100503213140.8F89E312800A@llvm.org> Author: enderby Date: Mon May 3 16:31:40 2010 New Revision: 102958 URL: http://llvm.org/viewvc/llvm-project?rev=102958&view=rev Log: Changed llvm-mc to use the same suffixes with floating point compare instructions as the Mac OS X darwin assembler. Some of which like 'fcoml' assembled to different opcodes. While some of the suffixes were just different. Modified: llvm/trunk/lib/Target/X86/X86InstrFPStack.td llvm/trunk/test/MC/AsmParser/X86/x86_32-encoding.s Modified: llvm/trunk/lib/Target/X86/X86InstrFPStack.td URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Target/X86/X86InstrFPStack.td?rev=102958&r1=102957&r2=102958&view=diff ============================================================================== --- llvm/trunk/lib/Target/X86/X86InstrFPStack.td (original) +++ llvm/trunk/lib/Target/X86/X86InstrFPStack.td Mon May 3 16:31:40 2010 @@ -327,8 +327,8 @@ // Versions of FP instructions that take a single memory operand. Added for the // disassembler; remove as they are included with patterns elsewhere. -def FCOM32m : FPI<0xD8, MRM2m, (outs), (ins f32mem:$src), "fcom{l}\t$src">; -def FCOMP32m : FPI<0xD8, MRM3m, (outs), (ins f32mem:$src), "fcomp{l}\t$src">; +def FCOM32m : FPI<0xD8, MRM2m, (outs), (ins f32mem:$src), "fcom{s}\t$src">; +def FCOMP32m : FPI<0xD8, MRM3m, (outs), (ins f32mem:$src), "fcomp{s}\t$src">; def FLDENVm : FPI<0xD9, MRM4m, (outs), (ins f32mem:$src), "fldenv\t$src">; def FSTENVm : FPI<0xD9, MRM6m, (outs f32mem:$dst), (ins), "fnstenv\t$dst">; @@ -336,15 +336,15 @@ def FICOM32m : FPI<0xDA, MRM2m, (outs), (ins i32mem:$src), "ficom{l}\t$src">; def FICOMP32m: FPI<0xDA, MRM3m, (outs), (ins i32mem:$src), "ficomp{l}\t$src">; -def FCOM64m : FPI<0xDC, MRM2m, (outs), (ins f64mem:$src), "fcom{ll}\t$src">; -def FCOMP64m : FPI<0xDC, MRM3m, (outs), (ins f64mem:$src), "fcomp{ll}\t$src">; +def FCOM64m : FPI<0xDC, MRM2m, (outs), (ins f64mem:$src), "fcom{l}\t$src">; +def FCOMP64m : FPI<0xDC, MRM3m, (outs), (ins f64mem:$src), "fcomp{l}\t$src">; def FRSTORm : FPI<0xDD, MRM4m, (outs f32mem:$dst), (ins), "frstor\t$dst">; def FSAVEm : FPI<0xDD, MRM6m, (outs f32mem:$dst), (ins), "fnsave\t$dst">; def FNSTSWm : FPI<0xDD, MRM7m, (outs f32mem:$dst), (ins), "fnstsw\t$dst">; -def FICOM16m : FPI<0xDE, MRM2m, (outs), (ins i16mem:$src), "ficom{w}\t$src">; -def FICOMP16m: FPI<0xDE, MRM3m, (outs), (ins i16mem:$src), "ficomp{w}\t$src">; +def FICOM16m : FPI<0xDE, MRM2m, (outs), (ins i16mem:$src), "ficom{s}\t$src">; +def FICOMP16m: FPI<0xDE, MRM3m, (outs), (ins i16mem:$src), "ficomp{s}\t$src">; def FBLDm : FPI<0xDF, MRM4m, (outs), (ins f32mem:$src), "fbld\t$src">; def FBSTPm : FPI<0xDF, MRM6m, (outs f32mem:$dst), (ins), "fbstp\t$dst">; Modified: llvm/trunk/test/MC/AsmParser/X86/x86_32-encoding.s URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/MC/AsmParser/X86/x86_32-encoding.s?rev=102958&r1=102957&r2=102958&view=diff ============================================================================== --- llvm/trunk/test/MC/AsmParser/X86/x86_32-encoding.s (original) +++ llvm/trunk/test/MC/AsmParser/X86/x86_32-encoding.s Mon May 3 16:31:40 2010 @@ -10014,3 +10014,36 @@ // CHECK: movd 3735928559(%ebx,%ecx,8), %xmm5 // CHECK: encoding: [0x66,0x0f,0x6e,0xac,0xcb,0xef,0xbe,0xad,0xde] movd 3735928559(%ebx,%ecx,8), %xmm5 + +// radr://7914715 +// CHECK: fcoml 3735928559(%ebx,%ecx,8) +// CHECK: encoding: [0xdc,0x94,0xcb,0xef,0xbe,0xad,0xde] + fcoml 3735928559(%ebx,%ecx,8) + +// CHECK: fcoms 32493 +// CHECK: encoding: [0xd8,0x15,0xed,0x7e,0x00,0x00] + fcoms 32493 + +// CHECK: fcompl 3735928559(%ebx,%ecx,8) +// CHECK: encoding: [0xdc,0x9c,0xcb,0xef,0xbe,0xad,0xde] + fcompl 3735928559(%ebx,%ecx,8) + +// CHECK: fcomps 32493 +// CHECK: encoding: [0xd8,0x1d,0xed,0x7e,0x00,0x00] + fcomps 32493 + +// CHECK: ficoml 3735928559(%ebx,%ecx,8) +// CHECK: encoding: [0xda,0x94,0xcb,0xef,0xbe,0xad,0xde] + ficoml 3735928559(%ebx,%ecx,8) + +// CHECK: ficoms 32493 +// CHECK: encoding: [0xde,0x15,0xed,0x7e,0x00,0x00] + ficoms 32493 + +// CHECK: ficompl 3735928559(%ebx,%ecx,8) +// CHECK: encoding: [0xda,0x9c,0xcb,0xef,0xbe,0xad,0xde] + ficompl 3735928559(%ebx,%ecx,8) + +// CHECK: ficomps 32493 +// CHECK: encoding: [0xde,0x1d,0xed,0x7e,0x00,0x00] + ficomps 32493 From nicholas at mxc.ca Mon May 3 16:36:51 2010 From: nicholas at mxc.ca (Nick Lewycky) Date: Mon, 03 May 2010 21:36:51 -0000 Subject: [llvm-commits] [llvm] r102959 - /llvm/trunk/lib/VMCore/Core.cpp Message-ID: <20100503213651.58862312800A@llvm.org> Author: nicholas Date: Mon May 3 16:36:51 2010 New Revision: 102959 URL: http://llvm.org/viewvc/llvm-project?rev=102959&view=rev Log: Fix function prototype mismatch in LLVMUnionType(). Fixes PR7019. Modified: llvm/trunk/lib/VMCore/Core.cpp Modified: llvm/trunk/lib/VMCore/Core.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/VMCore/Core.cpp?rev=102959&r1=102958&r2=102959&view=diff ============================================================================== --- llvm/trunk/lib/VMCore/Core.cpp (original) +++ llvm/trunk/lib/VMCore/Core.cpp Mon May 3 16:36:51 2010 @@ -327,8 +327,7 @@ return wrap(UnionType::get(&Tys[0], Tys.size())); } -LLVMTypeRef LLVMUnionType(LLVMTypeRef *ElementTypes, - unsigned ElementCount, int Packed) { +LLVMTypeRef LLVMUnionType(LLVMTypeRef *ElementTypes, unsigned ElementCount) { return LLVMUnionTypeInContext(LLVMGetGlobalContext(), ElementTypes, ElementCount); } From bob.wilson at apple.com Mon May 3 16:38:11 2010 From: bob.wilson at apple.com (Bob Wilson) Date: Mon, 03 May 2010 21:38:11 -0000 Subject: [llvm-commits] [llvm] r102960 - /llvm/trunk/lib/CodeGen/LiveIntervalAnalysis.cpp Message-ID: <20100503213811.C096E312800A@llvm.org> Author: bwilson Date: Mon May 3 16:38:11 2010 New Revision: 102960 URL: http://llvm.org/viewvc/llvm-project?rev=102960&view=rev Log: Print basic block numbers in live interval debug output. Since the rest of the debug output is showing machine instructions, the IR-level basic block names aren't very meaningful, and because multiple machine basic blocks may be derived from one IR-level BB, they're also not unique. Modified: llvm/trunk/lib/CodeGen/LiveIntervalAnalysis.cpp Modified: llvm/trunk/lib/CodeGen/LiveIntervalAnalysis.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/CodeGen/LiveIntervalAnalysis.cpp?rev=102960&r1=102959&r2=102960&view=diff ============================================================================== --- llvm/trunk/lib/CodeGen/LiveIntervalAnalysis.cpp (original) +++ llvm/trunk/lib/CodeGen/LiveIntervalAnalysis.cpp Mon May 3 16:38:11 2010 @@ -665,7 +665,8 @@ // Track the index of the current machine instr. SlotIndex MIIndex = getMBBStartIdx(MBB); - DEBUG(dbgs() << MBB->getName() << ":\n"); + DEBUG(dbgs() << "BB#" << MBB->getNumber() + << ":\t\t# derived from " << MBB->getName() << "\n"); // Create intervals for live-ins to this BB first. for (MachineBasicBlock::livein_iterator LI = MBB->livein_begin(), From bob.wilson at apple.com Mon May 3 16:41:24 2010 From: bob.wilson at apple.com (Bob Wilson) Date: Mon, 03 May 2010 21:41:24 -0000 Subject: [llvm-commits] [llvm] r102962 - /llvm/trunk/utils/buildit/build_llvm Message-ID: <20100503214124.C7BD1312800A@llvm.org> Author: bwilson Date: Mon May 3 16:41:24 2010 New Revision: 102962 URL: http://llvm.org/viewvc/llvm-project?rev=102962&view=rev Log: Remove special case for llvmCore_Embedded project. This is no longer needed since llvmCore is built as part of llvmgcc42 now. Modified: llvm/trunk/utils/buildit/build_llvm Modified: llvm/trunk/utils/buildit/build_llvm URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/utils/buildit/build_llvm?rev=102962&r1=102961&r2=102962&view=diff ============================================================================== --- llvm/trunk/utils/buildit/build_llvm (original) +++ llvm/trunk/utils/buildit/build_llvm Mon May 3 16:41:24 2010 @@ -60,11 +60,6 @@ DARWIN_VERS=`uname -r | sed 's/\..*//'` echo DARWIN_VERS = $DARWIN_VERS -if [ "x$RC_ProjectName" = "xllvmCore_Embedded" ]; then - DEST_DIR="$DEST_DIR/Developer/Platforms/iPhoneOS.platform" - mkdir -p "$DEST_DIR" -fi - DEVELOPER_DIR="${DEVELOPER_DIR-Developer}" if [ "x$RC_ProjectName" = "xllvmCore_EmbeddedHosted" ]; then DT_HOME="$DEST_DIR/usr" From isanbard at gmail.com Mon May 3 16:50:55 2010 From: isanbard at gmail.com (Bill Wendling) Date: Mon, 03 May 2010 21:50:55 -0000 Subject: [llvm-commits] [llvm-gcc-4.2] r102963 - in /llvm-gcc-4.2/trunk/gcc: llvm-backend.cpp llvm-convert.cpp Message-ID: <20100503215055.9A7DE312800A@llvm.org> Author: void Date: Mon May 3 16:50:55 2010 New Revision: 102963 URL: http://llvm.org/viewvc/llvm-project?rev=102963&view=rev Log: Revert r102947. Modified: llvm-gcc-4.2/trunk/gcc/llvm-backend.cpp llvm-gcc-4.2/trunk/gcc/llvm-convert.cpp Modified: llvm-gcc-4.2/trunk/gcc/llvm-backend.cpp URL: http://llvm.org/viewvc/llvm-project/llvm-gcc-4.2/trunk/gcc/llvm-backend.cpp?rev=102963&r1=102962&r2=102963&view=diff ============================================================================== --- llvm-gcc-4.2/trunk/gcc/llvm-backend.cpp (original) +++ llvm-gcc-4.2/trunk/gcc/llvm-backend.cpp Mon May 3 16:50:55 2010 @@ -1379,12 +1379,8 @@ } else if (!TREE_PUBLIC(decl)) { Linkage = GlobalValue::InternalLinkage; } else if (DECL_WEAK(decl)) { - if (DECL_ONE_ONLY(decl) && - !lookup_attribute("weak", DECL_ATTRIBUTES(decl))) - Linkage = GlobalValue::getWeakLinkage(flag_odr); - else - // The user may have explicitly asked for weak linkage - ignore flag_odr. - Linkage = GlobalValue::WeakAnyLinkage; + // The user may have explicitly asked for weak linkage - ignore flag_odr. + Linkage = GlobalValue::WeakAnyLinkage; } else if (DECL_ONE_ONLY(decl)) { Linkage = GlobalValue::getWeakLinkage(flag_odr); } else if (DECL_COMMON(decl) && // DECL_COMMON is only meaningful if no init Modified: llvm-gcc-4.2/trunk/gcc/llvm-convert.cpp URL: http://llvm.org/viewvc/llvm-project/llvm-gcc-4.2/trunk/gcc/llvm-convert.cpp?rev=102963&r1=102962&r2=102963&view=diff ============================================================================== --- llvm-gcc-4.2/trunk/gcc/llvm-convert.cpp (original) +++ llvm-gcc-4.2/trunk/gcc/llvm-convert.cpp Mon May 3 16:50:55 2010 @@ -545,12 +545,8 @@ } else if (DECL_COMDAT(FnDecl)) { Fn->setLinkage(Function::getLinkOnceLinkage(flag_odr)); } else if (DECL_WEAK(FnDecl)) { - if (DECL_ONE_ONLY(FnDecl) && - !lookup_attribute("weak", DECL_ATTRIBUTES(FnDecl))) - Fn->setLinkage(Function::getWeakLinkage(flag_odr)); - else - // The user may have explicitly asked for weak linkage - ignore flag_odr. - Fn->setLinkage(Function::WeakAnyLinkage); + // The user may have explicitly asked for weak linkage - ignore flag_odr. + Fn->setLinkage(Function::WeakAnyLinkage); } else if (DECL_ONE_ONLY(FnDecl)) { Fn->setLinkage(Function::getWeakLinkage(flag_odr)); } From isanbard at gmail.com Mon May 3 16:51:21 2010 From: isanbard at gmail.com (Bill Wendling) Date: Mon, 03 May 2010 21:51:21 -0000 Subject: [llvm-commits] [llvm] r102964 - /llvm/trunk/test/FrontendC++/thunk-weak-odr.cpp Message-ID: <20100503215121.317EE312800A@llvm.org> Author: void Date: Mon May 3 16:51:21 2010 New Revision: 102964 URL: http://llvm.org/viewvc/llvm-project?rev=102964&view=rev Log: Revert r102948. Removed: llvm/trunk/test/FrontendC++/thunk-weak-odr.cpp Removed: llvm/trunk/test/FrontendC++/thunk-weak-odr.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/FrontendC%2B%2B/thunk-weak-odr.cpp?rev=102963&view=auto ============================================================================== --- llvm/trunk/test/FrontendC++/thunk-weak-odr.cpp (original) +++ llvm/trunk/test/FrontendC++/thunk-weak-odr.cpp (removed) @@ -1,32 +0,0 @@ -// RUN: %llvmgxx %s -S -emit-llvm -O0 -o - | FileCheck %s -// - -// Thunks should be marked as "ODR". - -struct A { - virtual int f() { return 1; } -}; - -struct B { - virtual int f() { return 2; } -}; - -struct C : A, B { - virtual int f() { return 3; } -}; - -struct D : C { - virtual int f() { return 4; } -}; - -static int f(D* d) { - B* b = d; - return b->f(); -}; - -int g() { - D d; - return f(&d); -} - -// CHECK: define weak_odr {{.*}} @_ZThn8_N1D1fEv From gohman at apple.com Mon May 3 17:09:21 2010 From: gohman at apple.com (Dan Gohman) Date: Mon, 03 May 2010 22:09:21 -0000 Subject: [llvm-commits] [llvm] r102965 - in /llvm/trunk/lib: Analysis/ScalarEvolution.cpp Analysis/ScalarEvolutionExpander.cpp Transforms/Scalar/IndVarSimplify.cpp Transforms/Scalar/LoopStrengthReduce.cpp Message-ID: <20100503220921.D9FC6312800A@llvm.org> Author: djg Date: Mon May 3 17:09:21 2010 New Revision: 102965 URL: http://llvm.org/viewvc/llvm-project?rev=102965&view=rev Log: Use getConstant instead of getIntegerSCEV. The two are basically the same, now that getConstant has overloads consistent with ConstantInt::get. Modified: llvm/trunk/lib/Analysis/ScalarEvolution.cpp llvm/trunk/lib/Analysis/ScalarEvolutionExpander.cpp llvm/trunk/lib/Transforms/Scalar/IndVarSimplify.cpp llvm/trunk/lib/Transforms/Scalar/LoopStrengthReduce.cpp Modified: llvm/trunk/lib/Analysis/ScalarEvolution.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Analysis/ScalarEvolution.cpp?rev=102965&r1=102964&r2=102965&view=diff ============================================================================== --- llvm/trunk/lib/Analysis/ScalarEvolution.cpp (original) +++ llvm/trunk/lib/Analysis/ScalarEvolution.cpp Mon May 3 17:09:21 2010 @@ -761,7 +761,7 @@ CalculationBits); const SCEV *Dividend = SE.getTruncateOrZeroExtend(It, CalculationTy); for (unsigned i = 1; i != K; ++i) { - const SCEV *S = SE.getMinusSCEV(It, SE.getIntegerSCEV(i, It->getType())); + const SCEV *S = SE.getMinusSCEV(It, SE.getConstant(It->getType(), i)); Dividend = SE.getMulExpr(Dividend, SE.getTruncateOrZeroExtend(S, CalculationTy)); } @@ -1326,7 +1326,7 @@ if (Ops[i] == Ops[i+1]) { // X + Y + Y --> X + Y*2 // Found a match, merge the two values into a multiply, and add any // remaining values to the result. - const SCEV *Two = getIntegerSCEV(2, Ty); + const SCEV *Two = getConstant(Ty, 2); const SCEV *Mul = getMulExpr(Ops[i], Two); if (Ops.size() == 2) return Mul; @@ -1443,7 +1443,7 @@ Ops.push_back(getMulExpr(getConstant(I->first), getAddExpr(I->second))); if (Ops.empty()) - return getIntegerSCEV(0, Ty); + return getConstant(Ty, 0); if (Ops.size() == 1) return Ops[0]; return getAddExpr(Ops); @@ -1468,7 +1468,7 @@ MulOps.erase(MulOps.begin()+MulOp); InnerMul = getMulExpr(MulOps); } - const SCEV *One = getIntegerSCEV(1, Ty); + const SCEV *One = getConstant(Ty, 1); const SCEV *AddOne = getAddExpr(InnerMul, One); const SCEV *OuterMul = getMulExpr(AddOne, Ops[AddOp]); if (Ops.size() == 2) return OuterMul; @@ -2778,7 +2778,7 @@ // Don't attempt to analyze GEPs over unsized objects. if (!cast(Base->getType())->getElementType()->isSized()) return getUnknown(GEP); - const SCEV *TotalOffset = getIntegerSCEV(0, IntPtrTy); + const SCEV *TotalOffset = getConstant(IntPtrTy, 0); gep_type_iterator GTI = gep_type_begin(GEP); for (GetElementPtrInst::op_iterator I = next(GEP->op_begin()), E = GEP->op_end(); @@ -3187,7 +3187,7 @@ else if (ConstantInt *CI = dyn_cast(V)) return getConstant(CI); else if (isa(V)) - return getIntegerSCEV(0, V->getType()); + return getConstant(V->getType(), 0); else if (GlobalAlias *GA = dyn_cast(V)) return GA->mayBeOverridden() ? getUnknown(V) : getSCEV(GA->getAliasee()); else @@ -3861,7 +3861,7 @@ return getCouldNotCompute(); else // The backedge is never taken. - return getIntegerSCEV(0, CI->getType()); + return getConstant(CI->getType(), 0); } // If it's not an integer or pointer comparison then compute it the hard way. @@ -4687,7 +4687,7 @@ // already. If so, the backedge will execute zero times. if (const SCEVConstant *C = dyn_cast(V)) { if (!C->getValue()->isNullValue()) - return getIntegerSCEV(0, C->getType()); + return getConstant(C->getType(), 0); return getCouldNotCompute(); // Otherwise it will loop infinitely. } @@ -5374,7 +5374,7 @@ "This code doesn't handle negative strides yet!"); const Type *Ty = Start->getType(); - const SCEV *NegOne = getIntegerSCEV(-1, Ty); + const SCEV *NegOne = getConstant(Ty, (uint64_t)-1); const SCEV *Diff = getMinusSCEV(End, Start); const SCEV *RoundUp = getAddExpr(Step, NegOne); @@ -5430,7 +5430,7 @@ // behavior, so if wrap does occur, the loop could either terminate or // loop infinitely, but in either case, the loop is guaranteed to // iterate at least until the iteration where the wrapping occurs. - const SCEV *One = getIntegerSCEV(1, Step->getType()); + const SCEV *One = getConstant(Step->getType(), 1); if (isSigned) { APInt Max = APInt::getSignedMaxValue(BitWidth); if ((Max - getSignedRange(getMinusSCEV(Step, One)).getSignedMax()) @@ -5481,7 +5481,7 @@ // This allows the subsequent ceiling division of (N+(step-1))/step to // compute the correct value. const SCEV *StepMinusOne = getMinusSCEV(Step, - getIntegerSCEV(1, Step->getType())); + getConstant(Step->getType(), 1)); MaxEnd = isSigned ? getSMinExpr(MaxEnd, getMinusSCEV(getConstant(APInt::getSignedMaxValue(BitWidth)), @@ -5518,7 +5518,7 @@ if (const SCEVConstant *SC = dyn_cast(getStart())) if (!SC->getValue()->isZero()) { SmallVector Operands(op_begin(), op_end()); - Operands[0] = SE.getIntegerSCEV(0, SC->getType()); + Operands[0] = SE.getConstant(SC->getType(), 0); const SCEV *Shifted = SE.getAddRecExpr(Operands, getLoop()); if (const SCEVAddRecExpr *ShiftedAddRec = dyn_cast(Shifted)) @@ -5542,7 +5542,7 @@ // iteration exits. unsigned BitWidth = SE.getTypeSizeInBits(getType()); if (!Range.contains(APInt(BitWidth, 0))) - return SE.getIntegerSCEV(0, getType()); + return SE.getConstant(getType(), 0); if (isAffine()) { // If this is an affine expression then we have this situation: Modified: llvm/trunk/lib/Analysis/ScalarEvolutionExpander.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Analysis/ScalarEvolutionExpander.cpp?rev=102965&r1=102964&r2=102965&view=diff ============================================================================== --- llvm/trunk/lib/Analysis/ScalarEvolutionExpander.cpp (original) +++ llvm/trunk/lib/Analysis/ScalarEvolutionExpander.cpp Mon May 3 17:09:21 2010 @@ -192,7 +192,7 @@ // x/x == 1. if (S == Factor) { - S = SE.getIntegerSCEV(1, S->getType()); + S = SE.getConstant(S->getType(), 1); return true; } @@ -244,7 +244,7 @@ // Mul's operands. If so, we can just remove it. for (unsigned i = 0, e = M->getNumOperands(); i != e; ++i) { const SCEV *SOp = M->getOperand(i); - const SCEV *Remainder = SE.getIntegerSCEV(0, SOp->getType()); + const SCEV *Remainder = SE.getConstant(SOp->getType(), 0); if (FactorOutConstant(SOp, Remainder, Factor, SE, TD) && Remainder->isZero()) { SmallVector NewMulOps(M->op_begin(), M->op_end()); @@ -259,7 +259,7 @@ // In an AddRec, check if both start and step are divisible. if (const SCEVAddRecExpr *A = dyn_cast(S)) { const SCEV *Step = A->getStepRecurrence(SE); - const SCEV *StepRem = SE.getIntegerSCEV(0, Step->getType()); + const SCEV *StepRem = SE.getConstant(Step->getType(), 0); if (!FactorOutConstant(Step, StepRem, Factor, SE, TD)) return false; if (!StepRem->isZero()) @@ -289,7 +289,7 @@ SmallVector AddRecs(Ops.end() - NumAddRecs, Ops.end()); // Let ScalarEvolution sort and simplify the non-addrecs list. const SCEV *Sum = NoAddRecs.empty() ? - SE.getIntegerSCEV(0, Ty) : + SE.getConstant(Ty, 0) : SE.getAddExpr(NoAddRecs); // If it returned an add, use the operands. Otherwise it simplified // the sum into a single value, so just use that. @@ -316,7 +316,7 @@ while (const SCEVAddRecExpr *A = dyn_cast(Ops[i])) { const SCEV *Start = A->getStart(); if (Start->isZero()) break; - const SCEV *Zero = SE.getIntegerSCEV(0, Ty); + const SCEV *Zero = SE.getConstant(Ty, 0); AddRecs.push_back(SE.getAddRecExpr(Zero, A->getStepRecurrence(SE), A->getLoop())); @@ -392,7 +392,7 @@ SmallVector NewOps; for (unsigned i = 0, e = Ops.size(); i != e; ++i) { const SCEV *Op = Ops[i]; - const SCEV *Remainder = SE.getIntegerSCEV(0, Ty); + const SCEV *Remainder = SE.getConstant(Ty, 0); if (FactorOutConstant(Op, Remainder, ElSize, SE, SE.TD)) { // Op now has ElSize factored out. ScaledOps.push_back(Op); @@ -803,7 +803,7 @@ while (const SCEVAddRecExpr *A = dyn_cast(Base)) { Base = A->getStart(); Rest = SE.getAddExpr(Rest, - SE.getAddRecExpr(SE.getIntegerSCEV(0, A->getType()), + SE.getAddRecExpr(SE.getConstant(A->getType(), 0), A->getStepRecurrence(SE), A->getLoop())); } @@ -985,7 +985,7 @@ const SCEV *PostLoopOffset = 0; if (!Start->properlyDominates(L->getHeader(), SE.DT)) { PostLoopOffset = Start; - Start = SE.getIntegerSCEV(0, Normalized->getType()); + Start = SE.getConstant(Normalized->getType(), 0); Normalized = cast(SE.getAddRecExpr(Start, Normalized->getStepRecurrence(SE), @@ -997,7 +997,7 @@ const SCEV *PostLoopScale = 0; if (!Step->dominates(L->getHeader(), SE.DT)) { PostLoopScale = Step; - Step = SE.getIntegerSCEV(1, Normalized->getType()); + Step = SE.getConstant(Normalized->getType(), 1); Normalized = cast(SE.getAddRecExpr(Start, Step, Normalized->getLoop())); @@ -1080,7 +1080,7 @@ // {X,+,F} --> X + {0,+,F} if (!S->getStart()->isZero()) { SmallVector NewOps(S->op_begin(), S->op_end()); - NewOps[0] = SE.getIntegerSCEV(0, Ty); + NewOps[0] = SE.getConstant(Ty, 0); const SCEV *Rest = SE.getAddRecExpr(NewOps, L); // Turn things like ptrtoint+arithmetic+inttoptr into GEP. See the @@ -1108,7 +1108,7 @@ // {0,+,1} --> Insert a canonical induction variable into the loop! if (S->isAffine() && - S->getOperand(1) == SE.getIntegerSCEV(1, Ty)) { + S->getOperand(1) == SE.getConstant(Ty, 1)) { // If there's a canonical IV, just use it. if (CanonicalIV) { assert(Ty == SE.getEffectiveSCEVType(CanonicalIV->getType()) && @@ -1342,8 +1342,8 @@ SCEVExpander::getOrInsertCanonicalInductionVariable(const Loop *L, const Type *Ty) { assert(Ty->isIntegerTy() && "Can only insert integer induction variables!"); - const SCEV *H = SE.getAddRecExpr(SE.getIntegerSCEV(0, Ty), - SE.getIntegerSCEV(1, Ty), L); + const SCEV *H = SE.getAddRecExpr(SE.getConstant(Ty, 0), + SE.getConstant(Ty, 1), L); BasicBlock *SaveInsertBB = Builder.GetInsertBlock(); BasicBlock::iterator SaveInsertPt = Builder.GetInsertPoint(); Value *V = expandCodeFor(H, 0, L->getHeader()->begin()); Modified: llvm/trunk/lib/Transforms/Scalar/IndVarSimplify.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Transforms/Scalar/IndVarSimplify.cpp?rev=102965&r1=102964&r2=102965&view=diff ============================================================================== --- llvm/trunk/lib/Transforms/Scalar/IndVarSimplify.cpp (original) +++ llvm/trunk/lib/Transforms/Scalar/IndVarSimplify.cpp Mon May 3 17:09:21 2010 @@ -144,10 +144,10 @@ ICmpInst *OrigCond = dyn_cast(BI->getCondition()); if (!OrigCond) return 0; const SCEV *R = SE->getSCEV(OrigCond->getOperand(1)); - R = SE->getMinusSCEV(R, SE->getIntegerSCEV(1, R->getType())); + R = SE->getMinusSCEV(R, SE->getConstant(R->getType(), 1)); if (R != BackedgeTakenCount) { const SCEV *L = SE->getSCEV(OrigCond->getOperand(0)); - L = SE->getMinusSCEV(L, SE->getIntegerSCEV(1, L->getType())); + L = SE->getMinusSCEV(L, SE->getConstant(L->getType(), 1)); if (L != BackedgeTakenCount) return 0; } @@ -162,10 +162,10 @@ // Add one to the "backedge-taken" count to get the trip count. // If this addition may overflow, we have to be more pessimistic and // cast the induction variable before doing the add. - const SCEV *Zero = SE->getIntegerSCEV(0, BackedgeTakenCount->getType()); + const SCEV *Zero = SE->getConstant(BackedgeTakenCount->getType(), 0); const SCEV *N = SE->getAddExpr(BackedgeTakenCount, - SE->getIntegerSCEV(1, BackedgeTakenCount->getType())); + SE->getConstant(BackedgeTakenCount->getType(), 1)); if ((isa(N) && !N->isZero()) || SE->isLoopEntryGuardedByCond(L, ICmpInst::ICMP_NE, N, Zero)) { // No overflow. Cast the sum. @@ -175,7 +175,7 @@ RHS = SE->getTruncateOrZeroExtend(BackedgeTakenCount, IndVar->getType()); RHS = SE->getAddExpr(RHS, - SE->getIntegerSCEV(1, IndVar->getType())); + SE->getConstant(IndVar->getType(), 1)); } // The BackedgeTaken expression contains the number of times that the @@ -434,7 +434,7 @@ else { // (i+1) % n --> (i+1)==n?0:(i+1) if i is in [0,n). const SCEV *LessOne = - SE->getMinusSCEV(S, SE->getIntegerSCEV(1, S->getType())); + SE->getMinusSCEV(S, SE->getConstant(S->getType(), 1)); if ((!isSigned || SE->isKnownNonNegative(LessOne)) && SE->isKnownPredicate(isSigned ? ICmpInst::ICMP_SLT : ICmpInst::ICMP_ULT, LessOne, X)) { Modified: llvm/trunk/lib/Transforms/Scalar/LoopStrengthReduce.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Transforms/Scalar/LoopStrengthReduce.cpp?rev=102965&r1=102964&r2=102965&view=diff ============================================================================== --- llvm/trunk/lib/Transforms/Scalar/LoopStrengthReduce.cpp (original) +++ llvm/trunk/lib/Transforms/Scalar/LoopStrengthReduce.cpp Mon May 3 17:09:21 2010 @@ -221,7 +221,7 @@ if (const SCEVAddRecExpr *AR = dyn_cast(S)) if (!AR->getStart()->isZero()) { DoInitialMatch(AR->getStart(), L, Good, Bad, SE, DT); - DoInitialMatch(SE.getAddRecExpr(SE.getIntegerSCEV(0, AR->getType()), + DoInitialMatch(SE.getAddRecExpr(SE.getConstant(AR->getType(), 0), AR->getStepRecurrence(SE), AR->getLoop()), L, Good, Bad, SE, DT); @@ -379,7 +379,7 @@ bool IgnoreSignificantBits = false) { // Handle the trivial case, which works for any SCEV type. if (LHS == RHS) - return SE.getIntegerSCEV(1, LHS->getType()); + return SE.getConstant(LHS->getType(), 1); // Handle x /s -1 as x * -1, to give ScalarEvolution a chance to do some // folding. @@ -454,7 +454,7 @@ static int64_t ExtractImmediate(const SCEV *&S, ScalarEvolution &SE) { if (const SCEVConstant *C = dyn_cast(S)) { if (C->getValue()->getValue().getMinSignedBits() <= 64) { - S = SE.getIntegerSCEV(0, C->getType()); + S = SE.getConstant(C->getType(), 0); return C->getValue()->getSExtValue(); } } else if (const SCEVAddExpr *Add = dyn_cast(S)) { @@ -477,7 +477,7 @@ static GlobalValue *ExtractSymbol(const SCEV *&S, ScalarEvolution &SE) { if (const SCEVUnknown *U = dyn_cast(S)) { if (GlobalValue *GV = dyn_cast(U->getValue())) { - S = SE.getIntegerSCEV(0, GV->getType()); + S = SE.getConstant(GV->getType(), 0); return GV; } } else if (const SCEVAddExpr *Add = dyn_cast(S)) { @@ -1457,7 +1457,7 @@ const SCEV *BackedgeTakenCount = SE.getBackedgeTakenCount(L); if (isa(BackedgeTakenCount)) return Cond; - const SCEV *One = SE.getIntegerSCEV(1, BackedgeTakenCount->getType()); + const SCEV *One = SE.getConstant(BackedgeTakenCount->getType(), 1); // Add one to the backedge-taken count to get the trip count. const SCEV *IterationCount = SE.getAddExpr(BackedgeTakenCount, One); @@ -2032,7 +2032,7 @@ } else if (const SCEVAddRecExpr *AR = dyn_cast(S)) { // Split a non-zero base out of an addrec. if (!AR->getStart()->isZero()) { - CollectSubexprs(SE.getAddRecExpr(SE.getIntegerSCEV(0, AR->getType()), + CollectSubexprs(SE.getAddRecExpr(SE.getConstant(AR->getType(), 0), AR->getStepRecurrence(SE), AR->getLoop()), C, Ops, SE); CollectSubexprs(AR->getStart(), C, Ops, SE); @@ -2178,7 +2178,7 @@ F.AM.BaseOffs = (uint64_t)Base.AM.BaseOffs - *I; if (isLegalUse(F.AM, LU.MinOffset - *I, LU.MaxOffset - *I, LU.Kind, LU.AccessTy, TLI)) { - F.BaseRegs[i] = SE.getAddExpr(G, SE.getIntegerSCEV(*I, G->getType())); + F.BaseRegs[i] = SE.getAddExpr(G, SE.getConstant(G->getType(), *I)); (void)InsertFormula(LU, LUIdx, F); } @@ -2241,7 +2241,7 @@ // Compensate for the use having MinOffset built into it. F.AM.BaseOffs = (uint64_t)F.AM.BaseOffs + Offset - LU.MinOffset; - const SCEV *FactorS = SE.getIntegerSCEV(Factor, IntTy); + const SCEV *FactorS = SE.getConstant(IntTy, Factor); // Check that multiplying with each base register doesn't overflow. for (size_t i = 0, e = F.BaseRegs.size(); i != e; ++i) { @@ -2303,7 +2303,7 @@ for (size_t i = 0, e = Base.BaseRegs.size(); i != e; ++i) if (const SCEVAddRecExpr *AR = dyn_cast(Base.BaseRegs[i])) { - const SCEV *FactorS = SE.getIntegerSCEV(Factor, IntTy); + const SCEV *FactorS = SE.getConstant(IntTy, Factor); if (FactorS->isZero()) continue; // Divide out the factor, ignoring high bits, since we'll be @@ -3033,8 +3033,7 @@ // which is expected to be matched as part of the address. ScaledS = SE.getUnknown(Rewriter.expandCodeFor(ScaledS, 0, IP)); ScaledS = SE.getMulExpr(ScaledS, - SE.getIntegerSCEV(F.AM.Scale, - ScaledS->getType())); + SE.getConstant(ScaledS->getType(), F.AM.Scale)); Ops.push_back(ScaledS); // Flush the operand list to suppress SCEVExpander hoisting. @@ -3075,7 +3074,7 @@ // Emit instructions summing all the operands. const SCEV *FullS = Ops.empty() ? - SE.getIntegerSCEV(0, IntTy) : + SE.getConstant(IntTy, 0) : SE.getAddExpr(Ops); Value *FullV = Rewriter.expandCodeFor(FullS, Ty, IP); From echristo at apple.com Mon May 3 17:18:50 2010 From: echristo at apple.com (Eric Christopher) Date: Mon, 03 May 2010 22:18:50 -0000 Subject: [llvm-commits] [llvm] r102966 - /llvm/trunk/lib/CodeGen/PrologEpilogInserter.cpp Message-ID: <20100503221850.1C70C312800A@llvm.org> Author: echristo Date: Mon May 3 17:18:49 2010 New Revision: 102966 URL: http://llvm.org/viewvc/llvm-project?rev=102966&view=rev Log: Reword a comment slightly. Modified: llvm/trunk/lib/CodeGen/PrologEpilogInserter.cpp Modified: llvm/trunk/lib/CodeGen/PrologEpilogInserter.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/CodeGen/PrologEpilogInserter.cpp?rev=102966&r1=102965&r2=102966&view=diff ============================================================================== --- llvm/trunk/lib/CodeGen/PrologEpilogInserter.cpp (original) +++ llvm/trunk/lib/CodeGen/PrologEpilogInserter.cpp Mon May 3 17:18:49 2010 @@ -510,7 +510,7 @@ // callee saved registers. if (StackGrowsDown) { for (unsigned i = MinCSFrameIndex; i <= MaxCSFrameIndex; ++i) { - // If stack grows down, we need to add size of find the lowest + // If the stack grows down, we need to add the size to find the lowest // address of the object. Offset += MFI->getObjectSize(i); From gohman at apple.com Mon May 3 17:36:47 2010 From: gohman at apple.com (Dan Gohman) Date: Mon, 03 May 2010 22:36:47 -0000 Subject: [llvm-commits] [llvm] r102969 - in /llvm/trunk/test/CodeGen: ARM/vadd.ll ARM/vld2.ll ARM/vld3.ll ARM/vld4.ll ARM/vldlane.ll ARM/vmla.ll ARM/vmls.ll ARM/vmul.ll ARM/vneg.ll ARM/vsub.ll ARM/vtrn.ll ARM/vuzp.ll ARM/vzip.ll X86/2010-01-07-UAMemFeature.ll X86/stack-align.ll Message-ID: <20100503223647.3B3BC312800A@llvm.org> Author: djg Date: Mon May 3 17:36:46 2010 New Revision: 102969 URL: http://llvm.org/viewvc/llvm-project?rev=102969&view=rev Log: Fix tests to use fadd, fsub, and fmul, instead of add, sub, and mul, when the type is floating-point. Modified: llvm/trunk/test/CodeGen/ARM/vadd.ll llvm/trunk/test/CodeGen/ARM/vld2.ll llvm/trunk/test/CodeGen/ARM/vld3.ll llvm/trunk/test/CodeGen/ARM/vld4.ll llvm/trunk/test/CodeGen/ARM/vldlane.ll llvm/trunk/test/CodeGen/ARM/vmla.ll llvm/trunk/test/CodeGen/ARM/vmls.ll llvm/trunk/test/CodeGen/ARM/vmul.ll llvm/trunk/test/CodeGen/ARM/vneg.ll llvm/trunk/test/CodeGen/ARM/vsub.ll llvm/trunk/test/CodeGen/ARM/vtrn.ll llvm/trunk/test/CodeGen/ARM/vuzp.ll llvm/trunk/test/CodeGen/ARM/vzip.ll llvm/trunk/test/CodeGen/X86/2010-01-07-UAMemFeature.ll llvm/trunk/test/CodeGen/X86/stack-align.ll Modified: llvm/trunk/test/CodeGen/ARM/vadd.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/ARM/vadd.ll?rev=102969&r1=102968&r2=102969&view=diff ============================================================================== --- llvm/trunk/test/CodeGen/ARM/vadd.ll (original) +++ llvm/trunk/test/CodeGen/ARM/vadd.ll Mon May 3 17:36:46 2010 @@ -41,7 +41,7 @@ ;CHECK: vadd.f32 %tmp1 = load <2 x float>* %A %tmp2 = load <2 x float>* %B - %tmp3 = add <2 x float> %tmp1, %tmp2 + %tmp3 = fadd <2 x float> %tmp1, %tmp2 ret <2 x float> %tmp3 } @@ -86,7 +86,7 @@ ;CHECK: vadd.f32 %tmp1 = load <4 x float>* %A %tmp2 = load <4 x float>* %B - %tmp3 = add <4 x float> %tmp1, %tmp2 + %tmp3 = fadd <4 x float> %tmp1, %tmp2 ret <4 x float> %tmp3 } Modified: llvm/trunk/test/CodeGen/ARM/vld2.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/ARM/vld2.ll?rev=102969&r1=102968&r2=102969&view=diff ============================================================================== --- llvm/trunk/test/CodeGen/ARM/vld2.ll (original) +++ llvm/trunk/test/CodeGen/ARM/vld2.ll Mon May 3 17:36:46 2010 @@ -50,7 +50,7 @@ %tmp1 = call %struct.__neon_float32x2x2_t @llvm.arm.neon.vld2.v2f32(i8* %tmp0) %tmp2 = extractvalue %struct.__neon_float32x2x2_t %tmp1, 0 %tmp3 = extractvalue %struct.__neon_float32x2x2_t %tmp1, 1 - %tmp4 = add <2 x float> %tmp2, %tmp3 + %tmp4 = fadd <2 x float> %tmp2, %tmp3 ret <2 x float> %tmp4 } @@ -104,7 +104,7 @@ %tmp1 = call %struct.__neon_float32x4x2_t @llvm.arm.neon.vld2.v4f32(i8* %tmp0) %tmp2 = extractvalue %struct.__neon_float32x4x2_t %tmp1, 0 %tmp3 = extractvalue %struct.__neon_float32x4x2_t %tmp1, 1 - %tmp4 = add <4 x float> %tmp2, %tmp3 + %tmp4 = fadd <4 x float> %tmp2, %tmp3 ret <4 x float> %tmp4 } Modified: llvm/trunk/test/CodeGen/ARM/vld3.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/ARM/vld3.ll?rev=102969&r1=102968&r2=102969&view=diff ============================================================================== --- llvm/trunk/test/CodeGen/ARM/vld3.ll (original) +++ llvm/trunk/test/CodeGen/ARM/vld3.ll Mon May 3 17:36:46 2010 @@ -50,7 +50,7 @@ %tmp1 = call %struct.__neon_float32x2x3_t @llvm.arm.neon.vld3.v2f32(i8* %tmp0) %tmp2 = extractvalue %struct.__neon_float32x2x3_t %tmp1, 0 %tmp3 = extractvalue %struct.__neon_float32x2x3_t %tmp1, 2 - %tmp4 = add <2 x float> %tmp2, %tmp3 + %tmp4 = fadd <2 x float> %tmp2, %tmp3 ret <2 x float> %tmp4 } @@ -108,7 +108,7 @@ %tmp1 = call %struct.__neon_float32x4x3_t @llvm.arm.neon.vld3.v4f32(i8* %tmp0) %tmp2 = extractvalue %struct.__neon_float32x4x3_t %tmp1, 0 %tmp3 = extractvalue %struct.__neon_float32x4x3_t %tmp1, 2 - %tmp4 = add <4 x float> %tmp2, %tmp3 + %tmp4 = fadd <4 x float> %tmp2, %tmp3 ret <4 x float> %tmp4 } Modified: llvm/trunk/test/CodeGen/ARM/vld4.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/ARM/vld4.ll?rev=102969&r1=102968&r2=102969&view=diff ============================================================================== --- llvm/trunk/test/CodeGen/ARM/vld4.ll (original) +++ llvm/trunk/test/CodeGen/ARM/vld4.ll Mon May 3 17:36:46 2010 @@ -50,7 +50,7 @@ %tmp1 = call %struct.__neon_float32x2x4_t @llvm.arm.neon.vld4.v2f32(i8* %tmp0) %tmp2 = extractvalue %struct.__neon_float32x2x4_t %tmp1, 0 %tmp3 = extractvalue %struct.__neon_float32x2x4_t %tmp1, 2 - %tmp4 = add <2 x float> %tmp2, %tmp3 + %tmp4 = fadd <2 x float> %tmp2, %tmp3 ret <2 x float> %tmp4 } @@ -108,7 +108,7 @@ %tmp1 = call %struct.__neon_float32x4x4_t @llvm.arm.neon.vld4.v4f32(i8* %tmp0) %tmp2 = extractvalue %struct.__neon_float32x4x4_t %tmp1, 0 %tmp3 = extractvalue %struct.__neon_float32x4x4_t %tmp1, 2 - %tmp4 = add <4 x float> %tmp2, %tmp3 + %tmp4 = fadd <4 x float> %tmp2, %tmp3 ret <4 x float> %tmp4 } Modified: llvm/trunk/test/CodeGen/ARM/vldlane.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/ARM/vldlane.ll?rev=102969&r1=102968&r2=102969&view=diff ============================================================================== --- llvm/trunk/test/CodeGen/ARM/vldlane.ll (original) +++ llvm/trunk/test/CodeGen/ARM/vldlane.ll Mon May 3 17:36:46 2010 @@ -52,7 +52,7 @@ %tmp2 = call %struct.__neon_float32x2x2_t @llvm.arm.neon.vld2lane.v2f32(i8* %tmp0, <2 x float> %tmp1, <2 x float> %tmp1, i32 1) %tmp3 = extractvalue %struct.__neon_float32x2x2_t %tmp2, 0 %tmp4 = extractvalue %struct.__neon_float32x2x2_t %tmp2, 1 - %tmp5 = add <2 x float> %tmp3, %tmp4 + %tmp5 = fadd <2 x float> %tmp3, %tmp4 ret <2 x float> %tmp5 } @@ -88,7 +88,7 @@ %tmp2 = call %struct.__neon_float32x4x2_t @llvm.arm.neon.vld2lane.v4f32(i8* %tmp0, <4 x float> %tmp1, <4 x float> %tmp1, i32 1) %tmp3 = extractvalue %struct.__neon_float32x4x2_t %tmp2, 0 %tmp4 = extractvalue %struct.__neon_float32x4x2_t %tmp2, 1 - %tmp5 = add <4 x float> %tmp3, %tmp4 + %tmp5 = fadd <4 x float> %tmp3, %tmp4 ret <4 x float> %tmp5 } @@ -160,8 +160,8 @@ %tmp3 = extractvalue %struct.__neon_float32x2x3_t %tmp2, 0 %tmp4 = extractvalue %struct.__neon_float32x2x3_t %tmp2, 1 %tmp5 = extractvalue %struct.__neon_float32x2x3_t %tmp2, 2 - %tmp6 = add <2 x float> %tmp3, %tmp4 - %tmp7 = add <2 x float> %tmp5, %tmp6 + %tmp6 = fadd <2 x float> %tmp3, %tmp4 + %tmp7 = fadd <2 x float> %tmp5, %tmp6 ret <2 x float> %tmp7 } @@ -202,8 +202,8 @@ %tmp3 = extractvalue %struct.__neon_float32x4x3_t %tmp2, 0 %tmp4 = extractvalue %struct.__neon_float32x4x3_t %tmp2, 1 %tmp5 = extractvalue %struct.__neon_float32x4x3_t %tmp2, 2 - %tmp6 = add <4 x float> %tmp3, %tmp4 - %tmp7 = add <4 x float> %tmp5, %tmp6 + %tmp6 = fadd <4 x float> %tmp3, %tmp4 + %tmp7 = fadd <4 x float> %tmp5, %tmp6 ret <4 x float> %tmp7 } @@ -282,9 +282,9 @@ %tmp4 = extractvalue %struct.__neon_float32x2x4_t %tmp2, 1 %tmp5 = extractvalue %struct.__neon_float32x2x4_t %tmp2, 2 %tmp6 = extractvalue %struct.__neon_float32x2x4_t %tmp2, 3 - %tmp7 = add <2 x float> %tmp3, %tmp4 - %tmp8 = add <2 x float> %tmp5, %tmp6 - %tmp9 = add <2 x float> %tmp7, %tmp8 + %tmp7 = fadd <2 x float> %tmp3, %tmp4 + %tmp8 = fadd <2 x float> %tmp5, %tmp6 + %tmp9 = fadd <2 x float> %tmp7, %tmp8 ret <2 x float> %tmp9 } @@ -330,9 +330,9 @@ %tmp4 = extractvalue %struct.__neon_float32x4x4_t %tmp2, 1 %tmp5 = extractvalue %struct.__neon_float32x4x4_t %tmp2, 2 %tmp6 = extractvalue %struct.__neon_float32x4x4_t %tmp2, 3 - %tmp7 = add <4 x float> %tmp3, %tmp4 - %tmp8 = add <4 x float> %tmp5, %tmp6 - %tmp9 = add <4 x float> %tmp7, %tmp8 + %tmp7 = fadd <4 x float> %tmp3, %tmp4 + %tmp8 = fadd <4 x float> %tmp5, %tmp6 + %tmp9 = fadd <4 x float> %tmp7, %tmp8 ret <4 x float> %tmp9 } Modified: llvm/trunk/test/CodeGen/ARM/vmla.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/ARM/vmla.ll?rev=102969&r1=102968&r2=102969&view=diff ============================================================================== --- llvm/trunk/test/CodeGen/ARM/vmla.ll (original) +++ llvm/trunk/test/CodeGen/ARM/vmla.ll Mon May 3 17:36:46 2010 @@ -39,8 +39,8 @@ %tmp1 = load <2 x float>* %A %tmp2 = load <2 x float>* %B %tmp3 = load <2 x float>* %C - %tmp4 = mul <2 x float> %tmp2, %tmp3 - %tmp5 = add <2 x float> %tmp1, %tmp4 + %tmp4 = fmul <2 x float> %tmp2, %tmp3 + %tmp5 = fadd <2 x float> %tmp1, %tmp4 ret <2 x float> %tmp5 } @@ -83,8 +83,8 @@ %tmp1 = load <4 x float>* %A %tmp2 = load <4 x float>* %B %tmp3 = load <4 x float>* %C - %tmp4 = mul <4 x float> %tmp2, %tmp3 - %tmp5 = add <4 x float> %tmp1, %tmp4 + %tmp4 = fmul <4 x float> %tmp2, %tmp3 + %tmp5 = fadd <4 x float> %tmp1, %tmp4 ret <4 x float> %tmp5 } Modified: llvm/trunk/test/CodeGen/ARM/vmls.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/ARM/vmls.ll?rev=102969&r1=102968&r2=102969&view=diff ============================================================================== --- llvm/trunk/test/CodeGen/ARM/vmls.ll (original) +++ llvm/trunk/test/CodeGen/ARM/vmls.ll Mon May 3 17:36:46 2010 @@ -39,8 +39,8 @@ %tmp1 = load <2 x float>* %A %tmp2 = load <2 x float>* %B %tmp3 = load <2 x float>* %C - %tmp4 = mul <2 x float> %tmp2, %tmp3 - %tmp5 = sub <2 x float> %tmp1, %tmp4 + %tmp4 = fmul <2 x float> %tmp2, %tmp3 + %tmp5 = fsub <2 x float> %tmp1, %tmp4 ret <2 x float> %tmp5 } @@ -83,8 +83,8 @@ %tmp1 = load <4 x float>* %A %tmp2 = load <4 x float>* %B %tmp3 = load <4 x float>* %C - %tmp4 = mul <4 x float> %tmp2, %tmp3 - %tmp5 = sub <4 x float> %tmp1, %tmp4 + %tmp4 = fmul <4 x float> %tmp2, %tmp3 + %tmp5 = fsub <4 x float> %tmp1, %tmp4 ret <4 x float> %tmp5 } Modified: llvm/trunk/test/CodeGen/ARM/vmul.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/ARM/vmul.ll?rev=102969&r1=102968&r2=102969&view=diff ============================================================================== --- llvm/trunk/test/CodeGen/ARM/vmul.ll (original) +++ llvm/trunk/test/CodeGen/ARM/vmul.ll Mon May 3 17:36:46 2010 @@ -32,7 +32,7 @@ ;CHECK: vmul.f32 %tmp1 = load <2 x float>* %A %tmp2 = load <2 x float>* %B - %tmp3 = mul <2 x float> %tmp1, %tmp2 + %tmp3 = fmul <2 x float> %tmp1, %tmp2 ret <2 x float> %tmp3 } @@ -77,7 +77,7 @@ ;CHECK: vmul.f32 %tmp1 = load <4 x float>* %A %tmp2 = load <4 x float>* %B - %tmp3 = mul <4 x float> %tmp1, %tmp2 + %tmp3 = fmul <4 x float> %tmp1, %tmp2 ret <4 x float> %tmp3 } Modified: llvm/trunk/test/CodeGen/ARM/vneg.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/ARM/vneg.ll?rev=102969&r1=102968&r2=102969&view=diff ============================================================================== --- llvm/trunk/test/CodeGen/ARM/vneg.ll (original) +++ llvm/trunk/test/CodeGen/ARM/vneg.ll Mon May 3 17:36:46 2010 @@ -28,7 +28,7 @@ ;CHECK: vnegf32: ;CHECK: vneg.f32 %tmp1 = load <2 x float>* %A - %tmp2 = sub <2 x float> < float -0.000000e+00, float -0.000000e+00 >, %tmp1 + %tmp2 = fsub <2 x float> < float -0.000000e+00, float -0.000000e+00 >, %tmp1 ret <2 x float> %tmp2 } @@ -60,7 +60,7 @@ ;CHECK: vnegQf32: ;CHECK: vneg.f32 %tmp1 = load <4 x float>* %A - %tmp2 = sub <4 x float> < float -0.000000e+00, float -0.000000e+00, float -0.000000e+00, float -0.000000e+00 >, %tmp1 + %tmp2 = fsub <4 x float> < float -0.000000e+00, float -0.000000e+00, float -0.000000e+00, float -0.000000e+00 >, %tmp1 ret <4 x float> %tmp2 } Modified: llvm/trunk/test/CodeGen/ARM/vsub.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/ARM/vsub.ll?rev=102969&r1=102968&r2=102969&view=diff ============================================================================== --- llvm/trunk/test/CodeGen/ARM/vsub.ll (original) +++ llvm/trunk/test/CodeGen/ARM/vsub.ll Mon May 3 17:36:46 2010 @@ -41,7 +41,7 @@ ;CHECK: vsub.f32 %tmp1 = load <2 x float>* %A %tmp2 = load <2 x float>* %B - %tmp3 = sub <2 x float> %tmp1, %tmp2 + %tmp3 = fsub <2 x float> %tmp1, %tmp2 ret <2 x float> %tmp3 } @@ -86,7 +86,7 @@ ;CHECK: vsub.f32 %tmp1 = load <4 x float>* %A %tmp2 = load <4 x float>* %B - %tmp3 = sub <4 x float> %tmp1, %tmp2 + %tmp3 = fsub <4 x float> %tmp1, %tmp2 ret <4 x float> %tmp3 } Modified: llvm/trunk/test/CodeGen/ARM/vtrn.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/ARM/vtrn.ll?rev=102969&r1=102968&r2=102969&view=diff ============================================================================== --- llvm/trunk/test/CodeGen/ARM/vtrn.ll (original) +++ llvm/trunk/test/CodeGen/ARM/vtrn.ll Mon May 3 17:36:46 2010 @@ -44,7 +44,7 @@ %tmp2 = load <2 x float>* %B %tmp3 = shufflevector <2 x float> %tmp1, <2 x float> %tmp2, <2 x i32> %tmp4 = shufflevector <2 x float> %tmp1, <2 x float> %tmp2, <2 x i32> - %tmp5 = add <2 x float> %tmp3, %tmp4 + %tmp5 = fadd <2 x float> %tmp3, %tmp4 ret <2 x float> %tmp5 } @@ -92,6 +92,6 @@ %tmp2 = load <4 x float>* %B %tmp3 = shufflevector <4 x float> %tmp1, <4 x float> %tmp2, <4 x i32> %tmp4 = shufflevector <4 x float> %tmp1, <4 x float> %tmp2, <4 x i32> - %tmp5 = add <4 x float> %tmp3, %tmp4 + %tmp5 = fadd <4 x float> %tmp3, %tmp4 ret <4 x float> %tmp5 } Modified: llvm/trunk/test/CodeGen/ARM/vuzp.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/ARM/vuzp.ll?rev=102969&r1=102968&r2=102969&view=diff ============================================================================== --- llvm/trunk/test/CodeGen/ARM/vuzp.ll (original) +++ llvm/trunk/test/CodeGen/ARM/vuzp.ll Mon May 3 17:36:46 2010 @@ -70,6 +70,6 @@ %tmp2 = load <4 x float>* %B %tmp3 = shufflevector <4 x float> %tmp1, <4 x float> %tmp2, <4 x i32> %tmp4 = shufflevector <4 x float> %tmp1, <4 x float> %tmp2, <4 x i32> - %tmp5 = add <4 x float> %tmp3, %tmp4 + %tmp5 = fadd <4 x float> %tmp3, %tmp4 ret <4 x float> %tmp5 } Modified: llvm/trunk/test/CodeGen/ARM/vzip.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/ARM/vzip.ll?rev=102969&r1=102968&r2=102969&view=diff ============================================================================== --- llvm/trunk/test/CodeGen/ARM/vzip.ll (original) +++ llvm/trunk/test/CodeGen/ARM/vzip.ll Mon May 3 17:36:46 2010 @@ -70,6 +70,6 @@ %tmp2 = load <4 x float>* %B %tmp3 = shufflevector <4 x float> %tmp1, <4 x float> %tmp2, <4 x i32> %tmp4 = shufflevector <4 x float> %tmp1, <4 x float> %tmp2, <4 x i32> - %tmp5 = add <4 x float> %tmp3, %tmp4 + %tmp5 = fadd <4 x float> %tmp3, %tmp4 ret <4 x float> %tmp5 } Modified: llvm/trunk/test/CodeGen/X86/2010-01-07-UAMemFeature.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/X86/2010-01-07-UAMemFeature.ll?rev=102969&r1=102968&r2=102969&view=diff ============================================================================== --- llvm/trunk/test/CodeGen/X86/2010-01-07-UAMemFeature.ll (original) +++ llvm/trunk/test/CodeGen/X86/2010-01-07-UAMemFeature.ll Mon May 3 17:36:46 2010 @@ -6,6 +6,6 @@ define <4 x float> @foo(<4 x float>* %P, <4 x float> %In) nounwind { %A = load <4 x float>* %P, align 4 - %B = add <4 x float> %A, %In + %B = fadd <4 x float> %A, %In ret <4 x float> %B } Modified: llvm/trunk/test/CodeGen/X86/stack-align.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/X86/stack-align.ll?rev=102969&r1=102968&r2=102969&view=diff ============================================================================== --- llvm/trunk/test/CodeGen/X86/stack-align.ll (original) +++ llvm/trunk/test/CodeGen/X86/stack-align.ll Mon May 3 17:36:46 2010 @@ -31,7 +31,7 @@ entry: ; CHECK: andl{{.*}}$-32, %esp call void @test2() - %A = mul <2 x double> %x, %y + %A = fmul <2 x double> %x, %y ret <2 x double> %A } From stoklund at 2pi.dk Mon May 3 17:40:32 2010 From: stoklund at 2pi.dk (Jakob Stoklund Olesen) Date: Mon, 03 May 2010 22:40:32 -0000 Subject: [llvm-commits] [llvm] r102970 - in /llvm/trunk: lib/CodeGen/SimpleRegisterCoalescing.cpp test/CodeGen/X86/2010-05-03-CoalescerSubRegClobber.ll Message-ID: <20100503224032.B03EF312800A@llvm.org> Author: stoklund Date: Mon May 3 17:40:32 2010 New Revision: 102970 URL: http://llvm.org/viewvc/llvm-project?rev=102970&view=rev Log: Check that subregisters don't have independent values in RemoveCopyByCommutingDef(). This fixes PR6941. Added: llvm/trunk/test/CodeGen/X86/2010-05-03-CoalescerSubRegClobber.ll Modified: llvm/trunk/lib/CodeGen/SimpleRegisterCoalescing.cpp Modified: llvm/trunk/lib/CodeGen/SimpleRegisterCoalescing.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/CodeGen/SimpleRegisterCoalescing.cpp?rev=102970&r1=102969&r2=102970&view=diff ============================================================================== --- llvm/trunk/lib/CodeGen/SimpleRegisterCoalescing.cpp (original) +++ llvm/trunk/lib/CodeGen/SimpleRegisterCoalescing.cpp Mon May 3 17:40:32 2010 @@ -259,6 +259,9 @@ for (; BI != IntB.ranges.end() && AI->end >= BI->start; ++BI) { if (BI->valno == BValNo) continue; + // When BValNo is null, we're looking for a dummy clobber-value for a subreg. + if (!BValNo && !BI->valno->isDefAccurate() && !BI->valno->getCopy()) + continue; if (BI->start <= AI->start && BI->end > AI->start) return true; if (BI->start > AI->start && BI->start < AI->end) @@ -369,6 +372,17 @@ if (HasOtherReachingDefs(IntA, IntB, AValNo, BValNo)) return false; + bool BHasSubRegs = false; + if (TargetRegisterInfo::isPhysicalRegister(IntB.reg)) + BHasSubRegs = *tri_->getSubRegisters(IntB.reg); + + // Abort if the subregisters of IntB.reg have values that are not simply the + // clobbers from the superreg. + if (BHasSubRegs) + for (const unsigned *SR = tri_->getSubRegisters(IntB.reg); *SR; ++SR) + if (HasOtherReachingDefs(IntA, li_->getInterval(*SR), AValNo, 0)) + return false; + // If some of the uses of IntA.reg is already coalesced away, return false. // It's not possible to determine whether it's safe to perform the coalescing. for (MachineRegisterInfo::use_nodbg_iterator UI = @@ -417,9 +431,6 @@ BExtend[ALR->end] = BLR->end; // Update uses of IntA of the specific Val# with IntB. - bool BHasSubRegs = false; - if (TargetRegisterInfo::isPhysicalRegister(IntB.reg)) - BHasSubRegs = *tri_->getSubRegisters(IntB.reg); for (MachineRegisterInfo::use_iterator UI = mri_->use_begin(IntA.reg), UE = mri_->use_end(); UI != UE;) { MachineOperand &UseMO = UI.getOperand(); Added: llvm/trunk/test/CodeGen/X86/2010-05-03-CoalescerSubRegClobber.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/X86/2010-05-03-CoalescerSubRegClobber.ll?rev=102970&view=auto ============================================================================== --- llvm/trunk/test/CodeGen/X86/2010-05-03-CoalescerSubRegClobber.ll (added) +++ llvm/trunk/test/CodeGen/X86/2010-05-03-CoalescerSubRegClobber.ll Mon May 3 17:40:32 2010 @@ -0,0 +1,33 @@ +; RUN: llc < %s | FileCheck %s +; PR6941 +target datalayout = "e-p:64:64:64-i1:8:8-i8:8:8-i16:16:16-i32:32:32-i64:64:64-f32:32:32-f64:64:64-v64:64:64-v128:128:128-a0:0:64-s0:64:64-f80:128:128-n8:16:32:64" +target triple = "x86_64-apple-darwin10.0.0" + +define i32 @snd_xbytes(i32 %v, i32 %from, i32 %to) nounwind readnone ssp { +entry: + %cmp19 = icmp eq i32 %to, 0 ; [#uses=1] + br i1 %cmp19, label %while.end, label %while.cond + +while.cond: ; preds = %entry, %while.cond + %y.021 = phi i32 [ %rem, %while.cond ], [ %to, %entry ] ; [#uses=3] + %x.020 = phi i32 [ %y.021, %while.cond ], [ %from, %entry ] ; [#uses=1] + %rem = urem i32 %x.020, %y.021 ; [#uses=2] + %cmp = icmp eq i32 %rem, 0 ; [#uses=1] + br i1 %cmp, label %while.end, label %while.cond + +while.end: ; preds = %while.cond, %entry + %x.0.lcssa = phi i32 [ %from, %entry ], [ %y.021, %while.cond ] ; [#uses=2] + %div = udiv i32 %from, %x.0.lcssa ; [#uses=1] + %div11 = udiv i32 %to, %x.0.lcssa ; [#uses=1] + %conv = zext i32 %v to i64 ; [#uses=1] + %conv14 = zext i32 %div11 to i64 ; [#uses=1] +; Verify that we don't clobber %eax after putting the imulq result in %rax +; CHECK: imulq %r{{.}}x, %r[[RES:.]]x +; CHECK-NOT: movl {{.*}}, %e[[RES]]x +; CHECK: div + %mul = mul i64 %conv14, %conv ; [#uses=1] + %conv16 = zext i32 %div to i64 ; [#uses=1] + %div17 = udiv i64 %mul, %conv16 ; [#uses=1] + %conv18 = trunc i64 %div17 to i32 ; [#uses=1] + ret i32 %conv18 +} From gohman at apple.com Mon May 3 17:44:19 2010 From: gohman at apple.com (Dan Gohman) Date: Mon, 03 May 2010 22:44:19 -0000 Subject: [llvm-commits] [llvm] r102971 - in /llvm/trunk/lib: AsmParser/LLParser.cpp VMCore/Constants.cpp VMCore/Instructions.cpp Message-ID: <20100503224419.E5068312800A@llvm.org> Author: djg Date: Mon May 3 17:44:19 2010 New Revision: 102971 URL: http://llvm.org/viewvc/llvm-project?rev=102971&view=rev Log: Remove the API compatibility layer which converted add, sub, and mul to fadd, fsub, and fmul, when used with a floating-point type. LLVM has supported the new instructions since 2.6, so it's time to get on board. Modified: llvm/trunk/lib/AsmParser/LLParser.cpp llvm/trunk/lib/VMCore/Constants.cpp llvm/trunk/lib/VMCore/Instructions.cpp Modified: llvm/trunk/lib/AsmParser/LLParser.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/AsmParser/LLParser.cpp?rev=102971&r1=102970&r2=102971&view=diff ============================================================================== --- llvm/trunk/lib/AsmParser/LLParser.cpp (original) +++ llvm/trunk/lib/AsmParser/LLParser.cpp Mon May 3 17:44:19 2010 @@ -2351,11 +2351,28 @@ if (NSW) return Error(ModifierLoc, "nsw only applies to integer operations"); } - // API compatibility: Accept either integer or floating-point types with - // add, sub, and mul. - if (!Val0->getType()->isIntOrIntVectorTy() && - !Val0->getType()->isFPOrFPVectorTy()) - return Error(ID.Loc,"constexpr requires integer, fp, or vector operands"); + // Check that the type is valid for the operator. + switch (Opc) { + case Instruction::Add: + case Instruction::Sub: + case Instruction::Mul: + case Instruction::UDiv: + case Instruction::SDiv: + case Instruction::URem: + case Instruction::SRem: + if (!Val0->getType()->isIntOrIntVectorTy()) + return Error(ID.Loc, "constexpr requires integer operands"); + break; + case Instruction::FAdd: + case Instruction::FSub: + case Instruction::FMul: + case Instruction::FDiv: + case Instruction::FRem: + if (!Val0->getType()->isFPOrFPVectorTy()) + return Error(ID.Loc, "constexpr requires fp operands"); + break; + default: llvm_unreachable("Unknown binary operator!"); + } unsigned Flags = 0; if (NUW) Flags |= OverflowingBinaryOperator::NoUnsignedWrap; if (NSW) Flags |= OverflowingBinaryOperator::NoSignedWrap; @@ -3000,8 +3017,7 @@ if (EatIfPresent(lltok::kw_nuw)) NUW = true; } - // API compatibility: Accept either integer or floating-point types. - bool Result = ParseArithmetic(Inst, PFS, KeywordVal, 0); + bool Result = ParseArithmetic(Inst, PFS, KeywordVal, 1); if (!Result) { if (!Inst->getType()->isIntOrIntVectorTy()) { if (NUW) Modified: llvm/trunk/lib/VMCore/Constants.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/VMCore/Constants.cpp?rev=102971&r1=102970&r2=102971&view=diff ============================================================================== --- llvm/trunk/lib/VMCore/Constants.cpp (original) +++ llvm/trunk/lib/VMCore/Constants.cpp Mon May 3 17:44:19 2010 @@ -1450,12 +1450,6 @@ Constant *ConstantExpr::get(unsigned Opcode, Constant *C1, Constant *C2, unsigned Flags) { - // API compatibility: Adjust integer opcodes to floating-point opcodes. - if (C1->getType()->isFPOrFPVectorTy()) { - if (Opcode == Instruction::Add) Opcode = Instruction::FAdd; - else if (Opcode == Instruction::Sub) Opcode = Instruction::FSub; - else if (Opcode == Instruction::Mul) Opcode = Instruction::FMul; - } #ifndef NDEBUG switch (Opcode) { case Instruction::Add: @@ -1840,9 +1834,6 @@ } Constant* ConstantExpr::getNeg(Constant* C) { - // API compatibility: Adjust integer opcodes to floating-point opcodes. - if (C->getType()->isFPOrFPVectorTy()) - return getFNeg(C); assert(C->getType()->isIntOrIntVectorTy() && "Cannot NEG a nonintegral value!"); return get(Instruction::Sub, Modified: llvm/trunk/lib/VMCore/Instructions.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/VMCore/Instructions.cpp?rev=102971&r1=102970&r2=102971&view=diff ============================================================================== --- llvm/trunk/lib/VMCore/Instructions.cpp (original) +++ llvm/trunk/lib/VMCore/Instructions.cpp Mon May 3 17:44:19 2010 @@ -1562,43 +1562,29 @@ // BinaryOperator Class //===----------------------------------------------------------------------===// -/// AdjustIType - Map Add, Sub, and Mul to FAdd, FSub, and FMul when the -/// type is floating-point, to help provide compatibility with an older API. -/// -static BinaryOperator::BinaryOps AdjustIType(BinaryOperator::BinaryOps iType, - const Type *Ty) { - // API compatibility: Adjust integer opcodes to floating-point opcodes. - if (Ty->isFPOrFPVectorTy()) { - if (iType == BinaryOperator::Add) iType = BinaryOperator::FAdd; - else if (iType == BinaryOperator::Sub) iType = BinaryOperator::FSub; - else if (iType == BinaryOperator::Mul) iType = BinaryOperator::FMul; - } - return iType; -} - BinaryOperator::BinaryOperator(BinaryOps iType, Value *S1, Value *S2, const Type *Ty, const Twine &Name, Instruction *InsertBefore) - : Instruction(Ty, AdjustIType(iType, Ty), + : Instruction(Ty, iType, OperandTraits::op_begin(this), OperandTraits::operands(this), InsertBefore) { Op<0>() = S1; Op<1>() = S2; - init(AdjustIType(iType, Ty)); + init(iType); setName(Name); } BinaryOperator::BinaryOperator(BinaryOps iType, Value *S1, Value *S2, const Type *Ty, const Twine &Name, BasicBlock *InsertAtEnd) - : Instruction(Ty, AdjustIType(iType, Ty), + : Instruction(Ty, iType, OperandTraits::op_begin(this), OperandTraits::operands(this), InsertAtEnd) { Op<0>() = S1; Op<1>() = S2; - init(AdjustIType(iType, Ty)); + init(iType); setName(Name); } From dalej at apple.com Mon May 3 17:59:34 2010 From: dalej at apple.com (Dale Johannesen) Date: Mon, 03 May 2010 22:59:34 -0000 Subject: [llvm-commits] [llvm] r102972 - in /llvm/trunk: lib/Target/PowerPC/PPCISelLowering.cpp test/CodeGen/PowerPC/2010-05-03-retaddr1.ll Message-ID: <20100503225935.163F5312800A@llvm.org> Author: johannes Date: Mon May 3 17:59:34 2010 New Revision: 102972 URL: http://llvm.org/viewvc/llvm-project?rev=102972&view=rev Log: Implement builtin_return_address(x) and builtin_frame_address(x) on PPC for x!=0. 7624113. Added: llvm/trunk/test/CodeGen/PowerPC/2010-05-03-retaddr1.ll Modified: llvm/trunk/lib/Target/PowerPC/PPCISelLowering.cpp Modified: llvm/trunk/lib/Target/PowerPC/PPCISelLowering.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Target/PowerPC/PPCISelLowering.cpp?rev=102972&r1=102971&r2=102972&view=diff ============================================================================== --- llvm/trunk/lib/Target/PowerPC/PPCISelLowering.cpp (original) +++ llvm/trunk/lib/Target/PowerPC/PPCISelLowering.cpp Mon May 3 17:59:34 2010 @@ -4298,7 +4298,7 @@ // Create a stack slot that is 16-byte aligned. MachineFrameInfo *FrameInfo = DAG.getMachineFunction().getFrameInfo(); int FrameIdx = FrameInfo->CreateStackObject(16, 16, false); - EVT PtrVT = DAG.getTargetLoweringInfo().getPointerTy(); + EVT PtrVT = getPointerTy(); SDValue FIdx = DAG.getFrameIndex(FrameIdx, PtrVT); // Store the input value into Value#0 of the stack slot. @@ -5497,45 +5497,56 @@ SDValue PPCTargetLowering::LowerRETURNADDR(SDValue Op, SelectionDAG &DAG) const { DebugLoc dl = Op.getDebugLoc(); - // Depths > 0 not supported yet! - if (cast(Op.getOperand(0))->getZExtValue() > 0) - return SDValue(); + unsigned Depth = cast(Op.getOperand(0))->getZExtValue(); + // Make sure the function does not optimize away the store of the RA to + // the stack. MachineFunction &MF = DAG.getMachineFunction(); PPCFunctionInfo *FuncInfo = MF.getInfo(); + FuncInfo->setLRStoreRequired(); + bool isPPC64 = PPCSubTarget.isPPC64(); + bool isDarwinABI = PPCSubTarget.isDarwinABI(); + + if (Depth > 0) { + SDValue FrameAddr = LowerFRAMEADDR(Op, DAG); + SDValue Offset = + + DAG.getConstant(PPCFrameInfo::getReturnSaveOffset(isPPC64, isDarwinABI), + isPPC64? MVT::i64 : MVT::i32); + return DAG.getLoad(getPointerTy(), dl, DAG.getEntryNode(), + DAG.getNode(ISD::ADD, dl, getPointerTy(), + FrameAddr, Offset), + NULL, 0, false, false, 0); + } // Just load the return address off the stack. SDValue RetAddrFI = getReturnAddrFrameIndex(DAG); - - // Make sure the function really does not optimize away the store of the RA - // to the stack. - FuncInfo->setLRStoreRequired(); - return DAG.getLoad(getPointerTy(), dl, - DAG.getEntryNode(), RetAddrFI, NULL, 0, - false, false, 0); + return DAG.getLoad(getPointerTy(), dl, DAG.getEntryNode(), + RetAddrFI, NULL, 0, false, false, 0); } SDValue PPCTargetLowering::LowerFRAMEADDR(SDValue Op, SelectionDAG &DAG) const { DebugLoc dl = Op.getDebugLoc(); - // Depths > 0 not supported yet! - if (cast(Op.getOperand(0))->getZExtValue() > 0) - return SDValue(); + unsigned Depth = cast(Op.getOperand(0))->getZExtValue(); EVT PtrVT = DAG.getTargetLoweringInfo().getPointerTy(); bool isPPC64 = PtrVT == MVT::i64; MachineFunction &MF = DAG.getMachineFunction(); MachineFrameInfo *MFI = MF.getFrameInfo(); - bool is31 = (DisableFramePointerElim(MF) || MFI->hasVarSizedObjects()) - && MFI->getStackSize(); - - if (isPPC64) - return DAG.getCopyFromReg(DAG.getEntryNode(), dl, is31 ? PPC::X31 : PPC::X1, - MVT::i64); - else - return DAG.getCopyFromReg(DAG.getEntryNode(), dl, is31 ? PPC::R31 : PPC::R1, - MVT::i32); + MFI->setFrameAddressIsTaken(true); + bool is31 = (DisableFramePointerElim(MF) || MFI->hasVarSizedObjects()) && + MFI->getStackSize() && + !MF.getFunction()->hasFnAttr(Attribute::Naked); + unsigned FrameReg = isPPC64 ? (is31 ? PPC::X31 : PPC::X1) : + (is31 ? PPC::R31 : PPC::R1); + SDValue FrameAddr = DAG.getCopyFromReg(DAG.getEntryNode(), dl, FrameReg, + PtrVT); + while (Depth--) + FrameAddr = DAG.getLoad(Op.getValueType(), dl, DAG.getEntryNode(), + FrameAddr, NULL, 0, false, false, 0); + return FrameAddr; } bool Added: llvm/trunk/test/CodeGen/PowerPC/2010-05-03-retaddr1.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/PowerPC/2010-05-03-retaddr1.ll?rev=102972&view=auto ============================================================================== --- llvm/trunk/test/CodeGen/PowerPC/2010-05-03-retaddr1.ll (added) +++ llvm/trunk/test/CodeGen/PowerPC/2010-05-03-retaddr1.ll Mon May 3 17:59:34 2010 @@ -0,0 +1,24 @@ +; RUN: llc < %s -march=ppc32 -mtriple=powerpc-apple-darwin -mcpu=g5 | FileCheck %s + +declare i8* @llvm.frameaddress(i32) nounwind readnone + +define i8* @g2() nounwind readnone { +entry: +; CHECK: _g2: +; CHECK: lwz r3, 0(r1) + %0 = tail call i8* @llvm.frameaddress(i32 1) ; [#uses=1] + ret i8* %0 +} + +declare i8* @llvm.returnaddress(i32) nounwind readnone + +define i8* @g() nounwind readnone { +entry: +; CHECK: _g: +; CHECK: mflr r0 +; CHECK: stw r0, 8(r1) +; CHECK: lwz r3, 0(r1) +; CHECK: lwz r3, 8(r3) + %0 = tail call i8* @llvm.returnaddress(i32 1) ; [#uses=1] + ret i8* %0 +} From gohman at apple.com Mon May 3 18:36:34 2010 From: gohman at apple.com (Dan Gohman) Date: Mon, 03 May 2010 23:36:34 -0000 Subject: [llvm-commits] [llvm] r102975 - in /llvm/trunk: include/llvm/CodeGen/FastISel.h lib/CodeGen/SelectionDAG/FastISel.cpp Message-ID: <20100503233634.577C7312800A@llvm.org> Author: djg Date: Mon May 3 18:36:34 2010 New Revision: 102975 URL: http://llvm.org/viewvc/llvm-project?rev=102975&view=rev Log: Factor out FastISel's code for materializing constants and other values in registers into a separate function to de-couple it from the top-down-specific logic in getRegForValue. Modified: llvm/trunk/include/llvm/CodeGen/FastISel.h llvm/trunk/lib/CodeGen/SelectionDAG/FastISel.cpp Modified: llvm/trunk/include/llvm/CodeGen/FastISel.h URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/include/llvm/CodeGen/FastISel.h?rev=102975&r1=102974&r2=102975&view=diff ============================================================================== --- llvm/trunk/include/llvm/CodeGen/FastISel.h (original) +++ llvm/trunk/include/llvm/CodeGen/FastISel.h Mon May 3 18:36:34 2010 @@ -311,6 +311,11 @@ /// might result in multiple MBB's for one BB. As such, the start of the /// BB might correspond to a different MBB than the end. bool HandlePHINodesInSuccessorBlocks(const BasicBlock *LLVMBB); + + /// materializeRegForValue - Helper for getRegForVale. This function is + /// called when the value isn't already available in a register and must + /// be materialized with new instructions. + unsigned materializeRegForValue(const Value *V, MVT VT); }; } Modified: llvm/trunk/lib/CodeGen/SelectionDAG/FastISel.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/CodeGen/SelectionDAG/FastISel.cpp?rev=102975&r1=102974&r2=102975&view=diff ============================================================================== --- llvm/trunk/lib/CodeGen/SelectionDAG/FastISel.cpp (original) +++ llvm/trunk/lib/CodeGen/SelectionDAG/FastISel.cpp Mon May 3 18:36:34 2010 @@ -84,6 +84,15 @@ if (Reg != 0) return Reg; + return materializeRegForValue(V, VT); +} + +/// materializeRegForValue - Helper for getRegForVale. This function is +/// called when the value isn't already available in a register and must +/// be materialized with new instructions. +unsigned FastISel::materializeRegForValue(const Value *V, MVT VT) { + unsigned Reg = 0; + if (const ConstantInt *CI = dyn_cast(V)) { if (CI->getValue().getActiveBits() <= 64) Reg = FastEmit_i(VT, VT, ISD::Constant, CI->getZExtValue()); @@ -141,7 +150,7 @@ // Look up the value to see if we already have a register for it. We // cache values defined by Instructions across blocks, and other values // only locally. This is because Instructions already have the SSA - // def-dominatess-use requirement enforced. + // def-dominates-use requirement enforced. if (ValueMap.count(V)) return ValueMap[V]; return LocalValueMap[V]; From stoklund at 2pi.dk Mon May 3 18:49:21 2010 From: stoklund at 2pi.dk (Jakob Stoklund Olesen) Date: Mon, 03 May 2010 23:49:21 -0000 Subject: [llvm-commits] [llvm] r102976 - /llvm/trunk/lib/CodeGen/RegAllocLocal.cpp Message-ID: <20100503234921.14B7C312800A@llvm.org> Author: stoklund Date: Mon May 3 18:49:20 2010 New Revision: 102976 URL: http://llvm.org/viewvc/llvm-project?rev=102976&view=rev Log: Remove preexisting kill flags in RegAllocLocal, just like LiveVariables does. This should make it possible to start producing kill flags in isel without breaking stuff. Modified: llvm/trunk/lib/CodeGen/RegAllocLocal.cpp Modified: llvm/trunk/lib/CodeGen/RegAllocLocal.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/CodeGen/RegAllocLocal.cpp?rev=102976&r1=102975&r2=102976&view=diff ============================================================================== --- llvm/trunk/lib/CodeGen/RegAllocLocal.cpp (original) +++ llvm/trunk/lib/CodeGen/RegAllocLocal.cpp Mon May 3 18:49:20 2010 @@ -643,7 +643,10 @@ // uses regs before it defs them. if (!MO.isReg() || !MO.getReg() || !MO.isUse()) continue; - + + // Ignore helpful kill flags from earlier passes. + MO.setIsKill(false); + LastUseDef[MO.getReg()] = std::make_pair(I, i); if (TargetRegisterInfo::isVirtualRegister(MO.getReg())) continue; From gohman at apple.com Mon May 3 18:51:05 2010 From: gohman at apple.com (Dan Gohman) Date: Mon, 03 May 2010 23:51:05 -0000 Subject: [llvm-commits] [llvm] r102977 - /llvm/trunk/docs/ReleaseNotes.html Message-ID: <20100503235105.EB2E9312800A@llvm.org> Author: djg Date: Mon May 3 18:51:05 2010 New Revision: 102977 URL: http://llvm.org/viewvc/llvm-project?rev=102977&view=rev Log: Minimally update ReleaseNotes.html for 2.8 development; uncomment and update the big red warning at the top. Most of the old content remains and awaits revision. Clear out the API changes section, and start it up again with a mention of the add->fadd transition. Modified: llvm/trunk/docs/ReleaseNotes.html Modified: llvm/trunk/docs/ReleaseNotes.html URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/ReleaseNotes.html?rev=102977&r1=102976&r2=102977&view=diff ============================================================================== --- llvm/trunk/docs/ReleaseNotes.html (original) +++ llvm/trunk/docs/ReleaseNotes.html Mon May 3 18:51:05 2010 @@ -4,11 +4,11 @@ - LLVM 2.7 Release Notes + LLVM 2.8 Release Notes -
    LLVM 2.7 Release Notes
    +
    LLVM 2.8 Release Notes
    LLVM Dragon Logo @@ -16,8 +16,8 @@
    1. Introduction
    2. Sub-project Status Update
      3. -
    3. External Projects Using LLVM 2.7
      4. -
    4. What's New in LLVM 2.7?
      5. +
    5. External Projects Using LLVM 2.8
      6. +
    6. What's New in LLVM 2.8?
    7. Installation Instructions
    8. Portability and Supported Platforms
    9. Known Problems
      10. @@ -28,12 +28,11 @@

      Written by the LLVM Team

      - +LLVM 2.7 +Release Notes.
      @@ -74,7 +73,7 @@ --> - -
      Abstract
      - - -
      - -

      This document is a reference manual for the LLVM assembly language. LLVM is - a Static Single Assignment (SSA) based representation that provides type - safety, low-level operations, flexibility, and the capability of representing - 'all' high-level languages cleanly. It is the common code representation - used throughout all phases of the LLVM compilation strategy.

      - -
      - - -
      Introduction
      - - -
      - -

      The LLVM code representation is designed to be used in three different forms: - as an in-memory compiler IR, as an on-disk bitcode representation (suitable - for fast loading by a Just-In-Time compiler), and as a human readable - assembly language representation. This allows LLVM to provide a powerful - intermediate representation for efficient compiler transformations and - analysis, while providing a natural means to debug and visualize the - transformations. The three different forms of LLVM are all equivalent. This - document describes the human readable representation and notation.

      - -

      The LLVM representation aims to be light-weight and low-level while being - expressive, typed, and extensible at the same time. It aims to be a - "universal IR" of sorts, by being at a low enough level that high-level ideas - may be cleanly mapped to it (similar to how microprocessors are "universal - IR's", allowing many source languages to be mapped to them). By providing - type information, LLVM can be used as the target of optimizations: for - example, through pointer analysis, it can be proven that a C automatic - variable is never accessed outside of the current function, allowing it to - be promoted to a simple SSA value instead of a memory location.

      - -
      - - -
      Well-Formedness
      - -
      - -

      It is important to note that this document describes 'well formed' LLVM - assembly language. There is a difference between what the parser accepts and - what is considered 'well formed'. For example, the following instruction is - syntactically okay, but not well formed:

      - -
      -
      -%x = add i32 1, %x
-
      -
      - -

      because the definition of %x does not dominate all of its uses. The - LLVM infrastructure provides a verification pass that may be used to verify - that an LLVM module is well formed. This pass is automatically run by the - parser after parsing input assembly and by the optimizer before it outputs - bitcode. The violations pointed out by the verifier pass indicate bugs in - transformation passes or input to the parser.

      - -
      - - - - -
      Identifiers
      - - -
      - -

      LLVM identifiers come in two basic types: global and local. Global - identifiers (functions, global variables) begin with the '@' - character. Local identifiers (register names, types) begin with - the '%' character. Additionally, there are three different formats - for identifiers, for different purposes:

      - -
        -
      1. Named values are represented as a string of characters with their prefix. - For example, %foo, @DivisionByZero, - %a.really.long.identifier. The actual regular expression used is - '[%@][a-zA-Z$._][a-zA-Z$._0-9]*'. Identifiers which require - other characters in their names can be surrounded with quotes. Special - characters may be escaped using "\xx" where xx is the - ASCII code for the character in hexadecimal. In this way, any character - can be used in a name value, even quotes themselves.
        2. - -
      2. Unnamed values are represented as an unsigned numeric value with their - prefix. For example, %12, @2, %44.
        3. - -
      3. Constants, which are described in a section about - constants, below.
        4. -
      - -

      LLVM requires that values start with a prefix for two reasons: Compilers - don't need to worry about name clashes with reserved words, and the set of - reserved words may be expanded in the future without penalty. Additionally, - unnamed identifiers allow a compiler to quickly come up with a temporary - variable without having to avoid symbol table conflicts.

      - -

      Reserved words in LLVM are very similar to reserved words in other - languages. There are keywords for different opcodes - ('add', - 'bitcast', - 'ret', etc...), for primitive type names - ('void', - 'i32', etc...), and others. These - reserved words cannot conflict with variable names, because none of them - start with a prefix character ('%' or '@').

      - -

      Here is an example of LLVM code to multiply the integer variable - '%X' by 8:

      - -

      The easy way:

      - -
      -
      -%result = mul i32 %X, 8
-
      -
      - -

      After strength reduction:

      - -
      -
      -%result = shl i32 %X, i8 3
-
      -
      - -

      And the hard way:

      - -
      -
      -%0 = add i32 %X, %X           ; yields {i32}:%0
-%1 = add i32 %0, %0           ; yields {i32}:%1
-%result = add i32 %1, %1
-
      -
      - -

      This last way of multiplying %X by 8 illustrates several important - lexical features of LLVM:

      - -
        -
      1. Comments are delimited with a ';' and go until the end of - line.
        2. - -
      2. Unnamed temporaries are created when the result of a computation is not - assigned to a named value.
        3. - -
      3. Unnamed temporaries are numbered sequentially
        4. -
      - -

      It also shows a convention that we follow in this document. When - demonstrating instructions, we will follow an instruction with a comment that - defines the type and name of value produced. Comments are shown in italic - text.

      - -
      - - -
      High Level Structure
      - - - -
      Module Structure -
      - -
      - -

      LLVM programs are composed of "Module"s, each of which is a translation unit - of the input programs. Each module consists of functions, global variables, - and symbol table entries. Modules may be combined together with the LLVM - linker, which merges function (and global variable) definitions, resolves - forward declarations, and merges symbol table entries. Here is an example of - the "hello world" module:

      - -
      -
      -; Declare the string constant as a global constant.
-@.LC0 = internal constant [13 x i8] c"hello world\0A\00"    ; [13 x i8]*
-
-; External declaration of the puts function
-declare i32 @puts(i8 *)                                     ; i32(i8 *)* 
-
-; Definition of main function
-define i32 @main() {                                        ; i32()* 
-  ; Convert [13 x i8]* to i8  *...
-  %cast210 = getelementptr [13 x i8]* @.LC0, i64 0, i64 0   ; i8 *
-
-  ; Call puts function to write out the string to stdout.
-  call i32 @puts(i8 * %cast210)                             ; i32
-  ret i32 0
      }
-
-; Named metadata
-!1 = metadata !{i32 41}
-!foo = !{!1, null}
-
      -
      - -

      This example is made up of a global variable named - ".LC0", an external declaration of the "puts" function, - a function definition for - "main" and named metadata - "foo".

      - -

      In general, a module is made up of a list of global values, where both - functions and global variables are global values. Global values are - represented by a pointer to a memory location (in this case, a pointer to an - array of char, and a pointer to a function), and have one of the - following linkage types.

      - -
      - - -
      - Linkage Types -
      - -
      - -

      All Global Variables and Functions have one of the following types of - linkage:

      - -
      -
      private
      -
      Global values with private linkage are only directly accessible by objects - in the current module. In particular, linking code into a module with an - private global value may cause the private to be renamed as necessary to - avoid collisions. Because the symbol is private to the module, all - references can be updated. This doesn't show up in any symbol table in the - object file.
      - -
      linker_private
      -
      Similar to private, but the symbol is passed through the assembler and - removed by the linker after evaluation. Note that (unlike private - symbols) linker_private symbols are subject to coalescing by the linker: - weak symbols get merged and redefinitions are rejected. However, unlike - normal strong symbols, they are removed by the linker from the final - linked image (executable or dynamic library).
      - -
      internal
      -
      Similar to private, but the value shows as a local symbol - (STB_LOCAL in the case of ELF) in the object file. This - corresponds to the notion of the 'static' keyword in C.
      - -
      available_externally
      -
      Globals with "available_externally" linkage are never emitted - into the object file corresponding to the LLVM module. They exist to - allow inlining and other optimizations to take place given knowledge of - the definition of the global, which is known to be somewhere outside the - module. Globals with available_externally linkage are allowed to - be discarded at will, and are otherwise the same as linkonce_odr. - This linkage type is only allowed on definitions, not declarations.
      - -
      linkonce
      -
      Globals with "linkonce" linkage are merged with other globals of - the same name when linkage occurs. This can be used to implement - some forms of inline functions, templates, or other code which must be - generated in each translation unit that uses it, but where the body may - be overridden with a more definitive definition later. Unreferenced - linkonce globals are allowed to be discarded. Note that - linkonce linkage does not actually allow the optimizer to - inline the body of this function into callers because it doesn't know if - this definition of the function is the definitive definition within the - program or whether it will be overridden by a stronger definition. - To enable inlining and other optimizations, use "linkonce_odr" - linkage.
      - -
      weak
      -
      "weak" linkage has the same merging semantics as - linkonce linkage, except that unreferenced globals with - weak linkage may not be discarded. This is used for globals that - are declared "weak" in C source code.
      - -
      common
      -
      "common" linkage is most similar to "weak" linkage, but - they are used for tentative definitions in C, such as "int X;" at - global scope. - Symbols with "common" linkage are merged in the same way as - weak symbols, and they may not be deleted if unreferenced. - common symbols may not have an explicit section, - must have a zero initializer, and may not be marked 'constant'. Functions and aliases may not - have common linkage.
      - - -
      appending
      -
      "appending" linkage may only be applied to global variables of - pointer to array type. When two global variables with appending linkage - are linked together, the two global arrays are appended together. This is - the LLVM, typesafe, equivalent of having the system linker append together - "sections" with identical names when .o files are linked.
      - -
      extern_weak
      -
      The semantics of this linkage follow the ELF object file model: the symbol - is weak until linked, if not linked, the symbol becomes null instead of - being an undefined reference.
      - -
      linkonce_odr
      -
      weak_odr
      -
      Some languages allow differing globals to be merged, such as two functions - with different semantics. Other languages, such as C++, ensure - that only equivalent globals are ever merged (the "one definition rule" - - "ODR"). Such languages can use the linkonce_odr - and weak_odr linkage types to indicate that the global will only - be merged with equivalent globals. These linkage types are otherwise the - same as their non-odr versions.
      - -
      externally visible:
      -
      If none of the above identifiers are used, the global is externally - visible, meaning that it participates in linkage and can be used to - resolve external symbol references.
      -
      - -

      The next two types of linkage are targeted for Microsoft Windows platform - only. They are designed to support importing (exporting) symbols from (to) - DLLs (Dynamic Link Libraries).

      - -
      -
      dllimport
      -
      "dllimport" linkage causes the compiler to reference a function - or variable via a global pointer to a pointer that is set up by the DLL - exporting the symbol. On Microsoft Windows targets, the pointer name is - formed by combining __imp_ and the function or variable - name.
      - -
      dllexport
      -
      "dllexport" linkage causes the compiler to provide a global - pointer to a pointer in a DLL, so that it can be referenced with the - dllimport attribute. On Microsoft Windows targets, the pointer - name is formed by combining __imp_ and the function or - variable name.
      -
      - -

      For example, since the ".LC0" variable is defined to be internal, if - another module defined a ".LC0" variable and was linked with this - one, one of the two would be renamed, preventing a collision. Since - "main" and "puts" are external (i.e., lacking any linkage - declarations), they are accessible outside of the current module.

      - -

      It is illegal for a function declaration to have any linkage type - other than "externally visible", dllimport - or extern_weak.

      - -

      Aliases can have only external, internal, weak - or weak_odr linkages.

      - -
      - - -
      - Calling Conventions -
      - -
      - -

      LLVM functions, calls - and invokes can all have an optional calling - convention specified for the call. The calling convention of any pair of - dynamic caller/callee must match, or the behavior of the program is - undefined. The following calling conventions are supported by LLVM, and more - may be added in the future:

      - -
      -
      "ccc" - The C calling convention:
      -
      This calling convention (the default if no other calling convention is - specified) matches the target C calling conventions. This calling - convention supports varargs function calls and tolerates some mismatch in - the declared prototype and implemented declaration of the function (as - does normal C).
      - -
      "fastcc" - The fast calling convention:
      -
      This calling convention attempts to make calls as fast as possible - (e.g. by passing things in registers). This calling convention allows the - target to use whatever tricks it wants to produce fast code for the - target, without having to conform to an externally specified ABI - (Application Binary Interface). - Tail calls can only be optimized - when this or the GHC convention is used. This calling convention - does not support varargs and requires the prototype of all callees to - exactly match the prototype of the function definition.
      - -
      "coldcc" - The cold calling convention:
      -
      This calling convention attempts to make code in the caller as efficient - as possible under the assumption that the call is not commonly executed. - As such, these calls often preserve all registers so that the call does - not break any live ranges in the caller side. This calling convention - does not support varargs and requires the prototype of all callees to - exactly match the prototype of the function definition.
      - -
      "cc 10" - GHC convention:
      -
      This calling convention has been implemented specifically for use by the - Glasgow Haskell Compiler (GHC). - It passes everything in registers, going to extremes to achieve this by - disabling callee save registers. This calling convention should not be - used lightly but only for specific situations such as an alternative to - the register pinning performance technique often used when - implementing functional programming languages.At the moment only X86 - supports this convention and it has the following limitations: -
        -
      • On X86-32 only supports up to 4 bit type parameters. No - floating point types are supported.
        • -
      • On X86-64 only supports up to 10 bit type parameters and - 6 floating point parameters.
        • -
      - This calling convention supports - tail call optimization but - requires both the caller and callee are using it. -
      - -
      "cc <n>" - Numbered convention:
      -
      Any calling convention may be specified by number, allowing - target-specific calling conventions to be used. Target specific calling - conventions start at 64.
      -
      - -

      More calling conventions can be added/defined on an as-needed basis, to - support Pascal conventions or any other well-known target-independent - convention.

      - -
      - - -
      - Visibility Styles -
      - -
      - -

      All Global Variables and Functions have one of the following visibility - styles:

      - -
      -
      "default" - Default style:
      -
      On targets that use the ELF object file format, default visibility means - that the declaration is visible to other modules and, in shared libraries, - means that the declared entity may be overridden. On Darwin, default - visibility means that the declaration is visible to other modules. Default - visibility corresponds to "external linkage" in the language.
      - -
      "hidden" - Hidden style:
      -
      Two declarations of an object with hidden visibility refer to the same - object if they are in the same shared object. Usually, hidden visibility - indicates that the symbol will not be placed into the dynamic symbol - table, so no other module (executable or shared library) can reference it - directly.
      - -
      "protected" - Protected style:
      -
      On ELF, protected visibility indicates that the symbol will be placed in - the dynamic symbol table, but that references within the defining module - will bind to the local symbol. That is, the symbol cannot be overridden by - another module.
      -
      - -
      - - -
      - Named Types -
      - -
      - -

      LLVM IR allows you to specify name aliases for certain types. This can make - it easier to read the IR and make the IR more condensed (particularly when - recursive types are involved). An example of a name specification is:

      - -
      -
      -%mytype = type { %mytype*, i32 }
-
      -
      - -

      You may give a name to any type except - "void". Type name aliases may be used anywhere a type - is expected with the syntax "%mytype".

      - -

      Note that type names are aliases for the structural type that they indicate, - and that you can therefore specify multiple names for the same type. This - often leads to confusing behavior when dumping out a .ll file. Since LLVM IR - uses structural typing, the name is not part of the type. When printing out - LLVM IR, the printer will pick one name to render all types of a - particular shape. This means that if you have code where two different - source types end up having the same LLVM type, that the dumper will sometimes - print the "wrong" or unexpected type. This is an important design point and - isn't going to change.

      - -
      - - -
      - Global Variables -
      - -
      - -

      Global variables define regions of memory allocated at compilation time - instead of run-time. Global variables may optionally be initialized, may - have an explicit section to be placed in, and may have an optional explicit - alignment specified. A variable may be defined as "thread_local", which - means that it will not be shared by threads (each thread will have a - separated copy of the variable). A variable may be defined as a global - "constant," which indicates that the contents of the variable - will never be modified (enabling better optimization, allowing the - global data to be placed in the read-only section of an executable, etc). - Note that variables that need runtime initialization cannot be marked - "constant" as there is a store to the variable.

      - -

      LLVM explicitly allows declarations of global variables to be marked - constant, even if the final definition of the global is not. This capability - can be used to enable slightly better optimization of the program, but - requires the language definition to guarantee that optimizations based on the - 'constantness' are valid for the translation units that do not include the - definition.

      - -

      As SSA values, global variables define pointer values that are in scope - (i.e. they dominate) all basic blocks in the program. Global variables - always define a pointer to their "content" type because they describe a - region of memory, and all memory objects in LLVM are accessed through - pointers.

      - -

      A global variable may be declared to reside in a target-specific numbered - address space. For targets that support them, address spaces may affect how - optimizations are performed and/or what target instructions are used to - access the variable. The default address space is zero. The address space - qualifier must precede any other attributes.

      - -

      LLVM allows an explicit section to be specified for globals. If the target - supports it, it will emit globals to the section specified.

      - -

      An explicit alignment may be specified for a global, which must be a power - of 2. If not present, or if the alignment is set to zero, the alignment of - the global is set by the target to whatever it feels convenient. If an - explicit alignment is specified, the global is forced to have exactly that - alignment. Targets and optimizers are not allowed to over-align the global - if the global has an assigned section. In this case, the extra alignment - could be observable: for example, code could assume that the globals are - densely packed in their section and try to iterate over them as an array, - alignment padding would break this iteration.

      - -

      For example, the following defines a global in a numbered address space with - an initializer, section, and alignment:

      - -
      -
      - at G = addrspace(5) constant float 1.0, section "foo", align 4
-
      -
      - -
      - - - -
      - Functions -
      - -
      - -

      LLVM function definitions consist of the "define" keyword, an - optional linkage type, an optional - visibility style, an optional - calling convention, a return type, an optional - parameter attribute for the return type, a function - name, a (possibly empty) argument list (each with optional - parameter attributes), optional - function attributes, an optional section, an optional - alignment, an optional garbage collector name, an opening - curly brace, a list of basic blocks, and a closing curly brace.

      - -

      LLVM function declarations consist of the "declare" keyword, an - optional linkage type, an optional - visibility style, an optional - calling convention, a return type, an optional - parameter attribute for the return type, a function - name, a possibly empty list of arguments, an optional alignment, and an - optional garbage collector name.

      - -

      A function definition contains a list of basic blocks, forming the CFG - (Control Flow Graph) for the function. Each basic block may optionally start - with a label (giving the basic block a symbol table entry), contains a list - of instructions, and ends with a terminator - instruction (such as a branch or function return).

      - -

      The first basic block in a function is special in two ways: it is immediately - executed on entrance to the function, and it is not allowed to have - predecessor basic blocks (i.e. there can not be any branches to the entry - block of a function). Because the block can have no predecessors, it also - cannot have any PHI nodes.

      - -

      LLVM allows an explicit section to be specified for functions. If the target - supports it, it will emit functions to the section specified.

      - -

      An explicit alignment may be specified for a function. If not present, or if - the alignment is set to zero, the alignment of the function is set by the - target to whatever it feels convenient. If an explicit alignment is - specified, the function is forced to have at least that much alignment. All - alignments must be a power of 2.

      - -
      Syntax:
      -
      -
      -define [linkage] [visibility]
-       [cconv] [ret attrs]
-       <ResultType> @<FunctionName> ([argument list])
-       [fn Attrs] [section "name"] [align N]
-       [gc] { ... }
-
      -
      - -
      - - -
      - Aliases -
      - -
      - -

      Aliases act as "second name" for the aliasee value (which can be either - function, global variable, another alias or bitcast of global value). Aliases - may have an optional linkage type, and an - optional visibility style.

      - -
      Syntax:
      -
      -
      -@<Name> = alias [Linkage] [Visibility] <AliaseeTy> @<Aliasee>
-
      -
      - -
      - - -
      - Named Metadata -
      - -
      - -

      Named metadata is a collection of metadata. Metadata - nodes (but not metadata strings) and null are the only valid operands for - a named metadata.

      - -
      Syntax:
      -
      -
      -!1 = metadata !{metadata !"one"}
-!name = !{null, !1}
-
      -
      - -
      - - -
      Parameter Attributes
      - -
      - -

      The return type and each parameter of a function type may have a set of - parameter attributes associated with them. Parameter attributes are - used to communicate additional information about the result or parameters of - a function. Parameter attributes are considered to be part of the function, - not of the function type, so functions with different parameter attributes - can have the same function type.

      - -

      Parameter attributes are simple keywords that follow the type specified. If - multiple parameter attributes are needed, they are space separated. For - example:

      - -
      -
      -declare i32 @printf(i8* noalias nocapture, ...)
-declare i32 @atoi(i8 zeroext)
-declare signext i8 @returns_signed_char()
-
      -
      - -

      Note that any attributes for the function result (nounwind, - readonly) come immediately after the argument list.

      - -

      Currently, only the following parameter attributes are defined:

      - -
      -
      zeroext
      -
      This indicates to the code generator that the parameter or return value - should be zero-extended to a 32-bit value by the caller (for a parameter) - or the callee (for a return value).
      - -
      signext
      -
      This indicates to the code generator that the parameter or return value - should be sign-extended to a 32-bit value by the caller (for a parameter) - or the callee (for a return value).
      - -
      inreg
      -
      This indicates that this parameter or return value should be treated in a - special target-dependent fashion during while emitting code for a function - call or return (usually, by putting it in a register as opposed to memory, - though some targets use it to distinguish between two different kinds of - registers). Use of this attribute is target-specific.
      - -
      byval
      -
      This indicates that the pointer parameter should really be passed by value - to the function. The attribute implies that a hidden copy of the pointee - is made between the caller and the callee, so the callee is unable to - modify the value in the callee. This attribute is only valid on LLVM - pointer arguments. It is generally used to pass structs and arrays by - value, but is also valid on pointers to scalars. The copy is considered - to belong to the caller not the callee (for example, - readonly functions should not write to - byval parameters). This is not a valid attribute for return - values. The byval attribute also supports specifying an alignment with - the align attribute. This has a target-specific effect on the code - generator that usually indicates a desired alignment for the synthesized - stack slot.
      - -
      sret
      -
      This indicates that the pointer parameter specifies the address of a - structure that is the return value of the function in the source program. - This pointer must be guaranteed by the caller to be valid: loads and - stores to the structure may be assumed by the callee to not to trap. This - may only be applied to the first parameter. This is not a valid attribute - for return values.
      - -
      noalias
      -
      This indicates that the pointer does not alias any global or any other - parameter. The caller is responsible for ensuring that this is the - case. On a function return value, noalias additionally indicates - that the pointer does not alias any other pointers visible to the - caller. For further details, please see the discussion of the NoAlias - response in - alias - analysis.
      - -
      nocapture
      -
      This indicates that the callee does not make any copies of the pointer - that outlive the callee itself. This is not a valid attribute for return - values.
      - -
      nest
      -
      This indicates that the pointer parameter can be excised using the - trampoline intrinsics. This is not a valid - attribute for return values.
      -
      - -
      - - -
      - Garbage Collector Names -
      - -
      - -

      Each function may specify a garbage collector name, which is simply a - string:

      - -
      -
      -define void @f() gc "name" { ... }
-
      -
      - -

      The compiler declares the supported values of name. Specifying a - collector which will cause the compiler to alter its output in order to - support the named garbage collection algorithm.

      - -
      - - -
      - Function Attributes -
      - -
      - -

      Function attributes are set to communicate additional information about a - function. Function attributes are considered to be part of the function, not - of the function type, so functions with different parameter attributes can - have the same function type.

      - -

      Function attributes are simple keywords that follow the type specified. If - multiple attributes are needed, they are space separated. For example:

      - -
      -
      -define void @f() noinline { ... }
-define void @f() alwaysinline { ... }
-define void @f() alwaysinline optsize { ... }
-define void @f() optsize { ... }
-
      -
      - -
      -
      alignstack(<n>)
      -
      This attribute indicates that, when emitting the prologue and epilogue, - the backend should forcibly align the stack pointer. Specify the - desired alignment, which must be a power of two, in parentheses. - -
      alwaysinline
      -
      This attribute indicates that the inliner should attempt to inline this - function into callers whenever possible, ignoring any active inlining size - threshold for this caller.
      - -
      inlinehint
      -
      This attribute indicates that the source code contained a hint that inlining - this function is desirable (such as the "inline" keyword in C/C++). It - is just a hint; it imposes no requirements on the inliner.
      - -
      noinline
      -
      This attribute indicates that the inliner should never inline this - function in any situation. This attribute may not be used together with - the alwaysinline attribute.
      - -
      optsize
      -
      This attribute suggests that optimization passes and code generator passes - make choices that keep the code size of this function low, and otherwise - do optimizations specifically to reduce code size.
      - -
      noreturn
      -
      This function attribute indicates that the function never returns - normally. This produces undefined behavior at runtime if the function - ever does dynamically return.
      - -
      nounwind
      -
      This function attribute indicates that the function never returns with an - unwind or exceptional control flow. If the function does unwind, its - runtime behavior is undefined.
      - -
      readnone
      -
      This attribute indicates that the function computes its result (or decides - to unwind an exception) based strictly on its arguments, without - dereferencing any pointer arguments or otherwise accessing any mutable - state (e.g. memory, control registers, etc) visible to caller functions. - It does not write through any pointer arguments - (including byval arguments) and never - changes any state visible to callers. This means that it cannot unwind - exceptions by calling the C++ exception throwing methods, but - could use the unwind instruction.
      - -
      readonly
      -
      This attribute indicates that the function does not write through any - pointer arguments (including byval - arguments) or otherwise modify any state (e.g. memory, control registers, - etc) visible to caller functions. It may dereference pointer arguments - and read state that may be set in the caller. A readonly function always - returns the same value (or unwinds an exception identically) when called - with the same set of arguments and global state. It cannot unwind an - exception by calling the C++ exception throwing methods, but may - use the unwind instruction.
      - -
      ssp
      -
      This attribute indicates that the function should emit a stack smashing - protector. It is in the form of a "canary"—a random value placed on - the stack before the local variables that's checked upon return from the - function to see if it has been overwritten. A heuristic is used to - determine if a function needs stack protectors or not.
      -
      - If a function that has an ssp attribute is inlined into a - function that doesn't have an ssp attribute, then the resulting - function will have an ssp attribute.
      - -
      sspreq
      -
      This attribute indicates that the function should always emit a - stack smashing protector. This overrides - the ssp function attribute.
      -
      - If a function that has an sspreq attribute is inlined into a - function that doesn't have an sspreq attribute or which has - an ssp attribute, then the resulting function will have - an sspreq attribute.
      - -
      noredzone
      -
      This attribute indicates that the code generator should not use a red - zone, even if the target-specific ABI normally permits it.
      - -
      noimplicitfloat
      -
      This attributes disables implicit floating point instructions.
      - -
      naked
      -
      This attribute disables prologue / epilogue emission for the function. - This can have very system-specific consequences.
      -
      - -
      - - -
      - Module-Level Inline Assembly -
      - -
      - -

      Modules may contain "module-level inline asm" blocks, which corresponds to - the GCC "file scope inline asm" blocks. These blocks are internally - concatenated by LLVM and treated as a single unit, but may be separated in - the .ll file if desired. The syntax is very simple:

      - -
      -
      -module asm "inline asm code goes here"
-module asm "more can go here"
-
      -
      - -

      The strings can contain any character by escaping non-printable characters. - The escape sequence used is simply "\xx" where "xx" is the two digit hex code - for the number.

      - -

      The inline asm code is simply printed to the machine code .s file when - assembly code is generated.

      - -
      - - -
      - Data Layout -
      - -
      - -

      A module may specify a target specific data layout string that specifies how - data is to be laid out in memory. The syntax for the data layout is - simply:

      - -
      -
      -target datalayout = "layout specification"
-
      -
      - -

      The layout specification consists of a list of specifications - separated by the minus sign character ('-'). Each specification starts with - a letter and may include other information after the letter to define some - aspect of the data layout. The specifications accepted are as follows:

      - -
      -
      E
      -
      Specifies that the target lays out data in big-endian form. That is, the - bits with the most significance have the lowest address location.
      - -
      e
      -
      Specifies that the target lays out data in little-endian form. That is, - the bits with the least significance have the lowest address - location.
      - -
      p:size:abi:pref
      -
      This specifies the size of a pointer and its abi and - preferred alignments. All sizes are in bits. Specifying - the pref alignment is optional. If omitted, the - preceding : should be omitted too.
      - -
      isize:abi:pref
      -
      This specifies the alignment for an integer type of a given bit - size. The value of size must be in the range [1,2^23).
      - -
      vsize:abi:pref
      -
      This specifies the alignment for a vector type of a given bit - size.
      - -
      fsize:abi:pref
      -
      This specifies the alignment for a floating point type of a given bit - size. The value of size must be either 32 (float) or 64 - (double).
      - -
      asize:abi:pref
      -
      This specifies the alignment for an aggregate type of a given bit - size.
      - -
      ssize:abi:pref
      -
      This specifies the alignment for a stack object of a given bit - size.
      - -
      nsize1:size2:size3...
      -
      This specifies a set of native integer widths for the target CPU - in bits. For example, it might contain "n32" for 32-bit PowerPC, - "n32:64" for PowerPC 64, or "n8:16:32:64" for X86-64. Elements of - this set are considered to support most general arithmetic - operations efficiently.
      -
      - -

      When constructing the data layout for a given target, LLVM starts with a - default set of specifications which are then (possibly) overridden by the - specifications in the datalayout keyword. The default specifications - are given in this list:

      - -
        -
      • E - big endian
        • -
      • p:64:64:64 - 64-bit pointers with 64-bit alignment
        • -
      • i1:8:8 - i1 is 8-bit (byte) aligned
        • -
      • i8:8:8 - i8 is 8-bit (byte) aligned
        • -
      • i16:16:16 - i16 is 16-bit aligned
        • -
      • i32:32:32 - i32 is 32-bit aligned
        • -
      • i64:32:64 - i64 has ABI alignment of 32-bits but preferred - alignment of 64-bits
        • -
      • f32:32:32 - float is 32-bit aligned
        • -
      • f64:64:64 - double is 64-bit aligned
        • -
      • v64:64:64 - 64-bit vector is 64-bit aligned
        • -
      • v128:128:128 - 128-bit vector is 128-bit aligned
        • -
      • a0:0:1 - aggregates are 8-bit aligned
        • -
      • s0:64:64 - stack objects are 64-bit aligned
        • -
      - -

      When LLVM is determining the alignment for a given type, it uses the - following rules:

      - -
        -
      1. If the type sought is an exact match for one of the specifications, that - specification is used.
        2. - -
      2. If no match is found, and the type sought is an integer type, then the - smallest integer type that is larger than the bitwidth of the sought type - is used. If none of the specifications are larger than the bitwidth then - the the largest integer type is used. For example, given the default - specifications above, the i7 type will use the alignment of i8 (next - largest) while both i65 and i256 will use the alignment of i64 (largest - specified).
        3. - -
      3. If no match is found, and the type sought is a vector type, then the - largest vector type that is smaller than the sought vector type will be - used as a fall back. This happens because <128 x double> can be - implemented in terms of 64 <2 x double>, for example.
        4. -
      - -
      - - -
      - Pointer Aliasing Rules -
      - -
      - -

      Any memory access must be done through a pointer value associated -with an address range of the memory access, otherwise the behavior -is undefined. Pointer values are associated with address ranges -according to the following rules:

      - -
        -
      • A pointer value formed from a - getelementptr instruction - is associated with the addresses associated with the first operand - of the getelementptr.
        • -
      • An address of a global variable is associated with the address - range of the variable's storage.
        • -
      • The result value of an allocation instruction is associated with - the address range of the allocated storage.
        • -
      • A null pointer in the default address-space is associated with - no address.
        • -
      • A pointer value formed by an - inttoptr is associated with all - address ranges of all pointer values that contribute (directly or - indirectly) to the computation of the pointer's value.
        • -
      • The result value of a - bitcast is associated with all - addresses associated with the operand of the bitcast.
        • -
      • An integer constant other than zero or a pointer value returned - from a function not defined within LLVM may be associated with address - ranges allocated through mechanisms other than those provided by - LLVM. Such ranges shall not overlap with any ranges of addresses - allocated by mechanisms provided by LLVM.
        • -
      - -

      LLVM IR does not associate types with memory. The result type of a -load merely indicates the size and -alignment of the memory from which to load, as well as the -interpretation of the value. The first operand of a -store similarly only indicates the size -and alignment of the store.

      - -

      Consequently, type-based alias analysis, aka TBAA, aka --fstrict-aliasing, is not applicable to general unadorned -LLVM IR. Metadata may be used to encode -additional information which specialized optimization passes may use -to implement type-based alias analysis.

      - -
      - - -
      - Volatile Memory Accesses -
      - -
      - -

      Certain memory accesses, such as loads, stores, and llvm.memcpys may be marked volatile. -The optimizers must not change the number of volatile operations or change their -order of execution relative to other volatile operations. The optimizers -may change the order of volatile operations relative to non-volatile -operations. This is not Java's "volatile" and has no cross-thread -synchronization behavior.

      - -
      - - -
      Type System
      - - -
      - -

      The LLVM type system is one of the most important features of the - intermediate representation. Being typed enables a number of optimizations - to be performed on the intermediate representation directly, without having - to do extra analyses on the side before the transformation. A strong type - system makes it easier to read the generated code and enables novel analyses - and transformations that are not feasible to perform on normal three address - code representations.

      - -
      - - -
      Type -Classifications
      - -
      - -

      The types fall into a few useful classifications:

      - - - - - - - - - - - - - - - - - - - - - - - - - -
      ClassificationTypes
      integeri1, i2, i3, ... i8, ... i16, ... i32, ... i64, ...
      floating pointfloat, double, x86_fp80, fp128, ppc_fp128
      first classinteger, - floating point, - pointer, - vector, - structure, - union, - array, - label, - metadata. -
      primitivelabel, - void, - floating point, - metadata.
      derivedarray, - function, - pointer, - structure, - packed structure, - union, - vector, - opaque. -
      - -

      The first class types are perhaps the most - important. Values of these types are the only ones which can be produced by - instructions.

      - -
      - - -
      Primitive Types
      - -
      - -

      The primitive types are the fundamental building blocks of the LLVM - system.

      - -
      - - -
      Integer Type
      - -
      - -
      Overview:
      -

      The integer type is a very simple type that simply specifies an arbitrary - bit width for the integer type desired. Any bit width from 1 bit to - 223-1 (about 8 million) can be specified.

      - -
      Syntax:
      -
      -  iN
-
      - -

      The number of bits the integer will occupy is specified by the N - value.

      - -
      Examples:
      - - - - - - - - - - - - - -
      i1a single-bit integer.
      i32a 32-bit integer.
      i1942652a really big integer of over 1 million bits.
      - -
      - - -
      Floating Point Types
      - -
      - - - - - - - - - - -
      TypeDescription
      float32-bit floating point value
      double64-bit floating point value
      fp128128-bit floating point value (112-bit mantissa)
      x86_fp8080-bit floating point value (X87)
      ppc_fp128128-bit floating point value (two 64-bits)
      - -
      - - -
      Void Type
      - -
      - -
      Overview:
      -

      The void type does not represent any value and has no size.

      - -
      Syntax:
      -
      -  void
-
      - -
      - - -
      Label Type
      - -
      - -
      Overview:
      -

      The label type represents code labels.

      - -
      Syntax:
      -
      -  label
-
      - -
      - - -
      Metadata Type
      - -
      - -
      Overview:
      -

      The metadata type represents embedded metadata. No derived types may be - created from metadata except for function - arguments. - -

      Syntax:
      -
      -  metadata
-
      - -
      - - - -
      Derived Types
      - -
      - -

      The real power in LLVM comes from the derived types in the system. This is - what allows a programmer to represent arrays, functions, pointers, and other - useful types. Each of these types contain one or more element types which - may be a primitive type, or another derived type. For example, it is - possible to have a two dimensional array, using an array as the element type - of another array.

      - - -
      - - -
      Aggregate Types
      - -
      - -

      Aggregate Types are a subset of derived types that can contain multiple - member types. Arrays, - structs, vectors and - unions are aggregate types.

      - -
      - -
      - - -
      Array Type
      - -
      - -
      Overview:
      -

      The array type is a very simple derived type that arranges elements - sequentially in memory. The array type requires a size (number of elements) - and an underlying data type.

      - -
      Syntax:
      -
      -  [<# elements> x <elementtype>]
-
      - -

      The number of elements is a constant integer value; elementtype may - be any type with a size.

      - -
      Examples:
      - - - - - - - - - - - - - -
      [40 x i32]Array of 40 32-bit integer values.
      [41 x i32]Array of 41 32-bit integer values.
      [4 x i8]Array of 4 8-bit integer values.
      -

      Here are some examples of multidimensional arrays:

      - - - - - - - - - - - - - -
      [3 x [4 x i32]]3x4 array of 32-bit integer values.
      [12 x [10 x float]]12x10 array of single precision floating point values.
      [2 x [3 x [4 x i16]]]2x3x4 array of 16-bit integer values.
      - -

      There is no restriction on indexing beyond the end of the array implied by - a static type (though there are restrictions on indexing beyond the bounds - of an allocated object in some cases). This means that single-dimension - 'variable sized array' addressing can be implemented in LLVM with a zero - length array type. An implementation of 'pascal style arrays' in LLVM could - use the type "{ i32, [0 x float]}", for example.

      - -
      - - -
      Function Type
      - -
      - -
      Overview:
      -

      The function type can be thought of as a function signature. It consists of - a return type and a list of formal parameter types. The return type of a - function type is a scalar type, a void type, a struct type, or a union - type. If the return type is a struct type then all struct elements must be - of first class types, and the struct must have at least one element.

      - -
      Syntax:
      -
      -  <returntype> (<parameter list>)
-
      - -

      ...where '<parameter list>' is a comma-separated list of type - specifiers. Optionally, the parameter list may include a type ..., - which indicates that the function takes a variable number of arguments. - Variable argument functions can access their arguments with - the variable argument handling intrinsic - functions. '<returntype>' is any type except - label.

      - -
      Examples:
      - - - - - - - - - - - - - - -
      i32 (i32)function taking an i32, returning an i32 -
      float (i16, i32 *) * - Pointer to a function that takes - an i16 and a pointer to i32, - returning float. -
      i32 (i8*, ...)A vararg function that takes at least one - pointer to i8 (char in C), - which returns an integer. This is the signature for printf in - LLVM. -
      {i32, i32} (i32)A function taking an i32, returning a - structure containing two i32 values -
      - -
      - - -
      Structure Type
      - -
      - -
      Overview:
      -

      The structure type is used to represent a collection of data members together - in memory. The packing of the field types is defined to match the ABI of the - underlying processor. The elements of a structure may be any type that has a - size.

      - -

      Structures in memory are accessed using 'load' - and 'store' by getting a pointer to a field - with the 'getelementptr' instruction. - Structures in registers are accessed using the - 'extractvalue' and - 'insertvalue' instructions.

      -
      Syntax:
      -
      -  { <type list> }
-
      - -
      Examples:
      - - - - - - - - -
      { i32, i32, i32 }A triple of three i32 values
      { float, i32 (i32) * }A pair, where the first element is a float and the - second element is a pointer to a - function that takes an i32, returning - an i32.
      - -
      - - -
      Packed Structure Type -
      - -
      - -
      Overview:
      -

      The packed structure type is used to represent a collection of data members - together in memory. There is no padding between fields. Further, the - alignment of a packed structure is 1 byte. The elements of a packed - structure may be any type that has a size.

      - -

      Structures are accessed using 'load and - 'store' by getting a pointer to a field with - the 'getelementptr' instruction.

      - -
      Syntax:
      -
      -  < { <type list> } >
-
      - -
      Examples:
      - - - - - - - - -
      < { i32, i32, i32 } >A triple of three i32 values
      -< { float, i32 (i32)* } >A pair, where the first element is a float and the - second element is a pointer to a - function that takes an i32, returning - an i32.
      - -
      - - -
      Union Type
      - -
      - -
      Overview:
      -

      A union type describes an object with size and alignment suitable for - an object of any one of a given set of types (also known as an "untagged" - union). It is similar in concept and usage to a - struct, except that all members of the union - have an offset of zero. The elements of a union may be any type that has a - size. Unions must have at least one member - empty unions are not allowed. -

      - -

      The size of the union as a whole will be the size of its largest member, - and the alignment requirements of the union as a whole will be the largest - alignment requirement of any member.

      - -

      Union members are accessed using 'load and - 'store' by getting a pointer to a field with - the 'getelementptr' instruction. - Since all members are at offset zero, the getelementptr instruction does - not affect the address, only the type of the resulting pointer.

      - -
      Syntax:
      -
      -  union { <type list> }
-
      - -
      Examples:
      - - - - - - - - -
      union { i32, i32*, float }A union of three types: an i32, a pointer to - an i32, and a float.
      - union { float, i32 (i32) * }A union, where the first element is a float and the - second element is a pointer to a - function that takes an i32, returning - an i32.
      - -
      - - -
      Pointer Type
      - -
      - -
      Overview:
      -

      The pointer type is used to specify memory locations. - Pointers are commonly used to reference objects in memory.

      - -

      Pointer types may have an optional address space attribute defining the - numbered address space where the pointed-to object resides. The default - address space is number zero. The semantics of non-zero address - spaces are target-specific.

      - -

      Note that LLVM does not permit pointers to void (void*) nor does it - permit pointers to labels (label*). Use i8* instead.

      - -
      Syntax:
      -
      -  <type> *
-
      - -
      Examples:
      - - - - - - - - - - - - - -
      [4 x i32]*A pointer to array of four i32 values.
      i32 (i32 *) * A pointer to a function that takes an i32*, returning an - i32.
      i32 addrspace(5)*A pointer to an i32 value - that resides in address space #5.
      - -
      - - -
      Vector Type
      - -
      - -
      Overview:
      -

      A vector type is a simple derived type that represents a vector of elements. - Vector types are used when multiple primitive data are operated in parallel - using a single instruction (SIMD). A vector type requires a size (number of - elements) and an underlying primitive data type. Vector types are considered - first class.

      - -
      Syntax:
      -
      -  < <# elements> x <elementtype> >
-
      - -

      The number of elements is a constant integer value; elementtype may be any - integer or floating point type.

      - -
      Examples:
      - - - - - - - - - - - - - -
      <4 x i32>Vector of 4 32-bit integer values.
      <8 x float>Vector of 8 32-bit floating-point values.
      <2 x i64>Vector of 2 64-bit integer values.
      - -
      - - -
      Opaque Type
      -
      - -
      Overview:
      -

      Opaque types are used to represent unknown types in the system. This - corresponds (for example) to the C notion of a forward declared structure - type. In LLVM, opaque types can eventually be resolved to any type (not just - a structure type).

      - -
      Syntax:
      -
      -  opaque
-
      - -
      Examples:
      - - - - - -
      opaqueAn opaque type.
      - -
      - - -
      - Type Up-references -
      - -
      - -
      Overview:
      -

      An "up reference" allows you to refer to a lexically enclosing type without - requiring it to have a name. For instance, a structure declaration may - contain a pointer to any of the types it is lexically a member of. Example - of up references (with their equivalent as named type declarations) - include:

      - -
      -   { \2 * }                %x = type { %x* }
-   { \2 }*                 %y = type { %y }*
-   \1*                     %z = type %z*
-
      - -

      An up reference is needed by the asmprinter for printing out cyclic types - when there is no declared name for a type in the cycle. Because the - asmprinter does not want to print out an infinite type string, it needs a - syntax to handle recursive types that have no names (all names are optional - in llvm IR).

      - -
      Syntax:
      -
      -   \<level>
-
      - -

      The level is the count of the lexical type that is being referred to.

      - -
      Examples:
      - - - - - - - - - -
      \1*Self-referential pointer.
      { { \3*, i8 }, i32 }Recursive structure where the upref refers to the out-most - structure.
      - -
      - - -
      Constants
      - - -
      - -

      LLVM has several different basic types of constants. This section describes - them all and their syntax.

      - -
      - - -
      Simple Constants
      - -
      - -
      -
      Boolean constants
      -
      The two strings 'true' and 'false' are both valid - constants of the i1 type.
      - -
      Integer constants
      -
      Standard integers (such as '4') are constants of - the integer type. Negative numbers may be used - with integer types.
      - -
      Floating point constants
      -
      Floating point constants use standard decimal notation (e.g. 123.421), - exponential notation (e.g. 1.23421e+2), or a more precise hexadecimal - notation (see below). The assembler requires the exact decimal value of a - floating-point constant. For example, the assembler accepts 1.25 but - rejects 1.3 because 1.3 is a repeating decimal in binary. Floating point - constants must have a floating point type.
      - -
      Null pointer constants
      -
      The identifier 'null' is recognized as a null pointer constant - and must be of pointer type.
      -
      - -

      The one non-intuitive notation for constants is the hexadecimal form of - floating point constants. For example, the form 'double - 0x432ff973cafa8000' is equivalent to (but harder to read than) - 'double 4.5e+15'. The only time hexadecimal floating point - constants are required (and the only time that they are generated by the - disassembler) is when a floating point constant must be emitted but it cannot - be represented as a decimal floating point number in a reasonable number of - digits. For example, NaN's, infinities, and other special values are - represented in their IEEE hexadecimal format so that assembly and disassembly - do not cause any bits to change in the constants.

      - -

      When using the hexadecimal form, constants of types float and double are - represented using the 16-digit form shown above (which matches the IEEE754 - representation for double); float values must, however, be exactly - representable as IEE754 single precision. Hexadecimal format is always used - for long double, and there are three forms of long double. The 80-bit format - used by x86 is represented as 0xK followed by 20 hexadecimal digits. - The 128-bit format used by PowerPC (two adjacent doubles) is represented - by 0xM followed by 32 hexadecimal digits. The IEEE 128-bit format - is represented by 0xL followed by 32 hexadecimal digits; no - currently supported target uses this format. Long doubles will only work if - they match the long double format on your target. All hexadecimal formats - are big-endian (sign bit at the left).

      - -
      - - -
      - -Complex Constants -
      - -
      - -

      Complex constants are a (potentially recursive) combination of simple - constants and smaller complex constants.

      - -
      -
      Structure constants
      -
      Structure constants are represented with notation similar to structure - type definitions (a comma separated list of elements, surrounded by braces - ({})). For example: "{ i32 4, float 17.0, i32* @G }", - where "@G" is declared as "@G = external global i32". - Structure constants must have structure type, and - the number and types of elements must match those specified by the - type.
      - -
      Union constants
      -
      Union constants are represented with notation similar to a structure with - a single element - that is, a single typed element surrounded - by braces ({})). For example: "{ i32 4 }". The - union type can be initialized with a single-element - struct as long as the type of the struct element matches the type of - one of the union members.
      - -
      Array constants
      -
      Array constants are represented with notation similar to array type - definitions (a comma separated list of elements, surrounded by square - brackets ([])). For example: "[ i32 42, i32 11, i32 74 - ]". Array constants must have array type, and - the number and types of elements must match those specified by the - type.
      - -
      Vector constants
      -
      Vector constants are represented with notation similar to vector type - definitions (a comma separated list of elements, surrounded by - less-than/greater-than's (<>)). For example: "< i32 - 42, i32 11, i32 74, i32 100 >". Vector constants must - have vector type, and the number and types of - elements must match those specified by the type.
      - -
      Zero initialization
      -
      The string 'zeroinitializer' can be used to zero initialize a - value to zero of any type, including scalar and - aggregate types. - This is often used to avoid having to print large zero initializers - (e.g. for large arrays) and is always exactly equivalent to using explicit - zero initializers.
      - -
      Metadata node
      -
      A metadata node is a structure-like constant with - metadata type. For example: "metadata !{ - i32 0, metadata !"test" }". Unlike other constants that are meant to - be interpreted as part of the instruction stream, metadata is a place to - attach additional information such as debug info.
      -
      - -
      - - -
      - Global Variable and Function Addresses -
      - -
      - -

      The addresses of global variables - and functions are always implicitly valid - (link-time) constants. These constants are explicitly referenced when - the identifier for the global is used and always - have pointer type. For example, the following is a - legal LLVM file:

      - -
      -
      - at X = global i32 17
- at Y = global i32 42
- at Z = global [2 x i32*] [ i32* @X, i32* @Y ]
-
      -
      - -
      - - -
      Undefined Values
      -
      - -

      The string 'undef' can be used anywhere a constant is expected, and - indicates that the user of the value may receive an unspecified bit-pattern. - Undefined values may be of any type (other than label or void) and be used - anywhere a constant is permitted.

      - -

      Undefined values are useful because they indicate to the compiler that the - program is well defined no matter what value is used. This gives the - compiler more freedom to optimize. Here are some examples of (potentially - surprising) transformations that are valid (in pseudo IR):

      - - -
      -
      -  %A = add %X, undef
-  %B = sub %X, undef
-  %C = xor %X, undef
-Safe:
-  %A = undef
-  %B = undef
-  %C = undef
-
      -
      - -

      This is safe because all of the output bits are affected by the undef bits. -Any output bit can have a zero or one depending on the input bits.

      - -
      -
      -  %A = or %X, undef
-  %B = and %X, undef
-Safe:
-  %A = -1
-  %B = 0
-Unsafe:
-  %A = undef
-  %B = undef
-
      -
      - -

      These logical operations have bits that are not always affected by the input. -For example, if "%X" has a zero bit, then the output of the 'and' operation will -always be a zero, no matter what the corresponding bit from the undef is. As -such, it is unsafe to optimize or assume that the result of the and is undef. -However, it is safe to assume that all bits of the undef could be 0, and -optimize the and to 0. Likewise, it is safe to assume that all the bits of -the undef operand to the or could be set, allowing the or to be folded to --1.

      - -
      -
      -  %A = select undef, %X, %Y
-  %B = select undef, 42, %Y
-  %C = select %X, %Y, undef
-Safe:
-  %A = %X     (or %Y)
-  %B = 42     (or %Y)
-  %C = %Y
-Unsafe:
-  %A = undef
-  %B = undef
-  %C = undef
-
      -
      - -

      This set of examples show that undefined select (and conditional branch) -conditions can go "either way" but they have to come from one of the two -operands. In the %A example, if %X and %Y were both known to have a clear low -bit, then %A would have to have a cleared low bit. However, in the %C example, -the optimizer is allowed to assume that the undef operand could be the same as -%Y, allowing the whole select to be eliminated.

      - - -
      -
      -  %A = xor undef, undef
-
-  %B = undef
-  %C = xor %B, %B
-
-  %D = undef
-  %E = icmp lt %D, 4
-  %F = icmp gte %D, 4
-
-Safe:
-  %A = undef
-  %B = undef
-  %C = undef
-  %D = undef
-  %E = undef
-  %F = undef
-
      -
      - -

      This example points out that two undef operands are not necessarily the same. -This can be surprising to people (and also matches C semantics) where they -assume that "X^X" is always zero, even if X is undef. This isn't true for a -number of reasons, but the short answer is that an undef "variable" can -arbitrarily change its value over its "live range". This is true because the -"variable" doesn't actually have a live range. Instead, the value is -logically read from arbitrary registers that happen to be around when needed, -so the value is not necessarily consistent over time. In fact, %A and %C need -to have the same semantics or the core LLVM "replace all uses with" concept -would not hold.

      - -
      -
      -  %A = fdiv undef, %X
-  %B = fdiv %X, undef
-Safe:
-  %A = undef
-b: unreachable
-
      -
      - -

      These examples show the crucial difference between an undefined -value and undefined behavior. An undefined value (like undef) is -allowed to have an arbitrary bit-pattern. This means that the %A operation -can be constant folded to undef because the undef could be an SNaN, and fdiv is -not (currently) defined on SNaN's. However, in the second example, we can make -a more aggressive assumption: because the undef is allowed to be an arbitrary -value, we are allowed to assume that it could be zero. Since a divide by zero -has undefined behavior, we are allowed to assume that the operation -does not execute at all. This allows us to delete the divide and all code after -it: since the undefined operation "can't happen", the optimizer can assume that -it occurs in dead code. -

      - -
      -
      -a:  store undef -> %X
-b:  store %X -> undef
-Safe:
-a: <deleted>
-b: unreachable
-
      -
      - -

      These examples reiterate the fdiv example: a store "of" an undefined value -can be assumed to not have any effect: we can assume that the value is -overwritten with bits that happen to match what was already there. However, a -store "to" an undefined location could clobber arbitrary memory, therefore, it -has undefined behavior.

      - -
      - - -
      Trap Values
      -
      - -

      Trap values are similar to undef values, however - instead of representing an unspecified bit pattern, they represent the - fact that an instruction or constant expression which cannot evoke side - effects has nevertheless detected a condition which results in undefined - behavior.

      - -

      There is currently no way of representing a trap value in the IR; they - only exist when produced by operations such as - add with the nsw flag.

      - -

      Trap value behavior is defined in terms of value dependence:

      - -

      -

        -
      • Values other than phi nodes depend on - their operands.
        • - -
      • Phi nodes depend on the operand corresponding - to their dynamic predecessor basic block.
        • - -
      • Function arguments depend on the corresponding actual argument values in - the dynamic callers of their functions.
        • - -
      • Call instructions depend on the - ret instructions that dynamically transfer - control back to them.
        • - -
      • Invoke instructions depend on the - ret, unwind, - or exception-throwing call instructions that dynamically transfer control - back to them.
        • - -
      • Non-volatile loads and stores depend on the most recent stores to all of the - referenced memory addresses, following the order in the IR - (including loads and stores implied by intrinsics such as - @llvm.memcpy.)
        • - - - - - -
      • An instruction with externally visible side effects depends on the most - recent preceding instruction with externally visible side effects, following - the order in the IR. (This includes volatile loads and stores.)
        • - -
      • An instruction control-depends on a - terminator instruction - if the terminator instruction has multiple successors and the instruction - is always executed when control transfers to one of the successors, and - may not be executed when control is transfered to another.
        • - -
      • Dependence is transitive.
        • - -
      -

      - -

      Whenever a trap value is generated, all values which depend on it evaluate - to trap. If they have side effects, the evoke their side effects as if each - operand with a trap value were undef. If they have externally-visible side - effects, the behavior is undefined.

      - -

      Here are some examples:

      - -
      -
      -entry:
-  %trap = sub nuw i32 0, 1           ; Results in a trap value.
-  %still_trap = and i32 %trap, 0     ; Whereas (and i32 undef, 0) would return 0.
-  %trap_yet_again = getelementptr i32* @h, i32 %still_trap
-  store i32 0, i32* %trap_yet_again  ; undefined behavior
-
-  store i32 %trap, i32* @g           ; Trap value conceptually stored to memory.
-  %trap2 = load i32* @g              ; Returns a trap value, not just undef.
-
-  volatile store i32 %trap, i32* @g  ; External observation; undefined behavior.
-
-  %narrowaddr = bitcast i32* @g to i16*
-  %wideaddr = bitcast i32* @g to i64*
-  %trap3 = load 16* %narrowaddr      ; Returns a trap value.
-  %trap4 = load i64* %widaddr        ; Returns a trap value.
-
-  %cmp = icmp i32 slt %trap, 0       ; Returns a trap value.
-  %br i1 %cmp, %true, %end           ; Branch to either destination.
-
-true:
-  volatile store i32 0, i32* @g      ; This is control-dependent on %cmp, so
-                                     ; it has undefined behavior.
-  br label %end
-
-end:
-  %p = phi i32 [ 0, %entry ], [ 1, %true ]
-                                     ; Both edges into this PHI are
-                                     ; control-dependent on %cmp, so this
-                                     ; always results in a trap value.
-
-  volatile store i32 0, i32* @g      ; %end is control-equivalent to %entry
-                                     ; so this is defined (ignoring earlier
-                                     ; undefined behavior in this example).
-
      -
      - -
      - - -
      Addresses of Basic - Blocks
      -
      - -

      blockaddress(@function, %block)

      - -

      The 'blockaddress' constant computes the address of the specified - basic block in the specified function, and always has an i8* type. Taking - the address of the entry block is illegal.

      - -

      This value only has defined behavior when used as an operand to the - 'indirectbr' instruction or for comparisons - against null. Pointer equality tests between labels addresses is undefined - behavior - though, again, comparison against null is ok, and no label is - equal to the null pointer. This may also be passed around as an opaque - pointer sized value as long as the bits are not inspected. This allows - ptrtoint and arithmetic to be performed on these values so long as - the original value is reconstituted before the indirectbr.

      - -

      Finally, some targets may provide defined semantics when - using the value as the operand to an inline assembly, but that is target - specific. -

      - -
      - - - -
      Constant Expressions -
      - -
      - -

      Constant expressions are used to allow expressions involving other constants - to be used as constants. Constant expressions may be of - any first class type and may involve any LLVM - operation that does not have side effects (e.g. load and call are not - supported). The following is the syntax for constant expressions:

      - -
      -
      trunc ( CST to TYPE )
      -
      Truncate a constant to another type. The bit size of CST must be larger - than the bit size of TYPE. Both types must be integers.
      - -
      zext ( CST to TYPE )
      -
      Zero extend a constant to another type. The bit size of CST must be - smaller or equal to the bit size of TYPE. Both types must be - integers.
      - -
      sext ( CST to TYPE )
      -
      Sign extend a constant to another type. The bit size of CST must be - smaller or equal to the bit size of TYPE. Both types must be - integers.
      - -
      fptrunc ( CST to TYPE )
      -
      Truncate a floating point constant to another floating point type. The - size of CST must be larger than the size of TYPE. Both types must be - floating point.
      - -
      fpext ( CST to TYPE )
      -
      Floating point extend a constant to another type. The size of CST must be - smaller or equal to the size of TYPE. Both types must be floating - point.
      - -
      fptoui ( CST to TYPE )
      -
      Convert a floating point constant to the corresponding unsigned integer - constant. TYPE must be a scalar or vector integer type. CST must be of - scalar or vector floating point type. Both CST and TYPE must be scalars, - or vectors of the same number of elements. If the value won't fit in the - integer type, the results are undefined.
      - -
      fptosi ( CST to TYPE )
      -
      Convert a floating point constant to the corresponding signed integer - constant. TYPE must be a scalar or vector integer type. CST must be of - scalar or vector floating point type. Both CST and TYPE must be scalars, - or vectors of the same number of elements. If the value won't fit in the - integer type, the results are undefined.
      - -
      uitofp ( CST to TYPE )
      -
      Convert an unsigned integer constant to the corresponding floating point - constant. TYPE must be a scalar or vector floating point type. CST must be - of scalar or vector integer type. Both CST and TYPE must be scalars, or - vectors of the same number of elements. If the value won't fit in the - floating point type, the results are undefined.
      - -
      sitofp ( CST to TYPE )
      -
      Convert a signed integer constant to the corresponding floating point - constant. TYPE must be a scalar or vector floating point type. CST must be - of scalar or vector integer type. Both CST and TYPE must be scalars, or - vectors of the same number of elements. If the value won't fit in the - floating point type, the results are undefined.
      - -
      ptrtoint ( CST to TYPE )
      -
      Convert a pointer typed constant to the corresponding integer constant - TYPE must be an integer type. CST must be of pointer - type. The CST value is zero extended, truncated, or unchanged to - make it fit in TYPE.
      - -
      inttoptr ( CST to TYPE )
      -
      Convert a integer constant to a pointer constant. TYPE must be a pointer - type. CST must be of integer type. The CST value is zero extended, - truncated, or unchanged to make it fit in a pointer size. This one is - really dangerous!
      - -
      bitcast ( CST to TYPE )
      -
      Convert a constant, CST, to another TYPE. The constraints of the operands - are the same as those for the bitcast - instruction.
      - -
      getelementptr ( CSTPTR, IDX0, IDX1, ... )
      -
      getelementptr inbounds ( CSTPTR, IDX0, IDX1, ... )
      -
      Perform the getelementptr operation on - constants. As with the getelementptr - instruction, the index list may have zero or more indexes, which are - required to make sense for the type of "CSTPTR".
      - -
      select ( COND, VAL1, VAL2 )
      -
      Perform the select operation on constants.
      - -
      icmp COND ( VAL1, VAL2 )
      -
      Performs the icmp operation on constants.
      - -
      fcmp COND ( VAL1, VAL2 )
      -
      Performs the fcmp operation on constants.
      - -
      extractelement ( VAL, IDX )
      -
      Perform the extractelement operation on - constants.
      - -
      insertelement ( VAL, ELT, IDX )
      -
      Perform the insertelement operation on - constants.
      - -
      shufflevector ( VEC1, VEC2, IDXMASK )
      -
      Perform the shufflevector operation on - constants.
      - -
      OPCODE ( LHS, RHS )
      -
      Perform the specified operation of the LHS and RHS constants. OPCODE may - be any of the binary - or bitwise binary operations. The constraints - on operands are the same as those for the corresponding instruction - (e.g. no bitwise operations on floating point values are allowed).
      -
      - -
      - - -
      Other Values
      - - - -
      -Inline Assembler Expressions -
      - -
      - -

      LLVM supports inline assembler expressions (as opposed - to Module-Level Inline Assembly) through the use of - a special value. This value represents the inline assembler as a string - (containing the instructions to emit), a list of operand constraints (stored - as a string), a flag that indicates whether or not the inline asm - expression has side effects, and a flag indicating whether the function - containing the asm needs to align its stack conservatively. An example - inline assembler expression is:

      - -
      -
      -i32 (i32) asm "bswap $0", "=r,r"
-
      -
      - -

      Inline assembler expressions may only be used as the callee operand of - a call instruction. Thus, typically we - have:

      - -
      -
      -%X = call i32 asm "bswap $0", "=r,r"(i32 %Y)
-
      -
      - -

      Inline asms with side effects not visible in the constraint list must be - marked as having side effects. This is done through the use of the - 'sideeffect' keyword, like so:

      - -
      -
      -call void asm sideeffect "eieio", ""()
-
      -
      - -

      In some cases inline asms will contain code that will not work unless the - stack is aligned in some way, such as calls or SSE instructions on x86, - yet will not contain code that does that alignment within the asm. - The compiler should make conservative assumptions about what the asm might - contain and should generate its usual stack alignment code in the prologue - if the 'alignstack' keyword is present:

      - -
      -
      -call void asm alignstack "eieio", ""()
-
      -
      - -

      If both keywords appear the 'sideeffect' keyword must come - first.

      - -

      TODO: The format of the asm and constraints string still need to be - documented here. Constraints on what can be done (e.g. duplication, moving, - etc need to be documented). This is probably best done by reference to - another document that covers inline asm from a holistic perspective.

      -
      - -
      -Inline Asm Metadata -
      - -
      - -

      The call instructions that wrap inline asm nodes may have a "!srcloc" MDNode - attached to it that contains a constant integer. If present, the code - generator will use the integer as the location cookie value when report - errors through the LLVMContext error reporting mechanisms. This allows a - front-end to correlate backend errors that occur with inline asm back to the - source code that produced it. For example:

      - -
      -
      -call void asm sideeffect "something bad", ""(), !srcloc !42
-...
-!42 = !{ i32 1234567 }
-
      -
      - -

      It is up to the front-end to make sense of the magic numbers it places in the - IR.

      - -
      - - -
      Metadata Nodes and Metadata - Strings -
      - -
      - -

      LLVM IR allows metadata to be attached to instructions in the program that - can convey extra information about the code to the optimizers and code - generator. One example application of metadata is source-level debug - information. There are two metadata primitives: strings and nodes. All - metadata has the metadata type and is identified in syntax by a - preceding exclamation point ('!').

      - -

      A metadata string is a string surrounded by double quotes. It can contain - any character by escaping non-printable characters with "\xx" where "xx" is - the two digit hex code. For example: "!"test\00"".

      - -

      Metadata nodes are represented with notation similar to structure constants - (a comma separated list of elements, surrounded by braces and preceded by an - exclamation point). For example: "!{ metadata !"test\00", i32 - 10}". Metadata nodes can have any values as their operand.

      - -

      A named metadata is a collection of - metadata nodes, which can be looked up in the module symbol table. For - example: "!foo = metadata !{!4, !3}". - -

      Metadata can be used as function arguments. Here llvm.dbg.value - function is using two metadata arguments. - -

      - 
      -       call void @llvm.dbg.value(metadata !24, i64 0, metadata !25)
-
      -

      - -

      Metadata can be attached with an instruction. Here metadata !21 is - attached with add instruction using !dbg identifier. - -

      - 
      -      %indvar.next = add i64 %indvar, 1, !dbg !21
-
      -

      -
      - - - -
      - Intrinsic Global Variables -
      - - -

      LLVM has a number of "magic" global variables that contain data that affect -code generation or other IR semantics. These are documented here. All globals -of this sort should have a section specified as "llvm.metadata". This -section and all globals that start with "llvm." are reserved for use -by LLVM.

      - - -
      -The 'llvm.used' Global Variable -
      - -
      - -

      The @llvm.used global is an array with i8* element type which has appending linkage. This array contains a list of -pointers to global variables and functions which may optionally have a pointer -cast formed of bitcast or getelementptr. For example, a legal use of it is:

      - -
      -  @X = global i8 4
-  @Y = global i32 123
-
-  @llvm.used = appending global [2 x i8*] [
-     i8* @X,
-     i8* bitcast (i32* @Y to i8*)
-  ], section "llvm.metadata"
-
      - -

      If a global variable appears in the @llvm.used list, then the -compiler, assembler, and linker are required to treat the symbol as if there is -a reference to the global that it cannot see. For example, if a variable has -internal linkage and no references other than that from the @llvm.used -list, it cannot be deleted. This is commonly used to represent references from -inline asms and other things the compiler cannot "see", and corresponds to -"attribute((used))" in GNU C.

      - -

      On some targets, the code generator must emit a directive to the assembler or -object file to prevent the assembler and linker from molesting the symbol.

      - -
      - - -
      -The 'llvm.compiler.used' Global Variable -
      - -
      - -

      The @llvm.compiler.used directive is the same as the -@llvm.used directive, except that it only prevents the compiler from -touching the symbol. On targets that support it, this allows an intelligent -linker to optimize references to the symbol without being impeded as it would be -by @llvm.used.

      - -

      This is a rare construct that should only be used in rare circumstances, and -should not be exposed to source languages.

      - -
      - - -
      -The 'llvm.global_ctors' Global Variable -
      - -
      -
      -%0 = type { i32, void ()* }
- at llvm.global_ctors = appending global [1 x %0] [%0 { i32 65535, void ()* @ctor }]
-
      -

      The @llvm.global_ctors array contains a list of constructor functions and associated priorities. The functions referenced by this array will be called in ascending order of priority (i.e. lowest first) when the module is loaded. The order of functions with the same priority is not defined. -

      - -
      - - -
      -The 'llvm.global_dtors' Global Variable -
      - -
      -
      -%0 = type { i32, void ()* }
- at llvm.global_dtors = appending global [1 x %0] [%0 { i32 65535, void ()* @dtor }]
-
      - -

      The @llvm.global_dtors array contains a list of destructor functions and associated priorities. The functions referenced by this array will be called in descending order of priority (i.e. highest first) when the module is loaded. The order of functions with the same priority is not defined. -

      - -
      - - - -
      Instruction Reference
      - - -
      - -

      The LLVM instruction set consists of several different classifications of - instructions: terminator - instructions, binary instructions, - bitwise binary instructions, - memory instructions, and - other instructions.

      - -
      - - -
      Terminator -Instructions
      - -
      - -

      As mentioned previously, every basic block - in a program ends with a "Terminator" instruction, which indicates which - block should be executed after the current block is finished. These - terminator instructions typically yield a 'void' value: they produce - control flow, not values (the one exception being the - 'invoke' instruction).

      - -

      There are seven different terminator instructions: the - 'ret' instruction, the - 'br' instruction, the - 'switch' instruction, the - ''indirectbr' Instruction, the - 'invoke' instruction, the - 'unwind' instruction, and the - 'unreachable' instruction.

      - -
      - - -
      'ret' -Instruction
      - -
      - -
      Syntax:
      -
      -  ret <type> <value>       ; Return a value from a non-void function
-  ret void                 ; Return from void function
-
      - -
      Overview:
      -

      The 'ret' instruction is used to return control flow (and optionally - a value) from a function back to the caller.

      - -

      There are two forms of the 'ret' instruction: one that returns a - value and then causes control flow, and one that just causes control flow to - occur.

      - -
      Arguments:
      -

      The 'ret' instruction optionally accepts a single argument, the - return value. The type of the return value must be a - 'first class' type.

      - -

      A function is not well formed if it it has a - non-void return type and contains a 'ret' instruction with no return - value or a return value with a type that does not match its type, or if it - has a void return type and contains a 'ret' instruction with a - return value.

      - -
      Semantics:
      -

      When the 'ret' instruction is executed, control flow returns back to - the calling function's context. If the caller is a - "call" instruction, execution continues at the - instruction after the call. If the caller was an - "invoke" instruction, execution continues at - the beginning of the "normal" destination block. If the instruction returns - a value, that value shall set the call or invoke instruction's return - value.

      - -
      Example:
      -
      -  ret i32 5                       ; Return an integer value of 5
-  ret void                        ; Return from a void function
-  ret { i32, i8 } { i32 4, i8 2 } ; Return a struct of values 4 and 2
-
      - -
      - -
      'br' Instruction
      - -
      - -
      Syntax:
      -
      -  br i1 <cond>, label <iftrue>, label <iffalse>
        br label <dest>          ; Unconditional branch
-
      - -
      Overview:
      -

      The 'br' instruction is used to cause control flow to transfer to a - different basic block in the current function. There are two forms of this - instruction, corresponding to a conditional branch and an unconditional - branch.

      - -
      Arguments:
      -

      The conditional branch form of the 'br' instruction takes a single - 'i1' value and two 'label' values. The unconditional form - of the 'br' instruction takes a single 'label' value as a - target.

      - -
      Semantics:
      -

      Upon execution of a conditional 'br' instruction, the 'i1' - argument is evaluated. If the value is true, control flows to the - 'iftrue' label argument. If "cond" is false, - control flows to the 'iffalse' label argument.

      - -
      Example:
      -
      -Test:
-  %cond = icmp eq i32 %a, %b
-  br i1 %cond, label %IfEqual, label %IfUnequal
-IfEqual:
-  ret i32 1
-IfUnequal:
-  ret i32 0
-
      - -
      - - -
      - 'switch' Instruction -
      - -
      - -
      Syntax:
      -
      -  switch <intty> <value>, label <defaultdest> [ <intty> <val>, label <dest> ... ]
-
      - -
      Overview:
      -

      The 'switch' instruction is used to transfer control flow to one of - several different places. It is a generalization of the 'br' - instruction, allowing a branch to occur to one of many possible - destinations.

      - -
      Arguments:
      -

      The 'switch' instruction uses three parameters: an integer - comparison value 'value', a default 'label' destination, - and an array of pairs of comparison value constants and 'label's. - The table is not allowed to contain duplicate constant entries.

      - -
      Semantics:
      -

      The switch instruction specifies a table of values and - destinations. When the 'switch' instruction is executed, this table - is searched for the given value. If the value is found, control flow is - transferred to the corresponding destination; otherwise, control flow is - transferred to the default destination.

      - -
      Implementation:
      -

      Depending on properties of the target machine and the particular - switch instruction, this instruction may be code generated in - different ways. For example, it could be generated as a series of chained - conditional branches or with a lookup table.

      - -
      Example:
      -
      - ; Emulate a conditional br instruction
- %Val = zext i1 %value to i32
- switch i32 %Val, label %truedest [ i32 0, label %falsedest ]
-
- ; Emulate an unconditional br instruction
- switch i32 0, label %dest [ ]
-
- ; Implement a jump table:
- switch i32 %val, label %otherwise [ i32 0, label %onzero
-                                     i32 1, label %onone
-                                     i32 2, label %ontwo ]
-
      - -
      - - - -
      - 'indirectbr' Instruction -
      - -
      - -
      Syntax:
      -
      -  indirectbr <somety>* <address>, [ label <dest1>, label <dest2>, ... ]
-
      - -
      Overview:
      - -

      The 'indirectbr' instruction implements an indirect branch to a label - within the current function, whose address is specified by - "address". Address must be derived from a blockaddress constant.

      - -
      Arguments:
      - -

      The 'address' argument is the address of the label to jump to. The - rest of the arguments indicate the full set of possible destinations that the - address may point to. Blocks are allowed to occur multiple times in the - destination list, though this isn't particularly useful.

      - -

      This destination list is required so that dataflow analysis has an accurate - understanding of the CFG.

      - -
      Semantics:
      - -

      Control transfers to the block specified in the address argument. All - possible destination blocks must be listed in the label list, otherwise this - instruction has undefined behavior. This implies that jumps to labels - defined in other functions have undefined behavior as well.

      - -
      Implementation:
      - -

      This is typically implemented with a jump through a register.

      - -
      Example:
      -
      - indirectbr i8* %Addr, [ label %bb1, label %bb2, label %bb3 ]
-
      - -
      - - - -
      - 'invoke' Instruction -
      - -
      - -
      Syntax:
      -
      -  <result> = invoke [cconv] [ret attrs] <ptr to function ty> <function ptr val>(<function args>) [fn attrs]
-                to label <normal label> unwind label <exception label>
-
      - -
      Overview:
      -

      The 'invoke' instruction causes control to transfer to a specified - function, with the possibility of control flow transfer to either the - 'normal' label or the 'exception' label. If the callee - function returns with the "ret" instruction, - control flow will return to the "normal" label. If the callee (or any - indirect callees) returns with the "unwind" - instruction, control is interrupted and continued at the dynamically nearest - "exception" label.

      - -
      Arguments:
      -

      This instruction requires several arguments:

      - -
        -
      1. The optional "cconv" marker indicates which calling - convention the call should use. If none is specified, the call - defaults to using C calling conventions.
        2. - -
      2. The optional Parameter Attributes list for - return values. Only 'zeroext', 'signext', and - 'inreg' attributes are valid here.
        3. - -
      3. 'ptr to function ty': shall be the signature of the pointer to - function value being invoked. In most cases, this is a direct function - invocation, but indirect invokes are just as possible, branching - off an arbitrary pointer to function value.
        4. - -
      4. 'function ptr val': An LLVM value containing a pointer to a - function to be invoked.
        5. - -
      5. 'function args': argument list whose types match the function - signature argument types and parameter attributes. All arguments must be - of first class type. If the function - signature indicates the function accepts a variable number of arguments, - the extra arguments can be specified.
        6. - -
      6. 'normal label': the label reached when the called function - executes a 'ret' instruction.
        7. - -
      7. 'exception label': the label reached when a callee returns with - the unwind instruction.
        8. - -
      8. The optional function attributes list. Only - 'noreturn', 'nounwind', 'readonly' and - 'readnone' attributes are valid here.
        9. -
      - -
      Semantics:
      -

      This instruction is designed to operate as a standard - 'call' instruction in most regards. The - primary difference is that it establishes an association with a label, which - is used by the runtime library to unwind the stack.

      - -

      This instruction is used in languages with destructors to ensure that proper - cleanup is performed in the case of either a longjmp or a thrown - exception. Additionally, this is important for implementation of - 'catch' clauses in high-level languages that support them.

      - -

      For the purposes of the SSA form, the definition of the value returned by the - 'invoke' instruction is deemed to occur on the edge from the current - block to the "normal" label. If the callee unwinds then no return value is - available.

      - -

      Note that the code generator does not yet completely support unwind, and -that the invoke/unwind semantics are likely to change in future versions.

      - -
      Example:
      -
      -  %retval = invoke i32 @Test(i32 15) to label %Continue
-              unwind label %TestCleanup              ; {i32}:retval set
-  %retval = invoke coldcc i32 %Testfnptr(i32 15) to label %Continue
-              unwind label %TestCleanup              ; {i32}:retval set
-
      - -
      - - - -
      'unwind' -Instruction
      - -
      - -
      Syntax:
      -
      -  unwind
-
      - -
      Overview:
      -

      The 'unwind' instruction unwinds the stack, continuing control flow - at the first callee in the dynamic call stack which used - an invoke instruction to perform the call. - This is primarily used to implement exception handling.

      - -
      Semantics:
      -

      The 'unwind' instruction causes execution of the current function to - immediately halt. The dynamic call stack is then searched for the - first invoke instruction on the call stack. - Once found, execution continues at the "exceptional" destination block - specified by the invoke instruction. If there is no invoke - instruction in the dynamic call chain, undefined behavior results.

      - -

      Note that the code generator does not yet completely support unwind, and -that the invoke/unwind semantics are likely to change in future versions.

      - -
      - - - -
      'unreachable' -Instruction
      - -
      - -
      Syntax:
      -
      -  unreachable
-
      - -
      Overview:
      -

      The 'unreachable' instruction has no defined semantics. This - instruction is used to inform the optimizer that a particular portion of the - code is not reachable. This can be used to indicate that the code after a - no-return function cannot be reached, and other facts.

      - -
      Semantics:
      -

      The 'unreachable' instruction has no defined semantics.

      - -
      - - -
      Binary Operations
      - -
      - -

      Binary operators are used to do most of the computation in a program. They - require two operands of the same type, execute an operation on them, and - produce a single value. The operands might represent multiple data, as is - the case with the vector data type. The result value - has the same type as its operands.

      - -

      There are several different binary operators:

      - -
      - - -
      - 'add' Instruction -
      - -
      - -
      Syntax:
      -
      -  <result> = add <ty> <op1>, <op2>          ; yields {ty}:result
-  <result> = add nuw <ty> <op1>, <op2>      ; yields {ty}:result
-  <result> = add nsw <ty> <op1>, <op2>      ; yields {ty}:result
-  <result> = add nuw nsw <ty> <op1>, <op2>  ; yields {ty}:result
-
      - -
      Overview:
      -

      The 'add' instruction returns the sum of its two operands.

      - -
      Arguments:
      -

      The two arguments to the 'add' instruction must - be integer or vector of - integer values. Both arguments must have identical types.

      - -
      Semantics:
      -

      The value produced is the integer sum of the two operands.

      - -

      If the sum has unsigned overflow, the result returned is the mathematical - result modulo 2n, where n is the bit width of the result.

      - -

      Because LLVM integers use a two's complement representation, this instruction - is appropriate for both signed and unsigned integers.

      - -

      nuw and nsw stand for "No Unsigned Wrap" - and "No Signed Wrap", respectively. If the nuw and/or - nsw keywords are present, the result value of the add - is a trap value if unsigned and/or signed overflow, - respectively, occurs.

      - -
      Example:
      -
      -  <result> = add i32 4, %var          ; yields {i32}:result = 4 + %var
-
      - -
      - - -
      - 'fadd' Instruction -
      - -
      - -
      Syntax:
      -
      -  <result> = fadd <ty> <op1>, <op2>   ; yields {ty}:result
-
      - -
      Overview:
      -

      The 'fadd' instruction returns the sum of its two operands.

      - -
      Arguments:
      -

      The two arguments to the 'fadd' instruction must be - floating point or vector of - floating point values. Both arguments must have identical types.

      - -
      Semantics:
      -

      The value produced is the floating point sum of the two operands.

      - -
      Example:
      -
      -  <result> = fadd float 4.0, %var          ; yields {float}:result = 4.0 + %var
-
      - -
      - - -
      - 'sub' Instruction -
      - -
      - -
      Syntax:
      -
      -  <result> = sub <ty> <op1>, <op2>          ; yields {ty}:result
-  <result> = sub nuw <ty> <op1>, <op2>      ; yields {ty}:result
-  <result> = sub nsw <ty> <op1>, <op2>      ; yields {ty}:result
-  <result> = sub nuw nsw <ty> <op1>, <op2>  ; yields {ty}:result
-
      - -
      Overview:
      -

      The 'sub' instruction returns the difference of its two - operands.

      - -

      Note that the 'sub' instruction is used to represent the - 'neg' instruction present in most other intermediate - representations.

      - -
      Arguments:
      -

      The two arguments to the 'sub' instruction must - be integer or vector of - integer values. Both arguments must have identical types.

      - -
      Semantics:
      -

      The value produced is the integer difference of the two operands.

      - -

      If the difference has unsigned overflow, the result returned is the - mathematical result modulo 2n, where n is the bit width of the - result.

      - -

      Because LLVM integers use a two's complement representation, this instruction - is appropriate for both signed and unsigned integers.

      - -

      nuw and nsw stand for "No Unsigned Wrap" - and "No Signed Wrap", respectively. If the nuw and/or - nsw keywords are present, the result value of the sub - is a trap value if unsigned and/or signed overflow, - respectively, occurs.

      - -
      Example:
      -
      -  <result> = sub i32 4, %var          ; yields {i32}:result = 4 - %var
-  <result> = sub i32 0, %val          ; yields {i32}:result = -%var
-
      - -
      - - -
      - 'fsub' Instruction -
      - -
      - -
      Syntax:
      -
      -  <result> = fsub <ty> <op1>, <op2>   ; yields {ty}:result
-
      - -
      Overview:
      -

      The 'fsub' instruction returns the difference of its two - operands.

      - -

      Note that the 'fsub' instruction is used to represent the - 'fneg' instruction present in most other intermediate - representations.

      - -
      Arguments:
      -

      The two arguments to the 'fsub' instruction must be - floating point or vector of - floating point values. Both arguments must have identical types.

      - -
      Semantics:
      -

      The value produced is the floating point difference of the two operands.

      - -
      Example:
      -
      -  <result> = fsub float 4.0, %var           ; yields {float}:result = 4.0 - %var
-  <result> = fsub float -0.0, %val          ; yields {float}:result = -%var
-
      - -
      - - -
      - 'mul' Instruction -
      - -
      - -
      Syntax:
      -
      -  <result> = mul <ty> <op1>, <op2>          ; yields {ty}:result
-  <result> = mul nuw <ty> <op1>, <op2>      ; yields {ty}:result
-  <result> = mul nsw <ty> <op1>, <op2>      ; yields {ty}:result
-  <result> = mul nuw nsw <ty> <op1>, <op2>  ; yields {ty}:result
-
      - -
      Overview:
      -

      The 'mul' instruction returns the product of its two operands.

      - -
      Arguments:
      -

      The two arguments to the 'mul' instruction must - be integer or vector of - integer values. Both arguments must have identical types.

      - -
      Semantics:
      -

      The value produced is the integer product of the two operands.

      - -

      If the result of the multiplication has unsigned overflow, the result - returned is the mathematical result modulo 2n, where n is the bit - width of the result.

      - -

      Because LLVM integers use a two's complement representation, and the result - is the same width as the operands, this instruction returns the correct - result for both signed and unsigned integers. If a full product - (e.g. i32xi32->i64) is needed, the operands should - be sign-extended or zero-extended as appropriate to the width of the full - product.

      - -

      nuw and nsw stand for "No Unsigned Wrap" - and "No Signed Wrap", respectively. If the nuw and/or - nsw keywords are present, the result value of the mul - is a trap value if unsigned and/or signed overflow, - respectively, occurs.

      - -
      Example:
      -
      -  <result> = mul i32 4, %var          ; yields {i32}:result = 4 * %var
-
      - -
      - - -
      - 'fmul' Instruction -
      - -
      - -
      Syntax:
      -
      -  <result> = fmul <ty> <op1>, <op2>   ; yields {ty}:result
-
      - -
      Overview:
      -

      The 'fmul' instruction returns the product of its two operands.

      - -
      Arguments:
      -

      The two arguments to the 'fmul' instruction must be - floating point or vector of - floating point values. Both arguments must have identical types.

      - -
      Semantics:
      -

      The value produced is the floating point product of the two operands.

      - -
      Example:
      -
      -  <result> = fmul float 4.0, %var          ; yields {float}:result = 4.0 * %var
-
      - -
      - - -
      'udiv' Instruction -
      - -
      - -
      Syntax:
      -
      -  <result> = udiv <ty> <op1>, <op2>   ; yields {ty}:result
-
      - -
      Overview:
      -

      The 'udiv' instruction returns the quotient of its two operands.

      - -
      Arguments:
      -

      The two arguments to the 'udiv' instruction must be - integer or vector of integer - values. Both arguments must have identical types.

      - -
      Semantics:
      -

      The value produced is the unsigned integer quotient of the two operands.

      - -

      Note that unsigned integer division and signed integer division are distinct - operations; for signed integer division, use 'sdiv'.

      - -

      Division by zero leads to undefined behavior.

      - -
      Example:
      -
      -  <result> = udiv i32 4, %var          ; yields {i32}:result = 4 / %var
-
      - -
      - - -
      'sdiv' Instruction -
      - -
      - -
      Syntax:
      -
      -  <result> = sdiv <ty> <op1>, <op2>         ; yields {ty}:result
-  <result> = sdiv exact <ty> <op1>, <op2>   ; yields {ty}:result
-
      - -
      Overview:
      -

      The 'sdiv' instruction returns the quotient of its two operands.

      - -
      Arguments:
      -

      The two arguments to the 'sdiv' instruction must be - integer or vector of integer - values. Both arguments must have identical types.

      - -
      Semantics:
      -

      The value produced is the signed integer quotient of the two operands rounded - towards zero.

      - -

      Note that signed integer division and unsigned integer division are distinct - operations; for unsigned integer division, use 'udiv'.

      - -

      Division by zero leads to undefined behavior. Overflow also leads to - undefined behavior; this is a rare case, but can occur, for example, by doing - a 32-bit division of -2147483648 by -1.

      - -

      If the exact keyword is present, the result value of the - sdiv is a trap value if the result would - be rounded or if overflow would occur.

      - -
      Example:
      -
      -  <result> = sdiv i32 4, %var          ; yields {i32}:result = 4 / %var
-
      - -
      - - -
      'fdiv' -Instruction
      - -
      - -
      Syntax:
      -
      -  <result> = fdiv <ty> <op1>, <op2>   ; yields {ty}:result
-
      - -
      Overview:
      -

      The 'fdiv' instruction returns the quotient of its two operands.

      - -
      Arguments:
      -

      The two arguments to the 'fdiv' instruction must be - floating point or vector of - floating point values. Both arguments must have identical types.

      - -
      Semantics:
      -

      The value produced is the floating point quotient of the two operands.

      - -
      Example:
      -
      -  <result> = fdiv float 4.0, %var          ; yields {float}:result = 4.0 / %var
-
      - -
      - - -
      'urem' Instruction -
      - -
      - -
      Syntax:
      -
      -  <result> = urem <ty> <op1>, <op2>   ; yields {ty}:result
-
      - -
      Overview:
      -

      The 'urem' instruction returns the remainder from the unsigned - division of its two arguments.

      - -
      Arguments:
      -

      The two arguments to the 'urem' instruction must be - integer or vector of integer - values. Both arguments must have identical types.

      - -
      Semantics:
      -

      This instruction returns the unsigned integer remainder of a division. - This instruction always performs an unsigned division to get the - remainder.

      - -

      Note that unsigned integer remainder and signed integer remainder are - distinct operations; for signed integer remainder, use 'srem'.

      - -

      Taking the remainder of a division by zero leads to undefined behavior.

      - -
      Example:
      -
      -  <result> = urem i32 4, %var          ; yields {i32}:result = 4 % %var
-
      - -
      - - -
      - 'srem' Instruction -
      - -
      - -
      Syntax:
      -
      -  <result> = srem <ty> <op1>, <op2>   ; yields {ty}:result
-
      - -
      Overview:
      -

      The 'srem' instruction returns the remainder from the signed - division of its two operands. This instruction can also take - vector versions of the values in which case the - elements must be integers.

      - -
      Arguments:
      -

      The two arguments to the 'srem' instruction must be - integer or vector of integer - values. Both arguments must have identical types.

      - -
      Semantics:
      -

      This instruction returns the remainder of a division (where the result - has the same sign as the dividend, op1), not the modulo - operator (where the result has the same sign as the divisor, op2) of - a value. For more information about the difference, - see The - Math Forum. For a table of how this is implemented in various languages, - please see - Wikipedia: modulo operation.

      - -

      Note that signed integer remainder and unsigned integer remainder are - distinct operations; for unsigned integer remainder, use 'urem'.

      - -

      Taking the remainder of a division by zero leads to undefined behavior. - Overflow also leads to undefined behavior; this is a rare case, but can - occur, for example, by taking the remainder of a 32-bit division of - -2147483648 by -1. (The remainder doesn't actually overflow, but this rule - lets srem be implemented using instructions that return both the result of - the division and the remainder.)

      - -
      Example:
      -
      -  <result> = srem i32 4, %var          ; yields {i32}:result = 4 % %var
-
      - -
      - - -
      - 'frem' Instruction
      - -
      - -
      Syntax:
      -
      -  <result> = frem <ty> <op1>, <op2>   ; yields {ty}:result
-
      - -
      Overview:
      -

      The 'frem' instruction returns the remainder from the division of - its two operands.

      - -
      Arguments:
      -

      The two arguments to the 'frem' instruction must be - floating point or vector of - floating point values. Both arguments must have identical types.

      - -
      Semantics:
      -

      This instruction returns the remainder of a division. The remainder - has the same sign as the dividend.

      - -
      Example:
      -
      -  <result> = frem float 4.0, %var          ; yields {float}:result = 4.0 % %var
-
      - -
      - - -
      Bitwise Binary -Operations
      - -
      - -

      Bitwise binary operators are used to do various forms of bit-twiddling in a - program. They are generally very efficient instructions and can commonly be - strength reduced from other instructions. They require two operands of the - same type, execute an operation on them, and produce a single value. The - resulting value is the same type as its operands.

      - -
      - - -
      'shl' -Instruction
      - -
      - -
      Syntax:
      -
      -  <result> = shl <ty> <op1>, <op2>   ; yields {ty}:result
-
      - -
      Overview:
      -

      The 'shl' instruction returns the first operand shifted to the left - a specified number of bits.

      - -
      Arguments:
      -

      Both arguments to the 'shl' instruction must be the - same integer or vector of - integer type. 'op2' is treated as an unsigned value.

      - -
      Semantics:
      -

      The value produced is op1 * 2op2 mod - 2n, where n is the width of the result. If op2 - is (statically or dynamically) negative or equal to or larger than the number - of bits in op1, the result is undefined. If the arguments are - vectors, each vector element of op1 is shifted by the corresponding - shift amount in op2.

      - -
      Example:
      -
      -  <result> = shl i32 4, %var   ; yields {i32}: 4 << %var
-  <result> = shl i32 4, 2      ; yields {i32}: 16
-  <result> = shl i32 1, 10     ; yields {i32}: 1024
-  <result> = shl i32 1, 32     ; undefined
-  <result> = shl <2 x i32> < i32 1, i32 1>, < i32 1, i32 2>   ; yields: result=<2 x i32> < i32 2, i32 4>
-
      - -
      - - -
      'lshr' -Instruction
      - -
      - -
      Syntax:
      -
      -  <result> = lshr <ty> <op1>, <op2>   ; yields {ty}:result
-
      - -
      Overview:
      -

      The 'lshr' instruction (logical shift right) returns the first - operand shifted to the right a specified number of bits with zero fill.

      - -
      Arguments:
      -

      Both arguments to the 'lshr' instruction must be the same - integer or vector of integer - type. 'op2' is treated as an unsigned value.

      - -
      Semantics:
      -

      This instruction always performs a logical shift right operation. The most - significant bits of the result will be filled with zero bits after the shift. - If op2 is (statically or dynamically) equal to or larger than the - number of bits in op1, the result is undefined. If the arguments are - vectors, each vector element of op1 is shifted by the corresponding - shift amount in op2.

      - -
      Example:
      -
      -  <result> = lshr i32 4, 1   ; yields {i32}:result = 2
-  <result> = lshr i32 4, 2   ; yields {i32}:result = 1
-  <result> = lshr i8  4, 3   ; yields {i8}:result = 0
-  <result> = lshr i8 -2, 1   ; yields {i8}:result = 0x7FFFFFFF 
-  <result> = lshr i32 1, 32  ; undefined
-  <result> = lshr <2 x i32> < i32 -2, i32 4>, < i32 1, i32 2>   ; yields: result=<2 x i32> < i32 0x7FFFFFFF, i32 1>
-
      - -
      - - -
      'ashr' -Instruction
      -
      - -
      Syntax:
      -
      -  <result> = ashr <ty> <op1>, <op2>   ; yields {ty}:result
-
      - -
      Overview:
      -

      The 'ashr' instruction (arithmetic shift right) returns the first - operand shifted to the right a specified number of bits with sign - extension.

      - -
      Arguments:
      -

      Both arguments to the 'ashr' instruction must be the same - integer or vector of integer - type. 'op2' is treated as an unsigned value.

      - -
      Semantics:
      -

      This instruction always performs an arithmetic shift right operation, The - most significant bits of the result will be filled with the sign bit - of op1. If op2 is (statically or dynamically) equal to or - larger than the number of bits in op1, the result is undefined. If - the arguments are vectors, each vector element of op1 is shifted by - the corresponding shift amount in op2.

      - -
      Example:
      -
      -  <result> = ashr i32 4, 1   ; yields {i32}:result = 2
-  <result> = ashr i32 4, 2   ; yields {i32}:result = 1
-  <result> = ashr i8  4, 3   ; yields {i8}:result = 0
-  <result> = ashr i8 -2, 1   ; yields {i8}:result = -1
-  <result> = ashr i32 1, 32  ; undefined
-  <result> = ashr <2 x i32> < i32 -2, i32 4>, < i32 1, i32 3>   ; yields: result=<2 x i32> < i32 -1, i32 0>
-
      - -
      - - -
      'and' -Instruction
      - -
      - -
      Syntax:
      -
      -  <result> = and <ty> <op1>, <op2>   ; yields {ty}:result
-
      - -
      Overview:
      -

      The 'and' instruction returns the bitwise logical and of its two - operands.

      - -
      Arguments:
      -

      The two arguments to the 'and' instruction must be - integer or vector of integer - values. Both arguments must have identical types.

      - -
      Semantics:
      -

      The truth table used for the 'and' instruction is:

      - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
      In0In1Out
      000
      010
      100
      111
      - -
      Example:
      -
      -  <result> = and i32 4, %var         ; yields {i32}:result = 4 & %var
-  <result> = and i32 15, 40          ; yields {i32}:result = 8
-  <result> = and i32 4, 8            ; yields {i32}:result = 0
-
      -
      - -
      'or' Instruction
      - -
      - -
      Syntax:
      -
      -  <result> = or <ty> <op1>, <op2>   ; yields {ty}:result
-
      - -
      Overview:
      -

      The 'or' instruction returns the bitwise logical inclusive or of its - two operands.

      - -
      Arguments:
      -

      The two arguments to the 'or' instruction must be - integer or vector of integer - values. Both arguments must have identical types.

      - -
      Semantics:
      -

      The truth table used for the 'or' instruction is:

      - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
      In0In1Out
      000
      011
      101
      111
      - -
      Example:
      -
      -  <result> = or i32 4, %var         ; yields {i32}:result = 4 | %var
-  <result> = or i32 15, 40          ; yields {i32}:result = 47
-  <result> = or i32 4, 8            ; yields {i32}:result = 12
-
      - -
      - - -
      'xor' -Instruction
      - -
      - -
      Syntax:
      -
      -  <result> = xor <ty> <op1>, <op2>   ; yields {ty}:result
-
      - -
      Overview:
      -

      The 'xor' instruction returns the bitwise logical exclusive or of - its two operands. The xor is used to implement the "one's - complement" operation, which is the "~" operator in C.

      - -
      Arguments:
      -

      The two arguments to the 'xor' instruction must be - integer or vector of integer - values. Both arguments must have identical types.

      - -
      Semantics:
      -

      The truth table used for the 'xor' instruction is:

      - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
      In0In1Out
      000
      011
      101
      110
      - -
      Example:
      -
      -  <result> = xor i32 4, %var         ; yields {i32}:result = 4 ^ %var
-  <result> = xor i32 15, 40          ; yields {i32}:result = 39
-  <result> = xor i32 4, 8            ; yields {i32}:result = 12
-  <result> = xor i32 %V, -1          ; yields {i32}:result = ~%V
-
      - -
      - - -
      - Vector Operations -
      - -
      - -

      LLVM supports several instructions to represent vector operations in a - target-independent manner. These instructions cover the element-access and - vector-specific operations needed to process vectors effectively. While LLVM - does directly support these vector operations, many sophisticated algorithms - will want to use target-specific intrinsics to take full advantage of a - specific target.

      - -
      - - -
      - 'extractelement' Instruction -
      - -
      - -
      Syntax:
      -
      -  <result> = extractelement <n x <ty>> <val>, i32 <idx>    ; yields <ty>
-
      - -
      Overview:
      -

      The 'extractelement' instruction extracts a single scalar element - from a vector at a specified index.

      - - -
      Arguments:
      -

      The first operand of an 'extractelement' instruction is a value - of vector type. The second operand is an index - indicating the position from which to extract the element. The index may be - a variable.

      - -
      Semantics:
      -

      The result is a scalar of the same type as the element type of - val. Its value is the value at position idx of - val. If idx exceeds the length of val, the - results are undefined.

      - -
      Example:
      -
      -  <result> = extractelement <4 x i32> %vec, i32 0    ; yields i32
-
      - -
      - - -
      - 'insertelement' Instruction -
      - -
      - -
      Syntax:
      -
      -  <result> = insertelement <n x <ty>> <val>, <ty> <elt>, i32 <idx>    ; yields <n x <ty>>
-
      - -
      Overview:
      -

      The 'insertelement' instruction inserts a scalar element into a - vector at a specified index.

      - -
      Arguments:
      -

      The first operand of an 'insertelement' instruction is a value - of vector type. The second operand is a scalar value - whose type must equal the element type of the first operand. The third - operand is an index indicating the position at which to insert the value. - The index may be a variable.

      - -
      Semantics:
      -

      The result is a vector of the same type as val. Its element values - are those of val except at position idx, where it gets the - value elt. If idx exceeds the length of val, the - results are undefined.

      - -
      Example:
      -
      -  <result> = insertelement <4 x i32> %vec, i32 1, i32 0    ; yields <4 x i32>
-
      - -
      - - -
      - 'shufflevector' Instruction -
      - -
      - -
      Syntax:
      -
      -  <result> = shufflevector <n x <ty>> <v1>, <n x <ty>> <v2>, <m x i32> <mask>    ; yields <m x <ty>>
-
      - -
      Overview:
      -

      The 'shufflevector' instruction constructs a permutation of elements - from two input vectors, returning a vector with the same element type as the - input and length that is the same as the shuffle mask.

      - -
      Arguments:
      -

      The first two operands of a 'shufflevector' instruction are vectors - with types that match each other. The third argument is a shuffle mask whose - element type is always 'i32'. The result of the instruction is a vector - whose length is the same as the shuffle mask and whose element type is the - same as the element type of the first two operands.

      - -

      The shuffle mask operand is required to be a constant vector with either - constant integer or undef values.

      - -
      Semantics:
      -

      The elements of the two input vectors are numbered from left to right across - both of the vectors. The shuffle mask operand specifies, for each element of - the result vector, which element of the two input vectors the result element - gets. The element selector may be undef (meaning "don't care") and the - second operand may be undef if performing a shuffle from only one vector.

      - -
      Example:
      -
      -  <result> = shufflevector <4 x i32> %v1, <4 x i32> %v2,
-                          <4 x i32> <i32 0, i32 4, i32 1, i32 5>  ; yields <4 x i32>
-  <result> = shufflevector <4 x i32> %v1, <4 x i32> undef,
-                          <4 x i32> <i32 0, i32 1, i32 2, i32 3>  ; yields <4 x i32> - Identity shuffle.
-  <result> = shufflevector <8 x i32> %v1, <8 x i32> undef,
-                          <4 x i32> <i32 0, i32 1, i32 2, i32 3>  ; yields <4 x i32>
-  <result> = shufflevector <4 x i32> %v1, <4 x i32> %v2,
-                          <8 x i32> <i32 0, i32 1, i32 2, i32 3, i32 4, i32 5, i32 6, i32 7 >  ; yields <8 x i32>
-
      - -
      - - -
      - Aggregate Operations -
      - -
      - -

      LLVM supports several instructions for working with - aggregate values.

      - -
      - - -
      - 'extractvalue' Instruction -
      - -
      - -
      Syntax:
      -
      -  <result> = extractvalue <aggregate type> <val>, <idx>{, <idx>}*
-
      - -
      Overview:
      -

      The 'extractvalue' instruction extracts the value of a member field - from an aggregate value.

      - -
      Arguments:
      -

      The first operand of an 'extractvalue' instruction is a value - of struct, union or - array type. The operands are constant indices to - specify which value to extract in a similar manner as indices in a - 'getelementptr' instruction.

      - -
      Semantics:
      -

      The result is the value at the position in the aggregate specified by the - index operands.

      - -
      Example:
      -
      -  <result> = extractvalue {i32, float} %agg, 0    ; yields i32
-
      - -
      - - -
      - 'insertvalue' Instruction -
      - -
      - -
      Syntax:
      -
      -  <result> = insertvalue <aggregate type> <val>, <ty> <elt>, <idx>    ; yields <aggregate type>
-
      - -
      Overview:
      -

      The 'insertvalue' instruction inserts a value into a member field - in an aggregate value.

      - -
      Arguments:
      -

      The first operand of an 'insertvalue' instruction is a value - of struct, union or - array type. The second operand is a first-class - value to insert. The following operands are constant indices indicating - the position at which to insert the value in a similar manner as indices in a - 'getelementptr' instruction. The - value to insert must have the same type as the value identified by the - indices.

      - -
      Semantics:
      -

      The result is an aggregate of the same type as val. Its value is - that of val except that the value at the position specified by the - indices is that of elt.

      - -
      Example:
      -
      -  %agg1 = insertvalue {i32, float} undef, i32 1, 0         ; yields {i32 1, float undef}
-  %agg2 = insertvalue {i32, float} %agg1, float %val, 1    ; yields {i32 1, float %val}
-
      - -
      - - - -
      - Memory Access and Addressing Operations -
      - -
      - -

      A key design point of an SSA-based representation is how it represents - memory. In LLVM, no memory locations are in SSA form, which makes things - very simple. This section describes how to read, write, and allocate - memory in LLVM.

      - -
      - - -
      - 'alloca' Instruction -
      - -
      - -
      Syntax:
      -
      -  <result> = alloca <type>[, i32 <NumElements>][, align <alignment>]     ; yields {type*}:result
-
      - -
      Overview:
      -

      The 'alloca' instruction allocates memory on the stack frame of the - currently executing function, to be automatically released when this function - returns to its caller. The object is always allocated in the generic address - space (address space zero).

      - -
      Arguments:
      -

      The 'alloca' instruction - allocates sizeof(<type>)*NumElements bytes of memory on the - runtime stack, returning a pointer of the appropriate type to the program. - If "NumElements" is specified, it is the number of elements allocated, - otherwise "NumElements" is defaulted to be one. If a constant alignment is - specified, the value result of the allocation is guaranteed to be aligned to - at least that boundary. If not specified, or if zero, the target can choose - to align the allocation on any convenient boundary compatible with the - type.

      - -

      'type' may be any sized type.

      - -
      Semantics:
      -

      Memory is allocated; a pointer is returned. The operation is undefined if - there is insufficient stack space for the allocation. 'alloca'd - memory is automatically released when the function returns. The - 'alloca' instruction is commonly used to represent automatic - variables that must have an address available. When the function returns - (either with the ret - or unwind instructions), the memory is - reclaimed. Allocating zero bytes is legal, but the result is undefined.

      - -
      Example:
      -
      -  %ptr = alloca i32                             ; yields {i32*}:ptr
-  %ptr = alloca i32, i32 4                      ; yields {i32*}:ptr
-  %ptr = alloca i32, i32 4, align 1024          ; yields {i32*}:ptr
-  %ptr = alloca i32, align 1024                 ; yields {i32*}:ptr
-
      - -
      - - -
      'load' -Instruction
      - -
      - -
      Syntax:
      -
      -  <result> = load <ty>* <pointer>[, align <alignment>][, !nontemporal !<index>]
-  <result> = volatile load <ty>* <pointer>[, align <alignment>][, !nontemporal !<index>]
-  !<index> = !{ i32 1 }
-
      - -
      Overview:
      -

      The 'load' instruction is used to read from memory.

      - -
      Arguments:
      -

      The argument to the 'load' instruction specifies the memory address - from which to load. The pointer must point to - a first class type. If the load is - marked as volatile, then the optimizer is not allowed to modify the - number or order of execution of this load with other volatile operations.

      - -

      The optional constant align argument specifies the alignment of the - operation (that is, the alignment of the memory address). A value of 0 or an - omitted align argument means that the operation has the preferential - alignment for the target. It is the responsibility of the code emitter to - ensure that the alignment information is correct. Overestimating the - alignment results in undefined behavior. Underestimating the alignment may - produce less efficient code. An alignment of 1 is always safe.

      - -

      The optional !nontemporal metadata must reference a single - metatadata name <index> corresponding to a metadata node with - one i32 entry of value 1. The existence of - the !nontemporal metatadata on the instruction tells the optimizer - and code generator that this load is not expected to be reused in the cache. - The code generator may select special instructions to save cache bandwidth, - such as the MOVNT instruction on x86.

      - -
      Semantics:
      -

      The location of memory pointed to is loaded. If the value being loaded is of - scalar type then the number of bytes read does not exceed the minimum number - of bytes needed to hold all bits of the type. For example, loading an - i24 reads at most three bytes. When loading a value of a type like - i20 with a size that is not an integral number of bytes, the result - is undefined if the value was not originally written using a store of the - same type.

      - -
      Examples:
      -
      -  %ptr = alloca i32                               ; yields {i32*}:ptr
-  store i32 3, i32* %ptr                          ; yields {void}
-  %val = load i32* %ptr                           ; yields {i32}:val = i32 3
-
      - -
      - - -
      'store' -Instruction
      - -
      - -
      Syntax:
      -
      -  store <ty> <value>, <ty>* <pointer>[, align <alignment>][, !nontemporal !]                   ; yields {void}
-  volatile store <ty> <value>, <ty>* <pointer>[, align <alignment>][, !nontemporal !]          ; yields {void}
-
      - -
      Overview:
      -

      The 'store' instruction is used to write to memory.

      - -
      Arguments:
      -

      There are two arguments to the 'store' instruction: a value to store - and an address at which to store it. The type of the - '<pointer>' operand must be a pointer to - the first class type of the - '<value>' operand. If the store is marked as - volatile, then the optimizer is not allowed to modify the number or - order of execution of this store with other volatile operations.

      - -

      The optional constant "align" argument specifies the alignment of the - operation (that is, the alignment of the memory address). A value of 0 or an - omitted "align" argument means that the operation has the preferential - alignment for the target. It is the responsibility of the code emitter to - ensure that the alignment information is correct. Overestimating the - alignment results in an undefined behavior. Underestimating the alignment may - produce less efficient code. An alignment of 1 is always safe.

      - -

      The optional !nontemporal metadata must reference a single metatadata - name corresponding to a metadata node with one i32 entry of - value 1. The existence of the !nontemporal metatadata on the - instruction tells the optimizer and code generator that this load is - not expected to be reused in the cache. The code generator may - select special instructions to save cache bandwidth, such as the - MOVNT instruction on x86.

      - - -
      Semantics:
      -

      The contents of memory are updated to contain '<value>' at the - location specified by the '<pointer>' operand. If - '<value>' is of scalar type then the number of bytes written - does not exceed the minimum number of bytes needed to hold all bits of the - type. For example, storing an i24 writes at most three bytes. When - writing a value of a type like i20 with a size that is not an - integral number of bytes, it is unspecified what happens to the extra bits - that do not belong to the type, but they will typically be overwritten.

      - -
      Example:
      -
      -  %ptr = alloca i32                               ; yields {i32*}:ptr
-  store i32 3, i32* %ptr                          ; yields {void}
-  %val = load i32* %ptr                           ; yields {i32}:val = i32 3
-
      - -
      - - -
      - 'getelementptr' Instruction -
      - -
      - -
      Syntax:
      -
      -  <result> = getelementptr <pty>* <ptrval>{, <ty> <idx>}*
-  <result> = getelementptr inbounds <pty>* <ptrval>{, <ty> <idx>}*
-
      - -
      Overview:
      -

      The 'getelementptr' instruction is used to get the address of a - subelement of an aggregate data structure. - It performs address calculation only and does not access memory.

      - -
      Arguments:
      -

      The first argument is always a pointer, and forms the basis of the - calculation. The remaining arguments are indices that indicate which of the - elements of the aggregate object are indexed. The interpretation of each - index is dependent on the type being indexed into. The first index always - indexes the pointer value given as the first argument, the second index - indexes a value of the type pointed to (not necessarily the value directly - pointed to, since the first index can be non-zero), etc. The first type - indexed into must be a pointer value, subsequent types can be arrays, - vectors, structs and unions. Note that subsequent types being indexed into - can never be pointers, since that would require loading the pointer before - continuing calculation.

      - -

      The type of each index argument depends on the type it is indexing into. - When indexing into a (optionally packed) structure or union, only i32 - integer constants are allowed. When indexing into an array, pointer - or vector, integers of any width are allowed, and they are not required to be - constant.

      - -

      For example, let's consider a C code fragment and how it gets compiled to - LLVM:

      - -
      -
      -struct RT {
-  char A;
-  int B[10][20];
-  char C;
-};
-struct ST {
-  int X;
-  double Y;
-  struct RT Z;
-};
-
-int *foo(struct ST *s) {
-  return &s[1].Z.B[5][13];
-}
-
      -
      - -

      The LLVM code generated by the GCC frontend is:

      - -
      -
      -%RT = type { i8 , [10 x [20 x i32]], i8  }
-%ST = type { i32, double, %RT }
-
-define i32* @foo(%ST* %s) {
-entry:
-  %reg = getelementptr %ST* %s, i32 1, i32 2, i32 1, i32 5, i32 13
-  ret i32* %reg
-}
-
      -
      - -
      Semantics:
      -

      In the example above, the first index is indexing into the '%ST*' - type, which is a pointer, yielding a '%ST' = '{ i32, double, %RT - }' type, a structure. The second index indexes into the third element - of the structure, yielding a '%RT' = '{ i8 , [10 x [20 x i32]], - i8 }' type, another structure. The third index indexes into the second - element of the structure, yielding a '[10 x [20 x i32]]' type, an - array. The two dimensions of the array are subscripted into, yielding an - 'i32' type. The 'getelementptr' instruction returns a - pointer to this element, thus computing a value of 'i32*' type.

      - -

      Note that it is perfectly legal to index partially through a structure, - returning a pointer to an inner element. Because of this, the LLVM code for - the given testcase is equivalent to:

      - -
      -  define i32* @foo(%ST* %s) {
-    %t1 = getelementptr %ST* %s, i32 1                        ; yields %ST*:%t1
-    %t2 = getelementptr %ST* %t1, i32 0, i32 2                ; yields %RT*:%t2
-    %t3 = getelementptr %RT* %t2, i32 0, i32 1                ; yields [10 x [20 x i32]]*:%t3
-    %t4 = getelementptr [10 x [20 x i32]]* %t3, i32 0, i32 5  ; yields [20 x i32]*:%t4
-    %t5 = getelementptr [20 x i32]* %t4, i32 0, i32 13        ; yields i32*:%t5
-    ret i32* %t5
-  }
-
      - -

      If the inbounds keyword is present, the result value of the - getelementptr is a trap value if the - base pointer is not an in bounds address of an allocated object, - or if any of the addresses that would be formed by successive addition of - the offsets implied by the indices to the base address with infinitely - precise arithmetic are not an in bounds address of that allocated - object. The in bounds addresses for an allocated object are all - the addresses that point into the object, plus the address one byte past - the end.

      - -

      If the inbounds keyword is not present, the offsets are added to - the base address with silently-wrapping two's complement arithmetic, and - the result value of the getelementptr may be outside the object - pointed to by the base pointer. The result value may not necessarily be - used to access memory though, even if it happens to point into allocated - storage. See the Pointer Aliasing Rules - section for more information.

      - -

      The getelementptr instruction is often confusing. For some more insight into - how it works, see the getelementptr FAQ.

      - -
      Example:
      -
      -    ; yields [12 x i8]*:aptr
-    %aptr = getelementptr {i32, [12 x i8]}* %saptr, i64 0, i32 1
-    ; yields i8*:vptr
-    %vptr = getelementptr {i32, <2 x i8>}* %svptr, i64 0, i32 1, i32 1
-    ; yields i8*:eptr
-    %eptr = getelementptr [12 x i8]* %aptr, i64 0, i32 1
-    ; yields i32*:iptr
-    %iptr = getelementptr [10 x i32]* @arr, i16 0, i16 0
-
      - -
      - - -
      Conversion Operations -
      - -
      - -

      The instructions in this category are the conversion instructions (casting) - which all take a single operand and a type. They perform various bit - conversions on the operand.

      - -
      - - -
      - 'trunc .. to' Instruction -
      -
      - -
      Syntax:
      -
      -  <result> = trunc <ty> <value> to <ty2>             ; yields ty2
-
      - -
      Overview:
      -

      The 'trunc' instruction truncates its operand to the - type ty2.

      - -
      Arguments:
      -

      The 'trunc' instruction takes a value to trunc, which must - be an integer type, and a type that specifies the - size and type of the result, which must be - an integer type. The bit size of value must - be larger than the bit size of ty2. Equal sized types are not - allowed.

      - -
      Semantics:
      -

      The 'trunc' instruction truncates the high order bits - in value and converts the remaining bits to ty2. Since the - source size must be larger than the destination size, trunc cannot - be a no-op cast. It will always truncate bits.

      - -
      Example:
      -
      -  %X = trunc i32 257 to i8              ; yields i8:1
-  %Y = trunc i32 123 to i1              ; yields i1:true
-  %Z = trunc i32 122 to i1              ; yields i1:false
-
      - -
      - - -
      - 'zext .. to' Instruction -
      -
      - -
      Syntax:
      -
      -  <result> = zext <ty> <value> to <ty2>             ; yields ty2
-
      - -
      Overview:
      -

      The 'zext' instruction zero extends its operand to type - ty2.

      - - -
      Arguments:
      -

      The 'zext' instruction takes a value to cast, which must be of - integer type, and a type to cast it to, which must - also be of integer type. The bit size of the - value must be smaller than the bit size of the destination type, - ty2.

      - -
      Semantics:
      -

      The zext fills the high order bits of the value with zero - bits until it reaches the size of the destination type, ty2.

      - -

      When zero extending from i1, the result will always be either 0 or 1.

      - -
      Example:
      -
      -  %X = zext i32 257 to i64              ; yields i64:257
-  %Y = zext i1 true to i32              ; yields i32:1
-
      - -
      - - -
      - 'sext .. to' Instruction -
      -
      - -
      Syntax:
      -
      -  <result> = sext <ty> <value> to <ty2>             ; yields ty2
-
      - -
      Overview:
      -

      The 'sext' sign extends value to the type ty2.

      - -
      Arguments:
      -

      The 'sext' instruction takes a value to cast, which must be of - integer type, and a type to cast it to, which must - also be of integer type. The bit size of the - value must be smaller than the bit size of the destination type, - ty2.

      - -
      Semantics:
      -

      The 'sext' instruction performs a sign extension by copying the sign - bit (highest order bit) of the value until it reaches the bit size - of the type ty2.

      - -

      When sign extending from i1, the extension always results in -1 or 0.

      - -
      Example:
      -
      -  %X = sext i8  -1 to i16              ; yields i16   :65535
-  %Y = sext i1 true to i32             ; yields i32:-1
-
      - -
      - - -
      - 'fptrunc .. to' Instruction -
      - -
      - -
      Syntax:
      -
      -  <result> = fptrunc <ty> <value> to <ty2>             ; yields ty2
-
      - -
      Overview:
      -

      The 'fptrunc' instruction truncates value to type - ty2.

      - -
      Arguments:
      -

      The 'fptrunc' instruction takes a floating - point value to cast and a floating point type - to cast it to. The size of value must be larger than the size of - ty2. This implies that fptrunc cannot be used to make a - no-op cast.

      - -
      Semantics:
      -

      The 'fptrunc' instruction truncates a value from a larger - floating point type to a smaller - floating point type. If the value cannot fit - within the destination type, ty2, then the results are - undefined.

      - -
      Example:
      -
      -  %X = fptrunc double 123.0 to float         ; yields float:123.0
-  %Y = fptrunc double 1.0E+300 to float      ; yields undefined
-
      - -
      - - -
      - 'fpext .. to' Instruction -
      -
      - -
      Syntax:
      -
      -  <result> = fpext <ty> <value> to <ty2>             ; yields ty2
-
      - -
      Overview:
      -

      The 'fpext' extends a floating point value to a larger - floating point value.

      - -
      Arguments:
      -

      The 'fpext' instruction takes a - floating point value to cast, and - a floating point type to cast it to. The source - type must be smaller than the destination type.

      - -
      Semantics:
      -

      The 'fpext' instruction extends the value from a smaller - floating point type to a larger - floating point type. The fpext cannot be - used to make a no-op cast because it always changes bits. Use - bitcast to make a no-op cast for a floating point cast.

      - -
      Example:
      -
      -  %X = fpext float 3.1415 to double        ; yields double:3.1415
-  %Y = fpext float 1.0 to float            ; yields float:1.0 (no-op)
-
      - -
      - - -
      - 'fptoui .. to' Instruction -
      -
      - -
      Syntax:
      -
      -  <result> = fptoui <ty> <value> to <ty2>             ; yields ty2
-
      - -
      Overview:
      -

      The 'fptoui' converts a floating point value to its - unsigned integer equivalent of type ty2.

      - -
      Arguments:
      -

      The 'fptoui' instruction takes a value to cast, which must be a - scalar or vector floating point value, and a type - to cast it to ty2, which must be an integer - type. If ty is a vector floating point type, ty2 must be a - vector integer type with the same number of elements as ty

      - -
      Semantics:
      -

      The 'fptoui' instruction converts its - floating point operand into the nearest (rounding - towards zero) unsigned integer value. If the value cannot fit - in ty2, the results are undefined.

      - -
      Example:
      -
      -  %X = fptoui double 123.0 to i32      ; yields i32:123
-  %Y = fptoui float 1.0E+300 to i1     ; yields undefined:1
-  %Z = fptoui float 1.04E+17 to i8     ; yields undefined:1
-
      - -
      - - -
      - 'fptosi .. to' Instruction -
      -
      - -
      Syntax:
      -
      -  <result> = fptosi <ty> <value> to <ty2>             ; yields ty2
-
      - -
      Overview:
      -

      The 'fptosi' instruction converts - floating point value to - type ty2.

      - -
      Arguments:
      -

      The 'fptosi' instruction takes a value to cast, which must be a - scalar or vector floating point value, and a type - to cast it to ty2, which must be an integer - type. If ty is a vector floating point type, ty2 must be a - vector integer type with the same number of elements as ty

      - -
      Semantics:
      -

      The 'fptosi' instruction converts its - floating point operand into the nearest (rounding - towards zero) signed integer value. If the value cannot fit in ty2, - the results are undefined.

      - -
      Example:
      -
      -  %X = fptosi double -123.0 to i32      ; yields i32:-123
-  %Y = fptosi float 1.0E-247 to i1      ; yields undefined:1
-  %Z = fptosi float 1.04E+17 to i8      ; yields undefined:1
-
      - -
      - - -
      - 'uitofp .. to' Instruction -
      -
      - -
      Syntax:
      -
      -  <result> = uitofp <ty> <value> to <ty2>             ; yields ty2
-
      - -
      Overview:
      -

      The 'uitofp' instruction regards value as an unsigned - integer and converts that value to the ty2 type.

      - -
      Arguments:
      -

      The 'uitofp' instruction takes a value to cast, which must be a - scalar or vector integer value, and a type to cast - it to ty2, which must be an floating point - type. If ty is a vector integer type, ty2 must be a vector - floating point type with the same number of elements as ty

      - -
      Semantics:
      -

      The 'uitofp' instruction interprets its operand as an unsigned - integer quantity and converts it to the corresponding floating point - value. If the value cannot fit in the floating point value, the results are - undefined.

      - -
      Example:
      -
      -  %X = uitofp i32 257 to float         ; yields float:257.0
-  %Y = uitofp i8 -1 to double          ; yields double:255.0
-
      - -
      - - -
      - 'sitofp .. to' Instruction -
      -
      - -
      Syntax:
      -
      -  <result> = sitofp <ty> <value> to <ty2>             ; yields ty2
-
      - -
      Overview:
      -

      The 'sitofp' instruction regards value as a signed integer - and converts that value to the ty2 type.

      - -
      Arguments:
      -

      The 'sitofp' instruction takes a value to cast, which must be a - scalar or vector integer value, and a type to cast - it to ty2, which must be an floating point - type. If ty is a vector integer type, ty2 must be a vector - floating point type with the same number of elements as ty

      - -
      Semantics:
      -

      The 'sitofp' instruction interprets its operand as a signed integer - quantity and converts it to the corresponding floating point value. If the - value cannot fit in the floating point value, the results are undefined.

      - -
      Example:
      -
      -  %X = sitofp i32 257 to float         ; yields float:257.0
-  %Y = sitofp i8 -1 to double          ; yields double:-1.0
-
      - -
      - - -
      - 'ptrtoint .. to' Instruction -
      -
      - -
      Syntax:
      -
      -  <result> = ptrtoint <ty> <value> to <ty2>             ; yields ty2
-
      - -
      Overview:
      -

      The 'ptrtoint' instruction converts the pointer value to - the integer type ty2.

      - -
      Arguments:
      -

      The 'ptrtoint' instruction takes a value to cast, which - must be a pointer value, and a type to cast it to - ty2, which must be an integer type.

      - -
      Semantics:
      -

      The 'ptrtoint' instruction converts value to integer type - ty2 by interpreting the pointer value as an integer and either - truncating or zero extending that value to the size of the integer type. If - value is smaller than ty2 then a zero extension is done. If - value is larger than ty2 then a truncation is done. If they - are the same size, then nothing is done (no-op cast) other than a type - change.

      - -
      Example:
      -
      -  %X = ptrtoint i32* %X to i8           ; yields truncation on 32-bit architecture
-  %Y = ptrtoint i32* %x to i64          ; yields zero extension on 32-bit architecture
-
      - -
      - - -
      - 'inttoptr .. to' Instruction -
      -
      - -
      Syntax:
      -
      -  <result> = inttoptr <ty> <value> to <ty2>             ; yields ty2
-
      - -
      Overview:
      -

      The 'inttoptr' instruction converts an integer value to a - pointer type, ty2.

      - -
      Arguments:
      -

      The 'inttoptr' instruction takes an integer - value to cast, and a type to cast it to, which must be a - pointer type.

      - -
      Semantics:
      -

      The 'inttoptr' instruction converts value to type - ty2 by applying either a zero extension or a truncation depending on - the size of the integer value. If value is larger than the - size of a pointer then a truncation is done. If value is smaller - than the size of a pointer then a zero extension is done. If they are the - same size, nothing is done (no-op cast).

      - -
      Example:
      -
      -  %X = inttoptr i32 255 to i32*          ; yields zero extension on 64-bit architecture
-  %Y = inttoptr i32 255 to i32*          ; yields no-op on 32-bit architecture
-  %Z = inttoptr i64 0 to i32*            ; yields truncation on 32-bit architecture
-
      - -
      - - -
      - 'bitcast .. to' Instruction -
      -
      - -
      Syntax:
      -
      -  <result> = bitcast <ty> <value> to <ty2>             ; yields ty2
-
      - -
      Overview:
      -

      The 'bitcast' instruction converts value to type - ty2 without changing any bits.

      - -
      Arguments:
      -

      The 'bitcast' instruction takes a value to cast, which must be a - non-aggregate first class value, and a type to cast it to, which must also be - a non-aggregate first class type. The bit sizes - of value and the destination type, ty2, must be - identical. If the source type is a pointer, the destination type must also be - a pointer. This instruction supports bitwise conversion of vectors to - integers and to vectors of other types (as long as they have the same - size).

      - -
      Semantics:
      -

      The 'bitcast' instruction converts value to type - ty2. It is always a no-op cast because no bits change with - this conversion. The conversion is done as if the value had been - stored to memory and read back as type ty2. Pointer types may only - be converted to other pointer types with this instruction. To convert - pointers to other types, use the inttoptr or - ptrtoint instructions first.

      - -
      Example:
      -
      -  %X = bitcast i8 255 to i8              ; yields i8 :-1
-  %Y = bitcast i32* %x to sint*          ; yields sint*:%x
-  %Z = bitcast <2 x int> %V to i64;      ; yields i64: %V
-
      - -
      - - -
      Other Operations
      - -
      - -

      The instructions in this category are the "miscellaneous" instructions, which - defy better classification.

      - -
      - - -
      'icmp' Instruction -
      - -
      - -
      Syntax:
      -
      -  <result> = icmp <cond> <ty> <op1>, <op2>   ; yields {i1} or {<N x i1>}:result
-
      - -
      Overview:
      -

      The 'icmp' instruction returns a boolean value or a vector of - boolean values based on comparison of its two integer, integer vector, or - pointer operands.

      - -
      Arguments:
      -

      The 'icmp' instruction takes three operands. The first operand is - the condition code indicating the kind of comparison to perform. It is not a - value, just a keyword. The possible condition code are:

      - -
        -
      1. eq: equal
        2. -
      2. ne: not equal
        3. -
      3. ugt: unsigned greater than
        4. -
      4. uge: unsigned greater or equal
        5. -
      5. ult: unsigned less than
        6. -
      6. ule: unsigned less or equal
        7. -
      7. sgt: signed greater than
        8. -
      8. sge: signed greater or equal
        9. -
      9. slt: signed less than
        10. -
      10. sle: signed less or equal
        11. -
      - -

      The remaining two arguments must be integer or - pointer or integer vector - typed. They must also be identical types.

      - -
      Semantics:
      -

      The 'icmp' compares op1 and op2 according to the - condition code given as cond. The comparison performed always yields - either an i1 or vector of i1 - result, as follows:

      - -
        -
      1. eq: yields true if the operands are equal, - false otherwise. No sign interpretation is necessary or - performed.
        2. - -
      2. ne: yields true if the operands are unequal, - false otherwise. No sign interpretation is necessary or - performed.
        3. - -
      3. ugt: interprets the operands as unsigned values and yields - true if op1 is greater than op2.
        4. - -
      4. uge: interprets the operands as unsigned values and yields - true if op1 is greater than or equal - to op2.
        5. - -
      5. ult: interprets the operands as unsigned values and yields - true if op1 is less than op2.
        6. - -
      6. ule: interprets the operands as unsigned values and yields - true if op1 is less than or equal to op2.
        7. - -
      7. sgt: interprets the operands as signed values and yields - true if op1 is greater than op2.
        8. - -
      8. sge: interprets the operands as signed values and yields - true if op1 is greater than or equal - to op2.
        9. - -
      9. slt: interprets the operands as signed values and yields - true if op1 is less than op2.
        10. - -
      10. sle: interprets the operands as signed values and yields - true if op1 is less than or equal to op2.
        11. -
      - -

      If the operands are pointer typed, the pointer - values are compared as if they were integers.

      - -

      If the operands are integer vectors, then they are compared element by - element. The result is an i1 vector with the same number of elements - as the values being compared. Otherwise, the result is an i1.

      - -
      Example:
      -
      -  <result> = icmp eq i32 4, 5          ; yields: result=false
-  <result> = icmp ne float* %X, %X     ; yields: result=false
-  <result> = icmp ult i16  4, 5        ; yields: result=true
-  <result> = icmp sgt i16  4, 5        ; yields: result=false
-  <result> = icmp ule i16 -4, 5        ; yields: result=false
-  <result> = icmp sge i16  4, 5        ; yields: result=false
-
      - -

      Note that the code generator does not yet support vector types with - the icmp instruction.

      - -
      - - -
      'fcmp' Instruction -
      - -
      - -
      Syntax:
      -
      -  <result> = fcmp <cond> <ty> <op1>, <op2>     ; yields {i1} or {<N x i1>}:result
-
      - -
      Overview:
      -

      The 'fcmp' instruction returns a boolean value or vector of boolean - values based on comparison of its operands.

      - -

      If the operands are floating point scalars, then the result type is a boolean -(i1).

      - -

      If the operands are floating point vectors, then the result type is a vector - of boolean with the same number of elements as the operands being - compared.

      - -
      Arguments:
      -

      The 'fcmp' instruction takes three operands. The first operand is - the condition code indicating the kind of comparison to perform. It is not a - value, just a keyword. The possible condition code are:

      - -
        -
      1. false: no comparison, always returns false
        2. -
      2. oeq: ordered and equal
        3. -
      3. ogt: ordered and greater than
        4. -
      4. oge: ordered and greater than or equal
        5. -
      5. olt: ordered and less than
        6. -
      6. ole: ordered and less than or equal
        7. -
      7. one: ordered and not equal
        8. -
      8. ord: ordered (no nans)
        9. -
      9. ueq: unordered or equal
        10. -
      10. ugt: unordered or greater than
        11. -
      11. uge: unordered or greater than or equal
        12. -
      12. ult: unordered or less than
        13. -
      13. ule: unordered or less than or equal
        14. -
      14. une: unordered or not equal
        15. -
      15. uno: unordered (either nans)
        16. -
      16. true: no comparison, always returns true
        17. -
      - -

      Ordered means that neither operand is a QNAN while - unordered means that either operand may be a QNAN.

      - -

      Each of val1 and val2 arguments must be either - a floating point type or - a vector of floating point type. They must have - identical types.

      - -
      Semantics:
      -

      The 'fcmp' instruction compares op1 and op2 - according to the condition code given as cond. If the operands are - vectors, then the vectors are compared element by element. Each comparison - performed always yields an i1 result, as - follows:

      - -
        -
      1. false: always yields false, regardless of operands.
        2. - -
      2. oeq: yields true if both operands are not a QNAN and - op1 is equal to op2.
        3. - -
      3. ogt: yields true if both operands are not a QNAN and - op1 is greater than op2.
        4. - -
      4. oge: yields true if both operands are not a QNAN and - op1 is greater than or equal to op2.
        5. - -
      5. olt: yields true if both operands are not a QNAN and - op1 is less than op2.
        6. - -
      6. ole: yields true if both operands are not a QNAN and - op1 is less than or equal to op2.
        7. - -
      7. one: yields true if both operands are not a QNAN and - op1 is not equal to op2.
        8. - -
      8. ord: yields true if both operands are not a QNAN.
        9. - -
      9. ueq: yields true if either operand is a QNAN or - op1 is equal to op2.
        10. - -
      10. ugt: yields true if either operand is a QNAN or - op1 is greater than op2.
        11. - -
      11. uge: yields true if either operand is a QNAN or - op1 is greater than or equal to op2.
        12. - -
      12. ult: yields true if either operand is a QNAN or - op1 is less than op2.
        13. - -
      13. ule: yields true if either operand is a QNAN or - op1 is less than or equal to op2.
        14. - -
      14. une: yields true if either operand is a QNAN or - op1 is not equal to op2.
        15. - -
      15. uno: yields true if either operand is a QNAN.
        16. - -
      16. true: always yields true, regardless of operands.
        17. -
      - -
      Example:
      -
      -  <result> = fcmp oeq float 4.0, 5.0    ; yields: result=false
-  <result> = fcmp one float 4.0, 5.0    ; yields: result=true
-  <result> = fcmp olt float 4.0, 5.0    ; yields: result=true
-  <result> = fcmp ueq double 1.0, 2.0   ; yields: result=false
-
      - -

      Note that the code generator does not yet support vector types with - the fcmp instruction.

      - -
      - - -
      - 'phi' Instruction -
      - -
      - -
      Syntax:
      -
      -  <result> = phi <ty> [ <val0>, <label0>], ...
-
      - -
      Overview:
      -

      The 'phi' instruction is used to implement the φ node in the - SSA graph representing the function.

      - -
      Arguments:
      -

      The type of the incoming values is specified with the first type field. After - this, the 'phi' instruction takes a list of pairs as arguments, with - one pair for each predecessor basic block of the current block. Only values - of first class type may be used as the value - arguments to the PHI node. Only labels may be used as the label - arguments.

      - -

      There must be no non-phi instructions between the start of a basic block and - the PHI instructions: i.e. PHI instructions must be first in a basic - block.

      - -

      For the purposes of the SSA form, the use of each incoming value is deemed to - occur on the edge from the corresponding predecessor block to the current - block (but after any definition of an 'invoke' instruction's return - value on the same edge).

      - -
      Semantics:
      -

      At runtime, the 'phi' instruction logically takes on the value - specified by the pair corresponding to the predecessor basic block that - executed just prior to the current block.

      - -
      Example:
      -
      -Loop:       ; Infinite loop that counts from 0 on up...
-  %indvar = phi i32 [ 0, %LoopHeader ], [ %nextindvar, %Loop ]
-  %nextindvar = add i32 %indvar, 1
-  br label %Loop
-
      - -
      - - -
      - 'select' Instruction -
      - -
      - -
      Syntax:
      -
      -  <result> = select selty <cond>, <ty> <val1>, <ty> <val2>             ; yields ty
-
-  selty is either i1 or {<N x i1>}
-
      - -
      Overview:
      -

      The 'select' instruction is used to choose one value based on a - condition, without branching.

      - - -
      Arguments:
      -

      The 'select' instruction requires an 'i1' value or a vector of 'i1' - values indicating the condition, and two values of the - same first class type. If the val1/val2 are - vectors and the condition is a scalar, then entire vectors are selected, not - individual elements.

      - -
      Semantics:
      -

      If the condition is an i1 and it evaluates to 1, the instruction returns the - first value argument; otherwise, it returns the second value argument.

      - -

      If the condition is a vector of i1, then the value arguments must be vectors - of the same size, and the selection is done element by element.

      - -
      Example:
      -
      -  %X = select i1 true, i8 17, i8 42          ; yields i8:17
-
      - -

      Note that the code generator does not yet support conditions - with vector type.

      - -
      - - -
      - 'call' Instruction -
      - -
      - -
      Syntax:
      -
      -  <result> = [tail] call [cconv] [ret attrs] <ty> [<fnty>*] <fnptrval>(<function args>) [fn attrs]
-
      - -
      Overview:
      -

      The 'call' instruction represents a simple function call.

      - -
      Arguments:
      -

      This instruction requires several arguments:

      - -
        -
      1. The optional "tail" marker indicates that the callee function does not - access any allocas or varargs in the caller. Note that calls may be - marked "tail" even if they do not occur before - a ret instruction. If the "tail" marker is - present, the function call is eligible for tail call optimization, - but might not in fact be - optimized into a jump. The code generator may optimize calls marked - "tail" with either 1) automatic - sibling call optimization when the caller and callee have - matching signatures, or 2) forced tail call optimization when the - following extra requirements are met: -
          -
        • Caller and callee both have the calling - convention fastcc.
          • -
        • The call is in tail position (ret immediately follows call and ret - uses value of call or is void).
          • -
        • Option -tailcallopt is enabled, - or llvm::GuaranteedTailCallOpt is true.
          • -
        • Platform specific - constraints are met.
          • -
        -
        2. - -
      2. The optional "cconv" marker indicates which calling - convention the call should use. If none is specified, the call - defaults to using C calling conventions. The calling convention of the - call must match the calling convention of the target function, or else the - behavior is undefined.
        3. - -
      3. The optional Parameter Attributes list for - return values. Only 'zeroext', 'signext', and - 'inreg' attributes are valid here.
        4. - -
      4. 'ty': the type of the call instruction itself which is also the - type of the return value. Functions that return no value are marked - void.
        5. - -
      5. 'fnty': shall be the signature of the pointer to function value - being invoked. The argument types must match the types implied by this - signature. This type can be omitted if the function is not varargs and if - the function type does not return a pointer to a function.
        6. - -
      6. 'fnptrval': An LLVM value containing a pointer to a function to - be invoked. In most cases, this is a direct function invocation, but - indirect calls are just as possible, calling an arbitrary pointer - to function value.
        7. - -
      7. 'function args': argument list whose types match the function - signature argument types and parameter attributes. All arguments must be - of first class type. If the function - signature indicates the function accepts a variable number of arguments, - the extra arguments can be specified.
        8. - -
      8. The optional function attributes list. Only - 'noreturn', 'nounwind', 'readonly' and - 'readnone' attributes are valid here.
        9. -
      - -
      Semantics:
      -

      The 'call' instruction is used to cause control flow to transfer to - a specified function, with its incoming arguments bound to the specified - values. Upon a 'ret' instruction in the called - function, control flow continues with the instruction after the function - call, and the return value of the function is bound to the result - argument.

      - -
      Example:
      -
      -  %retval = call i32 @test(i32 %argc)
-  call i32 (i8 *, ...)* @printf(i8 * %msg, i32 12, i8 42)      ; yields i32
-  %X = tail call i32 @foo()                                    ; yields i32
-  %Y = tail call fastcc i32 @foo()  ; yields i32
-  call void %foo(i8 97 signext)
-
-  %struct.A = type { i32, i8 }
-  %r = call %struct.A @foo()                        ; yields { 32, i8 }
-  %gr = extractvalue %struct.A %r, 0                ; yields i32
-  %gr1 = extractvalue %struct.A %r, 1               ; yields i8
-  %Z = call void @foo() noreturn                    ; indicates that %foo never returns normally
-  %ZZ = call zeroext i32 @bar()                     ; Return value is %zero extended
-
      - -

      llvm treats calls to some functions with names and arguments that match the -standard C99 library as being the C99 library functions, and may perform -optimizations or generate code for them under that assumption. This is -something we'd like to change in the future to provide better support for -freestanding environments and non-C-based languages.

      - -
      - - -
      - 'va_arg' Instruction -
      - -
      - -
      Syntax:
      -
      -  <resultval> = va_arg <va_list*> <arglist>, <argty>
-
      - -
      Overview:
      -

      The 'va_arg' instruction is used to access arguments passed through - the "variable argument" area of a function call. It is used to implement the - va_arg macro in C.

      - -
      Arguments:
      -

      This instruction takes a va_list* value and the type of the - argument. It returns a value of the specified argument type and increments - the va_list to point to the next argument. The actual type - of va_list is target specific.

      - -
      Semantics:
      -

      The 'va_arg' instruction loads an argument of the specified type - from the specified va_list and causes the va_list to point - to the next argument. For more information, see the variable argument - handling Intrinsic Functions.

      - -

      It is legal for this instruction to be called in a function which does not - take a variable number of arguments, for example, the vfprintf - function.

      - -

      va_arg is an LLVM instruction instead of - an intrinsic function because it takes a type as an - argument.

      - -
      Example:
      -

      See the variable argument processing section.

      - -

      Note that the code generator does not yet fully support va_arg on many - targets. Also, it does not currently support va_arg with aggregate types on - any target.

      - -
      - - -
      Intrinsic Functions
      - - -
      - -

      LLVM supports the notion of an "intrinsic function". These functions have - well known names and semantics and are required to follow certain - restrictions. Overall, these intrinsics represent an extension mechanism for - the LLVM language that does not require changing all of the transformations - in LLVM when adding to the language (or the bitcode reader/writer, the - parser, etc...).

      - -

      Intrinsic function names must all start with an "llvm." prefix. This - prefix is reserved in LLVM for intrinsic names; thus, function names may not - begin with this prefix. Intrinsic functions must always be external - functions: you cannot define the body of intrinsic functions. Intrinsic - functions may only be used in call or invoke instructions: it is illegal to - take the address of an intrinsic function. Additionally, because intrinsic - functions are part of the LLVM language, it is required if any are added that - they be documented here.

      - -

      Some intrinsic functions can be overloaded, i.e., the intrinsic represents a - family of functions that perform the same operation but on different data - types. Because LLVM can represent over 8 million different integer types, - overloading is used commonly to allow an intrinsic function to operate on any - integer type. One or more of the argument types or the result type can be - overloaded to accept any integer type. Argument types may also be defined as - exactly matching a previous argument's type or the result type. This allows - an intrinsic function which accepts multiple arguments, but needs all of them - to be of the same type, to only be overloaded with respect to a single - argument or the result.

      - -

      Overloaded intrinsics will have the names of its overloaded argument types - encoded into its function name, each preceded by a period. Only those types - which are overloaded result in a name suffix. Arguments whose type is matched - against another type do not. For example, the llvm.ctpop function - can take an integer of any width and returns an integer of exactly the same - integer width. This leads to a family of functions such as - i8 @llvm.ctpop.i8(i8 %val) and i29 @llvm.ctpop.i29(i29 - %val). Only one type, the return type, is overloaded, and only one type - suffix is required. Because the argument's type is matched against the return - type, it does not require its own name suffix.

      - -

      To learn how to add an intrinsic function, please see the - Extending LLVM Guide.

      - -
      - - -
      - Variable Argument Handling Intrinsics -
      - -
      - -

      Variable argument support is defined in LLVM with - the va_arg instruction and these three - intrinsic functions. These functions are related to the similarly named - macros defined in the <stdarg.h> header file.

      - -

      All of these functions operate on arguments that use a target-specific value - type "va_list". The LLVM assembly language reference manual does - not define what this type is, so all transformations should be prepared to - handle these functions regardless of the type used.

      - -

      This example shows how the va_arg - instruction and the variable argument handling intrinsic functions are - used.

      - -
      -
      -define i32 @test(i32 %X, ...) {
-  ; Initialize variable argument processing
-  %ap = alloca i8*
-  %ap2 = bitcast i8** %ap to i8*
-  call void @llvm.va_start(i8* %ap2)
-
-  ; Read a single integer argument
-  %tmp = va_arg i8** %ap, i32
-
-  ; Demonstrate usage of llvm.va_copy and llvm.va_end
-  %aq = alloca i8*
-  %aq2 = bitcast i8** %aq to i8*
-  call void @llvm.va_copy(i8* %aq2, i8* %ap2)
-  call void @llvm.va_end(i8* %aq2)
-
-  ; Stop processing of arguments.
-  call void @llvm.va_end(i8* %ap2)
-  ret i32 %tmp
-}
-
-declare void @llvm.va_start(i8*)
-declare void @llvm.va_copy(i8*, i8*)
-declare void @llvm.va_end(i8*)
-
      -
      - -
      - - -
      - 'llvm.va_start' Intrinsic -
      - - -
      - -
      Syntax:
      -
      -  declare void %llvm.va_start(i8* <arglist>)
-
      - -
      Overview:
      -

      The 'llvm.va_start' intrinsic initializes *<arglist> - for subsequent use by va_arg.

      - -
      Arguments:
      -

      The argument is a pointer to a va_list element to initialize.

      - -
      Semantics:
      -

      The 'llvm.va_start' intrinsic works just like the va_start - macro available in C. In a target-dependent way, it initializes - the va_list element to which the argument points, so that the next - call to va_arg will produce the first variable argument passed to - the function. Unlike the C va_start macro, this intrinsic does not - need to know the last argument of the function as the compiler can figure - that out.

      - -
      - - -
      - 'llvm.va_end' Intrinsic -
      - -
      - -
      Syntax:
      -
      -  declare void @llvm.va_end(i8* <arglist>)
-
      - -
      Overview:
      -

      The 'llvm.va_end' intrinsic destroys *<arglist>, - which has been initialized previously - with llvm.va_start - or llvm.va_copy.

      - -
      Arguments:
      -

      The argument is a pointer to a va_list to destroy.

      - -
      Semantics:
      -

      The 'llvm.va_end' intrinsic works just like the va_end - macro available in C. In a target-dependent way, it destroys - the va_list element to which the argument points. Calls - to llvm.va_start - and llvm.va_copy must be matched exactly - with calls to llvm.va_end.

      - -
      - - -
      - 'llvm.va_copy' Intrinsic -
      - -
      - -
      Syntax:
      -
      -  declare void @llvm.va_copy(i8* <destarglist>, i8* <srcarglist>)
-
      - -
      Overview:
      -

      The 'llvm.va_copy' intrinsic copies the current argument position - from the source argument list to the destination argument list.

      - -
      Arguments:
      -

      The first argument is a pointer to a va_list element to initialize. - The second argument is a pointer to a va_list element to copy - from.

      - -
      Semantics:
      -

      The 'llvm.va_copy' intrinsic works just like the va_copy - macro available in C. In a target-dependent way, it copies the - source va_list element into the destination va_list - element. This intrinsic is necessary because - the llvm.va_start intrinsic may be - arbitrarily complex and require, for example, memory allocation.

      - -
      - - -
      - Accurate Garbage Collection Intrinsics -
      - -
      - -

      LLVM support for Accurate Garbage -Collection (GC) requires the implementation and generation of these -intrinsics. These intrinsics allow identification of GC -roots on the stack, as well as garbage collector implementations that -require read and write -barriers. Front-ends for type-safe garbage collected languages should generate -these intrinsics to make use of the LLVM garbage collectors. For more details, -see Accurate Garbage Collection with -LLVM.

      - -

      The garbage collection intrinsics only operate on objects in the generic - address space (address space zero).

      - -
      - - -
      - 'llvm.gcroot' Intrinsic -
      - -
      - -
      Syntax:
      -
      -  declare void @llvm.gcroot(i8** %ptrloc, i8* %metadata)
-
      - -
      Overview:
      -

      The 'llvm.gcroot' intrinsic declares the existence of a GC root to - the code generator, and allows some metadata to be associated with it.

      - -
      Arguments:
      -

      The first argument specifies the address of a stack object that contains the - root pointer. The second pointer (which must be either a constant or a - global value address) contains the meta-data to be associated with the - root.

      - -
      Semantics:
      -

      At runtime, a call to this intrinsic stores a null pointer into the "ptrloc" - location. At compile-time, the code generator generates information to allow - the runtime to find the pointer at GC safe points. The 'llvm.gcroot' - intrinsic may only be used in a function which specifies a GC - algorithm.

      - -
      - - -
      - 'llvm.gcread' Intrinsic -
      - -
      - -
      Syntax:
      -
      -  declare i8* @llvm.gcread(i8* %ObjPtr, i8** %Ptr)
-
      - -
      Overview:
      -

      The 'llvm.gcread' intrinsic identifies reads of references from heap - locations, allowing garbage collector implementations that require read - barriers.

      - -
      Arguments:
      -

      The second argument is the address to read from, which should be an address - allocated from the garbage collector. The first object is a pointer to the - start of the referenced object, if needed by the language runtime (otherwise - null).

      - -
      Semantics:
      -

      The 'llvm.gcread' intrinsic has the same semantics as a load - instruction, but may be replaced with substantially more complex code by the - garbage collector runtime, as needed. The 'llvm.gcread' intrinsic - may only be used in a function which specifies a GC - algorithm.

      - -
      - - -
      - 'llvm.gcwrite' Intrinsic -
      - -
      - -
      Syntax:
      -
      -  declare void @llvm.gcwrite(i8* %P1, i8* %Obj, i8** %P2)
-
      - -
      Overview:
      -

      The 'llvm.gcwrite' intrinsic identifies writes of references to heap - locations, allowing garbage collector implementations that require write - barriers (such as generational or reference counting collectors).

      - -
      Arguments:
      -

      The first argument is the reference to store, the second is the start of the - object to store it to, and the third is the address of the field of Obj to - store to. If the runtime does not require a pointer to the object, Obj may - be null.

      - -
      Semantics:
      -

      The 'llvm.gcwrite' intrinsic has the same semantics as a store - instruction, but may be replaced with substantially more complex code by the - garbage collector runtime, as needed. The 'llvm.gcwrite' intrinsic - may only be used in a function which specifies a GC - algorithm.

      - -
      - - -
      - Code Generator Intrinsics -
      - -
      - -

      These intrinsics are provided by LLVM to expose special features that may - only be implemented with code generator support.

      - -
      - - -
      - 'llvm.returnaddress' Intrinsic -
      - -
      - -
      Syntax:
      -
      -  declare i8  *@llvm.returnaddress(i32 <level>)
-
      - -
      Overview:
      -

      The 'llvm.returnaddress' intrinsic attempts to compute a - target-specific value indicating the return address of the current function - or one of its callers.

      - -
      Arguments:
      -

      The argument to this intrinsic indicates which function to return the address - for. Zero indicates the calling function, one indicates its caller, etc. - The argument is required to be a constant integer value.

      - -
      Semantics:
      -

      The 'llvm.returnaddress' intrinsic either returns a pointer - indicating the return address of the specified call frame, or zero if it - cannot be identified. The value returned by this intrinsic is likely to be - incorrect or 0 for arguments other than zero, so it should only be used for - debugging purposes.

      - -

      Note that calling this intrinsic does not prevent function inlining or other - aggressive transformations, so the value returned may not be that of the - obvious source-language caller.

      - -
      - - -
      - 'llvm.frameaddress' Intrinsic -
      - -
      - -
      Syntax:
      -
      -  declare i8 *@llvm.frameaddress(i32 <level>)
-
      - -
      Overview:
      -

      The 'llvm.frameaddress' intrinsic attempts to return the - target-specific frame pointer value for the specified stack frame.

      - -
      Arguments:
      -

      The argument to this intrinsic indicates which function to return the frame - pointer for. Zero indicates the calling function, one indicates its caller, - etc. The argument is required to be a constant integer value.

      - -
      Semantics:
      -

      The 'llvm.frameaddress' intrinsic either returns a pointer - indicating the frame address of the specified call frame, or zero if it - cannot be identified. The value returned by this intrinsic is likely to be - incorrect or 0 for arguments other than zero, so it should only be used for - debugging purposes.

      - -

      Note that calling this intrinsic does not prevent function inlining or other - aggressive transformations, so the value returned may not be that of the - obvious source-language caller.

      - -
      - - -
      - 'llvm.stacksave' Intrinsic -
      - -
      - -
      Syntax:
      -
      -  declare i8 *@llvm.stacksave()
-
      - -
      Overview:
      -

      The 'llvm.stacksave' intrinsic is used to remember the current state - of the function stack, for use - with llvm.stackrestore. This is - useful for implementing language features like scoped automatic variable - sized arrays in C99.

      - -
      Semantics:
      -

      This intrinsic returns a opaque pointer value that can be passed - to llvm.stackrestore. When - an llvm.stackrestore intrinsic is executed with a value saved - from llvm.stacksave, it effectively restores the state of the stack - to the state it was in when the llvm.stacksave intrinsic executed. - In practice, this pops any alloca blocks from the - stack that were allocated after the llvm.stacksave was executed.

      - -
      - - -
      - 'llvm.stackrestore' Intrinsic -
      - -
      - -
      Syntax:
      -
      -  declare void @llvm.stackrestore(i8 * %ptr)
-
      - -
      Overview:
      -

      The 'llvm.stackrestore' intrinsic is used to restore the state of - the function stack to the state it was in when the - corresponding llvm.stacksave intrinsic - executed. This is useful for implementing language features like scoped - automatic variable sized arrays in C99.

      - -
      Semantics:
      -

      See the description - for llvm.stacksave.

      - -
      - - -
      - 'llvm.prefetch' Intrinsic -
      - -
      - -
      Syntax:
      -
      -  declare void @llvm.prefetch(i8* <address>, i32 <rw>, i32 <locality>)
-
      - -
      Overview:
      -

      The 'llvm.prefetch' intrinsic is a hint to the code generator to - insert a prefetch instruction if supported; otherwise, it is a noop. - Prefetches have no effect on the behavior of the program but can change its - performance characteristics.

      - -
      Arguments:
      -

      address is the address to be prefetched, rw is the - specifier determining if the fetch should be for a read (0) or write (1), - and locality is a temporal locality specifier ranging from (0) - no - locality, to (3) - extremely local keep in cache. The rw - and locality arguments must be constant integers.

      - -
      Semantics:
      -

      This intrinsic does not modify the behavior of the program. In particular, - prefetches cannot trap and do not produce a value. On targets that support - this intrinsic, the prefetch can provide hints to the processor cache for - better performance.

      - -
      - - -
      - 'llvm.pcmarker' Intrinsic -
      - -
      - -
      Syntax:
      -
      -  declare void @llvm.pcmarker(i32 <id>)
-
      - -
      Overview:
      -

      The 'llvm.pcmarker' intrinsic is a method to export a Program - Counter (PC) in a region of code to simulators and other tools. The method - is target specific, but it is expected that the marker will use exported - symbols to transmit the PC of the marker. The marker makes no guarantees - that it will remain with any specific instruction after optimizations. It is - possible that the presence of a marker will inhibit optimizations. The - intended use is to be inserted after optimizations to allow correlations of - simulation runs.

      - -
      Arguments:
      -

      id is a numerical id identifying the marker.

      - -
      Semantics:
      -

      This intrinsic does not modify the behavior of the program. Backends that do - not support this intrinsic may ignore it.

      - -
      - - -
      - 'llvm.readcyclecounter' Intrinsic -
      - -
      - -
      Syntax:
      -
      -  declare i64 @llvm.readcyclecounter( )
-
      - -
      Overview:
      -

      The 'llvm.readcyclecounter' intrinsic provides access to the cycle - counter register (or similar low latency, high accuracy clocks) on those - targets that support it. On X86, it should map to RDTSC. On Alpha, it - should map to RPCC. As the backing counters overflow quickly (on the order - of 9 seconds on alpha), this should only be used for small timings.

      - -
      Semantics:
      -

      When directly supported, reading the cycle counter should not modify any - memory. Implementations are allowed to either return a application specific - value or a system wide value. On backends without support, this is lowered - to a constant 0.

      - -
      - - -
      - Standard C Library Intrinsics -
      - -
      - -

      LLVM provides intrinsics for a few important standard C library functions. - These intrinsics allow source-language front-ends to pass information about - the alignment of the pointer arguments to the code generator, providing - opportunity for more efficient code generation.

      - -
      - - -
      - 'llvm.memcpy' Intrinsic -
      - -
      - -
      Syntax:
      -

      This is an overloaded intrinsic. You can use llvm.memcpy on any - integer bit width and for different address spaces. Not all targets support - all bit widths however.

      - -
      -  declare void @llvm.memcpy.p0i8.p0i8.i32(i8 * <dest>, i8 * <src>,
-                                          i32 <len>, i32 <align>, i1 <isvolatile>)
-  declare void @llvm.memcpy.p0i8.p0i8.i64(i8 * <dest>, i8 * <src>,
-                                          i64 <len>, i32 <align>, i1 <isvolatile>)
-
      - -
      Overview:
      -

      The 'llvm.memcpy.*' intrinsics copy a block of memory from the - source location to the destination location.

      - -

      Note that, unlike the standard libc function, the llvm.memcpy.* - intrinsics do not return a value, takes extra alignment/isvolatile arguments - and the pointers can be in specified address spaces.

      - -
      Arguments:
      - -

      The first argument is a pointer to the destination, the second is a pointer - to the source. The third argument is an integer argument specifying the - number of bytes to copy, the fourth argument is the alignment of the - source and destination locations, and the fifth is a boolean indicating a - volatile access.

      - -

      If the call to this intrinsic has an alignment value that is not 0 or 1, - then the caller guarantees that both the source and destination pointers are - aligned to that boundary.

      - -

      If the isvolatile parameter is true, the - llvm.memcpy call is a volatile operation. - The detailed access behavior is not very cleanly specified and it is unwise - to depend on it.

      - -
      Semantics:
      - -

      The 'llvm.memcpy.*' intrinsics copy a block of memory from the - source location to the destination location, which are not allowed to - overlap. It copies "len" bytes of memory over. If the argument is known to - be aligned to some boundary, this can be specified as the fourth argument, - otherwise it should be set to 0 or 1.

      - -
      - - -
      - 'llvm.memmove' Intrinsic -
      - -
      - -
      Syntax:
      -

      This is an overloaded intrinsic. You can use llvm.memmove on any integer bit - width and for different address space. Not all targets support all bit - widths however.

      - -
      -  declare void @llvm.memmove.p0i8.p0i8.i32(i8 * <dest>, i8 * <src>,
-                                           i32 <len>, i32 <align>, i1 <isvolatile>)
-  declare void @llvm.memmove.p0i8.p0i8.i64(i8 * <dest>, i8 * <src>,
-                                           i64 <len>, i32 <align>, i1 <isvolatile>)
-
      - -
      Overview:
      -

      The 'llvm.memmove.*' intrinsics move a block of memory from the - source location to the destination location. It is similar to the - 'llvm.memcpy' intrinsic but allows the two memory locations to - overlap.

      - -

      Note that, unlike the standard libc function, the llvm.memmove.* - intrinsics do not return a value, takes extra alignment/isvolatile arguments - and the pointers can be in specified address spaces.

      - -
      Arguments:
      - -

      The first argument is a pointer to the destination, the second is a pointer - to the source. The third argument is an integer argument specifying the - number of bytes to copy, the fourth argument is the alignment of the - source and destination locations, and the fifth is a boolean indicating a - volatile access.

      - -

      If the call to this intrinsic has an alignment value that is not 0 or 1, - then the caller guarantees that the source and destination pointers are - aligned to that boundary.

      - -

      If the isvolatile parameter is true, the - llvm.memmove call is a volatile operation. - The detailed access behavior is not very cleanly specified and it is unwise - to depend on it.

      - -
      Semantics:
      - -

      The 'llvm.memmove.*' intrinsics copy a block of memory from the - source location to the destination location, which may overlap. It copies - "len" bytes of memory over. If the argument is known to be aligned to some - boundary, this can be specified as the fourth argument, otherwise it should - be set to 0 or 1.

      - -
      - - -
      - 'llvm.memset.*' Intrinsics -
      - -
      - -
      Syntax:
      -

      This is an overloaded intrinsic. You can use llvm.memset on any integer bit - width and for different address spaces. Not all targets support all bit - widths however.

      - -
      -  declare void @llvm.memset.p0i8.i32(i8 * <dest>, i8 <val>,
-                                     i32 <len>, i32 <align>, i1 <isvolatile>)
-  declare void @llvm.memset.p0i8.i64(i8 * <dest>, i8 <val>,
-                                     i64 <len>, i32 <align>, i1 <isvolatile>)
-
      - -
      Overview:
      -

      The 'llvm.memset.*' intrinsics fill a block of memory with a - particular byte value.

      - -

      Note that, unlike the standard libc function, the llvm.memset - intrinsic does not return a value, takes extra alignment/volatile arguments, - and the destination can be in an arbitrary address space.

      - -
      Arguments:
      -

      The first argument is a pointer to the destination to fill, the second is the - byte value to fill it with, the third argument is an integer argument - specifying the number of bytes to fill, and the fourth argument is the known - alignment of destination location.

      - -

      If the call to this intrinsic has an alignment value that is not 0 or 1, - then the caller guarantees that the destination pointer is aligned to that - boundary.

      - -

      If the isvolatile parameter is true, the - llvm.memset call is a volatile operation. - The detailed access behavior is not very cleanly specified and it is unwise - to depend on it.

      - -
      Semantics:
      -

      The 'llvm.memset.*' intrinsics fill "len" bytes of memory starting - at the destination location. If the argument is known to be aligned to some - boundary, this can be specified as the fourth argument, otherwise it should - be set to 0 or 1.

      - -
      - - -
      - 'llvm.sqrt.*' Intrinsic -
      - -
      - -
      Syntax:
      -

      This is an overloaded intrinsic. You can use llvm.sqrt on any - floating point or vector of floating point type. Not all targets support all - types however.

      - -
      -  declare float     @llvm.sqrt.f32(float %Val)
-  declare double    @llvm.sqrt.f64(double %Val)
-  declare x86_fp80  @llvm.sqrt.f80(x86_fp80 %Val)
-  declare fp128     @llvm.sqrt.f128(fp128 %Val)
-  declare ppc_fp128 @llvm.sqrt.ppcf128(ppc_fp128 %Val)
-
      - -
      Overview:
      -

      The 'llvm.sqrt' intrinsics return the sqrt of the specified operand, - returning the same value as the libm 'sqrt' functions would. - Unlike sqrt in libm, however, llvm.sqrt has undefined - behavior for negative numbers other than -0.0 (which allows for better - optimization, because there is no need to worry about errno being - set). llvm.sqrt(-0.0) is defined to return -0.0 like IEEE sqrt.

      - -
      Arguments:
      -

      The argument and return value are floating point numbers of the same - type.

      - -
      Semantics:
      -

      This function returns the sqrt of the specified operand if it is a - nonnegative floating point number.

      - -
      - - -
      - 'llvm.powi.*' Intrinsic -
      - -
      - -
      Syntax:
      -

      This is an overloaded intrinsic. You can use llvm.powi on any - floating point or vector of floating point type. Not all targets support all - types however.

      - -
      -  declare float     @llvm.powi.f32(float  %Val, i32 %power)
-  declare double    @llvm.powi.f64(double %Val, i32 %power)
-  declare x86_fp80  @llvm.powi.f80(x86_fp80  %Val, i32 %power)
-  declare fp128     @llvm.powi.f128(fp128 %Val, i32 %power)
-  declare ppc_fp128 @llvm.powi.ppcf128(ppc_fp128  %Val, i32 %power)
-
      - -
      Overview:
      -

      The 'llvm.powi.*' intrinsics return the first operand raised to the - specified (positive or negative) power. The order of evaluation of - multiplications is not defined. When a vector of floating point type is - used, the second argument remains a scalar integer value.

      - -
      Arguments:
      -

      The second argument is an integer power, and the first is a value to raise to - that power.

      - -
      Semantics:
      -

      This function returns the first value raised to the second power with an - unspecified sequence of rounding operations.

      - -
      - - -
      - 'llvm.sin.*' Intrinsic -
      - -
      - -
      Syntax:
      -

      This is an overloaded intrinsic. You can use llvm.sin on any - floating point or vector of floating point type. Not all targets support all - types however.

      - -
      -  declare float     @llvm.sin.f32(float  %Val)
-  declare double    @llvm.sin.f64(double %Val)
-  declare x86_fp80  @llvm.sin.f80(x86_fp80  %Val)
-  declare fp128     @llvm.sin.f128(fp128 %Val)
-  declare ppc_fp128 @llvm.sin.ppcf128(ppc_fp128  %Val)
-
      - -
      Overview:
      -

      The 'llvm.sin.*' intrinsics return the sine of the operand.

      - -
      Arguments:
      -

      The argument and return value are floating point numbers of the same - type.

      - -
      Semantics:
      -

      This function returns the sine of the specified operand, returning the same - values as the libm sin functions would, and handles error conditions - in the same way.

      - -
      - - -
      - 'llvm.cos.*' Intrinsic -
      - -
      - -
      Syntax:
      -

      This is an overloaded intrinsic. You can use llvm.cos on any - floating point or vector of floating point type. Not all targets support all - types however.

      - -
      -  declare float     @llvm.cos.f32(float  %Val)
-  declare double    @llvm.cos.f64(double %Val)
-  declare x86_fp80  @llvm.cos.f80(x86_fp80  %Val)
-  declare fp128     @llvm.cos.f128(fp128 %Val)
-  declare ppc_fp128 @llvm.cos.ppcf128(ppc_fp128  %Val)
-
      - -
      Overview:
      -

      The 'llvm.cos.*' intrinsics return the cosine of the operand.

      - -
      Arguments:
      -

      The argument and return value are floating point numbers of the same - type.

      - -
      Semantics:
      -

      This function returns the cosine of the specified operand, returning the same - values as the libm cos functions would, and handles error conditions - in the same way.

      - -
      - - -
      - 'llvm.pow.*' Intrinsic -
      - -
      - -
      Syntax:
      -

      This is an overloaded intrinsic. You can use llvm.pow on any - floating point or vector of floating point type. Not all targets support all - types however.

      - -
      -  declare float     @llvm.pow.f32(float  %Val, float %Power)
-  declare double    @llvm.pow.f64(double %Val, double %Power)
-  declare x86_fp80  @llvm.pow.f80(x86_fp80  %Val, x86_fp80 %Power)
-  declare fp128     @llvm.pow.f128(fp128 %Val, fp128 %Power)
-  declare ppc_fp128 @llvm.pow.ppcf128(ppc_fp128  %Val, ppc_fp128 Power)
-
      - -
      Overview:
      -

      The 'llvm.pow.*' intrinsics return the first operand raised to the - specified (positive or negative) power.

      - -
      Arguments:
      -

      The second argument is a floating point power, and the first is a value to - raise to that power.

      - -
      Semantics:
      -

      This function returns the first value raised to the second power, returning - the same values as the libm pow functions would, and handles error - conditions in the same way.

      - -
      - - -
      - Bit Manipulation Intrinsics -
      - -
      - -

      LLVM provides intrinsics for a few important bit manipulation operations. - These allow efficient code generation for some algorithms.

      - -
      - - -
      - 'llvm.bswap.*' Intrinsics -
      - -
      - -
      Syntax:
      -

      This is an overloaded intrinsic function. You can use bswap on any integer - type that is an even number of bytes (i.e. BitWidth % 16 == 0).

      - -
      -  declare i16 @llvm.bswap.i16(i16 <id>)
-  declare i32 @llvm.bswap.i32(i32 <id>)
-  declare i64 @llvm.bswap.i64(i64 <id>)
-
      - -
      Overview:
      -

      The 'llvm.bswap' family of intrinsics is used to byte swap integer - values with an even number of bytes (positive multiple of 16 bits). These - are useful for performing operations on data that is not in the target's - native byte order.

      - -
      Semantics:
      -

      The llvm.bswap.i16 intrinsic returns an i16 value that has the high - and low byte of the input i16 swapped. Similarly, - the llvm.bswap.i32 intrinsic returns an i32 value that has the four - bytes of the input i32 swapped, so that if the input bytes are numbered 0, 1, - 2, 3 then the returned i32 will have its bytes in 3, 2, 1, 0 order. - The llvm.bswap.i48, llvm.bswap.i64 and other intrinsics - extend this concept to additional even-byte lengths (6 bytes, 8 bytes and - more, respectively).

      - -
      - - -
      - 'llvm.ctpop.*' Intrinsic -
      - -
      - -
      Syntax:
      -

      This is an overloaded intrinsic. You can use llvm.ctpop on any integer bit - width. Not all targets support all bit widths however.

      - -
      -  declare i8 @llvm.ctpop.i8(i8  <src>)
-  declare i16 @llvm.ctpop.i16(i16 <src>)
-  declare i32 @llvm.ctpop.i32(i32 <src>)
-  declare i64 @llvm.ctpop.i64(i64 <src>)
-  declare i256 @llvm.ctpop.i256(i256 <src>)
-
      - -
      Overview:
      -

      The 'llvm.ctpop' family of intrinsics counts the number of bits set - in a value.

      - -
      Arguments:
      -

      The only argument is the value to be counted. The argument may be of any - integer type. The return type must match the argument type.

      - -
      Semantics:
      -

      The 'llvm.ctpop' intrinsic counts the 1's in a variable.

      - -
      - - -
      - 'llvm.ctlz.*' Intrinsic -
      - -
      - -
      Syntax:
      -

      This is an overloaded intrinsic. You can use llvm.ctlz on any - integer bit width. Not all targets support all bit widths however.

      - -
      -  declare i8 @llvm.ctlz.i8 (i8  <src>)
-  declare i16 @llvm.ctlz.i16(i16 <src>)
-  declare i32 @llvm.ctlz.i32(i32 <src>)
-  declare i64 @llvm.ctlz.i64(i64 <src>)
-  declare i256 @llvm.ctlz.i256(i256 <src>)
-
      - -
      Overview:
      -

      The 'llvm.ctlz' family of intrinsic functions counts the number of - leading zeros in a variable.

      - -
      Arguments:
      -

      The only argument is the value to be counted. The argument may be of any - integer type. The return type must match the argument type.

      - -
      Semantics:
      -

      The 'llvm.ctlz' intrinsic counts the leading (most significant) - zeros in a variable. If the src == 0 then the result is the size in bits of - the type of src. For example, llvm.ctlz(i32 2) = 30.

      - -
      - - -
      - 'llvm.cttz.*' Intrinsic -
      - -
      - -
      Syntax:
      -

      This is an overloaded intrinsic. You can use llvm.cttz on any - integer bit width. Not all targets support all bit widths however.

      - -
      -  declare i8 @llvm.cttz.i8 (i8  <src>)
-  declare i16 @llvm.cttz.i16(i16 <src>)
-  declare i32 @llvm.cttz.i32(i32 <src>)
-  declare i64 @llvm.cttz.i64(i64 <src>)
-  declare i256 @llvm.cttz.i256(i256 <src>)
-
      - -
      Overview:
      -

      The 'llvm.cttz' family of intrinsic functions counts the number of - trailing zeros.

      - -
      Arguments:
      -

      The only argument is the value to be counted. The argument may be of any - integer type. The return type must match the argument type.

      - -
      Semantics:
      -

      The 'llvm.cttz' intrinsic counts the trailing (least significant) - zeros in a variable. If the src == 0 then the result is the size in bits of - the type of src. For example, llvm.cttz(2) = 1.

      - -
      - - -
      - Arithmetic with Overflow Intrinsics -
      - -
      - -

      LLVM provides intrinsics for some arithmetic with overflow operations.

      - -
      - - -
      - 'llvm.sadd.with.overflow.*' Intrinsics -
      - -
      - -
      Syntax:
      -

      This is an overloaded intrinsic. You can use llvm.sadd.with.overflow - on any integer bit width.

      - -
      -  declare {i16, i1} @llvm.sadd.with.overflow.i16(i16 %a, i16 %b)
-  declare {i32, i1} @llvm.sadd.with.overflow.i32(i32 %a, i32 %b)
-  declare {i64, i1} @llvm.sadd.with.overflow.i64(i64 %a, i64 %b)
-
      - -
      Overview:
      -

      The 'llvm.sadd.with.overflow' family of intrinsic functions perform - a signed addition of the two arguments, and indicate whether an overflow - occurred during the signed summation.

      - -
      Arguments:
      -

      The arguments (%a and %b) and the first element of the result structure may - be of integer types of any bit width, but they must have the same bit - width. The second element of the result structure must be of - type i1. %a and %b are the two values that will - undergo signed addition.

      - -
      Semantics:
      -

      The 'llvm.sadd.with.overflow' family of intrinsic functions perform - a signed addition of the two variables. They return a structure — the - first element of which is the signed summation, and the second element of - which is a bit specifying if the signed summation resulted in an - overflow.

      - -
      Examples:
      -
      -  %res = call {i32, i1} @llvm.sadd.with.overflow.i32(i32 %a, i32 %b)
-  %sum = extractvalue {i32, i1} %res, 0
-  %obit = extractvalue {i32, i1} %res, 1
-  br i1 %obit, label %overflow, label %normal
-
      - -
      - - -
      - 'llvm.uadd.with.overflow.*' Intrinsics -
      - -
      - -
      Syntax:
      -

      This is an overloaded intrinsic. You can use llvm.uadd.with.overflow - on any integer bit width.

      - -
      -  declare {i16, i1} @llvm.uadd.with.overflow.i16(i16 %a, i16 %b)
-  declare {i32, i1} @llvm.uadd.with.overflow.i32(i32 %a, i32 %b)
-  declare {i64, i1} @llvm.uadd.with.overflow.i64(i64 %a, i64 %b)
-
      - -
      Overview:
      -

      The 'llvm.uadd.with.overflow' family of intrinsic functions perform - an unsigned addition of the two arguments, and indicate whether a carry - occurred during the unsigned summation.

      - -
      Arguments:
      -

      The arguments (%a and %b) and the first element of the result structure may - be of integer types of any bit width, but they must have the same bit - width. The second element of the result structure must be of - type i1. %a and %b are the two values that will - undergo unsigned addition.

      - -
      Semantics:
      -

      The 'llvm.uadd.with.overflow' family of intrinsic functions perform - an unsigned addition of the two arguments. They return a structure — - the first element of which is the sum, and the second element of which is a - bit specifying if the unsigned summation resulted in a carry.

      - -
      Examples:
      -
      -  %res = call {i32, i1} @llvm.uadd.with.overflow.i32(i32 %a, i32 %b)
-  %sum = extractvalue {i32, i1} %res, 0
-  %obit = extractvalue {i32, i1} %res, 1
-  br i1 %obit, label %carry, label %normal
-
      - -
      - - -
      - 'llvm.ssub.with.overflow.*' Intrinsics -
      - -
      - -
      Syntax:
      -

      This is an overloaded intrinsic. You can use llvm.ssub.with.overflow - on any integer bit width.

      - -
      -  declare {i16, i1} @llvm.ssub.with.overflow.i16(i16 %a, i16 %b)
-  declare {i32, i1} @llvm.ssub.with.overflow.i32(i32 %a, i32 %b)
-  declare {i64, i1} @llvm.ssub.with.overflow.i64(i64 %a, i64 %b)
-
      - -
      Overview:
      -

      The 'llvm.ssub.with.overflow' family of intrinsic functions perform - a signed subtraction of the two arguments, and indicate whether an overflow - occurred during the signed subtraction.

      - -
      Arguments:
      -

      The arguments (%a and %b) and the first element of the result structure may - be of integer types of any bit width, but they must have the same bit - width. The second element of the result structure must be of - type i1. %a and %b are the two values that will - undergo signed subtraction.

      - -
      Semantics:
      -

      The 'llvm.ssub.with.overflow' family of intrinsic functions perform - a signed subtraction of the two arguments. They return a structure — - the first element of which is the subtraction, and the second element of - which is a bit specifying if the signed subtraction resulted in an - overflow.

      - -
      Examples:
      -
      -  %res = call {i32, i1} @llvm.ssub.with.overflow.i32(i32 %a, i32 %b)
-  %sum = extractvalue {i32, i1} %res, 0
-  %obit = extractvalue {i32, i1} %res, 1
-  br i1 %obit, label %overflow, label %normal
-
      - -
      - - -
      - 'llvm.usub.with.overflow.*' Intrinsics -
      - -
      - -
      Syntax:
      -

      This is an overloaded intrinsic. You can use llvm.usub.with.overflow - on any integer bit width.

      - -
      -  declare {i16, i1} @llvm.usub.with.overflow.i16(i16 %a, i16 %b)
-  declare {i32, i1} @llvm.usub.with.overflow.i32(i32 %a, i32 %b)
-  declare {i64, i1} @llvm.usub.with.overflow.i64(i64 %a, i64 %b)
-
      - -
      Overview:
      -

      The 'llvm.usub.with.overflow' family of intrinsic functions perform - an unsigned subtraction of the two arguments, and indicate whether an - overflow occurred during the unsigned subtraction.

      - -
      Arguments:
      -

      The arguments (%a and %b) and the first element of the result structure may - be of integer types of any bit width, but they must have the same bit - width. The second element of the result structure must be of - type i1. %a and %b are the two values that will - undergo unsigned subtraction.

      - -
      Semantics:
      -

      The 'llvm.usub.with.overflow' family of intrinsic functions perform - an unsigned subtraction of the two arguments. They return a structure — - the first element of which is the subtraction, and the second element of - which is a bit specifying if the unsigned subtraction resulted in an - overflow.

      - -
      Examples:
      -
      -  %res = call {i32, i1} @llvm.usub.with.overflow.i32(i32 %a, i32 %b)
-  %sum = extractvalue {i32, i1} %res, 0
-  %obit = extractvalue {i32, i1} %res, 1
-  br i1 %obit, label %overflow, label %normal
-
      - -
      - - -
      - 'llvm.smul.with.overflow.*' Intrinsics -
      - -
      - -
      Syntax:
      -

      This is an overloaded intrinsic. You can use llvm.smul.with.overflow - on any integer bit width.

      - -
      -  declare {i16, i1} @llvm.smul.with.overflow.i16(i16 %a, i16 %b)
-  declare {i32, i1} @llvm.smul.with.overflow.i32(i32 %a, i32 %b)
-  declare {i64, i1} @llvm.smul.with.overflow.i64(i64 %a, i64 %b)
-
      - -
      Overview:
      - -

      The 'llvm.smul.with.overflow' family of intrinsic functions perform - a signed multiplication of the two arguments, and indicate whether an - overflow occurred during the signed multiplication.

      - -
      Arguments:
      -

      The arguments (%a and %b) and the first element of the result structure may - be of integer types of any bit width, but they must have the same bit - width. The second element of the result structure must be of - type i1. %a and %b are the two values that will - undergo signed multiplication.

      - -
      Semantics:
      -

      The 'llvm.smul.with.overflow' family of intrinsic functions perform - a signed multiplication of the two arguments. They return a structure — - the first element of which is the multiplication, and the second element of - which is a bit specifying if the signed multiplication resulted in an - overflow.

      - -
      Examples:
      -
      -  %res = call {i32, i1} @llvm.smul.with.overflow.i32(i32 %a, i32 %b)
-  %sum = extractvalue {i32, i1} %res, 0
-  %obit = extractvalue {i32, i1} %res, 1
-  br i1 %obit, label %overflow, label %normal
-
      - -
      - - -
      - 'llvm.umul.with.overflow.*' Intrinsics -
      - -
      - -
      Syntax:
      -

      This is an overloaded intrinsic. You can use llvm.umul.with.overflow - on any integer bit width.

      - -
      -  declare {i16, i1} @llvm.umul.with.overflow.i16(i16 %a, i16 %b)
-  declare {i32, i1} @llvm.umul.with.overflow.i32(i32 %a, i32 %b)
-  declare {i64, i1} @llvm.umul.with.overflow.i64(i64 %a, i64 %b)
-
      - -
      Overview:
      -

      The 'llvm.umul.with.overflow' family of intrinsic functions perform - a unsigned multiplication of the two arguments, and indicate whether an - overflow occurred during the unsigned multiplication.

      - -
      Arguments:
      -

      The arguments (%a and %b) and the first element of the result structure may - be of integer types of any bit width, but they must have the same bit - width. The second element of the result structure must be of - type i1. %a and %b are the two values that will - undergo unsigned multiplication.

      - -
      Semantics:
      -

      The 'llvm.umul.with.overflow' family of intrinsic functions perform - an unsigned multiplication of the two arguments. They return a structure - — the first element of which is the multiplication, and the second - element of which is a bit specifying if the unsigned multiplication resulted - in an overflow.

      - -
      Examples:
      -
      -  %res = call {i32, i1} @llvm.umul.with.overflow.i32(i32 %a, i32 %b)
-  %sum = extractvalue {i32, i1} %res, 0
-  %obit = extractvalue {i32, i1} %res, 1
-  br i1 %obit, label %overflow, label %normal
-
      - -
      - - -
      - Half Precision Floating Point Intrinsics -
      - -
      - -

      Half precision floating point is a storage-only format. This means that it is - a dense encoding (in memory) but does not support computation in the - format.

      - -

      This means that code must first load the half-precision floating point - value as an i16, then convert it to float with llvm.convert.from.fp16. - Computation can then be performed on the float value (including extending to - double etc). To store the value back to memory, it is first converted to - float if needed, then converted to i16 with - llvm.convert.to.fp16, then - storing as an i16 value.

      -
      - - -
      - 'llvm.convert.to.fp16' Intrinsic -
      - -
      - -
      Syntax:
      -
      -  declare i16 @llvm.convert.to.fp16(f32 %a)
-
      - -
      Overview:
      -

      The 'llvm.convert.to.fp16' intrinsic function performs - a conversion from single precision floating point format to half precision - floating point format.

      - -
      Arguments:
      -

      The intrinsic function contains single argument - the value to be - converted.

      - -
      Semantics:
      -

      The 'llvm.convert.to.fp16' intrinsic function performs - a conversion from single precision floating point format to half precision - floating point format. The return value is an i16 which - contains the converted number.

      - -
      Examples:
      -
      -  %res = call i16 @llvm.convert.to.fp16(f32 %a)
-  store i16 %res, i16* @x, align 2
-
      - -
      - - -
      - 'llvm.convert.from.fp16' Intrinsic -
      - -
      - -
      Syntax:
      -
      -  declare f32 @llvm.convert.from.fp16(i16 %a)
-
      - -
      Overview:
      -

      The 'llvm.convert.from.fp16' intrinsic function performs - a conversion from half precision floating point format to single precision - floating point format.

      - -
      Arguments:
      -

      The intrinsic function contains single argument - the value to be - converted.

      - -
      Semantics:
      -

      The 'llvm.convert.from.fp16' intrinsic function performs a - conversion from half single precision floating point format to single - precision floating point format. The input half-float value is represented by - an i16 value.

      - -
      Examples:
      -
      -  %a = load i16* @x, align 2
-  %res = call f32 @llvm.convert.from.fp16(i16 %a)
-
      - -
      - - -
      - Debugger Intrinsics -
      - -
      - -

      The LLVM debugger intrinsics (which all start with llvm.dbg. - prefix), are described in - the LLVM Source - Level Debugging document.

      - -
      - - -
      - Exception Handling Intrinsics -
      - -
      - -

      The LLVM exception handling intrinsics (which all start with - llvm.eh. prefix), are described in - the LLVM Exception - Handling document.

      - -
      - - -
      - Trampoline Intrinsic -
      - -
      - -

      This intrinsic makes it possible to excise one parameter, marked with - the nest attribute, from a function. The result is a callable - function pointer lacking the nest parameter - the caller does not need to - provide a value for it. Instead, the value to use is stored in advance in a - "trampoline", a block of memory usually allocated on the stack, which also - contains code to splice the nest value into the argument list. This is used - to implement the GCC nested function address extension.

      - -

      For example, if the function is - i32 f(i8* nest %c, i32 %x, i32 %y) then the resulting function - pointer has signature i32 (i32, i32)*. It can be created as - follows:

      - -
      -
      -  %tramp = alloca [10 x i8], align 4 ; size and alignment only correct for X86
-  %tramp1 = getelementptr [10 x i8]* %tramp, i32 0, i32 0
-  %p = call i8* @llvm.init.trampoline( i8* %tramp1, i8* bitcast (i32 (i8* nest , i32, i32)* @f to i8*), i8* %nval )
-  %fp = bitcast i8* %p to i32 (i32, i32)*
-
      -
      - -

      The call %val = call i32 %fp( i32 %x, i32 %y ) is then equivalent - to %val = call i32 %f( i8* %nval, i32 %x, i32 %y ).

      - -
      - - -
      - 'llvm.init.trampoline' Intrinsic -
      - -
      - -
      Syntax:
      -
      -  declare i8* @llvm.init.trampoline(i8* <tramp>, i8* <func>, i8* <nval>)
-
      - -
      Overview:
      -

      This fills the memory pointed to by tramp with code and returns a - function pointer suitable for executing it.

      - -
      Arguments:
      -

      The llvm.init.trampoline intrinsic takes three arguments, all - pointers. The tramp argument must point to a sufficiently large and - sufficiently aligned block of memory; this memory is written to by the - intrinsic. Note that the size and the alignment are target-specific - LLVM - currently provides no portable way of determining them, so a front-end that - generates this intrinsic needs to have some target-specific knowledge. - The func argument must hold a function bitcast to - an i8*.

      - -
      Semantics:
      -

      The block of memory pointed to by tramp is filled with target - dependent code, turning it into a function. A pointer to this function is - returned, but needs to be bitcast to an appropriate - function pointer type before being called. The new function's signature - is the same as that of func with any arguments marked with - the nest attribute removed. At most one such nest argument - is allowed, and it must be of pointer type. Calling the new function is - equivalent to calling func with the same argument list, but - with nval used for the missing nest argument. If, after - calling llvm.init.trampoline, the memory pointed to - by tramp is modified, then the effect of any later call to the - returned function pointer is undefined.

      - -
      - - -
      - Atomic Operations and Synchronization Intrinsics -
      - -
      - -

      These intrinsic functions expand the "universal IR" of LLVM to represent - hardware constructs for atomic operations and memory synchronization. This - provides an interface to the hardware, not an interface to the programmer. It - is aimed at a low enough level to allow any programming models or APIs - (Application Programming Interfaces) which need atomic behaviors to map - cleanly onto it. It is also modeled primarily on hardware behavior. Just as - hardware provides a "universal IR" for source languages, it also provides a - starting point for developing a "universal" atomic operation and - synchronization IR.

      - -

      These do not form an API such as high-level threading libraries, - software transaction memory systems, atomic primitives, and intrinsic - functions as found in BSD, GNU libc, atomic_ops, APR, and other system and - application libraries. The hardware interface provided by LLVM should allow - a clean implementation of all of these APIs and parallel programming models. - No one model or paradigm should be selected above others unless the hardware - itself ubiquitously does so.

      - -
      - - -
      - 'llvm.memory.barrier' Intrinsic -
      -
      -
      Syntax:
      -
      -  declare void @llvm.memory.barrier( i1 <ll>, i1 <ls>, i1 <sl>, i1 <ss>, i1 <device> )
-
      - -
      Overview:
      -

      The llvm.memory.barrier intrinsic guarantees ordering between - specific pairs of memory access types.

      - -
      Arguments:
      -

      The llvm.memory.barrier intrinsic requires five boolean arguments. - The first four arguments enables a specific barrier as listed below. The - fifth argument specifies that the barrier applies to io or device or uncached - memory.

      - -
        -
      • ll: load-load barrier
        • -
      • ls: load-store barrier
        • -
      • sl: store-load barrier
        • -
      • ss: store-store barrier
        • -
      • device: barrier applies to device and uncached memory also.
        • -
      - -
      Semantics:
      -

      This intrinsic causes the system to enforce some ordering constraints upon - the loads and stores of the program. This barrier does not - indicate when any events will occur, it only enforces - an order in which they occur. For any of the specified pairs of load - and store operations (f.ex. load-load, or store-load), all of the first - operations preceding the barrier will complete before any of the second - operations succeeding the barrier begin. Specifically the semantics for each - pairing is as follows:

      - -
        -
      • ll: All loads before the barrier must complete before any load - after the barrier begins.
        • -
      • ls: All loads before the barrier must complete before any - store after the barrier begins.
        • -
      • ss: All stores before the barrier must complete before any - store after the barrier begins.
        • -
      • sl: All stores before the barrier must complete before any - load after the barrier begins.
        • -
      - -

      These semantics are applied with a logical "and" behavior when more than one - is enabled in a single memory barrier intrinsic.

      - -

      Backends may implement stronger barriers than those requested when they do - not support as fine grained a barrier as requested. Some architectures do - not need all types of barriers and on such architectures, these become - noops.

      - -
      Example:
      -
      -%mallocP  = tail call i8* @malloc(i32 ptrtoint (i32* getelementptr (i32* null, i32 1) to i32))
-%ptr      = bitcast i8* %mallocP to i32*
-            store i32 4, %ptr
-
-%result1  = load i32* %ptr      ; yields {i32}:result1 = 4
-            call void @llvm.memory.barrier( i1 false, i1 true, i1 false, i1 false )
-                                ; guarantee the above finishes
-            store i32 8, %ptr   ; before this begins
-
      - -
      - - -
      - 'llvm.atomic.cmp.swap.*' Intrinsic -
      - -
      - -
      Syntax:
      -

      This is an overloaded intrinsic. You can use llvm.atomic.cmp.swap on - any integer bit width and for different address spaces. Not all targets - support all bit widths however.

      - -
      -  declare i8 @llvm.atomic.cmp.swap.i8.p0i8( i8* <ptr>, i8 <cmp>, i8 <val> )
-  declare i16 @llvm.atomic.cmp.swap.i16.p0i16( i16* <ptr>, i16 <cmp>, i16 <val> )
-  declare i32 @llvm.atomic.cmp.swap.i32.p0i32( i32* <ptr>, i32 <cmp>, i32 <val> )
-  declare i64 @llvm.atomic.cmp.swap.i64.p0i64( i64* <ptr>, i64 <cmp>, i64 <val> )
-
      - -
      Overview:
      -

      This loads a value in memory and compares it to a given value. If they are - equal, it stores a new value into the memory.

      - -
      Arguments:
      -

      The llvm.atomic.cmp.swap intrinsic takes three arguments. The result - as well as both cmp and val must be integer values with the - same bit width. The ptr argument must be a pointer to a value of - this integer type. While any bit width integer may be used, targets may only - lower representations they support in hardware.

      - -
      Semantics:
      -

      This entire intrinsic must be executed atomically. It first loads the value - in memory pointed to by ptr and compares it with the - value cmp. If they are equal, val is stored into the - memory. The loaded value is yielded in all cases. This provides the - equivalent of an atomic compare-and-swap operation within the SSA - framework.

      - -
      Examples:
      -
      -%mallocP  = tail call i8* @malloc(i32 ptrtoint (i32* getelementptr (i32* null, i32 1) to i32))
-%ptr      = bitcast i8* %mallocP to i32*
-            store i32 4, %ptr
-
-%val1     = add i32 4, 4
-%result1  = call i32 @llvm.atomic.cmp.swap.i32.p0i32( i32* %ptr, i32 4, %val1 )
-                                          ; yields {i32}:result1 = 4
-%stored1  = icmp eq i32 %result1, 4       ; yields {i1}:stored1 = true
-%memval1  = load i32* %ptr                ; yields {i32}:memval1 = 8
-
-%val2     = add i32 1, 1
-%result2  = call i32 @llvm.atomic.cmp.swap.i32.p0i32( i32* %ptr, i32 5, %val2 )
-                                          ; yields {i32}:result2 = 8
-%stored2  = icmp eq i32 %result2, 5       ; yields {i1}:stored2 = false
-
-%memval2  = load i32* %ptr                ; yields {i32}:memval2 = 8
-
      - -
      - - -
      - 'llvm.atomic.swap.*' Intrinsic -
      -
      -
      Syntax:
      - -

      This is an overloaded intrinsic. You can use llvm.atomic.swap on any - integer bit width. Not all targets support all bit widths however.

      - -
      -  declare i8 @llvm.atomic.swap.i8.p0i8( i8* <ptr>, i8 <val> )
-  declare i16 @llvm.atomic.swap.i16.p0i16( i16* <ptr>, i16 <val> )
-  declare i32 @llvm.atomic.swap.i32.p0i32( i32* <ptr>, i32 <val> )
-  declare i64 @llvm.atomic.swap.i64.p0i64( i64* <ptr>, i64 <val> )
-
      - -
      Overview:
      -

      This intrinsic loads the value stored in memory at ptr and yields - the value from memory. It then stores the value in val in the memory - at ptr.

      - -
      Arguments:
      -

      The llvm.atomic.swap intrinsic takes two arguments. Both - the val argument and the result must be integers of the same bit - width. The first argument, ptr, must be a pointer to a value of this - integer type. The targets may only lower integer representations they - support.

      - -
      Semantics:
      -

      This intrinsic loads the value pointed to by ptr, yields it, and - stores val back into ptr atomically. This provides the - equivalent of an atomic swap operation within the SSA framework.

      - -
      Examples:
      -
      -%mallocP  = tail call i8* @malloc(i32 ptrtoint (i32* getelementptr (i32* null, i32 1) to i32))
-%ptr      = bitcast i8* %mallocP to i32*
-            store i32 4, %ptr
-
-%val1     = add i32 4, 4
-%result1  = call i32 @llvm.atomic.swap.i32.p0i32( i32* %ptr, i32 %val1 )
-                                        ; yields {i32}:result1 = 4
-%stored1  = icmp eq i32 %result1, 4     ; yields {i1}:stored1 = true
-%memval1  = load i32* %ptr              ; yields {i32}:memval1 = 8
-
-%val2     = add i32 1, 1
-%result2  = call i32 @llvm.atomic.swap.i32.p0i32( i32* %ptr, i32 %val2 )
-                                        ; yields {i32}:result2 = 8
-
-%stored2  = icmp eq i32 %result2, 8     ; yields {i1}:stored2 = true
-%memval2  = load i32* %ptr              ; yields {i32}:memval2 = 2
-
      - -
      - - -
      - 'llvm.atomic.load.add.*' Intrinsic - -
      - -
      - -
      Syntax:
      -

      This is an overloaded intrinsic. You can use llvm.atomic.load.add on - any integer bit width. Not all targets support all bit widths however.

      - -
      -  declare i8 @llvm.atomic.load.add.i8.p0i8( i8* <ptr>, i8 <delta> )
-  declare i16 @llvm.atomic.load.add.i16.p0i16( i16* <ptr>, i16 <delta> )
-  declare i32 @llvm.atomic.load.add.i32.p0i32( i32* <ptr>, i32 <delta> )
-  declare i64 @llvm.atomic.load.add.i64.p0i64( i64* <ptr>, i64 <delta> )
-
      - -
      Overview:
      -

      This intrinsic adds delta to the value stored in memory - at ptr. It yields the original value at ptr.

      - -
      Arguments:
      -

      The intrinsic takes two arguments, the first a pointer to an integer value - and the second an integer value. The result is also an integer value. These - integer types can have any bit width, but they must all have the same bit - width. The targets may only lower integer representations they support.

      - -
      Semantics:
      -

      This intrinsic does a series of operations atomically. It first loads the - value stored at ptr. It then adds delta, stores the result - to ptr. It yields the original value stored at ptr.

      - -
      Examples:
      -
      -%mallocP  = tail call i8* @malloc(i32 ptrtoint (i32* getelementptr (i32* null, i32 1) to i32))
-%ptr      = bitcast i8* %mallocP to i32*
-            store i32 4, %ptr
-%result1  = call i32 @llvm.atomic.load.add.i32.p0i32( i32* %ptr, i32 4 )
-                                ; yields {i32}:result1 = 4
-%result2  = call i32 @llvm.atomic.load.add.i32.p0i32( i32* %ptr, i32 2 )
-                                ; yields {i32}:result2 = 8
-%result3  = call i32 @llvm.atomic.load.add.i32.p0i32( i32* %ptr, i32 5 )
-                                ; yields {i32}:result3 = 10
-%memval1  = load i32* %ptr      ; yields {i32}:memval1 = 15
-
      - -
      - - -
      - 'llvm.atomic.load.sub.*' Intrinsic - -
      - -
      - -
      Syntax:
      -

      This is an overloaded intrinsic. You can use llvm.atomic.load.sub on - any integer bit width and for different address spaces. Not all targets - support all bit widths however.

      - -
      -  declare i8 @llvm.atomic.load.sub.i8.p0i32( i8* <ptr>, i8 <delta> )
-  declare i16 @llvm.atomic.load.sub.i16.p0i32( i16* <ptr>, i16 <delta> )
-  declare i32 @llvm.atomic.load.sub.i32.p0i32( i32* <ptr>, i32 <delta> )
-  declare i64 @llvm.atomic.load.sub.i64.p0i32( i64* <ptr>, i64 <delta> )
-
      - -
      Overview:
      -

      This intrinsic subtracts delta to the value stored in memory at - ptr. It yields the original value at ptr.

      - -
      Arguments:
      -

      The intrinsic takes two arguments, the first a pointer to an integer value - and the second an integer value. The result is also an integer value. These - integer types can have any bit width, but they must all have the same bit - width. The targets may only lower integer representations they support.

      - -
      Semantics:
      -

      This intrinsic does a series of operations atomically. It first loads the - value stored at ptr. It then subtracts delta, stores the - result to ptr. It yields the original value stored - at ptr.

      - -
      Examples:
      -
      -%mallocP  = tail call i8* @malloc(i32 ptrtoint (i32* getelementptr (i32* null, i32 1) to i32))
-%ptr      = bitcast i8* %mallocP to i32*
-            store i32 8, %ptr
-%result1  = call i32 @llvm.atomic.load.sub.i32.p0i32( i32* %ptr, i32 4 )
-                                ; yields {i32}:result1 = 8
-%result2  = call i32 @llvm.atomic.load.sub.i32.p0i32( i32* %ptr, i32 2 )
-                                ; yields {i32}:result2 = 4
-%result3  = call i32 @llvm.atomic.load.sub.i32.p0i32( i32* %ptr, i32 5 )
-                                ; yields {i32}:result3 = 2
-%memval1  = load i32* %ptr      ; yields {i32}:memval1 = -3
-
      - -
      - - -
      - 'llvm.atomic.load.and.*' Intrinsic
      - 'llvm.atomic.load.nand.*' Intrinsic
      - 'llvm.atomic.load.or.*' Intrinsic
      - 'llvm.atomic.load.xor.*' Intrinsic
      -
      - -
      - -
      Syntax:
      -

      These are overloaded intrinsics. You can - use llvm.atomic.load_and, llvm.atomic.load_nand, - llvm.atomic.load_or, and llvm.atomic.load_xor on any integer - bit width and for different address spaces. Not all targets support all bit - widths however.

      - -
      -  declare i8 @llvm.atomic.load.and.i8.p0i8( i8* <ptr>, i8 <delta> )
-  declare i16 @llvm.atomic.load.and.i16.p0i16( i16* <ptr>, i16 <delta> )
-  declare i32 @llvm.atomic.load.and.i32.p0i32( i32* <ptr>, i32 <delta> )
-  declare i64 @llvm.atomic.load.and.i64.p0i64( i64* <ptr>, i64 <delta> )
-
      - -
      -  declare i8 @llvm.atomic.load.or.i8.p0i8( i8* <ptr>, i8 <delta> )
-  declare i16 @llvm.atomic.load.or.i16.p0i16( i16* <ptr>, i16 <delta> )
-  declare i32 @llvm.atomic.load.or.i32.p0i32( i32* <ptr>, i32 <delta> )
-  declare i64 @llvm.atomic.load.or.i64.p0i64( i64* <ptr>, i64 <delta> )
-
      - -
      -  declare i8 @llvm.atomic.load.nand.i8.p0i32( i8* <ptr>, i8 <delta> )
-  declare i16 @llvm.atomic.load.nand.i16.p0i32( i16* <ptr>, i16 <delta> )
-  declare i32 @llvm.atomic.load.nand.i32.p0i32( i32* <ptr>, i32 <delta> )
-  declare i64 @llvm.atomic.load.nand.i64.p0i32( i64* <ptr>, i64 <delta> )
-
      - -
      -  declare i8 @llvm.atomic.load.xor.i8.p0i32( i8* <ptr>, i8 <delta> )
-  declare i16 @llvm.atomic.load.xor.i16.p0i32( i16* <ptr>, i16 <delta> )
-  declare i32 @llvm.atomic.load.xor.i32.p0i32( i32* <ptr>, i32 <delta> )
-  declare i64 @llvm.atomic.load.xor.i64.p0i32( i64* <ptr>, i64 <delta> )
-
      - -
      Overview:
      -

      These intrinsics bitwise the operation (and, nand, or, xor) delta to - the value stored in memory at ptr. It yields the original value - at ptr.

      - -
      Arguments:
      -

      These intrinsics take two arguments, the first a pointer to an integer value - and the second an integer value. The result is also an integer value. These - integer types can have any bit width, but they must all have the same bit - width. The targets may only lower integer representations they support.

      - -
      Semantics:
      -

      These intrinsics does a series of operations atomically. They first load the - value stored at ptr. They then do the bitwise - operation delta, store the result to ptr. They yield the - original value stored at ptr.

      - -
      Examples:
      -
      -%mallocP  = tail call i8* @malloc(i32 ptrtoint (i32* getelementptr (i32* null, i32 1) to i32))
-%ptr      = bitcast i8* %mallocP to i32*
-            store i32 0x0F0F, %ptr
-%result0  = call i32 @llvm.atomic.load.nand.i32.p0i32( i32* %ptr, i32 0xFF )
-                                ; yields {i32}:result0 = 0x0F0F
-%result1  = call i32 @llvm.atomic.load.and.i32.p0i32( i32* %ptr, i32 0xFF )
-                                ; yields {i32}:result1 = 0xFFFFFFF0
-%result2  = call i32 @llvm.atomic.load.or.i32.p0i32( i32* %ptr, i32 0F )
-                                ; yields {i32}:result2 = 0xF0
-%result3  = call i32 @llvm.atomic.load.xor.i32.p0i32( i32* %ptr, i32 0F )
-                                ; yields {i32}:result3 = FF
-%memval1  = load i32* %ptr      ; yields {i32}:memval1 = F0
-
      - -
      - - -
      - 'llvm.atomic.load.max.*' Intrinsic
      - 'llvm.atomic.load.min.*' Intrinsic
      - 'llvm.atomic.load.umax.*' Intrinsic
      - 'llvm.atomic.load.umin.*' Intrinsic
      -
      - -
      - -
      Syntax:
      -

      These are overloaded intrinsics. You can use llvm.atomic.load_max, - llvm.atomic.load_min, llvm.atomic.load_umax, and - llvm.atomic.load_umin on any integer bit width and for different - address spaces. Not all targets support all bit widths however.

      - -
      -  declare i8 @llvm.atomic.load.max.i8.p0i8( i8* <ptr>, i8 <delta> )
-  declare i16 @llvm.atomic.load.max.i16.p0i16( i16* <ptr>, i16 <delta> )
-  declare i32 @llvm.atomic.load.max.i32.p0i32( i32* <ptr>, i32 <delta> )
-  declare i64 @llvm.atomic.load.max.i64.p0i64( i64* <ptr>, i64 <delta> )
-
      - -
      -  declare i8 @llvm.atomic.load.min.i8.p0i8( i8* <ptr>, i8 <delta> )
-  declare i16 @llvm.atomic.load.min.i16.p0i16( i16* <ptr>, i16 <delta> )
-  declare i32 @llvm.atomic.load.min.i32.p0i32( i32* <ptr>, i32 <delta> )
-  declare i64 @llvm.atomic.load.min.i64.p0i64( i64* <ptr>, i64 <delta> )
-
      - -
      -  declare i8 @llvm.atomic.load.umax.i8.p0i8( i8* <ptr>, i8 <delta> )
-  declare i16 @llvm.atomic.load.umax.i16.p0i16( i16* <ptr>, i16 <delta> )
-  declare i32 @llvm.atomic.load.umax.i32.p0i32( i32* <ptr>, i32 <delta> )
-  declare i64 @llvm.atomic.load.umax.i64.p0i64( i64* <ptr>, i64 <delta> )
-
      - -
      -  declare i8 @llvm.atomic.load.umin.i8.p0i8( i8* <ptr>, i8 <delta> )
-  declare i16 @llvm.atomic.load.umin.i16.p0i16( i16* <ptr>, i16 <delta> )
-  declare i32 @llvm.atomic.load.umin.i32.p0i32( i32* <ptr>, i32 <delta> )
-  declare i64 @llvm.atomic.load.umin.i64.p0i64( i64* <ptr>, i64 <delta> )
-
      - -
      Overview:
      -

      These intrinsics takes the signed or unsigned minimum or maximum of - delta and the value stored in memory at ptr. It yields the - original value at ptr.

      - -
      Arguments:
      -

      These intrinsics take two arguments, the first a pointer to an integer value - and the second an integer value. The result is also an integer value. These - integer types can have any bit width, but they must all have the same bit - width. The targets may only lower integer representations they support.

      - -
      Semantics:
      -

      These intrinsics does a series of operations atomically. They first load the - value stored at ptr. They then do the signed or unsigned min or - max delta and the value, store the result to ptr. They - yield the original value stored at ptr.

      - -
      Examples:
      -
      -%mallocP  = tail call i8* @malloc(i32 ptrtoint (i32* getelementptr (i32* null, i32 1) to i32))
-%ptr      = bitcast i8* %mallocP to i32*
-            store i32 7, %ptr
-%result0  = call i32 @llvm.atomic.load.min.i32.p0i32( i32* %ptr, i32 -2 )
-                                ; yields {i32}:result0 = 7
-%result1  = call i32 @llvm.atomic.load.max.i32.p0i32( i32* %ptr, i32 8 )
-                                ; yields {i32}:result1 = -2
-%result2  = call i32 @llvm.atomic.load.umin.i32.p0i32( i32* %ptr, i32 10 )
-                                ; yields {i32}:result2 = 8
-%result3  = call i32 @llvm.atomic.load.umax.i32.p0i32( i32* %ptr, i32 30 )
-                                ; yields {i32}:result3 = 8
-%memval1  = load i32* %ptr      ; yields {i32}:memval1 = 30
-
      - -
      - - - -
      - Memory Use Markers -
      - -
      - -

      This class of intrinsics exists to information about the lifetime of memory - objects and ranges where variables are immutable.

      - -
      - - -
      - 'llvm.lifetime.start' Intrinsic -
      - -
      - -
      Syntax:
      -
      -  declare void @llvm.lifetime.start(i64 <size>, i8* nocapture <ptr>)
-
      - -
      Overview:
      -

      The 'llvm.lifetime.start' intrinsic specifies the start of a memory - object's lifetime.

      - -
      Arguments:
      -

      The first argument is a constant integer representing the size of the - object, or -1 if it is variable sized. The second argument is a pointer to - the object.

      - -
      Semantics:
      -

      This intrinsic indicates that before this point in the code, the value of the - memory pointed to by ptr is dead. This means that it is known to - never be used and has an undefined value. A load from the pointer that - precedes this intrinsic can be replaced with - 'undef'.

      - -
      - - -
      - 'llvm.lifetime.end' Intrinsic -
      - -
      - -
      Syntax:
      -
      -  declare void @llvm.lifetime.end(i64 <size>, i8* nocapture <ptr>)
-
      - -
      Overview:
      -

      The 'llvm.lifetime.end' intrinsic specifies the end of a memory - object's lifetime.

      - -
      Arguments:
      -

      The first argument is a constant integer representing the size of the - object, or -1 if it is variable sized. The second argument is a pointer to - the object.

      - -
      Semantics:
      -

      This intrinsic indicates that after this point in the code, the value of the - memory pointed to by ptr is dead. This means that it is known to - never be used and has an undefined value. Any stores into the memory object - following this intrinsic may be removed as dead. - -

      - - -
      - 'llvm.invariant.start' Intrinsic -
      - -
      - -
      Syntax:
      -
      -  declare {}* @llvm.invariant.start(i64 <size>, i8* nocapture <ptr>) readonly
-
      - -
      Overview:
      -

      The 'llvm.invariant.start' intrinsic specifies that the contents of - a memory object will not change.

      - -
      Arguments:
      -

      The first argument is a constant integer representing the size of the - object, or -1 if it is variable sized. The second argument is a pointer to - the object.

      - -
      Semantics:
      -

      This intrinsic indicates that until an llvm.invariant.end that uses - the return value, the referenced memory location is constant and - unchanging.

      - -
      - - -
      - 'llvm.invariant.end' Intrinsic -
      - -
      - -
      Syntax:
      -
      -  declare void @llvm.invariant.end({}* <start>, i64 <size>, i8* nocapture <ptr>)
-
      - -
      Overview:
      -

      The 'llvm.invariant.end' intrinsic specifies that the contents of - a memory object are mutable.

      - -
      Arguments:
      -

      The first argument is the matching llvm.invariant.start intrinsic. - The second argument is a constant integer representing the size of the - object, or -1 if it is variable sized and the third argument is a pointer - to the object.

      - -
      Semantics:
      -

      This intrinsic indicates that the memory is mutable again.

      - -
      - - -
      - General Intrinsics -
      - -
      - -

      This class of intrinsics is designed to be generic and has no specific - purpose.

      - -
      - - -
      - 'llvm.var.annotation' Intrinsic -
      - -
      - -
      Syntax:
      -
      -  declare void @llvm.var.annotation(i8* <val>, i8* <str>, i8* <str>, i32  <int> )
-
      - -
      Overview:
      -

      The 'llvm.var.annotation' intrinsic.

      - -
      Arguments:
      -

      The first argument is a pointer to a value, the second is a pointer to a - global string, the third is a pointer to a global string which is the source - file name, and the last argument is the line number.

      - -
      Semantics:
      -

      This intrinsic allows annotation of local variables with arbitrary strings. - This can be useful for special purpose optimizations that want to look for - these annotations. These have no other defined use, they are ignored by code - generation and optimization.

      - -
      - - -
      - 'llvm.annotation.*' Intrinsic -
      - -
      - -
      Syntax:
      -

      This is an overloaded intrinsic. You can use 'llvm.annotation' on - any integer bit width.

      - -
      -  declare i8 @llvm.annotation.i8(i8 <val>, i8* <str>, i8* <str>, i32  <int> )
-  declare i16 @llvm.annotation.i16(i16 <val>, i8* <str>, i8* <str>, i32  <int> )
-  declare i32 @llvm.annotation.i32(i32 <val>, i8* <str>, i8* <str>, i32  <int> )
-  declare i64 @llvm.annotation.i64(i64 <val>, i8* <str>, i8* <str>, i32  <int> )
-  declare i256 @llvm.annotation.i256(i256 <val>, i8* <str>, i8* <str>, i32  <int> )
-
      - -
      Overview:
      -

      The 'llvm.annotation' intrinsic.

      - -
      Arguments:
      -

      The first argument is an integer value (result of some expression), the - second is a pointer to a global string, the third is a pointer to a global - string which is the source file name, and the last argument is the line - number. It returns the value of the first argument.

      - -
      Semantics:
      -

      This intrinsic allows annotations to be put on arbitrary expressions with - arbitrary strings. This can be useful for special purpose optimizations that - want to look for these annotations. These have no other defined use, they - are ignored by code generation and optimization.

      - -
      - - -
      - 'llvm.trap' Intrinsic -
      - -
      - -
      Syntax:
      -
      -  declare void @llvm.trap()
-
      - -
      Overview:
      -

      The 'llvm.trap' intrinsic.

      - -
      Arguments:
      -

      None.

      - -
      Semantics:
      -

      This intrinsics is lowered to the target dependent trap instruction. If the - target does not have a trap instruction, this intrinsic will be lowered to - the call of the abort() function.

      - -
      - - -
      - 'llvm.stackprotector' Intrinsic -
      - -
      - -
      Syntax:
      -
      -  declare void @llvm.stackprotector( i8* <guard>, i8** <slot> )
-
      - -
      Overview:
      -

      The llvm.stackprotector intrinsic takes the guard and - stores it onto the stack at slot. The stack slot is adjusted to - ensure that it is placed on the stack before local variables.

      - -
      Arguments:
      -

      The llvm.stackprotector intrinsic requires two pointer - arguments. The first argument is the value loaded from the stack - guard @__stack_chk_guard. The second variable is an alloca - that has enough space to hold the value of the guard.

      - -
      Semantics:
      -

      This intrinsic causes the prologue/epilogue inserter to force the position of - the AllocaInst stack slot to be before local variables on the - stack. This is to ensure that if a local variable on the stack is - overwritten, it will destroy the value of the guard. When the function exits, - the guard on the stack is checked against the original guard. If they're - different, then the program aborts by calling the __stack_chk_fail() - function.

      - -
      - - -
      - 'llvm.objectsize' Intrinsic -
      - -
      - -
      Syntax:
      -
      -  declare i32 @llvm.objectsize.i32( i8* <object>, i1 <type> )
-  declare i64 @llvm.objectsize.i64( i8* <object>, i1 <type> )
-
      - -
      Overview:
      -

      The llvm.objectsize intrinsic is designed to provide information - to the optimizers to discover at compile time either a) when an - operation like memcpy will either overflow a buffer that corresponds to - an object, or b) to determine that a runtime check for overflow isn't - necessary. An object in this context means an allocation of a - specific class, structure, array, or other object.

      - -
      Arguments:
      -

      The llvm.objectsize intrinsic takes two arguments. The first - argument is a pointer to or into the object. The second argument - is a boolean 0 or 1. This argument determines whether you want the - maximum (0) or minimum (1) bytes remaining. This needs to be a literal 0 or - 1, variables are not allowed.

      - -
      Semantics:
      -

      The llvm.objectsize intrinsic is lowered to either a constant - representing the size of the object concerned or i32/i64 -1 or 0 - (depending on the type argument if the size cannot be determined - at compile time.

      - -
      - - -
      -
      - Valid CSS - Valid HTML 4.01 - - Chris Lattner
      - The LLVM Compiler Infrastructure
      - Last modified: $Date$ -
      - - - Removed: llvm/trunk/docs/Lexicon.html URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/Lexicon.html?rev=103212&view=auto ============================================================================== --- llvm/trunk/docs/Lexicon.html (original) +++ llvm/trunk/docs/Lexicon.html (removed) @@ -1,277 +0,0 @@ - - - - - The LLVM Lexicon - - - - - -
      The LLVM Lexicon
      -

      NOTE: This document is a work in progress!

      - -
      Table Of Contents
      - -
      - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
      - A -
      ADCE
      - B -
      BURS
      - C -
      CSE
      - D -
      DAGDerived PointerDSADSE
      - G -
      GC
      - I -
      IPAIPOISel
      - L -
      LCSSALICMLoad-VNLTO
      - M -
      MC
      - O -
      Object Pointer
      - P -
      PRE
      - R -
      RAUWReassociationRoot
      - S -
      Safe PointSCCSCCPSDISelSRoAStack Map
      -
      - - -
      Definitions
      - - -
      - A -
      -
      -
      -
      ADCE
      -
      Aggressive Dead Code Elimination
      -
      -
      - -
      - B -
      -
      -
      -
      BURS
      -
      Bottom Up Rewriting System—A method of instruction selection for - code generation. An example is the BURG tool.
      -
      -
      - -
      - C -
      -
      -
      -
      CSE
      -
      Common Subexpression Elimination. An optimization that removes common - subexpression compuation. For example (a+b)*(a+b) has two - subexpressions that are the same: (a+b). This optimization would - perform the addition only once and then perform the multiply (but only if - it's compulationally correct/safe). -
      -
      - -
      - D -
      -
      -
      -
      DAG
      -
      Directed Acyclic Graph
      -
      Derived Pointer
      -
      A pointer to the interior of an object, such that a garbage collector - is unable to use the pointer for reachability analysis. While a derived - pointer is live, the corresponding object pointer must be kept in a root, - otherwise the collector might free the referenced object. With copying - collectors, derived pointers pose an additional hazard that they may be - invalidated at any safe point. This term is used in - opposition to object pointer.
      -
      DSA
      -
      Data Structure Analysis
      -
      DSE
      -
      Dead Store Elimination
      -
      -
      - -
      - G -
      -
      -
      -
      GC
      -
      Garbage Collection. The practice of using reachability analysis instead - of explicit memory management to reclaim unused memory.
      -
      -
      - -
      - H -
      -
      -
      -
      Heap
      -
      In garbage collection, the region of memory which is managed using - reachability analysis.
      -
      -
      - -
      - I -
      -
      -
      -
      IPA
      -
      Inter-Procedural Analysis. Refers to any variety of code analysis that - occurs between procedures, functions or compilation units (modules).
      -
      IPO
      -
      Inter-Procedural Optimization. Refers to any variety of code - optimization that occurs between procedures, functions or compilation units - (modules).
      -
      ISel
      -
      Instruction Selection.
      -
      -
      - -
      - L -
      -
      -
      -
      LCSSA
      -
      Loop-Closed Static Single Assignment Form
      -
      LICM
      -
      Loop Invariant Code Motion
      -
      Load-VN
      -
      Load Value Numbering
      -
      LTO
      -
      Link-Time Optimization
      -
      -
      - -
      - M -
      -
      -
      -
      MC
      -
      Machine Code
      -
      -
      - -
      - O -
      -
      -
      -
      Object Pointer
      -
      A pointer to an object such that the garbage collector is able to trace - references contained within the object. This term is used in opposition to - derived pointer.
      -
      -
      - - -
      - P -
      -
      -
      -
      PRE
      -
      Partial Redundancy Elimination
      -
      -
      - - -
      - R -
      -
      -
      -
      RAUW
      An abbreviation for Replace - All Uses With. The functions User::replaceUsesOfWith(), - Value::replaceAllUsesWith(), and Constant::replaceUsesOfWithOnConstant() - implement the replacement of one Value with another by iterating over its - def/use chain and fixing up all of the pointers to point to the new value. - See also def/use chains. -
      -
      Reassociation
      Rearranging - associative expressions to promote better redundancy elimination and other - optimization. For example, changing (A+B-A) into (B+A-A), permitting it to - be optimized into (B+0) then (B).
      -
      Root
      In garbage collection, a - pointer variable lying outside of the heap from which - the collector begins its reachability analysis. In the context of code - generation, "root" almost always refers to a "stack root" -- a local or - temporary variable within an executing function.
      -
      -
      - - -
      - S -
      -
      -
      -
      Safe Point
      -
      In garbage collection, it is necessary to identify stack - roots so that reachability analysis may proceed. It may be infeasible to - provide this information for every instruction, so instead the information - may is calculated only at designated safe points. With a copying collector, - derived pointers must not be retained across - safe points and object pointers must be - reloaded from stack roots.
      -
      SDISel
      -
      Selection DAG Instruction Selection.
      -
      SCC
      -
      Strongly Connected Component
      -
      SCCP
      -
      Sparse Conditional Constant Propagation
      -
      SRoA
      -
      Scalar Replacement of Aggregates
      -
      SSA
      -
      Static Single Assignment
      -
      Stack Map
      -
      In garbage collection, metadata emitted by the code generator which - identifies roots within the stack frame of an executing - function.
      -
      -
      - -
      -
      Valid CSSValid HTML 4.01The LLVM Team
      -The LLVM Compiler Infrastructure
      -Last modified: $Date$ -
      - - - Removed: llvm/trunk/docs/LinkTimeOptimization.html URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/LinkTimeOptimization.html?rev=103212&view=auto ============================================================================== --- llvm/trunk/docs/LinkTimeOptimization.html (original) +++ llvm/trunk/docs/LinkTimeOptimization.html (removed) @@ -1,390 +0,0 @@ - - - - LLVM Link Time Optimization: Design and Implementation - - - -
      - LLVM Link Time Optimization: Design and Implementation -
      - - - -
      -

      Written by Devang Patel and Nick Kledzik

      -
      - - -
      -Description -
      - - -
      -

      -LLVM features powerful intermodular optimizations which can be used at link -time. Link Time Optimization (LTO) is another name for intermodular optimization -when performed during the link stage. This document describes the interface -and design between the LTO optimizer and the linker.

      -
      - - -
      -Design Philosophy -
      - - -
      -

      -The LLVM Link Time Optimizer provides complete transparency, while doing -intermodular optimization, in the compiler tool chain. Its main goal is to let -the developer take advantage of intermodular optimizations without making any -significant changes to the developer's makefiles or build system. This is -achieved through tight integration with the linker. In this model, the linker -treates LLVM bitcode files like native object files and allows mixing and -matching among them. The linker uses libLTO, a shared -object, to handle LLVM bitcode files. This tight integration between -the linker and LLVM optimizer helps to do optimizations that are not possible -in other models. The linker input allows the optimizer to avoid relying on -conservative escape analysis. -

      -
      - - -
      - Example of link time optimization -
      - -
      -

      The following example illustrates the advantages of LTO's integrated - approach and clean interface. This example requires a system linker which - supports LTO through the interface described in this document. Here, - llvm-gcc transparently invokes system linker.

      -
        -
      • Input source file a.c is compiled into LLVM bitcode form. -
      • Input source file main.c is compiled into native object code. -
      -
      ---- a.h ---
-extern int foo1(void);
-extern void foo2(void);
-extern void foo4(void);
---- a.c ---
-#include "a.h"
-
-static signed int i = 0;
-
-void foo2(void) {
- i = -1;
-}
-
-static int foo3() {
-foo4();
-return 10;
-}
-
-int foo1(void) {
-int data = 0;
-
-if (i < 0) { data = foo3(); }
-
-data = data + 42;
-return data;
-}
-
---- main.c ---
-#include <stdio.h>
-#include "a.h"
-
-void foo4(void) {
- printf ("Hi\n");
-}
-
-int main() {
- return foo1();
-}
-
---- command lines ---
-$ llvm-gcc --emit-llvm -c a.c -o a.o  # <-- a.o is LLVM bitcode file
-$ llvm-gcc -c main.c -o main.o # <-- main.o is native object file
-$ llvm-gcc a.o main.o -o main # <-- standard link command without any modifications
-
      -

      In this example, the linker recognizes that foo2() is an - externally visible symbol defined in LLVM bitcode file. The linker completes - its usual symbol resolution - pass and finds that foo2() is not used anywhere. This information - is used by the LLVM optimizer and it removes foo2(). As soon as - foo2() is removed, the optimizer recognizes that condition - i < 0 is always false, which means foo3() is never - used. Hence, the optimizer removes foo3(), also. And this in turn, - enables linker to remove foo4(). This example illustrates the - advantage of tight integration with the linker. Here, the optimizer can not - remove foo3() without the linker's input. -

      -
      - - -
      - Alternative Approaches -
      - -
      -
      -
      Compiler driver invokes link time optimizer separately.
      -
      In this model the link time optimizer is not able to take advantage of - information collected during the linker's normal symbol resolution phase. - In the above example, the optimizer can not remove foo2() without - the linker's input because it is externally visible. This in turn prohibits - the optimizer from removing foo3().
      -
      Use separate tool to collect symbol information from all object - files.
      -
      In this model, a new, separate, tool or library replicates the linker's - capability to collect information for link time optimization. Not only is - this code duplication difficult to justify, but it also has several other - disadvantages. For example, the linking semantics and the features - provided by the linker on various platform are not unique. This means, - this new tool needs to support all such features and platforms in one - super tool or a separate tool per platform is required. This increases - maintenance cost for link time optimizer significantly, which is not - necessary. This approach also requires staying synchronized with linker - developements on various platforms, which is not the main focus of the link - time optimizer. Finally, this approach increases end user's build time due - to the duplication of work done by this separate tool and the linker itself. -
      -
      -
      - - -
      - Multi-phase communication between libLTO and linker -
      - -
      -

      The linker collects information about symbol defininitions and uses in - various link objects which is more accurate than any information collected - by other tools during typical build cycles. The linker collects this - information by looking at the definitions and uses of symbols in native .o - files and using symbol visibility information. The linker also uses - user-supplied information, such as a list of exported symbols. LLVM - optimizer collects control flow information, data flow information and knows - much more about program structure from the optimizer's point of view. - Our goal is to take advantage of tight integration between the linker and - the optimizer by sharing this information during various linking phases. -

      -
      - - -
      - Phase 1 : Read LLVM Bitcode Files -
      - -
      -

      The linker first reads all object files in natural order and collects - symbol information. This includes native object files as well as LLVM bitcode - files. To minimize the cost to the linker in the case that all .o files - are native object files, the linker only calls lto_module_create() - when a supplied object file is found to not be a native object file. If - lto_module_create() returns that the file is an LLVM bitcode file, - the linker - then iterates over the module using lto_module_get_symbol_name() and - lto_module_get_symbol_attribute() to get all symbols defined and - referenced. - This information is added to the linker's global symbol table. -

      -

      The lto* functions are all implemented in a shared object libLTO. This - allows the LLVM LTO code to be updated independently of the linker tool. - On platforms that support it, the shared object is lazily loaded. -

      -
      - - -
      - Phase 2 : Symbol Resolution -
      - -
      -

      In this stage, the linker resolves symbols using global symbol table. - It may report undefined symbol errors, read archive members, replace - weak symbols, etc. The linker is able to do this seamlessly even though it - does not know the exact content of input LLVM bitcode files. If dead code - stripping is enabled then the linker collects the list of live symbols. -

      -
      - - -
      - Phase 3 : Optimize Bitcode Files -
      -
      -

      After symbol resolution, the linker tells the LTO shared object which - symbols are needed by native object files. In the example above, the linker - reports that only foo1() is used by native object files using - lto_codegen_add_must_preserve_symbol(). Next the linker invokes - the LLVM optimizer and code generators using lto_codegen_compile() - which returns a native object file creating by merging the LLVM bitcode files - and applying various optimization passes. -

      -
      - - -
      - Phase 4 : Symbol Resolution after optimization -
      - -
      -

      In this phase, the linker reads optimized a native object file and - updates the internal global symbol table to reflect any changes. The linker - also collects information about any changes in use of external symbols by - LLVM bitcode files. In the example above, the linker notes that - foo4() is not used any more. If dead code stripping is enabled then - the linker refreshes the live symbol information appropriately and performs - dead code stripping.

      -

      After this phase, the linker continues linking as if it never saw LLVM - bitcode files.

      -
      - - -
      -libLTO -
      - -
      -

      libLTO is a shared object that is part of the LLVM tools, and - is intended for use by a linker. libLTO provides an abstract C - interface to use the LLVM interprocedural optimizer without exposing details - of LLVM's internals. The intention is to keep the interface as stable as - possible even when the LLVM optimizer continues to evolve. It should even - be possible for a completely different compilation technology to provide - a different libLTO that works with their object files and the standard - linker tool.

      -
      - - -
      - lto_module_t -
      - -
      - -

      A non-native object file is handled via an lto_module_t. -The following functions allow the linker to check if a file (on disk -or in a memory buffer) is a file which libLTO can process:

      - -
      -lto_module_is_object_file(const char*)
-lto_module_is_object_file_for_target(const char*, const char*)
-lto_module_is_object_file_in_memory(const void*, size_t)
-lto_module_is_object_file_in_memory_for_target(const void*, size_t, const char*)
-
      - -

      If the object file can be processed by libLTO, the linker creates a -lto_module_t by using one of

      - -
      -lto_module_create(const char*)
-lto_module_create_from_memory(const void*, size_t)
-
      - -

      and when done, the handle is released via

      - -
      -lto_module_dispose(lto_module_t)
-
      - -

      The linker can introspect the non-native object file by getting the number of -symbols and getting the name and attributes of each symbol via:

      - -
      -lto_module_get_num_symbols(lto_module_t)
-lto_module_get_symbol_name(lto_module_t, unsigned int)
-lto_module_get_symbol_attribute(lto_module_t, unsigned int)
-
      - -

      The attributes of a symbol include the alignment, visibility, and kind.

      -
      - - -
      - lto_code_gen_t -
      - -
      - -

      Once the linker has loaded each non-native object files into an -lto_module_t, it can request libLTO to process them all and -generate a native object file. This is done in a couple of steps. -First, a code generator is created with:

      - -
      lto_codegen_create()
      - -

      Then, each non-native object file is added to the code generator with:

      - -
      -lto_codegen_add_module(lto_code_gen_t, lto_module_t)
-
      - -

      The linker then has the option of setting some codegen options. Whether or -not to generate DWARF debug info is set with:

      - -
      lto_codegen_set_debug_model(lto_code_gen_t)
      - -

      Which kind of position independence is set with:

      - -
      lto_codegen_set_pic_model(lto_code_gen_t)
      - -

      And each symbol that is referenced by a native object file or otherwise must -not be optimized away is set with:

      - -
      -lto_codegen_add_must_preserve_symbol(lto_code_gen_t, const char*)
-
      - -

      After all these settings are done, the linker requests that a native object -file be created from the modules with the settings using:

      - -
      lto_codegen_compile(lto_code_gen_t, size*)
      - -

      which returns a pointer to a buffer containing the generated native -object file. The linker then parses that and links it with the rest -of the native object files.

      - -
      - - - -
      -
      - Valid CSS - Valid HTML 4.01 - - Devang Patel and Nick Kledzik
      - LLVM Compiler Infrastructure
      - Last modified: $Date$ -
      - - - - Modified: llvm/trunk/docs/Makefile URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/Makefile?rev=103213&r1=103212&r2=103213&view=diff ============================================================================== --- llvm/trunk/docs/Makefile (original) +++ llvm/trunk/docs/Makefile Thu May 6 18:45:43 2010 @@ -7,117 +7,7 @@ # ##===----------------------------------------------------------------------===## -LEVEL := .. -DIRS := CommandGuide tutorial - -ifdef BUILD_FOR_WEBSITE -PROJ_OBJ_DIR = . -DOXYGEN = doxygen - -$(PROJ_OBJ_DIR)/doxygen.cfg: doxygen.cfg.in - cat $< | sed \ - -e 's/@abs_top_srcdir@/../g' \ - -e 's/@DOT@/dot/g' \ - -e 's/@PACKAGE_VERSION@/mainline/' \ - -e 's/@abs_top_builddir@/../g' > $@ -endif +LEVEL = .. +DIRS = main api include $(LEVEL)/Makefile.common - -HTML := $(wildcard $(PROJ_SRC_DIR)/*.html) \ - $(wildcard $(PROJ_SRC_DIR)/*.css) -IMAGES := $(wildcard $(PROJ_SRC_DIR)/img/*.*) -DOXYFILES := doxygen.cfg.in doxygen.css doxygen.footer doxygen.header \ - doxygen.intro -EXTRA_DIST := $(HTML) $(DOXYFILES) llvm.css CommandGuide img - -.PHONY: install-html install-doxygen doxygen install-ocamldoc ocamldoc generated - -install_targets := install-html -ifeq ($(ENABLE_DOXYGEN),1) -install_targets += install-doxygen -endif -ifneq (,$(filter ocaml,$(BINDINGS_TO_BUILD))) -install_targets += install-ocamldoc -endif -install-local:: $(install_targets) - -# Live documentation is generated for the web site using this target: -# 'make generated BUILD_FOR_WEBSITE=1' -generated:: doxygen ocamldoc - -install-html: $(PROJ_OBJ_DIR)/html.tar.gz - $(Echo) Installing HTML documentation - $(Verb) $(MKDIR) $(DESTDIR)$(PROJ_docsdir)/html - $(Verb) $(MKDIR) $(DESTDIR)$(PROJ_docsdir)/html/img - $(Verb) $(DataInstall) $(HTML) $(DESTDIR)$(PROJ_docsdir)/html - $(Verb) $(DataInstall) $(IMAGES) $(DESTDIR)$(PROJ_docsdir)/html/img - $(Verb) $(DataInstall) $(PROJ_OBJ_DIR)/html.tar.gz $(DESTDIR)$(PROJ_docsdir) - -$(PROJ_OBJ_DIR)/html.tar.gz: $(HTML) - $(Echo) Packaging HTML documentation - $(Verb) $(RM) -rf $@ $(PROJ_OBJ_DIR)/html.tar - $(Verb) cd $(PROJ_SRC_DIR) && \ - $(TAR) cf $(PROJ_OBJ_DIR)/html.tar *.html - $(Verb) $(GZIP) $(PROJ_OBJ_DIR)/html.tar - -install-doxygen: doxygen - $(Echo) Installing doxygen documentation - $(Verb) $(MKDIR) $(DESTDIR)$(PROJ_docsdir)/html/doxygen - $(Verb) $(DataInstall) $(PROJ_OBJ_DIR)/doxygen.tar.gz $(DESTDIR)$(PROJ_docsdir) - $(Verb) cd $(PROJ_OBJ_DIR)/doxygen && \ - $(FIND) . -type f -exec \ - $(DataInstall) {} $(DESTDIR)$(PROJ_docsdir)/html/doxygen \; - -doxygen: regendoc $(PROJ_OBJ_DIR)/doxygen.tar.gz - -regendoc: - $(Echo) Building doxygen documentation - $(Verb) if test -e $(PROJ_OBJ_DIR)/doxygen ; then \ - $(RM) -rf $(PROJ_OBJ_DIR)/doxygen ; \ - fi - $(Verb) $(DOXYGEN) $(PROJ_OBJ_DIR)/doxygen.cfg - -$(PROJ_OBJ_DIR)/doxygen.tar.gz: $(DOXYFILES) $(PROJ_OBJ_DIR)/doxygen.cfg - $(Echo) Packaging doxygen documentation - $(Verb) $(RM) -rf $@ $(PROJ_OBJ_DIR)/doxygen.tar - $(Verb) $(TAR) cf $(PROJ_OBJ_DIR)/doxygen.tar doxygen - $(Verb) $(GZIP) $(PROJ_OBJ_DIR)/doxygen.tar - $(Verb) $(CP) $(PROJ_OBJ_DIR)/doxygen.tar.gz $(PROJ_OBJ_DIR)/doxygen/html/ - -userloc: $(LLVM_SRC_ROOT)/docs/userloc.html - -$(LLVM_SRC_ROOT)/docs/userloc.html: - $(Echo) Making User LOC Table - $(Verb) cd $(LLVM_SRC_ROOT) ; ./utils/userloc.pl -details -recurse \ - -html lib include tools runtime utils examples autoconf test > docs/userloc.html - -install-ocamldoc: ocamldoc - $(Echo) Installing ocamldoc documentation - $(Verb) $(MKDIR) $(DESTDIR)$(PROJ_docsdir)/ocamldoc/html - $(Verb) $(DataInstall) $(PROJ_OBJ_DIR)/ocamldoc.tar.gz $(DESTDIR)$(PROJ_docsdir) - $(Verb) cd $(PROJ_OBJ_DIR)/ocamldoc && \ - $(FIND) . -type f -exec \ - $(DataInstall) {} $(DESTDIR)$(PROJ_docsdir)/ocamldoc/html \; - -ocamldoc: regen-ocamldoc - $(Echo) Packaging ocamldoc documentation - $(Verb) $(RM) -rf $(PROJ_OBJ_DIR)/ocamldoc.tar* - $(Verb) $(TAR) cf $(PROJ_OBJ_DIR)/ocamldoc.tar ocamldoc - $(Verb) $(GZIP) $(PROJ_OBJ_DIR)/ocamldoc.tar - $(Verb) $(CP) $(PROJ_OBJ_DIR)/ocamldoc.tar.gz $(PROJ_OBJ_DIR)/ocamldoc/html/ - -regen-ocamldoc: - $(Echo) Building ocamldoc documentation - $(Verb) if test -e $(PROJ_OBJ_DIR)/ocamldoc ; then \ - $(RM) -rf $(PROJ_OBJ_DIR)/ocamldoc ; \ - fi - $(Verb) $(MAKE) -C $(LEVEL)/bindings/ocaml ocamldoc - $(Verb) $(MKDIR) $(PROJ_OBJ_DIR)/ocamldoc/html - $(Verb) \ - $(OCAMLDOC) -d $(PROJ_OBJ_DIR)/ocamldoc/html -sort -colorize-code -html \ - `$(FIND) $(LEVEL)/bindings/ocaml -name "*.odoc" -exec echo -load '{}' ';'` - -uninstall-local:: - $(Echo) Uninstalling Documentation - $(Verb) $(RM) -rf $(DESTDIR)$(PROJ_docsdir) Removed: llvm/trunk/docs/MakefileGuide.html URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/MakefileGuide.html?rev=103212&view=auto ============================================================================== --- llvm/trunk/docs/MakefileGuide.html (original) +++ llvm/trunk/docs/MakefileGuide.html (removed) @@ -1,1031 +0,0 @@ - - - - - LLVM Makefile Guide - - - - -
      LLVM Makefile Guide
      - -
        -
      1. Introduction
        2. -
      2. General Concepts -
          -
        1. Projects
          2. -
        2. Variable Values
          3. -
        3. Including Makefiles -
            -
          1. Makefile
            2. -
          2. Makefile.common
            3. -
          3. Makefile.config
            4. -
          4. Makefile.rules
            5. -
          -
          4. -
        4. Comments
          5. -
        -
        3. -
      3. Tutorial -
          -
        1. Libraries -
            -
          1. Bitcode Modules
            2. -
          2. Loadable Modules
            3. -
          -
          2. -
        2. Tools -
            -
          1. JIT Tools
            2. -
          -
          3. -
        3. Projects
          4. -
        -
        4. -
      4. Targets Supported -
          -
        1. all
          2. -
        2. all-local
          3. -
        3. check
          4. -
        4. check-local
          5. -
        5. clean
          6. -
        6. clean-local
          7. -
        7. dist
          8. -
        8. dist-check
          9. -
        9. dist-clean
          10. -
        10. install
          11. -
        11. preconditions
          12. -
        12. printvars
          13. -
        13. reconfigure
          14. -
        14. spotless
          15. -
        15. tags
          16. -
        16. uninstall
          17. -
        -
        5. -
      5. Using Variables -
          -
        1. Control Variables
          2. -
        2. Override Variables
          3. -
        3. Readable Variables
          4. -
        4. Internal Variables
          5. -
        -
        6. -
      - -
      -

      Written by Reid Spencer

      -
      - - -
      Introduction
      - - -
      -

      This document provides usage information about the LLVM makefile - system. While loosely patterned after the BSD makefile system, LLVM has taken - a departure from BSD in order to implement additional features needed by LLVM. - Although makefile systems such as automake were attempted at one point, it - has become clear that the features needed by LLVM and the Makefile norm are - too great to use a more limited tool. Consequently, LLVM requires simply GNU - Make 3.79, a widely portable makefile processor. LLVM unabashedly makes heavy - use of the features of GNU Make so the dependency on GNU Make is firm. If - you're not familiar with make, it is recommended that you read the - GNU Makefile - Manual.

      -

      While this document is rightly part of the - LLVM Programmer's Manual, it is treated - separately here because of the volume of content and because it is often an - early source of bewilderment for new developers.

      -
      - - -
      General Concepts
      - - -
      -

      The LLVM Makefile System is the component of LLVM that is responsible for - building the software, testing it, generating distributions, checking those - distributions, installing and uninstalling, etc. It consists of a several - files throughout the source tree. These files and other general concepts are - described in this section.

      -
      - - -
      Projects
      -
      -

      The LLVM Makefile System is quite generous. It not only builds its own - software, but it can build yours too. Built into the system is knowledge of - the llvm/projects directory. Any directory under projects - that has both a configure script and a Makefile is assumed - to be a project that uses the LLVM Makefile system. Building software that - uses LLVM does not require the LLVM Makefile System nor even placement in the - llvm/projects directory. However, doing so will allow your project - to get up and running quickly by utilizing the built-in features that are used - to compile LLVM. LLVM compiles itself using the same features of the makefile - system as used for projects.

      -

      For complete details on setting up your projects configuration, simply - mimic the llvm/projects/sample project or for further details, - consult the Projects.html page.

      -
      - - -
      Variable Values
      -
      -

      To use the makefile system, you simply create a file named - Makefile in your directory and declare values for certain variables. - The variables and values that you select determine what the makefile system - will do. These variables enable rules and processing in the makefile system - that automatically Do The Right Thing™. -

      - - -
      Including Makefiles
      -
      -

      Setting variables alone is not enough. You must include into your Makefile - additional files that provide the rules of the LLVM Makefile system. The - various files involved are described in the sections that follow.

      -
      - - -
      Makefile
      -
      -

      Each directory to participate in the build needs to have a file named - Makefile. This is the file first read by make. It has three - sections:

      -
        -
      1. Settable Variables - Required that must be set - first.
        2. -
      2. include $(LEVEL)/Makefile.common - - include the LLVM Makefile system. -
      3. Override Variables - Override variables set by - the LLVM Makefile system. -
      -
      - - -
      Makefile.common -
      -
      -

      Every project must have a Makefile.common file at its top source - directory. This file serves three purposes:

      -
        -
      1. It includes the project's configuration makefile to obtain values - determined by the configure script. This is done by including the - $(LEVEL)/Makefile.config file.
        2. -
      2. It specifies any other (static) values that are needed throughout the - project. Only values that are used in all or a large proportion of the - project's directories should be placed here.
        3. -
      3. It includes the standard rules for the LLVM Makefile system, - $(LLVM_SRC_ROOT)/Makefile.rules. - This file is the "guts" of the LLVM Makefile system.
        4. -
      -
      - - -
      Makefile.config -
      -
      -

      Every project must have a Makefile.config at the top of its - build directory. This file is generated by the - configure script from the pattern provided by the - Makefile.config.in file located at the top of the project's - source directory. The contents of this file depend largely on what - configuration items the project uses, however most projects can get what they - need by just relying on LLVM's configuration found in - $(LLVM_OBJ_ROOT)/Makefile.config. -

      - - -
      Makefile.rules
      -
      -

      This file, located at $(LLVM_SRC_ROOT)/Makefile.rules is the heart - of the LLVM Makefile System. It provides all the logic, dependencies, and - rules for building the targets supported by the system. What it does largely - depends on the values of make variables that - have been set before Makefile.rules is included. -

      - - -
      Comments
      -
      -

      User Makefiles need not have comments in them unless the construction is - unusual or it does not strictly follow the rules and patterns of the LLVM - makefile system. Makefile comments are invoked with the pound (#) character. - The # character and any text following it, to the end of the line, are ignored - by make.

      -
      - - -
      Tutorial
      - -
      -

      This section provides some examples of the different kinds of modules you - can build with the LLVM makefile system. In general, each directory you - provide will build a single object although that object may be composed of - additionally compiled components.

      -
      - - -
      Libraries
      -
      -

      Only a few variable definitions are needed to build a regular library. - Normally, the makefile system will build all the software into a single - libname.o (pre-linked) object. This means the library is not - searchable and that the distinction between compilation units has been - dissolved. Optionally, you can ask for a shared library (.so) or archive - library (.a) built. Archive libraries are the default. For example:

      - 
      
-      LIBRARYNAME = mylib
-      SHARED_LIBRARY = 1
-      ARCHIVE_LIBRARY = 1
-
      -

      says to build a library named "mylib" with both a shared library - (mylib.so) and an archive library (mylib.a) version. The - contents of all the - libraries produced will be the same, they are just constructed differently. - Note that you normally do not need to specify the sources involved. The LLVM - Makefile system will infer the source files from the contents of the source - directory.

      -

      The LOADABLE_MODULE=1 directive can be used in conjunction with - SHARED_LIBRARY=1 to indicate that the resulting shared library should - be openable with the dlopen function and searchable with the - dlsym function (or your operating system's equivalents). While this - isn't strictly necessary on Linux and a few other platforms, it is required - on systems like HP-UX and Darwin. You should use LOADABLE_MODULE for - any shared library that you intend to be loaded into an tool via the - -load option. See the - WritingAnLLVMPass.html document - for an example of why you might want to do this. -

      - - -
      Bitcode Modules
      -
      -

      In some situations, it is desirable to build a single bitcode module from - a variety of sources, instead of an archive, shared library, or bitcode - library. Bitcode modules can be specified in addition to any of the other - types of libraries by defining the MODULE_NAME - variable. For example:

      - 
      
-      LIBRARYNAME = mylib
-      BYTECODE_LIBRARY = 1
-      MODULE_NAME = mymod
-
      -

      will build a module named mymod.bc from the sources in the - directory. This module will be an aggregation of all the bitcode modules - derived from the sources. The example will also build a bitcode archive - containing a bitcode module for each compiled source file. The difference is - subtle, but important depending on how the module or library is to be linked. -

      -
      - - -
      - Loadable Modules -
      -
      -

      In some situations, you need to create a loadable module. Loadable modules - can be loaded into programs like opt or llc to specify - additional passes to run or targets to support. Loadable modules are also - useful for debugging a pass or providing a pass with another package if that - pass can't be included in LLVM.

      -

      LLVM provides complete support for building such a module. All you need to - do is use the LOADABLE_MODULE variable in your Makefile. For example, to - build a loadable module named MyMod that uses the LLVM libraries - LLVMSupport.a and LLVMSystem.a, you would specify:

      - 
      
-     LIBRARYNAME := MyMod
-     LOADABLE_MODULE := 1
-     LINK_COMPONENTS := support system
-
      -

      Use of the LOADABLE_MODULE facility implies several things:

      -
        -
      1. There will be no "lib" prefix on the module. This differentiates it from - a standard shared library of the same name.
        2. -
      2. The SHARED_LIBRARY variable is turned - on.
        3. -
      3. The LINK_LIBS_IN_SHARED variable - is turned on.
        4. -
      -

      A loadable module is loaded by LLVM via the facilities of libtool's libltdl - library which is part of lib/System implementation.

      -
      - - -
      Tools
      -
      -

      For building executable programs (tools), you must provide the name of the - tool and the names of the libraries you wish to link with the tool. For - example:

      - 
      
-      TOOLNAME = mytool
-      USEDLIBS = mylib
-      LINK_COMPONENTS = support system
-
      -

      says that we are to build a tool name mytool and that it requires - three libraries: mylib, LLVMSupport.a and - LLVMSystem.a.

      -

      Note that two different variables are use to indicate which libraries are - linked: USEDLIBS and LLVMLIBS. This distinction is necessary - to support projects. LLVMLIBS refers to the LLVM libraries found in - the LLVM object directory. USEDLIBS refers to the libraries built by - your project. In the case of building LLVM tools, USEDLIBS and - LLVMLIBS can be used interchangeably since the "project" is LLVM - itself and USEDLIBS refers to the same place as LLVMLIBS. -

      -

      Also note that there are two different ways of specifying a library: with a - .a suffix and without. Without the suffix, the entry refers to the - re-linked (.o) file which will include all symbols of the library. - This is useful, for example, to include all passes from a library of passes. - If the .a suffix is used then the library is linked as a searchable - library (with the -l option). In this case, only the symbols that are - unresolved at that point will be resolved from the library, if they - exist. Other (unreferenced) symbols will not be included when the .a - syntax is used. Note that in order to use the .a suffix, the library - in question must have been built with the ARCHIVE_LIBRARY option set. -

      -
      - - -
      JIT Tools
      -
      -

      Many tools will want to use the JIT features of LLVM. To do this, you - simply specify that you want an execution 'engine', and the makefiles will - automatically link in the appropriate JIT for the host or an interpreter - if none is available:

      - 
      
-      TOOLNAME = my_jit_tool
-      USEDLIBS = mylib
-      LINK_COMPONENTS = engine
-
      -

      Of course, any additional libraries may be listed as other components. To - get a full understanding of how this changes the linker command, it is - recommended that you:

      - 
      
-      cd examples/Fibonacci
-      make VERBOSE=1
-
      -
      - - -
      Targets Supported
      - - -
      -

      This section describes each of the targets that can be built using the LLVM - Makefile system. Any target can be invoked from any directory but not all are - applicable to a given directory (e.g. "check", "dist" and "install" will - always operate as if invoked from the top level directory).

      - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
      Target NameImplied TargetsTarget Description
      allCompile the software recursively. Default target. -
      all-localCompile the software in the local directory only. -
      checkChange to the test directory in a project and run the - test suite there. -
      check-localRun a local test suite. Generally this is only defined in the - Makefile of the project's test directory. -
      cleanRemove built objects recursively. -
      clean-localRemove built objects from the local directory only. -
      distallPrepare a source distribution tarball. -
      dist-checkallPrepare a source distribution tarball and check that it builds. -
      dist-cleancleanClean source distribution tarball temporary files. -
      installallCopy built objects to installation directory. -
      preconditionsallCheck to make sure configuration and makefiles are up to date. -
      printvarsallPrints variables defined by the makefile system (for debugging). -
      tagsMake C and C++ tags files for emacs and vi. -
      uninstallRemove built objects from installation directory. -
      -
      - - -
      all (default)
      -
      -

      When you invoke make with no arguments, you are implicitly - instructing it to seek the "all" target (goal). This target is used for - building the software recursively and will do different things in different - directories. For example, in a lib directory, the "all" target will - compile source files and generate libraries. But, in a tools - directory, it will link libraries and generate executables.

      -
      - - -
      all-local
      -
      -

      This target is the same as all but it operates only on - the current directory instead of recursively.

      -
      - - -
      check
      -
      -

      This target can be invoked from anywhere within a project's directories - but always invokes the check-local target - in the project's test directory, if it exists and has a - Makefile. A warning is produced otherwise. If - TESTSUITE is defined on the make - command line, it will be passed down to the invocation of - make check-local in the test directory. The intended usage - for this is to assist in running specific suites of tests. If - TESTSUITE is not set, the implementation of check-local - should run all normal tests. It is up to the project to define what - different values for TESTSUTE will do. See the - TestingGuide for further details.

      -
      - - -
      check-local
      -
      -

      This target should be implemented by the Makefile in the project's - test directory. It is invoked by the check target elsewhere. - Each project is free to define the actions of check-local as - appropriate for that project. The LLVM project itself uses dejagnu to run a - suite of feature and regresson tests. Other projects may choose to use - dejagnu or any other testing mechanism.

      -
      - - -
      clean
      -
      -

      This target cleans the build directory, recursively removing all things - that the Makefile builds. The cleaning rules have been made guarded so they - shouldn't go awry (via rm -f $(UNSET_VARIABLE)/* which will attempt - to erase the entire directory structure.

      -
      - - -
      clean-local
      -
      -

      This target does the same thing as clean but only for the current - (local) directory.

      -
      - - -
      dist
      -
      -

      This target builds a distribution tarball. It first builds the entire - project using the all target and then tars up the necessary files and - compresses it. The generated tarball is sufficient for a casual source - distribution, but probably not for a release (see dist-check).

      -
      - - -
      dist-check
      -
      -

      This target does the same thing as the dist target but also checks - the distribution tarball. The check is made by unpacking the tarball to a new - directory, configuring it, building it, installing it, and then verifying that - the installation results are correct (by comparing to the original build). - This target can take a long time to run but should be done before a release - goes out to make sure that the distributed tarball can actually be built into - a working release.

      -
      - - -
      dist-clean
      -
      -

      This is a special form of the clean clean target. It performs a - normal clean but also removes things pertaining to building the - distribution.

      -
      - - -
      install
      -
      -

      This target finalizes shared objects and executables and copies all - libraries, headers, executables and documentation to the directory given - with the --prefix option to configure. When completed, - the prefix directory will have everything needed to use LLVM.

      -

      The LLVM makefiles can generate complete internal documentation - for all the classes by using doxygen. By default, this feature is - not enabled because it takes a long time and generates a massive - amount of data (>100MB). If you want this feature, you must configure LLVM - with the --enable-doxygen switch and ensure that a modern version of doxygen - (1.3.7 or later) is available in your PATH. You can download - doxygen from - - here. -

      - - -
      preconditions
      -
      -

      This utility target checks to see if the Makefile in the object - directory is older than the Makefile in the source directory and - copies it if so. It also reruns the configure script if that needs to - be done and rebuilds the Makefile.config file similarly. Users may - overload this target to ensure that sanity checks are run before any - building of targets as all the targets depend on preconditions.

      -
      - - -
      printvars
      -
      -

      This utility target just causes the LLVM makefiles to print out some of - the makefile variables so that you can double check how things are set.

      -
      - - -
      reconfigure
      -
      -

      This utility target will force a reconfigure of LLVM or your project. It - simply runs $(PROJ_OBJ_ROOT)/config.status --recheck to rerun the - configuration tests and rebuild the configured files. This isn't generally - useful as the makefiles will reconfigure themselves whenever its necessary. -

      -
      - - -
      spotless
      -
      -

      This utility target, only available when $(PROJ_OBJ_ROOT) is not - the same as $(PROJ_SRC_ROOT), will completely clean the - $(PROJ_OBJ_ROOT) directory by removing its content entirely and - reconfiguring the directory. This returns the $(PROJ_OBJ_ROOT) - directory to a completely fresh state. All content in the directory except - configured files and top-level makefiles will be lost.

      -

      Use with caution.

      -
      - - -
      tags
      -
      -

      This target will generate a TAGS file in the top-level source - directory. It is meant for use with emacs, XEmacs, or ViM. The TAGS file - provides an index of symbol definitions so that the editor can jump you to the - definition quickly.

      -
      - - -
      uninstall
      -
      -

      This target is the opposite of the install target. It removes the - header, library and executable files from the installation directories. Note - that the directories themselves are not removed because it is not guaranteed - that LLVM is the only thing installing there (e.g. --prefix=/usr).

      -
      - - -
      Variables
      - -
      -

      Variables are used to tell the LLVM Makefile System what to do and to - obtain information from it. Variables are also used internally by the LLVM - Makefile System. Variable names that contain only the upper case alphabetic - letters and underscore are intended for use by the end user. All other - variables are internal to the LLVM Makefile System and should not be relied - upon nor modified. The sections below describe how to use the LLVM Makefile - variables.

      -
      - - -
      Control Variables
      -
      -

      Variables listed in the table below should be set before the - inclusion of $(LEVEL)/Makefile.common. - These variables provide input to the LLVM make system that tell it what to do - for the current directory.

      -
      -
      BUILD_ARCHIVE
      -
      If set to any value, causes an archive (.a) library to be built.
      -
      BUILT_SOURCES
      -
      Specifies a set of source files that are generated from other source - files. These sources will be built before any other target processing to - ensure they are present.
      -
      BYTECODE_LIBRARY
      -
      If set to any value, causes a bitcode library (.bc) to be built.
      -
      CONFIG_FILES
      -
      Specifies a set of configuration files to be installed.
      -
      DEBUG_SYMBOLS
      -
      If set to any value, causes the build to include debugging - symbols even in optimized objects, libraries and executables. This - alters the flags specified to the compilers and linkers. Debugging - isn't fun in an optimized build, but it is possible.
      -
      DIRS
      -
      Specifies a set of directories, usually children of the current - directory, that should also be made using the same goal. These directories - will be built serially.
      -
      DISABLE_AUTO_DEPENDENCIES
      -
      If set to any value, causes the makefiles to not automatically - generate dependencies when running the compiler. Use of this feature is - discouraged and it may be removed at a later date.
      -
      ENABLE_OPTIMIZED
      -
      If set to any value, causes the build to generate optimized objects, - libraries and executables. This alters the flags specified to the compilers - and linkers. Generally debugging won't be a fun experience with an optimized - build.
      -
      ENABLE_PROFILING
      -
      If set to any value, causes the build to generate both optimized and - profiled objects, libraries and executables. This alters the flags specified - to the compilers and linkers to ensure that profile data can be collected - from the tools built. Use the gprof tool to analyze the output from - the profiled tools (gmon.out).
      -
      DISABLE_ASSERTIONS
      -
      If set to any value, causes the build to disable assertions, even if - building a release or profile build. This will exclude all assertion check - code from the build. LLVM will execute faster, but with little help when - things go wrong.
      -
      EXPERIMENTAL_DIRS
      -
      Specify a set of directories that should be built, but if they fail, it - should not cause the build to fail. Note that this should only be used - temporarily while code is being written.
      -
      EXPORTED_SYMBOL_FILE
      -
      Specifies the name of a single file that contains a list of the - symbols to be exported by the linker. One symbol per line.
      -
      EXPORTED_SYMBOL_LIST
      -
      Specifies a set of symbols to be exported by the linker.
      -
      EXTRA_DIST
      -
      Specifies additional files that should be distributed with LLVM. All - source files, all built sources, all Makefiles, and most documentation files - will be automatically distributed. Use this variable to distribute any - files that are not automatically distributed.
      -
      KEEP_SYMBOLS
      -
      If set to any value, specifies that when linking executables the - makefiles should retain debug symbols in the executable. Normally, symbols - are stripped from the executable.
      -
      LEVEL(required)
      -
      Specify the level of nesting from the top level. This variable must be - set in each makefile as it is used to find the top level and thus the other - makefiles.
      -
      LIBRARYNAME
      -
      Specify the name of the library to be built. (Required For - Libraries)
      -
      LINK_COMPONENTS
      -
      When specified for building a tool, the value of this variable will be - passed to the llvm-config tool to generate a link line for the - tool. Unlike USEDLIBS and LLVMLIBS, not all libraries need - to be specified. The llvm-config tool will figure out the library - dependencies and add any libraries that are needed. The USEDLIBS - variable can still be used in conjunction with LINK_COMPONENTS so - that additional project-specific libraries can be linked with the LLVM - libraries specified by LINK_COMPONENTS
      -
      LINK_LIBS_IN_SHARED
      -
      By default, shared library linking will ignore any libraries specified - with the LLVMLIBS or USEDLIBS. - This prevents shared libs from including things that will be in the LLVM - tool the shared library will be loaded into. However, sometimes it is useful - to link certain libraries into your shared library and this option enables - that feature.
      -
      LLVMLIBS
      -
      Specifies the set of libraries from the LLVM $(ObjDir) that will be - linked into the tool or library.
      -
      LOADABLE_MODULE
      -
      If set to any value, causes the shared library being built to also be - a loadable module. Loadable modules can be opened with the dlopen() function - and searched with dlsym (or the operating system's equivalent). Note that - setting this variable without also setting SHARED_LIBRARY will have - no effect.
      -
      MODULE_NAME
      -
      Specifies the name of a bitcode module to be created. A bitcode - module can be specified in conjunction with other kinds of library builds - or by itself. It constructs from the sources a single linked bitcode - file.
      -
      NO_INSTALL
      -
      Specifies that the build products of the directory should not be - installed but should be built even if the install target is given. - This is handy for directories that build libraries or tools that are only - used as part of the build process, such as code generators (e.g. - tblgen).
      -
      OPTIONAL_DIRS
      -
      Specify a set of directories that may be built, if they exist, but its - not an error for them not to exist.
      -
      PARALLEL_DIRS
      -
      Specify a set of directories to build recursively and in parallel if - the -j option was used with make.
      -
      SHARED_LIBRARY
      -
      If set to any value, causes a shared library (.so) to be built in - addition to any other kinds of libraries. Note that this option will cause - all source files to be built twice: once with options for position - independent code and once without. Use it only where you really need a - shared library.
      -
      SOURCES(optional)
      -
      Specifies the list of source files in the current directory to be - built. Source files of any type may be specified (programs, documentation, - config files, etc.). If not specified, the makefile system will infer the - set of source files from the files present in the current directory.
      -
      SUFFIXES
      -
      Specifies a set of filename suffixes that occur in suffix match rules. - Only set this if your local Makefile specifies additional suffix - match rules.
      -
      TARGET
      -
      Specifies the name of the LLVM code generation target that the - current directory builds. Setting this variable enables additional rules to - build .inc files from .td files.
      -
      TESTSUITE
      -
      Specifies the directory of tests to run in llvm/test.
      -
      TOOLNAME
      -
      Specifies the name of the tool that the current directory should - build.
      -
      TOOL_VERBOSE
      -
      Implies VERBOSE and also tells each tool invoked to be verbose. This is - handy when you're trying to see the sub-tools invoked by each tool invoked - by the makefile. For example, this will pass -v to the GCC - compilers which causes it to print out the command lines it uses to invoke - sub-tools (compiler, assembler, linker).
      -
      USEDLIBS
      -
      Specifies the list of project libraries that will be linked into the - tool or library.
      -
      VERBOSE
      -
      Tells the Makefile system to produce detailed output of what it is doing - instead of just summary comments. This will generate a LOT of output.
      -
      -
      - - -
      Override Variables
      -
      -

      Override variables can be used to override the default - values provided by the LLVM makefile system. These variables can be set in - several ways:

      -
        -
      • In the environment (e.g. setenv, export) -- not recommended.
        • -
      • On the make command line -- recommended.
        • -
      • On the configure command line
        • -
      • In the Makefile (only after the inclusion of $(LEVEL)/Makefile.common).
        • -
      -

      The override variables are given below:

      -
      -
      AR (defaulted)
      -
      Specifies the path to the ar tool.
      -
      PROJ_OBJ_DIR
      -
      The directory into which the products of build rules will be placed. - This might be the same as - PROJ_SRC_DIR but typically is - not.
      -
      PROJ_SRC_DIR
      -
      The directory which contains the source files to be built.
      -
      BZIP2(configured)
      -
      The path to the bzip2 tool.
      -
      CC(configured)
      -
      The path to the 'C' compiler.
      -
      CFLAGS
      -
      Additional flags to be passed to the 'C' compiler.
      -
      CXX
      -
      Specifies the path to the C++ compiler.
      -
      CXXFLAGS
      -
      Additional flags to be passed to the C++ compiler.
      -
      DATE(configured)
      -
      Specifies the path to the date program or any program that can - generate the current date and time on its standard output
      -
      DOT(configured)
      -
      Specifies the path to the dot tool or false if there - isn't one.
      -
      ECHO(configured)
      -
      Specifies the path to the echo tool for printing output.
      -
      EXEEXT(configured)
      -
      Provides the extension to be used on executables built by the makefiles. - The value may be empty on platforms that do not use file extensions for - executables (e.g. Unix).
      -
      INSTALL(configured)
      -
      Specifies the path to the install tool.
      -
      LDFLAGS(configured)
      -
      Allows users to specify additional flags to pass to the linker.
      -
      LIBS(configured)
      -
      The list of libraries that should be linked with each tool.
      -
      LIBTOOL(configured)
      -
      Specifies the path to the libtool tool. This tool is renamed - mklib by the configure script and always located in the -
      LLVMAS(defaulted)
      -
      Specifies the path to the llvm-as tool.
      -
      LLVMCC
      -
      Specifies the path to the LLVM capable compiler.
      -
      LLVMCXX
      -
      Specifies the path to the LLVM C++ capable compiler.
      -
      LLVMGCC(defaulted)
      -
      Specifies the path to the LLVM version of the GCC 'C' Compiler
      -
      LLVMGXX(defaulted)
      -
      Specifies the path to the LLVM version of the GCC C++ Compiler
      -
      LLVMLD(defaulted)
      -
      Specifies the path to the LLVM bitcode linker tool
      -
      LLVM_OBJ_ROOT(configured) -
      -
      Specifies the top directory into which the output of the build is - placed.
      -
      LLVM_SRC_ROOT(configured) -
      -
      Specifies the top directory in which the sources are found.
      -
      LLVM_TARBALL_NAME - (configured)
      -
      Specifies the name of the distribution tarball to create. This is - configured from the name of the project and its version number.
      -
      MKDIR(defaulted)
      -
      Specifies the path to the mkdir tool that creates - directories.
      -
      ONLY_TOOLS
      -
      If set, specifies the list of tools to build.
      -
      PLATFORMSTRIPOPTS
      -
      The options to provide to the linker to specify that a stripped (no - symbols) executable should be built.
      -
      RANLIB(defaulted)
      -
      Specifies the path to the ranlib tool.
      -
      RM(defaulted)
      -
      Specifies the path to the rm tool.
      -
      SED(defaulted)
      -
      Specifies the path to the sed tool.
      -
      SHLIBEXT(configured)
      -
      Provides the filename extension to use for shared libraries.
      -
      TBLGEN(defaulted)
      -
      Specifies the path to the tblgen tool.
      -
      TAR(defaulted)
      -
      Specifies the path to the tar tool.
      -
      ZIP(defaulted)
      -
      Specifies the path to the zip tool.
      -
      -
      - - -
      Readable Variables
      -
      -

      Variables listed in the table below can be used by the user's Makefile but - should not be changed. Changing the value will generally cause the build to go - wrong, so don't do it.

      -
      -
      bindir
      -
      The directory into which executables will ultimately be installed. This - value is derived from the --prefix option given to - configure.
      -
      BuildMode
      -
      The name of the type of build being performed: Debug, Release, or - Profile
      -
      bytecode_libdir
      -
      The directory into which bitcode libraries will ultimately be - installed. This value is derived from the --prefix option given to - configure.
      -
      ConfigureScriptFLAGS
      -
      Additional flags given to the configure script when - reconfiguring.
      -
      DistDir
      -
      The current directory for which a distribution copy is being - made.
      -
      Echo
      -
      The LLVM Makefile System output command. This provides the - llvm[n] prefix and starts with @ so the command itself is not - printed by make.
      -
      EchoCmd
      -
      Same as Echo but without the leading @. -
      -
      includedir
      -
      The directory into which include files will ultimately be installed. - This value is derived from the --prefix option given to - configure.
      -
      libdir
      -
      The directory into which native libraries will ultimately be installed. - This value is derived from the --prefix option given to - configure.
      -
      LibDir
      -
      The configuration specific directory into which libraries are placed - before installation.
      -
      MakefileConfig
      -
      Full path of the Makefile.config file.
      -
      MakefileConfigIn
      -
      Full path of the Makefile.config.in file.
      -
      ObjDir
      -
      The configuration and directory specific directory where build objects - (compilation results) are placed.
      -
      SubDirs
      -
      The complete list of sub-directories of the current directory as - specified by other variables.
      -
      Sources
      -
      The complete list of source files.
      -
      sysconfdir
      -
      The directory into which configuration files will ultimately be - installed. This value is derived from the --prefix option given to - configure.
      -
      ToolDir
      -
      The configuration specific directory into which executables are placed - before they are installed.
      -
      TopDistDir
      -
      The top most directory into which the distribution files are copied. -
      -
      Verb
      -
      Use this as the first thing on your build script lines to enable or - disable verbose mode. It expands to either an @ (quiet mode) or nothing - (verbose mode).
      -
      -
      - - -
      Internal Variables
      -
      -

      Variables listed below are used by the LLVM Makefile System - and considered internal. You should not use these variables under any - circumstances.

      -

      - Archive - AR.Flags - BaseNameSources - BCCompile.C - BCCompile.CXX - BCLinkLib - C.Flags - Compile.C - CompileCommonOpts - Compile.CXX - ConfigStatusScript - ConfigureScript - CPP.Flags - CPP.Flags - CXX.Flags - DependFiles - DestArchiveLib - DestBitcodeLib - DestModule - DestSharedLib - DestTool - DistAlways - DistCheckDir - DistCheckTop - DistFiles - DistName - DistOther - DistSources - DistSubDirs - DistTarBZ2 - DistTarGZip - DistZip - ExtraLibs - FakeSources - INCFiles - InternalTargets - LD.Flags - LibName.A - LibName.BC - LibName.LA - LibName.O - LibTool.Flags - Link - LinkModule - LLVMLibDir - LLVMLibsOptions - LLVMLibsPaths - LLVMToolDir - LLVMUsedLibs - LocalTargets - Module - ObjectsBC - ObjectsLO - ObjectsO - ObjMakefiles - ParallelTargets - PreConditions - ProjLibsOptions - ProjLibsPaths - ProjUsedLibs - Ranlib - RecursiveTargets - SrcMakefiles - Strip - StripWarnMsg - TableGen - TDFiles - ToolBuildPath - TopLevelTargets - UserTargets -

      -
      - - -
      -
      - Valid CSS - Valid HTML 4.01 - - Reid Spencer
      - The LLVM Compiler Infrastructure
      - Last modified: $Date$ -
      - - Removed: llvm/trunk/docs/Packaging.html URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/Packaging.html?rev=103212&view=auto ============================================================================== --- llvm/trunk/docs/Packaging.html (original) +++ llvm/trunk/docs/Packaging.html (removed) @@ -1,118 +0,0 @@ - - - - Advice on Packaging LLVM - - - - -
      Advice on Packaging LLVM
      -
        -
      1. Overview
        2. -
      2. Compile Flags
        3. -
      3. C++ Features
        4. -
      4. Shared Library
        5. -
      5. Dependencies
        6. -
      - - -
      Overview
      - -
      - -

      LLVM sets certain default configure options to make sure our developers don't -break things for constrained platforms. These settings are not optimal for most -desktop systems, and we hope that packagers (e.g., Redhat, Debian, MacPorts, -etc.) will tweak them. This document lists settings we suggest you tweak. -

      - -

      LLVM's API changes with each release, so users are likely to want, for -example, both LLVM-2.6 and LLVM-2.7 installed at the same time to support apps -developed against each. -

      -
      - - -
      Compile Flags
      - -
      - -

      LLVM runs much more quickly when it's optimized and assertions are removed. -However, such a build is currently incompatible with users who build without -defining NDEBUG, and the lack of assertions makes it hard to debug problems in -user code. We recommend allowing users to install both optimized and debug -versions of LLVM in parallel. The following configure flags are relevant: -

      - -
      -
      --disable-assertions
      Builds LLVM with NDEBUG - defined. Changes the LLVM ABI. Also available by setting - DISABLE_ASSERTIONS=0|1 in make's environment. This defaults - to enabled regardless of the optimization setting, but it slows things - down.
      - -
      --enable-debug-symbols
      Builds LLVM with -g. - Also available by setting DEBUG_SYMBOLS=0|1 in make's - environment. This defaults to disabled when optimizing, so you should turn it - back on to let users debug their programs.
      - -
      --enable-optimized
      (For svn checkouts) Builds LLVM with - -O2 and, by default, turns off debug symbols. Also available by - setting ENABLE_OPTIMIZED=0|1 in make's environment. This - defaults to enabled when not in a checkout.
      -
      -
      - - -
      C++ Features
      - -
      - -
      -
      RTTI
      LLVM disables RTTI by default. Add REQUIRES_RTTI=1 - to your environment while running make to re-enable it. This will - allow users to build with RTTI enabled and still inherit from LLVM - classes.
      -
      -
      - - -
      Shared Library
      - -
      - -

      Configure with --enable-shared to build -libLLVM-major.minor.(so|dylib) and link the tools -against it. This saves lots of binary size at the cost of some startup time. -

      -
      - - -
      Dependencies
      - -
      - -
      -
      --enable-libffi
      Depend on libffi to allow the LLVM -interpreter to call external functions.
      -
      --with-oprofile
      Depend on libopagent -(>=version 0.9.4) to let the LLVM JIT tell oprofile about function addresses and -line numbers.
      -
      -
      - - -
      -
      - Valid CSS - Valid HTML 4.01 - The LLVM Compiler Infrastructure
      - Last modified: $Date$ -
      - - Removed: llvm/trunk/docs/Passes.html URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/Passes.html?rev=103212&view=auto ============================================================================== --- llvm/trunk/docs/Passes.html (original) +++ llvm/trunk/docs/Passes.html (removed) @@ -1,1770 +0,0 @@ - - - - LLVM's Analysis and Transform Passes - - - - - - - -
      LLVM's Analysis and Transform Passes
      - -
        -
      1. Introduction
        2. -
      2. Analysis Passes -
      3. Transform Passes
        4. -
      4. Utility Passes
        5. -
      - -
      -

      Written by Reid Spencer - and Gordon Henriksen

      -
      - - -
      Introduction
      -
      -

      This document serves as a high level summary of the optimization features - that LLVM provides. Optimizations are implemented as Passes that traverse some - portion of a program to either collect information or transform the program. - The table below divides the passes that LLVM provides into three categories. - Analysis passes compute information that other passes can use or for debugging - or program visualization purposes. Transform passes can use (or invalidate) - the analysis passes. Transform passes all mutate the program in some way. - Utility passes provides some utility but don't otherwise fit categorization. - For example passes to extract functions to bitcode or write a module to - bitcode are neither analysis nor transform passes. -

      The table below provides a quick summary of each pass and links to the more - complete pass description later in the document.

      -
      -
      - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
      ANALYSIS PASSES
      OptionName
      -aa-evalExhaustive Alias Analysis Precision Evaluator
      -basicaaBasic Alias Analysis (default AA impl)
      -basiccgBasic CallGraph Construction
      -codegenprepareOptimize for code generation
      -count-aaCount Alias Analysis Query Responses
      -debug-aaAA use debugger
      -domfrontierDominance Frontier Construction
      -domtreeDominator Tree Construction
      -dot-callgraphPrint Call Graph to 'dot' file
      -dot-cfgPrint CFG of function to 'dot' file
      -dot-cfg-onlyPrint CFG of function to 'dot' file (with no function bodies)
      -globalsmodref-aaSimple mod/ref analysis for globals
      -instcountCounts the various types of Instructions
      -intervalsInterval Partition Construction
      -loopsNatural Loop Construction
      -memdepMemory Dependence Analysis
      -no-aaNo Alias Analysis (always returns 'may' alias)
      -no-profileNo Profile Information
      -postdomfrontierPost-Dominance Frontier Construction
      -postdomtreePost-Dominator Tree Construction
      -print-alias-setsAlias Set Printer
      -print-callgraphPrint a call graph
      -print-callgraph-sccsPrint SCCs of the Call Graph
      -print-cfg-sccsPrint SCCs of each function CFG
      -print-externalfnconstantsPrint external fn callsites passed constants
      -print-functionPrint function to stderr
      -print-modulePrint module to stderr
      -print-used-typesFind Used Types
      -profile-loaderLoad profile information from llvmprof.out
      -scalar-evolutionScalar Evolution Analysis
      -targetdataTarget Data Layout
      TRANSFORM PASSES
      OptionName
      -adceAggressive Dead Code Elimination
      -argpromotionPromote 'by reference' arguments to scalars
      -block-placementProfile Guided Basic Block Placement
      -break-crit-edgesBreak critical edges in CFG
      -codegenpreparePrepare a function for code generation
      -constmergeMerge Duplicate Global Constants
      -constpropSimple constant propagation
      -dceDead Code Elimination
      -deadargelimDead Argument Elimination
      -deadtypeelimDead Type Elimination
      -dieDead Instruction Elimination
      -dseDead Store Elimination
      -globaldceDead Global Elimination
      -globaloptGlobal Variable Optimizer
      -gvnGlobal Value Numbering
      -indmemremIndirect Malloc and Free Removal
      -indvarsCanonicalize Induction Variables
      -inlineFunction Integration/Inlining
      -insert-block-profilingInsert instrumentation for block profiling
      -insert-edge-profilingInsert instrumentation for edge profiling
      -insert-function-profilingInsert instrumentation for function profiling
      -insert-null-profiling-rsMeasure profiling framework overhead
      -insert-rs-profiling-frameworkInsert random sampling instrumentation framework
      -instcombineCombine redundant instructions
      -internalizeInternalize Global Symbols
      -ipconstpropInterprocedural constant propagation
      -ipsccpInterprocedural Sparse Conditional Constant Propagation
      -jump-threadingThread control through conditional blocks
      -lcssaLoop-Closed SSA Form Pass
      -licmLoop Invariant Code Motion
      -loop-deletionDead Loop Deletion Pass
      -loop-extractExtract loops into new functions
      -loop-extract-singleExtract at most one loop into a new function
      -loop-index-splitIndex Split Loops
      -loop-reduceLoop Strength Reduction
      -loop-rotateRotate Loops
      -loop-unrollUnroll loops
      -loop-unswitchUnswitch loops
      -loopsimplifyCanonicalize natural loops
      -lowerallocsLower allocations from instructions to calls
      -lowerinvokeLower invoke and unwind, for unwindless code generators
      -lowersetjmpLower Set Jump
      -lowerswitchLower SwitchInst's to branches
      -mem2regPromote Memory to Register
      -memcpyoptOptimize use of memcpy and friends
      -mergereturnUnify function exit nodes
      -prune-ehRemove unused exception handling info
      -reassociateReassociate expressions
      -reg2memDemote all values to stack slots
      -scalarreplScalar Replacement of Aggregates
      -sccpSparse Conditional Constant Propagation
      -simplify-libcallsSimplify well-known library calls
      -simplifycfgSimplify the CFG
      -stripStrip all symbols from a module
      -strip-dead-prototypesRemove unused function declarations
      -sretpromotionPromote sret arguments
      -tailcallelimTail Call Elimination
      -tailduplicateTail Duplication
      UTILITY PASSES
      OptionName
      -deadarghaX0rDead Argument Hacking (BUGPOINT USE ONLY; DO NOT USE)
      -extract-blocksExtract Basic Blocks From Module (for bugpoint use)
      -preverifyPreliminary module verification
      -verifyModule Verifier
      -view-cfgView CFG of function
      -view-cfg-onlyView CFG of function (with no function bodies)
      -
      - - -
      Analysis Passes
      -
      -

      This section describes the LLVM Analysis Passes.

      -
      - - -
      - Exhaustive Alias Analysis Precision Evaluator -
      -
      -

      This is a simple N^2 alias analysis accuracy evaluator. - Basically, for each function in the program, it simply queries to see how the - alias analysis implementation answers alias queries between each pair of - pointers in the function.

      - -

      This is inspired and adapted from code by: Naveen Neelakantam, Francesco - Spadini, and Wojciech Stryjewski.

      -
      - - -
      - Basic Alias Analysis (default AA impl) -
      -
      -

      - This is the default implementation of the Alias Analysis interface - that simply implements a few identities (two different globals cannot alias, - etc), but otherwise does no analysis. -

      -
      - - -
      - Basic CallGraph Construction -
      -
      -

      Yet to be written.

      -
      - - -
      - Optimize for code generation -
      -
      -

      - This pass munges the code in the input function to better prepare it for - SelectionDAG-based code generation. This works around limitations in it's - basic-block-at-a-time approach. It should eventually be removed. -

      -
      - - -
      - Count Alias Analysis Query Responses -
      -
      -

      - A pass which can be used to count how many alias queries - are being made and how the alias analysis implementation being used responds. -

      -
      - - -
      - AA use debugger -
      -
      -

      - This simple pass checks alias analysis users to ensure that if they - create a new value, they do not query AA without informing it of the value. - It acts as a shim over any other AA pass you want. -

      - -

      - Yes keeping track of every value in the program is expensive, but this is - a debugging pass. -

      -
      - - -
      - Dominance Frontier Construction -
      -
      -

      - This pass is a simple dominator construction algorithm for finding forward - dominator frontiers. -

      -
      - - -
      - Dominator Tree Construction -
      -
      -

      - This pass is a simple dominator construction algorithm for finding forward - dominators. -

      -
      - - -
      - Print Call Graph to 'dot' file -
      -
      -

      - This pass, only available in opt, prints the call graph into a - .dot graph. This graph can then be processed with the "dot" tool - to convert it to postscript or some other suitable format. -

      -
      - - -
      - Print CFG of function to 'dot' file -
      -
      -

      - This pass, only available in opt, prints the control flow graph - into a .dot graph. This graph can then be processed with the - "dot" tool to convert it to postscript or some other suitable format. -

      -
      - - -
      - Print CFG of function to 'dot' file (with no function bodies) -
      -
      -

      - This pass, only available in opt, prints the control flow graph - into a .dot graph, omitting the function bodies. This graph can - then be processed with the "dot" tool to convert it to postscript or some - other suitable format. -

      -
      - - -
      - Simple mod/ref analysis for globals -
      -
      -

      - This simple pass provides alias and mod/ref information for global values - that do not have their address taken, and keeps track of whether functions - read or write memory (are "pure"). For this simple (but very common) case, - we can provide pretty accurate and useful information. -

      -
      - - -
      - Counts the various types of Instructions -
      -
      -

      - This pass collects the count of all instructions and reports them -

      -
      - - -
      - Interval Partition Construction -
      -
      -

      - This analysis calculates and represents the interval partition of a function, - or a preexisting interval partition. -

      - -

      - In this way, the interval partition may be used to reduce a flow graph down - to its degenerate single node interval partition (unless it is irreducible). -

      -
      - - -
      - Natural Loop Construction -
      -
      -

      - This analysis is used to identify natural loops and determine the loop depth - of various nodes of the CFG. Note that the loops identified may actually be - several natural loops that share the same header node... not just a single - natural loop. -

      -
      - - -
      - Memory Dependence Analysis -
      -
      -

      - An analysis that determines, for a given memory operation, what preceding - memory operations it depends on. It builds on alias analysis information, and - tries to provide a lazy, caching interface to a common kind of alias - information query. -

      -
      - - -
      - No Alias Analysis (always returns 'may' alias) -
      -
      -

      - Always returns "I don't know" for alias queries. NoAA is unlike other alias - analysis implementations, in that it does not chain to a previous analysis. As - such it doesn't follow many of the rules that other alias analyses must. -

      -
      - - -
      - No Profile Information -
      -
      -

      - The default "no profile" implementation of the abstract - ProfileInfo interface. -

      -
      - - -
      - Post-Dominance Frontier Construction -
      -
      -

      - This pass is a simple post-dominator construction algorithm for finding - post-dominator frontiers. -

      -
      - - -
      - Post-Dominator Tree Construction -
      -
      -

      - This pass is a simple post-dominator construction algorithm for finding - post-dominators. -

      -
      - - -
      - Alias Set Printer -
      -
      -

      Yet to be written.

      -
      - - -
      - Print a call graph -
      -
      -

      - This pass, only available in opt, prints the call graph to - standard output in a human-readable form. -

      -
      - - -
      - Print SCCs of the Call Graph -
      -
      -

      - This pass, only available in opt, prints the SCCs of the call - graph to standard output in a human-readable form. -

      -
      - - -
      - Print SCCs of each function CFG -
      -
      -

      - This pass, only available in opt, prints the SCCs of each - function CFG to standard output in a human-readable form. -

      -
      - - -
      - Print external fn callsites passed constants -
      -
      -

      - This pass, only available in opt, prints out call sites to - external functions that are called with constant arguments. This can be - useful when looking for standard library functions we should constant fold - or handle in alias analyses. -

      -
      - - -
      - Print function to stderr -
      -
      -

      - The PrintFunctionPass class is designed to be pipelined with - other FunctionPasses, and prints out the functions of the module - as they are processed. -

      -
      - - -
      - Print module to stderr -
      -
      -

      - This pass simply prints out the entire module when it is executed. -

      -
      - - -
      - Find Used Types -
      -
      -

      - This pass is used to seek out all of the types in use by the program. Note - that this analysis explicitly does not include types only used by the symbol - table. -

      - - -
      - Load profile information from llvmprof.out -
      -
      -

      - A concrete implementation of profiling information that loads the information - from a profile dump file. -

      -
      - - -
      - Scalar Evolution Analysis -
      -
      -

      - The ScalarEvolution analysis can be used to analyze and - catagorize scalar expressions in loops. It specializes in recognizing general - induction variables, representing them with the abstract and opaque - SCEV class. Given this analysis, trip counts of loops and other - important properties can be obtained. -

      - -

      - This analysis is primarily useful for induction variable substitution and - strength reduction. -

      -
      - - -
      - Target Data Layout -
      -
      -

      Provides other passes access to information on how the size and alignment - required by the the target ABI for various data types.

      -
      - - -
      Transform Passes
      -
      -

      This section describes the LLVM Transform Passes.

      -
      - - -
      - Aggressive Dead Code Elimination -
      -
      -

      ADCE aggressively tries to eliminate code. This pass is similar to - DCE but it assumes that values are dead until proven - otherwise. This is similar to SCCP, except applied to - the liveness of values.

      -
      - - -
      - Promote 'by reference' arguments to scalars -
      -
      -

      - This pass promotes "by reference" arguments to be "by value" arguments. In - practice, this means looking for internal functions that have pointer - arguments. If it can prove, through the use of alias analysis, that an - argument is *only* loaded, then it can pass the value into the function - instead of the address of the value. This can cause recursive simplification - of code and lead to the elimination of allocas (especially in C++ template - code like the STL). -

      - -

      - This pass also handles aggregate arguments that are passed into a function, - scalarizing them if the elements of the aggregate are only loaded. Note that - it refuses to scalarize aggregates which would require passing in more than - three operands to the function, because passing thousands of operands for a - large array or structure is unprofitable! -

      - -

      - Note that this transformation could also be done for arguments that are only - stored to (returning the value instead), but does not currently. This case - would be best handled when and if LLVM starts supporting multiple return - values from functions. -

      -
      - - -
      - Profile Guided Basic Block Placement -
      -
      -

      This pass is a very simple profile guided basic block placement algorithm. - The idea is to put frequently executed blocks together at the start of the - function and hopefully increase the number of fall-through conditional - branches. If there is no profile information for a particular function, this - pass basically orders blocks in depth-first order.

      -
      - - -
      - Break critical edges in CFG -
      -
      -

      - Break all of the critical edges in the CFG by inserting a dummy basic block. - It may be "required" by passes that cannot deal with critical edges. This - transformation obviously invalidates the CFG, but can update forward dominator - (set, immediate dominators, tree, and frontier) information. -

      -
      - - -
      - Prepare a function for code generation -
      -
      - This pass munges the code in the input function to better prepare it for - SelectionDAG-based code generation. This works around limitations in it's - basic-block-at-a-time approach. It should eventually be removed. -
      - - -
      - Merge Duplicate Global Constants -
      -
      -

      - Merges duplicate global constants together into a single constant that is - shared. This is useful because some passes (ie TraceValues) insert a lot of - string constants into the program, regardless of whether or not an existing - string is available. -

      -
      - - -
      - Simple constant propagation -
      -
      -

      This file implements constant propagation and merging. It looks for - instructions involving only constant operands and replaces them with a - constant value instead of an instruction. For example:

      - 
      add i32 1, 2
      -

      becomes

      - 
      i32 3
      -

      NOTE: this pass has a habit of making definitions be dead. It is a good - idea to to run a DIE (Dead Instruction Elimination) pass - sometime after running this pass.

      -
      - - -
      - Dead Code Elimination -
      -
      -

      - Dead code elimination is similar to dead instruction - elimination, but it rechecks instructions that were used by removed - instructions to see if they are newly dead. -

      -
      - - -
      - Dead Argument Elimination -
      -
      -

      - This pass deletes dead arguments from internal functions. Dead argument - elimination removes arguments which are directly dead, as well as arguments - only passed into function calls as dead arguments of other functions. This - pass also deletes dead arguments in a similar way. -

      - -

      - This pass is often useful as a cleanup pass to run after aggressive - interprocedural passes, which add possibly-dead arguments. -

      -
      - - -
      - Dead Type Elimination -
      -
      -

      - This pass is used to cleanup the output of GCC. It eliminate names for types - that are unused in the entire translation unit, using the find used types pass. -

      -
      - - -
      - Dead Instruction Elimination -
      -
      -

      - Dead instruction elimination performs a single pass over the function, - removing instructions that are obviously dead. -

      -
      - - -
      - Dead Store Elimination -
      -
      -

      - A trivial dead store elimination that only considers basic-block local - redundant stores. -

      -
      - - -
      - Dead Global Elimination -
      -
      -

      - This transform is designed to eliminate unreachable internal globals from the - program. It uses an aggressive algorithm, searching out globals that are - known to be alive. After it finds all of the globals which are needed, it - deletes whatever is left over. This allows it to delete recursive chunks of - the program which are unreachable. -

      -
      - - -
      - Global Variable Optimizer -
      -
      -

      - This pass transforms simple global variables that never have their address - taken. If obviously true, it marks read/write globals as constant, deletes - variables only stored to, etc. -

      -
      - - -
      - Global Value Numbering -
      -
      -

      - This pass performs global value numbering to eliminate fully and partially - redundant instructions. It also performs redundant load elimination. -

      -
      - - - -
      - Indirect Malloc and Free Removal -
      -
      -

      - This pass finds places where memory allocation functions may escape into - indirect land. Some transforms are much easier (aka possible) only if free - or malloc are not called indirectly. -

      - -

      - Thus find places where the address of memory functions are taken and construct - bounce functions with direct calls of those functions. -

      -
      - - -
      - Canonicalize Induction Variables -
      -
      -

      - This transformation analyzes and transforms the induction variables (and - computations derived from them) into simpler forms suitable for subsequent - analysis and transformation. -

      - -

      - This transformation makes the following changes to each loop with an - identifiable induction variable: -

      - -
        -
      1. All loops are transformed to have a single canonical - induction variable which starts at zero and steps by one.
        2. -
      2. The canonical induction variable is guaranteed to be the first PHI node - in the loop header block.
        3. -
      3. Any pointer arithmetic recurrences are raised to use array - subscripts.
        4. -
      - -

      - If the trip count of a loop is computable, this pass also makes the following - changes: -

      - -
        -
      1. The exit condition for the loop is canonicalized to compare the - induction value against the exit value. This turns loops like: - 
        for (i = 7; i*i < 1000; ++i)
        - into - 
        for (i = 0; i != 25; ++i)
        2. -
      2. Any use outside of the loop of an expression derived from the indvar - is changed to compute the derived value outside of the loop, eliminating - the dependence on the exit value of the induction variable. If the only - purpose of the loop is to compute the exit value of some derived - expression, this transformation will make the loop dead.
        3. -
      - -

      - This transformation should be followed by strength reduction after all of the - desired loop transformations have been performed. Additionally, on targets - where it is profitable, the loop could be transformed to count down to zero - (the "do loop" optimization). -

      -
      - - -
      - Function Integration/Inlining -
      -
      -

      - Bottom-up inlining of functions into callees. -

      -
      - - -
      - Insert instrumentation for block profiling -
      -
      -

      - This pass instruments the specified program with counters for basic block - profiling, which counts the number of times each basic block executes. This - is the most basic form of profiling, which can tell which blocks are hot, but - cannot reliably detect hot paths through the CFG. -

      - -

      - Note that this implementation is very na??ve. Control equivalent regions of - the CFG should not require duplicate counters, but it does put duplicate - counters in. -

      -
      - - -
      - Insert instrumentation for edge profiling -
      -
      -

      - This pass instruments the specified program with counters for edge profiling. - Edge profiling can give a reasonable approximation of the hot paths through a - program, and is used for a wide variety of program transformations. -

      - -

      - Note that this implementation is very na??ve. It inserts a counter for - every edge in the program, instead of using control flow information - to prune the number of counters inserted. -

      -
      - - -
      - Insert instrumentation for function profiling -
      -
      -

      - This pass instruments the specified program with counters for function - profiling, which counts the number of times each function is called. -

      -
      - - -
      - Measure profiling framework overhead -
      -
      -

      - The basic profiler that does nothing. It is the default profiler and thus - terminates RSProfiler chains. It is useful for measuring - framework overhead. -

      -
      - - -
      - Insert random sampling instrumentation framework -
      -
      -

      - The second stage of the random-sampling instrumentation framework, duplicates - all instructions in a function, ignoring the profiling code, then connects the - two versions together at the entry and at backedges. At each connection point - a choice is made as to whether to jump to the profiled code (take a sample) or - execute the unprofiled code. -

      - -

      - After this pass, it is highly recommended to runmem2reg - and adce. instcombine, - load-vn, gdce, and - dse also are good to run afterwards. -

      -
      - - -
      - Combine redundant instructions -
      -
      -

      - Combine instructions to form fewer, simple - instructions. This pass does not modify the CFG This pass is where algebraic - simplification happens. -

      - -

      - This pass combines things like: -

      - -
      %Y = add i32 %X, 1
-%Z = add i32 %Y, 1
      - -

      - into: -

      - -
      %Z = add i32 %X, 2
      - -

      - This is a simple worklist driven algorithm. -

      - -

      - This pass guarantees that the following canonicalizations are performed on - the program: -

      - -
        -
      • If a binary operator has a constant operand, it is moved to the right- - hand side.
        • -
      • Bitwise operators with constant operands are always grouped so that - shifts are performed first, then ors, then - ands, then xors.
        • -
      • Compare instructions are converted from <, - >, ???, or ??? to - = or ??? if possible.
        • -
      • All cmp instructions on boolean values are replaced with - logical operations.
        • -
      • add X, X is represented as - mul X, 2 ??? shl X, 1
        • -
      • Multiplies with a constant power-of-two argument are transformed into - shifts.
        • -
      • ??? etc.
        • -
      -
      - - -
      - Internalize Global Symbols -
      -
      -

      - This pass loops over all of the functions in the input module, looking for a - main function. If a main function is found, all other functions and all - global variables with initializers are marked as internal. -

      -
      - - -
      - Interprocedural constant propagation -
      -
      -

      - This pass implements an extremely simple interprocedural constant - propagation pass. It could certainly be improved in many different ways, - like using a worklist. This pass makes arguments dead, but does not remove - them. The existing dead argument elimination pass should be run after this - to clean up the mess. -

      -
      - - -
      - Interprocedural Sparse Conditional Constant Propagation -
      -
      -

      - An interprocedural variant of Sparse Conditional Constant - Propagation. -

      -
      - - -
      - Thread control through conditional blocks -
      -
      -

      - Jump threading tries to find distinct threads of control flow running through - a basic block. This pass looks at blocks that have multiple predecessors and - multiple successors. If one or more of the predecessors of the block can be - proven to always cause a jump to one of the successors, we forward the edge - from the predecessor to the successor by duplicating the contents of this - block. -

      -

      - An example of when this can occur is code like this: -

      - - 
      if () { ...
-  X = 4;
-}
-if (X < 3) {
      - -

      - In this case, the unconditional branch at the end of the first if can be - revectored to the false side of the second if. -

      -
      - - -
      - Loop-Closed SSA Form Pass -
      -
      -

      - This pass transforms loops by placing phi nodes at the end of the loops for - all values that are live across the loop boundary. For example, it turns - the left into the right code: -

      - - 
      for (...)                for (...)
-  if (c)                   if (c)
-    X1 = ...                 X1 = ...
-  else                     else
-    X2 = ...                 X2 = ...
-  X3 = phi(X1, X2)         X3 = phi(X1, X2)
-... = X3 + 4              X4 = phi(X3)
-                          ... = X4 + 4
      - -

      - This is still valid LLVM; the extra phi nodes are purely redundant, and will - be trivially eliminated by InstCombine. The major benefit of - this transformation is that it makes many other loop optimizations, such as - LoopUnswitching, simpler. -

      -
      - - -
      - Loop Invariant Code Motion -
      -
      -

      - This pass performs loop invariant code motion, attempting to remove as much - code from the body of a loop as possible. It does this by either hoisting - code into the preheader block, or by sinking code to the exit blocks if it is - safe. This pass also promotes must-aliased memory locations in the loop to - live in registers, thus hoisting and sinking "invariant" loads and stores. -

      - -

      - This pass uses alias analysis for two purposes: -

      - -
        -
      • Moving loop invariant loads and calls out of loops. If we can determine - that a load or call inside of a loop never aliases anything stored to, - we can hoist it or sink it like any other instruction.
        • -
      • Scalar Promotion of Memory - If there is a store instruction inside of - the loop, we try to move the store to happen AFTER the loop instead of - inside of the loop. This can only happen if a few conditions are true: -
          -
        • The pointer stored through is loop invariant.
          • -
        • There are no stores or loads in the loop which may alias - the pointer. There are no calls in the loop which mod/ref the - pointer.
          • -
        - If these conditions are true, we can promote the loads and stores in the - loop of the pointer to use a temporary alloca'd variable. We then use - the mem2reg functionality to construct the appropriate SSA form for the - variable.
        • -
      -
      - -
      - Dead Loop Deletion Pass -
      -
      -

      - This file implements the Dead Loop Deletion Pass. This pass is responsible - for eliminating loops with non-infinite computable trip counts that have no - side effects or volatile instructions, and do not contribute to the - computation of the function's return value. -

      -
      - - -
      - Extract loops into new functions -
      -
      -

      - A pass wrapper around the ExtractLoop() scalar transformation to - extract each top-level loop into its own new function. If the loop is the - only loop in a given function, it is not touched. This is a pass most - useful for debugging via bugpoint. -

      -
      - - -
      - Extract at most one loop into a new function -
      -
      -

      - Similar to Extract loops into new functions, - this pass extracts one natural loop from the program into a function if it - can. This is used by bugpoint. -

      -
      - - -
      - Index Split Loops -
      -
      -

      - This pass divides loop's iteration range by spliting loop such that each - individual loop is executed efficiently. -

      -
      - - -
      - Loop Strength Reduction -
      -
      -

      - This pass performs a strength reduction on array references inside loops that - have as one or more of their components the loop induction variable. This is - accomplished by creating a new value to hold the initial value of the array - access for the first iteration, and then creating a new GEP instruction in - the loop to increment the value by the appropriate amount. -

      -
      - - -
      - Rotate Loops -
      -
      -

      A simple loop rotation transformation.

      -
      - - -
      - Unroll loops -
      -
      -

      - This pass implements a simple loop unroller. It works best when loops have - been canonicalized by the -indvars pass, - allowing it to determine the trip counts of loops easily. -

      -
      - - -
      - Unswitch loops -
      -
      -

      - This pass transforms loops that contain branches on loop-invariant conditions - to have multiple loops. For example, it turns the left into the right code: -

      - - 
      for (...)                  if (lic)
-  A                          for (...)
-  if (lic)                     A; B; C
-    B                      else
-  C                          for (...)
-                               A; C
      - -

      - This can increase the size of the code exponentially (doubling it every time - a loop is unswitched) so we only unswitch if the resultant code will be - smaller than a threshold. -

      - -

      - This pass expects LICM to be run before it to hoist invariant conditions out - of the loop, to make the unswitching opportunity obvious. -

      -
      - - -
      - Canonicalize natural loops -
      -
      -

      - This pass performs several transformations to transform natural loops into a - simpler form, which makes subsequent analyses and transformations simpler and - more effective. -

      - -

      - Loop pre-header insertion guarantees that there is a single, non-critical - entry edge from outside of the loop to the loop header. This simplifies a - number of analyses and transformations, such as LICM. -

      - -

      - Loop exit-block insertion guarantees that all exit blocks from the loop - (blocks which are outside of the loop that have predecessors inside of the - loop) only have predecessors from inside of the loop (and are thus dominated - by the loop header). This simplifies transformations such as store-sinking - that are built into LICM. -

      - -

      - This pass also guarantees that loops will have exactly one backedge. -

      - -

      - Note that the simplifycfg pass will clean up blocks which are split out but - end up being unnecessary, so usage of this pass should not pessimize - generated code. -

      - -

      - This pass obviously modifies the CFG, but updates loop information and - dominator information. -

      -
      - - -
      - Lower allocations from instructions to calls -
      -
      -

      - Turn malloc and free instructions into @malloc and - @free calls. -

      - -

      - This is a target-dependent tranformation because it depends on the size of - data types and alignment constraints. -

      -
      - - -
      - Lower invoke and unwind, for unwindless code generators -
      -
      -

      - This transformation is designed for use by code generators which do not yet - support stack unwinding. This pass supports two models of exception handling - lowering, the 'cheap' support and the 'expensive' support. -

      - -

      - 'Cheap' exception handling support gives the program the ability to execute - any program which does not "throw an exception", by turning 'invoke' - instructions into calls and by turning 'unwind' instructions into calls to - abort(). If the program does dynamically use the unwind instruction, the - program will print a message then abort. -

      - -

      - 'Expensive' exception handling support gives the full exception handling - support to the program at the cost of making the 'invoke' instruction - really expensive. It basically inserts setjmp/longjmp calls to emulate the - exception handling as necessary. -

      - -

      - Because the 'expensive' support slows down programs a lot, and EH is only - used for a subset of the programs, it must be specifically enabled by the - -enable-correct-eh-support option. -

      - -

      - Note that after this pass runs the CFG is not entirely accurate (exceptional - control flow edges are not correct anymore) so only very simple things should - be done after the lowerinvoke pass has run (like generation of native code). - This should not be used as a general purpose "my LLVM-to-LLVM pass doesn't - support the invoke instruction yet" lowering pass. -

      -
      - - -
      - Lower Set Jump -
      -
      -

      - Lowers setjmp and longjmp to use the LLVM invoke and unwind - instructions as necessary. -

      - -

      - Lowering of longjmp is fairly trivial. We replace the call with a - call to the LLVM library function __llvm_sjljeh_throw_longjmp(). - This unwinds the stack for us calling all of the destructors for - objects allocated on the stack. -

      - -

      - At a setjmp call, the basic block is split and the setjmp - removed. The calls in a function that have a setjmp are converted to - invoke where the except part checks to see if it's a longjmp - exception and, if so, if it's handled in the function. If it is, then it gets - the value returned by the longjmp and goes to where the basic block - was split. invoke instructions are handled in a similar fashion with - the original except block being executed if it isn't a longjmp - except that is handled by that function. -

      -
      - - -
      - Lower SwitchInst's to branches -
      -
      -

      - Rewrites switch instructions with a sequence of branches, which - allows targets to get away with not implementing the switch instruction until - it is convenient. -

      -
      - - -
      - Promote Memory to Register -
      -
      -

      - This file promotes memory references to be register references. It promotes - alloca instructions which only have loads and - stores as uses. An alloca is transformed by using dominator - frontiers to place phi nodes, then traversing the function in - depth-first order to rewrite loads and stores as - appropriate. This is just the standard SSA construction algorithm to construct - "pruned" SSA form. -

      -
      - - -
      - Optimize use of memcpy and friend -
      -
      -

      - This pass performs various transformations related to eliminating memcpy - calls, or transforming sets of stores into memset's. -

      -
      - - -
      - Unify function exit nodes -
      -
      -

      - Ensure that functions have at most one ret instruction in them. - Additionally, it keeps track of which node is the new exit node of the CFG. -

      -
      - - -
      - Remove unused exception handling info -
      -
      -

      - This file implements a simple interprocedural pass which walks the call-graph, - turning invoke instructions into call instructions if and - only if the callee cannot throw an exception. It implements this as a - bottom-up traversal of the call-graph. -

      -
      - - -
      - Reassociate expressions -
      -
      -

      - This pass reassociates commutative expressions in an order that is designed - to promote better constant propagation, GCSE, LICM, PRE, etc. -

      - -

      - For example: 4 + (x + 5) ??? x + (4 + 5) -

      - -

      - In the implementation of this algorithm, constants are assigned rank = 0, - function arguments are rank = 1, and other values are assigned ranks - corresponding to the reverse post order traversal of current function - (starting at 2), which effectively gives values in deep loops higher rank - than values not in loops. -

      -
      - - -
      - Demote all values to stack slots -
      -
      -

      - This file demotes all registers to memory references. It is intented to be - the inverse of -mem2reg. By converting to - load instructions, the only values live across basic blocks are - alloca instructions and load instructions before - phi nodes. It is intended that this should make CFG hacking much - easier. To make later hacking easier, the entry block is split into two, such - that all introduced alloca instructions (and nothing else) are in the - entry block. -

      -
      - - -
      - Scalar Replacement of Aggregates -
      -
      -

      - The well-known scalar replacement of aggregates transformation. This - transform breaks up alloca instructions of aggregate type (structure - or array) into individual alloca instructions for each member if - possible. Then, if possible, it transforms the individual alloca - instructions into nice clean scalar SSA form. -

      - -

      - This combines a simple scalar replacement of aggregates algorithm with the mem2reg algorithm because often interact, - especially for C++ programs. As such, iterating between scalarrepl, - then mem2reg until we run out of things to - promote works well. -

      -
      - - -
      - Sparse Conditional Constant Propagation -
      -
      -

      - Sparse conditional constant propagation and merging, which can be summarized - as: -

      - -
        -
      1. Assumes values are constant unless proven otherwise
        2. -
      2. Assumes BasicBlocks are dead unless proven otherwise
        3. -
      3. Proves values to be constant, and replaces them with constants
        4. -
      4. Proves conditional branches to be unconditional
        5. -
      - -

      - Note that this pass has a habit of making definitions be dead. It is a good - idea to to run a DCE pass sometime after running this pass. -

      -
      - - -
      - Simplify well-known library calls -
      -
      -

      - Applies a variety of small optimizations for calls to specific well-known - function calls (e.g. runtime library functions). For example, a call - exit(3) that occurs within the main() function can be - transformed into simply return 3. -

      -
      - - -
      - Simplify the CFG -
      -
      -

      - Performs dead code elimination and basic block merging. Specifically: -

      - -
        -
      1. Removes basic blocks with no predecessors.
        2. -
      2. Merges a basic block into its predecessor if there is only one and the - predecessor only has one successor.
        3. -
      3. Eliminates PHI nodes for basic blocks with a single predecessor.
        4. -
      4. Eliminates a basic block that only contains an unconditional - branch.
        5. -
      -
      - - -
      - Strip all symbols from a module -
      -
      -

      - Performs code stripping. This transformation can delete: -

      - -
        -
      1. names for virtual registers
        2. -
      2. symbols for internal globals and functions
        3. -
      3. debug information
        4. -
      - -

      - Note that this transformation makes code much less readable, so it should - only be used in situations where the strip utility would be used, - such as reducing code size or making it harder to reverse engineer code. -

      -
      - - -
      - Remove unused function declarations -
      -
      -

      - This pass loops over all of the functions in the input module, looking for - dead declarations and removes them. Dead declarations are declarations of - functions for which no implementation is available (i.e., declarations for - unused library functions). -

      -
      - - -
      - Promote sret arguments -
      -
      -

      - This pass finds functions that return a struct (using a pointer to the struct - as the first argument of the function, marked with the 'sret' attribute) and - replaces them with a new function that simply returns each of the elements of - that struct (using multiple return values). -

      - -

      - This pass works under a number of conditions: -

      - -
        -
      • The returned struct must not contain other structs
        • -
      • The returned struct must only be used to load values from
        • -
      • The placeholder struct passed in is the result of an alloca
        • -
      -
      - - -
      - Tail Call Elimination -
      -
      -

      - This file transforms calls of the current function (self recursion) followed - by a return instruction with a branch to the entry of the function, creating - a loop. This pass also implements the following extensions to the basic - algorithm: -

      - -
        -
      • Trivial instructions between the call and return do not prevent the - transformation from taking place, though currently the analysis cannot - support moving any really useful instructions (only dead ones). -
      • This pass transforms functions that are prevented from being tail - recursive by an associative expression to use an accumulator variable, - thus compiling the typical naive factorial or fib implementation - into efficient code. -
      • TRE is performed if the function returns void, if the return - returns the result returned by the call, or if the function returns a - run-time constant on all exits from the function. It is possible, though - unlikely, that the return returns something else (like constant 0), and - can still be TRE'd. It can be TRE'd if all other return - instructions in the function return the exact same value. -
      • If it can prove that callees do not access theier caller stack frame, - they are marked as eligible for tail call elimination (by the code - generator). -
      -
      - - -
      - Tail Duplication -
      -
      -

      - This pass performs a limited form of tail duplication, intended to simplify - CFGs by removing some unconditional branches. This pass is necessary to - straighten out loops created by the C front-end, but also is capable of - making other code nicer. After this pass is run, the CFG simplify pass - should be run to clean up the mess. -

      -
      - - -
      Utility Passes
      -
      -

      This section describes the LLVM Utility Passes.

      -
      - - -
      - Dead Argument Hacking (BUGPOINT USE ONLY; DO NOT USE) -
      -
      -

      - Same as dead argument elimination, but deletes arguments to functions which - are external. This is only for use by bugpoint.

      -
      - - -
      - Extract Basic Blocks From Module (for bugpoint use) -
      -
      -

      - This pass is used by bugpoint to extract all blocks from the module into their - own functions.

      -
      - - -
      - Preliminary module verification -
      -
      -

      - Ensures that the module is in the form required by the Module Verifier pass. -

      - -

      - Running the verifier runs this pass automatically, so there should be no need - to use it directly. -

      -
      - - -
      - Module Verifier -
      -
      -

      - Verifies an LLVM IR code. This is useful to run after an optimization which is - undergoing testing. Note that llvm-as verifies its input before - emitting bitcode, and also that malformed bitcode is likely to make LLVM - crash. All language front-ends are therefore encouraged to verify their output - before performing optimizing transformations. -

      - -
        -
      • Both of a binary operator's parameters are of the same type.
        • -
      • Verify that the indices of mem access instructions match other - operands.
        • -
      • Verify that arithmetic and other things are only performed on - first-class types. Verify that shifts and logicals only happen on - integrals f.e.
        • -
      • All of the constants in a switch statement are of the correct type.
        • -
      • The code is in valid SSA form.
        • -
      • It is illegal to put a label into any other type (like a structure) or - to return one.
        • -
      • Only phi nodes can be self referential: %x = add i32 %x, %x is - invalid.
        • -
      • PHI nodes must have an entry for each predecessor, with no extras.
        • -
      • PHI nodes must be the first thing in a basic block, all grouped - together.
        • -
      • PHI nodes must have at least one entry.
        • -
      • All basic blocks should only end with terminator insts, not contain - them.
        • -
      • The entry node to a function must not have predecessors.
        • -
      • All Instructions must be embedded into a basic block.
        • -
      • Functions cannot take a void-typed parameter.
        • -
      • Verify that a function's argument list agrees with its declared - type.
        • -
      • It is illegal to specify a name for a void value.
        • -
      • It is illegal to have a internal global value with no initializer.
        • -
      • It is illegal to have a ret instruction that returns a value that does - not agree with the function return value type.
        • -
      • Function call argument types match the function prototype.
        • -
      • All other things that are tested by asserts spread about the code.
        • -
      - -

      - Note that this does not provide full security verification (like Java), but - instead just tries to ensure that code is well-formed. -

      -
      - - -
      - View CFG of function -
      -
      -

      - Displays the control flow graph using the GraphViz tool. -

      -
      - - -
      - View CFG of function (with no function bodies) -
      -
      -

      - Displays the control flow graph using the GraphViz tool, but omitting function - bodies. -

      -
      - - - -
      -
      - Valid CSS - Valid HTML 4.01 - - Reid Spencer
      - LLVM Compiler Infrastructure
      - Last modified: $Date$ -
      - - - Removed: llvm/trunk/docs/ProgrammersManual.html URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/ProgrammersManual.html?rev=103212&view=auto ============================================================================== --- llvm/trunk/docs/ProgrammersManual.html (original) +++ llvm/trunk/docs/ProgrammersManual.html (removed) @@ -1,3950 +0,0 @@ - - - - - LLVM Programmer's Manual - - - - -
      - LLVM Programmer's Manual -
      - -
        -
      1. Introduction
        2. -
      2. General Information - -
        3. -
      3. Important and useful LLVM APIs - -
        4. -
      4. Picking the Right Data Structure for a Task - -
        5. -
      5. Helpful Hints for Common Operations - -
        6. - -
      6. Threads and LLVM - -
        7. - -
      7. Advanced Topics -
        8. - -
      8. The Core LLVM Class Hierarchy Reference - -
        9. -
      - -
      -

      Written by Chris Lattner, - Dinakar Dhurjati, - Gabor Greif, - Joel Stanley, - Reid Spencer and - Owen Anderson

      -
      - - -
      - Introduction -
      - - -
      - -

      This document is meant to highlight some of the important classes and -interfaces available in the LLVM source-base. This manual is not -intended to explain what LLVM is, how it works, and what LLVM code looks -like. It assumes that you know the basics of LLVM and are interested -in writing transformations or otherwise analyzing or manipulating the -code.

      - -

      This document should get you oriented so that you can find your -way in the continuously growing source code that makes up the LLVM -infrastructure. Note that this manual is not intended to serve as a -replacement for reading the source code, so if you think there should be -a method in one of these classes to do something, but it's not listed, -check the source. Links to the doxygen sources -are provided to make this as easy as possible.

      - -

      The first section of this document describes general information that is -useful to know when working in the LLVM infrastructure, and the second describes -the Core LLVM classes. In the future this manual will be extended with -information describing how to use extension libraries, such as dominator -information, CFG traversal routines, and useful utilities like the InstVisitor template.

      - -
      - - -
      - General Information -
      - - -
      - -

      This section contains general information that is useful if you are working -in the LLVM source-base, but that isn't specific to any particular API.

      - -
      - - -
      - The C++ Standard Template Library -
      - -
      - -

      LLVM makes heavy use of the C++ Standard Template Library (STL), -perhaps much more than you are used to, or have seen before. Because of -this, you might want to do a little background reading in the -techniques used and capabilities of the library. There are many good -pages that discuss the STL, and several books on the subject that you -can get, so it will not be discussed in this document.

      - -

      Here are some useful links:

      - -
        - -
      1. Dinkumware C++ Library -reference - an excellent reference for the STL and other parts of the -standard C++ library.
        2. - -
      2. C++ In a Nutshell - This is an -O'Reilly book in the making. It has a decent Standard Library -Reference that rivals Dinkumware's, and is unfortunately no longer free since the -book has been published.
        3. - -
      3. C++ Frequently Asked -Questions
        4. - -
      4. SGI's STL Programmer's Guide - -Contains a useful Introduction to the -STL.
        5. - -
      5. Bjarne Stroustrup's C++ -Page
        6. - -
      6. -Bruce Eckel's Thinking in C++, 2nd ed. Volume 2 Revision 4.0 (even better, get -the book).
        7. - -
      - -

      You are also encouraged to take a look at the LLVM Coding Standards guide which focuses on how -to write maintainable code more than where to put your curly braces.

      - -
      - - -
      - Other useful references -
      - -
      - -
        -
      1. CVS -Branch and Tag Primer
        2. -
      2. Using -static and shared libraries across platforms
        3. -
      - -
      - - -
      - Important and useful LLVM APIs -
      - - -
      - -

      Here we highlight some LLVM APIs that are generally useful and good to -know about when writing transformations.

      - -
      - - -
      - The isa<>, cast<> and - dyn_cast<> templates -
      - -
      - -

      The LLVM source-base makes extensive use of a custom form of RTTI. -These templates have many similarities to the C++ dynamic_cast<> -operator, but they don't have some drawbacks (primarily stemming from -the fact that dynamic_cast<> only works on classes that -have a v-table). Because they are used so often, you must know what they -do and how they work. All of these templates are defined in the llvm/Support/Casting.h -file (note that you very rarely have to include this file directly).

      - -
      -
      isa<>:
      - -

      The isa<> operator works exactly like the Java - "instanceof" operator. It returns true or false depending on whether - a reference or pointer points to an instance of the specified class. This can - be very useful for constraint checking of various sorts (example below).

      -
      - -
      cast<>:
      - -

      The cast<> operator is a "checked cast" operation. It - converts a pointer or reference from a base class to a derived class, causing - an assertion failure if it is not really an instance of the right type. This - should be used in cases where you have some information that makes you believe - that something is of the right type. An example of the isa<> - and cast<> template is:

      - -
      -
      -static bool isLoopInvariant(const Value *V, const Loop *L) {
-  if (isa<Constant>(V) || isa<Argument>(V) || isa<GlobalValue>(V))
-    return true;
-
-  // Otherwise, it must be an instruction...
-  return !L->contains(cast<Instruction>(V)->getParent());
-}
-
      -
      - -

      Note that you should not use an isa<> test followed - by a cast<>, for that use the dyn_cast<> - operator.

      - -
      - -
      dyn_cast<>:
      - -

      The dyn_cast<> operator is a "checking cast" operation. - It checks to see if the operand is of the specified type, and if so, returns a - pointer to it (this operator does not work with references). If the operand is - not of the correct type, a null pointer is returned. Thus, this works very - much like the dynamic_cast<> operator in C++, and should be - used in the same circumstances. Typically, the dyn_cast<> - operator is used in an if statement or some other flow control - statement like this:

      - -
      -
      -if (AllocationInst *AI = dyn_cast<AllocationInst>(Val)) {
-  // ...
-}
-
      -
      - -

      This form of the if statement effectively combines together a call - to isa<> and a call to cast<> into one - statement, which is very convenient.

      - -

      Note that the dyn_cast<> operator, like C++'s - dynamic_cast<> or Java's instanceof operator, can be - abused. In particular, you should not use big chained if/then/else - blocks to check for lots of different variants of classes. If you find - yourself wanting to do this, it is much cleaner and more efficient to use the - InstVisitor class to dispatch over the instruction type directly.

      - -
      - -
      cast_or_null<>:
      - -

      The cast_or_null<> operator works just like the - cast<> operator, except that it allows for a null pointer as an - argument (which it then propagates). This can sometimes be useful, allowing - you to combine several null checks into one.

      - -
      dyn_cast_or_null<>:
      - -

      The dyn_cast_or_null<> operator works just like the - dyn_cast<> operator, except that it allows for a null pointer - as an argument (which it then propagates). This can sometimes be useful, - allowing you to combine several null checks into one.

      - -
      - -

      These five templates can be used with any classes, whether they have a -v-table or not. To add support for these templates, you simply need to add -classof static methods to the class you are interested casting -to. Describing this is currently outside the scope of this document, but there -are lots of examples in the LLVM source base.

      - -
      - - - -
      - Passing strings (the StringRef -and Twine classes) -
      - -
      - -

      Although LLVM generally does not do much string manipulation, we do have -several important APIs which take strings. Two important examples are the -Value class -- which has names for instructions, functions, etc. -- and the -StringMap class which is used extensively in LLVM and Clang.

      - -

      These are generic classes, and they need to be able to accept strings which -may have embedded null characters. Therefore, they cannot simply take -a const char *, and taking a const std::string& requires -clients to perform a heap allocation which is usually unnecessary. Instead, -many LLVM APIs use a const StringRef& or a const -Twine& for passing strings efficiently.

      - -
      - - -
      - The StringRef class -
      - -
      - -

      The StringRef data type represents a reference to a constant string -(a character array and a length) and supports the common operations available -on std:string, but does not require heap allocation.

      - -

      It can be implicitly constructed using a C style null-terminated string, -an std::string, or explicitly with a character pointer and length. -For example, the StringRef find function is declared as:

      - -
      - iterator find(const StringRef &Key); -
      - -

      and clients can call it using any one of:

      - -
      -
      -  Map.find("foo");                 // Lookup "foo"
-  Map.find(std::string("bar"));    // Lookup "bar"
-  Map.find(StringRef("\0baz", 4)); // Lookup "\0baz"
-
      -
      - -

      Similarly, APIs which need to return a string may return a StringRef -instance, which can be used directly or converted to an std::string -using the str member function. See -"llvm/ADT/StringRef.h" -for more information.

      - -

      You should rarely use the StringRef class directly, because it contains -pointers to external memory it is not generally safe to store an instance of the -class (unless you know that the external storage will not be freed).

      - -
      - - -
      - The Twine class -
      - -
      - -

      The Twine class is an efficient way for APIs to accept concatenated -strings. For example, a common LLVM paradigm is to name one instruction based on -the name of another instruction with a suffix, for example:

      - -
      -
      -    New = CmpInst::Create(..., SO->getName() + ".cmp");
-
      -
      - -

      The Twine class is effectively a -lightweight rope -which points to temporary (stack allocated) objects. Twines can be implicitly -constructed as the result of the plus operator applied to strings (i.e., a C -strings, an std::string, or a StringRef). The twine delays the -actual concatenation of strings until it is actually required, at which point -it can be efficiently rendered directly into a character array. This avoids -unnecessary heap allocation involved in constructing the temporary results of -string concatenation. See -"llvm/ADT/Twine.h" -for more information.

      - -

      As with a StringRef, Twine objects point to external memory -and should almost never be stored or mentioned directly. They are intended -solely for use when defining a function which should be able to efficiently -accept concatenated strings.

      - -
      - - - -
      - The DEBUG() macro and -debug option -
      - -
      - -

      Often when working on your pass you will put a bunch of debugging printouts -and other code into your pass. After you get it working, you want to remove -it, but you may need it again in the future (to work out new bugs that you run -across).

      - -

      Naturally, because of this, you don't want to delete the debug printouts, -but you don't want them to always be noisy. A standard compromise is to comment -them out, allowing you to enable them if you need them in the future.

      - -

      The "llvm/Support/Debug.h" -file provides a macro named DEBUG() that is a much nicer solution to -this problem. Basically, you can put arbitrary code into the argument of the -DEBUG macro, and it is only executed if 'opt' (or any other -tool) is run with the '-debug' command line argument:

      - -
      -
      -DEBUG(errs() << "I am here!\n");
-
      -
      - -

      Then you can run your pass like this:

      - -
      -
      -$ opt < a.bc > /dev/null -mypass
-<no output>
-$ opt < a.bc > /dev/null -mypass -debug
-I am here!
-
      -
      - -

      Using the DEBUG() macro instead of a home-brewed solution allows you -to not have to create "yet another" command line option for the debug output for -your pass. Note that DEBUG() macros are disabled for optimized builds, -so they do not cause a performance impact at all (for the same reason, they -should also not contain side-effects!).

      - -

      One additional nice thing about the DEBUG() macro is that you can -enable or disable it directly in gdb. Just use "set DebugFlag=0" or -"set DebugFlag=1" from the gdb if the program is running. If the -program hasn't been started yet, you can always just run it with --debug.

      - -
      - - -
      - Fine grained debug info with DEBUG_TYPE and - the -debug-only option -
      - -
      - -

      Sometimes you may find yourself in a situation where enabling -debug -just turns on too much information (such as when working on the code -generator). If you want to enable debug information with more fine-grained -control, you define the DEBUG_TYPE macro and the -debug only -option as follows:

      - -
      -
      -#undef  DEBUG_TYPE
-DEBUG(errs() << "No debug type\n");
-#define DEBUG_TYPE "foo"
-DEBUG(errs() << "'foo' debug type\n");
-#undef  DEBUG_TYPE
-#define DEBUG_TYPE "bar"
-DEBUG(errs() << "'bar' debug type\n"));
-#undef  DEBUG_TYPE
-#define DEBUG_TYPE ""
-DEBUG(errs() << "No debug type (2)\n");
-
      -
      - -

      Then you can run your pass like this:

      - -
      -
      -$ opt < a.bc > /dev/null -mypass
-<no output>
-$ opt < a.bc > /dev/null -mypass -debug
-No debug type
-'foo' debug type
-'bar' debug type
-No debug type (2)
-$ opt < a.bc > /dev/null -mypass -debug-only=foo
-'foo' debug type
-$ opt < a.bc > /dev/null -mypass -debug-only=bar
-'bar' debug type
-
      -
      - -

      Of course, in practice, you should only set DEBUG_TYPE at the top of -a file, to specify the debug type for the entire module (if you do this before -you #include "llvm/Support/Debug.h", you don't have to insert the ugly -#undef's). Also, you should use names more meaningful than "foo" and -"bar", because there is no system in place to ensure that names do not -conflict. If two different modules use the same string, they will all be turned -on when the name is specified. This allows, for example, all debug information -for instruction scheduling to be enabled with -debug-type=InstrSched, -even if the source lives in multiple files.

      - -

      The DEBUG_WITH_TYPE macro is also available for situations where you -would like to set DEBUG_TYPE, but only for one specific DEBUG -statement. It takes an additional first parameter, which is the type to use. For -example, the preceding example could be written as:

      - - -
      -
      -DEBUG_WITH_TYPE("", errs() << "No debug type\n");
-DEBUG_WITH_TYPE("foo", errs() << "'foo' debug type\n");
-DEBUG_WITH_TYPE("bar", errs() << "'bar' debug type\n"));
-DEBUG_WITH_TYPE("", errs() << "No debug type (2)\n");
-
      -
      - -
      - - -
      - The Statistic class & -stats - option -
      - -
      - -

      The "llvm/ADT/Statistic.h" file -provides a class named Statistic that is used as a unified way to -keep track of what the LLVM compiler is doing and how effective various -optimizations are. It is useful to see what optimizations are contributing to -making a particular program run faster.

      - -

      Often you may run your pass on some big program, and you're interested to see -how many times it makes a certain transformation. Although you can do this with -hand inspection, or some ad-hoc method, this is a real pain and not very useful -for big programs. Using the Statistic class makes it very easy to -keep track of this information, and the calculated information is presented in a -uniform manner with the rest of the passes being executed.

      - -

      There are many examples of Statistic uses, but the basics of using -it are as follows:

      - -
        -

      1. Define your statistic like this:

        - -
        -
        -#define DEBUG_TYPE "mypassname"   // This goes before any #includes.
-STATISTIC(NumXForms, "The # of times I did stuff");
-
        -
        - -

        The STATISTIC macro defines a static variable, whose name is - specified by the first argument. The pass name is taken from the DEBUG_TYPE - macro, and the description is taken from the second argument. The variable - defined ("NumXForms" in this case) acts like an unsigned integer.

        2. - -

      2. Whenever you make a transformation, bump the counter:

        - -
        -
        -++NumXForms;   // I did stuff!
-
        -
        - -
        3. -
      - -

      That's all you have to do. To get 'opt' to print out the - statistics gathered, use the '-stats' option:

      - -
      -
      -$ opt -stats -mypassname < program.bc > /dev/null
-... statistics output ...
-
      -
      - -

      When running opt on a C file from the SPEC benchmark -suite, it gives a report that looks like this:

      - -
      -
      -   7646 bitcodewriter   - Number of normal instructions
-    725 bitcodewriter   - Number of oversized instructions
- 129996 bitcodewriter   - Number of bitcode bytes written
-   2817 raise           - Number of insts DCEd or constprop'd
-   3213 raise           - Number of cast-of-self removed
-   5046 raise           - Number of expression trees converted
-     75 raise           - Number of other getelementptr's formed
-    138 raise           - Number of load/store peepholes
-     42 deadtypeelim    - Number of unused typenames removed from symtab
-    392 funcresolve     - Number of varargs functions resolved
-     27 globaldce       - Number of global variables removed
-      2 adce            - Number of basic blocks removed
-    134 cee             - Number of branches revectored
-     49 cee             - Number of setcc instruction eliminated
-    532 gcse            - Number of loads removed
-   2919 gcse            - Number of instructions removed
-     86 indvars         - Number of canonical indvars added
-     87 indvars         - Number of aux indvars removed
-     25 instcombine     - Number of dead inst eliminate
-    434 instcombine     - Number of insts combined
-    248 licm            - Number of load insts hoisted
-   1298 licm            - Number of insts hoisted to a loop pre-header
-      3 licm            - Number of insts hoisted to multiple loop preds (bad, no loop pre-header)
-     75 mem2reg         - Number of alloca's promoted
-   1444 cfgsimplify     - Number of blocks simplified
-
      -
      - -

      Obviously, with so many optimizations, having a unified framework for this -stuff is very nice. Making your pass fit well into the framework makes it more -maintainable and useful.

      - -
      - - -
      - Viewing graphs while debugging code -
      - -
      - -

      Several of the important data structures in LLVM are graphs: for example -CFGs made out of LLVM BasicBlocks, CFGs made out of -LLVM MachineBasicBlocks, and -Instruction Selection -DAGs. In many cases, while debugging various parts of the compiler, it is -nice to instantly visualize these graphs.

      - -

      LLVM provides several callbacks that are available in a debug build to do -exactly that. If you call the Function::viewCFG() method, for example, -the current LLVM tool will pop up a window containing the CFG for the function -where each basic block is a node in the graph, and each node contains the -instructions in the block. Similarly, there also exists -Function::viewCFGOnly() (does not include the instructions), the -MachineFunction::viewCFG() and MachineFunction::viewCFGOnly(), -and the SelectionDAG::viewGraph() methods. Within GDB, for example, -you can usually use something like call DAG.viewGraph() to pop -up a window. Alternatively, you can sprinkle calls to these functions in your -code in places you want to debug.

      - -

      Getting this to work requires a small amount of configuration. On Unix -systems with X11, install the graphviz -toolkit, and make sure 'dot' and 'gv' are in your path. If you are running on -Mac OS/X, download and install the Mac OS/X Graphviz program, and add -/Applications/Graphviz.app/Contents/MacOS/ (or wherever you install -it) to your path. Once in your system and path are set up, rerun the LLVM -configure script and rebuild LLVM to enable this functionality.

      - -

      SelectionDAG has been extended to make it easier to locate -interesting nodes in large complex graphs. From gdb, if you -call DAG.setGraphColor(node, "color"), then the -next call DAG.viewGraph() would highlight the node in the -specified color (choices of colors can be found at colors.) More -complex node attributes can be provided with call -DAG.setGraphAttrs(node, "attributes") (choices can be -found at Graph -Attributes.) If you want to restart and clear all the current graph -attributes, then you can call DAG.clearGraphAttrs().

      - -
      - - -
      - Picking the Right Data Structure for a Task -
      - - -
      - -

      LLVM has a plethora of data structures in the llvm/ADT/ directory, - and we commonly use STL data structures. This section describes the trade-offs - you should consider when you pick one.

      - -

      -The first step is a choose your own adventure: do you want a sequential -container, a set-like container, or a map-like container? The most important -thing when choosing a container is the algorithmic properties of how you plan to -access the container. Based on that, you should use:

      - -
        -
      • a map-like container if you need efficient look-up - of an value based on another value. Map-like containers also support - efficient queries for containment (whether a key is in the map). Map-like - containers generally do not support efficient reverse mapping (values to - keys). If you need that, use two maps. Some map-like containers also - support efficient iteration through the keys in sorted order. Map-like - containers are the most expensive sort, only use them if you need one of - these capabilities.
        • - -
      • a set-like container if you need to put a bunch of - stuff into a container that automatically eliminates duplicates. Some - set-like containers support efficient iteration through the elements in - sorted order. Set-like containers are more expensive than sequential - containers. -
        • - -
      • a sequential container provides - the most efficient way to add elements and keeps track of the order they are - added to the collection. They permit duplicates and support efficient - iteration, but do not support efficient look-up based on a key. -
        • - -
      • a string container is a specialized sequential - container or reference structure that is used for character or byte - arrays.
        • - -
      • a bit container provides an efficient way to store and - perform set operations on sets of numeric id's, while automatically - eliminating duplicates. Bit containers require a maximum of 1 bit for each - identifier you want to store. -
        • -
      - -

      -Once the proper category of container is determined, you can fine tune the -memory use, constant factors, and cache behaviors of access by intelligently -picking a member of the category. Note that constant factors and cache behavior -can be a big deal. If you have a vector that usually only contains a few -elements (but could contain many), for example, it's much better to use -SmallVector than vector -. Doing so avoids (relatively) expensive malloc/free calls, which dwarf the -cost of adding the elements to the container.

      - -
      - - -
      - Sequential Containers (std::vector, std::list, etc) -
      - -
      -There are a variety of sequential containers available for you, based on your -needs. Pick the first in this section that will do what you want. -
      - - -
      - Fixed Size Arrays -
      - -
      -

      Fixed size arrays are very simple and very fast. They are good if you know -exactly how many elements you have, or you have a (low) upper bound on how many -you have.

      -
      - - -
      - Heap Allocated Arrays -
      - -
      -

      Heap allocated arrays (new[] + delete[]) are also simple. They are good if -the number of elements is variable, if you know how many elements you will need -before the array is allocated, and if the array is usually large (if not, -consider a SmallVector). The cost of a heap -allocated array is the cost of the new/delete (aka malloc/free). Also note that -if you are allocating an array of a type with a constructor, the constructor and -destructors will be run for every element in the array (re-sizable vectors only -construct those elements actually used).

      -
      - - -
      - "llvm/ADT/SmallVector.h" -
      - -
      -

      SmallVector<Type, N> is a simple class that looks and smells -just like vector<Type>: -it supports efficient iteration, lays out elements in memory order (so you can -do pointer arithmetic between elements), supports efficient push_back/pop_back -operations, supports efficient random access to its elements, etc.

      - -

      The advantage of SmallVector is that it allocates space for -some number of elements (N) in the object itself. Because of this, if -the SmallVector is dynamically smaller than N, no malloc is performed. This can -be a big win in cases where the malloc/free call is far more expensive than the -code that fiddles around with the elements.

      - -

      This is good for vectors that are "usually small" (e.g. the number of -predecessors/successors of a block is usually less than 8). On the other hand, -this makes the size of the SmallVector itself large, so you don't want to -allocate lots of them (doing so will waste a lot of space). As such, -SmallVectors are most useful when on the stack.

      - -

      SmallVector also provides a nice portable and efficient replacement for -alloca.

      - -
      - - -
      - <vector> -
      - -
      -

      -std::vector is well loved and respected. It is useful when SmallVector isn't: -when the size of the vector is often large (thus the small optimization will -rarely be a benefit) or if you will be allocating many instances of the vector -itself (which would waste space for elements that aren't in the container). -vector is also useful when interfacing with code that expects vectors :). -

      - -

      One worthwhile note about std::vector: avoid code like this:

      - -
      -
      -for ( ... ) {
-   std::vector<foo> V;
-   use V;
-}
-
      -
      - -

      Instead, write this as:

      - -
      -
      -std::vector<foo> V;
-for ( ... ) {
-   use V;
-   V.clear();
-}
-
      -
      - -

      Doing so will save (at least) one heap allocation and free per iteration of -the loop.

      - -
      - - -
      - <deque> -
      - -
      -

      std::deque is, in some senses, a generalized version of std::vector. Like -std::vector, it provides constant time random access and other similar -properties, but it also provides efficient access to the front of the list. It -does not guarantee continuity of elements within memory.

      - -

      In exchange for this extra flexibility, std::deque has significantly higher -constant factor costs than std::vector. If possible, use std::vector or -something cheaper.

      -
      - - -
      - <list> -
      - -
      -

      std::list is an extremely inefficient class that is rarely useful. -It performs a heap allocation for every element inserted into it, thus having an -extremely high constant factor, particularly for small data types. std::list -also only supports bidirectional iteration, not random access iteration.

      - -

      In exchange for this high cost, std::list supports efficient access to both -ends of the list (like std::deque, but unlike std::vector or SmallVector). In -addition, the iterator invalidation characteristics of std::list are stronger -than that of a vector class: inserting or removing an element into the list does -not invalidate iterator or pointers to other elements in the list.

      -
      - - -
      - llvm/ADT/ilist.h -
      - -
      -

      ilist<T> implements an 'intrusive' doubly-linked list. It is -intrusive, because it requires the element to store and provide access to the -prev/next pointers for the list.

      - -

      ilist has the same drawbacks as std::list, and additionally -requires an ilist_traits implementation for the element type, but it -provides some novel characteristics. In particular, it can efficiently store -polymorphic objects, the traits class is informed when an element is inserted or -removed from the list, and ilists are guaranteed to support a -constant-time splice operation.

      - -

      These properties are exactly what we want for things like -Instructions and basic blocks, which is why these are implemented with -ilists.

      - -Related classes of interest are explained in the following subsections: - -
      - - -
      - ilist_traits -
      - -
      -

      ilist_traits<T> is ilist<T>'s customization -mechanism. iplist<T> (and consequently ilist<T>) -publicly derive from this traits class.

      -
      - - -
      - iplist -
      - -
      -

      iplist<T> is ilist<T>'s base and as such -supports a slightly narrower interface. Notably, inserters from -T& are absent.

      - -

      ilist_traits<T> is a public base of this class and can be -used for a wide variety of customizations.

      -
      - - -
      - llvm/ADT/ilist_node.h -
      - -
      -

      ilist_node<T> implements a the forward and backward links -that are expected by the ilist<T> (and analogous containers) -in the default manner.

      - -

      ilist_node<T>s are meant to be embedded in the node type -T, usually T publicly derives from -ilist_node<T>.

      -
      - - -
      - Sentinels -
      - -
      -

      ilists have another specialty that must be considered. To be a good -citizen in the C++ ecosystem, it needs to support the standard container -operations, such as begin and end iterators, etc. Also, the -operator-- must work correctly on the end iterator in the -case of non-empty ilists.

      - -

      The only sensible solution to this problem is to allocate a so-called -sentinel along with the intrusive list, which serves as the end -iterator, providing the back-link to the last element. However conforming to the -C++ convention it is illegal to operator++ beyond the sentinel and it -also must not be dereferenced.

      - -

      These constraints allow for some implementation freedom to the ilist -how to allocate and store the sentinel. The corresponding policy is dictated -by ilist_traits<T>. By default a T gets heap-allocated -whenever the need for a sentinel arises.

      - -

      While the default policy is sufficient in most cases, it may break down when -T does not provide a default constructor. Also, in the case of many -instances of ilists, the memory overhead of the associated sentinels -is wasted. To alleviate the situation with numerous and voluminous -T-sentinels, sometimes a trick is employed, leading to ghostly -sentinels.

      - -

      Ghostly sentinels are obtained by specially-crafted ilist_traits<T> -which superpose the sentinel with the ilist instance in memory. Pointer -arithmetic is used to obtain the sentinel, which is relative to the -ilist's this pointer. The ilist is augmented by an -extra pointer, which serves as the back-link of the sentinel. This is the only -field in the ghostly sentinel which can be legally accessed.

      -
      - - -
      - Other Sequential Container options -
      - -
      -

      Other STL containers are available, such as std::string.

      - -

      There are also various STL adapter classes such as std::queue, -std::priority_queue, std::stack, etc. These provide simplified access to an -underlying container but don't affect the cost of the container itself.

      - -
      - - - -
      - Set-Like Containers (std::set, SmallSet, SetVector, etc) -
      - -
      - -

      Set-like containers are useful when you need to canonicalize multiple values -into a single representation. There are several different choices for how to do -this, providing various trade-offs.

      - -
      - - - -
      - A sorted 'vector' -
      - -
      - -

      If you intend to insert a lot of elements, then do a lot of queries, a -great approach is to use a vector (or other sequential container) with -std::sort+std::unique to remove duplicates. This approach works really well if -your usage pattern has these two distinct phases (insert then query), and can be -coupled with a good choice of sequential container. -

      - -

      -This combination provides the several nice properties: the result data is -contiguous in memory (good for cache locality), has few allocations, is easy to -address (iterators in the final vector are just indices or pointers), and can be -efficiently queried with a standard binary or radix search.

      - -
      - - -
      - "llvm/ADT/SmallSet.h" -
      - -
      - -

      If you have a set-like data structure that is usually small and whose elements -are reasonably small, a SmallSet<Type, N> is a good choice. This set -has space for N elements in place (thus, if the set is dynamically smaller than -N, no malloc traffic is required) and accesses them with a simple linear search. -When the set grows beyond 'N' elements, it allocates a more expensive representation that -guarantees efficient access (for most types, it falls back to std::set, but for -pointers it uses something far better, SmallPtrSet).

      - -

      The magic of this class is that it handles small sets extremely efficiently, -but gracefully handles extremely large sets without loss of efficiency. The -drawback is that the interface is quite small: it supports insertion, queries -and erasing, but does not support iteration.

      - -
      - - -
      - "llvm/ADT/SmallPtrSet.h" -
      - -
      - -

      SmallPtrSet has all the advantages of SmallSet (and a SmallSet of pointers is -transparently implemented with a SmallPtrSet), but also supports iterators. If -more than 'N' insertions are performed, a single quadratically -probed hash table is allocated and grows as needed, providing extremely -efficient access (constant time insertion/deleting/queries with low constant -factors) and is very stingy with malloc traffic.

      - -

      Note that, unlike std::set, the iterators of SmallPtrSet are invalidated -whenever an insertion occurs. Also, the values visited by the iterators are not -visited in sorted order.

      - -
      - - -
      - "llvm/ADT/DenseSet.h" -
      - -
      - -

      -DenseSet is a simple quadratically probed hash table. It excels at supporting -small values: it uses a single allocation to hold all of the pairs that -are currently inserted in the set. DenseSet is a great way to unique small -values that are not simple pointers (use SmallPtrSet for pointers). Note that DenseSet has -the same requirements for the value type that DenseMap has. -

      - -
      - - -
      - "llvm/ADT/FoldingSet.h" -
      - -
      - -

      -FoldingSet is an aggregate class that is really good at uniquing -expensive-to-create or polymorphic objects. It is a combination of a chained -hash table with intrusive links (uniqued objects are required to inherit from -FoldingSetNode) that uses SmallVector as part of -its ID process.

      - -

      Consider a case where you want to implement a "getOrCreateFoo" method for -a complex object (for example, a node in the code generator). The client has a -description of *what* it wants to generate (it knows the opcode and all the -operands), but we don't want to 'new' a node, then try inserting it into a set -only to find out it already exists, at which point we would have to delete it -and return the node that already exists. -

      - -

      To support this style of client, FoldingSet perform a query with a -FoldingSetNodeID (which wraps SmallVector) that can be used to describe the -element that we want to query for. The query either returns the element -matching the ID or it returns an opaque ID that indicates where insertion should -take place. Construction of the ID usually does not require heap traffic.

      - -

      Because FoldingSet uses intrusive links, it can support polymorphic objects -in the set (for example, you can have SDNode instances mixed with LoadSDNodes). -Because the elements are individually allocated, pointers to the elements are -stable: inserting or removing elements does not invalidate any pointers to other -elements. -

      - -
      - - -
      - <set> -
      - -
      - -

      std::set is a reasonable all-around set class, which is decent at -many things but great at nothing. std::set allocates memory for each element -inserted (thus it is very malloc intensive) and typically stores three pointers -per element in the set (thus adding a large amount of per-element space -overhead). It offers guaranteed log(n) performance, which is not particularly -fast from a complexity standpoint (particularly if the elements of the set are -expensive to compare, like strings), and has extremely high constant factors for -lookup, insertion and removal.

      - -

      The advantages of std::set are that its iterators are stable (deleting or -inserting an element from the set does not affect iterators or pointers to other -elements) and that iteration over the set is guaranteed to be in sorted order. -If the elements in the set are large, then the relative overhead of the pointers -and malloc traffic is not a big deal, but if the elements of the set are small, -std::set is almost never a good choice.

      - -
      - - -
      - "llvm/ADT/SetVector.h" -
      - -
      -

      LLVM's SetVector<Type> is an adapter class that combines your choice of -a set-like container along with a Sequential -Container. The important property -that this provides is efficient insertion with uniquing (duplicate elements are -ignored) with iteration support. It implements this by inserting elements into -both a set-like container and the sequential container, using the set-like -container for uniquing and the sequential container for iteration. -

      - -

      The difference between SetVector and other sets is that the order of -iteration is guaranteed to match the order of insertion into the SetVector. -This property is really important for things like sets of pointers. Because -pointer values are non-deterministic (e.g. vary across runs of the program on -different machines), iterating over the pointers in the set will -not be in a well-defined order.

      - -

      -The drawback of SetVector is that it requires twice as much space as a normal -set and has the sum of constant factors from the set-like container and the -sequential container that it uses. Use it *only* if you need to iterate over -the elements in a deterministic order. SetVector is also expensive to delete -elements out of (linear time), unless you use it's "pop_back" method, which is -faster. -

      - -

      SetVector is an adapter class that defaults to using std::vector and std::set -for the underlying containers, so it is quite expensive. However, -"llvm/ADT/SetVector.h" also provides a SmallSetVector class, which -defaults to using a SmallVector and SmallSet of a specified size. If you use -this, and if your sets are dynamically smaller than N, you will save a lot of -heap traffic.

      - -
      - - -
      - "llvm/ADT/UniqueVector.h" -
      - -
      - -

      -UniqueVector is similar to SetVector, but it -retains a unique ID for each element inserted into the set. It internally -contains a map and a vector, and it assigns a unique ID for each value inserted -into the set.

      - -

      UniqueVector is very expensive: its cost is the sum of the cost of -maintaining both the map and vector, it has high complexity, high constant -factors, and produces a lot of malloc traffic. It should be avoided.

      - -
      - - - -
      - Other Set-Like Container Options -
      - -
      - -

      -The STL provides several other options, such as std::multiset and the various -"hash_set" like containers (whether from C++ TR1 or from the SGI library). We -never use hash_set and unordered_set because they are generally very expensive -(each insertion requires a malloc) and very non-portable. -

      - -

      std::multiset is useful if you're not interested in elimination of -duplicates, but has all the drawbacks of std::set. A sorted vector (where you -don't delete duplicate entries) or some other approach is almost always -better.

      - -
      - - -
      - Map-Like Containers (std::map, DenseMap, etc) -
      - -
      -Map-like containers are useful when you want to associate data to a key. As -usual, there are a lot of different ways to do this. :) -
      - - -
      - A sorted 'vector' -
      - -
      - -

      -If your usage pattern follows a strict insert-then-query approach, you can -trivially use the same approach as sorted vectors -for set-like containers. The only difference is that your query function -(which uses std::lower_bound to get efficient log(n) lookup) should only compare -the key, not both the key and value. This yields the same advantages as sorted -vectors for sets. -

      -
      - - -
      - "llvm/ADT/StringMap.h" -
      - -
      - -

      -Strings are commonly used as keys in maps, and they are difficult to support -efficiently: they are variable length, inefficient to hash and compare when -long, expensive to copy, etc. StringMap is a specialized container designed to -cope with these issues. It supports mapping an arbitrary range of bytes to an -arbitrary other object.

      - -

      The StringMap implementation uses a quadratically-probed hash table, where -the buckets store a pointer to the heap allocated entries (and some other -stuff). The entries in the map must be heap allocated because the strings are -variable length. The string data (key) and the element object (value) are -stored in the same allocation with the string data immediately after the element -object. This container guarantees the "(char*)(&Value+1)" points -to the key string for a value.

      - -

      The StringMap is very fast for several reasons: quadratic probing is very -cache efficient for lookups, the hash value of strings in buckets is not -recomputed when lookup up an element, StringMap rarely has to touch the -memory for unrelated objects when looking up a value (even when hash collisions -happen), hash table growth does not recompute the hash values for strings -already in the table, and each pair in the map is store in a single allocation -(the string data is stored in the same allocation as the Value of a pair).

      - -

      StringMap also provides query methods that take byte ranges, so it only ever -copies a string if a value is inserted into the table.

      -
      - - -
      - "llvm/ADT/IndexedMap.h" -
      - -
      -

      -IndexedMap is a specialized container for mapping small dense integers (or -values that can be mapped to small dense integers) to some other type. It is -internally implemented as a vector with a mapping function that maps the keys to -the dense integer range. -

      - -

      -This is useful for cases like virtual registers in the LLVM code generator: they -have a dense mapping that is offset by a compile-time constant (the first -virtual register ID).

      - -
      - - -
      - "llvm/ADT/DenseMap.h" -
      - -
      - -

      -DenseMap is a simple quadratically probed hash table. It excels at supporting -small keys and values: it uses a single allocation to hold all of the pairs that -are currently inserted in the map. DenseMap is a great way to map pointers to -pointers, or map other small types to each other. -

      - -

      -There are several aspects of DenseMap that you should be aware of, however. The -iterators in a densemap are invalidated whenever an insertion occurs, unlike -map. Also, because DenseMap allocates space for a large number of key/value -pairs (it starts with 64 by default), it will waste a lot of space if your keys -or values are large. Finally, you must implement a partial specialization of -DenseMapInfo for the key that you want, if it isn't already supported. This -is required to tell DenseMap about two special marker values (which can never be -inserted into the map) that it needs internally.

      - -
      - - -
      - "llvm/ADT/ValueMap.h" -
      - -
      - -

      -ValueMap is a wrapper around a DenseMap mapping -Value*s (or subclasses) to another type. When a Value is deleted or RAUW'ed, -ValueMap will update itself so the new version of the key is mapped to the same -value, just as if the key were a WeakVH. You can configure exactly how this -happens, and what else happens on these two events, by passing -a Config parameter to the ValueMap template.

      - -
      - - -
      - <map> -
      - -
      - -

      -std::map has similar characteristics to std::set: it uses -a single allocation per pair inserted into the map, it offers log(n) lookup with -an extremely large constant factor, imposes a space penalty of 3 pointers per -pair in the map, etc.

      - -

      std::map is most useful when your keys or values are very large, if you need -to iterate over the collection in sorted order, or if you need stable iterators -into the map (i.e. they don't get invalidated if an insertion or deletion of -another element takes place).

      - -
      - - -
      - Other Map-Like Container Options -
      - -
      - -

      -The STL provides several other options, such as std::multimap and the various -"hash_map" like containers (whether from C++ TR1 or from the SGI library). We -never use hash_set and unordered_set because they are generally very expensive -(each insertion requires a malloc) and very non-portable.

      - -

      std::multimap is useful if you want to map a key to multiple values, but has -all the drawbacks of std::map. A sorted vector or some other approach is almost -always better.

      - -
      - - -
      - String-like containers -
      - -
      - -

      -TODO: const char* vs stringref vs smallstring vs std::string. Describe twine, -xref to #string_apis. -

      - -
      - - -
      - Bit storage containers (BitVector, SparseBitVector) -
      - -
      -

      Unlike the other containers, there are only two bit storage containers, and -choosing when to use each is relatively straightforward.

      - -

      One additional option is -std::vector<bool>: we discourage its use for two reasons 1) the -implementation in many common compilers (e.g. commonly available versions of -GCC) is extremely inefficient and 2) the C++ standards committee is likely to -deprecate this container and/or change it significantly somehow. In any case, -please don't use it.

      -
      - - -
      - BitVector -
      - -
      -

      The BitVector container provides a dynamic size set of bits for manipulation. -It supports individual bit setting/testing, as well as set operations. The set -operations take time O(size of bitvector), but operations are performed one word -at a time, instead of one bit at a time. This makes the BitVector very fast for -set operations compared to other containers. Use the BitVector when you expect -the number of set bits to be high (IE a dense set). -

      -
      - - -
      - SmallBitVector -
      - -
      -

      The SmallBitVector container provides the same interface as BitVector, but -it is optimized for the case where only a small number of bits, less than -25 or so, are needed. It also transparently supports larger bit counts, but -slightly less efficiently than a plain BitVector, so SmallBitVector should -only be used when larger counts are rare. -

      - -

      -At this time, SmallBitVector does not support set operations (and, or, xor), -and its operator[] does not provide an assignable lvalue. -

      -
      - - -
      - SparseBitVector -
      - -
      -

      The SparseBitVector container is much like BitVector, with one major -difference: Only the bits that are set, are stored. This makes the -SparseBitVector much more space efficient than BitVector when the set is sparse, -as well as making set operations O(number of set bits) instead of O(size of -universe). The downside to the SparseBitVector is that setting and testing of random bits is O(N), and on large SparseBitVectors, this can be slower than BitVector. In our implementation, setting or testing bits in sorted order -(either forwards or reverse) is O(1) worst case. Testing and setting bits within 128 bits (depends on size) of the current bit is also O(1). As a general statement, testing/setting bits in a SparseBitVector is O(distance away from last set bit). -

      -
      - - -
      - Helpful Hints for Common Operations -
      - - -
      - -

      This section describes how to perform some very simple transformations of -LLVM code. This is meant to give examples of common idioms used, showing the -practical side of LLVM transformations.

      Because this is a "how-to" section, -you should also read about the main classes that you will be working with. The -Core LLVM Class Hierarchy Reference contains details -and descriptions of the main classes that you should know about.

      - -
      - - - -
      - Basic Inspection and Traversal Routines -
      - -
      - -

      The LLVM compiler infrastructure have many different data structures that may -be traversed. Following the example of the C++ standard template library, the -techniques used to traverse these various data structures are all basically the -same. For a enumerable sequence of values, the XXXbegin() function (or -method) returns an iterator to the start of the sequence, the XXXend() -function returns an iterator pointing to one past the last valid element of the -sequence, and there is some XXXiterator data type that is common -between the two operations.

      - -

      Because the pattern for iteration is common across many different aspects of -the program representation, the standard template library algorithms may be used -on them, and it is easier to remember how to iterate. First we show a few common -examples of the data structures that need to be traversed. Other data -structures are traversed in very similar ways.

      - -
      - - -
      - Iterating over the BasicBlocks in a Function -
      - -
      - -

      It's quite common to have a Function instance that you'd like to -transform in some way; in particular, you'd like to manipulate its -BasicBlocks. To facilitate this, you'll need to iterate over all of -the BasicBlocks that constitute the Function. The following is -an example that prints the name of a BasicBlock and the number of -Instructions it contains:

      - -
      -
      -// func is a pointer to a Function instance
-for (Function::iterator i = func->begin(), e = func->end(); i != e; ++i)
-  // Print out the name of the basic block if it has one, and then the
-  // number of instructions that it contains
-  errs() << "Basic block (name=" << i->getName() << ") has "
-             << i->size() << " instructions.\n";
-
      -
      - -

      Note that i can be used as if it were a pointer for the purposes of -invoking member functions of the Instruction class. This is -because the indirection operator is overloaded for the iterator -classes. In the above code, the expression i->size() is -exactly equivalent to (*i).size() just like you'd expect.

      - -
      - - -
      - Iterating over the Instructions in a BasicBlock -
      - -
      - -

      Just like when dealing with BasicBlocks in Functions, it's -easy to iterate over the individual instructions that make up -BasicBlocks. Here's a code snippet that prints out each instruction in -a BasicBlock:

      - -
      -
      -// blk is a pointer to a BasicBlock instance
-for (BasicBlock::iterator i = blk->begin(), e = blk->end(); i != e; ++i)
-   // The next statement works since operator<<(ostream&,...)
-   // is overloaded for Instruction&
-   errs() << *i << "\n";
-
      -
      - -

      However, this isn't really the best way to print out the contents of a -BasicBlock! Since the ostream operators are overloaded for virtually -anything you'll care about, you could have just invoked the print routine on the -basic block itself: errs() << *blk << "\n";.

      - -
      - - -
      - Iterating over the Instructions in a Function -
      - -
      - -

      If you're finding that you commonly iterate over a Function's -BasicBlocks and then that BasicBlock's Instructions, -InstIterator should be used instead. You'll need to include llvm/Support/InstIterator.h, -and then instantiate InstIterators explicitly in your code. Here's a -small example that shows how to dump all instructions in a function to the standard error stream:

      - -

      -
      -#include "llvm/Support/InstIterator.h"
-
-// F is a pointer to a Function instance
-for (inst_iterator I = inst_begin(F), E = inst_end(F); I != E; ++I)
-  errs() << *I << "\n";
-
      -
      - -

      Easy, isn't it? You can also use InstIterators to fill a -work list with its initial contents. For example, if you wanted to -initialize a work list to contain all instructions in a Function -F, all you would need to do is something like:

      - -
      -
      -std::set<Instruction*> worklist;
-// or better yet, SmallPtrSet<Instruction*, 64> worklist;
-
-for (inst_iterator I = inst_begin(F), E = inst_end(F); I != E; ++I)
-   worklist.insert(&*I);
-
      -
      - -

      The STL set worklist would now contain all instructions in the -Function pointed to by F.

      - -
      - - -
      - Turning an iterator into a class pointer (and - vice-versa) -
      - -
      - -

      Sometimes, it'll be useful to grab a reference (or pointer) to a class -instance when all you've got at hand is an iterator. Well, extracting -a reference or a pointer from an iterator is very straight-forward. -Assuming that i is a BasicBlock::iterator and j -is a BasicBlock::const_iterator:

      - -
      -
      -Instruction& inst = *i;   // Grab reference to instruction reference
-Instruction* pinst = &*i; // Grab pointer to instruction reference
-const Instruction& inst = *j;
-
      -
      - -

      However, the iterators you'll be working with in the LLVM framework are -special: they will automatically convert to a ptr-to-instance type whenever they -need to. Instead of dereferencing the iterator and then taking the address of -the result, you can simply assign the iterator to the proper pointer type and -you get the dereference and address-of operation as a result of the assignment -(behind the scenes, this is a result of overloading casting mechanisms). Thus -the last line of the last example,

      - -
      -
      -Instruction *pinst = &*i;
-
      -
      - -

      is semantically equivalent to

      - -
      -
      -Instruction *pinst = i;
-
      -
      - -

      It's also possible to turn a class pointer into the corresponding iterator, -and this is a constant time operation (very efficient). The following code -snippet illustrates use of the conversion constructors provided by LLVM -iterators. By using these, you can explicitly grab the iterator of something -without actually obtaining it via iteration over some structure:

      - -
      -
      -void printNextInstruction(Instruction* inst) {
-  BasicBlock::iterator it(inst);
-  ++it; // After this line, it refers to the instruction after *inst
-  if (it != inst->getParent()->end()) errs() << *it << "\n";
-}
-
      -
      - -

      Unfortunately, these implicit conversions come at a cost; they prevent -these iterators from conforming to standard iterator conventions, and thus -from being usable with standard algorithms and containers. For example, they -prevent the following code, where B is a BasicBlock, -from compiling:

      - -
      -
      -  llvm::SmallVector<llvm::Instruction *, 16>(B->begin(), B->end());
-
      -
      - -

      Because of this, these implicit conversions may be removed some day, -and operator* changed to return a pointer instead of a reference.

      - -
      - - -
      - Finding call sites: a slightly more complex - example -
      - -
      - -

      Say that you're writing a FunctionPass and would like to count all the -locations in the entire module (that is, across every Function) where a -certain function (i.e., some Function*) is already in scope. As you'll -learn later, you may want to use an InstVisitor to accomplish this in a -much more straight-forward manner, but this example will allow us to explore how -you'd do it if you didn't have InstVisitor around. In pseudo-code, this -is what we want to do:

      - -
      -
      -initialize callCounter to zero
-for each Function f in the Module
-  for each BasicBlock b in f
-    for each Instruction i in b
-      if (i is a CallInst and calls the given function)
-        increment callCounter
-
      -
      - -

      And the actual code is (remember, because we're writing a -FunctionPass, our FunctionPass-derived class simply has to -override the runOnFunction method):

      - -
      -
      -Function* targetFunc = ...;
-
-class OurFunctionPass : public FunctionPass {
-  public:
-    OurFunctionPass(): callCounter(0) { }
-
-    virtual runOnFunction(Function& F) {
-      for (Function::iterator b = F.begin(), be = F.end(); b != be; ++b) {
-        for (BasicBlock::iterator i = b->begin(), ie = b->end(); i != ie; ++i) {
-          if (CallInst* callInst = dyn_cast<CallInst>(&*i)) {
-            // We know we've encountered a call instruction, so we
-            // need to determine if it's a call to the
-            // function pointed to by m_func or not.
-            if (callInst->getCalledFunction() == targetFunc)
-              ++callCounter;
-          }
-        }
-      }
-    }
-
-  private:
-    unsigned callCounter;
-};
-
      -
      - -
      - - -
      - Treating calls and invokes the same way -
      - -
      - -

      You may have noticed that the previous example was a bit oversimplified in -that it did not deal with call sites generated by 'invoke' instructions. In -this, and in other situations, you may find that you want to treat -CallInsts and InvokeInsts the same way, even though their -most-specific common base class is Instruction, which includes lots of -less closely-related things. For these cases, LLVM provides a handy wrapper -class called CallSite. -It is essentially a wrapper around an Instruction pointer, with some -methods that provide functionality common to CallInsts and -InvokeInsts.

      - -

      This class has "value semantics": it should be passed by value, not by -reference and it should not be dynamically allocated or deallocated using -operator new or operator delete. It is efficiently copyable, -assignable and constructable, with costs equivalents to that of a bare pointer. -If you look at its definition, it has only a single pointer member.

      - -
      - - -
      - Iterating over def-use & use-def chains -
      - -
      - -

      Frequently, we might have an instance of the Value Class and we want to -determine which Users use the Value. The list of all -Users of a particular Value is called a def-use chain. -For example, let's say we have a Function* named F to a -particular function foo. Finding all of the instructions that -use foo is as simple as iterating over the def-use chain -of F:

      - -
      -
      -Function *F = ...;
-
-for (Value::use_iterator i = F->use_begin(), e = F->use_end(); i != e; ++i)
-  if (Instruction *Inst = dyn_cast<Instruction>(*i)) {
-    errs() << "F is used in instruction:\n";
-    errs() << *Inst << "\n";
-  }
-
      -
      - -

      Note that dereferencing a Value::use_iterator is not a very cheap -operation. Instead of performing *i above several times, consider -doing it only once in the loop body and reusing its result.

      - -

      Alternatively, it's common to have an instance of the User Class and need to know what -Values are used by it. The list of all Values used by a -User is known as a use-def chain. Instances of class -Instruction are common Users, so we might want to iterate over -all of the values that a particular instruction uses (that is, the operands of -the particular Instruction):

      - -
      -
      -Instruction *pi = ...;
-
-for (User::op_iterator i = pi->op_begin(), e = pi->op_end(); i != e; ++i) {
-  Value *v = *i;
-  // ...
-}
-
      -
      - -

      Declaring objects as const is an important tool of enforcing -mutation free algorithms (such as analyses, etc.). For this purpose above -iterators come in constant flavors as Value::const_use_iterator -and Value::const_op_iterator. They automatically arise when -calling use/op_begin() on const Value*s or -const User*s respectively. Upon dereferencing, they return -const Use*s. Otherwise the above patterns remain unchanged.

      - -
      - - -
      - Iterating over predecessors & -successors of blocks -
      - -
      - -

      Iterating over the predecessors and successors of a block is quite easy -with the routines defined in "llvm/Support/CFG.h". Just use code like -this to iterate over all predecessors of BB:

      - -
      -
      -#include "llvm/Support/CFG.h"
-BasicBlock *BB = ...;
-
-for (pred_iterator PI = pred_begin(BB), E = pred_end(BB); PI != E; ++PI) {
-  BasicBlock *Pred = *PI;
-  // ...
-}
-
      -
      - -

      Similarly, to iterate over successors use -succ_iterator/succ_begin/succ_end.

      - -
      - - - -
      - Making simple changes -
      - -
      - -

      There are some primitive transformation operations present in the LLVM -infrastructure that are worth knowing about. When performing -transformations, it's fairly common to manipulate the contents of basic -blocks. This section describes some of the common methods for doing so -and gives example code.

      - -
      - - -
      - Creating and inserting new - Instructions -
      - -
      - -

      Instantiating Instructions

      - -

      Creation of Instructions is straight-forward: simply call the -constructor for the kind of instruction to instantiate and provide the necessary -parameters. For example, an AllocaInst only requires a -(const-ptr-to) Type. Thus:

      - -
      -
      -AllocaInst* ai = new AllocaInst(Type::Int32Ty);
-
      -
      - -

      will create an AllocaInst instance that represents the allocation of -one integer in the current stack frame, at run time. Each Instruction -subclass is likely to have varying default parameters which change the semantics -of the instruction, so refer to the doxygen documentation for the subclass of -Instruction that you're interested in instantiating.

      - -

      Naming values

      - -

      It is very useful to name the values of instructions when you're able to, as -this facilitates the debugging of your transformations. If you end up looking -at generated LLVM machine code, you definitely want to have logical names -associated with the results of instructions! By supplying a value for the -Name (default) parameter of the Instruction constructor, you -associate a logical name with the result of the instruction's execution at -run time. For example, say that I'm writing a transformation that dynamically -allocates space for an integer on the stack, and that integer is going to be -used as some kind of index by some other code. To accomplish this, I place an -AllocaInst at the first point in the first BasicBlock of some -Function, and I'm intending to use it within the same -Function. I might do:

      - -
      -
      -AllocaInst* pa = new AllocaInst(Type::Int32Ty, 0, "indexLoc");
-
      -
      - -

      where indexLoc is now the logical name of the instruction's -execution value, which is a pointer to an integer on the run time stack.

      - -

      Inserting instructions

      - -

      There are essentially two ways to insert an Instruction -into an existing sequence of instructions that form a BasicBlock:

      - -
        -
      • Insertion into an explicit instruction list - -

        Given a BasicBlock* pb, an Instruction* pi within that - BasicBlock, and a newly-created instruction we wish to insert - before *pi, we do the following:

        - -
        -
        -BasicBlock *pb = ...;
-Instruction *pi = ...;
-Instruction *newInst = new Instruction(...);
-
-pb->getInstList().insert(pi, newInst); // Inserts newInst before pi in pb
-
        -
        - -

        Appending to the end of a BasicBlock is so common that - the Instruction class and Instruction-derived - classes provide constructors which take a pointer to a - BasicBlock to be appended to. For example code that - looked like:

        - -
        -
        -BasicBlock *pb = ...;
-Instruction *newInst = new Instruction(...);
-
-pb->getInstList().push_back(newInst); // Appends newInst to pb
-
        -
        - -

        becomes:

        - -
        -
        -BasicBlock *pb = ...;
-Instruction *newInst = new Instruction(..., pb);
-
        -
        - -

        which is much cleaner, especially if you are creating - long instruction streams.

        • - -
      • Insertion into an implicit instruction list - -

        Instruction instances that are already in BasicBlocks - are implicitly associated with an existing instruction list: the instruction - list of the enclosing basic block. Thus, we could have accomplished the same - thing as the above code without being given a BasicBlock by doing: -

        - -
        -
        -Instruction *pi = ...;
-Instruction *newInst = new Instruction(...);
-
-pi->getParent()->getInstList().insert(pi, newInst);
-
        -
        - -

        In fact, this sequence of steps occurs so frequently that the - Instruction class and Instruction-derived classes provide - constructors which take (as a default parameter) a pointer to an - Instruction which the newly-created Instruction should - precede. That is, Instruction constructors are capable of - inserting the newly-created instance into the BasicBlock of a - provided instruction, immediately before that instruction. Using an - Instruction constructor with a insertBefore (default) - parameter, the above code becomes:

        - -
        -
        -Instruction* pi = ...;
-Instruction* newInst = new Instruction(..., pi);
-
        -
        - -

        which is much cleaner, especially if you're creating a lot of - instructions and adding them to BasicBlocks.

        • -
      - -
      - - -
      - Deleting Instructions -
      - -
      - -

      Deleting an instruction from an existing sequence of instructions that form a -BasicBlock is very straight-forward. First, -you must have a pointer to the instruction that you wish to delete. Second, you -need to obtain the pointer to that instruction's basic block. You use the -pointer to the basic block to get its list of instructions and then use the -erase function to remove your instruction. For example:

      - -
      -
      -Instruction *I = .. ;
-I->eraseFromParent();
-
      -
      - -
      - - -
      - Replacing an Instruction with another - Value -
      - -
      - -

      Replacing individual instructions

      - -

      Including "llvm/Transforms/Utils/BasicBlockUtils.h" -permits use of two very useful replace functions: ReplaceInstWithValue -and ReplaceInstWithInst.

      - -

      Deleting Instructions

      - -
        -
      • ReplaceInstWithValue - -

        This function replaces all uses of a given instruction with a value, - and then removes the original instruction. The following example - illustrates the replacement of the result of a particular - AllocaInst that allocates memory for a single integer with a null - pointer to an integer.

        - -
        -
        -AllocaInst* instToReplace = ...;
-BasicBlock::iterator ii(instToReplace);
-
-ReplaceInstWithValue(instToReplace->getParent()->getInstList(), ii,
-                     Constant::getNullValue(PointerType::getUnqual(Type::Int32Ty)));
-
        • - -
      • ReplaceInstWithInst - -

        This function replaces a particular instruction with another - instruction, inserting the new instruction into the basic block at the - location where the old instruction was, and replacing any uses of the old - instruction with the new instruction. The following example illustrates - the replacement of one AllocaInst with another.

        - -
        -
        -AllocaInst* instToReplace = ...;
-BasicBlock::iterator ii(instToReplace);
-
-ReplaceInstWithInst(instToReplace->getParent()->getInstList(), ii,
-                    new AllocaInst(Type::Int32Ty, 0, "ptrToReplacedInt"));
-
        • -
      - -

      Replacing multiple uses of Users and Values

      - -

      You can use Value::replaceAllUsesWith and -User::replaceUsesOfWith to change more than one use at a time. See the -doxygen documentation for the Value Class -and User Class, respectively, for more -information.

      - - - -
      - - -
      - Deleting GlobalVariables -
      - -
      - -

      Deleting a global variable from a module is just as easy as deleting an -Instruction. First, you must have a pointer to the global variable that you wish - to delete. You use this pointer to erase it from its parent, the module. - For example:

      - -
      -
      -GlobalVariable *GV = .. ;
-
-GV->eraseFromParent();
-
      -
      - -
      - - -
      - How to Create Types -
      - -
      - -

      In generating IR, you may need some complex types. If you know these types -statically, you can use TypeBuilder<...>::get(), defined -in llvm/Support/TypeBuilder.h, to retrieve them. TypeBuilder -has two forms depending on whether you're building types for cross-compilation -or native library use. TypeBuilder<T, true> requires -that T be independent of the host environment, meaning that it's built -out of types from -the llvm::types -namespace and pointers, functions, arrays, etc. built of -those. TypeBuilder<T, false> additionally allows native C types -whose size may depend on the host compiler. For example,

      - -
      -
      -FunctionType *ft = TypeBuilder<types::i<8>(types::i<32>*), true>::get();
-
      -
      - -

      is easier to read and write than the equivalent

      - -
      -
      -std::vector<const Type*> params;
-params.push_back(PointerType::getUnqual(Type::Int32Ty));
-FunctionType *ft = FunctionType::get(Type::Int8Ty, params, false);
-
      -
      - -

      See the class -comment for more details.

      - -
      - - -
      - Threads and LLVM -
      - - -
      -

      -This section describes the interaction of the LLVM APIs with multithreading, -both on the part of client applications, and in the JIT, in the hosted -application. -

      - -

      -Note that LLVM's support for multithreading is still relatively young. Up -through version 2.5, the execution of threaded hosted applications was -supported, but not threaded client access to the APIs. While this use case is -now supported, clients must adhere to the guidelines specified below to -ensure proper operation in multithreaded mode. -

      - -

      -Note that, on Unix-like platforms, LLVM requires the presence of GCC's atomic -intrinsics in order to support threaded operation. If you need a -multhreading-capable LLVM on a platform without a suitably modern system -compiler, consider compiling LLVM and LLVM-GCC in single-threaded mode, and -using the resultant compiler to build a copy of LLVM with multithreading -support. -

      -
      - - -
      - Entering and Exiting Multithreaded Mode -
      - -
      - -

      -In order to properly protect its internal data structures while avoiding -excessive locking overhead in the single-threaded case, the LLVM must intialize -certain data structures necessary to provide guards around its internals. To do -so, the client program must invoke llvm_start_multithreaded() before -making any concurrent LLVM API calls. To subsequently tear down these -structures, use the llvm_stop_multithreaded() call. You can also use -the llvm_is_multithreaded() call to check the status of multithreaded -mode. -

      - -

      -Note that both of these calls must be made in isolation. That is to -say that no other LLVM API calls may be executing at any time during the -execution of llvm_start_multithreaded() or llvm_stop_multithreaded -. It's is the client's responsibility to enforce this isolation. -

      - -

      -The return value of llvm_start_multithreaded() indicates the success or -failure of the initialization. Failure typically indicates that your copy of -LLVM was built without multithreading support, typically because GCC atomic -intrinsics were not found in your system compiler. In this case, the LLVM API -will not be safe for concurrent calls. However, it will be safe for -hosting threaded applications in the JIT, though care -must be taken to ensure that side exits and the like do not accidentally -result in concurrent LLVM API calls. -

      -
      - - -
      - Ending Execution with llvm_shutdown() -
      - -
      -

      -When you are done using the LLVM APIs, you should call llvm_shutdown() -to deallocate memory used for internal structures. This will also invoke -llvm_stop_multithreaded() if LLVM is operating in multithreaded mode. -As such, llvm_shutdown() requires the same isolation guarantees as -llvm_stop_multithreaded(). -

      - -

      -Note that, if you use scope-based shutdown, you can use the -llvm_shutdown_obj class, which calls llvm_shutdown() in its -destructor. -

      - - -
      - Lazy Initialization with ManagedStatic -
      - -
      -

      -ManagedStatic is a utility class in LLVM used to implement static -initialization of static resources, such as the global type tables. Before the -invocation of llvm_shutdown(), it implements a simple lazy -initialization scheme. Once llvm_start_multithreaded() returns, -however, it uses double-checked locking to implement thread-safe lazy -initialization. -

      - -

      -Note that, because no other threads are allowed to issue LLVM API calls before -llvm_start_multithreaded() returns, it is possible to have -ManagedStatics of llvm::sys::Mutexs. -

      - -

      -The llvm_acquire_global_lock() and llvm_release_global_lock -APIs provide access to the global lock used to implement the double-checked -locking for lazy initialization. These should only be used internally to LLVM, -and only if you know what you're doing! -

      -
      - - -
      - Achieving Isolation with LLVMContext -
      - -
      -

      -LLVMContext is an opaque class in the LLVM API which clients can use -to operate multiple, isolated instances of LLVM concurrently within the same -address space. For instance, in a hypothetical compile-server, the compilation -of an individual translation unit is conceptually independent from all the -others, and it would be desirable to be able to compile incoming translation -units concurrently on independent server threads. Fortunately, -LLVMContext exists to enable just this kind of scenario! -

      - -

      -Conceptually, LLVMContext provides isolation. Every LLVM entity -(Modules, Values, Types, Constants, etc.) -in LLVM's in-memory IR belongs to an LLVMContext. Entities in -different contexts cannot interact with each other: Modules in -different contexts cannot be linked together, Functions cannot be added -to Modules in different contexts, etc. What this means is that is is -safe to compile on multiple threads simultaneously, as long as no two threads -operate on entities within the same context. -

      - -

      -In practice, very few places in the API require the explicit specification of a -LLVMContext, other than the Type creation/lookup APIs. -Because every Type carries a reference to its owning context, most -other entities can determine what context they belong to by looking at their -own Type. If you are adding new entities to LLVM IR, please try to -maintain this interface design. -

      - -

      -For clients that do not require the benefits of isolation, LLVM -provides a convenience API getGlobalContext(). This returns a global, -lazily initialized LLVMContext that may be used in situations where -isolation is not a concern. -

      -
      - - -
      - Threads and the JIT -
      - -
      -

      -LLVM's "eager" JIT compiler is safe to use in threaded programs. Multiple -threads can call ExecutionEngine::getPointerToFunction() or -ExecutionEngine::runFunction() concurrently, and multiple threads can -run code output by the JIT concurrently. The user must still ensure that only -one thread accesses IR in a given LLVMContext while another thread -might be modifying it. One way to do that is to always hold the JIT lock while -accessing IR outside the JIT (the JIT modifies the IR by adding -CallbackVHs). Another way is to only -call getPointerToFunction() from the LLVMContext's thread. -

      - -

      When the JIT is configured to compile lazily (using -ExecutionEngine::DisableLazyCompilation(false)), there is currently a -race condition in -updating call sites after a function is lazily-jitted. It's still possible to -use the lazy JIT in a threaded program if you ensure that only one thread at a -time can call any particular lazy stub and that the JIT lock guards any IR -access, but we suggest using only the eager JIT in threaded programs. -

      -
      - - -
      - Advanced Topics -
      - - -
      -

      -This section describes some of the advanced or obscure API's that most clients -do not need to be aware of. These API's tend manage the inner workings of the -LLVM system, and only need to be accessed in unusual circumstances. -

      -
      - - -
      - LLVM Type Resolution -
      - -
      - -

      -The LLVM type system has a very simple goal: allow clients to compare types for -structural equality with a simple pointer comparison (aka a shallow compare). -This goal makes clients much simpler and faster, and is used throughout the LLVM -system. -

      - -

      -Unfortunately achieving this goal is not a simple matter. In particular, -recursive types and late resolution of opaque types makes the situation very -difficult to handle. Fortunately, for the most part, our implementation makes -most clients able to be completely unaware of the nasty internal details. The -primary case where clients are exposed to the inner workings of it are when -building a recursive type. In addition to this case, the LLVM bitcode reader, -assembly parser, and linker also have to be aware of the inner workings of this -system. -

      - -

      -For our purposes below, we need three concepts. First, an "Opaque Type" is -exactly as defined in the language -reference. Second an "Abstract Type" is any type which includes an -opaque type as part of its type graph (for example "{ opaque, i32 }"). -Third, a concrete type is a type that is not an abstract type (e.g. "{ i32, -float }"). -

      - -
      - - -
      - Basic Recursive Type Construction -
      - -
      - -

      -Because the most common question is "how do I build a recursive type with LLVM", -we answer it now and explain it as we go. Here we include enough to cause this -to be emitted to an output .ll file: -

      - -
      -
      -%mylist = type { %mylist*, i32 }
-
      -
      - -

      -To build this, use the following LLVM APIs: -

      - -
      -
      -// Create the initial outer struct
-PATypeHolder StructTy = OpaqueType::get();
-std::vector<const Type*> Elts;
-Elts.push_back(PointerType::getUnqual(StructTy));
-Elts.push_back(Type::Int32Ty);
-StructType *NewSTy = StructType::get(Elts);
-
-// At this point, NewSTy = "{ opaque*, i32 }". Tell VMCore that
-// the struct and the opaque type are actually the same.
-cast<OpaqueType>(StructTy.get())->refineAbstractTypeTo(NewSTy);
-
-// NewSTy is potentially invalidated, but StructTy (a PATypeHolder) is
-// kept up-to-date
-NewSTy = cast<StructType>(StructTy.get());
-
-// Add a name for the type to the module symbol table (optional)
-MyModule->addTypeName("mylist", NewSTy);
-
      -
      - -

      -This code shows the basic approach used to build recursive types: build a -non-recursive type using 'opaque', then use type unification to close the cycle. -The type unification step is performed by the refineAbstractTypeTo method, which is -described next. After that, we describe the PATypeHolder class. -

      - -
      - - -
      - The refineAbstractTypeTo method -
      - -
      -

      -The refineAbstractTypeTo method starts the type unification process. -While this method is actually a member of the DerivedType class, it is most -often used on OpaqueType instances. Type unification is actually a recursive -process. After unification, types can become structurally isomorphic to -existing types, and all duplicates are deleted (to preserve pointer equality). -

      - -

      -In the example above, the OpaqueType object is definitely deleted. -Additionally, if there is an "{ \2*, i32}" type already created in the system, -the pointer and struct type created are also deleted. Obviously whenever -a type is deleted, any "Type*" pointers in the program are invalidated. As -such, it is safest to avoid having any "Type*" pointers to abstract types -live across a call to refineAbstractTypeTo (note that non-abstract -types can never move or be deleted). To deal with this, the PATypeHolder class is used to maintain a stable -reference to a possibly refined type, and the AbstractTypeUser class is used to update more -complex datastructures. -

      - -
      - - -
      - The PATypeHolder Class -
      - -
      -

      -PATypeHolder is a form of a "smart pointer" for Type objects. When VMCore -happily goes about nuking types that become isomorphic to existing types, it -automatically updates all PATypeHolder objects to point to the new type. In the -example above, this allows the code to maintain a pointer to the resultant -resolved recursive type, even though the Type*'s are potentially invalidated. -

      - -

      -PATypeHolder is an extremely light-weight object that uses a lazy union-find -implementation to update pointers. For example the pointer from a Value to its -Type is maintained by PATypeHolder objects. -

      - -
      - - -
      - The AbstractTypeUser Class -
      - -
      - -

      -Some data structures need more to perform more complex updates when types get -resolved. To support this, a class can derive from the AbstractTypeUser class. -This class -allows it to get callbacks when certain types are resolved. To register to get -callbacks for a particular type, the DerivedType::{add/remove}AbstractTypeUser -methods can be called on a type. Note that these methods only work for - abstract types. Concrete types (those that do not include any opaque -objects) can never be refined. -

      -
      - - - -
      - The ValueSymbolTable and - TypeSymbolTable classes -
      - -
      -

      The -ValueSymbolTable class provides a symbol table that the Function and -Module classes use for naming value definitions. The symbol table -can provide a name for any Value. -The -TypeSymbolTable class is used by the Module class to store -names for types.

      - -

      Note that the SymbolTable class should not be directly accessed -by most clients. It should only be used when iteration over the symbol table -names themselves are required, which is very special purpose. Note that not -all LLVM -Values have names, and those without names (i.e. they have -an empty name) do not exist in the symbol table. -

      - -

      These symbol tables support iteration over the values/types in the symbol -table with begin/end/iterator and supports querying to see if a -specific name is in the symbol table (with lookup). The -ValueSymbolTable class exposes no public mutator methods, instead, -simply call setName on a value, which will autoinsert it into the -appropriate symbol table. For types, use the Module::addTypeName method to -insert entries into the symbol table.

      - -
      - - - - -
      - The User and owned Use classes' memory layout -
      - -
      -

      The -User class provides a basis for expressing the ownership of User -towards other -Values. The -Use helper class is employed to do the bookkeeping and to facilitate O(1) -addition and removal.

      - - -
      - Interaction and relationship between User and Use objects -
      - -
      -

      -A subclass of User can choose between incorporating its Use objects -or refer to them out-of-line by means of a pointer. A mixed variant -(some Uses inline others hung off) is impractical and breaks the invariant -that the Use objects belonging to the same User form a contiguous array. -

      -
      - -

      -We have 2 different layouts in the User (sub)classes: -

        -

      • Layout a) -The Use object(s) are inside (resp. at fixed offset) of the User -object and there are a fixed number of them.

        - -

      • Layout b) -The Use object(s) are referenced by a pointer to an -array from the User object and there may be a variable -number of them.

        -
      -

      -As of v2.4 each layout still possesses a direct pointer to the -start of the array of Uses. Though not mandatory for layout a), -we stick to this redundancy for the sake of simplicity. -The User object also stores the number of Use objects it -has. (Theoretically this information can also be calculated -given the scheme presented below.)

      -

      -Special forms of allocation operators (operator new) -enforce the following memory layouts:

      - -
        -

      • Layout a) is modelled by prepending the User object by the Use[] array.

        - -
        -...---.---.---.---.-------...
-  | P | P | P | P | User
-'''---'---'---'---'-------'''
-
        - -

      • Layout b) is modelled by pointing at the Use[] array.

        -
        -.-------...
-| User
-'-------'''
-    |
-    v
-    .---.---.---.---...
-    | P | P | P | P |
-    '---'---'---'---'''
-
        -
      -(In the above figures 'P' stands for the Use** that - is stored in each Use object in the member Use::Prev) - - -
      - The waymarking algorithm -
      - -
      -

      -Since the Use objects are deprived of the direct (back)pointer to -their User objects, there must be a fast and exact method to -recover it. This is accomplished by the following scheme:

      -
      - -A bit-encoding in the 2 LSBits (least significant bits) of the Use::Prev allows to find the -start of the User object: -
        -
      • 00 —> binary digit 0
        • -
      • 01 —> binary digit 1
        • -
      • 10 —> stop and calculate (s)
        • -
      • 11 —> full stop (S)
        • -
      -

      -Given a Use*, all we have to do is to walk till we get -a stop and we either have a User immediately behind or -we have to walk to the next stop picking up digits -and calculating the offset:

      -
      -.---.---.---.---.---.---.---.---.---.---.---.---.---.---.---.---.----------------
-| 1 | s | 1 | 0 | 1 | 0 | s | 1 | 1 | 0 | s | 1 | 1 | s | 1 | S | User (or User*)
-'---'---'---'---'---'---'---'---'---'---'---'---'---'---'---'---'----------------
-    |+15                |+10            |+6         |+3     |+1
-    |                   |               |           |       |__>
-    |                   |               |           |__________>
-    |                   |               |______________________>
-    |                   |______________________________________>
-    |__________________________________________________________>
-
      -

      -Only the significant number of bits need to be stored between the -stops, so that the worst case is 20 memory accesses when there are -1000 Use objects associated with a User.

      - - -
      - Reference implementation -
      - -
      -

      -The following literate Haskell fragment demonstrates the concept:

      -
      - -
      -
      -> import Test.QuickCheck
-> 
-> digits :: Int -> [Char] -> [Char]
-> digits 0 acc = '0' : acc
-> digits 1 acc = '1' : acc
-> digits n acc = digits (n `div` 2) $ digits (n `mod` 2) acc
-> 
-> dist :: Int -> [Char] -> [Char]
-> dist 0 [] = ['S']
-> dist 0 acc = acc
-> dist 1 acc = let r = dist 0 acc in 's' : digits (length r) r
-> dist n acc = dist (n - 1) $ dist 1 acc
-> 
-> takeLast n ss = reverse $ take n $ reverse ss
-> 
-> test = takeLast 40 $ dist 20 []
-> 
-
      -
      -

      -Printing <test> gives: "1s100000s11010s10100s1111s1010s110s11s1S"

      -

      -The reverse algorithm computes the length of the string just by examining -a certain prefix:

      - -
      -
      -> pref :: [Char] -> Int
-> pref "S" = 1
-> pref ('s':'1':rest) = decode 2 1 rest
-> pref (_:rest) = 1 + pref rest
-> 
-> decode walk acc ('0':rest) = decode (walk + 1) (acc * 2) rest
-> decode walk acc ('1':rest) = decode (walk + 1) (acc * 2 + 1) rest
-> decode walk acc _ = walk + acc
-> 
-
      -
      -

      -Now, as expected, printing <pref test> gives 40.

      -

      -We can quickCheck this with following property:

      - -
      -
      -> testcase = dist 2000 []
-> testcaseLength = length testcase
-> 
-> identityProp n = n > 0 && n <= testcaseLength ==> length arr == pref arr
->     where arr = takeLast n testcase
-> 
-
      -
      -

      -As expected <quickCheck identityProp> gives:

      - -
      -*Main> quickCheck identityProp
-OK, passed 100 tests.
-
      -

      -Let's be a bit more exhaustive:

      - -
      -
      -> 
-> deepCheck p = check (defaultConfig { configMaxTest = 500 }) p
-> 
-
      -
      -

      -And here is the result of <deepCheck identityProp>:

      - -
      -*Main> deepCheck identityProp
-OK, passed 500 tests.
-
      - - -
      - Tagging considerations -
      - -

      -To maintain the invariant that the 2 LSBits of each Use** in Use -never change after being set up, setters of Use::Prev must re-tag the -new Use** on every modification. Accordingly getters must strip the -tag bits.

      -

      -For layout b) instead of the User we find a pointer (User* with LSBit set). -Following this pointer brings us to the User. A portable trick ensures -that the first bytes of User (if interpreted as a pointer) never has -the LSBit set. (Portability is relying on the fact that all known compilers place the -vptr in the first word of the instances.)

      - -
      - - -
      - The Core LLVM Class Hierarchy Reference -
      - - -
      -

      #include "llvm/Type.h" -
      doxygen info: Type Class

      - -

      The Core LLVM classes are the primary means of representing the program -being inspected or transformed. The core LLVM classes are defined in -header files in the include/llvm/ directory, and implemented in -the lib/VMCore directory.

      - -
      - - -
      - The Type class and Derived Types -
      - -
      - -

      Type is a superclass of all type classes. Every Value has - a Type. Type cannot be instantiated directly but only - through its subclasses. Certain primitive types (VoidType, - LabelType, FloatType and DoubleType) have hidden - subclasses. They are hidden because they offer no useful functionality beyond - what the Type class offers except to distinguish themselves from - other subclasses of Type.

      -

      All other types are subclasses of DerivedType. Types can be - named, but this is not a requirement. There exists exactly - one instance of a given shape at any one time. This allows type equality to - be performed with address equality of the Type Instance. That is, given two - Type* values, the types are identical if the pointers are identical. -

      -
      - - -
      - Important Public Methods -
      - -
      - -
        -
      • bool isIntegerTy() const: Returns true for any integer type.
        • - -
      • bool isFloatingPointTy(): Return true if this is one of the five - floating point types.
        • - -
      • bool isAbstract(): Return true if the type is abstract (contains - an OpaqueType anywhere in its definition).
        • - -
      • bool isSized(): Return true if the type has known size. Things - that don't have a size are abstract types, labels and void.
        • - -
      -
      - - -
      - Important Derived Types -
      -
      -
      -
      IntegerType
      -
      Subclass of DerivedType that represents integer types of any bit width. - Any bit width between IntegerType::MIN_INT_BITS (1) and - IntegerType::MAX_INT_BITS (~8 million) can be represented. -
        -
      • static const IntegerType* get(unsigned NumBits): get an integer - type of a specific bit width.
        • -
      • unsigned getBitWidth() const: Get the bit width of an integer - type.
        • -
      -
      -
      SequentialType
      -
      This is subclassed by ArrayType and PointerType -
        -
      • const Type * getElementType() const: Returns the type of each - of the elements in the sequential type.
        • -
      -
      -
      ArrayType
      -
      This is a subclass of SequentialType and defines the interface for array - types. -
        -
      • unsigned getNumElements() const: Returns the number of - elements in the array.
        • -
      -
      -
      PointerType
      -
      Subclass of SequentialType for pointer types.
      -
      VectorType
      -
      Subclass of SequentialType for vector types. A - vector type is similar to an ArrayType but is distinguished because it is - a first class type whereas ArrayType is not. Vector types are used for - vector operations and are usually small vectors of of an integer or floating - point type.
      -
      StructType
      -
      Subclass of DerivedTypes for struct types.
      -
      FunctionType
      -
      Subclass of DerivedTypes for function types. -
        -
      • bool isVarArg() const: Returns true if it's a vararg - function
        • -
      • const Type * getReturnType() const: Returns the - return type of the function.
        • -
      • const Type * getParamType (unsigned i): Returns - the type of the ith parameter.
        • -
      • const unsigned getNumParams() const: Returns the - number of formal parameters.
        • -
      -
      -
      OpaqueType
      -
      Sublcass of DerivedType for abstract types. This class - defines no content and is used as a placeholder for some other type. Note - that OpaqueType is used (temporarily) during type resolution for forward - references of types. Once the referenced type is resolved, the OpaqueType - is replaced with the actual type. OpaqueType can also be used for data - abstraction. At link time opaque types can be resolved to actual types - of the same name.
      -
      -
      - - - - -
      - The Module class -
      - -
      - -

      #include "llvm/Module.h"
      doxygen info: -Module Class

      - -

      The Module class represents the top level structure present in LLVM -programs. An LLVM module is effectively either a translation unit of the -original program or a combination of several translation units merged by the -linker. The Module class keeps track of a list of Functions, a list of GlobalVariables, and a SymbolTable. Additionally, it contains a few -helpful member functions that try to make common operations easy.

      - -
      - - -
      - Important Public Members of the Module class -
      - -
      - -
        -
      • Module::Module(std::string name = "")
        • -
      - -

      Constructing a Module is easy. You can optionally -provide a name for it (probably based on the name of the translation unit).

      - -
        -
      • Module::iterator - Typedef for function list iterator
        - Module::const_iterator - Typedef for const_iterator.
        - - begin(), end() - size(), empty() - -

        These are forwarding methods that make it easy to access the contents of - a Module object's Function - list.

        • - -
      • Module::FunctionListType &getFunctionList() - -

        Returns the list of Functions. This is - necessary to use when you need to update the list or perform a complex - action that doesn't have a forwarding method.

        - -

        • -
      - -
      - -
        -
      • Module::global_iterator - Typedef for global variable list iterator
        - - Module::const_global_iterator - Typedef for const_iterator.
        - - global_begin(), global_end() - global_size(), global_empty() - -

        These are forwarding methods that make it easy to access the contents of - a Module object's GlobalVariable list.

        • - -
      • Module::GlobalListType &getGlobalList() - -

        Returns the list of GlobalVariables. This is necessary to - use when you need to update the list or perform a complex action that - doesn't have a forwarding method.

        - -

        • -
      - -
      - - - -
      - -
        -
      • Function *getFunction(const std::string - &Name, const FunctionType *Ty) - -

        Look up the specified function in the Module SymbolTable. If it does not exist, return - null.

        • - -
      • Function *getOrInsertFunction(const - std::string &Name, const FunctionType *T) - -

        Look up the specified function in the Module SymbolTable. If it does not exist, add an - external declaration for the function and return it.

        • - -
      • std::string getTypeName(const Type *Ty) - -

        If there is at least one entry in the SymbolTable for the specified Type, return it. Otherwise return the empty - string.

        • - -
      • bool addTypeName(const std::string &Name, const Type *Ty) - -

        Insert an entry in the SymbolTable - mapping Name to Ty. If there is already an entry for this - name, true is returned and the SymbolTable is not modified.

        • -
      - -
      - - - -
      - The Value class -
      - -
      - -

      #include "llvm/Value.h" -
      -doxygen info: Value Class

      - -

      The Value class is the most important class in the LLVM Source -base. It represents a typed value that may be used (among other things) as an -operand to an instruction. There are many different types of Values, -such as Constants,Arguments. Even Instructions and Functions are Values.

      - -

      A particular Value may be used many times in the LLVM representation -for a program. For example, an incoming argument to a function (represented -with an instance of the Argument class) is "used" by -every instruction in the function that references the argument. To keep track -of this relationship, the Value class keeps a list of all of the Users that is using it (the User class is a base class for all nodes in the LLVM -graph that can refer to Values). This use list is how LLVM represents -def-use information in the program, and is accessible through the use_* -methods, shown below.

      - -

      Because LLVM is a typed representation, every LLVM Value is typed, -and this Type is available through the getType() -method. In addition, all LLVM values can be named. The "name" of the -Value is a symbolic string printed in the LLVM code:

      - -
      -
      -%foo = add i32 1, 2
-
      -
      - -

      The name of this instruction is "foo". NOTE -that the name of any value may be missing (an empty string), so names should -ONLY be used for debugging (making the source code easier to read, -debugging printouts), they should not be used to keep track of values or map -between them. For this purpose, use a std::map of pointers to the -Value itself instead.

      - -

      One important aspect of LLVM is that there is no distinction between an SSA -variable and the operation that produces it. Because of this, any reference to -the value produced by an instruction (or the value available as an incoming -argument, for example) is represented as a direct pointer to the instance of -the class that -represents this value. Although this may take some getting used to, it -simplifies the representation and makes it easier to manipulate.

      - -
      - - -
      - Important Public Members of the Value class -
      - -
      - -
        -
      • Value::use_iterator - Typedef for iterator over the -use-list
        - Value::const_use_iterator - Typedef for const_iterator over -the use-list
        - unsigned use_size() - Returns the number of users of the -value.
        - bool use_empty() - Returns true if there are no users.
        - use_iterator use_begin() - Get an iterator to the start of -the use-list.
        - use_iterator use_end() - Get an iterator to the end of the -use-list.
        - User *use_back() - Returns the last -element in the list. -

        These methods are the interface to access the def-use -information in LLVM. As with all other iterators in LLVM, the naming -conventions follow the conventions defined by the STL.

        -
        • -
      • Type *getType() const -

        This method returns the Type of the Value.

        -
        • -
      • bool hasName() const
        - std::string getName() const
        - void setName(const std::string &Name) -

        This family of methods is used to access and assign a name to a Value, -be aware of the precaution above.

        -
        • -
      • void replaceAllUsesWith(Value *V) - -

        This method traverses the use list of a Value changing all Users of the current value to refer to - "V" instead. For example, if you detect that an instruction always - produces a constant value (for example through constant folding), you can - replace all uses of the instruction with the constant like this:

        - -
        -
        -Inst->replaceAllUsesWith(ConstVal);
-
        -
        - -
      - -
      - - -
      - The User class -
      - -
      - -

      -#include "llvm/User.h"
      -doxygen info: User Class
      -Superclass: Value

      - -

      The User class is the common base class of all LLVM nodes that may -refer to Values. It exposes a list of "Operands" -that are all of the Values that the User is -referring to. The User class itself is a subclass of -Value.

      - -

      The operands of a User point directly to the LLVM Value that it refers to. Because LLVM uses Static -Single Assignment (SSA) form, there can only be one definition referred to, -allowing this direct connection. This connection provides the use-def -information in LLVM.

      - -
      - - -
      - Important Public Members of the User class -
      - -
      - -

      The User class exposes the operand list in two ways: through -an index access interface and through an iterator based interface.

      - -
        -
      • Value *getOperand(unsigned i)
        - unsigned getNumOperands() -

        These two methods expose the operands of the User in a -convenient form for direct access.

        • - -
      • User::op_iterator - Typedef for iterator over the operand -list
        - op_iterator op_begin() - Get an iterator to the start of -the operand list.
        - op_iterator op_end() - Get an iterator to the end of the -operand list. -

        Together, these methods make up the iterator based interface to -the operands of a User.

        • -
      - -
      - - -
      - The Instruction class -
      - -
      - -

      #include "llvm/Instruction.h"
      -doxygen info: Instruction Class
      -Superclasses: User, Value

      - -

      The Instruction class is the common base class for all LLVM -instructions. It provides only a few methods, but is a very commonly used -class. The primary data tracked by the Instruction class itself is the -opcode (instruction type) and the parent BasicBlock the Instruction is embedded -into. To represent a specific type of instruction, one of many subclasses of -Instruction are used.

      - -

      Because the Instruction class subclasses the User class, its operands can be accessed in the same -way as for other Users (with the -getOperand()/getNumOperands() and -op_begin()/op_end() methods).

      An important file for -the Instruction class is the llvm/Instruction.def file. This -file contains some meta-data about the various different types of instructions -in LLVM. It describes the enum values that are used as opcodes (for example -Instruction::Add and Instruction::ICmp), as well as the -concrete sub-classes of Instruction that implement the instruction (for -example BinaryOperator and CmpInst). Unfortunately, the use of macros in -this file confuses doxygen, so these enum values don't show up correctly in the -doxygen output.

      - -
      - - -
      - Important Subclasses of the Instruction - class -
      -
      -
        -
      • BinaryOperator -

        This subclasses represents all two operand instructions whose operands - must be the same type, except for the comparison instructions.

        • -
      • CastInst -

        This subclass is the parent of the 12 casting instructions. It provides - common operations on cast instructions.

        -
      • CmpInst -

        This subclass respresents the two comparison instructions, - ICmpInst (integer opreands), and - FCmpInst (floating point operands).

        -
      • TerminatorInst -

        This subclass is the parent of all terminator instructions (those which - can terminate a block).

        -
      -
      - - -
      - Important Public Members of the Instruction - class -
      - -
      - -
        -
      • BasicBlock *getParent() -

        Returns the BasicBlock that -this Instruction is embedded into.

        • -
      • bool mayWriteToMemory() -

        Returns true if the instruction writes to memory, i.e. it is a - call,free,invoke, or store.

        • -
      • unsigned getOpcode() -

        Returns the opcode for the Instruction.

        • -
      • Instruction *clone() const -

        Returns another instance of the specified instruction, identical -in all ways to the original except that the instruction has no parent -(ie it's not embedded into a BasicBlock), -and it has no name

        • -
      - -
      - - -
      - The Constant class and subclasses -
      - -
      - -

      Constant represents a base class for different types of constants. It -is subclassed by ConstantInt, ConstantArray, etc. for representing -the various types of Constants. GlobalValue is also -a subclass, which represents the address of a global variable or function. -

      - -
      - - -
      Important Subclasses of Constant
      -
      -
        -
      • ConstantInt : This subclass of Constant represents an integer constant of - any width. -
          -
        • const APInt& getValue() const: Returns the underlying - value of this constant, an APInt value.
          • -
        • int64_t getSExtValue() const: Converts the underlying APInt - value to an int64_t via sign extension. If the value (not the bit width) - of the APInt is too large to fit in an int64_t, an assertion will result. - For this reason, use of this method is discouraged.
          • -
        • uint64_t getZExtValue() const: Converts the underlying APInt - value to a uint64_t via zero extension. IF the value (not the bit width) - of the APInt is too large to fit in a uint64_t, an assertion will result. - For this reason, use of this method is discouraged.
          • -
        • static ConstantInt* get(const APInt& Val): Returns the - ConstantInt object that represents the value provided by Val. - The type is implied as the IntegerType that corresponds to the bit width - of Val.
          • -
        • static ConstantInt* get(const Type *Ty, uint64_t Val): - Returns the ConstantInt object that represents the value provided by - Val for integer type Ty.
          • -
        -
        • -
      • ConstantFP : This class represents a floating point constant. -
          -
        • double getValue() const: Returns the underlying value of - this constant.
          • -
        -
        • -
      • ConstantArray : This represents a constant array. -
          -
        • const std::vector<Use> &getValues() const: Returns - a vector of component constants that makeup this array.
          • -
        -
        • -
      • ConstantStruct : This represents a constant struct. -
          -
        • const std::vector<Use> &getValues() const: Returns - a vector of component constants that makeup this array.
          • -
        -
        • -
      • GlobalValue : This represents either a global variable or a function. In - either case, the value is a constant fixed address (after linking). -
        • -
      -
      - - - -
      - The GlobalValue class -
      - -
      - -

      #include "llvm/GlobalValue.h"
      -doxygen info: GlobalValue -Class
      -Superclasses: Constant, -User, Value

      - -

      Global values (GlobalVariables or Functions) are the only LLVM values that are -visible in the bodies of all Functions. -Because they are visible at global scope, they are also subject to linking with -other globals defined in different translation units. To control the linking -process, GlobalValues know their linkage rules. Specifically, -GlobalValues know whether they have internal or external linkage, as -defined by the LinkageTypes enumeration.

      - -

      If a GlobalValue has internal linkage (equivalent to being -static in C), it is not visible to code outside the current translation -unit, and does not participate in linking. If it has external linkage, it is -visible to external code, and does participate in linking. In addition to -linkage information, GlobalValues keep track of which Module they are currently part of.

      - -

      Because GlobalValues are memory objects, they are always referred to -by their address. As such, the Type of a -global is always a pointer to its contents. It is important to remember this -when using the GetElementPtrInst instruction because this pointer must -be dereferenced first. For example, if you have a GlobalVariable (a -subclass of GlobalValue) that is an array of 24 ints, type [24 x -i32], then the GlobalVariable is a pointer to that array. Although -the address of the first element of this array and the value of the -GlobalVariable are the same, they have different types. The -GlobalVariable's type is [24 x i32]. The first element's type -is i32. Because of this, accessing a global value requires you to -dereference the pointer with GetElementPtrInst first, then its elements -can be accessed. This is explained in the LLVM -Language Reference Manual.

      - -
      - - -
      - Important Public Members of the GlobalValue - class -
      - -
      - -
        -
      • bool hasInternalLinkage() const
        - bool hasExternalLinkage() const
        - void setInternalLinkage(bool HasInternalLinkage) -

        These methods manipulate the linkage characteristics of the GlobalValue.

        -

        -
        • -
      • Module *getParent() -

        This returns the Module that the -GlobalValue is currently embedded into.

        • -
      - -
      - - -
      - The Function class -
      - -
      - -

      #include "llvm/Function.h"
      doxygen -info: Function Class
      -Superclasses: GlobalValue, -Constant, -User, -Value

      - -

      The Function class represents a single procedure in LLVM. It is -actually one of the more complex classes in the LLVM hierarchy because it must -keep track of a large amount of data. The Function class keeps track -of a list of BasicBlocks, a list of formal -Arguments, and a -SymbolTable.

      - -

      The list of BasicBlocks is the most -commonly used part of Function objects. The list imposes an implicit -ordering of the blocks in the function, which indicate how the code will be -laid out by the backend. Additionally, the first BasicBlock is the implicit entry node for the -Function. It is not legal in LLVM to explicitly branch to this initial -block. There are no implicit exit nodes, and in fact there may be multiple exit -nodes from a single Function. If the BasicBlock list is empty, this indicates that -the Function is actually a function declaration: the actual body of the -function hasn't been linked in yet.

      - -

      In addition to a list of BasicBlocks, the -Function class also keeps track of the list of formal Arguments that the function receives. This -container manages the lifetime of the Argument -nodes, just like the BasicBlock list does for -the BasicBlocks.

      - -

      The SymbolTable is a very rarely used -LLVM feature that is only used when you have to look up a value by name. Aside -from that, the SymbolTable is used -internally to make sure that there are not conflicts between the names of Instructions, BasicBlocks, or Arguments in the function body.

      - -

      Note that Function is a GlobalValue -and therefore also a Constant. The value of the function -is its address (after linking) which is guaranteed to be constant.

      -
      - - -
      - Important Public Members of the Function - class -
      - -
      - -
        -
      • Function(const FunctionType - *Ty, LinkageTypes Linkage, const std::string &N = "", Module* Parent = 0) - -

        Constructor used when you need to create new Functions to add - the the program. The constructor must specify the type of the function to - create and what type of linkage the function should have. The FunctionType argument - specifies the formal arguments and return value for the function. The same - FunctionType value can be used to - create multiple functions. The Parent argument specifies the Module - in which the function is defined. If this argument is provided, the function - will automatically be inserted into that module's list of - functions.

        • - -
      • bool isDeclaration() - -

        Return whether or not the Function has a body defined. If the - function is "external", it does not have a body, and thus must be resolved - by linking with a function defined in a different translation unit.

        • - -
      • Function::iterator - Typedef for basic block list iterator
        - Function::const_iterator - Typedef for const_iterator.
        - - begin(), end() - size(), empty() - -

        These are forwarding methods that make it easy to access the contents of - a Function object's BasicBlock - list.

        • - -
      • Function::BasicBlockListType &getBasicBlockList() - -

        Returns the list of BasicBlocks. This - is necessary to use when you need to update the list or perform a complex - action that doesn't have a forwarding method.

        • - -
      • Function::arg_iterator - Typedef for the argument list -iterator
        - Function::const_arg_iterator - Typedef for const_iterator.
        - - arg_begin(), arg_end() - arg_size(), arg_empty() - -

        These are forwarding methods that make it easy to access the contents of - a Function object's Argument - list.

        • - -
      • Function::ArgumentListType &getArgumentList() - -

        Returns the list of Arguments. This is - necessary to use when you need to update the list or perform a complex - action that doesn't have a forwarding method.

        • - -
      • BasicBlock &getEntryBlock() - -

        Returns the entry BasicBlock for the - function. Because the entry block for the function is always the first - block, this returns the first block of the Function.

        • - -
      • Type *getReturnType()
        - FunctionType *getFunctionType() - -

        This traverses the Type of the - Function and returns the return type of the function, or the FunctionType of the actual - function.

        • - -
      • SymbolTable *getSymbolTable() - -

        Return a pointer to the SymbolTable - for this Function.

        • -
      - -
      - - -
      - The GlobalVariable class -
      - -
      - -

      #include "llvm/GlobalVariable.h" -
      -doxygen info: GlobalVariable - Class
      -Superclasses: GlobalValue, -Constant, -User, -Value

      - -

      Global variables are represented with the (surprise surprise) -GlobalVariable class. Like functions, GlobalVariables are also -subclasses of GlobalValue, and as such are -always referenced by their address (global values must live in memory, so their -"name" refers to their constant address). See -GlobalValue for more on this. Global -variables may have an initial value (which must be a -Constant), and if they have an initializer, -they may be marked as "constant" themselves (indicating that their contents -never change at runtime).

      -
      - - -
      - Important Public Members of the - GlobalVariable class -
      - -
      - -
        -
      • GlobalVariable(const Type *Ty, bool - isConstant, LinkageTypes& Linkage, Constant - *Initializer = 0, const std::string &Name = "", Module* Parent = 0) - -

        Create a new global variable of the specified type. If - isConstant is true then the global variable will be marked as - unchanging for the program. The Linkage parameter specifies the type of - linkage (internal, external, weak, linkonce, appending) for the variable. - If the linkage is InternalLinkage, WeakAnyLinkage, WeakODRLinkage, - LinkOnceAnyLinkage or LinkOnceODRLinkage,  then the resultant - global variable will have internal linkage. AppendingLinkage concatenates - together all instances (in different translation units) of the variable - into a single variable but is only applicable to arrays.  See - the LLVM Language Reference for - further details on linkage types. Optionally an initializer, a name, and the - module to put the variable into may be specified for the global variable as - well.

        • - -
      • bool isConstant() const - -

        Returns true if this is a global variable that is known not to - be modified at runtime.

        • - -
      • bool hasInitializer() - -

        Returns true if this GlobalVariable has an intializer.

        • - -
      • Constant *getInitializer() - -

        Returns the initial value for a GlobalVariable. It is not legal - to call this method if there is no initializer.

        • -
      - -
      - - - -
      - The BasicBlock class -
      - -
      - -

      #include "llvm/BasicBlock.h"
      -doxygen info: BasicBlock -Class
      -Superclass: Value

      - -

      This class represents a single entry multiple exit section of the code, -commonly known as a basic block by the compiler community. The -BasicBlock class maintains a list of Instructions, which form the body of the block. -Matching the language definition, the last element of this list of instructions -is always a terminator instruction (a subclass of the TerminatorInst class).

      - -

      In addition to tracking the list of instructions that make up the block, the -BasicBlock class also keeps track of the Function that it is embedded into.

      - -

      Note that BasicBlocks themselves are Values, because they are referenced by instructions -like branches and can go in the switch tables. BasicBlocks have type -label.

      - -
      - - -
      - Important Public Members of the BasicBlock - class -
      - -
      -
        - -
      • BasicBlock(const std::string &Name = "", Function *Parent = 0) - -

        The BasicBlock constructor is used to create new basic blocks for -insertion into a function. The constructor optionally takes a name for the new -block, and a Function to insert it into. If -the Parent parameter is specified, the new BasicBlock is -automatically inserted at the end of the specified Function, if not specified, the BasicBlock must be -manually inserted into the Function.

        • - -
      • BasicBlock::iterator - Typedef for instruction list iterator
        -BasicBlock::const_iterator - Typedef for const_iterator.
        -begin(), end(), front(), back(), -size(), empty() -STL-style functions for accessing the instruction list. - -

        These methods and typedefs are forwarding functions that have the same -semantics as the standard library methods of the same names. These methods -expose the underlying instruction list of a basic block in a way that is easy to -manipulate. To get the full complement of container operations (including -operations to update the list), you must use the getInstList() -method.

        • - -
      • BasicBlock::InstListType &getInstList() - -

        This method is used to get access to the underlying container that actually -holds the Instructions. This method must be used when there isn't a forwarding -function in the BasicBlock class for the operation that you would like -to perform. Because there are no forwarding functions for "updating" -operations, you need to use this if you want to update the contents of a -BasicBlock.

        • - -
      • Function *getParent() - -

        Returns a pointer to Function the block is -embedded into, or a null pointer if it is homeless.

        • - -
      • TerminatorInst *getTerminator() - -

        Returns a pointer to the terminator instruction that appears at the end of -the BasicBlock. If there is no terminator instruction, or if the last -instruction in the block is not a terminator, then a null pointer is -returned.

        • - -
      - -
      - - - -
      - The Argument class -
      - -
      - -

      This subclass of Value defines the interface for incoming formal -arguments to a function. A Function maintains a list of its formal -arguments. An argument has a pointer to the parent Function.

      - -
      - - -
      -
      - Valid CSS - Valid HTML 4.01 Strict - - Dinakar Dhurjati and - Chris Lattner
      - The LLVM Compiler Infrastructure
      - Last modified: $Date$ -
      - - - Removed: llvm/trunk/docs/Projects.html URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/Projects.html?rev=103212&view=auto ============================================================================== --- llvm/trunk/docs/Projects.html (original) +++ llvm/trunk/docs/Projects.html (removed) @@ -1,460 +0,0 @@ - - - - Creating an LLVM Project - - - - -
      Creating an LLVM Project
      - -
        -
      1. Overview
        2. -
      2. Create a project from the Sample Project
        3. -
      3. Source tree layout
        4. -
      4. Writing LLVM-style Makefiles -
          -
        1. Required Variables
          2. -
        2. Variables for Building Subdirectories
          3. -
        3. Variables for Building Libraries
          4. -
        4. Variables for Building Programs
          5. -
        5. Miscellaneous Variables
          6. -
        5. -
      5. Placement of object code
        6. -
      6. Further help
        7. -
      - -
      -

      Written by John Criswell

      -
      - - -
      Overview
      - - -
      - -

      The LLVM build system is designed to facilitate the building of third party -projects that use LLVM header files, libraries, and tools. In order to use -these facilities, a Makefile from a project must do the following things:

      - -
        -
      1. Set make variables. There are several variables that a Makefile - needs to set to use the LLVM build system: -
          -
        • PROJECT_NAME - The name by which your project is known.
          • -
        • LLVM_SRC_ROOT - The root of the LLVM source tree.
          • -
        • LLVM_OBJ_ROOT - The root of the LLVM object tree.
          • -
        • PROJ_SRC_ROOT - The root of the project's source tree.
          • -
        • PROJ_OBJ_ROOT - The root of the project's object tree.
          • -
        • PROJ_INSTALL_ROOT - The root installation directory.
          • -
        • LEVEL - The relative path from the current directory to the - project's root ($PROJ_OBJ_ROOT).
          • -
        2. -
      2. Include Makefile.config from $(LLVM_OBJ_ROOT).
        3. -
      3. Include Makefile.rules from $(LLVM_SRC_ROOT).
        4. -
      - -

      There are two ways that you can set all of these variables:

      -
        -
      1. You can write your own Makefiles which hard-code these values.
        2. -
      2. You can use the pre-made LLVM sample project. This sample project - includes Makefiles, a configure script that can be used to configure the - location of LLVM, and the ability to support multiple object directories - from a single source directory.
        3. -
      - -

      This document assumes that you will base your project on the LLVM sample -project found in llvm/projects/sample. If you want to devise your own -build system, studying the sample project and LLVM Makefiles will probably -provide enough information on how to write your own Makefiles.

      - -
      - - -
      - Create a Project from the Sample Project -
      - - -
      - -

      Follow these simple steps to start your project:

      - -
        -
      1. Copy the llvm/projects/sample directory to any place of your -choosing. You can place it anywhere you like. Rename the directory to match -the name of your project.
        2. - -
      2. -If you downloaded LLVM using Subversion, remove all the directories named .svn -(and all the files therein) from your project's new source tree. This will -keep Subversion from thinking that your project is inside -llvm/trunk/projects/sample.
        3. - -
      3. Add your source code and Makefiles to your source tree.
        4. - -
      4. If you want your project to be configured with the configure script -then you need to edit autoconf/configure.ac as follows: -
          -
        • AC_INIT. Place the name of your project, its version number and - a contact email address for your project as the arguments to this macro
          • -
        • AC_CONFIG_AUX_DIR. If your project isn't in the - llvm/projects directory then you might need to adjust this so that - it specifies a relative path to the llvm/autoconf directory.
          • -
        • LLVM_CONFIG_PROJECT. Just leave this alone.
          • -
        • AC_CONFIG_SRCDIR. Specify a path to a file name that identifies - your project; or just leave it at Makefile.common.in
          • -
        • AC_CONFIG_FILES. Do not change.
          • -
        • AC_CONFIG_MAKEFILE. Use one of these macros for each Makefile - that your project uses. This macro arranges for your makefiles to be copied - from the source directory, unmodified, to the build directory.
          • -
        -
        5. - -
      5. After updating autoconf/configure.ac, regenerate the -configure script with these commands: - -
        -

        % cd autoconf
        - % ./AutoRegen.sh

        -
        - -

        You must be using Autoconf version 2.59 or later and your aclocal version -should be 1.9 or later.

        6. - -
      6. Run configure in the directory in which you want to place -object code. Use the following options to tell your project where it -can find LLVM: - -
        -
        --with-llvmsrc=<directory>
        -
        Tell your project where the LLVM source tree is located.
        -

        --with-llvmobj=<directory>
        -
        Tell your project where the LLVM object tree is located.
        -

        --prefix=<directory>
        -
        Tell your project where it should get installed.
        -
        -
      - -

      That's it! Now all you have to do is type gmake (or make -if your on a GNU/Linux system) in the root of your object directory, and your -project should build.

      - -
      - - -
      - Source Tree Layout -
      - - -
      - -

      In order to use the LLVM build system, you will want to organize your -source code so that it can benefit from the build system's features. -Mainly, you want your source tree layout to look similar to the LLVM -source tree layout. The best way to do this is to just copy the -project tree from llvm/projects/sample and modify it to meet -your needs, but you can certainly add to it if you want.

      - -

      Underneath your top level directory, you should have the following -directories:

      - -
      -
      lib -
      - This subdirectory should contain all of your library source - code. For each library that you build, you will have one - directory in lib that will contain that library's source - code. - -

      - Libraries can be object files, archives, or dynamic libraries. - The lib directory is just a convenient place for libraries - as it places them all in a directory from which they can be linked - later. - -

      include -
      - This subdirectory should contain any header files that are - global to your project. By global, we mean that they are used - by more than one library or executable of your project. -

      - By placing your header files in include, they will be - found automatically by the LLVM build system. For example, if - you have a file include/jazz/note.h, then your source - files can include it simply with #include "jazz/note.h". - -

      tools -
      - This subdirectory should contain all of your source - code for executables. For each program that you build, you - will have one directory in tools that will contain that - program's source code. -

      - -

      test -
      - This subdirectory should contain tests that verify that your code - works correctly. Automated tests are especially useful. -

      - Currently, the LLVM build system provides basic support for tests. - The LLVM system provides the following: -

        -
      • - LLVM provides a tcl procedure that is used by Dejagnu to run - tests. It can be found in llvm/lib/llvm-dg.exp. This - test procedure uses RUN lines in the actual test case to determine - how to run the test. See the TestingGuide for more details. You - can easily write Makefile support similar to the Makefiles in - llvm/test to use Dejagnu to run your project's tests.
        • -
      • - LLVM contains an optional package called llvm-test - which provides benchmarks and programs that are known to compile with the - LLVM GCC front ends. You can use these - programs to test your code, gather statistics information, and - compare it to the current LLVM performance statistics. -
        Currently, there is no way to hook your tests directly into the - llvm/test testing harness. You will simply - need to find a way to use the source provided within that directory - on your own. -
      -
      - -

      Typically, you will want to build your lib directory first followed by -your tools directory.

      - -
      - - -
      - Writing LLVM Style Makefiles -
      - - -
      - -

      The LLVM build system provides a convenient way to build libraries and -executables. Most of your project Makefiles will only need to define a few -variables. Below is a list of the variables one can set and what they can -do:

      - -
      - - -
      - Required Variables -
      - -
      - -
      -
      LEVEL -
      - This variable is the relative path from this Makefile to the - top directory of your project's source code. For example, if - your source code is in /tmp/src, then the Makefile in - /tmp/src/jump/high would set LEVEL to "../..". -
      - -
      - - -
      - Variables for Building Subdirectories -
      - -
      - -
      -
      DIRS -
      - This is a space separated list of subdirectories that should be - built. They will be built, one at a time, in the order - specified. -

      - -

      PARALLEL_DIRS -
      - This is a list of directories that can be built in parallel. - These will be built after the directories in DIRS have been - built. -

      - -

      OPTIONAL_DIRS -
      - This is a list of directories that can be built if they exist, - but will not cause an error if they do not exist. They are - built serially in the order in which they are listed. -
      - -
      - - -
      - Variables for Building Libraries -
      - -
      - -
      -
      LIBRARYNAME -
      - This variable contains the base name of the library that will - be built. For example, to build a library named - libsample.a, LIBRARYNAME should be set to - sample. -

      - -

      BUILD_ARCHIVE -
      - By default, a library is a .o file that is linked - directly into a program. To build an archive (also known as - a static library), set the BUILD_ARCHIVE variable. -

      - -

      SHARED_LIBRARY -
      - If SHARED_LIBRARY is defined in your Makefile, a shared - (or dynamic) library will be built. -
      - -
      - - -
      - Variables for Building Programs -
      - -
      - -
      -
      TOOLNAME -
      - This variable contains the name of the program that will - be built. For example, to build an executable named - sample, TOOLNAME should be set to sample. -

      - -

      USEDLIBS -
      - This variable holds a space separated list of libraries that - should be linked into the program. These libraries must either - be LLVM libraries or libraries that come from your lib - directory. The libraries must be specified by their base name. - For example, to link libsample.a, you would set USEDLIBS to - sample. -

      - Note that this works only for statically linked libraries. -

      - -

      LIBS -
      - To link dynamic libraries, add -l<library base name> to - the LIBS variable. The LLVM build system will look in the same places - for dynamic libraries as it does for static libraries. -

      - For example, to link libsample.so, you would have the - following line in your Makefile: -

      - - LIBS += -lsample - -

      - -
      - - -
      - Miscellaneous Variables -
      - -
      - -
      -
      ExtraSource -
      - This variable contains a space separated list of extra source - files that need to be built. It is useful for including the - output of Lex and Yacc programs. -

      - -

      CFLAGS -
      CPPFLAGS -
      - This variable can be used to add options to the C and C++ - compiler, respectively. It is typically used to add options - that tell the compiler the location of additional directories - to search for header files. -

      - It is highly suggested that you append to CFLAGS and CPPFLAGS as - opposed to overwriting them. The master Makefiles may already - have useful options in them that you may not want to overwrite. -

      -

      - -
      - - -
      - Placement of Object Code -
      - - -
      - -

      The final location of built libraries and executables will depend upon -whether you do a Debug, Release, or Profile build.

      - -
      -
      Libraries -
      - All libraries (static and dynamic) will be stored in - PROJ_OBJ_ROOT/<type>/lib, where type is Debug, - Release, or Profile for a debug, optimized, or - profiled build, respectively.

      - -

      Executables -
      All executables will be stored in - PROJ_OBJ_ROOT/<type>/bin, where type is Debug, - Release, or Profile for a debug, optimized, or profiled - build, respectively. -
      - -
      - - -
      - Further Help -
      - - -
      - -

      If you have any questions or need any help creating an LLVM project, -the LLVM team would be more than happy to help. You can always post your -questions to the LLVM Developers -Mailing List.

      - -
      - - -
      -
      - Valid CSS - Valid HTML 4.01 - - John Criswell
      - The LLVM Compiler Infrastructure -
      - Last modified: $Date$ -
      - - - Removed: llvm/trunk/docs/ReleaseNotes.html URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/ReleaseNotes.html?rev=103212&view=auto ============================================================================== --- llvm/trunk/docs/ReleaseNotes.html (original) +++ llvm/trunk/docs/ReleaseNotes.html (removed) @@ -1,1237 +0,0 @@ - - - - - - LLVM 2.8 Release Notes - - - -
      LLVM 2.8 Release Notes
      - -LLVM Dragon Logo - -
        -
      1. Introduction
        2. -
      2. Sub-project Status Update
        3. -
      3. External Projects Using LLVM 2.8
        4. -
      4. What's New in LLVM 2.8?
        5. -
      5. Installation Instructions
        6. -
      6. Portability and Supported Platforms
        7. -
      7. Known Problems
        8. -
      8. Additional Information
        9. -
      - -
      -

      Written by the LLVM Team

      -
      - -

      These are in-progress notes for the upcoming LLVM 2.8 -release.
      -You may prefer the -LLVM 2.7 -Release Notes.

      - - -
      - Introduction -
      - - -
      - -

      This document contains the release notes for the LLVM Compiler -Infrastructure, release 2.8. Here we describe the status of LLVM, including -major improvements from the previous release and significant known problems. -All LLVM releases may be downloaded from the LLVM releases web site.

      - -

      For more information about LLVM, including information about the latest -release, please check out the main LLVM -web site. If you have questions or comments, the LLVM Developer's -Mailing List is a good place to send them.

      - -

      Note that if you are reading this file from a Subversion checkout or the -main LLVM web page, this document applies to the next release, not the -current one. To see the release notes for a specific release, please see the -releases page.

      - -
      - - - - - - - - - - -
      - Sub-project Status Update -
      - - -
      -

      -The LLVM 2.8 distribution currently consists of code from the core LLVM -repository (which roughly includes the LLVM optimizers, code generators -and supporting tools), the Clang repository and the llvm-gcc repository. In -addition to this code, the LLVM Project includes other sub-projects that are in -development. Here we include updates on these subprojects. -

      - -
      - - - -
      -Clang: C/C++/Objective-C Frontend Toolkit -
      - -
      - -

      Clang is an LLVM front end for the C, -C++, and Objective-C languages. Clang aims to provide a better user experience -through expressive diagnostics, a high level of conformance to language -standards, fast compilation, and low memory use. Like LLVM, Clang provides a -modular, library-based architecture that makes it suitable for creating or -integrating with other development tools. Clang is considered a -production-quality compiler for C and Objective-C on x86 (32- and 64-bit).

      - -

      In the LLVM 2.7 time-frame, the Clang team has made many improvements:

      - -
        - -
      • C++ Support: Clang is now capable of self-hosting! While still -alpha-quality, Clang's C++ support has matured enough to build LLVM and Clang, -and C++ is now enabled by default. See the Clang C++ compatibility -page for common C++ migration issues.
        • - -
      • Objective-C: Clang now includes experimental support for an updated -Objective-C ABI on non-Darwin platforms. This includes support for non-fragile -instance variables and accelerated proxies, as well as greater potential for -future optimisations. The new ABI is used when compiling with the --fobjc-nonfragile-abi and -fgnu-runtime options. Code compiled with these -options may be mixed with code compiled with GCC or clang using the old GNU ABI, -but requires the libobjc2 runtime from the GNUstep project.
        • - -
      • New warnings: Clang contains a number of new warnings, including -control-flow warnings (unreachable code, missing return statements in a -non-void function, etc.), sign-comparison warnings, and improved -format-string warnings.
        • - -
      • CIndex API and Python bindings: Clang now includes a C API as part of the -CIndex library. Although we may make some changes to the API in the future, it -is intended to be stable and has been designed for use by external projects. See -the Clang -doxygen CIndex -documentation for more details. The CIndex API also includes a preliminary -set of Python bindings.
        • - -
      • ARM Support: Clang now has ABI support for both the Darwin and Linux ARM -ABIs. Coupled with many improvements to the LLVM ARM backend, Clang is now -suitable for use as a beta quality ARM compiler.
        • - -
      -
      - - -
      -Clang Static Analyzer -
      - -
      - -

      The Clang Static Analyzer - project is an effort to use static source code analysis techniques to - automatically find bugs in C and Objective-C programs (and hopefully C++ in the - future!). The tool is very good at finding bugs that occur on specific - paths through code, such as on error conditions.

      - -

      In the LLVM 2.7 time-frame, the analyzer core has made several major and - minor improvements, including better support for tracking the fields of - structures, initial support (not enabled by default yet) for doing - interprocedural (cross-function) analysis, and new checks have been added. -

      - -
      - - -
      -VMKit: JVM/CLI Virtual Machine Implementation -
      - -
      -

      -The VMKit project is an implementation of -a JVM and a CLI Virtual Machine (Microsoft .NET is an -implementation of the CLI) using LLVM for static and just-in-time -compilation.

      - -

      -With the release of LLVM 2.7, VMKit has shifted to a great framework for writing -virtual machines. VMKit now offers precise and efficient garbage collection with -multi-threading support, thanks to the MMTk memory management toolkit, as well -as just in time and ahead of time compilation with LLVM. The major changes in -VMKit 0.27 are:

      - -
        - -
      • Garbage collection: VMKit now uses the MMTk toolkit for garbage collectors. - The first collector to be ported is the MarkSweep collector, which is precise, - and drastically improves the performance of VMKit.
        • -
      • Line number information in the JVM: by using the debug metadata of LLVM, the - JVM now supports precise line number information, useful when printing a stack - trace.
        • -
      • Interface calls in the JVM: we implemented a variant of the Interface Method - Table technique for interface calls in the JVM. -
        • - -
      -
      - - - -
      -compiler-rt: Compiler Runtime Library -
      - -
      -

      -The new LLVM compiler-rt project -is a simple library that provides an implementation of the low-level -target-specific hooks required by code generation and other runtime components. -For example, when compiling for a 32-bit target, converting a double to a 64-bit -unsigned integer is compiled into a runtime call to the "__fixunsdfdi" -function. The compiler-rt library provides highly optimized implementations of -this and other low-level routines (some are 3x faster than the equivalent -libgcc routines).

      - -

      -All of the code in the compiler-rt project is available under the standard LLVM -License, a "BSD-style" license. New in LLVM 2.7: compiler_rt now -supports ARM targets.

      - -
      - - -
      -DragonEgg: llvm-gcc ported to gcc-4.5 -
      - -
      -

      -DragonEgg is a port of llvm-gcc to -gcc-4.5. Unlike llvm-gcc, which makes many intrusive changes to the underlying -gcc-4.2 code, dragonegg in theory does not require any gcc-4.5 modifications -whatsoever (currently one small patch is needed). This is thanks to the new -gcc plugin architecture, which -makes it possible to modify the behaviour of gcc at runtime by loading a plugin, -which is nothing more than a dynamic library which conforms to the gcc plugin -interface. DragonEgg is a gcc plugin that causes the LLVM optimizers to be run -instead of the gcc optimizers, and the LLVM code generators instead of the gcc -code generators, just like llvm-gcc. To use it, you add -"-fplugin=path/dragonegg.so" to the gcc-4.5 command line, and gcc-4.5 magically -becomes llvm-gcc-4.5! -

      - -

      -DragonEgg is still a work in progress. Currently C works very well, while C++, -Ada and Fortran work fairly well. All other languages either don't work at all, -or only work poorly. For the moment only the x86-32 and x86-64 targets are -supported, and only on linux and darwin (darwin needs an additional gcc patch). -

      - -

      -DragonEgg is a new project which is seeing its first release with llvm-2.7. -

      - -
      - - - -
      -llvm-mc: Machine Code Toolkit -
      - -
      -

      -The LLVM Machine Code (aka MC) sub-project of LLVM was created to solve a number -of problems in the realm of assembly, disassembly, object file format handling, -and a number of other related areas that CPU instruction-set level tools work -in. It is a sub-project of LLVM which provides it with a number of advantages -over other compilers that do not have tightly integrated assembly-level tools. -For a gentle introduction, please see the Intro to the -LLVM MC Project Blog Post. -

      - -

      2.7 includes major parts of the work required by the new MC Project. A few - targets have been refactored to support it, and work is underway to support a - native assembler in LLVM. This work is not complete in LLVM 2.7, but it has - made substantially more progress on LLVM mainline.

      - -

      One minor example of what MC can do is to transcode an AT&T syntax - X86 .s file into intel syntax. You can do this with something like:

      -
      -  llvm-mc foo.s -output-asm-variant=1 -o foo-intel.s
-
      - -
      - - - -
      - External Open Source Projects Using LLVM 2.7 -
      - - -
      - -

      An exciting aspect of LLVM is that it is used as an enabling technology for - a lot of other language and tools projects. This section lists some of the - projects that have already been updated to work with LLVM 2.7.

      -
      - - -
      -Pure -
      - -
      -

      -Pure -is an algebraic/functional programming language based on term rewriting. -Programs are collections of equations which are used to evaluate expressions in -a symbolic fashion. Pure offers dynamic typing, eager and lazy evaluation, -lexical closures, a hygienic macro system (also based on term rewriting), -built-in list and matrix support (including list and matrix comprehensions) and -an easy-to-use C interface. The interpreter uses LLVM as a backend to - JIT-compile Pure programs to fast native code.

      - -

      Pure versions 0.43 and later have been tested and are known to work with -LLVM 2.7 (and continue to work with older LLVM releases >= 2.5).

      - -
      - - -
      -Roadsend PHP -
      - -
      -

      -Roadsend PHP (rphp) is an open -source implementation of the PHP programming -language that uses LLVM for its optimizer, JIT and static compiler. This is a -reimplementation of an earlier project that is now based on LLVM. -

      -
      - - -
      -Unladen Swallow -
      - -
      -

      -Unladen Swallow is a -branch of Python intended to be fully -compatible and significantly faster. It uses LLVM's optimization passes and JIT -compiler. -

      -
      - - -
      -TTA-based Codesign Environment (TCE) -
      - -
      -

      -TCE is a toolset for designing -application-specific processors (ASP) based on the Transport triggered -architecture (TTA). The toolset provides a complete co-design flow from C/C++ -programs down to synthesizable VHDL and parallel program binaries. Processor -customization points include the register files, function units, supported -operations, and the interconnection network.

      - -

      TCE uses llvm-gcc/Clang and LLVM for C/C++ language support, target -independent optimizations and also for parts of code generation. It generates -new LLVM-based code generators "on the fly" for the designed TTA processors and -loads them in to the compiler backend as runtime libraries to avoid per-target -recompilation of larger parts of the compiler chain.

      - -
      - - -
      -SAFECode Compiler -
      - -
      -

      -SAFECode is a memory safe C -compiler built using LLVM. It takes standard, unannotated C code, analyzes the -code to ensure that memory accesses and array indexing operations are safe, and -instruments the code with run-time checks when safety cannot be proven -statically. -

      -
      - - -
      -IcedTea Java Virtual Machine Implementation -
      - -
      -

      -IcedTea provides a -harness to build OpenJDK using only free software build tools and to provide -replacements for the not-yet free parts of OpenJDK. One of the extensions that -IcedTea provides is a new JIT compiler named Shark which uses LLVM -to provide native code generation without introducing processor-dependent -code. -

      -

      Icedtea6 1.8 and later have been tested and are known to work with -LLVM 2.7 (and continue to work with older LLVM releases >= 2.6 as well). -

      -
      - - -
      -LLVM-Lua -
      - -
      -

      -LLVM-Lua uses LLVM - to add JIT and static compiling support to the Lua VM. Lua -bytecode is analyzed to remove type checks, then LLVM is used to compile the -bytecode down to machine code. -

      -

      LLVM-Lua 1.2.0 have been tested and is known to work with LLVM 2.7. -

      -
      - - -
      -MacRuby -
      - -
      -

      -MacRuby is an implementation of Ruby based on -core Mac OS technologies, sponsored by Apple Inc. It uses LLVM at runtime for -optimization passes, JIT compilation and exception handling. It also allows -static (ahead-of-time) compilation of Ruby code straight to machine code. -

      -

      The upcoming MacRuby 0.6 release works with LLVM 2.7. -

      -
      - - -
      -Glasgow Haskell Compiler (GHC) -
      - -
      -

      -GHC is an open source, -state-of-the-art programming suite for Haskell, a standard lazy -functional programming language. It includes an optimizing static -compiler generating good code for a variety of platforms, together -with an interactive system for convenient, quick development.

      - -

      In addition to the existing C and native code generators, GHC now -supports an LLVM -code generator. GHC supports LLVM 2.7.

      - -
      - - - -
      - What's New in LLVM 2.7? -
      - - -
      - -

      This release includes a huge number of bug fixes, performance tweaks and -minor improvements. Some of the major improvements and new features are listed -in this section. -

      - -
      - - -
      -LLVM Community Changes -
      - -
      - -

      In addition to changes to the code, between LLVM 2.6 and 2.7, a number of -organization changes have happened: -

      - -
        -
      • LLVM has a new official logo!
        • - -
      • Ted Kremenek and Doug Gregor have stepped forward as Code Owners of the - Clang static analyzer and the Clang frontend, respectively.
        • - -
      • LLVM now has an official Blog at - http://blog.llvm.org. This is a great way - to learn about new LLVM-related features as they are implemented. Several - features in this release are already explained on the blog.
        • - -
      • The LLVM web pages are now checked into the SVN server, in the "www", - "www-pubs" and "www-releases" SVN modules. Previously they were hidden in a - largely inaccessible old CVS server.
        • - -
      • llvm.org is now hosted on a new (and much - faster) server. It is still graciously hosted at the University of Illinois - of Urbana Champaign.
        • -
      -
      - - -
      -Major New Features -
      - -
      - -

      LLVM 2.7 includes several major new capabilities:

      - -
        -
      • 2.7 includes initial support for the MicroBlaze target. - MicroBlaze is a soft processor core designed for Xilinx FPGAs.
        • - -
      • 2.7 includes a new LLVM IR "extensible metadata" feature. This feature - supports many different use cases, including allowing front-end authors to - encode source level information into LLVM IR, which is consumed by later - language-specific passes. This is a great way to do high-level optimizations - like devirtualization, type-based alias analysis, etc. See the - Extensible Metadata Blog Post for more information.
        • - -
      • 2.7 encodes debug information -in a completely new way, built on extensible metadata. The new implementation -is much more memory efficient and paves the way for improvements to optimized -code debugging experience.
        • - -
      • 2.7 now directly supports taking the address of a label and doing an - indirect branch through a pointer. This is particularly useful for - interpreter loops, and is used to implement the GCC "address of label" - extension. For more information, see the -Address of Label and Indirect Branches in LLVM IR Blog Post. - -
      • 2.7 is the first release to start supporting APIs for assembling and - disassembling target machine code. These APIs are useful for a variety of - low level clients, and are surfaced in the new "enhanced disassembly" API. - For more information see the The X86 - Disassembler Blog Post for more information.
        • - -
      • 2.7 includes major parts of the work required by the new MC Project, - see the MC update above for more information.
        • - -
      - -
      - - -
      -LLVM IR and Core Improvements -
      - -
      -

      LLVM IR has several new features for better support of new targets and that -expose new optimization opportunities:

      - -
        -
      • LLVM IR now supports a 16-bit "half float" data type through two new intrinsics and APFloat support.
        • -
      • LLVM IR supports two new function - attributes: inlinehint and alignstack(n). The former is a hint to the - optimizer that a function was declared 'inline' and thus the inliner should - weight it higher when considering inlining it. The later - indicates to the code generator that the function diverges from the platform - ABI on stack alignment.
        • -
      • The new llvm.objectsize intrinsic - allows the optimizer to infer the sizes of memory objects in some cases. - This intrinsic is used to implement the GCC __builtin_object_size - extension.
        • -
      • LLVM IR now supports marking load and store instructions with "non-temporal" hints (building on the new - metadata feature). This hint encourages the code - generator to generate non-temporal accesses when possible, which are useful - for code that is carefully managing cache behavior. Currently, only the - X86 backend provides target support for this feature.
        • - -
      • LLVM 2.7 has pre-alpha support for unions in LLVM IR. - Unfortunately, this support is not really usable in 2.7, so if you're - interested in pushing it forward, please help contribute to LLVM mainline.
        • - -
      - -
      - - -
      -Optimizer Improvements -
      - -
      - -

      In addition to a large array of minor performance tweaks and bug fixes, this -release includes a few major enhancements and additions to the optimizers:

      - -
        - -
      • The inliner now merges arrays stack objects in different callees when - inlining multiple call sites into one function. This reduces the stack size - of the resultant function.
        • -
      • The -basicaa alias analysis pass (which is the default) has been improved to - be less dependent on "type safe" pointers. It can now look through bitcasts - and other constructs more aggressively, allowing better load/store - optimization.
        • -
      • The load elimination optimization in the GVN Pass [intro - blog post] has been substantially improved to be more aggressive about - partial redundancy elimination and do more aggressive phi translation. Please - see the - Advanced Topics in Redundant Load Elimination with a Focus on PHI Translation - Blog Post for more details.
        • -
      • The module target data string now - includes a notion of 'native' integer data types for the target. This - helps mid-level optimizations avoid promoting complex sequences of - operations to data types that are not natively supported (e.g. converting - i32 operations to i64 on 32-bit chips).
        • -
      • The mid-level optimizer is now conservative when operating on a module with - no target data. Previously, it would default to SparcV9 settings, which is - not what most people expected.
        • -
      • Jump threading is now much more aggressive at simplifying correlated - conditionals and threading blocks with otherwise complex logic. It has - subsumed the old "Conditional Propagation" pass, and -condprop has been - removed from LLVM 2.7.
        • -
      • The -instcombine pass has been refactored from being one huge file to being - a library of its own. Internally, it uses a customized IRBuilder to clean - it up and simplify it.
        • - -
      • The optimal edge profiling pass is reliable and much more complete than in - 2.6. It can be used with the llvm-prof tool but isn't wired up to the - llvm-gcc and clang command line options yet.
        • - -
      • A new experimental alias analysis implementation, -scev-aa, has been added. - It uses LLVM's Scalar Evolution implementation to do symbolic analysis of - pointer offset expressions to disambiguate pointers. It can catch a few - cases that basicaa cannot, particularly in complex loop nests.
        • - -
      • The default pass ordering has been tweaked for improved optimization - effectiveness.
        • - -
      - -
      - - - -
      -Interpreter and JIT Improvements -
      - -
      - -
        -
      • The JIT now supports generating debug information and is compatible with -the new GDB 7.0 (and later) interfaces for registering dynamically generated -debug info.
        • - -
      • The JIT now defaults -to compiling eagerly to avoid a race condition in the lazy JIT. -Clients that still want the lazy JIT can switch it on by calling -ExecutionEngine::DisableLazyCompilation(false).
        • - -
      • It is now possible to create more than one JIT instance in the same process. -These JITs can generate machine code in parallel, -although you -still have to obey the other threading restrictions.
        • - -
      - -
      - - -
      -Target Independent Code Generator Improvements -
      - -
      - -

      We have put a significant amount of work into the code generator -infrastructure, which allows us to implement more aggressive algorithms and make -it run faster:

      - -
        -
      • The 'llc -asm-verbose' option (which is now the default) has been enhanced - to emit many useful comments to .s files indicating information about spill - slots and loop nest structure. This should make it much easier to read and - understand assembly files. This is wired up in llvm-gcc and clang to - the -fverbose-asm option.
        • - -
      • New LSR with "full strength reduction" mode, which can reduce address - register pressure in loops where address generation is important.
        • - -
      • A new codegen level Common Subexpression Elimination pass (MachineCSE) - is available and enabled by default. It catches redundancies exposed by - lowering.
        • -
      • A new pre-register-allocation tail duplication pass is available and enabled - by default, it can substantially improve branch prediction quality in some - cases.
        • -
      • A new sign and zero extension optimization pass (OptimizeExtsPass) - is available and enabled by default. This pass can takes advantage - architecture features like x86-64 implicit zero extension behavior and - sub-registers.
        • -
      • The code generator now supports a mode where it attempts to preserve the - order of instructions in the input code. This is important for source that - is hand scheduled and extremely sensitive to scheduling. It is compatible - with the GCC -fno-schedule-insns option.
        • -
      • The target-independent code generator now supports generating code with - arbitrary numbers of result values. Returning more values than was - previously supported is handled by returning through a hidden pointer. In - 2.7, only the X86 and XCore targets have adopted support for this - though.
        • -
      • The code generator now supports generating code that follows the - Glasgow Haskell Compiler Calling - Convention and ABI.
        • -
      • The "DAG instruction - selection" phase of the code generator has been largely rewritten for - 2.7. Previously, tblgen spit out tons of C++ code which was compiled and - linked into the target to do the pattern matching, now it emits a much - smaller table which is read by the target-independent code. The primary - advantages of this approach is that the size and compile time of various - targets is much improved. The X86 code generator shrunk by 1.5MB of code, - for example.
        • -
      • Almost the entire code generator has switched to emitting code through the - MC interfaces instead of printing textually to the .s file. This led to a - number of cleanups and speedups. In 2.7, debug an exception handling - information does not go through MC yet.
        • -
      -
      - - -
      -X86-32 and X86-64 Target Improvements -
      - -
      -

      New features of the X86 target include: -

      - -
        -
      • The X86 backend now optimizes tails calls much more aggressively for - functions that use the standard C calling convention.
        • -
      • The X86 backend now models scalar SSE registers as subregs of the SSE vector - registers, making the code generator more aggressive in cases where scalars - and vector types are mixed.
        • - -
      - -
      - - -
      -ARM Target Improvements -
      - -
      -

      New features of the ARM target include: -

      - -
        - -
      • The ARM backend now generates instructions in unified assembly syntax.
        • - -
      • llvm-gcc now has complete support for the ARM v7 NEON instruction set. This - support differs slightly from the GCC implementation. Please see the - - ARM Advanced SIMD (NEON) Intrinsics and Types in LLVM Blog Post for - helpful information if migrating code from GCC to LLVM-GCC.
        • - -
      • The ARM and Thumb code generators now use register scavenging for stack - object address materialization. This allows the use of R3 as a general - purpose register in Thumb1 code, as it was previous reserved for use in - stack address materialization. Secondly, sequential uses of the same - value will now re-use the materialized constant.
        • - -
      • The ARM backend now has good support for ARMv4 targets and has been tested - on StrongARM hardware. Previously, LLVM only supported ARMv4T and - newer chips.
        • - -
      • Atomic builtins are now supported for ARMv6 and ARMv7 (__sync_synchronize, - __sync_fetch_and_add, etc.).
        • - -
      - - -
      - - -
      -New Useful APIs -
      - -
      - -

      This release includes a number of new APIs that are used internally, which - may also be useful for external clients. -

      - -
        -
      • The optimizer uses the new CodeMetrics class to measure the size of code. - Various passes (like the inliner, loop unswitcher, etc) all use this to make - more accurate estimates of the code size impact of various - optimizations.
        • -
      • A new - llvm/Analysis/InstructionSimplify.h interface is available for doing - symbolic simplification of instructions (e.g. a+0 -> a) - without requiring the instruction to exist. This centralizes a lot of - ad-hoc symbolic manipulation code scattered in various passes.
        • -
      • The optimizer now uses a new SSAUpdater - class which efficiently supports - doing unstructured SSA update operations. This centralized a bunch of code - scattered throughout various passes (e.g. jump threading, lcssa, - loop rotate, etc) for doing this sort of thing. The code generator has a - similar - MachineSSAUpdater class.
        • -
      • The - llvm/Support/Regex.h header exposes a platform independent regular - expression API. Building on this, the FileCheck utility now supports - regular exressions.
        • -
      • raw_ostream now supports a circular "debug stream" accessed with "dbgs()". - By default, this stream works the same way as "errs()", but if you pass - -debug-buffer-size=1000 to opt, the debug stream is capped to a - fixed sized circular buffer and the output is printed at the end of the - program's execution. This is helpful if you have a long lived compiler - process and you're interested in seeing snapshots in time.
        • -
      - - -
      - - -
      -Other Improvements and New Features -
      - -
      -

      Other miscellaneous features include:

      - -
        -
      • You can now build LLVM as a big dynamic library (e.g. "libllvm2.7.so"). To - get this, configure LLVM with the --enable-shared option.
        • - -
      • LLVM command line tools now overwrite their output by default. Previously, - they would only do this with -f. This makes them more convenient to use, and - behave more like standard unix tools.
        • - -
      • The opt and llc tools now autodetect whether their input is a .ll or .bc - file, and automatically do the right thing. This means you don't need to - explicitly use the llvm-as tool for most things.
        • -
      - -
      - - - -
      -Major Changes and Removed Features -
      - -
      - -

      If you're already an LLVM user or developer with out-of-tree changes based -on LLVM 2.6, this section lists some "gotchas" that you may run into upgrading -from the previous release.

      - -
        - -
      • -The Andersen's alias analysis ("anders-aa") pass, the Predicate Simplifier -("predsimplify") pass, the LoopVR pass, the GVNPRE pass, and the random sampling -profiling ("rsprofiling") passes have all been removed. They were not being -actively maintained and had substantial problems. If you are interested in -these components, you are welcome to ressurect them from SVN, fix the -correctness problems, and resubmit them to mainline.
        • - -
      • LLVM now defaults to building most libraries with RTTI turned off, providing -a code size reduction. Packagers who are interested in building LLVM to support -plugins that require RTTI information should build with "make REQUIRE_RTTI=1" -and should read the new Advice on Packaging LLVM -document.
        • - -
      • The LLVM interpreter now defaults to not using libffi even -if you have it installed. This makes it more likely that an LLVM built on one -system will work when copied to a similar system. To use libffi, -configure with --enable-libffi.
        • - -
      • Debug information uses a completely different representation, an LLVM 2.6 -.bc file should work with LLVM 2.7, but debug info won't come forward.
        • - -
      • The LLVM 2.6 (and earlier) "malloc" and "free" instructions got removed, - along with LowerAllocations pass. Now you should just use a call to the - malloc and free functions in libc. These calls are optimized as well as - the old instructions were.
        • -
      - -

      In addition, many APIs have changed in this release. Some of the major LLVM -API changes are:

      - -
        - -
      • The add, sub, and mul instructions no longer -support floating-point operands. The fadd, fsub, and -fmul instructions should be used for this purpose instead.
        • - -
      - -
      - - - - -
      - Portability and Supported Platforms -
      - - -
      - -

      LLVM is known to work on the following platforms:

      - -
        -
      • Intel and AMD machines (IA32, X86-64, AMD64, EMT-64) running Red Hat - Linux, Fedora Core, FreeBSD and AuroraUX (and probably other unix-like - systems).
        • -
      • PowerPC and X86-based Mac OS X systems, running 10.4 and above in 32-bit - and 64-bit modes.
        • -
      • Intel and AMD machines running on Win32 using MinGW libraries (native).
        • -
      • Intel and AMD machines running on Win32 with the Cygwin libraries (limited - support is available for native builds with Visual C++).
        • -
      • Sun x86 and AMD64 machines running Solaris 10, OpenSolaris 0906.
        • -
      • Alpha-based machines running Debian GNU/Linux.
        • -
      - -

      The core LLVM infrastructure uses GNU autoconf to adapt itself -to the machine and operating system on which it is built. However, minor -porting may be required to get LLVM to work on new platforms. We welcome your -portability patches and reports of successful builds or error messages.

      - -
      - - -
      - Known Problems -
      - - -
      - -

      This section contains significant known problems with the LLVM system, -listed by component. If you run into a problem, please check the LLVM bug database and submit a bug if -there isn't already one.

      - -
        -
      • LLVM will not correctly compile on Solaris and/or OpenSolaris -using the stock GCC 3.x.x series 'out the box', -See: Broken versions of GCC and other tools. -However, A Modern GCC Build -for x86/x86-64 has been made available from the third party AuroraUX Project -that has been meticulously tested for bootstrapping LLVM & Clang.
        • -
      - -
      - - -
      - Experimental features included with this release -
      - -
      - -

      The following components of this LLVM release are either untested, known to -be broken or unreliable, or are in early development. These components should -not be relied on, and bugs should not be filed against them, but they may be -useful to some people. In particular, if you would like to work on one of these -components, please contact us on the LLVMdev list.

      - -
        -
      • The MSIL, Alpha, SPU, MIPS, PIC16, Blackfin, MSP430, SystemZ and MicroBlaze - backends are experimental.
        • -
      • llc "-filetype=asm" (the default) is the only - supported value for this option. The MachO writer is experimental, and - works much better in mainline SVN.
        • -
      - -
      - - -
      - Known problems with the X86 back-end -
      - -
      - -
        -
      • The X86 backend does not yet support - all inline assembly that uses the X86 - floating point stack. It supports the 'f' and 't' constraints, but not - 'u'.
        • -
      • The X86 backend generates inefficient floating point code when configured - to generate code for systems that don't have SSE2.
        • -
      • Win64 code generation wasn't widely tested. Everything should work, but we - expect small issues to happen. Also, llvm-gcc cannot build the mingw64 - runtime currently due to lack of support for the 'u' inline assembly - constraint and for X87 floating point inline assembly.
        • -
      • The X86-64 backend does not yet support the LLVM IR instruction - va_arg. Currently, front-ends support variadic - argument constructs on X86-64 by lowering them manually.
        • -
      - -
      - - -
      - Known problems with the PowerPC back-end -
      - -
      - -
        -
      • The Linux PPC32/ABI support needs testing for the interpreter and static -compilation, and lacks support for debug information.
        • -
      - -
      - - -
      - Known problems with the ARM back-end -
      - -
      - -
        -
      • Thumb mode works only on ARMv6 or higher processors. On sub-ARMv6 -processors, thumb programs can crash or produce wrong -results (PR1388).
        • -
      • Compilation for ARM Linux OABI (old ABI) is supported but not fully tested. -
        • -
      - -
      - - -
      - Known problems with the SPARC back-end -
      - -
      - -
        -
      • The SPARC backend only supports the 32-bit SPARC ABI (-m32); it does not - support the 64-bit SPARC ABI (-m64).
        • -
      - -
      - - -
      - Known problems with the MIPS back-end -
      - -
      - -
        -
      • 64-bit MIPS targets are not supported yet.
        • -
      - -
      - - -
      - Known problems with the Alpha back-end -
      - -
      - -
        - -
      • On 21164s, some rare FP arithmetic sequences which may trap do not have the -appropriate nops inserted to ensure restartability.
        • - -
      -
      - - -
      - Known problems with the C back-end -
      - -
      - - - -
      - - - -
      - Known problems with the llvm-gcc C and C++ front-end -
      - -
      - -

      The only major language feature of GCC not supported by llvm-gcc is - the __builtin_apply family of builtins. However, some extensions - are only supported on some targets. For example, trampolines are only - supported on some targets (these are used when you take the address of a - nested function).

      - -
      - - -
      - Known problems with the llvm-gcc Fortran front-end -
      - -
      -
        -
      • Fortran support generally works, but there are still several unresolved bugs - in Bugzilla. Please see the - tools/gfortran component for details.
        • -
      -
      - - -
      - Known problems with the llvm-gcc Ada front-end -
      - -
      -The llvm-gcc 4.2 Ada compiler works fairly well; however, this is not a mature -technology, and problems should be expected. -
        -
      • The Ada front-end currently only builds on X86-32. This is mainly due -to lack of trampoline support (pointers to nested functions) on other platforms. -However, it also fails to build on X86-64 -which does support trampolines.
        • -
      • The Ada front-end fails to bootstrap. -This is due to lack of LLVM support for setjmp/longjmp style -exception handling, which is used internally by the compiler. -Workaround: configure with --disable-bootstrap.
        • -
      • The c380004, c393010 -and cxg2021 ACATS tests fail -(c380004 also fails with gcc-4.2 mainline). -If the compiler is built with checks disabled then c393010 -causes the compiler to go into an infinite loop, using up all system memory.
        • -
      • Some GCC specific Ada tests continue to crash the compiler.
        • -
      • The -E binder option (exception backtraces) -does not work and will result in programs -crashing if an exception is raised. Workaround: do not use -E.
        • -
      • Only discrete types are allowed to start -or finish at a non-byte offset in a record. Workaround: do not pack records -or use representation clauses that result in a field of a non-discrete type -starting or finishing in the middle of a byte.
        • -
      • The lli interpreter considers -'main' as generated by the Ada binder to be invalid. -Workaround: hand edit the file to use pointers for argv and -envp rather than integers.
        • -
      • The -fstack-check option is -ignored.
        • -
      -
      - - -
      - Additional Information -
      - - -
      - -

      A wide variety of additional information is available on the LLVM web page, in particular in the documentation section. The web page also -contains versions of the API documentation which is up-to-date with the -Subversion version of the source code. -You can access versions of these documents specific to this release by going -into the "llvm/doc/" directory in the LLVM tree.

      - -

      If you have any questions or comments about LLVM, please feel free to contact -us via the mailing -lists.

      - -
      - - - -
      -
      - Valid CSS - Valid HTML 4.01 - - LLVM Compiler Infrastructure
      - Last modified: $Date$ -
      - - - Removed: llvm/trunk/docs/SourceLevelDebugging.html URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/SourceLevelDebugging.html?rev=103212&view=auto ============================================================================== --- llvm/trunk/docs/SourceLevelDebugging.html (original) +++ llvm/trunk/docs/SourceLevelDebugging.html (removed) @@ -1,1780 +0,0 @@ - - - - - Source Level Debugging with LLVM - - - - -
      Source Level Debugging with LLVM
      - - - - - -
      - - -A leafy and green bug eater -
      - -
      -

      Written by Chris Lattner - and Jim Laskey

      -
      - - - -
      Introduction
      - - -
      - -

      This document is the central repository for all information pertaining to - debug information in LLVM. It describes the actual format - that the LLVM debug information takes, which is useful for those - interested in creating front-ends or dealing directly with the information. - Further, this document provides specific examples of what debug information - for C/C++.

      - -
      - - -
      - Philosophy behind LLVM debugging information -
      - -
      - -

      The idea of the LLVM debugging information is to capture how the important - pieces of the source-language's Abstract Syntax Tree map onto LLVM code. - Several design aspects have shaped the solution that appears here. The - important ones are:

      - -
        -
      • Debugging information should have very little impact on the rest of the - compiler. No transformations, analyses, or code generators should need to - be modified because of debugging information.
        • - -
      • LLVM optimizations should interact in well-defined and - easily described ways with the debugging information.
        • - -
      • Because LLVM is designed to support arbitrary programming languages, - LLVM-to-LLVM tools should not need to know anything about the semantics of - the source-level-language.
        • - -
      • Source-level languages are often widely different from one another. - LLVM should not put any restrictions of the flavor of the source-language, - and the debugging information should work with any language.
        • - -
      • With code generator support, it should be possible to use an LLVM compiler - to compile a program to native machine code and standard debugging - formats. This allows compatibility with traditional machine-code level - debuggers, like GDB or DBX.
        • -
      - -

      The approach used by the LLVM implementation is to use a small set - of intrinsic functions to define a - mapping between LLVM program objects and the source-level objects. The - description of the source-level program is maintained in LLVM metadata - in an implementation-defined format - (the C/C++ front-end currently uses working draft 7 of - the DWARF 3 - standard).

      - -

      When a program is being debugged, a debugger interacts with the user and - turns the stored debug information into source-language specific information. - As such, a debugger must be aware of the source-language, and is thus tied to - a specific language or family of languages.

      - -
      - - -
      - Debug information consumers -
      - -
      - -

      The role of debug information is to provide meta information normally - stripped away during the compilation process. This meta information provides - an LLVM user a relationship between generated code and the original program - source code.

      - -

      Currently, debug information is consumed by DwarfDebug to produce dwarf - information used by the gdb debugger. Other targets could use the same - information to produce stabs or other debug forms.

      - -

      It would also be reasonable to use debug information to feed profiling tools - for analysis of generated code, or, tools for reconstructing the original - source from generated code.

      - -

      TODO - expound a bit more.

      - -
      - - -
      - Debugging optimized code -
      - -
      - -

      An extremely high priority of LLVM debugging information is to make it - interact well with optimizations and analysis. In particular, the LLVM debug - information provides the following guarantees:

      - -
        -
      • LLVM debug information always provides information to accurately read - the source-level state of the program, regardless of which LLVM - optimizations have been run, and without any modification to the - optimizations themselves. However, some optimizations may impact the - ability to modify the current state of the program with a debugger, such - as setting program variables, or calling functions that have been - deleted.
        • - -
      • LLVM optimizations gracefully interact with debugging information. If - they are not aware of debug information, they are automatically disabled - as necessary in the cases that would invalidate the debug info. This - retains the LLVM features, making it easy to write new - transformations.
        • - -
      • As desired, LLVM optimizations can be upgraded to be aware of the LLVM - debugging information, allowing them to update the debugging information - as they perform aggressive optimizations. This means that, with effort, - the LLVM optimizers could optimize debug code just as well as non-debug - code.
        • - -
      • LLVM debug information does not prevent many important optimizations from - happening (for example inlining, basic block reordering/merging/cleanup, - tail duplication, etc), further reducing the amount of the compiler that - eventually is "aware" of debugging information.
        • - -
      • LLVM debug information is automatically optimized along with the rest of - the program, using existing facilities. For example, duplicate - information is automatically merged by the linker, and unused information - is automatically removed.
        • -
      - -

      Basically, the debug information allows you to compile a program with - "-O0 -g" and get full debug information, allowing you to arbitrarily - modify the program as it executes from a debugger. Compiling a program with - "-O3 -g" gives you full debug information that is always available - and accurate for reading (e.g., you get accurate stack traces despite tail - call elimination and inlining), but you might lose the ability to modify the - program and call functions where were optimized out of the program, or - inlined away completely.

      - -

      LLVM test suite provides a - framework to test optimizer's handling of debugging information. It can be - run like this:

      - -
      -
      -% cd llvm/projects/test-suite/MultiSource/Benchmarks  # or some other level
-% make TEST=dbgopt
-
      -
      - -

      This will test impact of debugging information on optimization passes. If - debugging information influences optimization passes then it will be reported - as a failure. See TestingGuide for more - information on LLVM test infrastructure and how to run various tests.

      - -
      - - -
      - Debugging information format -
      - - -
      - -

      LLVM debugging information has been carefully designed to make it possible - for the optimizer to optimize the program and debugging information without - necessarily having to know anything about debugging information. In - particular, the use of metadata avoids duplicated debugging information from - the beginning, and the global dead code elimination pass automatically - deletes debugging information for a function if it decides to delete the - function.

      - -

      To do this, most of the debugging information (descriptors for types, - variables, functions, source files, etc) is inserted by the language - front-end in the form of LLVM metadata.

      - -

      Debug information is designed to be agnostic about the target debugger and - debugging information representation (e.g. DWARF/Stabs/etc). It uses a - generic pass to decode the information that represents variables, types, - functions, namespaces, etc: this allows for arbitrary source-language - semantics and type-systems to be used, as long as there is a module - written for the target debugger to interpret the information.

      - -

      To provide basic functionality, the LLVM debugger does have to make some - assumptions about the source-level language being debugged, though it keeps - these to a minimum. The only common features that the LLVM debugger assumes - exist are source files, - and program objects. These abstract - objects are used by a debugger to form stack traces, show information about - local variables, etc.

      - -

      This section of the documentation first describes the representation aspects - common to any source-language. The next section - describes the data layout conventions used by the C and C++ front-ends.

      - -
      - - -
      - Debug information descriptors -
      - -
      - -

      In consideration of the complexity and volume of debug information, LLVM - provides a specification for well formed debug descriptors.

      - -

      Consumers of LLVM debug information expect the descriptors for program - objects to start in a canonical format, but the descriptors can include - additional information appended at the end that is source-language - specific. All LLVM debugging information is versioned, allowing backwards - compatibility in the case that the core structures need to change in some - way. Also, all debugging information objects start with a tag to indicate - what type of object it is. The source-language is allowed to define its own - objects, by using unreserved tag numbers. We recommend using with tags in - the range 0x1000 through 0x2000 (there is a defined enum DW_TAG_user_base = - 0x1000.)

      - -

      The fields of debug descriptors used internally by LLVM - are restricted to only the simple data types i32, i1, - float, double, mdstring and mdnode.

      - -
      -
      -!1 = metadata !{
-  i32,   ;; A tag
-  ...
-}
-
      -
      - -

      The first field of a descriptor is always an - i32 containing a tag value identifying the content of the - descriptor. The remaining fields are specific to the descriptor. The values - of tags are loosely bound to the tag values of DWARF information entries. - However, that does not restrict the use of the information supplied to DWARF - targets. To facilitate versioning of debug information, the tag is augmented - with the current debug version (LLVMDebugVersion = 8 << 16 or 0x80000 or - 524288.)

      - -

      The details of the various descriptors follow.

      - -
      - - -
      - Compile unit descriptors -
      - -
      - -
      -
      -!0 = metadata !{
-  i32,       ;; Tag = 17 + LLVMDebugVersion 
-             ;; (DW_TAG_compile_unit)
-  i32,       ;; Unused field. 
-  i32,       ;; DWARF language identifier (ex. DW_LANG_C89) 
-  metadata,  ;; Source file name
-  metadata,  ;; Source file directory (includes trailing slash)
-  metadata   ;; Producer (ex. "4.0.1 LLVM (LLVM research group)")
-  i1,        ;; True if this is a main compile unit. 
-  i1,        ;; True if this is optimized.
-  metadata,  ;; Flags
-  i32        ;; Runtime version
-}
-
      -
      - -

      These descriptors contain a source language ID for the file (we use the DWARF - 3.0 ID numbers, such as DW_LANG_C89, DW_LANG_C_plus_plus, - DW_LANG_Cobol74, etc), three strings describing the filename, - working directory of the compiler, and an identifier string for the compiler - that produced it.

      - -

      Compile unit descriptors provide the root context for objects declared in a - specific compilation unit. File descriptors are defined using this context.

      - -
      - - -
      - File descriptors -
      - -
      - -
      -
      -!0 = metadata !{
-  i32,       ;; Tag = 41 + LLVMDebugVersion 
-             ;; (DW_TAG_file_type)
-  metadata,  ;; Source file name
-  metadata,  ;; Source file directory (includes trailing slash)
-  metadata   ;; Reference to compile unit where defined
-}
-
      -
      - -

      These descriptors contain information for a file. Global variables and top - level functions would be defined using this context.k File descriptors also - provide context for source line correspondence.

      - -

      Each input file is encoded as a separate file descriptor in LLVM debugging - information output. Each file descriptor would be defined using a - compile unit.

      - -
      - - -
      - Global variable descriptors -
      - -
      - -
      -
      -!1 = metadata !{
-  i32,      ;; Tag = 52 + LLVMDebugVersion 
-            ;; (DW_TAG_variable)
-  i32,      ;; Unused field.
-  metadata, ;; Reference to context descriptor
-  metadata, ;; Name
-  metadata, ;; Display name (fully qualified C++ name)
-  metadata, ;; MIPS linkage name (for C++)
-  metadata, ;; Reference to file where defined
-  i32,      ;; Line number where defined
-  metadata, ;; Reference to type descriptor
-  i1,       ;; True if the global is local to compile unit (static)
-  i1,       ;; True if the global is defined in the compile unit (not extern)
-  {  }*     ;; Reference to the global variable
-}
-
      -
      - -

      These descriptors provide debug information about globals variables. The -provide details such as name, type and where the variable is defined.

      - -
      - - -
      - Subprogram descriptors -
      - -
      - -
      -
      -!2 = metadata !{
-  i32,      ;; Tag = 46 + LLVMDebugVersion
-            ;; (DW_TAG_subprogram)
-  i32,      ;; Unused field.
-  metadata, ;; Reference to context descriptor
-  metadata, ;; Name
-  metadata, ;; Display name (fully qualified C++ name)
-  metadata, ;; MIPS linkage name (for C++)
-  metadata, ;; Reference to file where defined
-  i32,      ;; Line number where defined
-  metadata, ;; Reference to type descriptor
-  i1,       ;; True if the global is local to compile unit (static)
-  i1        ;; True if the global is defined in the compile unit (not extern)
-}
-
      -
      - -

      These descriptors provide debug information about functions, methods and - subprograms. They provide details such as name, return types and the source - location where the subprogram is defined.

      - -
      - - -
      - Block descriptors -
      - -
      - -
      -
      -!3 = metadata !{
-  i32,     ;; Tag = 13 + LLVMDebugVersion (DW_TAG_lexical_block)
-  metadata ;; Reference to context descriptor
-}
-
      -
      - -

      These descriptors provide debug information about nested blocks within a - subprogram. The array of member descriptors is used to define local - variables and deeper nested blocks.

      - -
      - - -
      - Basic type descriptors -
      - -
      - -
      -
      -!4 = metadata !{
-  i32,      ;; Tag = 36 + LLVMDebugVersion 
-            ;; (DW_TAG_base_type)
-  metadata, ;; Reference to context (typically a compile unit)
-  metadata, ;; Name (may be "" for anonymous types)
-  metadata, ;; Reference to file where defined (may be NULL)
-  i32,      ;; Line number where defined (may be 0)
-  i64,      ;; Size in bits
-  i64,      ;; Alignment in bits
-  i64,      ;; Offset in bits
-  i32,      ;; Flags
-  i32       ;; DWARF type encoding
-}
-
      -
      - -

      These descriptors define primitive types used in the code. Example int, bool - and float. The context provides the scope of the type, which is usually the - top level. Since basic types are not usually user defined the compile unit - and line number can be left as NULL and 0. The size, alignment and offset - are expressed in bits and can be 64 bit values. The alignment is used to - round the offset when embedded in a - composite type (example to keep float - doubles on 64 bit boundaries.) The offset is the bit offset if embedded in - a composite type.

      - -

      The type encoding provides the details of the type. The values are typically - one of the following:

      - -
      -
      -DW_ATE_address       = 1
-DW_ATE_boolean       = 2
-DW_ATE_float         = 4
-DW_ATE_signed        = 5
-DW_ATE_signed_char   = 6
-DW_ATE_unsigned      = 7
-DW_ATE_unsigned_char = 8
-
      -
      - -
      - - -
      - Derived type descriptors -
      - -
      - -
      -
      -!5 = metadata !{
-  i32,      ;; Tag (see below)
-  metadata, ;; Reference to context
-  metadata, ;; Name (may be "" for anonymous types)
-  metadata, ;; Reference to file where defined (may be NULL)
-  i32,      ;; Line number where defined (may be 0)
-  i32,      ;; Size in bits
-  i32,      ;; Alignment in bits
-  i32,      ;; Offset in bits
-  metadata  ;; Reference to type derived from
-}
-
      -
      - -

      These descriptors are used to define types derived from other types. The -value of the tag varies depending on the meaning. The following are possible -tag values:

      - -
      -
      -DW_TAG_formal_parameter = 5
-DW_TAG_member           = 13
-DW_TAG_pointer_type     = 15
-DW_TAG_reference_type   = 16
-DW_TAG_typedef          = 22
-DW_TAG_const_type       = 38
-DW_TAG_volatile_type    = 53
-DW_TAG_restrict_type    = 55
-
      -
      - -

      DW_TAG_member is used to define a member of - a composite type - or subprogram. The type of the member is - the derived - type. DW_TAG_formal_parameter is used to define a member which - is a formal argument of a subprogram.

      - -

      DW_TAG_typedef is used to provide a name for the derived type.

      - -

      DW_TAG_pointer_type,DW_TAG_reference_type, - DW_TAG_const_type, DW_TAG_volatile_type - and DW_TAG_restrict_type are used to qualify - the derived type.

      - -

      Derived type location can be determined - from the compile unit and line number. The size, alignment and offset are - expressed in bits and can be 64 bit values. The alignment is used to round - the offset when embedded in a composite - type (example to keep float doubles on 64 bit boundaries.) The offset is - the bit offset if embedded in a composite - type.

      - -

      Note that the void * type is expressed as a - llvm.dbg.derivedtype.type with tag of DW_TAG_pointer_type - and NULL derived type.

      - -
      - - -
      - Composite type descriptors -
      - -
      - -
      -
      -!6 = metadata !{
-  i32,      ;; Tag (see below)
-  metadata, ;; Reference to context
-  metadata, ;; Name (may be "" for anonymous types)
-  metadata, ;; Reference to file where defined (may be NULL)
-  i32,      ;; Line number where defined (may be 0)
-  i64,      ;; Size in bits
-  i64,      ;; Alignment in bits
-  i64,      ;; Offset in bits
-  i32,      ;; Flags
-  metadata, ;; Reference to type derived from
-  metadata, ;; Reference to array of member descriptors
-  i32       ;; Runtime languages
-}
-
      -
      - -

      These descriptors are used to define types that are composed of 0 or more -elements. The value of the tag varies depending on the meaning. The following -are possible tag values:

      - -
      -
      -DW_TAG_array_type       = 1
-DW_TAG_enumeration_type = 4
-DW_TAG_structure_type   = 19
-DW_TAG_union_type       = 23
-DW_TAG_vector_type      = 259
-DW_TAG_subroutine_type  = 21
-DW_TAG_inheritance      = 28
-
      -
      - -

      The vector flag indicates that an array type is a native packed vector.

      - -

      The members of array types (tag = DW_TAG_array_type) or vector types - (tag = DW_TAG_vector_type) are subrange - descriptors, each representing the range of subscripts at that level of - indexing.

      - -

      The members of enumeration types (tag = DW_TAG_enumeration_type) are - enumerator descriptors, each representing - the definition of enumeration value for the set.

      - -

      The members of structure (tag = DW_TAG_structure_type) or union (tag - = DW_TAG_union_type) types are any one of - the basic, - derived - or composite type descriptors, each - representing a field member of the structure or union.

      - -

      For C++ classes (tag = DW_TAG_structure_type), member descriptors - provide information about base classes, static members and member - functions. If a member is a derived type - descriptor and has a tag of DW_TAG_inheritance, then the type - represents a base class. If the member of is - a global variable descriptor then it - represents a static member. And, if the member is - a subprogram descriptor then it represents - a member function. For static members and member - functions, getName() returns the members link or the C++ mangled - name. getDisplayName() the simplied version of the name.

      - -

      The first member of subroutine (tag = DW_TAG_subroutine_type) type - elements is the return type for the subroutine. The remaining elements are - the formal arguments to the subroutine.

      - -

      Composite type location can be - determined from the compile unit and line number. The size, alignment and - offset are expressed in bits and can be 64 bit values. The alignment is used - to round the offset when embedded in - a composite type (as an example, to keep - float doubles on 64 bit boundaries.) The offset is the bit offset if embedded - in a composite type.

      - -
      - - -
      - Subrange descriptors -
      - -
      - -
      -
      -%llvm.dbg.subrange.type = type {
-  i32,    ;; Tag = 33 + LLVMDebugVersion (DW_TAG_subrange_type)
-  i64,    ;; Low value
-  i64     ;; High value
-}
-
      -
      - -

      These descriptors are used to define ranges of array subscripts for an array - composite type. The low value defines - the lower bounds typically zero for C/C++. The high value is the upper - bounds. Values are 64 bit. High - low + 1 is the size of the array. If low - == high the array will be unbounded.

      - -
      - - -
      - Enumerator descriptors -
      - -
      - -
      -
      -!6 = metadata !{
-  i32,      ;; Tag = 40 + LLVMDebugVersion 
-            ;; (DW_TAG_enumerator)
-  metadata, ;; Name
-  i64       ;; Value
-}
-
      -
      - -

      These descriptors are used to define members of an - enumeration composite type, it - associates the name to the value.

      - -
      - - -
      - Local variables -
      - -
      - -
      -
      -!7 = metadata !{
-  i32,      ;; Tag (see below)
-  metadata, ;; Context
-  metadata, ;; Name
-  metadata, ;; Reference to file where defined
-  i32,      ;; Line number where defined
-  metadata  ;; Type descriptor
-}
-
      -
      - -

      These descriptors are used to define variables local to a sub program. The - value of the tag depends on the usage of the variable:

      - -
      -
      -DW_TAG_auto_variable   = 256
-DW_TAG_arg_variable    = 257
-DW_TAG_return_variable = 258
-
      -
      - -

      An auto variable is any variable declared in the body of the function. An - argument variable is any variable that appears as a formal argument to the - function. A return variable is used to track the result of a function and - has no source correspondent.

      - -

      The context is either the subprogram or block where the variable is defined. - Name the source variable name. Compile unit and line indicate where the - variable was defined. Type descriptor defines the declared type of the - variable.

      - -
      - - -
      - Debugger intrinsic functions -
      - -
      - -

      LLVM uses several intrinsic functions (name prefixed with "llvm.dbg") to - provide debug information at various points in generated code.

      - -
      - - -
      - llvm.dbg.declare -
      - -
      -
      -  void %llvm.dbg.declare( { } *, metadata )
-
      - -

      This intrinsic provides information about a local element (ex. variable.) The - first argument is the alloca for the variable, cast to a { }*. The - second argument is - the %llvm.dbg.variable containing - the description of the variable.

      - -
      - - -
      - llvm.dbg.value -
      - -
      -
      -  void %llvm.dbg.value( metadata, i64, metadata )
-
      - -

      This intrinsic provides information when a user source variable is set to a - new value. The first argument is the new value (wrapped as metadata). The - second argument is the offset in the user source variable where the new value - is written. The third argument is - the %llvm.dbg.variable containing - the description of the user source variable.

      - -
      - - -
      - Object lifetimes and scoping -
      - -
      -

      In many languages, the local variables in functions can have their lifetimes - or scopes limited to a subset of a function. In the C family of languages, - for example, variables are only live (readable and writable) within the - source block that they are defined in. In functional languages, values are - only readable after they have been defined. Though this is a very obvious - concept, it is non-trivial to model in LLVM, because it has no notion of - scoping in this sense, and does not want to be tied to a language's scoping - rules.

      - -

      In order to handle this, the LLVM debug format uses the metadata attached to - llvm instructions to encode line number and scoping information. Consider - the following C fragment, for example:

      - -
      -
      -1.  void foo() {
-2.    int X = 21;
-3.    int Y = 22;
-4.    {
-5.      int Z = 23;
-6.      Z = X;
-7.    }
-8.    X = Y;
-9.  }
-
      -
      - -

      Compiled to LLVM, this function would be represented like this:

      - -
      -
      -define void @foo() nounwind ssp {
-entry:
-  %X = alloca i32, align 4                        ; <i32*> [#uses=4]
-  %Y = alloca i32, align 4                        ; <i32*> [#uses=4]
-  %Z = alloca i32, align 4                        ; <i32*> [#uses=3]
-  %0 = bitcast i32* %X to { }*                    ; <{ }*> [#uses=1]
-  call void @llvm.dbg.declare({ }* %0, metadata !0), !dbg !7
-  store i32 21, i32* %X, !dbg !8
-  %1 = bitcast i32* %Y to { }*                    ; <{ }*> [#uses=1]
-  call void @llvm.dbg.declare({ }* %1, metadata !9), !dbg !10
-  store i32 22, i32* %Y, !dbg !11
-  %2 = bitcast i32* %Z to { }*                    ; <{ }*> [#uses=1]
-  call void @llvm.dbg.declare({ }* %2, metadata !12), !dbg !14
-  store i32 23, i32* %Z, !dbg !15
-  %tmp = load i32* %X, !dbg !16                   ; <i32> [#uses=1]
-  %tmp1 = load i32* %Y, !dbg !16                  ; <i32> [#uses=1]
-  %add = add nsw i32 %tmp, %tmp1, !dbg !16        ; <i32> [#uses=1]
-  store i32 %add, i32* %Z, !dbg !16
-  %tmp2 = load i32* %Y, !dbg !17                  ; <i32> [#uses=1]
-  store i32 %tmp2, i32* %X, !dbg !17
-  ret void, !dbg !18
-}
-
-declare void @llvm.dbg.declare({ }*, metadata) nounwind readnone
-
-!0 = metadata !{i32 459008, metadata !1, metadata !"X", 
-                metadata !3, i32 2, metadata !6}; [ DW_TAG_auto_variable ]
-!1 = metadata !{i32 458763, metadata !2}; [DW_TAG_lexical_block ]
-!2 = metadata !{i32 458798, i32 0, metadata !3, metadata !"foo", metadata !"foo", 
-               metadata !"foo", metadata !3, i32 1, metadata !4, 
-               i1 false, i1 true}; [DW_TAG_subprogram ]
-!3 = metadata !{i32 458769, i32 0, i32 12, metadata !"foo.c", 
-                metadata !"/private/tmp", metadata !"clang 1.1", i1 true, 
-                i1 false, metadata !"", i32 0}; [DW_TAG_compile_unit ]
-!4 = metadata !{i32 458773, metadata !3, metadata !"", null, i32 0, i64 0, i64 0, 
-                i64 0, i32 0, null, metadata !5, i32 0}; [DW_TAG_subroutine_type ]
-!5 = metadata !{null}
-!6 = metadata !{i32 458788, metadata !3, metadata !"int", metadata !3, i32 0, 
-                i64 32, i64 32, i64 0, i32 0, i32 5}; [DW_TAG_base_type ]
-!7 = metadata !{i32 2, i32 7, metadata !1, null}
-!8 = metadata !{i32 2, i32 3, metadata !1, null}
-!9 = metadata !{i32 459008, metadata !1, metadata !"Y", metadata !3, i32 3, 
-                metadata !6}; [ DW_TAG_auto_variable ]
-!10 = metadata !{i32 3, i32 7, metadata !1, null}
-!11 = metadata !{i32 3, i32 3, metadata !1, null}
-!12 = metadata !{i32 459008, metadata !13, metadata !"Z", metadata !3, i32 5, 
-                 metadata !6}; [ DW_TAG_auto_variable ]
-!13 = metadata !{i32 458763, metadata !1}; [DW_TAG_lexical_block ]
-!14 = metadata !{i32 5, i32 9, metadata !13, null}
-!15 = metadata !{i32 5, i32 5, metadata !13, null}
-!16 = metadata !{i32 6, i32 5, metadata !13, null}
-!17 = metadata !{i32 8, i32 3, metadata !1, null}
-!18 = metadata !{i32 9, i32 1, metadata !2, null}
-
      -
      - -

      This example illustrates a few important details about LLVM debugging - information. In particular, it shows how the llvm.dbg.declare - intrinsic and location information, which are attached to an instruction, - are applied together to allow a debugger to analyze the relationship between - statements, variable definitions, and the code used to implement the - function.

      - -
      -
      -call void @llvm.dbg.declare({ }* %0, metadata !0), !dbg !7   
-
      -
      - -

      The first intrinsic - %llvm.dbg.declare - encodes debugging information for the variable X. The metadata - !dbg !7 attached to the intrinsic provides scope information for the - variable X.

      - -
      -
      -!7 = metadata !{i32 2, i32 7, metadata !1, null}
-!1 = metadata !{i32 458763, metadata !2}; [DW_TAG_lexical_block ]
-!2 = metadata !{i32 458798, i32 0, metadata !3, metadata !"foo", 
-                metadata !"foo", metadata !"foo", metadata !3, i32 1, 
-                metadata !4, i1 false, i1 true}; [DW_TAG_subprogram ]   
-
      -
      - -

      Here !7 is metadata providing location information. It has four - fields: line number, column number, scope, and original scope. The original - scope represents inline location if this instruction is inlined inside a - caller, and is null otherwise. In this example, scope is encoded by - !1. !1 represents a lexical block inside the scope - !2, where !2 is a - subprogram descriptor. This way the - location information attached to the intrinsics indicates that the - variable X is declared at line number 2 at a function level scope in - function foo.

      - -

      Now lets take another example.

      - -
      -
      -call void @llvm.dbg.declare({ }* %2, metadata !12), !dbg !14
-
      -
      - -

      The second intrinsic - %llvm.dbg.declare - encodes debugging information for variable Z. The metadata - !dbg !14 attached to the intrinsic provides scope information for - the variable Z.

      - -
      -
      -!13 = metadata !{i32 458763, metadata !1}; [DW_TAG_lexical_block ]
-!14 = metadata !{i32 5, i32 9, metadata !13, null}
-
      -
      - -

      Here !14 indicates that Z is declared at line number 5 and - column number 9 inside of lexical scope !13. The lexical scope - itself resides inside of lexical scope !1 described above.

      - -

      The scope information attached with each instruction provides a - straightforward way to find instructions covered by a scope.

      - -
      - - -
      - C/C++ front-end specific debug information -
      - - -
      - -

      The C and C++ front-ends represent information about the program in a format - that is effectively identical - to DWARF 3.0 in - terms of information content. This allows code generators to trivially - support native debuggers by generating standard dwarf information, and - contains enough information for non-dwarf targets to translate it as - needed.

      - -

      This section describes the forms used to represent C and C++ programs. Other - languages could pattern themselves after this (which itself is tuned to - representing programs in the same way that DWARF 3 does), or they could - choose to provide completely different forms if they don't fit into the DWARF - model. As support for debugging information gets added to the various LLVM - source-language front-ends, the information used should be documented - here.

      - -

      The following sections provide examples of various C/C++ constructs and the - debug information that would best describe those constructs.

      - -
      - - -
      - C/C++ source file information -
      - -
      - -

      Given the source files MySource.cpp and MyHeader.h located - in the directory /Users/mine/sources, the following code:

      - -
      -
      -#include "MyHeader.h"
-
-int main(int argc, char *argv[]) {
-  return 0;
-}
-
      -
      - -

      a C/C++ front-end would generate the following descriptors:

      - -
      -
      -...
-;;
-;; Define the compile unit for the main source file "/Users/mine/sources/MySource.cpp".
-;;
-!2 = metadata !{
-  i32 524305,    ;; Tag
-  i32 0,         ;; Unused
-  i32 4,         ;; Language Id
-  metadata !"MySource.cpp", 
-  metadata !"/Users/mine/sources", 
-  metadata !"4.2.1 (Based on Apple Inc. build 5649) (LLVM build 00)", 
-  i1 true,       ;; Main Compile Unit
-  i1 false,      ;; Optimized compile unit
-  metadata !"",  ;; Compiler flags
-  i32 0}         ;; Runtime version
-
-;;
-;; Define the file for the file "/Users/mine/sources/MySource.cpp".
-;;
-!1 = metadata !{
-  i32 524329,    ;; Tag
-  metadata !"MySource.cpp", 
-  metadata !"/Users/mine/sources", 
-  metadata !3    ;; Compile unit
-}
-
-;;
-;; Define the file for the file "/Users/mine/sources/Myheader.h"
-;;
-!3 = metadata !{
-  i32 524329,    ;; Tag
-  metadata !"Myheader.h"
-  metadata !"/Users/mine/sources", 
-  metadata !3    ;; Compile unit
-}
-
-...
-
      -
      - -

      llvm::Instruction provides easy access to metadata attached with an -instruction. One can extract line number information encoded in LLVM IR -using Instruction::getMetadata() and -DILocation::getLineNumber(). -

      - if (MDNode *N = I->getMetadata("dbg")) {  // Here I is an LLVM instruction
-   DILocation Loc(N);                      // DILocation is in DebugInfo.h
-   unsigned Line = Loc.getLineNumber();
-   StringRef File = Loc.getFilename();
-   StringRef Dir = Loc.getDirectory();
- }
-
      -
      - - -
      - C/C++ global variable information -
      - -
      - -

      Given an integer global variable declared as follows:

      - -
      -
      -int MyGlobal = 100;
-
      -
      - -

      a C/C++ front-end would generate the following descriptors:

      - -
      -
      -;;
-;; Define the global itself.
-;;
-%MyGlobal = global int 100
-...
-;;
-;; List of debug info of globals
-;;
-!llvm.dbg.gv = !{!0}
-
-;;
-;; Define the global variable descriptor.  Note the reference to the global
-;; variable anchor and the global variable itself.
-;;
-!0 = metadata !{
-  i32 524340,              ;; Tag
-  i32 0,                   ;; Unused
-  metadata !1,             ;; Context
-  metadata !"MyGlobal",    ;; Name
-  metadata !"MyGlobal",    ;; Display Name
-  metadata !"MyGlobal",    ;; Linkage Name
-  metadata !3,             ;; Compile Unit
-  i32 1,                   ;; Line Number
-  metadata !4,             ;; Type
-  i1 false,                ;; Is a local variable
-  i1 true,                 ;; Is this a definition
-  i32* @MyGlobal           ;; The global variable
-}
-
-;;
-;; Define the basic type of 32 bit signed integer.  Note that since int is an
-;; intrinsic type the source file is NULL and line 0.
-;;    
-!4 = metadata !{
-  i32 524324,              ;; Tag
-  metadata !1,             ;; Context
-  metadata !"int",         ;; Name
-  metadata !1,             ;; File
-  i32 0,                   ;; Line number
-  i64 32,                  ;; Size in Bits
-  i64 32,                  ;; Align in Bits
-  i64 0,                   ;; Offset in Bits
-  i32 0,                   ;; Flags
-  i32 5                    ;; Encoding
-}
-
-
      -
      - -
      - - -
      - C/C++ function information -
      - -
      - -

      Given a function declared as follows:

      - -
      -
      -int main(int argc, char *argv[]) {
-  return 0;
-}
-
      -
      - -

      a C/C++ front-end would generate the following descriptors:

      - -
      -
      -;;
-;; Define the anchor for subprograms.  Note that the second field of the
-;; anchor is 46, which is the same as the tag for subprograms
-;; (46 = DW_TAG_subprogram.)
-;;
-!6 = metadata !{
-  i32 524334,        ;; Tag
-  i32 0,             ;; Unused
-  metadata !1,       ;; Context
-  metadata !"main",  ;; Name
-  metadata !"main",  ;; Display name
-  metadata !"main",  ;; Linkage name
-  metadata !1,       ;; File
-  i32 1,             ;; Line number
-  metadata !4,       ;; Type
-  i1 false,          ;; Is local 
-  i1 true            ;; Is definition
-}
-;;
-;; Define the subprogram itself.
-;;
-define i32 @main(i32 %argc, i8** %argv) {
-...
-}
-
      -
      - -
      - - -
      - C/C++ basic types -
      - -
      - -

      The following are the basic type descriptors for C/C++ core types:

      - -
      - - -
      - bool -
      - -
      - -
      -
      -!2 = metadata !{
-  i32 524324,        ;; Tag
-  metadata !1,       ;; Context
-  metadata !"bool",  ;; Name
-  metadata !1,       ;; File
-  i32 0,             ;; Line number
-  i64 8,             ;; Size in Bits
-  i64 8,             ;; Align in Bits
-  i64 0,             ;; Offset in Bits
-  i32 0,             ;; Flags
-  i32 2              ;; Encoding
-}
-
      -
      - -
      - - -
      - char -
      - -
      - -
      -
      -!2 = metadata !{
-  i32 524324,        ;; Tag
-  metadata !1,       ;; Context
-  metadata !"char",  ;; Name
-  metadata !1,       ;; File
-  i32 0,             ;; Line number
-  i64 8,             ;; Size in Bits
-  i64 8,             ;; Align in Bits
-  i64 0,             ;; Offset in Bits
-  i32 0,             ;; Flags
-  i32 6              ;; Encoding
-}
-
      -
      - -
      - - -
      - unsigned char -
      - -
      - -
      -
      -!2 = metadata !{
-  i32 524324,        ;; Tag
-  metadata !1,       ;; Context
-  metadata !"unsigned char", 
-  metadata !1,       ;; File
-  i32 0,             ;; Line number
-  i64 8,             ;; Size in Bits
-  i64 8,             ;; Align in Bits
-  i64 0,             ;; Offset in Bits
-  i32 0,             ;; Flags
-  i32 8              ;; Encoding
-}
-
      -
      - -
      - - -
      - short -
      - -
      - -
      -
      -!2 = metadata !{
-  i32 524324,        ;; Tag
-  metadata !1,       ;; Context
-  metadata !"short int",
-  metadata !1,       ;; File
-  i32 0,             ;; Line number
-  i64 16,            ;; Size in Bits
-  i64 16,            ;; Align in Bits
-  i64 0,             ;; Offset in Bits
-  i32 0,             ;; Flags
-  i32 5              ;; Encoding
-}
-
      -
      - -
      - - -
      - unsigned short -
      - -
      - -
      -
      -!2 = metadata !{
-  i32 524324,        ;; Tag
-  metadata !1,       ;; Context
-  metadata !"short unsigned int",
-  metadata !1,       ;; File
-  i32 0,             ;; Line number
-  i64 16,            ;; Size in Bits
-  i64 16,            ;; Align in Bits
-  i64 0,             ;; Offset in Bits
-  i32 0,             ;; Flags
-  i32 7              ;; Encoding
-}
-
      -
      - -
      - - -
      - int -
      - -
      - -
      -
      -!2 = metadata !{
-  i32 524324,        ;; Tag
-  metadata !1,       ;; Context
-  metadata !"int",   ;; Name
-  metadata !1,       ;; File
-  i32 0,             ;; Line number
-  i64 32,            ;; Size in Bits
-  i64 32,            ;; Align in Bits
-  i64 0,             ;; Offset in Bits
-  i32 0,             ;; Flags
-  i32 5              ;; Encoding
-}
-
      - -
      - - -
      - unsigned int -
      - -
      - -
      -
      -!2 = metadata !{
-  i32 524324,        ;; Tag
-  metadata !1,       ;; Context
-  metadata !"unsigned int",
-  metadata !1,       ;; File
-  i32 0,             ;; Line number
-  i64 32,            ;; Size in Bits
-  i64 32,            ;; Align in Bits
-  i64 0,             ;; Offset in Bits
-  i32 0,             ;; Flags
-  i32 7              ;; Encoding
-}
-
      -
      - -
      - - -
      - long long -
      - -
      - -
      -
      -!2 = metadata !{
-  i32 524324,        ;; Tag
-  metadata !1,       ;; Context
-  metadata !"long long int",
-  metadata !1,       ;; File
-  i32 0,             ;; Line number
-  i64 64,            ;; Size in Bits
-  i64 64,            ;; Align in Bits
-  i64 0,             ;; Offset in Bits
-  i32 0,             ;; Flags
-  i32 5              ;; Encoding
-}
-
      -
      - -
      - - -
      - unsigned long long -
      - -
      - -
      -
      -!2 = metadata !{
-  i32 524324,        ;; Tag
-  metadata !1,       ;; Context
-  metadata !"long long unsigned int",
-  metadata !1,       ;; File
-  i32 0,             ;; Line number
-  i64 64,            ;; Size in Bits
-  i64 64,            ;; Align in Bits
-  i64 0,             ;; Offset in Bits
-  i32 0,             ;; Flags
-  i32 7              ;; Encoding
-}
-
      -
      - -
      - - -
      - float -
      - -
      - -
      -
      -!2 = metadata !{
-  i32 524324,        ;; Tag
-  metadata !1,       ;; Context
-  metadata !"float",
-  metadata !1,       ;; File
-  i32 0,             ;; Line number
-  i64 32,            ;; Size in Bits
-  i64 32,            ;; Align in Bits
-  i64 0,             ;; Offset in Bits
-  i32 0,             ;; Flags
-  i32 4              ;; Encoding
-}
-
      -
      - -
      - - -
      - double -
      - -
      - -
      -
      -!2 = metadata !{
-  i32 524324,        ;; Tag
-  metadata !1,       ;; Context
-  metadata !"double",;; Name
-  metadata !1,       ;; File
-  i32 0,             ;; Line number
-  i64 64,            ;; Size in Bits
-  i64 64,            ;; Align in Bits
-  i64 0,             ;; Offset in Bits
-  i32 0,             ;; Flags
-  i32 4              ;; Encoding
-}
-
      -
      - -
      - - -
      - C/C++ derived types -
      - -
      - -

      Given the following as an example of C/C++ derived type:

      - -
      -
      -typedef const int *IntPtr;
-
      -
      - -

      a C/C++ front-end would generate the following descriptors:

      - -
      -
      -;;
-;; Define the typedef "IntPtr".
-;;
-!2 = metadata !{
-  i32 524310,          ;; Tag
-  metadata !1,         ;; Context
-  metadata !"IntPtr",  ;; Name
-  metadata !3,         ;; File
-  i32 0,               ;; Line number
-  i64 0,               ;; Size in bits
-  i64 0,               ;; Align in bits
-  i64 0,               ;; Offset in bits
-  i32 0,               ;; Flags
-  metadata !4          ;; Derived From type
-}
-
-;;
-;; Define the pointer type.
-;;
-!4 = metadata !{
-  i32 524303,          ;; Tag
-  metadata !1,         ;; Context
-  metadata !"",        ;; Name
-  metadata !1,         ;; File
-  i32 0,               ;; Line number
-  i64 64,              ;; Size in bits
-  i64 64,              ;; Align in bits
-  i64 0,               ;; Offset in bits
-  i32 0,               ;; Flags
-  metadata !5          ;; Derived From type
-}
-;;
-;; Define the const type.
-;;
-!5 = metadata !{
-  i32 524326,          ;; Tag
-  metadata !1,         ;; Context
-  metadata !"",        ;; Name
-  metadata !1,         ;; File
-  i32 0,               ;; Line number
-  i64 32,              ;; Size in bits
-  i64 32,              ;; Align in bits
-  i64 0,               ;; Offset in bits
-  i32 0,               ;; Flags
-  metadata !6          ;; Derived From type
-}
-;;
-;; Define the int type.
-;;
-!6 = metadata !{
-  i32 524324,          ;; Tag
-  metadata !1,         ;; Context
-  metadata !"int",     ;; Name
-  metadata !1,         ;; File
-  i32 0,               ;; Line number
-  i64 32,              ;; Size in bits
-  i64 32,              ;; Align in bits
-  i64 0,               ;; Offset in bits
-  i32 0,               ;; Flags
-  5                    ;; Encoding
-}
-
      -
      - -
      - - -
      - C/C++ struct/union types -
      - -
      - -

      Given the following as an example of C/C++ struct type:

      - -
      -
      -struct Color {
-  unsigned Red;
-  unsigned Green;
-  unsigned Blue;
-};
-
      -
      - -

      a C/C++ front-end would generate the following descriptors:

      - -
      -
      -;;
-;; Define basic type for unsigned int.
-;;
-!5 = metadata !{
-  i32 524324,        ;; Tag
-  metadata !1,       ;; Context
-  metadata !"unsigned int",
-  metadata !1,       ;; File
-  i32 0,             ;; Line number
-  i64 32,            ;; Size in Bits
-  i64 32,            ;; Align in Bits
-  i64 0,             ;; Offset in Bits
-  i32 0,             ;; Flags
-  i32 7              ;; Encoding
-}
-;;
-;; Define composite type for struct Color.
-;;
-!2 = metadata !{
-  i32 524307,        ;; Tag
-  metadata !1,       ;; Context
-  metadata !"Color", ;; Name
-  metadata !1,       ;; Compile unit
-  i32 1,             ;; Line number
-  i64 96,            ;; Size in bits
-  i64 32,            ;; Align in bits
-  i64 0,             ;; Offset in bits
-  i32 0,             ;; Flags
-  null,              ;; Derived From
-  metadata !3,       ;; Elements
-  i32 0              ;; Runtime Language
-}
-
-;;
-;; Define the Red field.
-;;
-!4 = metadata !{
-  i32 524301,        ;; Tag
-  metadata !1,       ;; Context
-  metadata !"Red",   ;; Name
-  metadata !1,       ;; File
-  i32 2,             ;; Line number
-  i64 32,            ;; Size in bits
-  i64 32,            ;; Align in bits
-  i64 0,             ;; Offset in bits
-  i32 0,             ;; Flags
-  metadata !5        ;; Derived From type
-}
-
-;;
-;; Define the Green field.
-;;
-!6 = metadata !{
-  i32 524301,        ;; Tag
-  metadata !1,       ;; Context
-  metadata !"Green", ;; Name
-  metadata !1,       ;; File
-  i32 3,             ;; Line number
-  i64 32,            ;; Size in bits
-  i64 32,            ;; Align in bits
-  i64 32,             ;; Offset in bits
-  i32 0,             ;; Flags
-  metadata !5        ;; Derived From type
-}
-
-;;
-;; Define the Blue field.
-;;
-!7 = metadata !{
-  i32 524301,        ;; Tag
-  metadata !1,       ;; Context
-  metadata !"Blue",  ;; Name
-  metadata !1,       ;; File
-  i32 4,             ;; Line number
-  i64 32,            ;; Size in bits
-  i64 32,            ;; Align in bits
-  i64 64,             ;; Offset in bits
-  i32 0,             ;; Flags
-  metadata !5        ;; Derived From type
-}
-
-;;
-;; Define the array of fields used by the composite type Color.
-;;
-!3 = metadata !{metadata !4, metadata !6, metadata !7}
-
      -
      - -
      - - -
      - C/C++ enumeration types -
      - -
      - -

      Given the following as an example of C/C++ enumeration type:

      - -
      -
      -enum Trees {
-  Spruce = 100,
-  Oak = 200,
-  Maple = 300
-};
-
      -
      - -

      a C/C++ front-end would generate the following descriptors:

      - -
      -
      -;;
-;; Define composite type for enum Trees
-;;
-!2 = metadata !{
-  i32 524292,        ;; Tag
-  metadata !1,       ;; Context
-  metadata !"Trees", ;; Name
-  metadata !1,       ;; File
-  i32 1,             ;; Line number
-  i64 32,            ;; Size in bits
-  i64 32,            ;; Align in bits
-  i64 0,             ;; Offset in bits
-  i32 0,             ;; Flags
-  null,              ;; Derived From type
-  metadata !3,       ;; Elements
-  i32 0              ;; Runtime language
-}
-
-;;
-;; Define the array of enumerators used by composite type Trees.
-;;
-!3 = metadata !{metadata !4, metadata !5, metadata !6}
-
-;;
-;; Define Spruce enumerator.
-;;
-!4 = metadata !{i32 524328, metadata !"Spruce", i64 100}
-
-;;
-;; Define Oak enumerator.
-;;
-!5 = metadata !{i32 524328, metadata !"Oak", i64 200}
-
-;;
-;; Define Maple enumerator.
-;;
-!6 = metadata !{i32 524328, metadata !"Maple", i64 300}
-
-
      -
      - -
      - - - -
      -
      - Valid CSS - Valid HTML 4.01 - - Chris Lattner
      - LLVM Compiler Infrastructure
      - Last modified: $Date$ -
      - - - Removed: llvm/trunk/docs/SystemLibrary.html URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/SystemLibrary.html?rev=103212&view=auto ============================================================================== --- llvm/trunk/docs/SystemLibrary.html (original) +++ llvm/trunk/docs/SystemLibrary.html (removed) @@ -1,319 +0,0 @@ - - - - System Library - - - - -
      System Library
      - - -
      -

      Written by Reid Spencer

      -
      - - - -
      Abstract
      -
      -

      This document provides some details on LLVM's System Library, located in - the source at lib/System and include/llvm/System. The - library's purpose is to shield LLVM from the differences between operating - systems for the few services LLVM needs from the operating system. Much of - LLVM is written using portability features of standard C++. However, in a few - areas, system dependent facilities are needed and the System Library is the - wrapper around those system calls.

      -

      By centralizing LLVM's use of operating system interfaces, we make it - possible for the LLVM tool chain and runtime libraries to be more easily - ported to new platforms since (theoretically) only lib/System needs - to be ported. This library also unclutters the rest of LLVM from #ifdef use - and special cases for specific operating systems. Such uses are replaced - with simple calls to the interfaces provided in include/llvm/System. -

      -

      Note that the System Library is not intended to be a complete operating - system wrapper (such as the Adaptive Communications Environment (ACE) or - Apache Portable Runtime (APR)), but only provides the functionality necessary - to support LLVM. -

      The System Library was written by Reid Spencer who formulated the - design based on similar work originating from the eXtensible Programming - System (XPS). Several people helped with the effort; especially, - Jeff Cohen and Henrik Bach on the Win32 port.

      -
      - - -
      - Keeping LLVM Portable -
      -
      -

      In order to keep LLVM portable, LLVM developers should adhere to a set of - portability rules associated with the System Library. Adherence to these rules - should help the System Library achieve its goal of shielding LLVM from the - variations in operating system interfaces and doing so efficiently. The - following sections define the rules needed to fulfill this objective.

      -
      - - -
      Don't Include System Headers -
      -
      -

      Except in lib/System, no LLVM source code should directly - #include a system header. Care has been taken to remove all such - #includes from LLVM while lib/System was being - developed. Specifically this means that header files like "unistd.h", - "windows.h", "stdio.h", and "string.h" are forbidden to be included by LLVM - source code outside the implementation of lib/System.

      -

      To obtain system-dependent functionality, existing interfaces to the system - found in include/llvm/System should be used. If an appropriate - interface is not available, it should be added to include/llvm/System - and implemented in lib/System for all supported platforms.

      -
      - - -
      Don't Expose System Headers -
      -
      -

      The System Library must shield LLVM from all system headers. To - obtain system level functionality, LLVM source must - #include "llvm/System/Thing.h" and nothing else. This means that - Thing.h cannot expose any system header files. This protects LLVM - from accidentally using system specific functionality and only allows it - via the lib/System interface.

      -
      - - -
      Use Standard C Headers
      -
      -

      The standard C headers (the ones beginning with "c") are allowed - to be exposed through the lib/System interface. These headers and - the things they declare are considered to be platform agnostic. LLVM source - files may include them directly or obtain their inclusion through - lib/System interfaces.

      -
      - - -
      Use Standard C++ Headers -
      -
      -

      The standard C++ headers from the standard C++ library and - standard template library may be exposed through the lib/System - interface. These headers and the things they declare are considered to be - platform agnostic. LLVM source files may include them or obtain their - inclusion through lib/System interfaces.

      -
      - - -
      High Level Interface
      -
      -

      The entry points specified in the interface of lib/System must be aimed at - completing some reasonably high level task needed by LLVM. We do not want to - simply wrap each operating system call. It would be preferable to wrap several - operating system calls that are always used in conjunction with one another by - LLVM.

      -

      For example, consider what is needed to execute a program, wait for it to - complete, and return its result code. On Unix, this involves the following - operating system calls: getenv, fork, execve, and wait. The - correct thing for lib/System to provide is a function, say - ExecuteProgramAndWait, that implements the functionality completely. - what we don't want is wrappers for the operating system calls involved.

      -

      There must not be a one-to-one relationship between operating - system calls and the System library's interface. Any such interface function - will be suspicious.

      -
      - - -
      No Unused Functionality
      -
      -

      There must be no functionality specified in the interface of lib/System - that isn't actually used by LLVM. We're not writing a general purpose - operating system wrapper here, just enough to satisfy LLVM's needs. And, LLVM - doesn't need much. This design goal aims to keep the lib/System interface - small and understandable which should foster its actual use and adoption.

      -
      - - -
      No Duplicate Implementations -
      -
      -

      The implementation of a function for a given platform must be written - exactly once. This implies that it must be possible to apply a function's - implementation to multiple operating systems if those operating systems can - share the same implementation. This rule applies to the set of operating - systems supported for a given class of operating system (e.g. Unix, Win32). -

      -
      - - -
      No Virtual Methods
      -
      -

      The System Library interfaces can be called quite frequently by LLVM. In - order to make those calls as efficient as possible, we discourage the use of - virtual methods. There is no need to use inheritance for implementation - differences, it just adds complexity. The #include mechanism works - just fine.

      -
      - - -
      No Exposed Functions
      -
      -

      Any functions defined by system libraries (i.e. not defined by lib/System) - must not be exposed through the lib/System interface, even if the header file - for that function is not exposed. This prevents inadvertent use of system - specific functionality.

      -

      For example, the stat system call is notorious for having - variations in the data it provides. lib/System must not declare - stat nor allow it to be declared. Instead it should provide its own - interface to discovering information about files and directories. Those - interfaces may be implemented in terms of stat but that is strictly - an implementation detail. The interface provided by the System Library must - be implemented on all platforms (even those without stat).

      -
      - - -
      No Exposed Data
      -
      -

      Any data defined by system libraries (i.e. not defined by lib/System) must - not be exposed through the lib/System interface, even if the header file for - that function is not exposed. As with functions, this prevents inadvertent use - of data that might not exist on all platforms.

      -
      - - -
      Minimize Soft Errors
      -
      -

      Operating system interfaces will generally provide error results for every - little thing that could go wrong. In almost all cases, you can divide these - error results into two groups: normal/good/soft and abnormal/bad/hard. That - is, some of the errors are simply information like "file not found", - "insufficient privileges", etc. while other errors are much harder like - "out of space", "bad disk sector", or "system call interrupted". We'll call - the first group "soft" errors and the second group "hard" - errors.

      -

      lib/System must always attempt to minimize soft errors. - This is a design requirement because the - minimization of soft errors can affect the granularity and the nature of the - interface. In general, if you find that you're wanting to throw soft errors, - you must review the granularity of the interface because it is likely you're - trying to implement something that is too low level. The rule of thumb is to - provide interface functions that can't fail, except when faced with - hard errors.

      -

      For a trivial example, suppose we wanted to add an "OpenFileForWriting" - function. For many operating systems, if the file doesn't exist, attempting - to open the file will produce an error. However, lib/System should not - simply throw that error if it occurs because its a soft error. The problem - is that the interface function, OpenFileForWriting is too low level. It should - be OpenOrCreateFileForWriting. In the case of the soft "doesn't exist" error, - this function would just create it and then open it for writing.

      -

      This design principle needs to be maintained in lib/System because it - avoids the propagation of soft error handling throughout the rest of LLVM. - Hard errors will generally just cause a termination for an LLVM tool so don't - be bashful about throwing them.

      -

      Rules of thumb:

      -
        -
      1. Don't throw soft errors, only hard errors.
        2. -
      2. If you're tempted to throw a soft error, re-think the interface.
        3. -
      3. Handle internally the most common normal/good/soft error conditions - so the rest of LLVM doesn't have to.
        4. -
      -
      - - -
      No throw Specifications -
      -
      -

      None of the lib/System interface functions may be declared with C++ - throw() specifications on them. This requirement makes sure that the - compiler does not insert additional exception handling code into the interface - functions. This is a performance consideration: lib/System functions are at - the bottom of many call chains and as such can be frequently called. We - need them to be as efficient as possible. However, no routines in the - system library should actually throw exceptions.

      -
      - - -
      Code Organization
      -
      -

      Implementations of the System Library interface are separated by their - general class of operating system. Currently only Unix and Win32 classes are - defined but more could be added for other operating system classifications. - To distinguish which implementation to compile, the code in lib/System uses - the LLVM_ON_UNIX and LLVM_ON_WIN32 #defines provided via configure through the - llvm/Config/config.h file. Each source file in lib/System, after implementing - the generic (operating system independent) functionality needs to include the - correct implementation using a set of #if defined(LLVM_ON_XYZ) - directives. For example, if we had lib/System/File.cpp, we'd expect to see in - that file:

      - 
      
-  #if defined(LLVM_ON_UNIX)
-  #include "Unix/File.cpp"
-  #endif
-  #if defined(LLVM_ON_WIN32)
-  #include "Win32/File.cpp"
-  #endif
-
      -

      The implementation in lib/System/Unix/File.cpp should handle all Unix - variants. The implementation in lib/System/Win32/File.cpp should handle all - Win32 variants. What this does is quickly differentiate the basic class of - operating system that will provide the implementation. The specific details - for a given platform must still be determined through the use of - #ifdef.

      -
      - - -
      Consistent Semantics
      -
      -

      The implementation of a lib/System interface can vary drastically between - platforms. That's okay as long as the end result of the interface function - is the same. For example, a function to create a directory is pretty straight - forward on all operating system. System V IPC on the other hand isn't even - supported on all platforms. Instead of "supporting" System V IPC, lib/System - should provide an interface to the basic concept of inter-process - communications. The implementations might use System V IPC if that was - available or named pipes, or whatever gets the job done effectively for a - given operating system. In all cases, the interface and the implementation - must be semantically consistent.

      -
      - - -
      Bug 351
      -
      -

      See bug 351 - for further details on the progress of this work

      -
      - - - -
      -
      - Valid CSS - Valid HTML 4.01 - - Reid Spencer
      - LLVM Compiler Infrastructure
      - Last modified: $Date$ -
      - - Removed: llvm/trunk/docs/TableGenFundamentals.html URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/TableGenFundamentals.html?rev=103212&view=auto ============================================================================== --- llvm/trunk/docs/TableGenFundamentals.html (original) +++ llvm/trunk/docs/TableGenFundamentals.html (removed) @@ -1,802 +0,0 @@ - - - - TableGen Fundamentals - - - - -
      TableGen Fundamentals
      - -
      - -
      - -
      -

      Written by Chris Lattner

      -
      - - -
      Introduction
      - - -
      - -

      TableGen's purpose is to help a human develop and maintain records of -domain-specific information. Because there may be a large number of these -records, it is specifically designed to allow writing flexible descriptions and -for common features of these records to be factored out. This reduces the -amount of duplication in the description, reduces the chance of error, and -makes it easier to structure domain specific information.

      - -

      The core part of TableGen parses a file, instantiates -the declarations, and hands the result off to a domain-specific "TableGen backend" for processing. The current major user -of TableGen is the LLVM code generator.

      - -

      Note that if you work on TableGen much, and use emacs or vim, that you can -find an emacs "TableGen mode" and a vim language file in the -llvm/utils/emacs and llvm/utils/vim directories of your LLVM -distribution, respectively.

      - -
      - - -
      Basic concepts
      - -
      - -

      TableGen files consist of two key parts: 'classes' and 'definitions', both -of which are considered 'records'.

      - -

      TableGen records have a unique name, a list of values, and a list of -superclasses. The list of values is the main data that TableGen builds for each -record; it is this that holds the domain specific information for the -application. The interpretation of this data is left to a specific TableGen backend, but the structure and format rules are -taken care of and are fixed by TableGen.

      - -

      TableGen definitions are the concrete form of 'records'. These -generally do not have any undefined values, and are marked with the -'def' keyword.

      - -

      TableGen classes are abstract records that are used to build and -describe other records. These 'classes' allow the end-user to build -abstractions for either the domain they are targeting (such as "Register", -"RegisterClass", and "Instruction" in the LLVM code generator) or for the -implementor to help factor out common properties of records (such as "FPInst", -which is used to represent floating point instructions in the X86 backend). -TableGen keeps track of all of the classes that are used to build up a -definition, so the backend can find all definitions of a particular class, such -as "Instruction".

      - -

      TableGen multiclasses are groups of abstract records that are -instantiated all at once. Each instantiation can result in multiple -TableGen definitions. If a multiclass inherits from another multiclass, -the definitions in the sub-multiclass become part of the current -multiclass, as if they were declared in the current multiclass.

      - -
      - - -
      An example record
      - -
      - -

      With no other arguments, TableGen parses the specified file and prints out -all of the classes, then all of the definitions. This is a good way to see what -the various definitions expand to fully. Running this on the X86.td -file prints this (at the time of this writing):

      - -
      -
      -...
-def ADD32rr {   // Instruction X86Inst I
-  string Namespace = "X86";
-  dag OutOperandList = (outs GR32:$dst);
-  dag InOperandList = (ins GR32:$src1, GR32:$src2);
-  string AsmString = "add{l}\t{$src2, $dst|$dst, $src2}";
-  list<dag> Pattern = [(set GR32:$dst, (add GR32:$src1, GR32:$src2))];
-  list<Register> Uses = [];
-  list<Register> Defs = [EFLAGS];
-  list<Predicate> Predicates = [];
-  int CodeSize = 3;
-  int AddedComplexity = 0;
-  bit isReturn = 0;
-  bit isBranch = 0;
-  bit isIndirectBranch = 0;
-  bit isBarrier = 0;
-  bit isCall = 0;
-  bit canFoldAsLoad = 0;
-  bit mayLoad = 0;
-  bit mayStore = 0;
-  bit isImplicitDef = 0;
-  bit isTwoAddress = 1;
-  bit isConvertibleToThreeAddress = 1;
-  bit isCommutable = 1;
-  bit isTerminator = 0;
-  bit isReMaterializable = 0;
-  bit isPredicable = 0;
-  bit hasDelaySlot = 0;
-  bit usesCustomInserter = 0;
-  bit hasCtrlDep = 0;
-  bit isNotDuplicable = 0;
-  bit hasSideEffects = 0;
-  bit neverHasSideEffects = 0;
-  InstrItinClass Itinerary = NoItinerary;
-  string Constraints = "";
-  string DisableEncoding = "";
-  bits<8> Opcode = { 0, 0, 0, 0, 0, 0, 0, 1 };
-  Format Form = MRMDestReg;
-  bits<6> FormBits = { 0, 0, 0, 0, 1, 1 };
-  ImmType ImmT = NoImm;
-  bits<3> ImmTypeBits = { 0, 0, 0 };
-  bit hasOpSizePrefix = 0;
-  bit hasAdSizePrefix = 0;
-  bits<4> Prefix = { 0, 0, 0, 0 };
-  bit hasREX_WPrefix = 0;
-  FPFormat FPForm = ?;
-  bits<3> FPFormBits = { 0, 0, 0 };
-}
-...
-
      -
      - -

      This definition corresponds to a 32-bit register-register add instruction in -the X86. The string after the 'def' string indicates the name of the -record—"ADD32rr" in this case—and the comment at the end of -the line indicates the superclasses of the definition. The body of the record -contains all of the data that TableGen assembled for the record, indicating that -the instruction is part of the "X86" namespace, the pattern indicating how the -the instruction should be emitted into the assembly file, that it is a -two-address instruction, has a particular encoding, etc. The contents and -semantics of the information in the record is specific to the needs of the X86 -backend, and is only shown as an example.

      - -

      As you can see, a lot of information is needed for every instruction -supported by the code generator, and specifying it all manually would be -unmaintainable, prone to bugs, and tiring to do in the first place. Because we -are using TableGen, all of the information was derived from the following -definition:

      - -
      -
      -let Defs = [EFLAGS],
-    isCommutable = 1,                  // X = ADD Y,Z --> X = ADD Z,Y
-    isConvertibleToThreeAddress = 1 in // Can transform into LEA.
-def ADD32rr  : I<0x01, MRMDestReg, (outs GR32:$dst),
-                                   (ins GR32:$src1, GR32:$src2),
-                 "add{l}\t{$src2, $dst|$dst, $src2}",
-                 [(set GR32:$dst, (add GR32:$src1, GR32:$src2))]>;
-
      -
      - -

      This definition makes use of the custom class I (extended from the -custom class X86Inst), which is defined in the X86-specific TableGen -file, to factor out the common features that instructions of its class share. A -key feature of TableGen is that it allows the end-user to define the -abstractions they prefer to use when describing their information.

      - -
      - - -
      Running TableGen
      - -
      - -

      TableGen runs just like any other LLVM tool. The first (optional) argument -specifies the file to read. If a filename is not specified, tblgen -reads from standard input.

      - -

      To be useful, one of the TableGen backends must be -used. These backends are selectable on the command line (type 'tblgen --help' for a list). For example, to get a list of all of the definitions -that subclass a particular type (which can be useful for building up an enum -list of these records), use the -print-enums option:

      - -
      -
      -$ tblgen X86.td -print-enums -class=Register
-AH, AL, AX, BH, BL, BP, BPL, BX, CH, CL, CX, DH, DI, DIL, DL, DX, EAX, EBP, EBX,
-ECX, EDI, EDX, EFLAGS, EIP, ESI, ESP, FP0, FP1, FP2, FP3, FP4, FP5, FP6, IP,
-MM0, MM1, MM2, MM3, MM4, MM5, MM6, MM7, R10, R10B, R10D, R10W, R11, R11B, R11D,
-R11W, R12, R12B, R12D, R12W, R13, R13B, R13D, R13W, R14, R14B, R14D, R14W, R15,
-R15B, R15D, R15W, R8, R8B, R8D, R8W, R9, R9B, R9D, R9W, RAX, RBP, RBX, RCX, RDI,
-RDX, RIP, RSI, RSP, SI, SIL, SP, SPL, ST0, ST1, ST2, ST3, ST4, ST5, ST6, ST7,
-XMM0, XMM1, XMM10, XMM11, XMM12, XMM13, XMM14, XMM15, XMM2, XMM3, XMM4, XMM5,
-XMM6, XMM7, XMM8, XMM9,
-
-$ tblgen X86.td -print-enums -class=Instruction 
-ABS_F, ABS_Fp32, ABS_Fp64, ABS_Fp80, ADC32mi, ADC32mi8, ADC32mr, ADC32ri,
-ADC32ri8, ADC32rm, ADC32rr, ADC64mi32, ADC64mi8, ADC64mr, ADC64ri32, ADC64ri8,
-ADC64rm, ADC64rr, ADD16mi, ADD16mi8, ADD16mr, ADD16ri, ADD16ri8, ADD16rm,
-ADD16rr, ADD32mi, ADD32mi8, ADD32mr, ADD32ri, ADD32ri8, ADD32rm, ADD32rr,
-ADD64mi32, ADD64mi8, ADD64mr, ADD64ri32, ...
-
      -
      - -

      The default backend prints out all of the records, as described above.

      - -

      If you plan to use TableGen, you will most likely have to write a backend that extracts the information specific to -what you need and formats it in the appropriate way.

      - -
      - - - -
      TableGen syntax
      - - -
      - -

      TableGen doesn't care about the meaning of data (that is up to the backend to -define), but it does care about syntax, and it enforces a simple type system. -This section describes the syntax and the constructs allowed in a TableGen file. -

      - -
      - - -
      TableGen primitives
      - - -
      TableGen comments
      - -
      - -

      TableGen supports BCPL style "//" comments, which run to the end of -the line, and it also supports nestable "/* */" comments.

      - -
      - - -
      - The TableGen type system -
      - -
      - -

      TableGen files are strongly typed, in a simple (but complete) type-system. -These types are used to perform automatic conversions, check for errors, and to -help interface designers constrain the input that they allow. Every value definition is required to have an associated type. -

      - -

      TableGen supports a mixture of very low-level types (such as bit) -and very high-level types (such as dag). This flexibility is what -allows it to describe a wide range of information conveniently and compactly. -The TableGen types are:

      - -
      -
      bit
      -
      A 'bit' is a boolean value that can hold either 0 or 1.
      - -
      int
      -
      The 'int' type represents a simple 32-bit integer value, such as 5.
      - -
      string
      -
      The 'string' type represents an ordered sequence of characters of - arbitrary length.
      - -
      bits<n>
      -
      A 'bits' type is an arbitrary, but fixed, size integer that is broken up - into individual bits. This type is useful because it can handle some bits - being defined while others are undefined.
      - -
      list<ty>
      -
      This type represents a list whose elements are some other type. The - contained type is arbitrary: it can even be another list type.
      - -
      Class type
      -
      Specifying a class name in a type context means that the defined value - must be a subclass of the specified class. This is useful in conjunction with - the list type, for example, to constrain the elements of the - list to a common base class (e.g., a list<Register> can - only contain definitions derived from the "Register" class).
      - -
      dag
      -
      This type represents a nestable directed graph of elements.
      - -
      code
      -
      This represents a big hunk of text. This is lexically distinct from - string values because it doesn't require escapeing double quotes and other - common characters that occur in code.
      -
      - -

      To date, these types have been sufficient for describing things that -TableGen has been used for, but it is straight-forward to extend this list if -needed.

      - -
      - - -
      - TableGen values and expressions -
      - -
      - -

      TableGen allows for a pretty reasonable number of different expression forms -when building up values. These forms allow the TableGen file to be written in a -natural syntax and flavor for the application. The current expression forms -supported include:

      - -
      -
      ?
      -
      uninitialized field
      -
      0b1001011
      -
      binary integer value
      -
      07654321
      -
      octal integer value (indicated by a leading 0)
      -
      7
      -
      decimal integer value
      -
      0x7F
      -
      hexadecimal integer value
      -
      "foo"
      -
      string value
      -
      [{ ... }]
      -
      code fragment
      -
      [ X, Y, Z ]<type>
      -
      list value. <type> is the type of the list -element and is usually optional. In rare cases, -TableGen is unable to deduce the element type in -which case the user must specify it explicitly.
      -
      { a, b, c }
      -
      initializer for a "bits<3>" value
      -
      value
      -
      value reference
      -
      value{17}
      -
      access to one bit of a value
      -
      value{15-17}
      -
      access to multiple bits of a value
      -
      DEF
      -
      reference to a record definition
      -
      CLASS<val list>
      -
      reference to a new anonymous definition of CLASS with the specified - template arguments.
      -
      X.Y
      -
      reference to the subfield of a value
      -
      list[4-7,17,2-3]
      -
      A slice of the 'list' list, including elements 4,5,6,7,17,2, and 3 from - it. Elements may be included multiple times.
      -
      (DEF a, b)
      -
      a dag value. The first element is required to be a record definition, the - remaining elements in the list may be arbitrary other values, including nested - `dag' values.
      -
      !strconcat(a, b)
      -
      A string value that is the result of concatenating the 'a' and 'b' - strings.
      -
      !cast<type>(a)
      -
      A symbol of type type obtained by looking up the string 'a' in -the symbol table. If the type of 'a' does not match type, TableGen -aborts with an error. !cast<string> is a special case in that the argument must -be an object defined by a 'def' construct.
      -
      !nameconcat<type>(a, b)
      -
      Shorthand for !cast<type>(!strconcat(a, b))
      -
      !subst(a, b, c)
      -
      If 'a' and 'b' are of string type or are symbol references, substitute -'b' for 'a' in 'c.' This operation is analogous to $(subst) in GNU make.
      -
      !foreach(a, b, c)
      -
      For each member 'b' of dag or list 'a' apply operator 'c.' 'b' is a -dummy variable that should be declared as a member variable of an instantiated -class. This operation is analogous to $(foreach) in GNU make.
      -
      !car(a)
      -
      The first element of list 'a.'
      -
      !cdr(a)
      -
      The 2nd-N elements of list 'a.'
      -
      !null(a)
      -
      An integer {0,1} indicating whether list 'a' is empty.
      -
      !if(a,b,c)
      -
      'b' if the result of integer operator 'a' is nonzero, 'c' otherwise.
      -
      !eq(a,b)
      -
      Integer one if string a is equal to string b, zero otherwise. This - only operates on string objects. Use !cast to compare other - types of objects.
      -
      - -

      Note that all of the values have rules specifying how they convert to values -for different types. These rules allow you to assign a value like "7" -to a "bits<4>" value, for example.

      - -
      - - -
      - Classes and definitions -
      - -
      - -

      As mentioned in the intro, classes and definitions -(collectively known as 'records') in TableGen are the main high-level unit of -information that TableGen collects. Records are defined with a def or -class keyword, the record name, and an optional list of "template arguments". If the record has superclasses, -they are specified as a comma separated list that starts with a colon character -(":"). If value definitions or let expressions are needed for the class, they are -enclosed in curly braces ("{}"); otherwise, the record ends with a -semicolon.

      - -

      Here is a simple TableGen file:

      - -
      -
      -class C { bit V = 1; }
-def X : C;
-def Y : C {
-  string Greeting = "hello";
-}
-
      -
      - -

      This example defines two definitions, X and Y, both of -which derive from the C class. Because of this, they both get the -V bit value. The Y definition also gets the Greeting member -as well.

      - -

      In general, classes are useful for collecting together the commonality -between a group of records and isolating it in a single place. Also, classes -permit the specification of default values for their subclasses, allowing the -subclasses to override them as they wish.

      - -
      - - -
      - Value definitions -
      - -
      - -

      Value definitions define named entries in records. A value must be defined -before it can be referred to as the operand for another value definition or -before the value is reset with a let expression. A -value is defined by specifying a TableGen type and a name. -If an initial value is available, it may be specified after the type with an -equal sign. Value definitions require terminating semicolons.

      - -
      - - -
      - 'let' expressions -
      - -
      - -

      A record-level let expression is used to change the value of a value -definition in a record. This is primarily useful when a superclass defines a -value that a derived class or definition wants to override. Let expressions -consist of the 'let' keyword followed by a value name, an equal sign -("="), and a new value. For example, a new class could be added to the -example above, redefining the V field for all of its subclasses:

      - -
      -
      -class D : C { let V = 0; }
-def Z : D;
-
      -
      - -

      In this case, the Z definition will have a zero value for its "V" -value, despite the fact that it derives (indirectly) from the C class, -because the D class overrode its value.

      - -
      - - -
      - Class template arguments -
      - -
      - -

      TableGen permits the definition of parameterized classes as well as normal -concrete classes. Parameterized TableGen classes specify a list of variable -bindings (which may optionally have defaults) that are bound when used. Here is -a simple example:

      - -
      -
      -class FPFormat<bits<3> val> {
-  bits<3> Value = val;
-}
-def NotFP      : FPFormat<0>;
-def ZeroArgFP  : FPFormat<1>;
-def OneArgFP   : FPFormat<2>;
-def OneArgFPRW : FPFormat<3>;
-def TwoArgFP   : FPFormat<4>;
-def CompareFP  : FPFormat<5>;
-def CondMovFP  : FPFormat<6>;
-def SpecialFP  : FPFormat<7>;
-
      -
      - -

      In this case, template arguments are used as a space efficient way to specify -a list of "enumeration values", each with a "Value" field set to the -specified integer.

      - -

      The more esoteric forms of TableGen expressions are -useful in conjunction with template arguments. As an example:

      - -
      -
      -class ModRefVal<bits<2> val> {
-  bits<2> Value = val;
-}
-
-def None   : ModRefVal<0>;
-def Mod    : ModRefVal<1>;
-def Ref    : ModRefVal<2>;
-def ModRef : ModRefVal<3>;
-
-class Value<ModRefVal MR> {
-  // Decode some information into a more convenient format, while providing
-  // a nice interface to the user of the "Value" class.
-  bit isMod = MR.Value{0};
-  bit isRef = MR.Value{1};
-
-  // other stuff...
-}
-
-// Example uses
-def bork : Value<Mod>;
-def zork : Value<Ref>;
-def hork : Value<ModRef>;
-
      -
      - -

      This is obviously a contrived example, but it shows how template arguments -can be used to decouple the interface provided to the user of the class from the -actual internal data representation expected by the class. In this case, -running tblgen on the example prints the following definitions:

      - -
      -
      -def bork {      // Value
-  bit isMod = 1;
-  bit isRef = 0;
-}
-def hork {      // Value
-  bit isMod = 1;
-  bit isRef = 1;
-}
-def zork {      // Value
-  bit isMod = 0;
-  bit isRef = 1;
-}
-
      -
      - -

      This shows that TableGen was able to dig into the argument and extract a -piece of information that was requested by the designer of the "Value" class. -For more realistic examples, please see existing users of TableGen, such as the -X86 backend.

      - -
      - - -
      - Multiclass definitions and instances -
      - -
      - -

      -While classes with template arguments are a good way to factor commonality -between two instances of a definition, multiclasses allow a convenient notation -for defining multiple definitions at once (instances of implicitly constructed -classes). For example, consider an 3-address instruction set whose instructions -come in two forms: "reg = reg op reg" and "reg = reg op imm" -(e.g. SPARC). In this case, you'd like to specify in one place that this -commonality exists, then in a separate place indicate what all the ops are. -

      - -

      -Here is an example TableGen fragment that shows this idea: -

      - -
      -
      -def ops;
-def GPR;
-def Imm;
-class inst<int opc, string asmstr, dag operandlist>;
-
-multiclass ri_inst<int opc, string asmstr> {
-  def _rr : inst<opc, !strconcat(asmstr, " $dst, $src1, $src2"),
-                 (ops GPR:$dst, GPR:$src1, GPR:$src2)>;
-  def _ri : inst<opc, !strconcat(asmstr, " $dst, $src1, $src2"),
-                 (ops GPR:$dst, GPR:$src1, Imm:$src2)>;
-}
-
-// Instantiations of the ri_inst multiclass.
-defm ADD : ri_inst<0b111, "add">;
-defm SUB : ri_inst<0b101, "sub">;
-defm MUL : ri_inst<0b100, "mul">;
-...
-
      -
      - -

      The name of the resultant definitions has the multidef fragment names - appended to them, so this defines ADD_rr, ADD_ri, - SUB_rr, etc. A defm may inherit from multiple multiclasses, - instantiating definitions from each multiclass. Using a multiclass - this way is exactly equivalent to instantiating the classes multiple - times yourself, e.g. by writing:

      - -
      -
      -def ops;
-def GPR;
-def Imm;
-class inst<int opc, string asmstr, dag operandlist>;
-
-class rrinst<int opc, string asmstr>
-  : inst<opc, !strconcat(asmstr, " $dst, $src1, $src2"),
-         (ops GPR:$dst, GPR:$src1, GPR:$src2)>;
-
-class riinst<int opc, string asmstr>
-  : inst<opc, !strconcat(asmstr, " $dst, $src1, $src2"),
-         (ops GPR:$dst, GPR:$src1, Imm:$src2)>;
-
-// Instantiations of the ri_inst multiclass.
-def ADD_rr : rrinst<0b111, "add">;
-def ADD_ri : riinst<0b111, "add">;
-def SUB_rr : rrinst<0b101, "sub">;
-def SUB_ri : riinst<0b101, "sub">;
-def MUL_rr : rrinst<0b100, "mul">;
-def MUL_ri : riinst<0b100, "mul">;
-...
-
      -
      - -
      - - -
      - File scope entities -
      - - -
      - File inclusion -
      - -
      -

      TableGen supports the 'include' token, which textually substitutes -the specified file in place of the include directive. The filename should be -specified as a double quoted string immediately after the 'include' -keyword. Example:

      - -
      -
      -include "foo.td"
-
      -
      - -
      - - -
      - 'let' expressions -
      - -
      - -

      "Let" expressions at file scope are similar to "let" -expressions within a record, except they can specify a value binding for -multiple records at a time, and may be useful in certain other cases. -File-scope let expressions are really just another way that TableGen allows the -end-user to factor out commonality from the records.

      - -

      File-scope "let" expressions take a comma-separated list of bindings to -apply, and one or more records to bind the values in. Here are some -examples:

      - -
      -
      -let isTerminator = 1, isReturn = 1, isBarrier = 1, hasCtrlDep = 1 in
-  def RET : I<0xC3, RawFrm, (outs), (ins), "ret", [(X86retflag 0)]>;
-
-let isCall = 1 in
-  // All calls clobber the non-callee saved registers...
-  let Defs = [EAX, ECX, EDX, FP0, FP1, FP2, FP3, FP4, FP5, FP6, ST0,
-              MM0, MM1, MM2, MM3, MM4, MM5, MM6, MM7,
-              XMM0, XMM1, XMM2, XMM3, XMM4, XMM5, XMM6, XMM7, EFLAGS] in {
-    def CALLpcrel32 : Ii32<0xE8, RawFrm, (outs), (ins i32imm:$dst,variable_ops),
-                           "call\t${dst:call}", []>;
-    def CALL32r     : I<0xFF, MRM2r, (outs), (ins GR32:$dst, variable_ops),
-                        "call\t{*}$dst", [(X86call GR32:$dst)]>;
-    def CALL32m     : I<0xFF, MRM2m, (outs), (ins i32mem:$dst, variable_ops),
-                        "call\t{*}$dst", []>;
-  }
-
      -
      - -

      File-scope "let" expressions are often useful when a couple of definitions -need to be added to several records, and the records do not otherwise need to be -opened, as in the case with the CALL* instructions above.

      - -
      - - -
      Code Generator backend info
      - - -

      Expressions used by code generator to describe instructions and isel -patterns:

      - -
      - -
      (implicit a)
      -
      an implicitly defined physical register. This tells the dag instruction - selection emitter the input pattern's extra definitions matches implicit - physical register definitions.
      - -
      - - -
      TableGen backends
      - - -
      - -

      TODO: How they work, how to write one. This section should not contain -details about any particular backend, except maybe -print-enums as an example. -This should highlight the APIs in TableGen/Record.h.

      - -
      - - - -
      -
      - Valid CSS - Valid HTML 4.01 - - Chris Lattner
      - LLVM Compiler Infrastructure
      - Last modified: $Date$ -
      - - - Removed: llvm/trunk/docs/TestingGuide.html URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/TestingGuide.html?rev=103212&view=auto ============================================================================== --- llvm/trunk/docs/TestingGuide.html (original) +++ llvm/trunk/docs/TestingGuide.html (removed) @@ -1,1212 +0,0 @@ - - - - LLVM Testing Infrastructure Guide - - - - -
      - LLVM Testing Infrastructure Guide -
      - -
        -
      1. Overview
        2. -
      2. Requirements
        3. -
      3. LLVM testing infrastructure organization - -
        4. -
      4. Quick start - -
        5. -
      5. DejaGNU structure - -
        6. -
      6. Test suite structure
        7. -
      7. Running the test suite - -
        8. -
      8. Running the nightly tester
        9. -
      - -
      -

      Written by John T. Criswell, Reid Spencer, and Tanya Lattner

      -
      - - -
      Overview
      - - -
      - -

      This document is the reference manual for the LLVM testing infrastructure. It documents -the structure of the LLVM testing infrastructure, the tools needed to use it, -and how to add and run tests.

      - -
      - - -
      Requirements
      - - -
      - -

      In order to use the LLVM testing infrastructure, you will need all of the software -required to build LLVM, plus the following:

      - -
      -
      DejaGNU
      -
      The Feature and Regressions tests are organized and run by DejaGNU.
      -
      Expect
      -
      Expect is required by DejaGNU.
      -
      tcl
      -
      Tcl is required by DejaGNU.
      -
      - -
      - - -
      LLVM testing infrastructure organization
      - - -
      - -

      The LLVM testing infrastructure contains two major categories of tests: code -fragments and whole programs. Code fragments are referred to as the "DejaGNU -tests" and are in the llvm module in subversion under the -llvm/test directory. The whole programs tests are referred to as the -"Test suite" and are in the test-suite module in subversion. -

      - -
      - - -
      DejaGNU tests
      - - -
      - -

      Code fragments are small pieces of code that test a specific -feature of LLVM or trigger a specific bug in LLVM. They are usually -written in LLVM assembly language, but can be written in other -languages if the test targets a particular language front end (and the -appropriate --with-llvmgcc options were used -at configure time of the llvm module). These tests -are driven by the DejaGNU testing framework, which is hidden behind a -few simple makefiles.

      - -

      These code fragments are not complete programs. The code generated -from them is never executed to determine correct behavior.

      - -

      These code fragment tests are located in the llvm/test -directory.

      - -

      Typically when a bug is found in LLVM, a regression test containing -just enough code to reproduce the problem should be written and placed -somewhere underneath this directory. In most cases, this will be a small -piece of LLVM assembly language code, often distilled from an actual -application or benchmark.

      - -
      - - -
      Test suite
      - - -
      - -

      The test suite contains whole programs, which are pieces of -code which can be compiled and linked into a stand-alone program that can be -executed. These programs are generally written in high level languages such as -C or C++, but sometimes they are written straight in LLVM assembly.

      - -

      These programs are compiled and then executed using several different -methods (native compiler, LLVM C backend, LLVM JIT, LLVM native code generation, -etc). The output of these programs is compared to ensure that LLVM is compiling -the program correctly.

      - -

      In addition to compiling and executing programs, whole program tests serve as -a way of benchmarking LLVM performance, both in terms of the efficiency of the -programs generated as well as the speed with which LLVM compiles, optimizes, and -generates code.

      - -

      The test-suite is located in the test-suite Subversion module.

      - -
      - - -
      Quick start
      - - -
      - -

      The tests are located in two separate Subversion modules. The - DejaGNU tests are in the main "llvm" module under the directory - llvm/test (so you get these tests for free with the main llvm tree). - The more comprehensive test suite that includes whole -programs in C and C++ is in the test-suite module. This module should -be checked out to the llvm/projects directory (don't use another name -then the default "test-suite", for then the test suite will be run every time -you run make in the main llvm directory). -When you configure the llvm module, -the test-suite directory will be automatically configured. -Alternatively, you can configure the test-suite module manually.

      - - -
      DejaGNU tests
      - -

      To run all of the simple tests in LLVM using DejaGNU, use the master Makefile - in the llvm/test directory:

      - -
      -
      -% gmake -C llvm/test
-
      -
      - -

      or

      - -
      -
      -% gmake check
-
      -
      - -

      To run only a subdirectory of tests in llvm/test using DejaGNU (ie. -Transforms), just set the TESTSUITE variable to the path of the -subdirectory (relative to llvm/test):

      - -
      -
      -% gmake TESTSUITE=Transforms check
-
      -
      - -

      Note: If you are running the tests with objdir != subdir, you -must have run the complete testsuite before you can specify a -subdirectory.

      - -

      To run only a single test, set TESTONE to its path (relative to -llvm/test) and make the check-one target:

      - -
      -
      -% gmake TESTONE=Feature/basictest.ll check-one
-
      -
      - -

      To run the tests with Valgrind (Memcheck by default), just append -VG=1 to the commands above, e.g.:

      - -
      -
      -% gmake check VG=1
-
      -
      - - -
      Test suite
      - - -

      To run the comprehensive test suite (tests that compile and execute whole -programs), first checkout and setup the test-suite module:

      - -
      -
      -% cd llvm/projects
-% svn co http://llvm.org/svn/llvm-project/test-suite/trunk test-suite
-% cd ..
-% ./configure --with-llvmgccdir=$LLVM_GCC_DIR
-
      -
      - -

      where $LLVM_GCC_DIR is the directory where -you installed llvm-gcc, not it's src or obj -dir. The --with-llvmgccdir option assumes that -the llvm-gcc-4.2 module was configured with ---program-prefix=llvm-, and therefore that the C and C++ -compiler drivers are called llvm-gcc and llvm-g++ -respectively. If this is not the case, -use --with-llvmgcc/--with-llvmgxx to specify each -executable's location.

      - -

      Then, run the entire test suite by running make in the test-suite -directory:

      - -
      -
      -% cd projects/test-suite
-% gmake
-
      -
      - -

      Usually, running the "nightly" set of tests is a good idea, and you can also -let it generate a report by running:

      - -
      -
      -% cd projects/test-suite
-% gmake TEST=nightly report report.html
-
      -
      - -

      Any of the above commands can also be run in a subdirectory of -projects/test-suite to run the specified test only on the programs in -that subdirectory.

      - -
      - - -
      DejaGNU structure
      - -
      -

      The LLVM DejaGNU tests are driven by DejaGNU together with GNU Make and are - located in the llvm/test directory. - -

      This directory contains a large array of small tests - that exercise various features of LLVM and to ensure that regressions do not - occur. The directory is broken into several sub-directories, each focused on - a particular area of LLVM. A few of the important ones are:

      - -
        -
      • Analysis: checks Analysis passes.
        • -
      • Archive: checks the Archive library.
        • -
      • Assembler: checks Assembly reader/writer functionality.
        • -
      • Bitcode: checks Bitcode reader/writer functionality.
        • -
      • CodeGen: checks code generation and each target.
        • -
      • Features: checks various features of the LLVM language.
        • -
      • Linker: tests bitcode linking.
        • -
      • Transforms: tests each of the scalar, IPO, and utility - transforms to ensure they make the right transformations.
        • -
      • Verifier: tests the IR verifier.
        • -
      - -
      - - -
      Writing new DejaGNU tests
      - -
      -

      The DejaGNU structure is very simple, but does require some information to - be set. This information is gathered via configure and is written - to a file, site.exp in llvm/test. The llvm/test - Makefile does this work for you.

      - -

      In order for DejaGNU to work, each directory of tests must have a - dg.exp file. DejaGNU looks for this file to determine how to run the - tests. This file is just a Tcl script and it can do anything you want, but - we've standardized it for the LLVM regression tests. If you're adding a - directory of tests, just copy dg.exp from another directory to get - running. The standard dg.exp simply loads a Tcl - library (test/lib/llvm.exp) and calls the llvm_runtests - function defined in that library with a list of file names to run. The names - are obtained by using Tcl's glob command. Any directory that contains only - directories does not need the dg.exp file.

      - -

      The llvm-runtests function lookas at each file that is passed to - it and gathers any lines together that match "RUN:". This are the "RUN" lines - that specify how the test is to be run. So, each test script must contain - RUN lines if it is to do anything. If there are no RUN lines, the - llvm-runtests function will issue an error and the test will - fail.

      - -

      RUN lines are specified in the comments of the test program using the - keyword RUN followed by a colon, and lastly the command (pipeline) - to execute. Together, these lines form the "script" that - llvm-runtests executes to run the test case. The syntax of the - RUN lines is similar to a shell's syntax for pipelines including I/O - redirection and variable substitution. However, even though these lines - may look like a shell script, they are not. RUN lines are interpreted - directly by the Tcl exec command. They are never executed by a - shell. Consequently the syntax differs from normal shell script syntax in a - few ways. You can specify as many RUN lines as needed.

      - -

      Each RUN line is executed on its own, distinct from other lines unless - its last character is \. This continuation character causes the RUN - line to be concatenated with the next one. In this way you can build up long - pipelines of commands without making huge line lengths. The lines ending in - \ are concatenated until a RUN line that doesn't end in \ is - found. This concatenated set of RUN lines then constitutes one execution. - Tcl will substitute variables and arrange for the pipeline to be executed. If - any process in the pipeline fails, the entire line (and test case) fails too. -

      - -

      Below is an example of legal RUN lines in a .ll file:

      - -
      -
      -; RUN: llvm-as < %s | llvm-dis > %t1
-; RUN: llvm-dis < %s.bc-13 > %t2
-; RUN: diff %t1 %t2
-
      -
      - -

      As with a Unix shell, the RUN: lines permit pipelines and I/O redirection - to be used. However, the usage is slightly different than for Bash. To check - what's legal, see the documentation for the - Tcl exec - command and the - tutorial. - The major differences are:

      -
        -
      • You can't do 2>&1. That will cause Tcl to write to a - file named &1. Usually this is done to get stderr to go through - a pipe. You can do that in tcl with |& so replace this idiom: - ... 2>&1 | grep with ... |& grep
        • -
      • You can only redirect to a file, not to another descriptor and not from - a here document.
        • -
      • tcl supports redirecting to open files with the @ syntax but you - shouldn't use that here.
        • -
      - -

      There are some quoting rules that you must pay attention to when writing - your RUN lines. In general nothing needs to be quoted. Tcl won't strip off any - ' or " so they will get passed to the invoked program. For example:

      - -
      -
      -... | grep 'find this string'
-
      -
      - -

      This will fail because the ' characters are passed to grep. This would - instruction grep to look for 'find in the files this and - string'. To avoid this use curly braces to tell Tcl that it should - treat everything enclosed as one value. So our example would become:

      - -
      -
      -... | grep {find this string}
-
      -
      - -

      Additionally, the characters [ and ] are treated - specially by Tcl. They tell Tcl to interpret the content as a command to - execute. Since these characters are often used in regular expressions this can - have disastrous results and cause the entire test run in a directory to fail. - For example, a common idiom is to look for some basicblock number:

      - -
      -
      -... | grep bb[2-8]
-
      -
      - -

      This, however, will cause Tcl to fail because its going to try to execute - a program named "2-8". Instead, what you want is this:

      - -
      -
      -... | grep {bb\[2-8\]}
-
      -
      - -

      Finally, if you need to pass the \ character down to a program, - then it must be doubled. This is another Tcl special character. So, suppose - you had: - -

      -
      -... | grep 'i32\*'
-
      -
      - -

      This will fail to match what you want (a pointer to i32). First, the - ' do not get stripped off. Second, the \ gets stripped off - by Tcl so what grep sees is: 'i32*'. That's not likely to match - anything. To resolve this you must use \\ and the {}, like - this:

      - -
      -
      -... | grep {i32\\*}
-
      -
      - -

      If your system includes GNU grep, make sure -that GREP_OPTIONS is not set in your environment. Otherwise, -you may get invalid results (both false positives and false -negatives).

      - -
      - - -
      The FileCheck utility
      - - -
      - -

      A powerful feature of the RUN: lines is that it allows any arbitrary commands - to be executed as part of the test harness. While standard (portable) unix - tools like 'grep' work fine on run lines, as you see above, there are a lot - of caveats due to interaction with Tcl syntax, and we want to make sure the - run lines are portable to a wide range of systems. Another major problem is - that grep is not very good at checking to verify that the output of a tools - contains a series of different output in a specific order. The FileCheck - tool was designed to help with these problems.

      - -

      FileCheck (whose basic command line arguments are described in the FileCheck man page is - designed to read a file to check from standard input, and the set of things - to verify from a file specified as a command line argument. A simple example - of using FileCheck from a RUN line looks like this:

      - -
      -
      -; RUN: llvm-as < %s | llc -march=x86-64 | FileCheck %s
-
      -
      - -

      This syntax says to pipe the current file ("%s") into llvm-as, pipe that into -llc, then pipe the output of llc into FileCheck. This means that FileCheck will -be verifying its standard input (the llc output) against the filename argument -specified (the original .ll file specified by "%s"). To see how this works, -lets look at the rest of the .ll file (after the RUN line):

      - -
      -
      -define void @sub1(i32* %p, i32 %v) {
-entry:
-; CHECK: sub1:
-; CHECK: subl
-        %0 = tail call i32 @llvm.atomic.load.sub.i32.p0i32(i32* %p, i32 %v)
-        ret void
-}
-
-define void @inc4(i64* %p) {
-entry:
-; CHECK: inc4:
-; CHECK: incq
-        %0 = tail call i64 @llvm.atomic.load.add.i64.p0i64(i64* %p, i64 1)
-        ret void
-}
-
      -
      - -

      Here you can see some "CHECK:" lines specified in comments. Now you can see -how the file is piped into llvm-as, then llc, and the machine code output is -what we are verifying. FileCheck checks the machine code output to verify that -it matches what the "CHECK:" lines specify.

      - -

      The syntax of the CHECK: lines is very simple: they are fixed strings that -must occur in order. FileCheck defaults to ignoring horizontal whitespace -differences (e.g. a space is allowed to match a tab) but otherwise, the contents -of the CHECK: line is required to match some thing in the test file exactly.

      - -

      One nice thing about FileCheck (compared to grep) is that it allows merging -test cases together into logical groups. For example, because the test above -is checking for the "sub1:" and "inc4:" labels, it will not match unless there -is a "subl" in between those labels. If it existed somewhere else in the file, -that would not count: "grep subl" matches if subl exists anywhere in the -file.

      - -
      - - -
      The FileCheck -check-prefix option
      - -
      - -

      The FileCheck -check-prefix option allows multiple test configurations to be -driven from one .ll file. This is useful in many circumstances, for example, -testing different architectural variants with llc. Here's a simple example:

      - -
      -
      -; RUN: llvm-as < %s | llc -mtriple=i686-apple-darwin9 -mattr=sse41 \
-; RUN:              | FileCheck %s -check-prefix=X32
-; RUN: llvm-as < %s | llc -mtriple=x86_64-apple-darwin9 -mattr=sse41 \
-; RUN:              | FileCheck %s -check-prefix=X64
-
-define <4 x i32> @pinsrd_1(i32 %s, <4 x i32> %tmp) nounwind {
-        %tmp1 = insertelement <4 x i32> %tmp, i32 %s, i32 1
-        ret <4 x i32> %tmp1
-; X32: pinsrd_1:
-; X32:    pinsrd $1, 4(%esp), %xmm0
-
-; X64: pinsrd_1:
-; X64:    pinsrd $1, %edi, %xmm0
-}
-
      -
      - -

      In this case, we're testing that we get the expected code generation with -both 32-bit and 64-bit code generation.

      - -
      - - -
      The "CHECK-NEXT:" directive
      - -
      - -

      Sometimes you want to match lines and would like to verify that matches -happen on exactly consequtive lines with no other lines in between them. In -this case, you can use CHECK: and CHECK-NEXT: directives to specify this. If -you specified a custom check prefix, just use "<PREFIX>-NEXT:". For -example, something like this works as you'd expect:

      - -
      -
      -define void @t2(<2 x double>* %r, <2 x double>* %A, double %B) {
-	%tmp3 = load <2 x double>* %A, align 16
-	%tmp7 = insertelement <2 x double> undef, double %B, i32 0
-	%tmp9 = shufflevector <2 x double> %tmp3,
-                              <2 x double> %tmp7,
-                              <2 x i32> < i32 0, i32 2 >
-	store <2 x double> %tmp9, <2 x double>* %r, align 16
-	ret void
-        
-; CHECK: t2:
-; CHECK: 	movl	8(%esp), %eax
-; CHECK-NEXT: 	movapd	(%eax), %xmm0
-; CHECK-NEXT: 	movhpd	12(%esp), %xmm0
-; CHECK-NEXT: 	movl	4(%esp), %eax
-; CHECK-NEXT: 	movapd	%xmm0, (%eax)
-; CHECK-NEXT: 	ret
-}
-
      -
      - -

      CHECK-NEXT: directives reject the input unless there is exactly one newline -between it an the previous directive. A CHECK-NEXT cannot be the first -directive in a file.

      - -
      - - -
      The "CHECK-NOT:" directive
      - -
      - -

      The CHECK-NOT: directive is used to verify that a string doesn't occur -between two matches (or the first match and the beginning of the file). For -example, to verify that a load is removed by a transformation, a test like this -can be used:

      - -
      -
      -define i8 @coerce_offset0(i32 %V, i32* %P) {
-  store i32 %V, i32* %P
-   
-  %P2 = bitcast i32* %P to i8*
-  %P3 = getelementptr i8* %P2, i32 2
-
-  %A = load i8* %P3
-  ret i8 %A
-; CHECK: @coerce_offset0
-; CHECK-NOT: load
-; CHECK: ret i8
-}
-
      -
      - -
      - - -
      FileCheck Pattern Matching Syntax
      - -
      - -

      The CHECK: and CHECK-NOT: directives both take a pattern to match. For most -uses of FileCheck, fixed string matching is perfectly sufficient. For some -things, a more flexible form of matching is desired. To support this, FileCheck -allows you to specify regular expressions in matching strings, surrounded by -double braces: {{yourregex}}. Because we want to use fixed string -matching for a majority of what we do, FileCheck has been designed to support -mixing and matching fixed string matching with regular expressions. This allows -you to write things like this:

      - -
      -
      -; CHECK: movhpd	{{[0-9]+}}(%esp), {{%xmm[0-7]}}
-
      -
      - -

      In this case, any offset from the ESP register will be allowed, and any xmm -register will be allowed.

      - -

      Because regular expressions are enclosed with double braces, they are -visually distinct, and you don't need to use escape characters within the double -braces like you would in C. In the rare case that you want to match double -braces explicitly from the input, you can use something ugly like -{{[{][{]}} as your pattern.

      - -
      - - -
      FileCheck Variables
      - -
      - -

      It is often useful to match a pattern and then verify that it occurs again -later in the file. For codegen tests, this can be useful to allow any register, -but verify that that register is used consistently later. To do this, FileCheck -allows named variables to be defined and substituted into patterns. Here is a -simple example:

      - -
      -
      -; CHECK: test5:
-; CHECK:    notw	[[REGISTER:%[a-z]+]]
-; CHECK:    andw	{{.*}}[[REGISTER]]
-
      -
      - -

      The first check line matches a regex (%[a-z]+) and captures it into -the variables "REGISTER". The second line verifies that whatever is in REGISTER -occurs later in the file after an "andw". FileCheck variable references are -always contained in [[ ]] pairs, are named, and their names can be -formed with the regex "[a-zA-Z][a-zA-Z0-9]*". If a colon follows the -name, then it is a definition of the variable, if not, it is a use.

      - -

      FileCheck variables can be defined multiple times, and uses always get the -latest value. Note that variables are all read at the start of a "CHECK" line -and are all defined at the end. This means that if you have something like -"CHECK: [[XYZ:.*]]x[[XYZ]]" that the check line will read the previous -value of the XYZ variable and define a new one after the match is performed. If -you need to do something like this you can probably take advantage of the fact -that FileCheck is not actually line-oriented when it matches, this allows you to -define two separate CHECK lines that match on the same line. -

      - -
      - - -
      Variables and -substitutions
      - -
      -

      With a RUN line there are a number of substitutions that are permitted. In - general, any Tcl variable that is available in the substitute - function (in test/lib/llvm.exp) can be substituted into a RUN line. - To make a substitution just write the variable's name preceded by a $. - Additionally, for compatibility reasons with previous versions of the test - library, certain names can be accessed with an alternate syntax: a % prefix. - These alternates are deprecated and may go away in a future version. -

      -

      Here are the available variable names. The alternate syntax is listed in - parentheses.

      - -
      -
      $test (%s)
      -
      The full path to the test case's source. This is suitable for passing - on the command line as the input to an llvm tool.
      - -
      $srcdir
      -
      The source directory from where the "make check" was run.
      - -
      objdir
      -
      The object directory that corresponds to the $srcdir.
      - -
      subdir
      -
      A partial path from the test directory that contains the - sub-directory that contains the test source being executed.
      - -
      srcroot
      -
      The root directory of the LLVM src tree.
      - -
      objroot
      -
      The root directory of the LLVM object tree. This could be the same - as the srcroot.
      - -
      path
      -
      The path to the directory that contains the test case source. This is - for locating any supporting files that are not generated by the test, but - used by the test.
      - -
      tmp
      -
      The path to a temporary file name that could be used for this test case. - The file name won't conflict with other test cases. You can append to it if - you need multiple temporaries. This is useful as the destination of some - redirected output.
      - -
      llvmlibsdir (%llvmlibsdir)
      -
      The directory where the LLVM libraries are located.
      - -
      target_triplet (%target_triplet)
      -
      The target triplet that corresponds to the current host machine (the one - running the test cases). This should probably be called "host".
      - -
      llvmgcc (%llvmgcc)
      -
      The full path to the llvm-gcc executable as specified in the - configured LLVM environment
      - -
      llvmgxx (%llvmgxx)
      -
      The full path to the llvm-gxx executable as specified in the - configured LLVM environment
      - -
      gccpath
      -
      The full path to the C compiler used to build LLVM. Note that - this might not be gcc.
      - -
      gxxpath
      -
      The full path to the C++ compiler used to build LLVM. Note that - this might not be g++.
      - -
      compile_c (%compile_c)
      -
      The full command line used to compile LLVM C source code. This has all - the configured -I, -D and optimization options.
      - -
      compile_cxx (%compile_cxx)
      -
      The full command used to compile LLVM C++ source code. This has - all the configured -I, -D and optimization options.
      - -
      link (%link)
      -
      This full link command used to link LLVM executables. This has all the - configured -I, -L and -l options.
      - -
      shlibext (%shlibext)
      -
      The suffix for the host platforms share library (dll) files. This - includes the period as the first character.
      -
      -

      To add more variables, two things need to be changed. First, add a line in - the test/Makefile that creates the site.exp file. This will - "set" the variable as a global in the site.exp file. Second, in the - test/lib/llvm.exp file, in the substitute proc, add the variable name - to the list of "global" declarations at the beginning of the proc. That's it, - the variable can then be used in test scripts.

      -
      - - -
      Other Features
      - -
      -

      To make RUN line writing easier, there are several shell scripts located - in the llvm/test/Scripts directory. This directory is in the PATH - when running tests, so you can just call these scripts using their name. For - example:

      -
      -
      ignore
      -
      This script runs its arguments and then always returns 0. This is useful - in cases where the test needs to cause a tool to generate an error (e.g. to - check the error output). However, any program in a pipeline that returns a - non-zero result will cause the test to fail. This script overcomes that - issue and nicely documents that the test case is purposefully ignoring the - result code of the tool
      - -
      not
      -
      This script runs its arguments and then inverts the result code from - it. Zero result codes become 1. Non-zero result codes become 0. This is - useful to invert the result of a grep. For example "not grep X" means - succeed only if you don't find X in the input.
      -
      - -

      Sometimes it is necessary to mark a test case as "expected fail" or XFAIL. - You can easily mark a test as XFAIL just by including XFAIL: on a - line near the top of the file. This signals that the test case should succeed - if the test fails. Such test cases are counted separately by DejaGnu. To - specify an expected fail, use the XFAIL keyword in the comments of the test - program followed by a colon and one or more regular expressions (separated by - a comma). The regular expressions allow you to XFAIL the test conditionally by - host platform. The regular expressions following the : are matched against the - target triplet for the host machine. If there is a match, the test is expected - to fail. If not, the test is expected to succeed. To XFAIL everywhere just - specify XFAIL: *. Here is an example of an XFAIL line:

      - -
      -
      -; XFAIL: darwin,sun
-
      -
      - -

      To make the output more useful, the llvm_runtest function wil - scan the lines of the test case for ones that contain a pattern that matches - PR[0-9]+. This is the syntax for specifying a PR (Problem Report) number that - is related to the test case. The number after "PR" specifies the LLVM bugzilla - number. When a PR number is specified, it will be used in the pass/fail - reporting. This is useful to quickly get some context when a test fails.

      - -

      Finally, any line that contains "END." will cause the special - interpretation of lines to terminate. This is generally done right after the - last RUN: line. This has two side effects: (a) it prevents special - interpretation of lines that are part of the test program, not the - instructions to the test case, and (b) it speeds things up for really big test - cases by avoiding interpretation of the remainder of the file.

      - -
      - - -
      Test suite -Structure
      - - -
      - -

      The test-suite module contains a number of programs that can be compiled -with LLVM and executed. These programs are compiled using the native compiler -and various LLVM backends. The output from the program compiled with the -native compiler is assumed correct; the results from the other programs are -compared to the native program output and pass if they match.

      - -

      When executing tests, it is usually a good idea to start out with a subset of -the available tests or programs. This makes test run times smaller at first and -later on this is useful to investigate individual test failures. To run some -test only on a subset of programs, simply change directory to the programs you -want tested and run gmake there. Alternatively, you can run a different -test using the TEST variable to change what tests or run on the -selected programs (see below for more info).

      - -

      In addition for testing correctness, the llvm-test directory also -performs timing tests of various LLVM optimizations. It also records -compilation times for the compilers and the JIT. This information can be -used to compare the effectiveness of LLVM's optimizations and code -generation.

      - -

      llvm-test tests are divided into three types of tests: MultiSource, -SingleSource, and External.

      - -
        -
      • llvm-test/SingleSource -

        The SingleSource directory contains test programs that are only a single -source file in size. These are usually small benchmark programs or small -programs that calculate a particular value. Several such programs are grouped -together in each directory.

        • - -
      • llvm-test/MultiSource -

        The MultiSource directory contains subdirectories which contain entire -programs with multiple source files. Large benchmarks and whole applications -go here.

        • - -
      • llvm-test/External -

        The External directory contains Makefiles for building code that is external -to (i.e., not distributed with) LLVM. The most prominent members of this -directory are the SPEC 95 and SPEC 2000 benchmark suites. The External -directory does not contain these actual tests, but only the Makefiles that know -how to properly compile these programs from somewhere else. The presence and -location of these external programs is configured by the llvm-test -configure script.

        • -
      - -

      Each tree is then subdivided into several categories, including applications, -benchmarks, regression tests, code that is strange grammatically, etc. These -organizations should be relatively self explanatory.

      - -

      Some tests are known to fail. Some are bugs that we have not fixed yet; -others are features that we haven't added yet (or may never add). In DejaGNU, -the result for such tests will be XFAIL (eXpected FAILure). In this way, you -can tell the difference between an expected and unexpected failure.

      - -

      The tests in the test suite have no such feature at this time. If the -test passes, only warnings and other miscellaneous output will be generated. If -a test fails, a large <program> FAILED message will be displayed. This -will help you separate benign warnings from actual test failures.

      - -
      - - -
      Running the test suite
      - - -
      - -

      First, all tests are executed within the LLVM object directory tree. They -are not executed inside of the LLVM source tree. This is because the -test suite creates temporary files during execution.

      - -

      To run the test suite, you need to use the following steps:

      - -
        -
      1. cd into the llvm/projects directory in your source tree. -
        2. - -

      2. Check out the test-suite module with:

        - -
        -
        -% svn co http://llvm.org/svn/llvm-project/test-suite/trunk test-suite
-
        -
        -

        This will get the test suite into llvm/projects/test-suite.

        -
        3. -

      3. Configure and build llvm.

        4. -

      4. Configure and build llvm-gcc.

        5. -

      5. Install llvm-gcc somewhere.

        6. -

      6. Re-configure llvm from the top level of - each build tree (LLVM object directory tree) in which you want - to run the test suite, just as you do before building LLVM.

        -

        During the re-configuration, you must either: (1) - have llvm-gcc you just built in your path, or (2) - specify the directory where your just-built llvm-gcc is - installed using --with-llvmgccdir=$LLVM_GCC_DIR.

        -

        You must also tell the configure machinery that the test suite - is available so it can be configured for your build tree:

        -
        -
        -% cd $LLVM_OBJ_ROOT ; $LLVM_SRC_ROOT/configure [--with-llvmgccdir=$LLVM_GCC_DIR]
-
        -
        -

        [Remember that $LLVM_GCC_DIR is the directory where you - installed llvm-gcc, not its src or obj directory.]

        -
        7. - -

      7. You can now run the test suite from your build tree as follows:

        -
        -
        -% cd $LLVM_OBJ_ROOT/projects/test-suite
-% make
-
        -
        -
        8. -
      -

      Note that the second and third steps only need to be done once. After you -have the suite checked out and configured, you don't need to do it again (unless -the test code or configure script changes).

      - -
      - - -
      -Configuring External Tests
      - - -
      -

      In order to run the External tests in the test-suite - module, you must specify --with-externals. This - must be done during the re-configuration step (see above), - and the llvm re-configuration must recognize the - previously-built llvm-gcc. If any of these is missing or - neglected, the External tests won't work.

      -
      -
      --with-externals
      -
      --with-externals=<directory>
      -
      - This tells LLVM where to find any external tests. They are expected to be - in specifically named subdirectories of <directory>. - If directory is left unspecified, - configure uses the default value - /home/vadve/shared/benchmarks/speccpu2000/benchspec. - Subdirectory names known to LLVM include: -
      -
      spec95
      -
      speccpu2000
      -
      speccpu2006
      -
      povray31
      -
      - Others are added from time to time, and can be determined from - configure. -
      - - -
      -Running different tests
      - -
      -

      In addition to the regular "whole program" tests, the test-suite -module also provides a mechanism for compiling the programs in different ways. -If the variable TEST is defined on the gmake command line, the test system will -include a Makefile named TEST.<value of TEST variable>.Makefile. -This Makefile can modify build rules to yield different results.

      - -

      For example, the LLVM nightly tester uses TEST.nightly.Makefile to -create the nightly test reports. To run the nightly tests, run gmake -TEST=nightly.

      - -

      There are several TEST Makefiles available in the tree. Some of them are -designed for internal LLVM research and will not work outside of the LLVM -research group. They may still be valuable, however, as a guide to writing your -own TEST Makefile for any optimization or analysis passes that you develop with -LLVM.

      - -
      - - -
      -Generating test output
      - -
      -

      There are a number of ways to run the tests and generate output. The most - simple one is simply running gmake with no arguments. This will - compile and run all programs in the tree using a number of different methods - and compare results. Any failures are reported in the output, but are likely - drowned in the other output. Passes are not reported explicitely.

      - -

      Somewhat better is running gmake TEST=sometest test, which runs - the specified test and usually adds per-program summaries to the output - (depending on which sometest you use). For example, the nightly test - explicitely outputs TEST-PASS or TEST-FAIL for every test after each program. - Though these lines are still drowned in the output, it's easy to grep the - output logs in the Output directories.

      - -

      Even better are the report and report.format targets - (where format is one of html, csv, text or - graphs). The exact contents of the report are dependent on which - TEST you are running, but the text results are always shown at the - end of the run and the results are always stored in the - report.<type>.format file (when running with - TEST=<type>). - - The report also generate a file called - report.<type>.raw.out containing the output of the entire test - run. -

      - - -
      -Writing custom tests for the test suite
      - - -
      - -

      Assuming you can run the test suite, (e.g. "gmake TEST=nightly report" -should work), it is really easy to run optimizations or code generator -components against every program in the tree, collecting statistics or running -custom checks for correctness. At base, this is how the nightly tester works, -it's just one example of a general framework.

      - -

      Lets say that you have an LLVM optimization pass, and you want to see how -many times it triggers. First thing you should do is add an LLVM -statistic to your pass, which -will tally counts of things you care about.

      - -

      Following this, you can set up a test and a report that collects these and -formats them for easy viewing. This consists of two files, an -"test-suite/TEST.XXX.Makefile" fragment (where XXX is the name of your -test) and an "llvm-test/TEST.XXX.report" file that indicates how to -format the output into a table. There are many example reports of various -levels of sophistication included with the test suite, and the framework is very -general.

      - -

      If you are interested in testing an optimization pass, check out the -"libcalls" test as an example. It can be run like this:

      - -

      -
      -% cd llvm/projects/test-suite/MultiSource/Benchmarks  # or some other level
-% make TEST=libcalls report
-
      -
      - -

      This will do a bunch of stuff, then eventually print a table like this:

      - -
      -
      -Name                                  | total | #exit |
-...
-FreeBench/analyzer/analyzer           | 51    | 6     | 
-FreeBench/fourinarow/fourinarow       | 1     | 1     | 
-FreeBench/neural/neural               | 19    | 9     | 
-FreeBench/pifft/pifft                 | 5     | 3     | 
-MallocBench/cfrac/cfrac               | 1     | *     | 
-MallocBench/espresso/espresso         | 52    | 12    | 
-MallocBench/gs/gs                     | 4     | *     | 
-Prolangs-C/TimberWolfMC/timberwolfmc  | 302   | *     | 
-Prolangs-C/agrep/agrep                | 33    | 12    | 
-Prolangs-C/allroots/allroots          | *     | *     | 
-Prolangs-C/assembler/assembler        | 47    | *     | 
-Prolangs-C/bison/mybison              | 74    | *     | 
-...
-
      -
      - -

      This basically is grepping the -stats output and displaying it in a table. -You can also use the "TEST=libcalls report.html" target to get the table in HTML -form, similarly for report.csv and report.tex.

      - -

      The source for this is in test-suite/TEST.libcalls.*. The format is pretty -simple: the Makefile indicates how to run the test (in this case, -"opt -simplify-libcalls -stats"), and the report contains one line for -each column of the output. The first value is the header for the column and the -second is the regex to grep the output of the command for. There are lots of -example reports that can do fancy stuff.

      - -
      - - -
      Running the nightly tester
      - - -
      - -

      -The LLVM Nightly Testers -automatically check out an LLVM tree, build it, run the "nightly" -program test (described above), run all of the DejaGNU tests, -delete the checked out tree, and then submit the results to -http://llvm.org/nightlytest/. -After test results are submitted to -http://llvm.org/nightlytest/, -they are processed and displayed on the tests page. An email to - -llvm-testresults at cs.uiuc.edu summarizing the results is also generated. -This testing scheme is designed to ensure that programs don't break as well -as keep track of LLVM's progress over time.

      - -

      If you'd like to set up an instance of the nightly tester to run on your -machine, take a look at the comments at the top of the -utils/NewNightlyTest.pl file. If you decide to set up a nightly tester -please choose a unique nickname and invoke utils/NewNightlyTest.pl -with the "-nickname [yournickname]" command line option. - -

      You can create a shell script to encapsulate the running of the script. -The optimized x86 Linux nightly test is run from just such a script:

      - -
      -
      -#!/bin/bash
-BASE=/proj/work/llvm/nightlytest
-export BUILDDIR=$BASE/build 
-export WEBDIR=$BASE/testresults 
-export LLVMGCCDIR=/proj/work/llvm/cfrontend/install
-export PATH=/proj/install/bin:$LLVMGCCDIR/bin:$PATH
-export LD_LIBRARY_PATH=/proj/install/lib
-cd $BASE
-cp /proj/work/llvm/llvm/utils/NewNightlyTest.pl .
-nice ./NewNightlyTest.pl -nice -release -verbose -parallel -enable-linscan \
-   -nickname NightlyTester -noexternals > output.log 2>&1 
-
      -
      - -

      It is also possible to specify the the location your nightly test results -are submitted. You can do this by passing the command line option -"-submit-server [server_address]" and "-submit-script [script_on_server]" to -utils/NewNightlyTest.pl. For example, to submit to the llvm.org -nightly test results page, you would invoke the nightly test script with -"-submit-server llvm.org -submit-script /nightlytest/NightlyTestAccept.cgi". -If these options are not specified, the nightly test script sends the results -to the llvm.org nightly test results page.

      - -

      Take a look at the NewNightlyTest.pl file to see what all of the -flags and strings do. If you start running the nightly tests, please let us -know. Thanks!

      - -
      - - - -
      -
      - Valid CSS - Valid HTML 4.01 - - John T. Criswell, Reid Spencer, and Tanya Lattner
      - The LLVM Compiler Infrastructure
      - Last modified: $Date$ -
      - - Removed: llvm/trunk/docs/UsingLibraries.html URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/UsingLibraries.html?rev=103212&view=auto ============================================================================== --- llvm/trunk/docs/UsingLibraries.html (original) +++ llvm/trunk/docs/UsingLibraries.html (removed) @@ -1,439 +0,0 @@ - - - - Using The LLVM Libraries - - - -
      Using The LLVM Libraries
      -
        -
      1. Abstract
        2. -
      2. Introduction
        3. -
      3. Library Descriptions
        4. -
      4. Library Dependencies
        5. -
      5. Linkage Rules Of Thumb -
          -
        1. Always link LLVMCore, LLVMSupport, LLVMSystem -
        2. Never link both archive and re-linked -
        -
        6. -
      - -
      -

      Written by Reid Spencer

      -
      - -

      Warning: This document is out of date, please see llvm-config for more information.

      - - -
      Abstract
      -
      -

      Amongst other things, LLVM is a toolkit for building compilers, linkers, - runtime executives, virtual machines, and other program execution related - tools. In addition to the LLVM tool set, the functionality of LLVM is - available through a set of libraries. To use LLVM as a toolkit for - constructing tools, a developer needs to understand what is contained in the - various libraries, what they depend on, and how to use them. Fortunately, - there is a tool, llvm-config to aid with this. This document - describes the contents of the libraries and how to use llvm-config - to generate command line options. -

      -
      - - -
      Introduction
      -
      -

      If you're writing a compiler, virtual machine, or any other utility based - on LLVM, you'll need to figure out which of the many libraries files you will - need to link with to be successful. An understanding of the contents of these - libraries will be useful in coming up with an optimal specification for the - libraries to link with. The purpose of this document is to reduce some of - the trial and error that the author experienced in using LLVM.

      -

      LLVM produces two types of libraries: archives (ending in .a) and - objects (ending in .o). However, both are libraries. Libraries ending - in .o are known as re-linked libraries because they contain all the - compilation units of the library linked together as a single .o file. - Furthermore, several of the libraries have both forms of library. The - re-linked libraries are used whenever you want to include all symbols from the - library. The archive libraries are used whenever you want to only resolve - outstanding symbols at that point in the link without including everything in - the library.

      -

      If you're using the LLVM Makefile system to link your tools,you will use - the LLVMLIBS make variable. - (see the Makefile Guide for - details). This variable specifies which LLVM libraries to link into your tool - and the order in which they will be linked. You specify re-linked libraries by - naming the library without a suffix. You specify archive libraries by naming - the library with a .a suffix but without the lib prefix. The - order in which the libraries appear in the LLVMLIBS variable - definition is the order in which they will be linked. Getting this order - correct for your tool can sometimes be challenging. -

      - -
      Library Descriptions
      -
      -

      The table below categorizes each library - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
      LibraryFormsDescription
      Core Libraries
      LLVMArchive.aLLVM archive reading and writing
      LLVMAsmParser.aLLVM assembly parsing
      LLVMBCReader.aLLVM bitcode reading
      LLVMBCWriter.aLLVM bitcode writing
      LLVMCore.aLLVM core intermediate representation
      LLVMDebugger.aSource level debugging support
      LLVMLinker.aBitcode and archive linking interface
      LLVMSupport.aGeneral support utilities
      LLVMSystem.aOperating system abstraction layer
      LLVMbzip2.aBZip2 compression library
      Analysis Libraries
      LLVMAnalysis.aVarious analysis passes.
      LLVMDataStructure.oData structure analysis passes.
      LLVMipa.aInter-procedural analysis passes.
      Transformation Libraries
      LLVMInstrumentation.aInstrumentation passes.
      LLVMipo.aAll inter-procedural optimization passes.
      LLVMScalarOpts.aAll scalar optimization passes.
      LLVMTransformUtils.aTransformation utilities used by many passes.
      Code Generation Libraries
      LLVMCodeGen.oNative code generation infrastructure
      LLVMSelectionDAG.oAggressive instruction selector for directed acyclic graphs
      Target Libraries
      LLVMAlpha.oCode generation for Alpha architecture
      LLVMARM.oCode generation for ARM architecture
      LLVMCBackend.o'C' language code generator.
      LLVMPowerPC.oCode generation for PowerPC architecture
      LLVMSparc.oCode generation for Sparc architecture
      LLVMTarget.aGeneric code generation utilities.
      LLVMX86.oCode generation for Intel x86 architecture
      Runtime Libraries
      LLVMInterpreter.oBitcode Interpreter
      LLVMJIT.oBitcode JIT Compiler
      LLVMExecutionEngine.oVirtual machine engine
      -

      - - -
      Using llvm-config
      -
      -

      The llvm-config tool is a perl script that produces on its output - various kinds of information. For example, the source or object directories - used to build LLVM can be accessed by passing options to llvm-config. - For complete details on this tool, please see the - manual page.

      -

      To understand the relationships between libraries, the llvm-config - can be very useful. If all you know is that you want certain libraries to - be available, you can generate the complete set of libraries to link with - using one of four options, as below:

      -
        -
      1. --ldflags. This generates the command line options necessary to - be passed to the ld tool in order to link with LLVM. Most notably, - the -L option is provided to specify a library search directory - that contains the LLVM libraries.
        2. -
      2. --libs. This generates command line options suitable for - use with a gcc-style linker. That is, libraries are given with a -l option - and object files are given with a full path.
        3. -
      3. --libnames. This generates a list of just the library file - names. If you know the directory in which these files reside (see --ldflags) - then you can find the libraries there.
        4. -
      4. --libfiles. This generates the full path names of the - LLVM library files.
        5. -
      -

      If you wish to delve further into how llvm-config generates the - correct order (based on library dependencies), please see the tool named - GenLibDeps.pl in the utils source directory of LLVM.

      - - - - - - - -

      Dependency Relationships Of Libraries

      -

      This graph shows the dependency of archive libraries on other archive - libraries or objects. Where a library has both archive and object forms, only - the archive form is shown.

      - Library Dependencies -

      Dependency Relationships Of Object Files

      -

      This graph shows the dependency of object files on archive libraries or - other objects. Where a library has both object and archive forms, only the - dependency to the archive form is shown.

      - Object File Dependencies -

      The following list shows the dependency relationships between libraries in - textual form. The information is the same as shown on the graphs but arranged - alphabetically.

      -
      -
      libLLVMAnalysis.a
        -
      • libLLVMCore.a
        • -
      • libLLVMSupport.a
        • -
      • libLLVMSystem.a
        • -
      • libLLVMTarget.a
        • -
      -
      libLLVMArchive.a
        -
      • libLLVMBCReader.a
        • -
      • libLLVMCore.a
        • -
      • libLLVMSupport.a
        • -
      • libLLVMSystem.a
        • -
      -
      libLLVMAsmParser.a
        -
      • libLLVMCore.a
        • -
      • libLLVMSystem.a
        • -
      -
      libLLVMBCReader.a
        -
      • libLLVMCore.a
        • -
      • libLLVMSupport.a
        • -
      • libLLVMSystem.a
        • -
      -
      libLLVMBCWriter.a
        -
      • libLLVMCore.a
        • -
      • libLLVMSupport.a
        • -
      • libLLVMSystem.a
        • -
      -
      libLLVMCodeGen.a
        -
      • libLLVMAnalysis.a
        • -
      • libLLVMCore.a
        • -
      • libLLVMScalarOpts.a
        • -
      • libLLVMSupport.a
        • -
      • libLLVMSystem.a
        • -
      • libLLVMTarget.a
        • -
      • libLLVMTransformUtils.a
        • -
      -
      libLLVMCore.a
        -
      • libLLVMSupport.a
        • -
      • libLLVMSystem.a
        • -
      -
      libLLVMDebugger.a
        -
      • libLLVMBCReader.a
        • -
      • libLLVMCore.a
        • -
      • libLLVMSupport.a
        • -
      • libLLVMSystem.a
        • -
      -
      libLLVMInstrumentation.a
        -
      • libLLVMCore.a
        • -
      • libLLVMScalarOpts.a
        • -
      • libLLVMSupport.a
        • -
      • libLLVMTransformUtils.a
        • -
      -
      libLLVMLinker.a
        -
      • libLLVMArchive.a
        • -
      • libLLVMBCReader.a
        • -
      • libLLVMCore.a
        • -
      • libLLVMSupport.a
        • -
      • libLLVMSystem.a
        • -
      -
      libLLVMScalarOpts.a
        -
      • libLLVMAnalysis.a
        • -
      • libLLVMCore.a
        • -
      • libLLVMSupport.a
        • -
      • libLLVMSystem.a
        • -
      • libLLVMTarget.a
        • -
      • libLLVMTransformUtils.a
        • -
      -
      libLLVMSelectionDAG.a
        -
      • libLLVMAnalysis.a
        • -
      • libLLVMCodeGen.a
        • -
      • libLLVMCore.a
        • -
      • libLLVMSupport.a
        • -
      • libLLVMSystem.a
        • -
      • libLLVMTarget.a
        • -
      • libLLVMTransformUtils.a
        • -
      -
      libLLVMSupport.a
        -
      • libLLVMSystem.a
        • -
      • libLLVMbzip2.a
        • -
      -
      libLLVMSystem.a
        -
      -
      libLLVMTarget.a
        -
      • libLLVMCore.a
        • -
      • libLLVMSupport.a
        • -
      • libLLVMSystem.a
        • -
      -
      libLLVMTransformUtils.a
        -
      • libLLVMAnalysis.a
        • -
      • libLLVMCore.a
        • -
      • libLLVMSupport.a
        • -
      • libLLVMSystem.a
        • -
      • libLLVMTarget.a
        • -
      • libLLVMipa.a
        • -
      -
      libLLVMbzip2.a
        -
      -
      libLLVMipa.a
        -
      • libLLVMAnalysis.a
        • -
      • libLLVMCore.a
        • -
      • libLLVMSupport.a
        • -
      • libLLVMSystem.a
        • -
      -
      libLLVMipo.a
        -
      • libLLVMAnalysis.a
        • -
      • libLLVMCore.a
        • -
      • libLLVMSupport.a
        • -
      • libLLVMSystem.a
        • -
      • libLLVMTarget.a
        • -
      • libLLVMTransformUtils.a
        • -
      • libLLVMipa.a
        • -
      -
      libLLVMlto.a
        -
      • libLLVMAnalysis.a
        • -
      • libLLVMBCReader.a
        • -
      • libLLVMBCWriter.a
        • -
      • libLLVMCore.a
        • -
      • libLLVMLinker.a
        • -
      • libLLVMScalarOpts.a
        • -
      • libLLVMSupport.a
        • -
      • libLLVMSystem.a
        • -
      • libLLVMTarget.a
        • -
      • libLLVMipa.a
        • -
      • libLLVMipo.a
        • -
      -
      LLVMARM.o
        -
      • libLLVMCodeGen.a
        • -
      • libLLVMCore.a
        • -
      • libLLVMSelectionDAG.a
        • -
      • libLLVMSupport.a
        • -
      • libLLVMSystem.a
        • -
      • libLLVMTarget.a
        • -
      -
      LLVMAlpha.o
        -
      • libLLVMCodeGen.a
        • -
      • libLLVMCore.a
        • -
      • libLLVMSelectionDAG.a
        • -
      • libLLVMSupport.a
        • -
      • libLLVMSystem.a
        • -
      • libLLVMTarget.a
        • -
      -
      LLVMCBackend.o
        -
      • libLLVMAnalysis.a
        • -
      • libLLVMCodeGen.a
        • -
      • libLLVMCore.a
        • -
      • libLLVMScalarOpts.a
        • -
      • libLLVMSupport.a
        • -
      • libLLVMSystem.a
        • -
      • libLLVMTarget.a
        • -
      • libLLVMTransformUtils.a
        • -
      • libLLVMipa.a
        • -
      -
      LLVMExecutionEngine.o
        -
      • libLLVMCore.a
        • -
      • libLLVMSupport.a
        • -
      • libLLVMSystem.a
        • -
      • libLLVMTarget.a
        • -
      -
      LLVMInterpreter.o
        -
      • LLVMExecutionEngine.o
        • -
      • libLLVMCodeGen.a
        • -
      • libLLVMCore.a
        • -
      • libLLVMSupport.a
        • -
      • libLLVMSystem.a
        • -
      • libLLVMTarget.a
        • -
      -
      LLVMJIT.o
        -
      • LLVMExecutionEngine.o
        • -
      • libLLVMCore.a
        • -
      • libLLVMSupport.a
        • -
      • libLLVMSystem.a
        • -
      • libLLVMTarget.a
        • -
      -
      LLVMPowerPC.o
        -
      • libLLVMCodeGen.a
        • -
      • libLLVMCore.a
        • -
      • libLLVMSelectionDAG.a
        • -
      • libLLVMSupport.a
        • -
      • libLLVMSystem.a
        • -
      • libLLVMTarget.a
        • -
      -
      LLVMSparc.o
        -
      • libLLVMCodeGen.a
        • -
      • libLLVMCore.a
        • -
      • libLLVMSelectionDAG.a
        • -
      • libLLVMSupport.a
        • -
      • libLLVMSystem.a
        • -
      • libLLVMTarget.a
        • -
      -
      LLVMX86.o
        -
      • libLLVMCodeGen.a
        • -
      • libLLVMCore.a
        • -
      • libLLVMSelectionDAG.a
        • -
      • libLLVMSupport.a
        • -
      • libLLVMSystem.a
        • -
      • libLLVMTarget.a
        • -
      -
      -
      - - -
      Linkage Rules Of Thumb
      -
      -

      This section contains various "rules of thumb" about what files you - should link into your programs.

      -
      - -
      Always Link LLVMCore, LLVMSupport, - and LLVMSystem
      -
      -

      No matter what you do with LLVM, the last three entries in the value of - your LLVMLIBS make variable should always be: - LLVMCore LLVMSupport.a LLVMSystem.a. There are no LLVM - programs that don't depend on these three.

      -
      - -
      Never link both archive and - re-linked library
      -
      -

      There is never any point to linking both the re-linked (.o) and - the archive (.a) versions of a library. Since the re-linked version - includes the entire library, the archive version will not resolve any symbols. - You could even end up with link error if you place the archive version before - the re-linked version on the linker's command line.

      -
      - -
      -
      -
      - Valid CSS - Valid HTML 4.01 - Reid Spencer -
      -The LLVM Compiler Infrastructure -
      Last modified: $Date$
      - - - Removed: llvm/trunk/docs/WritingAnLLVMBackend.html URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/WritingAnLLVMBackend.html?rev=103212&view=auto ============================================================================== --- llvm/trunk/docs/WritingAnLLVMBackend.html (original) +++ llvm/trunk/docs/WritingAnLLVMBackend.html (removed) @@ -1,2561 +0,0 @@ - - - - - Writing an LLVM Compiler Backend - - - - - -
      - Writing an LLVM Compiler Backend -
      - -
        -
      1. Introduction - -
      2. Target Machine
        3. -
      3. Target Registration
        4. -
      4. Register Set and Register Classes -
        5. -
      5. Instruction Set -
        6. -
      6. Instruction Selector -
        7. -
      7. Assembly Printer
        8. -
      8. Subtarget Support
        9. -
      9. JIT Support -
        10. -
      - -
      -

      Written by Mason Woo and - Misha Brukman

      -
      - - -
      - Introduction -
      - - -
      - -

      -This document describes techniques for writing compiler backends that convert -the LLVM Intermediate Representation (IR) to code for a specified machine or -other languages. Code intended for a specific machine can take the form of -either assembly code or binary code (usable for a JIT compiler). -

      - -

      -The backend of LLVM features a target-independent code generator that may create -output for several types of target CPUs — including X86, PowerPC, Alpha, -and SPARC. The backend may also be used to generate code targeted at SPUs of the -Cell processor or GPUs to support the execution of compute kernels. -

      - -

      -The document focuses on existing examples found in subdirectories -of llvm/lib/Target in a downloaded LLVM release. In particular, this -document focuses on the example of creating a static compiler (one that emits -text assembly) for a SPARC target, because SPARC has fairly standard -characteristics, such as a RISC instruction set and straightforward calling -conventions. -

      - -
      - -
      - Audience -
      - -
      - -

      -The audience for this document is anyone who needs to write an LLVM backend to -generate code for a specific hardware or software target. -

      - -
      - -
      - Prerequisite Reading -
      - -
      - -

      -These essential documents must be read before reading this document: -

      - -
        -
      • LLVM Language Reference - Manual — a reference manual for the LLVM assembly language.
        • - -
      • The LLVM - Target-Independent Code Generator — a guide to the components - (classes and code generation algorithms) for translating the LLVM internal - representation into machine code for a specified target. Pay particular - attention to the descriptions of code generation stages: Instruction - Selection, Scheduling and Formation, SSA-based Optimization, Register - Allocation, Prolog/Epilog Code Insertion, Late Machine Code Optimizations, - and Code Emission.
        • - -
      • TableGen - Fundamentals —a document that describes the TableGen - (tblgen) application that manages domain-specific information to - support LLVM code generation. TableGen processes input from a target - description file (.td suffix) and generates C++ code that can be - used for code generation.
        • - -
      • Writing an LLVM - Pass — The assembly printer is a FunctionPass, as are - several SelectionDAG processing steps.
        • -
      - -

      -To follow the SPARC examples in this document, have a copy of -The SPARC Architecture -Manual, Version 8 for reference. For details about the ARM instruction -set, refer to the ARM Architecture -Reference Manual. For more about the GNU Assembler format -(GAS), see -Using As, -especially for the assembly printer. Using As contains a list of target -machine dependent features. -

      - -
      - -
      - Basic Steps -
      - -
      - -

      -To write a compiler backend for LLVM that converts the LLVM IR to code for a -specified target (machine or other language), follow these steps: -

      - -
        -
      • Create a subclass of the TargetMachine class that describes characteristics - of your target machine. Copy existing examples of specific TargetMachine - class and header files; for example, start with - SparcTargetMachine.cpp and SparcTargetMachine.h, but - change the file names for your target. Similarly, change code that - references "Sparc" to reference your target.
        • - -
      • Describe the register set of the target. Use TableGen to generate code for - register definition, register aliases, and register classes from a - target-specific RegisterInfo.td input file. You should also write - additional code for a subclass of the TargetRegisterInfo class that - represents the class register file data used for register allocation and - also describes the interactions between registers.
        • - -
      • Describe the instruction set of the target. Use TableGen to generate code - for target-specific instructions from target-specific versions of - TargetInstrFormats.td and TargetInstrInfo.td. You should - write additional code for a subclass of the TargetInstrInfo class to - represent machine instructions supported by the target machine.
        • - -
      • Describe the selection and conversion of the LLVM IR from a Directed Acyclic - Graph (DAG) representation of instructions to native target-specific - instructions. Use TableGen to generate code that matches patterns and - selects instructions based on additional information in a target-specific - version of TargetInstrInfo.td. Write code - for XXXISelDAGToDAG.cpp, where XXX identifies the specific target, - to perform pattern matching and DAG-to-DAG instruction selection. Also write - code in XXXISelLowering.cpp to replace or remove operations and - data types that are not supported natively in a SelectionDAG.
        • - -
      • Write code for an assembly printer that converts LLVM IR to a GAS format for - your target machine. You should add assembly strings to the instructions - defined in your target-specific version of TargetInstrInfo.td. You - should also write code for a subclass of AsmPrinter that performs the - LLVM-to-assembly conversion and a trivial subclass of TargetAsmInfo.
        • - -
      • Optionally, add support for subtargets (i.e., variants with different - capabilities). You should also write code for a subclass of the - TargetSubtarget class, which allows you to use the -mcpu= - and -mattr= command-line options.
        • - -
      • Optionally, add JIT support and create a machine code emitter (subclass of - TargetJITInfo) that is used to emit binary code directly into memory.
        • -
      - -

      -In the .cpp and .h. files, initially stub up these methods and -then implement them later. Initially, you may not know which private members -that the class will need and which components will need to be subclassed. -

      - -
      - -
      - Preliminaries -
      - -
      - -

      -To actually create your compiler backend, you need to create and modify a few -files. The absolute minimum is discussed here. But to actually use the LLVM -target-independent code generator, you must perform the steps described in -the LLVM -Target-Independent Code Generator document. -

      - -

      -First, you should create a subdirectory under lib/Target to hold all -the files related to your target. If your target is called "Dummy," create the -directory lib/Target/Dummy. -

      - -

      -In this new -directory, create a Makefile. It is easiest to copy a -Makefile of another target and modify it. It should at least contain -the LEVEL, LIBRARYNAME and TARGET variables, and then -include $(LEVEL)/Makefile.common. The library can be -named LLVMDummy (for example, see the MIPS target). Alternatively, you -can split the library into LLVMDummyCodeGen -and LLVMDummyAsmPrinter, the latter of which should be implemented in a -subdirectory below lib/Target/Dummy (for example, see the PowerPC -target). -

      - -

      -Note that these two naming schemes are hardcoded into llvm-config. -Using any other naming scheme will confuse llvm-config and produce a -lot of (seemingly unrelated) linker errors when linking llc. -

      - -

      -To make your target actually do something, you need to implement a subclass of -TargetMachine. This implementation should typically be in the file -lib/Target/DummyTargetMachine.cpp, but any file in -the lib/Target directory will be built and should work. To use LLVM's -target independent code generator, you should do what all current machine -backends do: create a subclass of LLVMTargetMachine. (To create a -target from scratch, create a subclass of TargetMachine.) -

      - -

      -To get LLVM to actually build and link your target, you need to add it to -the TARGETS_TO_BUILD variable. To do this, you modify the configure -script to know about your target when parsing the --enable-targets -option. Search the configure script for TARGETS_TO_BUILD, add your -target to the lists there (some creativity required), and then -reconfigure. Alternatively, you can change autotools/configure.ac and -regenerate configure by running ./autoconf/AutoRegen.sh. -

      - -
      - - -
      - Target Machine -
      - - -
      - -

      -LLVMTargetMachine is designed as a base class for targets implemented -with the LLVM target-independent code generator. The LLVMTargetMachine -class should be specialized by a concrete target class that implements the -various virtual methods. LLVMTargetMachine is defined as a subclass of -TargetMachine in include/llvm/Target/TargetMachine.h. The -TargetMachine class implementation (TargetMachine.cpp) also -processes numerous command-line options. -

      - -

      -To create a concrete target-specific subclass of LLVMTargetMachine, -start by copying an existing TargetMachine class and header. You -should name the files that you create to reflect your specific target. For -instance, for the SPARC target, name the files SparcTargetMachine.h and -SparcTargetMachine.cpp. -

      - -

      -For a target machine XXX, the implementation of -XXXTargetMachine must have access methods to obtain objects that -represent target components. These methods are named get*Info, and are -intended to obtain the instruction set (getInstrInfo), register set -(getRegisterInfo), stack frame layout (getFrameInfo), and -similar information. XXXTargetMachine must also implement the -getTargetData method to access an object with target-specific data -characteristics, such as data type size and alignment requirements. -

      - -

      -For instance, for the SPARC target, the header file -SparcTargetMachine.h declares prototypes for several get*Info -and getTargetData methods that simply return a class member. -

      - -
      -
      -namespace llvm {
-
-class Module;
-
-class SparcTargetMachine : public LLVMTargetMachine {
-  const TargetData DataLayout;       // Calculates type size & alignment
-  SparcSubtarget Subtarget;
-  SparcInstrInfo InstrInfo;
-  TargetFrameInfo FrameInfo;
-  
-protected:
-  virtual const TargetAsmInfo *createTargetAsmInfo() const;
-  
-public:
-  SparcTargetMachine(const Module &M, const std::string &FS);
-
-  virtual const SparcInstrInfo *getInstrInfo() const {return &InstrInfo; }
-  virtual const TargetFrameInfo *getFrameInfo() const {return &FrameInfo; }
-  virtual const TargetSubtarget *getSubtargetImpl() const{return &Subtarget; }
-  virtual const TargetRegisterInfo *getRegisterInfo() const {
-    return &InstrInfo.getRegisterInfo();
-  }
-  virtual const TargetData *getTargetData() const { return &DataLayout; }
-  static unsigned getModuleMatchQuality(const Module &M);
-
-  // Pass Pipeline Configuration
-  virtual bool addInstSelector(PassManagerBase &PM, bool Fast);
-  virtual bool addPreEmitPass(PassManagerBase &PM, bool Fast);
-};
-
-} // end namespace llvm
-
      -
      - -
      - - -
      - -
        -
      • getInstrInfo()
        • -
      • getRegisterInfo()
        • -
      • getFrameInfo()
        • -
      • getTargetData()
        • -
      • getSubtargetImpl()
        • -
      - -

      For some targets, you also need to support the following methods:

      - -
        -
      • getTargetLowering()
        • -
      • getJITInfo()
        • -
      - -

      -In addition, the XXXTargetMachine constructor should specify a -TargetDescription string that determines the data layout for the target -machine, including characteristics such as pointer size, alignment, and -endianness. For example, the constructor for SparcTargetMachine contains the -following: -

      - -
      -
      -SparcTargetMachine::SparcTargetMachine(const Module &M, const std::string &FS)
-  : DataLayout("E-p:32:32-f128:128:128"),
-    Subtarget(M, FS), InstrInfo(Subtarget),
-    FrameInfo(TargetFrameInfo::StackGrowsDown, 8, 0) {
-}
-
      -
      - -
      - -
      - -

      Hyphens separate portions of the TargetDescription string.

      - -
        -
      • An upper-case "E" in the string indicates a big-endian target data - model. a lower-case "e" indicates little-endian.
        • - -
      • "p:" is followed by pointer information: size, ABI alignment, and - preferred alignment. If only two figures follow "p:", then the - first value is pointer size, and the second value is both ABI and preferred - alignment.
        • - -
      • Then a letter for numeric type alignment: "i", "f", - "v", or "a" (corresponding to integer, floating point, - vector, or aggregate). "i", "v", or "a" are - followed by ABI alignment and preferred alignment. "f" is followed - by three values: the first indicates the size of a long double, then ABI - alignment, and then ABI preferred alignment.
        • -
      - -
      - - -
      - Target Registration -
      - - -
      - -

      -You must also register your target with the TargetRegistry, which is -what other LLVM tools use to be able to lookup and use your target at -runtime. The TargetRegistry can be used directly, but for most targets -there are helper templates which should take care of the work for you.

      - -

      -All targets should declare a global Target object which is used to -represent the target during registration. Then, in the target's TargetInfo -library, the target should define that object and use -the RegisterTarget template to register the target. For example, the Sparc registration code looks like this: -

      - -
      -
      -Target llvm::TheSparcTarget;
-
-extern "C" void LLVMInitializeSparcTargetInfo() { 
-  RegisterTarget<Triple::sparc, /*HasJIT=*/false>
-    X(TheSparcTarget, "sparc", "Sparc");
-}
-
      -
      - -

      -This allows the TargetRegistry to look up the target by name or by -target triple. In addition, most targets will also register additional features -which are available in separate libraries. These registration steps are -separate, because some clients may wish to only link in some parts of the target --- the JIT code generator does not require the use of the assembler printer, for -example. Here is an example of registering the Sparc assembly printer: -

      - -
      -
      -extern "C" void LLVMInitializeSparcAsmPrinter() { 
-  RegisterAsmPrinter<SparcAsmPrinter> X(TheSparcTarget);
-}
-
      -
      - -

      -For more information, see -"llvm/Target/TargetRegistry.h". -

      - -
      - - -
      - Register Set and Register Classes -
      - - -
      - -

      -You should describe a concrete target-specific class that represents the -register file of a target machine. This class is called XXXRegisterInfo -(where XXX identifies the target) and represents the class register -file data that is used for register allocation. It also describes the -interactions between registers. -

      - -

      -You also need to define register classes to categorize related registers. A -register class should be added for groups of registers that are all treated the -same way for some instruction. Typical examples are register classes for -integer, floating-point, or vector registers. A register allocator allows an -instruction to use any register in a specified register class to perform the -instruction in a similar manner. Register classes allocate virtual registers to -instructions from these sets, and register classes let the target-independent -register allocator automatically choose the actual registers. -

      - -

      -Much of the code for registers, including register definition, register aliases, -and register classes, is generated by TableGen from XXXRegisterInfo.td -input files and placed in XXXGenRegisterInfo.h.inc and -XXXGenRegisterInfo.inc output files. Some of the code in the -implementation of XXXRegisterInfo requires hand-coding. -

      - -
      - - -
      - Defining a Register -
      - -
      - -

      -The XXXRegisterInfo.td file typically starts with register definitions -for a target machine. The Register class (specified -in Target.td) is used to define an object for each register. The -specified string n becomes the Name of the register. The -basic Register object does not have any subregisters and does not -specify any aliases. -

      - -
      -
      -class Register<string n> {
-  string Namespace = "";
-  string AsmName = n;
-  string Name = n;
-  int SpillSize = 0;
-  int SpillAlignment = 0;
-  list<Register> Aliases = [];
-  list<Register> SubRegs = [];
-  list<int> DwarfNumbers = [];
-}
-
      -
      - -

      -For example, in the X86RegisterInfo.td file, there are register -definitions that utilize the Register class, such as: -

      - -
      -
      -def AL : Register<"AL">, DwarfRegNum<[0, 0, 0]>;
-
      -
      - -

      -This defines the register AL and assigns it values (with -DwarfRegNum) that are used by gcc, gdb, or a debug -information writer to identify a register. For register -AL, DwarfRegNum takes an array of 3 values representing 3 -different modes: the first element is for X86-64, the second for exception -handling (EH) on X86-32, and the third is generic. -1 is a special Dwarf number -that indicates the gcc number is undefined, and -2 indicates the register number -is invalid for this mode. -

      - -

      -From the previously described line in the X86RegisterInfo.td file, -TableGen generates this code in the X86GenRegisterInfo.inc file: -

      - -
      -
      -static const unsigned GR8[] = { X86::AL, ... };
-
-const unsigned AL_AliasSet[] = { X86::AX, X86::EAX, X86::RAX, 0 };
-
-const TargetRegisterDesc RegisterDescriptors[] = { 
-  ...
-{ "AL", "AL", AL_AliasSet, Empty_SubRegsSet, Empty_SubRegsSet, AL_SuperRegsSet }, ...
-
      -
      - -

      -From the register info file, TableGen generates a TargetRegisterDesc -object for each register. TargetRegisterDesc is defined in -include/llvm/Target/TargetRegisterInfo.h with the following fields: -

      - -
      -
      -struct TargetRegisterDesc {
-  const char     *AsmName;      // Assembly language name for the register
-  const char     *Name;         // Printable name for the reg (for debugging)
-  const unsigned *AliasSet;     // Register Alias Set
-  const unsigned *SubRegs;      // Sub-register set
-  const unsigned *ImmSubRegs;   // Immediate sub-register set
-  const unsigned *SuperRegs;    // Super-register set
-};
      -
      - -

      -TableGen uses the entire target description file (.td) to determine -text names for the register (in the AsmName and Name fields of -TargetRegisterDesc) and the relationships of other registers to the -defined register (in the other TargetRegisterDesc fields). In this -example, other definitions establish the registers "AX", -"EAX", and "RAX" as aliases for one another, so TableGen -generates a null-terminated array (AL_AliasSet) for this register alias -set. -

      - -

      -The Register class is commonly used as a base class for more complex -classes. In Target.td, the Register class is the base for the -RegisterWithSubRegs class that is used to define registers that need to -specify subregisters in the SubRegs list, as shown here: -

      - -
      -
      -class RegisterWithSubRegs<string n,
-list<Register> subregs> : Register<n> {
-  let SubRegs = subregs;
-}
-
      -
      - -

      -In SparcRegisterInfo.td, additional register classes are defined for -SPARC: a Register subclass, SparcReg, and further subclasses: Ri, -Rf, and Rd. SPARC registers are identified by 5-bit ID -numbers, which is a feature common to these subclasses. Note the use of -'let' expressions to override values that are initially defined in a -superclass (such as SubRegs field in the Rd class). -

      - -
      -
      -class SparcReg<string n> : Register<n> {
-  field bits<5> Num;
-  let Namespace = "SP";
-}
-// Ri - 32-bit integer registers
-class Ri<bits<5> num, string n> :
-SparcReg<n> {
-  let Num = num;
-}
-// Rf - 32-bit floating-point registers
-class Rf<bits<5> num, string n> :
-SparcReg<n> {
-  let Num = num;
-}
-// Rd - Slots in the FP register file for 64-bit
-floating-point values.
-class Rd<bits<5> num, string n,
-list<Register> subregs> : SparcReg<n> {
-  let Num = num;
-  let SubRegs = subregs;
-}
-
      -
      - -

      -In the SparcRegisterInfo.td file, there are register definitions that -utilize these subclasses of Register, such as: -

      - -
      -
      -def G0 : Ri< 0, "G0">,
-DwarfRegNum<[0]>;
-def G1 : Ri< 1, "G1">, DwarfRegNum<[1]>;
-...
-def F0 : Rf< 0, "F0">,
-DwarfRegNum<[32]>;
-def F1 : Rf< 1, "F1">,
-DwarfRegNum<[33]>;
-...
-def D0 : Rd< 0, "F0", [F0, F1]>,
-DwarfRegNum<[32]>;
-def D1 : Rd< 2, "F2", [F2, F3]>,
-DwarfRegNum<[34]>;
-
      -
      - -

      -The last two registers shown above (D0 and D1) are -double-precision floating-point registers that are aliases for pairs of -single-precision floating-point sub-registers. In addition to aliases, the -sub-register and super-register relationships of the defined register are in -fields of a register's TargetRegisterDesc. -

      - -
      - - -
      - Defining a Register Class -
      - -
      - -

      -The RegisterClass class (specified in Target.td) is used to -define an object that represents a group of related registers and also defines -the default allocation order of the registers. A target description file -XXXRegisterInfo.td that uses Target.td can construct register -classes using the following class: -

      - -
      -
      -class RegisterClass<string namespace,
-list<ValueType> regTypes, int alignment,
-                    list<Register> regList> {
-  string Namespace = namespace;
-  list<ValueType> RegTypes = regTypes;
-  int Size = 0;  // spill size, in bits; zero lets tblgen pick the size
-  int Alignment = alignment;
-
-  // CopyCost is the cost of copying a value between two registers
-  // default value 1 means a single instruction
-  // A negative value means copying is extremely expensive or impossible
-  int CopyCost = 1;  
-  list<Register> MemberList = regList;
-  
-  // for register classes that are subregisters of this class
-  list<RegisterClass> SubRegClassList = [];  
-  
-  code MethodProtos = [{}];  // to insert arbitrary code
-  code MethodBodies = [{}];
-}
-
      -
      - -

      To define a RegisterClass, use the following 4 arguments:

      - -
        -
      • The first argument of the definition is the name of the namespace.
        • - -
      • The second argument is a list of ValueType register type values - that are defined in include/llvm/CodeGen/ValueTypes.td. Defined - values include integer types (such as i16, i32, - and i1 for Boolean), floating-point types - (f32, f64), and vector types (for example, v8i16 - for an 8 x i16 vector). All registers in a RegisterClass - must have the same ValueType, but some registers may store vector - data in different configurations. For example a register that can process a - 128-bit vector may be able to handle 16 8-bit integer elements, 8 16-bit - integers, 4 32-bit integers, and so on.
        • - -
      • The third argument of the RegisterClass definition specifies the - alignment required of the registers when they are stored or loaded to - memory.
        • - -
      • The final argument, regList, specifies which registers are in this - class. If an allocation_order_* method is not specified, - then regList also defines the order of allocation used by the - register allocator.
        • -
      - -

      -In SparcRegisterInfo.td, three RegisterClass objects are defined: -FPRegs, DFPRegs, and IntRegs. For all three register -classes, the first argument defines the namespace with the string -'SP'. FPRegs defines a group of 32 single-precision -floating-point registers (F0 to F31); DFPRegs defines -a group of 16 double-precision registers -(D0-D15). For IntRegs, the MethodProtos -and MethodBodies methods are used by TableGen to insert the specified -code into generated output. -

      - -
      -
      -def FPRegs : RegisterClass<"SP", [f32], 32,
-  [F0, F1, F2, F3, F4, F5, F6, F7, F8, F9, F10, F11, F12, F13, F14, F15,
-   F16, F17, F18, F19, F20, F21, F22, F23, F24, F25, F26, F27, F28, F29, F30, F31]>;
-
-def DFPRegs : RegisterClass<"SP", [f64], 64,
-  [D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15]>;
- 
-def IntRegs : RegisterClass<"SP", [i32], 32,
-    [L0, L1, L2, L3, L4, L5, L6, L7,
-     I0, I1, I2, I3, I4, I5,
-     O0, O1, O2, O3, O4, O5, O7,
-     G1,
-     // Non-allocatable regs:
-     G2, G3, G4, 
-     O6,        // stack ptr
-    I6,        // frame ptr
-     I7,        // return address
-     G0,        // constant zero
-     G5, G6, G7 // reserved for kernel
-    ]> {
-  let MethodProtos = [{
-    iterator allocation_order_end(const MachineFunction &MF) const;
-  }];
-  let MethodBodies = [{
-    IntRegsClass::iterator
-    IntRegsClass::allocation_order_end(const MachineFunction &MF) const {
-      return end() - 10  // Don't allocate special registers
-         -1;
-    }
-  }];
-}
-
      -
      - -

      -Using SparcRegisterInfo.td with TableGen generates several output files -that are intended for inclusion in other source code that you write. -SparcRegisterInfo.td generates SparcGenRegisterInfo.h.inc, -which should be included in the header file for the implementation of the SPARC -register implementation that you write (SparcRegisterInfo.h). In -SparcGenRegisterInfo.h.inc a new structure is defined called -SparcGenRegisterInfo that uses TargetRegisterInfo as its -base. It also specifies types, based upon the defined register -classes: DFPRegsClass, FPRegsClass, and IntRegsClass. -

      - -

      -SparcRegisterInfo.td also generates SparcGenRegisterInfo.inc, -which is included at the bottom of SparcRegisterInfo.cpp, the SPARC -register implementation. The code below shows only the generated integer -registers and associated register classes. The order of registers -in IntRegs reflects the order in the definition of IntRegs in -the target description file. Take special note of the use -of MethodBodies in SparcRegisterInfo.td to create code in -SparcGenRegisterInfo.inc. MethodProtos generates similar code -in SparcGenRegisterInfo.h.inc. -

      - -
      -
        // IntRegs Register Class...
-  static const unsigned IntRegs[] = {
-    SP::L0, SP::L1, SP::L2, SP::L3, SP::L4, SP::L5,
-    SP::L6, SP::L7, SP::I0, SP::I1, SP::I2, SP::I3,
-    SP::I4, SP::I5, SP::O0, SP::O1, SP::O2, SP::O3,
-    SP::O4, SP::O5, SP::O7, SP::G1, SP::G2, SP::G3,
-    SP::G4, SP::O6, SP::I6, SP::I7, SP::G0, SP::G5,
-    SP::G6, SP::G7, 
-  };
-
-  // IntRegsVTs Register Class Value Types...
-  static const MVT::ValueType IntRegsVTs[] = {
-    MVT::i32, MVT::Other
-  };
-
-namespace SP {   // Register class instances
-  DFPRegsClass    DFPRegsRegClass;
-  FPRegsClass     FPRegsRegClass;
-  IntRegsClass    IntRegsRegClass;
-...
-  // IntRegs Sub-register Classess...
-  static const TargetRegisterClass* const IntRegsSubRegClasses [] = {
-    NULL
-  };
-...
-  // IntRegs Super-register Classess...
-  static const TargetRegisterClass* const IntRegsSuperRegClasses [] = {
-    NULL
-  };
-...
-  // IntRegs Register Class sub-classes...
-  static const TargetRegisterClass* const IntRegsSubclasses [] = {
-    NULL
-  };
-...
-  // IntRegs Register Class super-classes...
-  static const TargetRegisterClass* const IntRegsSuperclasses [] = {
-    NULL
-  };
-...
-  IntRegsClass::iterator
-  IntRegsClass::allocation_order_end(const MachineFunction &MF) const {
-     return end()-10  // Don't allocate special registers
-         -1;
-  }
-  
-  IntRegsClass::IntRegsClass() : TargetRegisterClass(IntRegsRegClassID, 
-    IntRegsVTs, IntRegsSubclasses, IntRegsSuperclasses, IntRegsSubRegClasses, 
-    IntRegsSuperRegClasses, 4, 4, 1, IntRegs, IntRegs + 32) {}
-}
-
      -
      - -
      - - -
      - Implement a subclass of - TargetRegisterInfo -
      - -
      - -

      -The final step is to hand code portions of XXXRegisterInfo, which -implements the interface described in TargetRegisterInfo.h. These -functions return 0, NULL, or false, unless -overridden. Here is a list of functions that are overridden for the SPARC -implementation in SparcRegisterInfo.cpp: -

      - -
        -
      • getCalleeSavedRegs — Returns a list of callee-saved registers - in the order of the desired callee-save stack frame offset.
        • - -
      • getCalleeSavedRegClasses — Returns a list of preferred - register classes with which to spill each callee saved register.
        • - -
      • getReservedRegs — Returns a bitset indexed by physical - register numbers, indicating if a particular register is unavailable.
        • - -
      • hasFP — Return a Boolean indicating if a function should have - a dedicated frame pointer register.
        • - -
      • eliminateCallFramePseudoInstr — If call frame setup or - destroy pseudo instructions are used, this can be called to eliminate - them.
        • - -
      • eliminateFrameIndex — Eliminate abstract frame indices from - instructions that may use them.
        • - -
      • emitPrologue — Insert prologue code into the function.
        • - -
      • emitEpilogue — Insert epilogue code into the function.
        • -
      - -
      - - -
      - Instruction Set -
      - - -
      - -

      -During the early stages of code generation, the LLVM IR code is converted to a -SelectionDAG with nodes that are instances of the SDNode class -containing target instructions. An SDNode has an opcode, operands, type -requirements, and operation properties. For example, is an operation -commutative, does an operation load from memory. The various operation node -types are described in the include/llvm/CodeGen/SelectionDAGNodes.h -file (values of the NodeType enum in the ISD namespace). -

      - -

      -TableGen uses the following target description (.td) input files to -generate much of the code for instruction definition: -

      - -
        -
      • Target.td — Where the Instruction, Operand, - InstrInfo, and other fundamental classes are defined.
        • - -
      • TargetSelectionDAG.td— Used by SelectionDAG - instruction selection generators, contains SDTC* classes (selection - DAG type constraint), definitions of SelectionDAG nodes (such as - imm, cond, bb, add, fadd, - sub), and pattern support (Pattern, Pat, - PatFrag, PatLeaf, ComplexPattern.
        • - -
      • XXXInstrFormats.td — Patterns for definitions of - target-specific instructions.
        • - -
      • XXXInstrInfo.td — Target-specific definitions of instruction - templates, condition codes, and instructions of an instruction set. For - architecture modifications, a different file name may be used. For example, - for Pentium with SSE instruction, this file is X86InstrSSE.td, and - for Pentium with MMX, this file is X86InstrMMX.td.
        • -
      - -

      -There is also a target-specific XXX.td file, where XXX is the -name of the target. The XXX.td file includes the other .td -input files, but its contents are only directly important for subtargets. -

      - -

      -You should describe a concrete target-specific class XXXInstrInfo that -represents machine instructions supported by a target machine. -XXXInstrInfo contains an array of XXXInstrDescriptor objects, -each of which describes one instruction. An instruction descriptor defines:

      - -
        -
      • Opcode mnemonic
        • - -
      • Number of operands
        • - -
      • List of implicit register definitions and uses
        • - -
      • Target-independent properties (such as memory access, is commutable)
        • - -
      • Target-specific flags
        • -
      - -

      -The Instruction class (defined in Target.td) is mostly used as a base -for more complex instruction classes. -

      - -
      -
      class Instruction {
-  string Namespace = "";
-  dag OutOperandList;       // An dag containing the MI def operand list.
-  dag InOperandList;        // An dag containing the MI use operand list.
-  string AsmString = "";    // The .s format to print the instruction with.
-  list<dag> Pattern;  // Set to the DAG pattern for this instruction
-  list<Register> Uses = []; 
-  list<Register> Defs = [];
-  list<Predicate> Predicates = [];  // predicates turned into isel match code
-  ... remainder not shown for space ...
-}
-
      -
      - -

      -A SelectionDAG node (SDNode) should contain an object -representing a target-specific instruction that is defined -in XXXInstrInfo.td. The instruction objects should represent -instructions from the architecture manual of the target machine (such as the -SPARC Architecture Manual for the SPARC target). -

      - -

      -A single instruction from the architecture manual is often modeled as multiple -target instructions, depending upon its operands. For example, a manual might -describe an add instruction that takes a register or an immediate operand. An -LLVM target could model this with two instructions named ADDri and -ADDrr. -

      - -

      -You should define a class for each instruction category and define each opcode -as a subclass of the category with appropriate parameters such as the fixed -binary encoding of opcodes and extended opcodes. You should map the register -bits to the bits of the instruction in which they are encoded (for the -JIT). Also you should specify how the instruction should be printed when the -automatic assembly printer is used. -

      - -

      -As is described in the SPARC Architecture Manual, Version 8, there are three -major 32-bit formats for instructions. Format 1 is only for the CALL -instruction. Format 2 is for branch on condition codes and SETHI (set -high bits of a register) instructions. Format 3 is for other instructions. -

      - -

      -Each of these formats has corresponding classes in SparcInstrFormat.td. -InstSP is a base class for other instruction classes. Additional base -classes are specified for more precise formats: for example -in SparcInstrFormat.td, F2_1 is for SETHI, -and F2_2 is for branches. There are three other base -classes: F3_1 for register/register operations, F3_2 for -register/immediate operations, and F3_3 for floating-point -operations. SparcInstrInfo.td also adds the base class Pseudo for -synthetic SPARC instructions. -

      - -

      -SparcInstrInfo.td largely consists of operand and instruction -definitions for the SPARC target. In SparcInstrInfo.td, the following -target description file entry, LDrr, defines the Load Integer -instruction for a Word (the LD SPARC opcode) from a memory address to a -register. The first parameter, the value 3 (112), is the -operation value for this category of operation. The second parameter -(0000002) is the specific operation value -for LD/Load Word. The third parameter is the output destination, which -is a register operand and defined in the Register target description -file (IntRegs). -

      - -
      -
      def LDrr : F3_1 <3, 0b000000, (outs IntRegs:$dst), (ins MEMrr:$addr),
-                 "ld [$addr], $dst",
-                 [(set IntRegs:$dst, (load ADDRrr:$addr))]>;
-
      -
      - -

      -The fourth parameter is the input source, which uses the address -operand MEMrr that is defined earlier in SparcInstrInfo.td: -

      - -
      -
      def MEMrr : Operand<i32> {
-  let PrintMethod = "printMemOperand";
-  let MIOperandInfo = (ops IntRegs, IntRegs);
-}
-
      -
      - -

      -The fifth parameter is a string that is used by the assembly printer and can be -left as an empty string until the assembly printer interface is implemented. The -sixth and final parameter is the pattern used to match the instruction during -the SelectionDAG Select Phase described in -(The LLVM -Target-Independent Code Generator). This parameter is detailed in the next -section, Instruction Selector. -

      - -

      -Instruction class definitions are not overloaded for different operand types, so -separate versions of instructions are needed for register, memory, or immediate -value operands. For example, to perform a Load Integer instruction for a Word -from an immediate operand to a register, the following instruction class is -defined: -

      - -
      -
      def LDri : F3_2 <3, 0b000000, (outs IntRegs:$dst), (ins MEMri:$addr),
-                 "ld [$addr], $dst",
-                 [(set IntRegs:$dst, (load ADDRri:$addr))]>;
-
      -
      - -

      -Writing these definitions for so many similar instructions can involve a lot of -cut and paste. In td files, the multiclass directive enables the -creation of templates to define several instruction classes at once (using -the defm directive). For example in SparcInstrInfo.td, the -multiclass pattern F3_12 is defined to create 2 instruction -classes each time F3_12 is invoked: -

      - -
      -
      multiclass F3_12 <string OpcStr, bits<6> Op3Val, SDNode OpNode> {
-  def rr  : F3_1 <2, Op3Val, 
-                 (outs IntRegs:$dst), (ins IntRegs:$b, IntRegs:$c),
-                 !strconcat(OpcStr, " $b, $c, $dst"),
-                 [(set IntRegs:$dst, (OpNode IntRegs:$b, IntRegs:$c))]>;
-  def ri  : F3_2 <2, Op3Val,
-                 (outs IntRegs:$dst), (ins IntRegs:$b, i32imm:$c),
-                 !strconcat(OpcStr, " $b, $c, $dst"),
-                 [(set IntRegs:$dst, (OpNode IntRegs:$b, simm13:$c))]>;
-}
-
      -
      - -

      -So when the defm directive is used for the XOR -and ADD instructions, as seen below, it creates four instruction -objects: XORrr, XORri, ADDrr, and ADDri. -

      - -
      -
      -defm XOR   : F3_12<"xor", 0b000011, xor>;
-defm ADD   : F3_12<"add", 0b000000, add>;
-
      -
      - -

      -SparcInstrInfo.td also includes definitions for condition codes that -are referenced by branch instructions. The following definitions -in SparcInstrInfo.td indicate the bit location of the SPARC condition -code. For example, the 10th bit represents the 'greater than' -condition for integers, and the 22nd bit represents the 'greater -than' condition for floats. -

      - -
      -
      -def ICC_NE  : ICC_VAL< 9>;  // Not Equal
-def ICC_E   : ICC_VAL< 1>;  // Equal
-def ICC_G   : ICC_VAL<10>;  // Greater
-...
-def FCC_U   : FCC_VAL<23>;  // Unordered
-def FCC_G   : FCC_VAL<22>;  // Greater
-def FCC_UG  : FCC_VAL<21>;  // Unordered or Greater
-...
-
      -
      - -

      -(Note that Sparc.h also defines enums that correspond to the same SPARC -condition codes. Care must be taken to ensure the values in Sparc.h -correspond to the values in SparcInstrInfo.td. I.e., -SPCC::ICC_NE = 9, SPCC::FCC_U = 23 and so on.) -

      - -
      - - -
      - Instruction Operand Mapping -
      - -
      - -

      -The code generator backend maps instruction operands to fields in the -instruction. Operands are assigned to unbound fields in the instruction in the -order they are defined. Fields are bound when they are assigned a value. For -example, the Sparc target defines the XNORrr instruction as -a F3_1 format instruction having three operands. -

      - -
      -
      -def XNORrr  : F3_1<2, 0b000111,
-                   (outs IntRegs:$dst), (ins IntRegs:$b, IntRegs:$c),
-                   "xnor $b, $c, $dst",
-                   [(set IntRegs:$dst, (not (xor IntRegs:$b, IntRegs:$c)))]>;
-
      -
      - -

      -The instruction templates in SparcInstrFormats.td show the base class -for F3_1 is InstSP. -

      - -
      -
      -class InstSP<dag outs, dag ins, string asmstr, list<dag> pattern> : Instruction {
-  field bits<32> Inst;
-  let Namespace = "SP";
-  bits<2> op;
-  let Inst{31-30} = op;       
-  dag OutOperandList = outs;
-  dag InOperandList = ins;
-  let AsmString   = asmstr;
-  let Pattern = pattern;
-}
-
      -
      - -

      InstSP leaves the op field unbound.

      - -
      -
      -class F3<dag outs, dag ins, string asmstr, list<dag> pattern>
-    : InstSP<outs, ins, asmstr, pattern> {
-  bits<5> rd;
-  bits<6> op3;
-  bits<5> rs1;
-  let op{1} = 1;   // Op = 2 or 3
-  let Inst{29-25} = rd;
-  let Inst{24-19} = op3;
-  let Inst{18-14} = rs1;
-}
-
      -
      - -

      -F3 binds the op field and defines the rd, -op3, and rs1 fields. F3 format instructions will -bind the operands rd, op3, and rs1 fields. -

      - -
      -
      -class F3_1<bits<2> opVal, bits<6> op3val, dag outs, dag ins,
-           string asmstr, list<dag> pattern> : F3<outs, ins, asmstr, pattern> {
-  bits<8> asi = 0; // asi not currently used
-  bits<5> rs2;
-  let op         = opVal;
-  let op3        = op3val;
-  let Inst{13}   = 0;     // i field = 0
-  let Inst{12-5} = asi;   // address space identifier
-  let Inst{4-0}  = rs2;
-}
-
      -
      - -

      -F3_1 binds the op3 field and defines the rs2 -fields. F3_1 format instructions will bind the operands to the rd, -rs1, and rs2 fields. This results in the XNORrr -instruction binding $dst, $b, and $c operands to -the rd, rs1, and rs2 fields respectively. -

      - -
      - - -
      - Implement a subclass of - TargetInstrInfo -
      - -
      - -

      -The final step is to hand code portions of XXXInstrInfo, which -implements the interface described in TargetInstrInfo.h. These -functions return 0 or a Boolean or they assert, unless -overridden. Here's a list of functions that are overridden for the SPARC -implementation in SparcInstrInfo.cpp: -

      - -
        -
      • isMoveInstr — Return true if the instruction is a register to - register move; false, otherwise.
        • - -
      • isLoadFromStackSlot — If the specified machine instruction is - a direct load from a stack slot, return the register number of the - destination and the FrameIndex of the stack slot.
        • - -
      • isStoreToStackSlot — If the specified machine instruction is - a direct store to a stack slot, return the register number of the - destination and the FrameIndex of the stack slot.
        • - -
      • copyRegToReg — Copy values between a pair of registers.
        • - -
      • storeRegToStackSlot — Store a register value to a stack - slot.
        • - -
      • loadRegFromStackSlot — Load a register value from a stack - slot.
        • - -
      • storeRegToAddr — Store a register value to memory.
        • - -
      • loadRegFromAddr — Load a register value from memory.
        • - -
      • foldMemoryOperand — Attempt to combine instructions of any - load or store instruction for the specified operand(s).
        • -
      - -
      - - -
      - Branch Folding and If Conversion -
      -
      - -

      -Performance can be improved by combining instructions or by eliminating -instructions that are never reached. The AnalyzeBranch method -in XXXInstrInfo may be implemented to examine conditional instructions -and remove unnecessary instructions. AnalyzeBranch looks at the end of -a machine basic block (MBB) for opportunities for improvement, such as branch -folding and if conversion. The BranchFolder and IfConverter -machine function passes (see the source files BranchFolding.cpp and -IfConversion.cpp in the lib/CodeGen directory) call -AnalyzeBranch to improve the control flow graph that represents the -instructions. -

      - -

      -Several implementations of AnalyzeBranch (for ARM, Alpha, and X86) can -be examined as models for your own AnalyzeBranch implementation. Since -SPARC does not implement a useful AnalyzeBranch, the ARM target -implementation is shown below. -

      - -

      AnalyzeBranch returns a Boolean value and takes four parameters:

      - -
        -
      • MachineBasicBlock &MBB — The incoming block to be - examined.
        • - -
      • MachineBasicBlock *&TBB — A destination block that is - returned. For a conditional branch that evaluates to true, TBB is - the destination.
        • - -
      • MachineBasicBlock *&FBB — For a conditional branch that - evaluates to false, FBB is returned as the destination.
        • - -
      • std::vector<MachineOperand> &Cond — List of - operands to evaluate a condition for a conditional branch.
        • -
      - -

      -In the simplest case, if a block ends without a branch, then it falls through to -the successor block. No destination blocks are specified for either TBB -or FBB, so both parameters return NULL. The start of -the AnalyzeBranch (see code below for the ARM target) shows the -function parameters and the code for the simplest case. -

      - -
      -
      bool ARMInstrInfo::AnalyzeBranch(MachineBasicBlock &MBB,
-        MachineBasicBlock *&TBB, MachineBasicBlock *&FBB,
-        std::vector<MachineOperand> &Cond) const
-{
-  MachineBasicBlock::iterator I = MBB.end();
-  if (I == MBB.begin() || !isUnpredicatedTerminator(--I))
-    return false;
-
      -
      - -

      -If a block ends with a single unconditional branch instruction, then -AnalyzeBranch (shown below) should return the destination of that -branch in the TBB parameter. -

      - -
      -
      -  if (LastOpc == ARM::B || LastOpc == ARM::tB) {
-    TBB = LastInst->getOperand(0).getMBB();
-    return false;
-  }
-
      -
      - -

      -If a block ends with two unconditional branches, then the second branch is never -reached. In that situation, as shown below, remove the last branch instruction -and return the penultimate branch in the TBB parameter. -

      - -
      -
      -  if ((SecondLastOpc == ARM::B || SecondLastOpc==ARM::tB) &&
-      (LastOpc == ARM::B || LastOpc == ARM::tB)) {
-    TBB = SecondLastInst->getOperand(0).getMBB();
-    I = LastInst;
-    I->eraseFromParent();
-    return false;
-  }
-
      -
      - -

      -A block may end with a single conditional branch instruction that falls through -to successor block if the condition evaluates to false. In that case, -AnalyzeBranch (shown below) should return the destination of that -conditional branch in the TBB parameter and a list of operands in -the Cond parameter to evaluate the condition. -

      - -
      -
      -  if (LastOpc == ARM::Bcc || LastOpc == ARM::tBcc) {
-    // Block ends with fall-through condbranch.
-    TBB = LastInst->getOperand(0).getMBB();
-    Cond.push_back(LastInst->getOperand(1));
-    Cond.push_back(LastInst->getOperand(2));
-    return false;
-  }
-
      -
      - -

      -If a block ends with both a conditional branch and an ensuing unconditional -branch, then AnalyzeBranch (shown below) should return the conditional -branch destination (assuming it corresponds to a conditional evaluation of -'true') in the TBB parameter and the unconditional branch -destination in the FBB (corresponding to a conditional evaluation of -'false'). A list of operands to evaluate the condition should be -returned in the Cond parameter. -

      - -
      -
      -  unsigned SecondLastOpc = SecondLastInst->getOpcode();
-
-  if ((SecondLastOpc == ARM::Bcc && LastOpc == ARM::B) ||
-      (SecondLastOpc == ARM::tBcc && LastOpc == ARM::tB)) {
-    TBB =  SecondLastInst->getOperand(0).getMBB();
-    Cond.push_back(SecondLastInst->getOperand(1));
-    Cond.push_back(SecondLastInst->getOperand(2));
-    FBB = LastInst->getOperand(0).getMBB();
-    return false;
-  }
-
      -
      - -

      -For the last two cases (ending with a single conditional branch or ending with -one conditional and one unconditional branch), the operands returned in -the Cond parameter can be passed to methods of other instructions to -create new branches or perform other operations. An implementation -of AnalyzeBranch requires the helper methods RemoveBranch -and InsertBranch to manage subsequent operations. -

      - -

      -AnalyzeBranch should return false indicating success in most circumstances. -AnalyzeBranch should only return true when the method is stumped about what to -do, for example, if a block has three terminating branches. AnalyzeBranch may -return true if it encounters a terminator it cannot handle, such as an indirect -branch. -

      - -
      - - -
      - Instruction Selector -
      - - -
      - -

      -LLVM uses a SelectionDAG to represent LLVM IR instructions, and nodes -of the SelectionDAG ideally represent native target -instructions. During code generation, instruction selection passes are performed -to convert non-native DAG instructions into native target-specific -instructions. The pass described in XXXISelDAGToDAG.cpp is used to -match patterns and perform DAG-to-DAG instruction selection. Optionally, a pass -may be defined (in XXXBranchSelector.cpp) to perform similar DAG-to-DAG -operations for branch instructions. Later, the code in -XXXISelLowering.cpp replaces or removes operations and data types not -supported natively (legalizes) in a SelectionDAG. -

      - -

      -TableGen generates code for instruction selection using the following target -description input files: -

      - -
        -
      • XXXInstrInfo.td — Contains definitions of instructions in a - target-specific instruction set, generates XXXGenDAGISel.inc, which - is included in XXXISelDAGToDAG.cpp.
        • - -
      • XXXCallingConv.td — Contains the calling and return value - conventions for the target architecture, and it generates - XXXGenCallingConv.inc, which is included in - XXXISelLowering.cpp.
        • -
      - -

      -The implementation of an instruction selection pass must include a header that -declares the FunctionPass class or a subclass of FunctionPass. In -XXXTargetMachine.cpp, a Pass Manager (PM) should add each instruction -selection pass into the queue of passes to run. -

      - -

      -The LLVM static compiler (llc) is an excellent tool for visualizing the -contents of DAGs. To display the SelectionDAG before or after specific -processing phases, use the command line options for llc, described -at -SelectionDAG Instruction Selection Process. -

      - -

      -To describe instruction selector behavior, you should add patterns for lowering -LLVM code into a SelectionDAG as the last parameter of the instruction -definitions in XXXInstrInfo.td. For example, in -SparcInstrInfo.td, this entry defines a register store operation, and -the last parameter describes a pattern with the store DAG operator. -

      - -
      -
      -def STrr  : F3_1< 3, 0b000100, (outs), (ins MEMrr:$addr, IntRegs:$src),
-                 "st $src, [$addr]", [(store IntRegs:$src, ADDRrr:$addr)]>;
-
      -
      - -

      -ADDRrr is a memory mode that is also defined in -SparcInstrInfo.td: -

      - -
      -
      -def ADDRrr : ComplexPattern<i32, 2, "SelectADDRrr", [], []>;
-
      -
      - -

      -The definition of ADDRrr refers to SelectADDRrr, which is a -function defined in an implementation of the Instructor Selector (such -as SparcISelDAGToDAG.cpp). -

      - -

      -In lib/Target/TargetSelectionDAG.td, the DAG operator for store is -defined below: -

      - -
      -
      -def store : PatFrag<(ops node:$val, node:$ptr),
-                    (st node:$val, node:$ptr), [{
-  if (StoreSDNode *ST = dyn_cast<StoreSDNode>(N))
-    return !ST->isTruncatingStore() && 
-           ST->getAddressingMode() == ISD::UNINDEXED;
-  return false;
-}]>;
-
      -
      - -

      -XXXInstrInfo.td also generates (in XXXGenDAGISel.inc) the -SelectCode method that is used to call the appropriate processing -method for an instruction. In this example, SelectCode -calls Select_ISD_STORE for the ISD::STORE opcode. -

      - -
      -
      -SDNode *SelectCode(SDValue N) {
-  ... 
-  MVT::ValueType NVT = N.getNode()->getValueType(0);
-  switch (N.getOpcode()) {
-  case ISD::STORE: {
-    switch (NVT) {
-    default:
-      return Select_ISD_STORE(N);
-      break;
-    }
-    break;
-  }
-  ...
-
      -
      - -

      -The pattern for STrr is matched, so elsewhere in -XXXGenDAGISel.inc, code for STrr is created for -Select_ISD_STORE. The Emit_22 method is also generated -in XXXGenDAGISel.inc to complete the processing of this -instruction. -

      - -
      -
      -SDNode *Select_ISD_STORE(const SDValue &N) {
-  SDValue Chain = N.getOperand(0);
-  if (Predicate_store(N.getNode())) {
-    SDValue N1 = N.getOperand(1);
-    SDValue N2 = N.getOperand(2);
-    SDValue CPTmp0;
-    SDValue CPTmp1;
-
-    // Pattern: (st:void IntRegs:i32:$src, 
-    //           ADDRrr:i32:$addr)<<P:Predicate_store>>
-    // Emits: (STrr:void ADDRrr:i32:$addr, IntRegs:i32:$src)
-    // Pattern complexity = 13  cost = 1  size = 0
-    if (SelectADDRrr(N, N2, CPTmp0, CPTmp1) &&
-        N1.getNode()->getValueType(0) == MVT::i32 &&
-        N2.getNode()->getValueType(0) == MVT::i32) {
-      return Emit_22(N, SP::STrr, CPTmp0, CPTmp1);
-    }
-...
-
      -
      - -
      - - -
      - The SelectionDAG Legalize Phase -
      - -
      - -

      -The Legalize phase converts a DAG to use types and operations that are natively -supported by the target. For natively unsupported types and operations, you need -to add code to the target-specific XXXTargetLowering implementation to convert -unsupported types and operations to supported ones. -

      - -

      -In the constructor for the XXXTargetLowering class, first use the -addRegisterClass method to specify which types are supports and which -register classes are associated with them. The code for the register classes are -generated by TableGen from XXXRegisterInfo.td and placed -in XXXGenRegisterInfo.h.inc. For example, the implementation of the -constructor for the SparcTargetLowering class (in -SparcISelLowering.cpp) starts with the following code: -

      - -
      -
      -addRegisterClass(MVT::i32, SP::IntRegsRegisterClass);
-addRegisterClass(MVT::f32, SP::FPRegsRegisterClass);
-addRegisterClass(MVT::f64, SP::DFPRegsRegisterClass); 
-
      -
      - -

      -You should examine the node types in the ISD namespace -(include/llvm/CodeGen/SelectionDAGNodes.h) and determine which -operations the target natively supports. For operations that do not have -native support, add a callback to the constructor for the XXXTargetLowering -class, so the instruction selection process knows what to do. The TargetLowering -class callback methods (declared in llvm/Target/TargetLowering.h) are: -

      - -
        -
      • setOperationAction — General operation.
        • - -
      • setLoadExtAction — Load with extension.
        • - -
      • setTruncStoreAction — Truncating store.
        • - -
      • setIndexedLoadAction — Indexed load.
        • - -
      • setIndexedStoreAction — Indexed store.
        • - -
      • setConvertAction — Type conversion.
        • - -
      • setCondCodeAction — Support for a given condition code.
        • -
      - -

      -Note: on older releases, setLoadXAction is used instead -of setLoadExtAction. Also, on older releases, -setCondCodeAction may not be supported. Examine your release -to see what methods are specifically supported. -

      - -

      -These callbacks are used to determine that an operation does or does not work -with a specified type (or types). And in all cases, the third parameter is -a LegalAction type enum value: Promote, Expand, -Custom, or Legal. SparcISelLowering.cpp -contains examples of all four LegalAction values. -

      - -
      - - -
      - Promote -
      - -
      - -

      -For an operation without native support for a given type, the specified type may -be promoted to a larger type that is supported. For example, SPARC does not -support a sign-extending load for Boolean values (i1 type), so -in SparcISelLowering.cpp the third parameter below, Promote, -changes i1 type values to a large type before loading. -

      - -
      -
      -setLoadExtAction(ISD::SEXTLOAD, MVT::i1, Promote);
-
      -
      - -
      - - -
      - Expand -
      - -
      - -

      -For a type without native support, a value may need to be broken down further, -rather than promoted. For an operation without native support, a combination of -other operations may be used to similar effect. In SPARC, the floating-point -sine and cosine trig operations are supported by expansion to other operations, -as indicated by the third parameter, Expand, to -setOperationAction: -

      - -
      -
      -setOperationAction(ISD::FSIN, MVT::f32, Expand);
-setOperationAction(ISD::FCOS, MVT::f32, Expand);
-
      -
      - -
      - - -
      - Custom -
      - -
      - -

      -For some operations, simple type promotion or operation expansion may be -insufficient. In some cases, a special intrinsic function must be implemented. -

      - -

      -For example, a constant value may require special treatment, or an operation may -require spilling and restoring registers in the stack and working with register -allocators. -

      - -

      -As seen in SparcISelLowering.cpp code below, to perform a type -conversion from a floating point value to a signed integer, first the -setOperationAction should be called with Custom as the third -parameter: -

      - -
      -
      -setOperationAction(ISD::FP_TO_SINT, MVT::i32, Custom);
-
      -
      - -

      -In the LowerOperation method, for each Custom operation, a -case statement should be added to indicate what function to call. In the -following code, an FP_TO_SINT opcode will call -the LowerFP_TO_SINT method: -

      - -
      -
      -SDValue SparcTargetLowering::LowerOperation(SDValue Op, SelectionDAG &DAG) {
-  switch (Op.getOpcode()) {
-  case ISD::FP_TO_SINT: return LowerFP_TO_SINT(Op, DAG);
-  ...
-  }
-}
-
      -
      - -

      -Finally, the LowerFP_TO_SINT method is implemented, using an FP -register to convert the floating-point value to an integer. -

      - -
      -
      -static SDValue LowerFP_TO_SINT(SDValue Op, SelectionDAG &DAG) {
-  assert(Op.getValueType() == MVT::i32);
-  Op = DAG.getNode(SPISD::FTOI, MVT::f32, Op.getOperand(0));
-  return DAG.getNode(ISD::BIT_CONVERT, MVT::i32, Op);
-}
-
      -
      - -
      - - -
      - Legal -
      - -
      - -

      -The Legal LegalizeAction enum value simply indicates that an -operation is natively supported. Legal represents the default -condition, so it is rarely used. In SparcISelLowering.cpp, the action -for CTPOP (an operation to count the bits set in an integer) is -natively supported only for SPARC v9. The following code enables -the Expand conversion technique for non-v9 SPARC implementations. -

      - -
      -
      -setOperationAction(ISD::CTPOP, MVT::i32, Expand);
-...
-if (TM.getSubtarget<SparcSubtarget>().isV9())
-  setOperationAction(ISD::CTPOP, MVT::i32, Legal);
-  case ISD::SETULT: return SPCC::ICC_CS;
-  case ISD::SETULE: return SPCC::ICC_LEU;
-  case ISD::SETUGT: return SPCC::ICC_GU;
-  case ISD::SETUGE: return SPCC::ICC_CC;
-  }
-}
-
      -
      - -
      - - -
      - Calling Conventions -
      - -
      - -

      -To support target-specific calling conventions, XXXGenCallingConv.td -uses interfaces (such as CCIfType and CCAssignToReg) that are defined in -lib/Target/TargetCallingConv.td. TableGen can take the target -descriptor file XXXGenCallingConv.td and generate the header -file XXXGenCallingConv.inc, which is typically included -in XXXISelLowering.cpp. You can use the interfaces in -TargetCallingConv.td to specify: -

      - -
        -
      • The order of parameter allocation.
        • - -
      • Where parameters and return values are placed (that is, on the stack or in - registers).
        • - -
      • Which registers may be used.
        • - -
      • Whether the caller or callee unwinds the stack.
        • -
      - -

      -The following example demonstrates the use of the CCIfType and -CCAssignToReg interfaces. If the CCIfType predicate is true -(that is, if the current argument is of type f32 or f64), then -the action is performed. In this case, the CCAssignToReg action assigns -the argument value to the first available register: either R0 -or R1. -

      - -
      -
      -CCIfType<[f32,f64], CCAssignToReg<[R0, R1]>>
-
      -
      - -

      -SparcCallingConv.td contains definitions for a target-specific -return-value calling convention (RetCC_Sparc32) and a basic 32-bit C calling -convention (CC_Sparc32). The definition of RetCC_Sparc32 -(shown below) indicates which registers are used for specified scalar return -types. A single-precision float is returned to register F0, and a -double-precision float goes to register D0. A 32-bit integer is -returned in register I0 or I1. -

      - -
      -
      -def RetCC_Sparc32 : CallingConv<[
-  CCIfType<[i32], CCAssignToReg<[I0, I1]>>,
-  CCIfType<[f32], CCAssignToReg<[F0]>>,
-  CCIfType<[f64], CCAssignToReg<[D0]>>
-]>;
-
      -
      - -

      -The definition of CC_Sparc32 in SparcCallingConv.td introduces -CCAssignToStack, which assigns the value to a stack slot with the -specified size and alignment. In the example below, the first parameter, 4, -indicates the size of the slot, and the second parameter, also 4, indicates the -stack alignment along 4-byte units. (Special cases: if size is zero, then the -ABI size is used; if alignment is zero, then the ABI alignment is used.) -

      - -
      -
      -def CC_Sparc32 : CallingConv<[
-  // All arguments get passed in integer registers if there is space.
-  CCIfType<[i32, f32, f64], CCAssignToReg<[I0, I1, I2, I3, I4, I5]>>,
-  CCAssignToStack<4, 4>
-]>;
-
      -
      - -

      -CCDelegateTo is another commonly used interface, which tries to find a -specified sub-calling convention, and, if a match is found, it is invoked. In -the following example (in X86CallingConv.td), the definition of -RetCC_X86_32_C ends with CCDelegateTo. After the current value -is assigned to the register ST0 or ST1, -the RetCC_X86Common is invoked. -

      - -
      -
      -def RetCC_X86_32_C : CallingConv<[
-  CCIfType<[f32], CCAssignToReg<[ST0, ST1]>>,
-  CCIfType<[f64], CCAssignToReg<[ST0, ST1]>>,
-  CCDelegateTo<RetCC_X86Common>
-]>;
-
      -
      - -

      -CCIfCC is an interface that attempts to match the given name to the -current calling convention. If the name identifies the current calling -convention, then a specified action is invoked. In the following example (in -X86CallingConv.td), if the Fast calling convention is in use, -then RetCC_X86_32_Fast is invoked. If the SSECall calling -convention is in use, then RetCC_X86_32_SSE is invoked. -

      - -
      -
      -def RetCC_X86_32 : CallingConv<[
-  CCIfCC<"CallingConv::Fast", CCDelegateTo<RetCC_X86_32_Fast>>,
-  CCIfCC<"CallingConv::X86_SSECall", CCDelegateTo<RetCC_X86_32_SSE>>,
-  CCDelegateTo<RetCC_X86_32_C>
-]>;
-
      -
      - -

      Other calling convention interfaces include:

      - -
        -
      • CCIf <predicate, action> — If the predicate matches, - apply the action.
        • - -
      • CCIfInReg <action> — If the argument is marked with the - 'inreg' attribute, then apply the action.
        • - -
      • CCIfNest <action> — Inf the argument is marked with the - 'nest' attribute, then apply the action.
        • - -
      • CCIfNotVarArg <action> — If the current function does - not take a variable number of arguments, apply the action.
        • - -
      • CCAssignToRegWithShadow <registerList, shadowList> — - similar to CCAssignToReg, but with a shadow list of registers.
        • - -
      • CCPassByVal <size, align> — Assign value to a stack - slot with the minimum specified size and alignment.
        • - -
      • CCPromoteToType <type> — Promote the current value to - the specified type.
        • - -
      • CallingConv <[actions]> — Define each calling - convention that is supported.
        • -
      - -
      - - -
      - Assembly Printer -
      - - -
      - -

      -During the code emission stage, the code generator may utilize an LLVM pass to -produce assembly output. To do this, you want to implement the code for a -printer that converts LLVM IR to a GAS-format assembly language for your target -machine, using the following steps: -

      - -
        -
      • Define all the assembly strings for your target, adding them to the - instructions defined in the XXXInstrInfo.td file. - (See Instruction Set.) TableGen will produce - an output file (XXXGenAsmWriter.inc) with an implementation of - the printInstruction method for the XXXAsmPrinter class.
        • - -
      • Write XXXTargetAsmInfo.h, which contains the bare-bones declaration - of the XXXTargetAsmInfo class (a subclass - of TargetAsmInfo).
        • - -
      • Write XXXTargetAsmInfo.cpp, which contains target-specific values - for TargetAsmInfo properties and sometimes new implementations for - methods.
        • - -
      • Write XXXAsmPrinter.cpp, which implements the AsmPrinter - class that performs the LLVM-to-assembly conversion.
        • -
      - -

      -The code in XXXTargetAsmInfo.h is usually a trivial declaration of the -XXXTargetAsmInfo class for use in XXXTargetAsmInfo.cpp. -Similarly, XXXTargetAsmInfo.cpp usually has a few declarations of -XXXTargetAsmInfo replacement values that override the default values -in TargetAsmInfo.cpp. For example in SparcTargetAsmInfo.cpp: -

      - -
      -
      -SparcTargetAsmInfo::SparcTargetAsmInfo(const SparcTargetMachine &TM) {
-  Data16bitsDirective = "\t.half\t";
-  Data32bitsDirective = "\t.word\t";
-  Data64bitsDirective = 0;  // .xword is only supported by V9.
-  ZeroDirective = "\t.skip\t";
-  CommentString = "!";
-  ConstantPoolSection = "\t.section \".rodata\",#alloc\n";
-}
-
      -
      - -

      -The X86 assembly printer implementation (X86TargetAsmInfo) is an -example where the target specific TargetAsmInfo class uses an -overridden methods: ExpandInlineAsm. -

      - -

      -A target-specific implementation of AsmPrinter is written in -XXXAsmPrinter.cpp, which implements the AsmPrinter class that -converts the LLVM to printable assembly. The implementation must include the -following headers that have declarations for the AsmPrinter and -MachineFunctionPass classes. The MachineFunctionPass is a -subclass of FunctionPass. -

      - -
      -
      -#include "llvm/CodeGen/AsmPrinter.h"
-#include "llvm/CodeGen/MachineFunctionPass.h" 
-
      -
      - -

      -As a FunctionPass, AsmPrinter first -calls doInitialization to set up the AsmPrinter. In -SparcAsmPrinter, a Mangler object is instantiated to process -variable names. -

      - -

      -In XXXAsmPrinter.cpp, the runOnMachineFunction method -(declared in MachineFunctionPass) must be implemented -for XXXAsmPrinter. In MachineFunctionPass, -the runOnFunction method invokes runOnMachineFunction. -Target-specific implementations of runOnMachineFunction differ, but -generally do the following to process each machine function: -

      - -
        -
      • Call SetupMachineFunction to perform initialization.
        • - -
      • Call EmitConstantPool to print out (to the output stream) constants - which have been spilled to memory.
        • - -
      • Call EmitJumpTableInfo to print out jump tables used by the current - function.
        • - -
      • Print out the label for the current function.
        • - -
      • Print out the code for the function, including basic block labels and the - assembly for the instruction (using printInstruction)
        • -
      - -

      -The XXXAsmPrinter implementation must also include the code generated -by TableGen that is output in the XXXGenAsmWriter.inc file. The code -in XXXGenAsmWriter.inc contains an implementation of the -printInstruction method that may call these methods: -

      - -
        -
      • printOperand
        • - -
      • printMemOperand
        • - -
      • printCCOperand (for conditional statements)
        • - -
      • printDataDirective
        • - -
      • printDeclare
        • - -
      • printImplicitDef
        • - -
      • printInlineAsm
        • -
      - -

      -The implementations of printDeclare, printImplicitDef, -printInlineAsm, and printLabel in AsmPrinter.cpp are -generally adequate for printing assembly and do not need to be -overridden. -

      - -

      -The printOperand method is implemented with a long switch/case -statement for the type of operand: register, immediate, basic block, external -symbol, global address, constant pool index, or jump table index. For an -instruction with a memory address operand, the printMemOperand method -should be implemented to generate the proper output. Similarly, -printCCOperand should be used to print a conditional operand. -

      - -

      doFinalization should be overridden in XXXAsmPrinter, and -it should be called to shut down the assembly printer. During -doFinalization, global variables and constants are printed to -output. -

      - -
      - - -
      - Subtarget Support -
      - - -
      - -

      -Subtarget support is used to inform the code generation process of instruction -set variations for a given chip set. For example, the LLVM SPARC implementation -provided covers three major versions of the SPARC microprocessor architecture: -Version 8 (V8, which is a 32-bit architecture), Version 9 (V9, a 64-bit -architecture), and the UltraSPARC architecture. V8 has 16 double-precision -floating-point registers that are also usable as either 32 single-precision or 8 -quad-precision registers. V8 is also purely big-endian. V9 has 32 -double-precision floating-point registers that are also usable as 16 -quad-precision registers, but cannot be used as single-precision registers. The -UltraSPARC architecture combines V9 with UltraSPARC Visual Instruction Set -extensions. -

      - -

      -If subtarget support is needed, you should implement a target-specific -XXXSubtarget class for your architecture. This class should process the -command-line options -mcpu= and -mattr=. -

      - -

      -TableGen uses definitions in the Target.td and Sparc.td files -to generate code in SparcGenSubtarget.inc. In Target.td, shown -below, the SubtargetFeature interface is defined. The first 4 string -parameters of the SubtargetFeature interface are a feature name, an -attribute set by the feature, the value of the attribute, and a description of -the feature. (The fifth parameter is a list of features whose presence is -implied, and its default value is an empty array.) -

      - -
      -
      -class SubtargetFeature<string n, string a,  string v, string d,
-                       list<SubtargetFeature> i = []> {
-  string Name = n;
-  string Attribute = a;
-  string Value = v;
-  string Desc = d;
-  list<SubtargetFeature> Implies = i;
-}
-
      -
      - -

      -In the Sparc.td file, the SubtargetFeature is used to define the -following features. -

      - -
      -
      -def FeatureV9 : SubtargetFeature<"v9", "IsV9", "true",
-                     "Enable SPARC-V9 instructions">;
-def FeatureV8Deprecated : SubtargetFeature<"deprecated-v8", 
-                     "V8DeprecatedInsts", "true",
-                     "Enable deprecated V8 instructions in V9 mode">;
-def FeatureVIS : SubtargetFeature<"vis", "IsVIS", "true",
-                     "Enable UltraSPARC Visual Instruction Set extensions">;
-
      -
      - -

      -Elsewhere in Sparc.td, the Proc class is defined and then is used to -define particular SPARC processor subtypes that may have the previously -described features. -

      - -
      -
      -class Proc<string Name, list<SubtargetFeature> Features>
-  : Processor<Name, NoItineraries, Features>;
- 
-def : Proc<"generic",         []>;
-def : Proc<"v8",              []>;
-def : Proc<"supersparc",      []>;
-def : Proc<"sparclite",       []>;
-def : Proc<"f934",            []>;
-def : Proc<"hypersparc",      []>;
-def : Proc<"sparclite86x",    []>;
-def : Proc<"sparclet",        []>;
-def : Proc<"tsc701",          []>;
-def : Proc<"v9",              [FeatureV9]>;
-def : Proc<"ultrasparc",      [FeatureV9, FeatureV8Deprecated]>;
-def : Proc<"ultrasparc3",     [FeatureV9, FeatureV8Deprecated]>;
-def : Proc<"ultrasparc3-vis", [FeatureV9, FeatureV8Deprecated, FeatureVIS]>;
-
      -
      - -

      -From Target.td and Sparc.td files, the resulting -SparcGenSubtarget.inc specifies enum values to identify the features, arrays of -constants to represent the CPU features and CPU subtypes, and the -ParseSubtargetFeatures method that parses the features string that sets -specified subtarget options. The generated SparcGenSubtarget.inc file -should be included in the SparcSubtarget.cpp. The target-specific -implementation of the XXXSubtarget method should follow this pseudocode: -

      - -
      -
      -XXXSubtarget::XXXSubtarget(const Module &M, const std::string &FS) {
-  // Set the default features
-  // Determine default and user specified characteristics of the CPU
-  // Call ParseSubtargetFeatures(FS, CPU) to parse the features string
-  // Perform any additional operations
-}
-
      -
      - -
      - - -
      - JIT Support -
      - - -
      - -

      -The implementation of a target machine optionally includes a Just-In-Time (JIT) -code generator that emits machine code and auxiliary structures as binary output -that can be written directly to memory. To do this, implement JIT code -generation by performing the following steps: -

      - -
        -
      • Write an XXXCodeEmitter.cpp file that contains a machine function - pass that transforms target-machine instructions into relocatable machine - code.
        • - -
      • Write an XXXJITInfo.cpp file that implements the JIT interfaces for - target-specific code-generation activities, such as emitting machine code - and stubs.
        • - -
      • Modify XXXTargetMachine so that it provides a - TargetJITInfo object through its getJITInfo method.
        • -
      - -

      -There are several different approaches to writing the JIT support code. For -instance, TableGen and target descriptor files may be used for creating a JIT -code generator, but are not mandatory. For the Alpha and PowerPC target -machines, TableGen is used to generate XXXGenCodeEmitter.inc, which -contains the binary coding of machine instructions and the -getBinaryCodeForInstr method to access those codes. Other JIT -implementations do not. -

      - -

      -Both XXXJITInfo.cpp and XXXCodeEmitter.cpp must include the -llvm/CodeGen/MachineCodeEmitter.h header file that defines the -MachineCodeEmitter class containing code for several callback functions -that write data (in bytes, words, strings, etc.) to the output stream. -

      - -
      - - -
      - Machine Code Emitter -
      - -
      - -

      -In XXXCodeEmitter.cpp, a target-specific of the Emitter class -is implemented as a function pass (subclass -of MachineFunctionPass). The target-specific implementation -of runOnMachineFunction (invoked by -runOnFunction in MachineFunctionPass) iterates through the -MachineBasicBlock calls emitInstruction to process each -instruction and emit binary code. emitInstruction is largely -implemented with case statements on the instruction types defined in -XXXInstrInfo.h. For example, in X86CodeEmitter.cpp, -the emitInstruction method is built around the following switch/case -statements: -

      - -
      -
      -switch (Desc->TSFlags & X86::FormMask) {
-case X86II::Pseudo:  // for not yet implemented instructions 
-   ...               // or pseudo-instructions
-   break;
-case X86II::RawFrm:  // for instructions with a fixed opcode value
-   ...
-   break;
-case X86II::AddRegFrm: // for instructions that have one register operand 
-   ...                 // added to their opcode
-   break;
-case X86II::MRMDestReg:// for instructions that use the Mod/RM byte
-   ...                 // to specify a destination (register)
-   break;
-case X86II::MRMDestMem:// for instructions that use the Mod/RM byte
-   ...                 // to specify a destination (memory)
-   break;
-case X86II::MRMSrcReg: // for instructions that use the Mod/RM byte
-   ...                 // to specify a source (register)
-   break;
-case X86II::MRMSrcMem: // for instructions that use the Mod/RM byte
-   ...                 // to specify a source (memory)
-   break;
-case X86II::MRM0r: case X86II::MRM1r:  // for instructions that operate on 
-case X86II::MRM2r: case X86II::MRM3r:  // a REGISTER r/m operand and
-case X86II::MRM4r: case X86II::MRM5r:  // use the Mod/RM byte and a field
-case X86II::MRM6r: case X86II::MRM7r:  // to hold extended opcode data
-   ...  
-   break;
-case X86II::MRM0m: case X86II::MRM1m:  // for instructions that operate on
-case X86II::MRM2m: case X86II::MRM3m:  // a MEMORY r/m operand and
-case X86II::MRM4m: case X86II::MRM5m:  // use the Mod/RM byte and a field
-case X86II::MRM6m: case X86II::MRM7m:  // to hold extended opcode data
-   ...  
-   break;
-case X86II::MRMInitReg: // for instructions whose source and
-   ...                  // destination are the same register
-   break;
-}
-
      -
      - -

      -The implementations of these case statements often first emit the opcode and -then get the operand(s). Then depending upon the operand, helper methods may be -called to process the operand(s). For example, in X86CodeEmitter.cpp, -for the X86II::AddRegFrm case, the first data emitted -(by emitByte) is the opcode added to the register operand. Then an -object representing the machine operand, MO1, is extracted. The helper -methods such as isImmediate, -isGlobalAddress, isExternalSymbol, isConstantPoolIndex, and -isJumpTableIndex determine the operand -type. (X86CodeEmitter.cpp also has private methods such -as emitConstant, emitGlobalAddress, -emitExternalSymbolAddress, emitConstPoolAddress, -and emitJumpTableAddress that emit the data into the output stream.) -

      - -
      -
      -case X86II::AddRegFrm:
-  MCE.emitByte(BaseOpcode + getX86RegNum(MI.getOperand(CurOp++).getReg()));
-  
-  if (CurOp != NumOps) {
-    const MachineOperand &MO1 = MI.getOperand(CurOp++);
-    unsigned Size = X86InstrInfo::sizeOfImm(Desc);
-    if (MO1.isImmediate())
-      emitConstant(MO1.getImm(), Size);
-    else {
-      unsigned rt = Is64BitMode ? X86::reloc_pcrel_word
-        : (IsPIC ? X86::reloc_picrel_word : X86::reloc_absolute_word);
-      if (Opcode == X86::MOV64ri) 
-        rt = X86::reloc_absolute_dword;  // FIXME: add X86II flag?
-      if (MO1.isGlobalAddress()) {
-        bool NeedStub = isa<Function>(MO1.getGlobal());
-        bool isLazy = gvNeedsLazyPtr(MO1.getGlobal());
-        emitGlobalAddress(MO1.getGlobal(), rt, MO1.getOffset(), 0,
-                          NeedStub, isLazy);
-      } else if (MO1.isExternalSymbol())
-        emitExternalSymbolAddress(MO1.getSymbolName(), rt);
-      else if (MO1.isConstantPoolIndex())
-        emitConstPoolAddress(MO1.getIndex(), rt);
-      else if (MO1.isJumpTableIndex())
-        emitJumpTableAddress(MO1.getIndex(), rt);
-    }
-  }
-  break;
-
      -
      - -

      -In the previous example, XXXCodeEmitter.cpp uses the -variable rt, which is a RelocationType enum that may be used to -relocate addresses (for example, a global address with a PIC base offset). The -RelocationType enum for that target is defined in the short -target-specific XXXRelocations.h file. The RelocationType is used by -the relocate method defined in XXXJITInfo.cpp to rewrite -addresses for referenced global symbols. -

      - -

      -For example, X86Relocations.h specifies the following relocation types -for the X86 addresses. In all four cases, the relocated value is added to the -value already in memory. For reloc_pcrel_word -and reloc_picrel_word, there is an additional initial adjustment. -

      - -
      -
      -enum RelocationType {
-  reloc_pcrel_word = 0,    // add reloc value after adjusting for the PC loc
-  reloc_picrel_word = 1,   // add reloc value after adjusting for the PIC base
-  reloc_absolute_word = 2, // absolute relocation; no additional adjustment 
-  reloc_absolute_dword = 3 // absolute relocation; no additional adjustment
-};
-
      -
      - -
      - - -
      - Target JIT Info -
      - -
      - -

      -XXXJITInfo.cpp implements the JIT interfaces for target-specific -code-generation activities, such as emitting machine code and stubs. At minimum, -a target-specific version of XXXJITInfo implements the following: -

      - -
        -
      • getLazyResolverFunction — Initializes the JIT, gives the - target a function that is used for compilation.
        • - -
      • emitFunctionStub — Returns a native function with a specified - address for a callback function.
        • - -
      • relocate — Changes the addresses of referenced globals, based - on relocation types.
        • - -
      • Callback function that are wrappers to a function stub that is used when the - real target is not initially known.
        • -
      - -

      -getLazyResolverFunction is generally trivial to implement. It makes the -incoming parameter as the global JITCompilerFunction and returns the -callback function that will be used a function wrapper. For the Alpha target -(in AlphaJITInfo.cpp), the getLazyResolverFunction -implementation is simply: -

      - -
      -
      -TargetJITInfo::LazyResolverFn AlphaJITInfo::getLazyResolverFunction(  
-                                            JITCompilerFn F) {
-  JITCompilerFunction = F;
-  return AlphaCompilationCallback;
-}
-
      -
      - -

      -For the X86 target, the getLazyResolverFunction implementation is a -little more complication, because it returns a different callback function for -processors with SSE instructions and XMM registers. -

      - -

      -The callback function initially saves and later restores the callee register -values, incoming arguments, and frame and return address. The callback function -needs low-level access to the registers or stack, so it is typically implemented -with assembler. -

      - -
      - - - -
      -
      - Valid CSS - Valid HTML 4.01 - - Mason Woo and Misha Brukman
      - The LLVM Compiler Infrastructure -
      - Last modified: $Date$ -
      - - - From mikem.llvm at gmail.com Thu May 6 18:48:37 2010 From: mikem.llvm at gmail.com (mike-m) Date: Thu, 06 May 2010 23:48:37 -0000 Subject: [llvm-commits] [llvm] r103215 - in /llvm/trunk/docs/main/CommandGuide: html/ man/ ps/ Message-ID: <20100506234837.A37EF312800A@llvm.org> Author: mikem Date: Thu May 6 18:48:37 2010 New Revision: 103215 URL: http://llvm.org/viewvc/llvm-project?rev=103215&view=rev Log: Cleanup unneeded dirs after docs overhaul. Removed: llvm/trunk/docs/main/CommandGuide/html/ llvm/trunk/docs/main/CommandGuide/man/ llvm/trunk/docs/main/CommandGuide/ps/ From mikem.llvm at gmail.com Thu May 6 19:13:23 2010 From: mikem.llvm at gmail.com (mike-m) Date: Fri, 07 May 2010 00:13:23 -0000 Subject: [llvm-commits] [llvm] r103217 - /llvm/trunk/docs/mk/main.mk Message-ID: <20100507001323.853BE312800A@llvm.org> Author: mikem Date: Thu May 6 19:13:23 2010 New Revision: 103217 URL: http://llvm.org/viewvc/llvm-project?rev=103217&view=rev Log: Disable man->postscript and man->pdf doc generation unless explicitly configured via --enable-doxygen. It seems some systems have broken pdfroff so automatic use of it is not safe. Modified: llvm/trunk/docs/mk/main.mk Modified: llvm/trunk/docs/mk/main.mk URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/mk/main.mk?rev=103217&r1=103216&r2=103217&view=diff ============================================================================== --- llvm/trunk/docs/mk/main.mk (original) +++ llvm/trunk/docs/mk/main.mk Thu May 6 19:13:23 2010 @@ -104,12 +104,14 @@ .PHONY: docs docs: $(MAIN.html.files) docs: $(MAIN.man.out) +ifeq ($(ENABLE_DOXYGEN),1) ifneq (,$(GROFF)) docs: $(MAIN.ps.out) endif ifneq (,$(PDFROFF)) docs: $(MAIN.pdf.out) endif +endif $(MAIN.html.tar): | $(dir $(MAIN.html.tar)) $(MAIN.html.tar): $(MAIN.html.files) @@ -154,12 +156,14 @@ install-docs: $(INSTALL.html.tar) install-docs: $(INSTALL.html.out) install-docs: $(INSTALL.man.out) +ifeq ($(ENABLE_DOXYGEN),1) ifneq (,$(GROFF)) install-docs: $(INSTALL.ps.out) endif ifneq (,$(PDFROFF)) install-docs: $(INSTALL.pdf.out) endif +endif $(INSTALL.html.tar): | $(dir $(INSTALL.html.tar)) $(INSTALL.html.tar): $(MAIN.html.tar) From evan.cheng at apple.com Thu May 6 19:24:53 2010 From: evan.cheng at apple.com (Evan Cheng) Date: Fri, 07 May 2010 00:24:53 -0000 Subject: [llvm-commits] [llvm] r103218 - in /llvm/trunk/lib/Target/ARM: ARMBaseInstrInfo.cpp ARMInstrNEON.td Message-ID: <20100507002453.2EB37312800A@llvm.org> Author: evancheng Date: Thu May 6 19:24:52 2010 New Revision: 103218 URL: http://llvm.org/viewvc/llvm-project?rev=103218&view=rev Log: Remove VLD1q and VST1q for reloading and spilling Q registers. Just use VLD1q64 / VST1q64 and reference sub-registers. Modified: llvm/trunk/lib/Target/ARM/ARMBaseInstrInfo.cpp llvm/trunk/lib/Target/ARM/ARMInstrNEON.td Modified: llvm/trunk/lib/Target/ARM/ARMBaseInstrInfo.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Target/ARM/ARMBaseInstrInfo.cpp?rev=103218&r1=103217&r2=103218&view=diff ============================================================================== --- llvm/trunk/lib/Target/ARM/ARMBaseInstrInfo.cpp (original) +++ llvm/trunk/lib/Target/ARM/ARMBaseInstrInfo.cpp Thu May 6 19:24:52 2010 @@ -723,6 +723,18 @@ return true; } +static const +MachineInstrBuilder &AddDReg(MachineInstrBuilder &MIB, + unsigned Reg, unsigned SubIdx, unsigned State, + const TargetRegisterInfo *TRI) { + if (!SubIdx) + return MIB.addReg(Reg, State); + + if (TargetRegisterInfo::isPhysicalRegister(Reg)) + return MIB.addReg(TRI->getSubReg(Reg, SubIdx), State); + return MIB.addReg(Reg, State, SubIdx); +} + void ARMBaseInstrInfo:: storeRegToStackSlot(MachineBasicBlock &MBB, MachineBasicBlock::iterator I, unsigned SrcReg, bool isKill, int FI, @@ -764,13 +776,14 @@ RC == ARM::QPR_8RegisterClass) { // FIXME: Neon instructions should support predicates if (Align >= 16 && getRegisterInfo().canRealignStack(MF)) { - AddDefaultPred(BuildMI(MBB, I, DL, get(ARM::VST1q)) - .addFrameIndex(FI).addImm(128) - .addMemOperand(MMO) - .addReg(SrcReg, getKillRegState(isKill))); + MachineInstrBuilder MIB = BuildMI(MBB, I, DL, get(ARM::VST1q64)) + .addFrameIndex(FI).addImm(128); + MIB = AddDReg(MIB, SrcReg, ARM::DSUBREG_0, getKillRegState(isKill), TRI); + MIB = AddDReg(MIB, SrcReg, ARM::DSUBREG_1, 0, TRI); + AddDefaultPred(MIB.addMemOperand(MMO)); } else { - AddDefaultPred(BuildMI(MBB, I, DL, get(ARM::VSTMQ)). - addReg(SrcReg, getKillRegState(isKill)) + AddDefaultPred(BuildMI(MBB, I, DL, get(ARM::VSTMQ)) + .addReg(SrcReg, getKillRegState(isKill)) .addFrameIndex(FI) .addImm(ARM_AM::getAM5Opc(ARM_AM::ia, 4)) .addMemOperand(MMO)); @@ -820,9 +833,10 @@ RC == ARM::QPR_VFP2RegisterClass || RC == ARM::QPR_8RegisterClass) { if (Align >= 16 && getRegisterInfo().canRealignStack(MF)) { - AddDefaultPred(BuildMI(MBB, I, DL, get(ARM::VLD1q), DestReg) - .addFrameIndex(FI).addImm(128) - .addMemOperand(MMO)); + MachineInstrBuilder MIB = BuildMI(MBB, I, DL, get(ARM::VLD1q64)); + MIB = AddDReg(MIB, DestReg, ARM::DSUBREG_0, RegState::Define, TRI); + MIB = AddDReg(MIB, DestReg, ARM::DSUBREG_1, RegState::Define, TRI); + AddDefaultPred(MIB.addFrameIndex(FI).addImm(128).addMemOperand(MMO)); } else { AddDefaultPred(BuildMI(MBB, I, DL, get(ARM::VLDMQ), DestReg) .addFrameIndex(FI) Modified: llvm/trunk/lib/Target/ARM/ARMInstrNEON.td URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Target/ARM/ARMInstrNEON.td?rev=103218&r1=103217&r2=103218&view=diff ============================================================================== --- llvm/trunk/lib/Target/ARM/ARMInstrNEON.td (original) +++ llvm/trunk/lib/Target/ARM/ARMInstrNEON.td Thu May 6 19:24:52 2010 @@ -128,17 +128,6 @@ IndexModeUpd, IIC_fpLoadm, "vldm${addr:submode}${p}\t${addr:base}!, ${dst:dregpair}", "$addr.base = $wb", []>; - -// Use vld1 to load a Q register as a D register pair. -// This alternative to VLDMQ allows an alignment to be specified. -// This is equivalent to VLD1q64 except that it has a Q register operand. -def VLD1q - : NLdSt<0,0b10,0b1010,0b1100, (outs QPR:$dst), (ins addrmode6:$addr), - IIC_VLD1, "vld1", "64", "${dst:dregpair}, $addr", "", []>; -def VLD1q_UPD - : NLdSt<0,0b10,0b1010,0b1100, (outs QPR:$dst, GPR:$wb), - (ins addrmode6:$addr, am6offset:$offset), IIC_VLD1, "vld1", "64", - "${dst:dregpair}, $addr$offset", "$addr.addr = $wb", []>; } // mayLoad = 1 let mayStore = 1 in { @@ -154,18 +143,6 @@ IndexModeUpd, IIC_fpStorem, "vstm${addr:submode}${p}\t${addr:base}!, ${src:dregpair}", "$addr.base = $wb", []>; - -// Use vst1 to store a Q register as a D register pair. -// This alternative to VSTMQ allows an alignment to be specified. -// This is equivalent to VST1q64 except that it has a Q register operand. -def VST1q - : NLdSt<0,0b00,0b1010,0b1100, (outs), (ins addrmode6:$addr, QPR:$src), - IIC_VST, "vst1", "64", "${src:dregpair}, $addr", "", []>; -def VST1q_UPD - : NLdSt<0,0b00,0b1010,0b1100, (outs GPR:$wb), - (ins addrmode6:$addr, am6offset:$offset, QPR:$src), - IIC_VST, "vst1", "64", "{$src:dregpair}, $addr$offset", - "$addr.addr = $wb", []>; } // mayStore = 1 let mayLoad = 1, hasExtraDefRegAllocReq = 1 in { From mikem.llvm at gmail.com Thu May 6 19:28:05 2010 From: mikem.llvm at gmail.com (mike-m) Date: Fri, 07 May 2010 00:28:05 -0000 Subject: [llvm-commits] [llvm] r103219 - in /llvm/trunk/docs: ./ CommandGuide/ CommandGuide/html/ CommandGuide/man/ CommandGuide/man/man1/ CommandGuide/ps/ HistoricalNotes/ api/ img/ main/ mk/ tutorial/ Message-ID: <20100507002805.ADBB5312800A@llvm.org> Author: mikem Date: Thu May 6 19:28:04 2010 New Revision: 103219 URL: http://llvm.org/viewvc/llvm-project?rev=103219&view=rev Log: Revert r103213. It broke several sections of live website. Added: llvm/trunk/docs/AliasAnalysis.html - copied unchanged from r103212, llvm/trunk/docs/AliasAnalysis.html llvm/trunk/docs/BitCodeFormat.html - copied unchanged from r103212, llvm/trunk/docs/BitCodeFormat.html llvm/trunk/docs/Bugpoint.html - copied unchanged from r103212, llvm/trunk/docs/Bugpoint.html llvm/trunk/docs/CFEBuildInstrs.html - copied unchanged from r103212, llvm/trunk/docs/CFEBuildInstrs.html llvm/trunk/docs/CMake.html - copied unchanged from r103212, llvm/trunk/docs/CMake.html llvm/trunk/docs/CodeGenerator.html - copied unchanged from r103212, llvm/trunk/docs/CodeGenerator.html llvm/trunk/docs/CodingStandards.html - copied unchanged from r103212, llvm/trunk/docs/CodingStandards.html llvm/trunk/docs/CommandGuide/ (props changed) - copied from r103212, llvm/trunk/docs/CommandGuide/ llvm/trunk/docs/CommandGuide/FileCheck.pod - copied unchanged from r103212, llvm/trunk/docs/CommandGuide/FileCheck.pod llvm/trunk/docs/CommandGuide/Makefile - copied unchanged from r103212, llvm/trunk/docs/CommandGuide/Makefile llvm/trunk/docs/CommandGuide/bugpoint.pod - copied unchanged from r103212, llvm/trunk/docs/CommandGuide/bugpoint.pod llvm/trunk/docs/CommandGuide/html/ (props changed) - copied from r103212, llvm/trunk/docs/CommandGuide/html/ llvm/trunk/docs/CommandGuide/html/manpage.css - copied unchanged from r103212, llvm/trunk/docs/CommandGuide/html/manpage.css llvm/trunk/docs/CommandGuide/index.html - copied unchanged from r103212, llvm/trunk/docs/CommandGuide/index.html llvm/trunk/docs/CommandGuide/lit.pod - copied unchanged from r103212, llvm/trunk/docs/CommandGuide/lit.pod llvm/trunk/docs/CommandGuide/llc.pod - copied unchanged from r103212, llvm/trunk/docs/CommandGuide/llc.pod llvm/trunk/docs/CommandGuide/lli.pod - copied unchanged from r103212, llvm/trunk/docs/CommandGuide/lli.pod llvm/trunk/docs/CommandGuide/llvm-ar.pod - copied unchanged from r103212, llvm/trunk/docs/CommandGuide/llvm-ar.pod llvm/trunk/docs/CommandGuide/llvm-as.pod - copied unchanged from r103212, llvm/trunk/docs/CommandGuide/llvm-as.pod llvm/trunk/docs/CommandGuide/llvm-bcanalyzer.pod - copied unchanged from r103212, llvm/trunk/docs/CommandGuide/llvm-bcanalyzer.pod llvm/trunk/docs/CommandGuide/llvm-config.pod - copied unchanged from r103212, llvm/trunk/docs/CommandGuide/llvm-config.pod llvm/trunk/docs/CommandGuide/llvm-dis.pod - copied unchanged from r103212, llvm/trunk/docs/CommandGuide/llvm-dis.pod llvm/trunk/docs/CommandGuide/llvm-extract.pod - copied unchanged from r103212, llvm/trunk/docs/CommandGuide/llvm-extract.pod llvm/trunk/docs/CommandGuide/llvm-ld.pod - copied unchanged from r103212, llvm/trunk/docs/CommandGuide/llvm-ld.pod llvm/trunk/docs/CommandGuide/llvm-link.pod - copied unchanged from r103212, llvm/trunk/docs/CommandGuide/llvm-link.pod llvm/trunk/docs/CommandGuide/llvm-nm.pod - copied unchanged from r103212, llvm/trunk/docs/CommandGuide/llvm-nm.pod llvm/trunk/docs/CommandGuide/llvm-prof.pod - copied unchanged from r103212, llvm/trunk/docs/CommandGuide/llvm-prof.pod llvm/trunk/docs/CommandGuide/llvm-ranlib.pod - copied unchanged from r103212, llvm/trunk/docs/CommandGuide/llvm-ranlib.pod llvm/trunk/docs/CommandGuide/llvmc.pod - copied unchanged from r103212, llvm/trunk/docs/CommandGuide/llvmc.pod llvm/trunk/docs/CommandGuide/llvmgcc.pod - copied unchanged from r103212, llvm/trunk/docs/CommandGuide/llvmgcc.pod llvm/trunk/docs/CommandGuide/llvmgxx.pod - copied unchanged from r103212, llvm/trunk/docs/CommandGuide/llvmgxx.pod llvm/trunk/docs/CommandGuide/man/ (props changed) - copied from r103212, llvm/trunk/docs/CommandGuide/man/ llvm/trunk/docs/CommandGuide/man/man1/ (props changed) - copied from r103212, llvm/trunk/docs/CommandGuide/man/man1/ llvm/trunk/docs/CommandGuide/manpage.css - copied unchanged from r103212, llvm/trunk/docs/CommandGuide/manpage.css llvm/trunk/docs/CommandGuide/opt.pod - copied unchanged from r103212, llvm/trunk/docs/CommandGuide/opt.pod llvm/trunk/docs/CommandGuide/ps/ (props changed) - copied from r103212, llvm/trunk/docs/CommandGuide/ps/ llvm/trunk/docs/CommandGuide/tblgen.pod - copied unchanged from r103212, llvm/trunk/docs/CommandGuide/tblgen.pod llvm/trunk/docs/CommandLine.html - copied unchanged from r103212, llvm/trunk/docs/CommandLine.html llvm/trunk/docs/CompilerDriver.html - copied unchanged from r103212, llvm/trunk/docs/CompilerDriver.html llvm/trunk/docs/CompilerDriverTutorial.html - copied unchanged from r103212, llvm/trunk/docs/CompilerDriverTutorial.html llvm/trunk/docs/CompilerWriterInfo.html - copied unchanged from r103212, llvm/trunk/docs/CompilerWriterInfo.html llvm/trunk/docs/DebuggingJITedCode.html - copied unchanged from r103212, llvm/trunk/docs/DebuggingJITedCode.html llvm/trunk/docs/DeveloperPolicy.html - copied unchanged from r103212, llvm/trunk/docs/DeveloperPolicy.html llvm/trunk/docs/ExceptionHandling.html - copied unchanged from r103212, llvm/trunk/docs/ExceptionHandling.html llvm/trunk/docs/ExtendedIntegerResults.txt - copied unchanged from r103212, llvm/trunk/docs/ExtendedIntegerResults.txt llvm/trunk/docs/ExtendingLLVM.html - copied unchanged from r103212, llvm/trunk/docs/ExtendingLLVM.html llvm/trunk/docs/FAQ.html - copied unchanged from r103212, llvm/trunk/docs/FAQ.html llvm/trunk/docs/GCCFEBuildInstrs.html - copied unchanged from r103212, llvm/trunk/docs/GCCFEBuildInstrs.html llvm/trunk/docs/GarbageCollection.html - copied unchanged from r103212, llvm/trunk/docs/GarbageCollection.html llvm/trunk/docs/GetElementPtr.html - copied unchanged from r103212, llvm/trunk/docs/GetElementPtr.html llvm/trunk/docs/GettingStarted.html - copied unchanged from r103212, llvm/trunk/docs/GettingStarted.html llvm/trunk/docs/GettingStartedVS.html - copied unchanged from r103212, llvm/trunk/docs/GettingStartedVS.html llvm/trunk/docs/GoldPlugin.html - copied unchanged from r103212, llvm/trunk/docs/GoldPlugin.html llvm/trunk/docs/HistoricalNotes/ - copied from r103212, llvm/trunk/docs/HistoricalNotes/ llvm/trunk/docs/HistoricalNotes/2000-11-18-EarlyDesignIdeas.txt - copied unchanged from r103212, llvm/trunk/docs/HistoricalNotes/2000-11-18-EarlyDesignIdeas.txt llvm/trunk/docs/HistoricalNotes/2000-11-18-EarlyDesignIdeasResp.txt - copied unchanged from r103212, llvm/trunk/docs/HistoricalNotes/2000-11-18-EarlyDesignIdeasResp.txt llvm/trunk/docs/HistoricalNotes/2000-12-06-EncodingIdea.txt - copied unchanged from r103212, llvm/trunk/docs/HistoricalNotes/2000-12-06-EncodingIdea.txt llvm/trunk/docs/HistoricalNotes/2000-12-06-MeetingSummary.txt - copied unchanged from r103212, llvm/trunk/docs/HistoricalNotes/2000-12-06-MeetingSummary.txt llvm/trunk/docs/HistoricalNotes/2001-01-31-UniversalIRIdea.txt - copied unchanged from r103212, llvm/trunk/docs/HistoricalNotes/2001-01-31-UniversalIRIdea.txt llvm/trunk/docs/HistoricalNotes/2001-02-06-TypeNotationDebate.txt - copied unchanged from r103212, llvm/trunk/docs/HistoricalNotes/2001-02-06-TypeNotationDebate.txt llvm/trunk/docs/HistoricalNotes/2001-02-06-TypeNotationDebateResp1.txt - copied unchanged from r103212, llvm/trunk/docs/HistoricalNotes/2001-02-06-TypeNotationDebateResp1.txt llvm/trunk/docs/HistoricalNotes/2001-02-06-TypeNotationDebateResp2.txt - copied unchanged from r103212, llvm/trunk/docs/HistoricalNotes/2001-02-06-TypeNotationDebateResp2.txt llvm/trunk/docs/HistoricalNotes/2001-02-06-TypeNotationDebateResp4.txt - copied unchanged from r103212, llvm/trunk/docs/HistoricalNotes/2001-02-06-TypeNotationDebateResp4.txt llvm/trunk/docs/HistoricalNotes/2001-02-09-AdveComments.txt - copied unchanged from r103212, llvm/trunk/docs/HistoricalNotes/2001-02-09-AdveComments.txt llvm/trunk/docs/HistoricalNotes/2001-02-09-AdveCommentsResponse.txt - copied unchanged from r103212, llvm/trunk/docs/HistoricalNotes/2001-02-09-AdveCommentsResponse.txt llvm/trunk/docs/HistoricalNotes/2001-02-13-Reference-Memory.txt - copied unchanged from r103212, llvm/trunk/docs/HistoricalNotes/2001-02-13-Reference-Memory.txt llvm/trunk/docs/HistoricalNotes/2001-02-13-Reference-MemoryResponse.txt - copied unchanged from r103212, llvm/trunk/docs/HistoricalNotes/2001-02-13-Reference-MemoryResponse.txt llvm/trunk/docs/HistoricalNotes/2001-04-16-DynamicCompilation.txt - copied unchanged from r103212, llvm/trunk/docs/HistoricalNotes/2001-04-16-DynamicCompilation.txt llvm/trunk/docs/HistoricalNotes/2001-05-18-ExceptionHandling.txt - copied unchanged from r103212, llvm/trunk/docs/HistoricalNotes/2001-05-18-ExceptionHandling.txt llvm/trunk/docs/HistoricalNotes/2001-05-19-ExceptionResponse.txt - copied unchanged from r103212, llvm/trunk/docs/HistoricalNotes/2001-05-19-ExceptionResponse.txt llvm/trunk/docs/HistoricalNotes/2001-06-01-GCCOptimizations.txt - copied unchanged from r103212, llvm/trunk/docs/HistoricalNotes/2001-06-01-GCCOptimizations.txt llvm/trunk/docs/HistoricalNotes/2001-06-01-GCCOptimizations2.txt - copied unchanged from r103212, llvm/trunk/docs/HistoricalNotes/2001-06-01-GCCOptimizations2.txt llvm/trunk/docs/HistoricalNotes/2001-06-20-.NET-Differences.txt - copied unchanged from r103212, llvm/trunk/docs/HistoricalNotes/2001-06-20-.NET-Differences.txt llvm/trunk/docs/HistoricalNotes/2001-07-06-LoweringIRForCodeGen.txt - copied unchanged from r103212, llvm/trunk/docs/HistoricalNotes/2001-07-06-LoweringIRForCodeGen.txt llvm/trunk/docs/HistoricalNotes/2001-09-18-OptimizeExceptions.txt - copied unchanged from r103212, llvm/trunk/docs/HistoricalNotes/2001-09-18-OptimizeExceptions.txt llvm/trunk/docs/HistoricalNotes/2002-05-12-InstListChange.txt - copied unchanged from r103212, llvm/trunk/docs/HistoricalNotes/2002-05-12-InstListChange.txt llvm/trunk/docs/HistoricalNotes/2002-06-25-MegaPatchInfo.txt - copied unchanged from r103212, llvm/trunk/docs/HistoricalNotes/2002-06-25-MegaPatchInfo.txt llvm/trunk/docs/HistoricalNotes/2003-01-23-CygwinNotes.txt - copied unchanged from r103212, llvm/trunk/docs/HistoricalNotes/2003-01-23-CygwinNotes.txt llvm/trunk/docs/HistoricalNotes/2003-06-25-Reoptimizer1.txt - copied unchanged from r103212, llvm/trunk/docs/HistoricalNotes/2003-06-25-Reoptimizer1.txt llvm/trunk/docs/HistoricalNotes/2003-06-26-Reoptimizer2.txt - copied unchanged from r103212, llvm/trunk/docs/HistoricalNotes/2003-06-26-Reoptimizer2.txt llvm/trunk/docs/HistoricalNotes/2007-OriginalClangReadme.txt - copied unchanged from r103212, llvm/trunk/docs/HistoricalNotes/2007-OriginalClangReadme.txt llvm/trunk/docs/HowToReleaseLLVM.html - copied unchanged from r103212, llvm/trunk/docs/HowToReleaseLLVM.html llvm/trunk/docs/HowToSubmitABug.html - copied unchanged from r103212, llvm/trunk/docs/HowToSubmitABug.html llvm/trunk/docs/LangRef.html - copied unchanged from r103212, llvm/trunk/docs/LangRef.html llvm/trunk/docs/Lexicon.html - copied unchanged from r103212, llvm/trunk/docs/Lexicon.html llvm/trunk/docs/LinkTimeOptimization.html - copied unchanged from r103212, llvm/trunk/docs/LinkTimeOptimization.html llvm/trunk/docs/MakefileGuide.html - copied unchanged from r103212, llvm/trunk/docs/MakefileGuide.html llvm/trunk/docs/Packaging.html - copied unchanged from r103212, llvm/trunk/docs/Packaging.html llvm/trunk/docs/Passes.html - copied unchanged from r103212, llvm/trunk/docs/Passes.html llvm/trunk/docs/ProgrammersManual.html - copied unchanged from r103212, llvm/trunk/docs/ProgrammersManual.html llvm/trunk/docs/Projects.html - copied unchanged from r103212, llvm/trunk/docs/Projects.html llvm/trunk/docs/ReleaseNotes.html - copied unchanged from r103212, llvm/trunk/docs/ReleaseNotes.html llvm/trunk/docs/SourceLevelDebugging.html - copied unchanged from r103212, llvm/trunk/docs/SourceLevelDebugging.html llvm/trunk/docs/SystemLibrary.html - copied unchanged from r103212, llvm/trunk/docs/SystemLibrary.html llvm/trunk/docs/TableGenFundamentals.html - copied unchanged from r103212, llvm/trunk/docs/TableGenFundamentals.html llvm/trunk/docs/TestingGuide.html - copied unchanged from r103212, llvm/trunk/docs/TestingGuide.html llvm/trunk/docs/UsingLibraries.html - copied unchanged from r103212, llvm/trunk/docs/UsingLibraries.html llvm/trunk/docs/WritingAnLLVMBackend.html - copied unchanged from r103212, llvm/trunk/docs/WritingAnLLVMBackend.html llvm/trunk/docs/WritingAnLLVMPass.html - copied unchanged from r103212, llvm/trunk/docs/WritingAnLLVMPass.html llvm/trunk/docs/doxygen.cfg.in - copied unchanged from r103212, llvm/trunk/docs/doxygen.cfg.in llvm/trunk/docs/doxygen.css - copied unchanged from r103212, llvm/trunk/docs/doxygen.css llvm/trunk/docs/doxygen.footer - copied unchanged from r103212, llvm/trunk/docs/doxygen.footer llvm/trunk/docs/doxygen.header - copied unchanged from r103212, llvm/trunk/docs/doxygen.header llvm/trunk/docs/doxygen.intro - copied unchanged from r103212, llvm/trunk/docs/doxygen.intro llvm/trunk/docs/img/ - copied from r103212, llvm/trunk/docs/img/ llvm/trunk/docs/img/Debugging.gif - copied unchanged from r103212, llvm/trunk/docs/img/Debugging.gif llvm/trunk/docs/img/libdeps.gif - copied unchanged from r103212, llvm/trunk/docs/img/libdeps.gif llvm/trunk/docs/img/lines.gif - copied unchanged from r103212, llvm/trunk/docs/img/lines.gif llvm/trunk/docs/img/objdeps.gif - copied unchanged from r103212, llvm/trunk/docs/img/objdeps.gif llvm/trunk/docs/img/venusflytrap.jpg - copied unchanged from r103212, llvm/trunk/docs/img/venusflytrap.jpg llvm/trunk/docs/index.html - copied unchanged from r103212, llvm/trunk/docs/index.html llvm/trunk/docs/llvm.css - copied unchanged from r103212, llvm/trunk/docs/llvm.css llvm/trunk/docs/re_format.7 - copied unchanged from r103212, llvm/trunk/docs/re_format.7 llvm/trunk/docs/tutorial/ - copied from r103212, llvm/trunk/docs/tutorial/ llvm/trunk/docs/tutorial/LangImpl1.html - copied unchanged from r103212, llvm/trunk/docs/tutorial/LangImpl1.html llvm/trunk/docs/tutorial/LangImpl2.html - copied unchanged from r103212, llvm/trunk/docs/tutorial/LangImpl2.html llvm/trunk/docs/tutorial/LangImpl3.html - copied unchanged from r103212, llvm/trunk/docs/tutorial/LangImpl3.html llvm/trunk/docs/tutorial/LangImpl4.html - copied unchanged from r103212, llvm/trunk/docs/tutorial/LangImpl4.html llvm/trunk/docs/tutorial/LangImpl5-cfg.png - copied unchanged from r103212, llvm/trunk/docs/tutorial/LangImpl5-cfg.png llvm/trunk/docs/tutorial/LangImpl5.html - copied unchanged from r103212, llvm/trunk/docs/tutorial/LangImpl5.html llvm/trunk/docs/tutorial/LangImpl6.html - copied unchanged from r103212, llvm/trunk/docs/tutorial/LangImpl6.html llvm/trunk/docs/tutorial/LangImpl7.html - copied unchanged from r103212, llvm/trunk/docs/tutorial/LangImpl7.html llvm/trunk/docs/tutorial/LangImpl8.html - copied unchanged from r103212, llvm/trunk/docs/tutorial/LangImpl8.html llvm/trunk/docs/tutorial/Makefile - copied unchanged from r103212, llvm/trunk/docs/tutorial/Makefile llvm/trunk/docs/tutorial/OCamlLangImpl1.html - copied unchanged from r103212, llvm/trunk/docs/tutorial/OCamlLangImpl1.html llvm/trunk/docs/tutorial/OCamlLangImpl2.html - copied unchanged from r103212, llvm/trunk/docs/tutorial/OCamlLangImpl2.html llvm/trunk/docs/tutorial/OCamlLangImpl3.html - copied unchanged from r103212, llvm/trunk/docs/tutorial/OCamlLangImpl3.html llvm/trunk/docs/tutorial/OCamlLangImpl4.html - copied unchanged from r103212, llvm/trunk/docs/tutorial/OCamlLangImpl4.html llvm/trunk/docs/tutorial/OCamlLangImpl5.html - copied unchanged from r103212, llvm/trunk/docs/tutorial/OCamlLangImpl5.html llvm/trunk/docs/tutorial/OCamlLangImpl6.html - copied unchanged from r103212, llvm/trunk/docs/tutorial/OCamlLangImpl6.html llvm/trunk/docs/tutorial/OCamlLangImpl7.html - copied unchanged from r103212, llvm/trunk/docs/tutorial/OCamlLangImpl7.html llvm/trunk/docs/tutorial/index.html - copied unchanged from r103212, llvm/trunk/docs/tutorial/index.html Removed: llvm/trunk/docs/api/ llvm/trunk/docs/main/ llvm/trunk/docs/mk/ Modified: llvm/trunk/docs/Makefile Propchange: llvm/trunk/docs/CommandGuide/ ------------------------------------------------------------------------------ --- svn:ignore (added) +++ svn:ignore Thu May 6 19:28:04 2010 @@ -0,0 +1,4 @@ +pod2htm?.tmp +*.html +*.1 +*.ps Propchange: llvm/trunk/docs/CommandGuide/html/ ------------------------------------------------------------------------------ --- svn:ignore (added) +++ svn:ignore Thu May 6 19:28:04 2010 @@ -0,0 +1,2 @@ +*html +.dir Propchange: llvm/trunk/docs/CommandGuide/man/ ------------------------------------------------------------------------------ --- svn:ignore (added) +++ svn:ignore Thu May 6 19:28:04 2010 @@ -0,0 +1 @@ +.dir Propchange: llvm/trunk/docs/CommandGuide/man/man1/ ------------------------------------------------------------------------------ --- svn:ignore (added) +++ svn:ignore Thu May 6 19:28:04 2010 @@ -0,0 +1,2 @@ +*.1 +.dir Propchange: llvm/trunk/docs/CommandGuide/ps/ ------------------------------------------------------------------------------ --- svn:ignore (added) +++ svn:ignore Thu May 6 19:28:04 2010 @@ -0,0 +1,2 @@ +*ps +.dir Modified: llvm/trunk/docs/Makefile URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/Makefile?rev=103219&r1=103218&r2=103219&view=diff ============================================================================== --- llvm/trunk/docs/Makefile (original) +++ llvm/trunk/docs/Makefile Thu May 6 19:28:04 2010 @@ -7,7 +7,117 @@ # ##===----------------------------------------------------------------------===## -LEVEL = .. -DIRS = main api +LEVEL := .. +DIRS := CommandGuide tutorial + +ifdef BUILD_FOR_WEBSITE +PROJ_OBJ_DIR = . +DOXYGEN = doxygen + +$(PROJ_OBJ_DIR)/doxygen.cfg: doxygen.cfg.in + cat $< | sed \ + -e 's/@abs_top_srcdir@/../g' \ + -e 's/@DOT@/dot/g' \ + -e 's/@PACKAGE_VERSION@/mainline/' \ + -e 's/@abs_top_builddir@/../g' > $@ +endif include $(LEVEL)/Makefile.common + +HTML := $(wildcard $(PROJ_SRC_DIR)/*.html) \ + $(wildcard $(PROJ_SRC_DIR)/*.css) +IMAGES := $(wildcard $(PROJ_SRC_DIR)/img/*.*) +DOXYFILES := doxygen.cfg.in doxygen.css doxygen.footer doxygen.header \ + doxygen.intro +EXTRA_DIST := $(HTML) $(DOXYFILES) llvm.css CommandGuide img + +.PHONY: install-html install-doxygen doxygen install-ocamldoc ocamldoc generated + +install_targets := install-html +ifeq ($(ENABLE_DOXYGEN),1) +install_targets += install-doxygen +endif +ifneq (,$(filter ocaml,$(BINDINGS_TO_BUILD))) +install_targets += install-ocamldoc +endif +install-local:: $(install_targets) + +# Live documentation is generated for the web site using this target: +# 'make generated BUILD_FOR_WEBSITE=1' +generated:: doxygen ocamldoc + +install-html: $(PROJ_OBJ_DIR)/html.tar.gz + $(Echo) Installing HTML documentation + $(Verb) $(MKDIR) $(DESTDIR)$(PROJ_docsdir)/html + $(Verb) $(MKDIR) $(DESTDIR)$(PROJ_docsdir)/html/img + $(Verb) $(DataInstall) $(HTML) $(DESTDIR)$(PROJ_docsdir)/html + $(Verb) $(DataInstall) $(IMAGES) $(DESTDIR)$(PROJ_docsdir)/html/img + $(Verb) $(DataInstall) $(PROJ_OBJ_DIR)/html.tar.gz $(DESTDIR)$(PROJ_docsdir) + +$(PROJ_OBJ_DIR)/html.tar.gz: $(HTML) + $(Echo) Packaging HTML documentation + $(Verb) $(RM) -rf $@ $(PROJ_OBJ_DIR)/html.tar + $(Verb) cd $(PROJ_SRC_DIR) && \ + $(TAR) cf $(PROJ_OBJ_DIR)/html.tar *.html + $(Verb) $(GZIP) $(PROJ_OBJ_DIR)/html.tar + +install-doxygen: doxygen + $(Echo) Installing doxygen documentation + $(Verb) $(MKDIR) $(DESTDIR)$(PROJ_docsdir)/html/doxygen + $(Verb) $(DataInstall) $(PROJ_OBJ_DIR)/doxygen.tar.gz $(DESTDIR)$(PROJ_docsdir) + $(Verb) cd $(PROJ_OBJ_DIR)/doxygen && \ + $(FIND) . -type f -exec \ + $(DataInstall) {} $(DESTDIR)$(PROJ_docsdir)/html/doxygen \; + +doxygen: regendoc $(PROJ_OBJ_DIR)/doxygen.tar.gz + +regendoc: + $(Echo) Building doxygen documentation + $(Verb) if test -e $(PROJ_OBJ_DIR)/doxygen ; then \ + $(RM) -rf $(PROJ_OBJ_DIR)/doxygen ; \ + fi + $(Verb) $(DOXYGEN) $(PROJ_OBJ_DIR)/doxygen.cfg + +$(PROJ_OBJ_DIR)/doxygen.tar.gz: $(DOXYFILES) $(PROJ_OBJ_DIR)/doxygen.cfg + $(Echo) Packaging doxygen documentation + $(Verb) $(RM) -rf $@ $(PROJ_OBJ_DIR)/doxygen.tar + $(Verb) $(TAR) cf $(PROJ_OBJ_DIR)/doxygen.tar doxygen + $(Verb) $(GZIP) $(PROJ_OBJ_DIR)/doxygen.tar + $(Verb) $(CP) $(PROJ_OBJ_DIR)/doxygen.tar.gz $(PROJ_OBJ_DIR)/doxygen/html/ + +userloc: $(LLVM_SRC_ROOT)/docs/userloc.html + +$(LLVM_SRC_ROOT)/docs/userloc.html: + $(Echo) Making User LOC Table + $(Verb) cd $(LLVM_SRC_ROOT) ; ./utils/userloc.pl -details -recurse \ + -html lib include tools runtime utils examples autoconf test > docs/userloc.html + +install-ocamldoc: ocamldoc + $(Echo) Installing ocamldoc documentation + $(Verb) $(MKDIR) $(DESTDIR)$(PROJ_docsdir)/ocamldoc/html + $(Verb) $(DataInstall) $(PROJ_OBJ_DIR)/ocamldoc.tar.gz $(DESTDIR)$(PROJ_docsdir) + $(Verb) cd $(PROJ_OBJ_DIR)/ocamldoc && \ + $(FIND) . -type f -exec \ + $(DataInstall) {} $(DESTDIR)$(PROJ_docsdir)/ocamldoc/html \; + +ocamldoc: regen-ocamldoc + $(Echo) Packaging ocamldoc documentation + $(Verb) $(RM) -rf $(PROJ_OBJ_DIR)/ocamldoc.tar* + $(Verb) $(TAR) cf $(PROJ_OBJ_DIR)/ocamldoc.tar ocamldoc + $(Verb) $(GZIP) $(PROJ_OBJ_DIR)/ocamldoc.tar + $(Verb) $(CP) $(PROJ_OBJ_DIR)/ocamldoc.tar.gz $(PROJ_OBJ_DIR)/ocamldoc/html/ + +regen-ocamldoc: + $(Echo) Building ocamldoc documentation + $(Verb) if test -e $(PROJ_OBJ_DIR)/ocamldoc ; then \ + $(RM) -rf $(PROJ_OBJ_DIR)/ocamldoc ; \ + fi + $(Verb) $(MAKE) -C $(LEVEL)/bindings/ocaml ocamldoc + $(Verb) $(MKDIR) $(PROJ_OBJ_DIR)/ocamldoc/html + $(Verb) \ + $(OCAMLDOC) -d $(PROJ_OBJ_DIR)/ocamldoc/html -sort -colorize-code -html \ + `$(FIND) $(LEVEL)/bindings/ocaml -name "*.odoc" -exec echo -load '{}' ';'` + +uninstall-local:: + $(Echo) Uninstalling Documentation + $(Verb) $(RM) -rf $(DESTDIR)$(PROJ_docsdir) From daniel at zuster.org Thu May 6 20:01:43 2010 From: daniel at zuster.org (Daniel Dunbar) Date: Thu, 6 May 2010 18:01:43 -0700 Subject: [llvm-commits] Patch for builbot to use scripted builds In-Reply-To: References: <4BE159CA.5070108@free.fr> <4BE28113.5020404@free.fr> Message-ID: Hi Galina, These look great to me, thank you very very very much for working on this!! - Daniel On Thu, May 6, 2010 at 12:37 PM, Galina Kistanova wrote: > Hello everyone, > > I'd like to check the status of these two patches, one for buildbot > and another one for llvm-gcc. > Ok to submit? > > Thanks > > Galina > > > On Thu, May 6, 2010 at 1:42 AM, Duncan Sands wrote: >> Hi Galina, >> >> ?Yes, I will submit a patch to switch dragonegg to use ScriptedBuilder >>> as soon as it will be in the svn. That was an idea and I have planed >>> to clear this with you. But since you have asked, I assume you are Ok >>> with it, aren't you? >> >> yes, I'm fine with having dragonegg use ScriptedBuilder. >> >> Thanks for working on this, >> >> Duncan. >> _______________________________________________ >> llvm-commits mailing list >> llvm-commits at cs.uiuc.edu >> http://lists.cs.uiuc.edu/mailman/listinfo/llvm-commits >> > > _______________________________________________ > llvm-commits mailing list > llvm-commits at cs.uiuc.edu > http://lists.cs.uiuc.edu/mailman/listinfo/llvm-commits > From gohman at apple.com Thu May 6 20:08:53 2010 From: gohman at apple.com (Dan Gohman) Date: Fri, 07 May 2010 01:08:53 -0000 Subject: [llvm-commits] [llvm] r103226 - in /llvm/trunk: lib/CodeGen/AsmPrinter/DwarfDebug.cpp test/CodeGen/X86/unknown-location.ll Message-ID: <20100507010853.8BA19312800A@llvm.org> Author: djg Date: Thu May 6 20:08:53 2010 New Revision: 103226 URL: http://llvm.org/viewvc/llvm-project?rev=103226&view=rev Log: Disable the new unknown-location code for now. It causes a major increase in the debug line info section, and it's causing regressions in a gdb testsuite. Modified: llvm/trunk/lib/CodeGen/AsmPrinter/DwarfDebug.cpp llvm/trunk/test/CodeGen/X86/unknown-location.ll Modified: llvm/trunk/lib/CodeGen/AsmPrinter/DwarfDebug.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/CodeGen/AsmPrinter/DwarfDebug.cpp?rev=103226&r1=103225&r2=103226&view=diff ============================================================================== --- llvm/trunk/lib/CodeGen/AsmPrinter/DwarfDebug.cpp (original) +++ llvm/trunk/lib/CodeGen/AsmPrinter/DwarfDebug.cpp Thu May 6 20:08:53 2010 @@ -47,6 +47,10 @@ static cl::opt DisableDebugInfoPrinting("disable-debug-info-print", cl::Hidden, cl::desc("Disable debug info printing")); +static cl::opt UnknownLocations("use-unknown-locations", cl::Hidden, + cl::desc("Make an absense of debug location information explicit."), + cl::init(false)); + namespace { const char *DWARFGroupName = "DWARF Emission"; const char *DbgTimerName = "DWARF Debug Writer"; @@ -2151,21 +2155,23 @@ // Check location. DebugLoc DL = MI->getDebugLoc(); if (DL.isUnknown()) { - // This instruction has no debug location. If the preceding instruction - // did, emit debug location information to indicate that the debug - // location is now unknown. - MCSymbol *Label = NULL; - if (DL == PrevInstLoc) - Label = PrevLabel; - else { - Label = recordSourceLine(DL.getLine(), DL.getCol(), 0); - PrevInstLoc = DL; - PrevLabel = Label; - } + if (UnknownLocations) { + // This instruction has no debug location. If the preceding instruction + // did, emit debug location information to indicate that the debug + // location is now unknown. + MCSymbol *Label = NULL; + if (DL == PrevInstLoc) + Label = PrevLabel; + else { + Label = recordSourceLine(DL.getLine(), DL.getCol(), 0); + PrevInstLoc = DL; + PrevLabel = Label; + } - // If this instruction begins a scope then note down corresponding label. - if (InsnsBeginScopeSet.count(MI) != 0) - LabelsBeforeInsn[MI] = Label; + // If this instruction begins a scope then note down corresponding label. + if (InsnsBeginScopeSet.count(MI) != 0) + LabelsBeforeInsn[MI] = Label; + } return; } Modified: llvm/trunk/test/CodeGen/X86/unknown-location.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/X86/unknown-location.ll?rev=103226&r1=103225&r2=103226&view=diff ============================================================================== --- llvm/trunk/test/CodeGen/X86/unknown-location.ll (original) +++ llvm/trunk/test/CodeGen/X86/unknown-location.ll Thu May 6 20:08:53 2010 @@ -1,4 +1,4 @@ -; RUN: llc < %s -asm-verbose=false -march=x86-64 | FileCheck %s +; RUN: llc < %s -asm-verbose=false -march=x86-64 -use-unknown-locations | FileCheck %s ; The divide instruction does not have a debug location. CodeGen should ; represent this in the debug information. This is checked by a check From gohman at apple.com Thu May 6 20:09:21 2010 From: gohman at apple.com (Dan Gohman) Date: Fri, 07 May 2010 01:09:21 -0000 Subject: [llvm-commits] [llvm] r103227 - /llvm/trunk/lib/CodeGen/SelectionDAG/SelectionDAG.cpp Message-ID: <20100507010921.E7911312800A@llvm.org> Author: djg Date: Thu May 6 20:09:21 2010 New Revision: 103227 URL: http://llvm.org/viewvc/llvm-project?rev=103227&view=rev Log: Print debug information for SDNodes. Modified: llvm/trunk/lib/CodeGen/SelectionDAG/SelectionDAG.cpp Modified: llvm/trunk/lib/CodeGen/SelectionDAG/SelectionDAG.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/CodeGen/SelectionDAG/SelectionDAG.cpp?rev=103227&r1=103226&r2=103227&view=diff ============================================================================== --- llvm/trunk/lib/CodeGen/SelectionDAG/SelectionDAG.cpp (original) +++ llvm/trunk/lib/CodeGen/SelectionDAG/SelectionDAG.cpp Thu May 6 20:09:21 2010 @@ -15,6 +15,7 @@ #include "SDNodeOrdering.h" #include "SDNodeDbgValue.h" #include "llvm/Constants.h" +#include "llvm/Analysis/DebugInfo.h" #include "llvm/Analysis/ValueTracking.h" #include "llvm/Function.h" #include "llvm/GlobalAlias.h" @@ -6008,6 +6009,21 @@ if (getNodeId() != -1) OS << " [ID=" << getNodeId() << ']'; + + DebugLoc dl = getDebugLoc(); + if (G && !dl.isUnknown()) { + DIScope + Scope(dl.getScope(G->getMachineFunction().getFunction()->getContext())); + OS << " dbg:"; + // Omit the directory, since it's usually long and uninteresting. + if (Scope.Verify()) + OS << Scope.getFilename(); + else + OS << ""; + OS << ':' << dl.getLine(); + if (dl.getCol() != 0) + OS << ':' << dl.getCol(); + } } void SDNode::print(raw_ostream &OS, const SelectionDAG *G) const { From dalej at apple.com Thu May 6 20:11:31 2010 From: dalej at apple.com (Dale Johannesen) Date: Fri, 07 May 2010 01:11:31 -0000 Subject: [llvm-commits] [llvm] r103230 - in /llvm/trunk/test/FrontendC: 2007-04-11-InlineStorageClassC89.c 2007-04-11-InlineStorageClassC99.c Message-ID: <20100507011131.668C23128026@llvm.org> Author: johannes Date: Thu May 6 20:11:31 2010 New Revision: 103230 URL: http://llvm.org/viewvc/llvm-project?rev=103230&view=rev Log: Adjust tests affected by llvm-gcc 103229. All results here match gcc-4.2. Modified: llvm/trunk/test/FrontendC/2007-04-11-InlineStorageClassC89.c llvm/trunk/test/FrontendC/2007-04-11-InlineStorageClassC99.c Modified: llvm/trunk/test/FrontendC/2007-04-11-InlineStorageClassC89.c URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/FrontendC/2007-04-11-InlineStorageClassC89.c?rev=103230&r1=103229&r2=103230&view=diff ============================================================================== --- llvm/trunk/test/FrontendC/2007-04-11-InlineStorageClassC89.c (original) +++ llvm/trunk/test/FrontendC/2007-04-11-InlineStorageClassC89.c Thu May 6 20:11:31 2010 @@ -11,8 +11,8 @@ // RUN: grep -v linkonce | count 1 // RUN: %llvmgcc %s -S -emit-llvm -O0 -o - | grep define | \ // RUN: grep xstatnoWeak | grep internal | count 1 -// RUN: %llvmgcc %s -S -emit-llvm -O0 -o - | grep declare | \ -// RUN: grep xextnoWeak | grep -v internal | grep -v weak | \ +// RUN: %llvmgcc %s -S -emit-llvm -O0 -o - | grep define | \ +// RUN: grep xextnoWeak | grep available_externally | grep -v weak | \ // RUN: grep -v linkonce | count 1 inline int xglobWeak(int) __attribute__((weak)); inline int xglobWeak (int i) { Modified: llvm/trunk/test/FrontendC/2007-04-11-InlineStorageClassC99.c URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/FrontendC/2007-04-11-InlineStorageClassC99.c?rev=103230&r1=103229&r2=103230&view=diff ============================================================================== --- llvm/trunk/test/FrontendC/2007-04-11-InlineStorageClassC99.c (original) +++ llvm/trunk/test/FrontendC/2007-04-11-InlineStorageClassC99.c Thu May 6 20:11:31 2010 @@ -6,13 +6,13 @@ // RUN: grep xWeaknoinline | grep weak | count 1 // RUN: %llvmgcc -std=c99 %s -S -emit-llvm -O0 -o - | grep define | \ // RUN: grep xWeakextnoinline | grep weak | count 1 -// RUN: %llvmgcc -std=c99 %s -S -emit-llvm -O0 -o - | grep declare | \ -// RUN: grep xglobnoWeak | grep -v internal | grep -v weak | \ +// RUN: %llvmgcc -std=c99 %s -S -emit-llvm -O0 -o - | grep define | \ +// RUN: grep xglobnoWeak | grep available_externally | grep -v weak | \ // RUN: grep -v linkonce | count 1 // RUN: %llvmgcc -std=c99 %s -S -emit-llvm -O0 -o - | grep define | \ // RUN: grep xstatnoWeak | grep internal | count 1 // RUN: %llvmgcc -std=c99 %s -S -emit-llvm -O0 -o - | grep define | \ -// RUN: grep xextnoWeak | grep -v internal | grep -v weak | \ +// RUN: grep xextnoWeak | grep -v available_externally | grep -v weak | \ // RUN: grep -v linkonce | count 1 inline int xglobWeak(int) __attribute__((weak)); inline int xglobWeak (int i) { From dalej at apple.com Thu May 6 20:10:24 2010 From: dalej at apple.com (Dale Johannesen) Date: Fri, 07 May 2010 01:10:24 -0000 Subject: [llvm-commits] [llvm-gcc-4.2] r103229 - in /llvm-gcc-4.2/trunk/gcc: cgraph.c cgraph.h cgraphunit.c ipa.c llvm-convert.cpp Message-ID: <20100507011024.E52293128018@llvm.org> Author: johannes Date: Thu May 6 20:10:24 2010 New Revision: 103229 URL: http://llvm.org/viewvc/llvm-project?rev=103229&view=rev Log: Fix for PR 4262 / 6599374 (extern inline handling). The basic problem with Duncan's previous attempt (see PR 4262) is that there isn't anything in GCC's IR corresponding to "extern" in the source; there is a DECL_EXTERNAL bit which means that in C, but is abused by C++ and ObjC to mean other things. The way around that is to pay attention to that bit only if the language is C; ugly, but so is the problem it's working around. Tested by gcc.dg/98031[23]-1.c in gcc testsuite. Modified: llvm-gcc-4.2/trunk/gcc/cgraph.c llvm-gcc-4.2/trunk/gcc/cgraph.h llvm-gcc-4.2/trunk/gcc/cgraphunit.c llvm-gcc-4.2/trunk/gcc/ipa.c llvm-gcc-4.2/trunk/gcc/llvm-convert.cpp Modified: llvm-gcc-4.2/trunk/gcc/cgraph.c URL: http://llvm.org/viewvc/llvm-project/llvm-gcc-4.2/trunk/gcc/cgraph.c?rev=103229&r1=103228&r2=103229&view=diff ============================================================================== --- llvm-gcc-4.2/trunk/gcc/cgraph.c (original) +++ llvm-gcc-4.2/trunk/gcc/cgraph.c Thu May 6 20:10:24 2010 @@ -601,7 +601,7 @@ if (!n->next_clone && !n->global.inlined_to && (cgraph_global_info_ready /* LLVM LOCAL extern inline */ - && (TREE_ASM_WRITTEN (n->decl) || IS_EXTERN_INLINE (n->decl)))) + && (TREE_ASM_WRITTEN (n->decl) || IS_EXTERN_NOINLINE (n->decl)))) kill_body = true; } Modified: llvm-gcc-4.2/trunk/gcc/cgraph.h URL: http://llvm.org/viewvc/llvm-project/llvm-gcc-4.2/trunk/gcc/cgraph.h?rev=103229&r1=103228&r2=103229&view=diff ============================================================================== --- llvm-gcc-4.2/trunk/gcc/cgraph.h (original) +++ llvm-gcc-4.2/trunk/gcc/cgraph.h Thu May 6 20:10:24 2010 @@ -336,13 +336,32 @@ /* LLVM LOCAL begin 6501843 */ /* We're no longer running gcc's inliner at all, so the bodies of - used extern always-inline functions must be passed down to the LLVM BE. - cgraph used to remove these. (gcc "extern inline" == c99 "inline") */ + used extern inline functions must be passed down to the LLVM BE. + cgraph used to remove these. (gcc "extern inline" == c99 "inline"). + + C++ uses DECL_EXTERNAL to mark functions instantiated as part of + template instantiation which should not be emitted. Objective C uses + it for some other convoluted purpose. Functions marked this way in + other languages should not be passed down to the LLVM BE. The easiest + way to outwit this, although inelegant, seems to be to check the language. + + Weak extern inlines are treated as weak. + + For compilation speed in the common case we don't include langhooks.h + here; the few users of this file that use IS_EXTERN_[NO]INLINE need to + include it. */ #ifdef ENABLE_LLVM #define IS_EXTERN_INLINE(f) (DECL_EXTERNAL(f) && \ - !lookup_attribute("always_inline", DECL_ATTRIBUTES(f))) + DECL_EXPLICIT_INLINE_P(f) && \ + !lookup_attribute ("weak", DECL_ATTRIBUTES (f)) && \ + strcmp (lang_hooks.name, "GNU C") == 0) +#define IS_EXTERN_NOINLINE(f) (DECL_EXTERNAL(f) && \ + (!DECL_EXPLICIT_INLINE_P(f) || \ + lookup_attribute ("weak", DECL_ATTRIBUTES (f)) || \ + strcmp (lang_hooks.name, "GNU C") != 0)) #else #define IS_EXTERN_INLINE(f) (DECL_EXTERNAL(f)) +#define IS_EXTERN_NOINLINE(f) (!DECL_EXTERNAL(f)) #endif /* LLVM LOCAL end */ #endif /* GCC_CGRAPH_H */ Modified: llvm-gcc-4.2/trunk/gcc/cgraphunit.c URL: http://llvm.org/viewvc/llvm-project/llvm-gcc-4.2/trunk/gcc/cgraphunit.c?rev=103229&r1=103228&r2=103229&view=diff ============================================================================== --- llvm-gcc-4.2/trunk/gcc/cgraphunit.c (original) +++ llvm-gcc-4.2/trunk/gcc/cgraphunit.c Thu May 6 20:10:24 2010 @@ -385,7 +385,7 @@ if (!n->global.inlined_to && !n->alias /* LLVM LOCAL extern inline */ - && !IS_EXTERN_INLINE (n->decl)) + && !IS_EXTERN_NOINLINE (n->decl)) { cgraph_expand_function (n); output = true; @@ -849,7 +849,7 @@ if (node->analyzed && DECL_SAVED_TREE (node->decl) && !TREE_ASM_WRITTEN (node->decl) /* LLVM LOCAL extern inline */ - && (!IS_EXTERN_INLINE (node->decl) || node->global.inlined_to)) + && (!IS_EXTERN_NOINLINE (node->decl) || node->global.inlined_to)) { if (this_cfun->cfg) { @@ -1295,7 +1295,7 @@ || (e && node->reachable)) && !TREE_ASM_WRITTEN (decl) /* LLVM LOCAL extern inline */ - && !IS_EXTERN_INLINE (decl)) + && !IS_EXTERN_NOINLINE (decl)) node->output = 1; else { @@ -1303,7 +1303,7 @@ #ifdef ENABLE_CHECKING if (!node->global.inlined_to && DECL_SAVED_TREE (decl) /* LLVM LOCAL extern inline */ - && !IS_EXTERN_INLINE (decl)) + && !IS_EXTERN_NOINLINE (decl)) { dump_cgraph_node (stderr, node); internal_error ("failed to reclaim unneeded function"); @@ -1311,7 +1311,7 @@ #endif /* LLVM LOCAL extern inline */ gcc_assert (node->global.inlined_to || !DECL_SAVED_TREE (decl) - || IS_EXTERN_INLINE (decl)); + || IS_EXTERN_NOINLINE (decl)); } } @@ -2040,3 +2040,4 @@ } #include "gt-cgraphunit.h" + Modified: llvm-gcc-4.2/trunk/gcc/ipa.c URL: http://llvm.org/viewvc/llvm-project/llvm-gcc-4.2/trunk/gcc/ipa.c?rev=103229&r1=103228&r2=103229&view=diff ============================================================================== --- llvm-gcc-4.2/trunk/gcc/ipa.c (original) +++ llvm-gcc-4.2/trunk/gcc/ipa.c Thu May 6 20:10:24 2010 @@ -23,6 +23,7 @@ #include "coretypes.h" #include "tm.h" #include "cgraph.h" +#include "langhooks.h" /* Fill array order with all nodes with output flag set in the reverse topological order. */ @@ -113,7 +114,7 @@ for (node = cgraph_nodes; node; node = node->next) if (node->needed && !node->global.inlined_to /* LLVM LOCAL extern inline */ - && ((!IS_EXTERN_INLINE (node->decl)) + && ((!IS_EXTERN_NOINLINE (node->decl)) || !node->analyzed || before_inlining_p)) { @@ -137,7 +138,7 @@ && node->analyzed && (!e->inline_failed || !e->callee->analyzed /* LLVM LOCAL extern inline */ - || !IS_EXTERN_INLINE(e->callee->decl) + || !IS_EXTERN_NOINLINE(e->callee->decl) || before_inlining_p)) { e->callee->aux = first; @@ -169,7 +170,7 @@ if (file) fprintf (file, " %s", cgraph_node_name (node)); /* LLVM LOCAL extern inline */ - if (!node->analyzed || !IS_EXTERN_INLINE(node->decl) + if (!node->analyzed || !IS_EXTERN_NOINLINE(node->decl) || before_inlining_p) cgraph_remove_node (node); else Modified: llvm-gcc-4.2/trunk/gcc/llvm-convert.cpp URL: http://llvm.org/viewvc/llvm-project/llvm-gcc-4.2/trunk/gcc/llvm-convert.cpp?rev=103229&r1=103228&r2=103229&view=diff ============================================================================== --- llvm-gcc-4.2/trunk/gcc/llvm-convert.cpp (original) +++ llvm-gcc-4.2/trunk/gcc/llvm-convert.cpp Thu May 6 20:10:24 2010 @@ -529,10 +529,6 @@ assert(Fn->empty() && "Function expanded multiple times!"); // Compute the linkage that the function should get. - // Functions declared "always inline" should not have a body - // emitted; hack this by pretending they're static. That will either - // make them go away or emit a static definition that won't collide with - // anything. if (DECL_LLVM_PRIVATE(FnDecl)) { Fn->setLinkage(Function::PrivateLinkage); } else if (DECL_LLVM_LINKER_PRIVATE(FnDecl)) { @@ -541,7 +537,7 @@ Fn->setLinkage(Function::InternalLinkage); } else if (DECL_EXTERNAL(FnDecl) && lookup_attribute ("always_inline", DECL_ATTRIBUTES (FnDecl))) { - Fn->setLinkage(Function::InternalLinkage); + Fn->setLinkage(Function::AvailableExternallyLinkage); } else if (DECL_COMDAT(FnDecl)) { Fn->setLinkage(Function::getLinkOnceLinkage(flag_odr)); } else if (DECL_WEAK(FnDecl)) { @@ -549,6 +545,9 @@ Fn->setLinkage(Function::WeakAnyLinkage); } else if (DECL_ONE_ONLY(FnDecl)) { Fn->setLinkage(Function::getWeakLinkage(flag_odr)); + } else if (IS_EXTERN_INLINE(FnDecl)) { + // gcc "extern inline", C99 "inline" + Fn->setLinkage(Function::AvailableExternallyLinkage); } #ifdef TARGET_ADJUST_LLVM_LINKAGE From gohman at apple.com Thu May 6 20:10:20 2010 From: gohman at apple.com (Dan Gohman) Date: Fri, 07 May 2010 01:10:20 -0000 Subject: [llvm-commits] [llvm] r103228 - /llvm/trunk/lib/CodeGen/SelectionDAG/FastISel.cpp Message-ID: <20100507011020.CFAC7312800A@llvm.org> Author: djg Date: Thu May 6 20:10:20 2010 New Revision: 103228 URL: http://llvm.org/viewvc/llvm-project?rev=103228&view=rev Log: Transfer debug location information from PHI nodes to resulting lowered copies. Modified: llvm/trunk/lib/CodeGen/SelectionDAG/FastISel.cpp Modified: llvm/trunk/lib/CodeGen/SelectionDAG/FastISel.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/CodeGen/SelectionDAG/FastISel.cpp?rev=103228&r1=103227&r2=103228&view=diff ============================================================================== --- llvm/trunk/lib/CodeGen/SelectionDAG/FastISel.cpp (original) +++ llvm/trunk/lib/CodeGen/SelectionDAG/FastISel.cpp Thu May 6 20:10:20 2010 @@ -1082,6 +1082,7 @@ // emitted yet. for (BasicBlock::const_iterator I = SuccBB->begin(); const PHINode *PN = dyn_cast(I); ++I) { + // Ignore dead phi's. if (PN->use_empty()) continue; @@ -1104,12 +1105,19 @@ const Value *PHIOp = PN->getIncomingValueForBlock(LLVMBB); + // Set the DebugLoc for the copy. Prefer the location of the operand + // if there is one; use the location of the PHI otherwise. + DL = PN->getDebugLoc(); + if (const Instruction *Inst = dyn_cast(PHIOp)) + DL = Inst->getDebugLoc(); + unsigned Reg = getRegForValue(PHIOp); if (Reg == 0) { PHINodesToUpdate.resize(OrigNumPHINodesToUpdate); return false; } PHINodesToUpdate.push_back(std::make_pair(MBBI++, Reg)); + DL = DebugLoc(); } } From gohman at apple.com Thu May 6 20:28:10 2010 From: gohman at apple.com (Dan Gohman) Date: Fri, 07 May 2010 01:28:10 -0000 Subject: [llvm-commits] [llvm] r103232 - /llvm/trunk/lib/Target/X86/X86InstrInfo.cpp Message-ID: <20100507012810.DEEBC312800A@llvm.org> Author: djg Date: Thu May 6 20:28:10 2010 New Revision: 103232 URL: http://llvm.org/viewvc/llvm-project?rev=103232&view=rev Log: When rematerializing, use the debug location of the original instruction, rather than a location near where the new instruction is being inserted. Modified: llvm/trunk/lib/Target/X86/X86InstrInfo.cpp Modified: llvm/trunk/lib/Target/X86/X86InstrInfo.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Target/X86/X86InstrInfo.cpp?rev=103232&r1=103231&r2=103232&view=diff ============================================================================== --- llvm/trunk/lib/Target/X86/X86InstrInfo.cpp (original) +++ llvm/trunk/lib/Target/X86/X86InstrInfo.cpp Thu May 6 20:28:10 2010 @@ -1065,7 +1065,7 @@ unsigned DestReg, unsigned SubIdx, const MachineInstr *Orig, const TargetRegisterInfo *TRI) const { - DebugLoc DL = MBB.findDebugLoc(I); + DebugLoc DL = Orig->getDebugLoc(); if (SubIdx && TargetRegisterInfo::isPhysicalRegister(DestReg)) { DestReg = TRI->getSubReg(DestReg, SubIdx); From nicholas at mxc.ca Thu May 6 20:45:38 2010 From: nicholas at mxc.ca (Nick Lewycky) Date: Fri, 07 May 2010 01:45:38 -0000 Subject: [llvm-commits] [llvm] r103233 - in /llvm/trunk: lib/CodeGen/RegAllocLocal.cpp test/CodeGen/X86/2010-05-05-LocalAllocEarlyClobber.ll test/CodeGen/X86/2010-05-06-LocalInlineAsmClobber.ll Message-ID: <20100507014538.E1CC5312800A@llvm.org> Author: nicholas Date: Thu May 6 20:45:38 2010 New Revision: 103233 URL: http://llvm.org/viewvc/llvm-project?rev=103233&view=rev Log: Revert r103133 and add testcase from PR7066. Added: llvm/trunk/test/CodeGen/X86/2010-05-06-LocalInlineAsmClobber.ll Modified: llvm/trunk/lib/CodeGen/RegAllocLocal.cpp llvm/trunk/test/CodeGen/X86/2010-05-05-LocalAllocEarlyClobber.ll Modified: llvm/trunk/lib/CodeGen/RegAllocLocal.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/CodeGen/RegAllocLocal.cpp?rev=103233&r1=103232&r2=103233&view=diff ============================================================================== --- llvm/trunk/lib/CodeGen/RegAllocLocal.cpp (original) +++ llvm/trunk/lib/CodeGen/RegAllocLocal.cpp Thu May 6 20:45:38 2010 @@ -843,18 +843,8 @@ SmallVector Kills; for (unsigned i = 0, e = MI->getNumOperands(); i != e; ++i) { MachineOperand &MO = MI->getOperand(i); - if (!MO.isReg()) continue; - unsigned Reg = MO.getReg(); - if (!Reg) continue; - - // Avoid allocating assigned early clobbers below. - if (MO.isEarlyClobber() && TargetRegisterInfo::isPhysicalRegister(Reg)) { - spillPhysReg(MBB, MI, Reg, true); // Spill any existing value in reg - PhysRegsUsed[Reg] = 0; // It is free and reserved now - AddToPhysRegsUseOrder(Reg); - } - - if (!MO.isKill()) continue; + if (!MO.isReg() || !MO.isKill()) continue; + if (!MO.isImplicit()) Kills.push_back(MO.getReg()); else if (!isReadModWriteImplicitKill(MI, MO.getReg())) Modified: llvm/trunk/test/CodeGen/X86/2010-05-05-LocalAllocEarlyClobber.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/X86/2010-05-05-LocalAllocEarlyClobber.ll?rev=103233&r1=103232&r2=103233&view=diff ============================================================================== --- llvm/trunk/test/CodeGen/X86/2010-05-05-LocalAllocEarlyClobber.ll (original) +++ llvm/trunk/test/CodeGen/X86/2010-05-05-LocalAllocEarlyClobber.ll Thu May 6 20:45:38 2010 @@ -1,5 +1,7 @@ ; RUN: llc < %s -O0 -regalloc=local | FileCheck %s ; PR6520 +; XFAIL: * + target datalayout = "e-p:32:32:32-i1:8:8-i8:8:8-i16:16:16-i32:32:32-i64:32:64-f32:32:32-f64:32:64-v64:64:64-v128:128:128-a0:0:64-f80:128:128-n8:16:32" target triple = "i386-apple-darwin10.0.0" Added: llvm/trunk/test/CodeGen/X86/2010-05-06-LocalInlineAsmClobber.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/X86/2010-05-06-LocalInlineAsmClobber.ll?rev=103233&view=auto ============================================================================== --- llvm/trunk/test/CodeGen/X86/2010-05-06-LocalInlineAsmClobber.ll (added) +++ llvm/trunk/test/CodeGen/X86/2010-05-06-LocalInlineAsmClobber.ll Thu May 6 20:45:38 2010 @@ -0,0 +1,10 @@ +; RUN: llc -regalloc=local %s -o /dev/null +; PR7066 + +target datalayout = "e-p:64:64:64-i1:8:8-i8:8:8-i16:16:16-i32:32:32-i64:64:64-f32:32:32-f64:64:64-v64:64:64-v128:128:128-a0:0:64-s0:64:64-f80:128:128-n8:16:32:64" +target triple = "x86_64-unknown-linux-gnu" + +define i32 @sys_clone(i32 (i8*)* %fn, i8* %child_stack, i32 %flags, i8* %arg, i32* %parent_tidptr, i8* %newtls, i32* %child_tidptr) nounwind { + call i64 asm sideeffect "", "={ax},0,i,i,r,{si},{di},r,{dx},imr,imr,~{sp},~{memory},~{r8},~{r10},~{r11},~{cx},~{dirflag},~{fpsr},~{flags}"(i64 4294967274, i32 56, i32 60, i32 (i8*)* undef, i8* undef, i32 undef, i8* undef, i32* undef, i8* undef, i32* undef) nounwind ; [#uses=0] + ret i32 undef +} From evan.cheng at apple.com Thu May 6 20:54:08 2010 From: evan.cheng at apple.com (Evan Cheng) Date: Fri, 07 May 2010 01:54:08 -0000 Subject: [llvm-commits] [llvm] r103234 - /llvm/trunk/lib/Target/ARM/ARMBaseInstrInfo.cpp Message-ID: <20100507015408.C15A3312800A@llvm.org> Author: evancheng Date: Thu May 6 20:54:08 2010 New Revision: 103234 URL: http://llvm.org/viewvc/llvm-project?rev=103234&view=rev Log: Use VSTMD / VLDMD for spills and reloads of Q registers instead of VSTMQ / VLDQ. The later are aliases which ought to be eliminated but we can't because they are used for storing and loading v2f64 values. Modified: llvm/trunk/lib/Target/ARM/ARMBaseInstrInfo.cpp Modified: llvm/trunk/lib/Target/ARM/ARMBaseInstrInfo.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Target/ARM/ARMBaseInstrInfo.cpp?rev=103234&r1=103233&r2=103234&view=diff ============================================================================== --- llvm/trunk/lib/Target/ARM/ARMBaseInstrInfo.cpp (original) +++ llvm/trunk/lib/Target/ARM/ARMBaseInstrInfo.cpp Thu May 6 20:54:08 2010 @@ -782,11 +782,14 @@ MIB = AddDReg(MIB, SrcReg, ARM::DSUBREG_1, 0, TRI); AddDefaultPred(MIB.addMemOperand(MMO)); } else { - AddDefaultPred(BuildMI(MBB, I, DL, get(ARM::VSTMQ)) - .addReg(SrcReg, getKillRegState(isKill)) - .addFrameIndex(FI) - .addImm(ARM_AM::getAM5Opc(ARM_AM::ia, 4)) - .addMemOperand(MMO)); + MachineInstrBuilder MIB = + AddDefaultPred(BuildMI(MBB, I, DL, get(ARM::VSTMD)) + .addFrameIndex(FI) + .addImm(ARM_AM::getAM5Opc(ARM_AM::ia, 4))) + .addMemOperand(MMO); + MIB = AddDReg(MIB, SrcReg, ARM::DSUBREG_0, getKillRegState(isKill), TRI); + AddDReg(MIB, SrcReg, ARM::DSUBREG_1, 0, TRI); + } } else { assert((RC == ARM::QQPRRegisterClass || @@ -838,10 +841,13 @@ MIB = AddDReg(MIB, DestReg, ARM::DSUBREG_1, RegState::Define, TRI); AddDefaultPred(MIB.addFrameIndex(FI).addImm(128).addMemOperand(MMO)); } else { - AddDefaultPred(BuildMI(MBB, I, DL, get(ARM::VLDMQ), DestReg) - .addFrameIndex(FI) - .addImm(ARM_AM::getAM5Opc(ARM_AM::ia, 4)) - .addMemOperand(MMO)); + MachineInstrBuilder MIB = + AddDefaultPred(BuildMI(MBB, I, DL, get(ARM::VLDMD)) + .addFrameIndex(FI) + .addImm(ARM_AM::getAM5Opc(ARM_AM::ia, 4))) + .addMemOperand(MMO); + MIB = AddDReg(MIB, DestReg, ARM::DSUBREG_0, RegState::Define, TRI); + AddDReg(MIB, DestReg, ARM::DSUBREG_1, RegState::Define, TRI); } } else { assert((RC == ARM::QQPRRegisterClass || From evan.cheng at apple.com Thu May 6 21:04:02 2010 From: evan.cheng at apple.com (Evan Cheng) Date: Fri, 07 May 2010 02:04:02 -0000 Subject: [llvm-commits] [llvm] r103235 - in /llvm/trunk/lib/Target/ARM: ARMBaseInstrInfo.cpp ARMInstrNEON.td Message-ID: <20100507020402.9F470312800A@llvm.org> Author: evancheng Date: Thu May 6 21:04:02 2010 New Revision: 103235 URL: http://llvm.org/viewvc/llvm-project?rev=103235&view=rev Log: Use VLD2q32 / VST2q32 to reload / spill QQ (pair of Q) registers when stack slot is sufficiently aligned. Use VLDMD / VSTMD otherwise. Modified: llvm/trunk/lib/Target/ARM/ARMBaseInstrInfo.cpp llvm/trunk/lib/Target/ARM/ARMInstrNEON.td Modified: llvm/trunk/lib/Target/ARM/ARMBaseInstrInfo.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Target/ARM/ARMBaseInstrInfo.cpp?rev=103235&r1=103234&r2=103235&view=diff ============================================================================== --- llvm/trunk/lib/Target/ARM/ARMBaseInstrInfo.cpp (original) +++ llvm/trunk/lib/Target/ARM/ARMBaseInstrInfo.cpp Thu May 6 21:04:02 2010 @@ -788,14 +788,31 @@ .addImm(ARM_AM::getAM5Opc(ARM_AM::ia, 4))) .addMemOperand(MMO); MIB = AddDReg(MIB, SrcReg, ARM::DSUBREG_0, getKillRegState(isKill), TRI); - AddDReg(MIB, SrcReg, ARM::DSUBREG_1, 0, TRI); - + AddDReg(MIB, SrcReg, ARM::DSUBREG_1, 0, TRI); } } else { assert((RC == ARM::QQPRRegisterClass || RC == ARM::QQPR_VFP2RegisterClass || RC == ARM::QQPR_8RegisterClass) && "Unknown regclass!"); - llvm_unreachable("Not yet implemented!"); + if (Align >= 16 && getRegisterInfo().canRealignStack(MF)) { + MachineInstrBuilder MIB = BuildMI(MBB, I, DL, get(ARM::VST2q32)) + .addFrameIndex(FI).addImm(128); + MIB = AddDReg(MIB, SrcReg, ARM::DSUBREG_0, getKillRegState(isKill), TRI); + MIB = AddDReg(MIB, SrcReg, ARM::DSUBREG_1, 0, TRI); + MIB = AddDReg(MIB, SrcReg, ARM::DSUBREG_2, 0, TRI); + MIB = AddDReg(MIB, SrcReg, ARM::DSUBREG_3, 0, TRI); + AddDefaultPred(MIB.addMemOperand(MMO)); + } else { + MachineInstrBuilder MIB = + AddDefaultPred(BuildMI(MBB, I, DL, get(ARM::VSTMD)) + .addFrameIndex(FI) + .addImm(ARM_AM::getAM5Opc(ARM_AM::ia, 4))) + .addMemOperand(MMO); + MIB = AddDReg(MIB, SrcReg, ARM::DSUBREG_0, getKillRegState(isKill), TRI); + MIB = AddDReg(MIB, SrcReg, ARM::DSUBREG_1, 0, TRI); + MIB = AddDReg(MIB, SrcReg, ARM::DSUBREG_2, 0, TRI); + AddDReg(MIB, SrcReg, ARM::DSUBREG_3, 0, TRI); + } } } @@ -847,13 +864,30 @@ .addImm(ARM_AM::getAM5Opc(ARM_AM::ia, 4))) .addMemOperand(MMO); MIB = AddDReg(MIB, DestReg, ARM::DSUBREG_0, RegState::Define, TRI); - AddDReg(MIB, DestReg, ARM::DSUBREG_1, RegState::Define, TRI); + AddDReg(MIB, DestReg, ARM::DSUBREG_1, RegState::Define, TRI); } } else { assert((RC == ARM::QQPRRegisterClass || RC == ARM::QQPR_VFP2RegisterClass || RC == ARM::QQPR_8RegisterClass) && "Unknown regclass!"); - llvm_unreachable("Not yet implemented!"); + if (Align >= 16 && getRegisterInfo().canRealignStack(MF)) { + MachineInstrBuilder MIB = BuildMI(MBB, I, DL, get(ARM::VLD2q32)); + MIB = AddDReg(MIB, DestReg, ARM::DSUBREG_0, RegState::Define, TRI); + MIB = AddDReg(MIB, DestReg, ARM::DSUBREG_1, RegState::Define, TRI); + MIB = AddDReg(MIB, DestReg, ARM::DSUBREG_2, RegState::Define, TRI); + MIB = AddDReg(MIB, DestReg, ARM::DSUBREG_3, RegState::Define, TRI); + AddDefaultPred(MIB.addFrameIndex(FI).addImm(128).addMemOperand(MMO)); + } else { + MachineInstrBuilder MIB = + AddDefaultPred(BuildMI(MBB, I, DL, get(ARM::VLDMD)) + .addFrameIndex(FI) + .addImm(ARM_AM::getAM5Opc(ARM_AM::ia, 4))) + .addMemOperand(MMO); + MIB = AddDReg(MIB, DestReg, ARM::DSUBREG_0, RegState::Define, TRI); + MIB = AddDReg(MIB, DestReg, ARM::DSUBREG_1, RegState::Define, TRI); + MIB = AddDReg(MIB, DestReg, ARM::DSUBREG_2, RegState::Define, TRI); + AddDReg(MIB, DestReg, ARM::DSUBREG_3, RegState::Define, TRI); + } } } Modified: llvm/trunk/lib/Target/ARM/ARMInstrNEON.td URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Target/ARM/ARMInstrNEON.td?rev=103235&r1=103234&r2=103235&view=diff ============================================================================== --- llvm/trunk/lib/Target/ARM/ARMInstrNEON.td (original) +++ llvm/trunk/lib/Target/ARM/ARMInstrNEON.td Thu May 6 21:04:02 2010 @@ -123,11 +123,6 @@ : AXDI5<(outs QPR:$dst), (ins addrmode5:$addr, pred:$p), IndexModeNone, IIC_fpLoadm, "vldm${addr:submode}${p}\t${addr:base}, ${dst:dregpair}", "", []>; -def VLDMQ_UPD - : AXDI5<(outs QPR:$dst, GPR:$wb), (ins addrmode5:$addr, pred:$p), - IndexModeUpd, IIC_fpLoadm, - "vldm${addr:submode}${p}\t${addr:base}!, ${dst:dregpair}", - "$addr.base = $wb", []>; } // mayLoad = 1 let mayStore = 1 in { @@ -138,11 +133,6 @@ : AXDI5<(outs), (ins QPR:$src, addrmode5:$addr, pred:$p), IndexModeNone, IIC_fpStorem, "vstm${addr:submode}${p}\t${addr:base}, ${src:dregpair}", "", []>; -def VSTMQ_UPD - : AXDI5<(outs GPR:$wb), (ins QPR:$src, addrmode5:$addr, pred:$p), - IndexModeUpd, IIC_fpStorem, - "vstm${addr:submode}${p}\t${addr:base}!, ${src:dregpair}", - "$addr.base = $wb", []>; } // mayStore = 1 let mayLoad = 1, hasExtraDefRegAllocReq = 1 in { From evan.cheng at apple.com Fri May 7 01:26:28 2010 From: evan.cheng at apple.com (Evan Cheng) Date: Fri, 07 May 2010 06:26:28 -0000 Subject: [llvm-commits] [test-suite] r103244 - /test-suite/trunk/MultiSource/Benchmarks/Makefile Message-ID: <20100507062628.77D3B312800A@llvm.org> Author: evancheng Date: Fri May 7 01:26:28 2010 New Revision: 103244 URL: http://llvm.org/viewvc/llvm-project?rev=103244&view=rev Log: Disable OptimizerEval. The amount of time it takes to run it changes dramatically between runs which makes it a poor benchmark. Modified: test-suite/trunk/MultiSource/Benchmarks/Makefile Modified: test-suite/trunk/MultiSource/Benchmarks/Makefile URL: http://llvm.org/viewvc/llvm-project/test-suite/trunk/MultiSource/Benchmarks/Makefile?rev=103244&r1=103243&r2=103244&view=diff ============================================================================== --- test-suite/trunk/MultiSource/Benchmarks/Makefile (original) +++ test-suite/trunk/MultiSource/Benchmarks/Makefile Fri May 7 01:26:28 2010 @@ -1,8 +1,9 @@ # MultiSource/Benchmarks Makefile: Build all subdirectories automatically LEVEL = ../.. +# Disabled: OptimizerEval. PARALLEL_DIRS := Fhourstones Fhourstones-3.1 \ - McCat Olden OptimizerEval Ptrdist llubenchmark \ + McCat Olden Ptrdist llubenchmark \ sim FreeBench MallocBench Prolangs-C SciMark2-C\ mediabench ASCI_Purple MiBench Trimaran VersaBench NPB-serial\ BitBench ASC_Sequoia From echristo at apple.com Fri May 7 02:02:44 2010 From: echristo at apple.com (Eric Christopher) Date: Fri, 7 May 2010 00:02:44 -0700 Subject: [llvm-commits] [test-suite] r103244 - /test-suite/trunk/MultiSource/Benchmarks/Makefile In-Reply-To: <20100507062628.77D3B312800A@llvm.org> References: <20100507062628.77D3B312800A@llvm.org> Message-ID: <84FBE6F4-5EF1-4196-A0F8-5B8022276638@apple.com> On May 6, 2010, at 11:26 PM, Evan Cheng wrote: > Author: evancheng > Date: Fri May 7 01:26:28 2010 > New Revision: 103244 > > URL: http://llvm.org/viewvc/llvm-project?rev=103244&view=rev > Log: > Disable OptimizerEval. The amount of time it takes to run it changes dramatically between runs which makes it a poor benchmark. Yay. -eric From echristo at apple.com Fri May 7 02:11:29 2010 From: echristo at apple.com (Eric Christopher) Date: Fri, 07 May 2010 07:11:29 -0000 Subject: [llvm-commits] [llvm-gcc-4.2] r103245 - /llvm-gcc-4.2/trunk/gcc/Makefile.in Message-ID: <20100507071129.8237C312800A@llvm.org> Author: echristo Date: Fri May 7 02:11:29 2010 New Revision: 103245 URL: http://llvm.org/viewvc/llvm-project?rev=103245&view=rev Log: There's no reason to do this anymore that I can tell and Bill can't remember why either. Modified: llvm-gcc-4.2/trunk/gcc/Makefile.in Modified: llvm-gcc-4.2/trunk/gcc/Makefile.in URL: http://llvm.org/viewvc/llvm-project/llvm-gcc-4.2/trunk/gcc/Makefile.in?rev=103245&r1=103244&r2=103245&view=diff ============================================================================== --- llvm-gcc-4.2/trunk/gcc/Makefile.in (original) +++ llvm-gcc-4.2/trunk/gcc/Makefile.in Fri May 7 02:11:29 2010 @@ -4103,12 +4103,10 @@ # and also as either gcc (if native) or $(gcc_tooldir)/bin/gcc. # LLVM LOCAL begin copy libstdc++.dylib on Darwin -ifneq (,$(findstring darwin,$(target))) install-driver: installdirs xgcc$(exeext) -rm -f $(DESTDIR)$(bindir)/$(GCC_INSTALL_NAME)$(exeext) -$(INSTALL_PROGRAM) xgcc$(exeext) $(DESTDIR)$(bindir)/$(GCC_INSTALL_NAME)$(exeext) -rm -f $(DESTDIR)$(bindir)/$(target_noncanonical)-gcc-$(version)$(exeext) - -cp -p /usr/lib/libstdc++.6.dylib $(DESTDIR)$(libsubdir)/libstdc++.dylib -( cd $(DESTDIR)$(bindir) && \ $(LN) $(GCC_INSTALL_NAME)$(exeext) $(target_noncanonical)-gcc-$(version)$(exeext) ) -if [ -f gcc-cross$(exeext) ] ; then \ @@ -4122,26 +4120,6 @@ $(LN) $(GCC_INSTALL_NAME)$(exeext) $(target_noncanonical)-gcc-tmp$(exeext) && \ mv -f $(target_noncanonical)-gcc-tmp$(exeext) $(GCC_TARGET_INSTALL_NAME)$(exeext) ); \ fi -else -install-driver: installdirs xgcc$(exeext) - -rm -f $(DESTDIR)$(bindir)/$(GCC_INSTALL_NAME)$(exeext) - -$(INSTALL_PROGRAM) xgcc$(exeext) $(DESTDIR)$(bindir)/$(GCC_INSTALL_NAME)$(exeext) - -rm -f $(DESTDIR)$(bindir)/$(target_noncanonical)-gcc-$(version)$(exeext) - -( cd $(DESTDIR)$(bindir) && \ - $(LN) $(GCC_INSTALL_NAME)$(exeext) $(target_noncanonical)-gcc-$(version)$(exeext) ) - -if [ -f gcc-cross$(exeext) ] ; then \ - if [ -d $(DESTDIR)$(gcc_tooldir)/bin/. ] ; then \ - rm -f $(DESTDIR)$(gcc_tooldir)/bin/gcc$(exeext); \ - $(INSTALL_PROGRAM) gcc-cross$(exeext) $(DESTDIR)$(gcc_tooldir)/bin/gcc$(exeext); \ - else true; fi; \ - else \ - rm -f $(DESTDIR)$(bindir)/$(target_noncanonical)-gcc-tmp$(exeext); \ - ( cd $(DESTDIR)$(bindir) && \ - $(LN) $(GCC_INSTALL_NAME)$(exeext) $(target_noncanonical)-gcc-tmp$(exeext) && \ - mv -f $(target_noncanonical)-gcc-tmp$(exeext) $(GCC_TARGET_INSTALL_NAME)$(exeext) ); \ - fi -endif -# LLVM LOCAL end copy libstdc++.dylib on Darwin # Install the info files. # $(INSTALL_DATA) might be a relative pathname, so we can't cd into srcdir From echristo at apple.com Fri May 7 02:47:17 2010 From: echristo at apple.com (Eric Christopher) Date: Fri, 07 May 2010 07:47:17 -0000 Subject: [llvm-commits] [llvm-gcc-4.2] r103246 - /llvm-gcc-4.2/trunk/gcc/Makefile.in Message-ID: <20100507074717.142DA312800A@llvm.org> Author: echristo Date: Fri May 7 02:47:16 2010 New Revision: 103246 URL: http://llvm.org/viewvc/llvm-project?rev=103246&view=rev Log: Temporarily revert this since it broke a builder that's now no longer responding. Modified: llvm-gcc-4.2/trunk/gcc/Makefile.in Modified: llvm-gcc-4.2/trunk/gcc/Makefile.in URL: http://llvm.org/viewvc/llvm-project/llvm-gcc-4.2/trunk/gcc/Makefile.in?rev=103246&r1=103245&r2=103246&view=diff ============================================================================== --- llvm-gcc-4.2/trunk/gcc/Makefile.in (original) +++ llvm-gcc-4.2/trunk/gcc/Makefile.in Fri May 7 02:47:16 2010 @@ -4103,10 +4103,12 @@ # and also as either gcc (if native) or $(gcc_tooldir)/bin/gcc. # LLVM LOCAL begin copy libstdc++.dylib on Darwin +ifneq (,$(findstring darwin,$(target))) install-driver: installdirs xgcc$(exeext) -rm -f $(DESTDIR)$(bindir)/$(GCC_INSTALL_NAME)$(exeext) -$(INSTALL_PROGRAM) xgcc$(exeext) $(DESTDIR)$(bindir)/$(GCC_INSTALL_NAME)$(exeext) -rm -f $(DESTDIR)$(bindir)/$(target_noncanonical)-gcc-$(version)$(exeext) + -cp -p /usr/lib/libstdc++.6.dylib $(DESTDIR)$(libsubdir)/libstdc++.dylib -( cd $(DESTDIR)$(bindir) && \ $(LN) $(GCC_INSTALL_NAME)$(exeext) $(target_noncanonical)-gcc-$(version)$(exeext) ) -if [ -f gcc-cross$(exeext) ] ; then \ @@ -4120,6 +4122,26 @@ $(LN) $(GCC_INSTALL_NAME)$(exeext) $(target_noncanonical)-gcc-tmp$(exeext) && \ mv -f $(target_noncanonical)-gcc-tmp$(exeext) $(GCC_TARGET_INSTALL_NAME)$(exeext) ); \ fi +else +install-driver: installdirs xgcc$(exeext) + -rm -f $(DESTDIR)$(bindir)/$(GCC_INSTALL_NAME)$(exeext) + -$(INSTALL_PROGRAM) xgcc$(exeext) $(DESTDIR)$(bindir)/$(GCC_INSTALL_NAME)$(exeext) + -rm -f $(DESTDIR)$(bindir)/$(target_noncanonical)-gcc-$(version)$(exeext) + -( cd $(DESTDIR)$(bindir) && \ + $(LN) $(GCC_INSTALL_NAME)$(exeext) $(target_noncanonical)-gcc-$(version)$(exeext) ) + -if [ -f gcc-cross$(exeext) ] ; then \ + if [ -d $(DESTDIR)$(gcc_tooldir)/bin/. ] ; then \ + rm -f $(DESTDIR)$(gcc_tooldir)/bin/gcc$(exeext); \ + $(INSTALL_PROGRAM) gcc-cross$(exeext) $(DESTDIR)$(gcc_tooldir)/bin/gcc$(exeext); \ + else true; fi; \ + else \ + rm -f $(DESTDIR)$(bindir)/$(target_noncanonical)-gcc-tmp$(exeext); \ + ( cd $(DESTDIR)$(bindir) && \ + $(LN) $(GCC_INSTALL_NAME)$(exeext) $(target_noncanonical)-gcc-tmp$(exeext) && \ + mv -f $(target_noncanonical)-gcc-tmp$(exeext) $(GCC_TARGET_INSTALL_NAME)$(exeext) ); \ + fi +endif +# LLVM LOCAL end copy libstdc++.dylib on Darwin # Install the info files. # $(INSTALL_DATA) might be a relative pathname, so we can't cd into srcdir From grosser at fim.uni-passau.de Fri May 7 04:33:18 2010 From: grosser at fim.uni-passau.de (Tobias Grosser) Date: Fri, 07 May 2010 09:33:18 -0000 Subject: [llvm-commits] [llvm] r103251 - /llvm/trunk/docs/Passes.html Message-ID: <20100507093318.D04E4312800A@llvm.org> Author: grosser Date: Fri May 7 04:33:18 2010 New Revision: 103251 URL: http://llvm.org/viewvc/llvm-project?rev=103251&view=rev Log: Document graphviz passes for the (post) dominator tree. Add documentation for: -dot-dom -dot-dom-only -dot-postdom -dot-postdom-only -view-dom -view-dom-only -view-postdom -view-postdom-only Modified: llvm/trunk/docs/Passes.html Modified: llvm/trunk/docs/Passes.html URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/Passes.html?rev=103251&r1=103250&r2=103251&view=diff ============================================================================== --- llvm/trunk/docs/Passes.html (original) +++ llvm/trunk/docs/Passes.html Fri May 7 04:33:18 2010 @@ -85,6 +85,10 @@ -dot-callgraphPrint Call Graph to 'dot' file -dot-cfgPrint CFG of function to 'dot' file -dot-cfg-onlyPrint CFG of function to 'dot' file (with no function bodies) +-dot-domPrint dominator tree of function to 'dot' file +-dot-dom-onlyPrint dominator tree of function to 'dot' file (with no function bodies) +-dot-postdomPrint post dominator tree of function to 'dot' file +-dot-postdom-onlyPrint post dominator tree of function to 'dot' file (with no function bodies) -globalsmodref-aaSimple mod/ref analysis for globals -instcountCounts the various types of Instructions -intervalsInterval Partition Construction @@ -177,6 +181,10 @@ -verifyModule Verifier -view-cfgView CFG of function -view-cfg-onlyView CFG of function (with no function bodies) +-view-domView dominator tree of function +-view-dom-onlyView dominator tree of function (with no function bodies) +-view-postdomView post dominator tree of function +-view-postdom-onlyView post dominator tree of function (with no function bodies) @@ -321,6 +329,58 @@
      + Print dominator tree of function to 'dot' file +
      +
      +

      + This pass, only available in opt, prints the dominator tree + into a .dot graph. This graph can then be processed with the + "dot" tool to convert it to postscript or some other suitable format. +

      +
      + + +
      + Print dominator tree of function to 'dot' file (with no + function bodies) +
      +
      +

      + This pass, only available in opt, prints the dominator tree + into a .dot graph, omitting the function bodies. This graph can + then be processed with the "dot" tool to convert it to postscript or some + other suitable format. +

      +
      + + +
      + Print post dominator tree of function to 'dot' file +
      +
      +

      + This pass, only available in opt, prints the post dominator tree + into a .dot graph. This graph can then be processed with the + "dot" tool to convert it to postscript or some other suitable format. +

      +
      + + +
      + Print post dominator tree of function to 'dot' file + (with no function bodies) +
      +
      +

      + This pass, only available in opt, prints the post dominator tree + into a .dot graph, omitting the function bodies. This graph can + then be processed with the "dot" tool to convert it to postscript or some + other suitable format. +

      +
      + + +
      Simple mod/ref analysis for globals
      @@ -1752,6 +1812,52 @@

      + +
      + View dominator tree of function +
      +
      +

      + Displays the dominator tree using the GraphViz tool. +

      +
      + + +
      + View dominator tree of function (with no function + bodies) + +
      +
      +

      + Displays the dominator tree using the GraphViz tool, but omitting function + bodies. +

      +
      + + +
      + View post dominator tree of function +
      +
      +

      + Displays the post dominator tree using the GraphViz tool. +

      +
      + + +
      + View post dominator tree of function (with no + function bodies) + +
      +
      +

      + Displays the post dominator tree using the GraphViz tool, but omitting + function bodies. +

      +
      +
      From gohman at apple.com Fri May 7 10:30:29 2010 From: gohman at apple.com (Dan Gohman) Date: Fri, 07 May 2010 15:30:29 -0000 Subject: [llvm-commits] [llvm] r103254 - in /llvm/trunk: include/llvm/Analysis/DebugInfo.h lib/Analysis/DebugInfo.cpp Message-ID: <20100507153029.4A063312800A@llvm.org> Author: djg Date: Fri May 7 10:30:29 2010 New Revision: 103254 URL: http://llvm.org/viewvc/llvm-project?rev=103254&view=rev Log: Convert the DebugInfo classes dump() methods into print(raw_ostream &) methods, and add dump functions implemented in terms of the print. Modified: llvm/trunk/include/llvm/Analysis/DebugInfo.h llvm/trunk/lib/Analysis/DebugInfo.cpp Modified: llvm/trunk/include/llvm/Analysis/DebugInfo.h URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/include/llvm/Analysis/DebugInfo.h?rev=103254&r1=103253&r2=103254&view=diff ============================================================================== --- llvm/trunk/include/llvm/Analysis/DebugInfo.h (original) +++ llvm/trunk/include/llvm/Analysis/DebugInfo.h Fri May 7 10:30:29 2010 @@ -34,6 +34,7 @@ class Instruction; class MDNode; class LLVMContext; + class raw_ostream; /// DIDescriptor - A thin wraper around MDNode to access encoded debug info. /// This should not be stored in a container, because underly MDNode may @@ -75,7 +76,10 @@ /// ValidDebugInfo - Return true if N represents valid debug info value. static bool ValidDebugInfo(MDNode *N, unsigned OptLevel); - /// dump - print descriptor. + /// print - print descriptor. + void print(raw_ostream &OS) const; + + /// dump - print descriptor to dbgs() with a newline. void dump() const; bool isDerivedType() const; @@ -153,7 +157,10 @@ /// Verify - Verify that a compile unit is well formed. bool Verify() const; - /// dump - print compile unit. + /// print - print compile unit. + void print(raw_ostream &OS) const; + + /// dump - print compile unit to dbgs() with a newline. void dump() const; }; @@ -253,7 +260,11 @@ } StringRef getFilename() const { return getCompileUnit().getFilename();} StringRef getDirectory() const { return getCompileUnit().getDirectory();} - /// dump - print type. + + /// print - print type. + void print(raw_ostream &OS) const; + + /// dump - print type to dbgs() with a newline. void dump() const; }; @@ -264,7 +275,10 @@ unsigned getEncoding() const { return getUnsignedField(9); } - /// dump - print basic type. + /// print - print basic type. + void print(raw_ostream &OS) const; + + /// dump - print basic type to dbgs() with a newline. void dump() const; }; @@ -283,7 +297,11 @@ /// getOriginalTypeSize - If this type is derived from a base type then /// return base type size. uint64_t getOriginalTypeSize() const; - /// dump - print derived type. + + /// print - print derived type. + void print(raw_ostream &OS) const; + + /// dump - print derived type to dbgs() with a newline. void dump() const; /// replaceAllUsesWith - Replace all uses of debug info referenced by @@ -312,7 +330,10 @@ /// Verify - Verify that a composite type descriptor is well formed. bool Verify() const; - /// dump - print composite type. + /// print - print composite type. + void print(raw_ostream &OS) const; + + /// dump - print composite type to dbgs() with a newline. void dump() const; }; @@ -344,7 +365,10 @@ unsigned isLocalToUnit() const { return getUnsignedField(9); } unsigned isDefinition() const { return getUnsignedField(10); } - /// dump - print global. + /// print - print global. + void print(raw_ostream &OS) const; + + /// dump - print global to dbgs() with a newline. void dump() const; }; @@ -413,7 +437,10 @@ /// Verify - Verify that a subprogram descriptor is well formed. bool Verify() const; - /// dump - print subprogram. + /// print - print subprogram. + void print(raw_ostream &OS) const; + + /// dump - print subprogram to dbgs() with a newline. void dump() const; /// describes - Return true if this subprogram provides debugging @@ -431,7 +458,10 @@ /// Verify - Verify that a global variable descriptor is well formed. bool Verify() const; - /// dump - print global variable. + /// print - print global variable. + void print(raw_ostream &OS) const; + + /// dump - print global variable to dbgs() with a newline. void dump() const; }; @@ -479,7 +509,10 @@ /// information for an inlined function arguments. bool isInlinedFnArgument(const Function *CurFn); - /// dump - print variable. + /// print - print variable. + void print(raw_ostream &OS) const; + + /// dump - print variable to dbgs() with a newline. void dump() const; }; Modified: llvm/trunk/lib/Analysis/DebugInfo.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Analysis/DebugInfo.cpp?rev=103254&r1=103253&r2=103254&view=diff ============================================================================== --- llvm/trunk/lib/Analysis/DebugInfo.cpp (original) +++ llvm/trunk/lib/Analysis/DebugInfo.cpp Fri May 7 10:30:29 2010 @@ -475,34 +475,34 @@ //===----------------------------------------------------------------------===// -/// dump - Print descriptor. -void DIDescriptor::dump() const { - dbgs() << "[" << dwarf::TagString(getTag()) << "] "; - dbgs().write_hex((intptr_t) &*DbgNode) << ']'; +/// print - Print descriptor. +void DIDescriptor::print(raw_ostream &OS) const { + OS << "[" << dwarf::TagString(getTag()) << "] "; + OS.write_hex((intptr_t) &*DbgNode) << ']'; } -/// dump - Print compile unit. -void DICompileUnit::dump() const { +/// print - Print compile unit. +void DICompileUnit::print(raw_ostream &OS) const { if (getLanguage()) - dbgs() << " [" << dwarf::LanguageString(getLanguage()) << "] "; + OS << " [" << dwarf::LanguageString(getLanguage()) << "] "; - dbgs() << " [" << getDirectory() << "/" << getFilename() << " ]"; + OS << " [" << getDirectory() << "/" << getFilename() << " ]"; } -/// dump - Print type. -void DIType::dump() const { +/// print - Print type. +void DIType::print(raw_ostream &OS) const { if (!DbgNode) return; StringRef Res = getName(); if (!Res.empty()) - dbgs() << " [" << Res << "] "; + OS << " [" << Res << "] "; unsigned Tag = getTag(); - dbgs() << " [" << dwarf::TagString(Tag) << "] "; + OS << " [" << dwarf::TagString(Tag) << "] "; // TODO : Print context getCompileUnit().dump(); - dbgs() << " [" + OS << " [" << getLineNumber() << ", " << getSizeInBits() << ", " << getAlignInBits() << ", " @@ -510,12 +510,12 @@ << "] "; if (isPrivate()) - dbgs() << " [private] "; + OS << " [private] "; else if (isProtected()) - dbgs() << " [protected] "; + OS << " [protected] "; if (isForwardDecl()) - dbgs() << " [fwd] "; + OS << " [fwd] "; if (isBasicType()) DIBasicType(DbgNode).dump(); @@ -524,97 +524,147 @@ else if (isCompositeType()) DICompositeType(DbgNode).dump(); else { - dbgs() << "Invalid DIType\n"; + OS << "Invalid DIType\n"; return; } - dbgs() << "\n"; + OS << "\n"; } -/// dump - Print basic type. -void DIBasicType::dump() const { - dbgs() << " [" << dwarf::AttributeEncodingString(getEncoding()) << "] "; +/// print - Print basic type. +void DIBasicType::print(raw_ostream &OS) const { + OS << " [" << dwarf::AttributeEncodingString(getEncoding()) << "] "; } -/// dump - Print derived type. -void DIDerivedType::dump() const { - dbgs() << "\n\t Derived From: "; getTypeDerivedFrom().dump(); +/// print - Print derived type. +void DIDerivedType::print(raw_ostream &OS) const { + OS << "\n\t Derived From: "; getTypeDerivedFrom().dump(); } -/// dump - Print composite type. -void DICompositeType::dump() const { +/// print - Print composite type. +void DICompositeType::print(raw_ostream &OS) const { DIArray A = getTypeArray(); - dbgs() << " [" << A.getNumElements() << " elements]"; + OS << " [" << A.getNumElements() << " elements]"; } -/// dump - Print global. -void DIGlobal::dump() const { +/// print - Print global. +void DIGlobal::print(raw_ostream &OS) const { StringRef Res = getName(); if (!Res.empty()) - dbgs() << " [" << Res << "] "; + OS << " [" << Res << "] "; unsigned Tag = getTag(); - dbgs() << " [" << dwarf::TagString(Tag) << "] "; + OS << " [" << dwarf::TagString(Tag) << "] "; // TODO : Print context getCompileUnit().dump(); - dbgs() << " [" << getLineNumber() << "] "; + OS << " [" << getLineNumber() << "] "; if (isLocalToUnit()) - dbgs() << " [local] "; + OS << " [local] "; if (isDefinition()) - dbgs() << " [def] "; + OS << " [def] "; if (isGlobalVariable()) DIGlobalVariable(DbgNode).dump(); - dbgs() << "\n"; + OS << "\n"; } -/// dump - Print subprogram. -void DISubprogram::dump() const { +/// print - Print subprogram. +void DISubprogram::print(raw_ostream &OS) const { StringRef Res = getName(); if (!Res.empty()) - dbgs() << " [" << Res << "] "; + OS << " [" << Res << "] "; unsigned Tag = getTag(); - dbgs() << " [" << dwarf::TagString(Tag) << "] "; + OS << " [" << dwarf::TagString(Tag) << "] "; // TODO : Print context getCompileUnit().dump(); - dbgs() << " [" << getLineNumber() << "] "; + OS << " [" << getLineNumber() << "] "; if (isLocalToUnit()) - dbgs() << " [local] "; + OS << " [local] "; if (isDefinition()) - dbgs() << " [def] "; + OS << " [def] "; - dbgs() << "\n"; + OS << "\n"; } -/// dump - Print global variable. -void DIGlobalVariable::dump() const { - dbgs() << " ["; +/// print - Print global variable. +void DIGlobalVariable::print(raw_ostream &OS) const { + OS << " ["; getGlobal()->dump(); - dbgs() << "] "; + OS << "] "; } -/// dump - Print variable. -void DIVariable::dump() const { +/// print - Print variable. +void DIVariable::print(raw_ostream &OS) const { StringRef Res = getName(); if (!Res.empty()) - dbgs() << " [" << Res << "] "; + OS << " [" << Res << "] "; getCompileUnit().dump(); - dbgs() << " [" << getLineNumber() << "] "; + OS << " [" << getLineNumber() << "] "; getType().dump(); - dbgs() << "\n"; + OS << "\n"; // FIXME: Dump complex addresses } +/// dump - Print descriptor to dbgs() with a newline. +void DIDescriptor::dump() const { + print(dbgs()); dbgs() << '\n'; +} + +/// dump - Print compile unit to dbgs() with a newline. +void DICompileUnit::dump() const { + print(dbgs()); dbgs() << '\n'; +} + +/// dump - Print type to dbgs() with a newline. +void DIType::dump() const { + print(dbgs()); dbgs() << '\n'; +} + +/// dump - Print basic type to dbgs() with a newline. +void DIBasicType::dump() const { + print(dbgs()); dbgs() << '\n'; +} + +/// dump - Print derived type to dbgs() with a newline. +void DIDerivedType::dump() const { + print(dbgs()); dbgs() << '\n'; +} + +/// dump - Print composite type to dbgs() with a newline. +void DICompositeType::dump() const { + print(dbgs()); dbgs() << '\n'; +} + +/// dump - Print global to dbgs() with a newline. +void DIGlobal::dump() const { + print(dbgs()); dbgs() << '\n'; +} + +/// dump - Print subprogram to dbgs() with a newline. +void DISubprogram::dump() const { + print(dbgs()); dbgs() << '\n'; +} + +/// dump - Print global variable. +void DIGlobalVariable::dump() const { + print(dbgs()); dbgs() << '\n'; +} + +/// dump - Print variable. +void DIVariable::dump() const { + print(dbgs()); dbgs() << '\n'; +} + //===----------------------------------------------------------------------===// // DIFactory: Basic Helpers //===----------------------------------------------------------------------===// From gohman at apple.com Fri May 7 10:36:10 2010 From: gohman at apple.com (Dan Gohman) Date: Fri, 07 May 2010 15:36:10 -0000 Subject: [llvm-commits] [llvm] r103256 - /llvm/trunk/include/llvm/Analysis/DebugInfo.h Message-ID: <20100507153610.B3DCD312800A@llvm.org> Author: djg Date: Fri May 7 10:36:10 2010 New Revision: 103256 URL: http://llvm.org/viewvc/llvm-project?rev=103256&view=rev Log: Const-ify some stuff. Modified: llvm/trunk/include/llvm/Analysis/DebugInfo.h Modified: llvm/trunk/include/llvm/Analysis/DebugInfo.h URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/include/llvm/Analysis/DebugInfo.h?rev=103256&r1=103255&r2=103256&view=diff ============================================================================== --- llvm/trunk/include/llvm/Analysis/DebugInfo.h (original) +++ llvm/trunk/include/llvm/Analysis/DebugInfo.h Fri May 7 10:36:10 2010 @@ -788,20 +788,20 @@ bool addType(DIType DT); public: - typedef SmallVector::iterator iterator; - iterator compile_unit_begin() { return CUs.begin(); } - iterator compile_unit_end() { return CUs.end(); } - iterator subprogram_begin() { return SPs.begin(); } - iterator subprogram_end() { return SPs.end(); } - iterator global_variable_begin() { return GVs.begin(); } - iterator global_variable_end() { return GVs.end(); } - iterator type_begin() { return TYs.begin(); } - iterator type_end() { return TYs.end(); } + typedef SmallVector::const_iterator iterator; + iterator compile_unit_begin() const { return CUs.begin(); } + iterator compile_unit_end() const { return CUs.end(); } + iterator subprogram_begin() const { return SPs.begin(); } + iterator subprogram_end() const { return SPs.end(); } + iterator global_variable_begin() const { return GVs.begin(); } + iterator global_variable_end() const { return GVs.end(); } + iterator type_begin() const { return TYs.begin(); } + iterator type_end() const { return TYs.end(); } - unsigned compile_unit_count() { return CUs.size(); } - unsigned global_variable_count() { return GVs.size(); } - unsigned subprogram_count() { return SPs.size(); } - unsigned type_count() { return TYs.size(); } + unsigned compile_unit_count() const { return CUs.size(); } + unsigned global_variable_count() const { return GVs.size(); } + unsigned subprogram_count() const { return SPs.size(); } + unsigned type_count() const { return TYs.size(); } private: SmallVector CUs; // Compile Units From gohman at apple.com Fri May 7 10:40:13 2010 From: gohman at apple.com (Dan Gohman) Date: Fri, 07 May 2010 15:40:13 -0000 Subject: [llvm-commits] [llvm] r103257 - in /llvm/trunk: include/llvm/LinkAllPasses.h include/llvm/Transforms/Scalar.h lib/Transforms/Scalar/Sink.cpp test/Transforms/Sink/ test/Transforms/Sink/basic.ll test/Transforms/Sink/dg.exp Message-ID: <20100507154013.E14C0312800A@llvm.org> Author: djg Date: Fri May 7 10:40:13 2010 New Revision: 103257 URL: http://llvm.org/viewvc/llvm-project?rev=103257&view=rev Log: Add an LLVM IR version of code sinking. This uses the same simple algorithm as MachineSink, but it isn't constrained by MachineInstr-level details. Added: llvm/trunk/lib/Transforms/Scalar/Sink.cpp llvm/trunk/test/Transforms/Sink/ (with props) llvm/trunk/test/Transforms/Sink/basic.ll llvm/trunk/test/Transforms/Sink/dg.exp Modified: llvm/trunk/include/llvm/LinkAllPasses.h llvm/trunk/include/llvm/Transforms/Scalar.h Modified: llvm/trunk/include/llvm/LinkAllPasses.h URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/include/llvm/LinkAllPasses.h?rev=103257&r1=103256&r2=103257&view=diff ============================================================================== --- llvm/trunk/include/llvm/LinkAllPasses.h (original) +++ llvm/trunk/include/llvm/LinkAllPasses.h Fri May 7 10:40:13 2010 @@ -138,6 +138,7 @@ (void) llvm::createGEPSplitterPass(); (void) llvm::createABCDPass(); (void) llvm::createLintPass(); + (void) llvm::createSinkingPass(); (void)new llvm::IntervalPartition(); (void)new llvm::FindUsedTypes(); Modified: llvm/trunk/include/llvm/Transforms/Scalar.h URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/include/llvm/Transforms/Scalar.h?rev=103257&r1=103256&r2=103257&view=diff ============================================================================== --- llvm/trunk/include/llvm/Transforms/Scalar.h (original) +++ llvm/trunk/include/llvm/Transforms/Scalar.h Fri May 7 10:40:13 2010 @@ -332,6 +332,12 @@ // FunctionPass *createABCDPass(); +//===----------------------------------------------------------------------===// +// +// Sink - Code Sinking +// +FunctionPass *createSinkingPass(); + } // End llvm namespace #endif Added: llvm/trunk/lib/Transforms/Scalar/Sink.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Transforms/Scalar/Sink.cpp?rev=103257&view=auto ============================================================================== --- llvm/trunk/lib/Transforms/Scalar/Sink.cpp (added) +++ llvm/trunk/lib/Transforms/Scalar/Sink.cpp Fri May 7 10:40:13 2010 @@ -0,0 +1,267 @@ +//===-- Sink.cpp - Code Sinking -------------------------------------------===// +// +// The LLVM Compiler Infrastructure +// +// This file is distributed under the University of Illinois Open Source +// License. See LICENSE.TXT for details. +// +//===----------------------------------------------------------------------===// +// +// This pass moves instructions into successor blocks, when possible, so that +// they aren't executed on paths where their results aren't needed. +// +//===----------------------------------------------------------------------===// + +#define DEBUG_TYPE "sink" +#include "llvm/Transforms/Scalar.h" +#include "llvm/IntrinsicInst.h" +#include "llvm/Analysis/Dominators.h" +#include "llvm/Analysis/LoopInfo.h" +#include "llvm/Analysis/AliasAnalysis.h" +#include "llvm/Assembly/Writer.h" +#include "llvm/ADT/Statistic.h" +#include "llvm/Support/CFG.h" +#include "llvm/Support/Debug.h" +#include "llvm/Support/raw_ostream.h" +using namespace llvm; + +STATISTIC(NumSunk, "Number of instructions sunk"); + +namespace { + class Sinking : public FunctionPass { + DominatorTree *DT; + LoopInfo *LI; + AliasAnalysis *AA; + + public: + static char ID; // Pass identification + Sinking() : FunctionPass(&ID) {} + + virtual bool runOnFunction(Function &F); + + virtual void getAnalysisUsage(AnalysisUsage &AU) const { + AU.setPreservesCFG(); + FunctionPass::getAnalysisUsage(AU); + AU.addRequired(); + AU.addRequired(); + AU.addRequired(); + AU.addPreserved(); + AU.addPreserved(); + } + private: + bool ProcessBlock(BasicBlock &BB); + bool SinkInstruction(Instruction *I, SmallPtrSet &Stores); + bool AllUsesDominatedByBlock(Instruction *Inst, BasicBlock *BB) const; + }; +} // end anonymous namespace + +char Sinking::ID = 0; +static RegisterPass +X("sink", "Code sinking"); + +FunctionPass *llvm::createSinkingPass() { return new Sinking(); } + +/// AllUsesDominatedByBlock - Return true if all uses of the specified value +/// occur in blocks dominated by the specified block. +bool Sinking::AllUsesDominatedByBlock(Instruction *Inst, + BasicBlock *BB) const { + // Ignoring debug uses is necessary so debug info doesn't affect the code. + // This may leave a referencing dbg_value in the original block, before + // the definition of the vreg. Dwarf generator handles this although the + // user might not get the right info at runtime. + for (Value::use_iterator I = Inst->use_begin(), + E = Inst->use_end(); I != E; ++I) { + // Determine the block of the use. + Instruction *UseInst = cast(*I); + BasicBlock *UseBlock = UseInst->getParent(); + if (PHINode *PN = dyn_cast(UseInst)) { + // PHI nodes use the operand in the predecessor block, not the block with + // the PHI. + unsigned Num = PHINode::getIncomingValueNumForOperand(I.getOperandNo()); + UseBlock = PN->getIncomingBlock(Num); + } + // Check that it dominates. + if (!DT->dominates(BB, UseBlock)) + return false; + } + return true; +} + +bool Sinking::runOnFunction(Function &F) { + DT = &getAnalysis(); + LI = &getAnalysis(); + AA = &getAnalysis(); + + bool EverMadeChange = false; + + while (1) { + bool MadeChange = false; + + // Process all basic blocks. + for (Function::iterator I = F.begin(), E = F.end(); + I != E; ++I) + MadeChange |= ProcessBlock(*I); + + // If this iteration over the code changed anything, keep iterating. + if (!MadeChange) break; + EverMadeChange = true; + } + return EverMadeChange; +} + +bool Sinking::ProcessBlock(BasicBlock &BB) { + // Can't sink anything out of a block that has less than two successors. + if (BB.getTerminator()->getNumSuccessors() <= 1 || BB.empty()) return false; + + // Don't bother sinking code out of unreachable blocks. In addition to being + // unprofitable, it can also lead to infinite looping, because in an unreachable + // loop there may be nowhere to stop. + if (!DT->isReachableFromEntry(&BB)) return false; + + bool MadeChange = false; + + // Walk the basic block bottom-up. Remember if we saw a store. + BasicBlock::iterator I = BB.end(); + --I; + bool ProcessedBegin = false; + SmallPtrSet Stores; + do { + Instruction *Inst = I; // The instruction to sink. + + // Predecrement I (if it's not begin) so that it isn't invalidated by + // sinking. + ProcessedBegin = I == BB.begin(); + if (!ProcessedBegin) + --I; + + if (isa(Inst)) + continue; + + if (SinkInstruction(Inst, Stores)) + ++NumSunk, MadeChange = true; + + // If we just processed the first instruction in the block, we're done. + } while (!ProcessedBegin); + + return MadeChange; +} + +static bool isSafeToMove(Instruction *Inst, AliasAnalysis *AA, + SmallPtrSet &Stores) { + if (LoadInst *L = dyn_cast(Inst)) { + if (L->isVolatile()) return false; + + Value *Ptr = L->getPointerOperand(); + unsigned Size = AA->getTypeStoreSize(L->getType()); + for (SmallPtrSet::iterator I = Stores.begin(), + E = Stores.end(); I != E; ++I) + if (AA->getModRefInfo(*I, Ptr, Size) & AliasAnalysis::Mod) + return false; + } + + if (Inst->mayWriteToMemory()) { + Stores.insert(Inst); + return false; + } + + return Inst->isSafeToSpeculativelyExecute(); +} + +/// SinkInstruction - Determine whether it is safe to sink the specified machine +/// instruction out of its current block into a successor. +bool Sinking::SinkInstruction(Instruction *Inst, + SmallPtrSet &Stores) { + // Check if it's safe to move the instruction. + if (!isSafeToMove(Inst, AA, Stores)) + return false; + + // FIXME: This should include support for sinking instructions within the + // block they are currently in to shorten the live ranges. We often get + // instructions sunk into the top of a large block, but it would be better to + // also sink them down before their first use in the block. This xform has to + // be careful not to *increase* register pressure though, e.g. sinking + // "x = y + z" down if it kills y and z would increase the live ranges of y + // and z and only shrink the live range of x. + + // Loop over all the operands of the specified instruction. If there is + // anything we can't handle, bail out. + BasicBlock *ParentBlock = Inst->getParent(); + + // SuccToSinkTo - This is the successor to sink this instruction to, once we + // decide. + BasicBlock *SuccToSinkTo = 0; + + // FIXME: This picks a successor to sink into based on having one + // successor that dominates all the uses. However, there are cases where + // sinking can happen but where the sink point isn't a successor. For + // example: + // x = computation + // if () {} else {} + // use x + // the instruction could be sunk over the whole diamond for the + // if/then/else (or loop, etc), allowing it to be sunk into other blocks + // after that. + + // Instructions can only be sunk if all their uses are in blocks + // dominated by one of the successors. + // Look at all the successors and decide which one + // we should sink to. + for (succ_iterator SI = succ_begin(ParentBlock), + E = succ_end(ParentBlock); SI != E; ++SI) { + if (AllUsesDominatedByBlock(Inst, *SI)) { + SuccToSinkTo = *SI; + break; + } + } + + // If we couldn't find a block to sink to, ignore this instruction. + if (SuccToSinkTo == 0) + return false; + + // It is not possible to sink an instruction into its own block. This can + // happen with loops. + if (Inst->getParent() == SuccToSinkTo) + return false; + + DEBUG(dbgs() << "Sink instr " << *Inst); + DEBUG(dbgs() << "to block "; + WriteAsOperand(dbgs(), SuccToSinkTo, false)); + + // If the block has multiple predecessors, this would introduce computation on + // a path that it doesn't already exist. We could split the critical edge, + // but for now we just punt. + // FIXME: Split critical edges if not backedges. + if (SuccToSinkTo->getUniquePredecessor() != ParentBlock) { + // We cannot sink a load across a critical edge - there may be stores in + // other code paths. + if (!Inst->isSafeToSpeculativelyExecute()) { + DEBUG(dbgs() << " *** PUNTING: Wont sink load along critical edge.\n"); + return false; + } + + // We don't want to sink across a critical edge if we don't dominate the + // successor. We could be introducing calculations to new code paths. + if (!DT->dominates(ParentBlock, SuccToSinkTo)) { + DEBUG(dbgs() << " *** PUNTING: Critical edge found\n"); + return false; + } + + // Don't sink instructions into a loop. + if (LI->isLoopHeader(SuccToSinkTo)) { + DEBUG(dbgs() << " *** PUNTING: Loop header found\n"); + return false; + } + + // Otherwise we are OK with sinking along a critical edge. + DEBUG(dbgs() << "Sinking along critical edge.\n"); + } + + // Determine where to insert into. Skip phi nodes. + BasicBlock::iterator InsertPos = SuccToSinkTo->begin(); + while (InsertPos != SuccToSinkTo->end() && isa(InsertPos)) + ++InsertPos; + + // Move the instruction. + Inst->moveBefore(InsertPos); + return true; +} Propchange: llvm/trunk/test/Transforms/Sink/ ------------------------------------------------------------------------------ --- svn:ignore (added) +++ svn:ignore Fri May 7 10:40:13 2010 @@ -0,0 +1 @@ +Output Added: llvm/trunk/test/Transforms/Sink/basic.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/Transforms/Sink/basic.ll?rev=103257&view=auto ============================================================================== --- llvm/trunk/test/Transforms/Sink/basic.ll (added) +++ llvm/trunk/test/Transforms/Sink/basic.ll Fri May 7 10:40:13 2010 @@ -0,0 +1,22 @@ +; RUN: opt < %s -sink -S | FileCheck %s + + at A = external global i32 + at B = external global i32 + +; Sink should sink the load past the store (which doesn't overlap) into +; the block that uses it. + +; CHECK: @foo +; CHECK: true: +; CHECK-NEXT: %l = load i32* @A +; CHECK-NEXT: ret i32 %l + +define i32 @foo(i1 %z) { + %l = load i32* @A + store i32 0, i32* @B + br i1 %z, label %true, label %false +true: + ret i32 %l +false: + ret i32 0 +} Added: llvm/trunk/test/Transforms/Sink/dg.exp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/Transforms/Sink/dg.exp?rev=103257&view=auto ============================================================================== --- llvm/trunk/test/Transforms/Sink/dg.exp (added) +++ llvm/trunk/test/Transforms/Sink/dg.exp Fri May 7 10:40:13 2010 @@ -0,0 +1,3 @@ +load_lib llvm.exp + +RunLLVMTests [lsort [glob -nocomplain $srcdir/$subdir/*.{ll,c,cpp}]] From gohman at apple.com Fri May 7 11:17:22 2010 From: gohman at apple.com (Dan Gohman) Date: Fri, 07 May 2010 16:17:22 -0000 Subject: [llvm-commits] [llvm] r103261 - /llvm/trunk/lib/Analysis/DebugInfo.cpp Message-ID: <20100507161723.044F7312800A@llvm.org> Author: djg Date: Fri May 7 11:17:22 2010 New Revision: 103261 URL: http://llvm.org/viewvc/llvm-project?rev=103261&view=rev Log: Fix the new print functions to call print instead of dump. Modified: llvm/trunk/lib/Analysis/DebugInfo.cpp Modified: llvm/trunk/lib/Analysis/DebugInfo.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Analysis/DebugInfo.cpp?rev=103261&r1=103260&r2=103261&view=diff ============================================================================== --- llvm/trunk/lib/Analysis/DebugInfo.cpp (original) +++ llvm/trunk/lib/Analysis/DebugInfo.cpp Fri May 7 11:17:22 2010 @@ -501,7 +501,7 @@ OS << " [" << dwarf::TagString(Tag) << "] "; // TODO : Print context - getCompileUnit().dump(); + getCompileUnit().print(OS); OS << " [" << getLineNumber() << ", " << getSizeInBits() << ", " @@ -518,11 +518,11 @@ OS << " [fwd] "; if (isBasicType()) - DIBasicType(DbgNode).dump(); + DIBasicType(DbgNode).print(OS); else if (isDerivedType()) - DIDerivedType(DbgNode).dump(); + DIDerivedType(DbgNode).print(OS); else if (isCompositeType()) - DICompositeType(DbgNode).dump(); + DICompositeType(DbgNode).print(OS); else { OS << "Invalid DIType\n"; return; @@ -538,7 +538,7 @@ /// print - Print derived type. void DIDerivedType::print(raw_ostream &OS) const { - OS << "\n\t Derived From: "; getTypeDerivedFrom().dump(); + OS << "\n\t Derived From: "; getTypeDerivedFrom().print(OS); } /// print - Print composite type. @@ -557,7 +557,7 @@ OS << " [" << dwarf::TagString(Tag) << "] "; // TODO : Print context - getCompileUnit().dump(); + getCompileUnit().print(OS); OS << " [" << getLineNumber() << "] "; if (isLocalToUnit()) @@ -567,7 +567,7 @@ OS << " [def] "; if (isGlobalVariable()) - DIGlobalVariable(DbgNode).dump(); + DIGlobalVariable(DbgNode).print(OS); OS << "\n"; } @@ -582,7 +582,7 @@ OS << " [" << dwarf::TagString(Tag) << "] "; // TODO : Print context - getCompileUnit().dump(); + getCompileUnit().print(OS); OS << " [" << getLineNumber() << "] "; if (isLocalToUnit()) @@ -597,7 +597,7 @@ /// print - Print global variable. void DIGlobalVariable::print(raw_ostream &OS) const { OS << " ["; - getGlobal()->dump(); + getGlobal()->print(OS); OS << "] "; } @@ -607,9 +607,9 @@ if (!Res.empty()) OS << " [" << Res << "] "; - getCompileUnit().dump(); + getCompileUnit().print(OS); OS << " [" << getLineNumber() << "] "; - getType().dump(); + getType().print(OS); OS << "\n"; // FIXME: Dump complex addresses From gohman at apple.com Fri May 7 11:22:32 2010 From: gohman at apple.com (Dan Gohman) Date: Fri, 07 May 2010 16:22:32 -0000 Subject: [llvm-commits] [llvm] r103262 - in /llvm/trunk: include/llvm/Analysis/Passes.h include/llvm/LinkAllPasses.h lib/Analysis/CMakeLists.txt lib/Analysis/ModuleDebugInfoPrinter.cpp Message-ID: <20100507162232.7D9D9312800A@llvm.org> Author: djg Date: Fri May 7 11:22:32 2010 New Revision: 103262 URL: http://llvm.org/viewvc/llvm-project?rev=103262&view=rev Log: Add a simple module-level debug info printer. It just sets up a DebugInfoFinder and iterates over all the contents calling print. Added: llvm/trunk/lib/Analysis/ModuleDebugInfoPrinter.cpp Modified: llvm/trunk/include/llvm/Analysis/Passes.h llvm/trunk/include/llvm/LinkAllPasses.h llvm/trunk/lib/Analysis/CMakeLists.txt Modified: llvm/trunk/include/llvm/Analysis/Passes.h URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/include/llvm/Analysis/Passes.h?rev=103262&r1=103261&r2=103262&view=diff ============================================================================== --- llvm/trunk/include/llvm/Analysis/Passes.h (original) +++ llvm/trunk/include/llvm/Analysis/Passes.h Fri May 7 11:22:32 2010 @@ -153,6 +153,9 @@ // print debug info intrinsics in human readable form FunctionPass *createDbgInfoPrinterPass(); + + // Print module-level debug info metadata in human-readable form. + ModulePass *createModuleDebugInfoPrinterPass(); } #endif Modified: llvm/trunk/include/llvm/LinkAllPasses.h URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/include/llvm/LinkAllPasses.h?rev=103262&r1=103261&r2=103262&view=diff ============================================================================== --- llvm/trunk/include/llvm/LinkAllPasses.h (original) +++ llvm/trunk/include/llvm/LinkAllPasses.h Fri May 7 11:22:32 2010 @@ -132,6 +132,7 @@ (void) llvm::createPrintModulePass(0); (void) llvm::createPrintFunctionPass("", 0); (void) llvm::createDbgInfoPrinterPass(); + (void) llvm::createModuleDebugInfoPrinterPass(); (void) llvm::createPartialInliningPass(); (void) llvm::createSSIPass(); (void) llvm::createSSIEverythingPass(); Modified: llvm/trunk/lib/Analysis/CMakeLists.txt URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Analysis/CMakeLists.txt?rev=103262&r1=103261&r2=103262&view=diff ============================================================================== --- llvm/trunk/lib/Analysis/CMakeLists.txt (original) +++ llvm/trunk/lib/Analysis/CMakeLists.txt Fri May 7 11:22:32 2010 @@ -28,6 +28,7 @@ LoopPass.cpp MemoryBuiltins.cpp MemoryDependenceAnalysis.cpp + ModuleDebugInfoPrinter.cpp PHITransAddr.cpp PointerTracking.cpp PostDominators.cpp Added: llvm/trunk/lib/Analysis/ModuleDebugInfoPrinter.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Analysis/ModuleDebugInfoPrinter.cpp?rev=103262&view=auto ============================================================================== --- llvm/trunk/lib/Analysis/ModuleDebugInfoPrinter.cpp (added) +++ llvm/trunk/lib/Analysis/ModuleDebugInfoPrinter.cpp Fri May 7 11:22:32 2010 @@ -0,0 +1,86 @@ +//===-- ModuleDebugInfoPrinter.cpp - Prints module debug info metadata ----===// +// +// The LLVM Compiler Infrastructure +// +// This file is distributed under the University of Illinois Open Source +// License. See LICENSE.TXT for details. +// +//===----------------------------------------------------------------------===// +// +// This pass decodes the debug info metadata in a module and prints in a +// (sufficiently-prepared-) human-readable form. +// +// For example, run this pass from opt along with the -analyze option, and +// it'll print to standard output. +// +//===----------------------------------------------------------------------===// + +#include "llvm/Analysis/Passes.h" +#include "llvm/Analysis/DebugInfo.h" +#include "llvm/Assembly/Writer.h" +#include "llvm/Pass.h" +#include "llvm/Function.h" +#include "llvm/Support/ErrorHandling.h" +#include "llvm/Support/raw_ostream.h" +#include "llvm/ADT/Statistic.h" +using namespace llvm; + +namespace { + class ModuleDebugInfoPrinter : public ModulePass { + DebugInfoFinder Finder; + public: + static char ID; // Pass identification, replacement for typeid + ModuleDebugInfoPrinter() : ModulePass(&ID) {} + + virtual bool runOnModule(Module &M); + + virtual void getAnalysisUsage(AnalysisUsage &AU) const { + AU.setPreservesAll(); + } + virtual void print(raw_ostream &O, const Module *M) const; + }; +} + +char ModuleDebugInfoPrinter::ID = 0; +static RegisterPass +X("module-debuginfo", + "Decodes module-level debug info", false, true); + +ModulePass *llvm::createModuleDebugInfoPrinterPass() { + return new ModuleDebugInfoPrinter(); +} + +bool ModuleDebugInfoPrinter::runOnModule(Module &M) { + Finder.processModule(M); + return false; +} + +void ModuleDebugInfoPrinter::print(raw_ostream &O, const Module *M) const { + for (DebugInfoFinder::iterator I = Finder.compile_unit_begin(), + E = Finder.compile_unit_end(); I != E; ++I) { + O << "Compile Unit: "; + DICompileUnit(*I).print(O); + O << '\n'; + } + + for (DebugInfoFinder::iterator I = Finder.subprogram_begin(), + E = Finder.subprogram_end(); I != E; ++I) { + O << "Subprogram: "; + DISubprogram(*I).print(O); + O << '\n'; + } + + for (DebugInfoFinder::iterator I = Finder.global_variable_begin(), + E = Finder.global_variable_end(); I != E; ++I) { + O << "GlobalVariable: "; + DIGlobalVariable(*I).print(O); + O << '\n'; + } + + for (DebugInfoFinder::iterator I = Finder.type_begin(), + E = Finder.type_end(); I != E; ++I) { + O << "Type: "; + DIType(*I).print(O); + O << '\n'; + } +} From sabre at nondot.org Fri May 7 11:27:04 2010 From: sabre at nondot.org (Chris Lattner) Date: Fri, 07 May 2010 16:27:04 -0000 Subject: [llvm-commits] [llvm] r103263 - /llvm/trunk/tools/llvm-ld/llvm-ld.cpp Message-ID: <20100507162704.BE8F5312800A@llvm.org> Author: lattner Date: Fri May 7 11:27:04 2010 New Revision: 103263 URL: http://llvm.org/viewvc/llvm-project?rev=103263&view=rev Log: don't pass -f to llc, it doesn't have it anymore. Patch by Kevin Fan (PR7090) Modified: llvm/trunk/tools/llvm-ld/llvm-ld.cpp Modified: llvm/trunk/tools/llvm-ld/llvm-ld.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/tools/llvm-ld/llvm-ld.cpp?rev=103263&r1=103262&r2=103263&view=diff ============================================================================== --- llvm/trunk/tools/llvm-ld/llvm-ld.cpp (original) +++ llvm/trunk/tools/llvm-ld/llvm-ld.cpp Fri May 7 11:27:04 2010 @@ -266,7 +266,6 @@ // We will use GCC to assemble the program so set the assembly syntax to AT&T, // regardless of what the target in the bitcode file is. args.push_back("-x86-asm-syntax=att"); - args.push_back("-f"); args.push_back("-o"); args.push_back(OutputFilename.c_str()); args.push_back(InputFilename.c_str()); @@ -289,7 +288,6 @@ std::vector args; args.push_back(llc.c_str()); args.push_back("-march=c"); - args.push_back("-f"); args.push_back("-o"); args.push_back(OutputFile.c_str()); args.push_back(InputFile.c_str()); From gohman at apple.com Fri May 7 11:39:27 2010 From: gohman at apple.com (Dan Gohman) Date: Fri, 07 May 2010 16:39:27 -0000 Subject: [llvm-commits] [llvm] r103264 - /llvm/trunk/lib/Analysis/DebugInfo.cpp Message-ID: <20100507163927.2DE2F312800A@llvm.org> Author: djg Date: Fri May 7 11:39:27 2010 New Revision: 103264 URL: http://llvm.org/viewvc/llvm-project?rev=103264&view=rev Log: Add some words to this output to indicate what the numbers mean. Modified: llvm/trunk/lib/Analysis/DebugInfo.cpp Modified: llvm/trunk/lib/Analysis/DebugInfo.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Analysis/DebugInfo.cpp?rev=103264&r1=103263&r2=103264&view=diff ============================================================================== --- llvm/trunk/lib/Analysis/DebugInfo.cpp (original) +++ llvm/trunk/lib/Analysis/DebugInfo.cpp Fri May 7 11:39:27 2010 @@ -503,10 +503,10 @@ // TODO : Print context getCompileUnit().print(OS); OS << " [" - << getLineNumber() << ", " - << getSizeInBits() << ", " - << getAlignInBits() << ", " - << getOffsetInBits() + << "line " << getLineNumber() << ", " + << getSizeInBits() << " bits, " + << getAlignInBits() << " bit alignment, " + << getOffsetInBits() << " bit offset" << "] "; if (isPrivate()) From baldrick at free.fr Fri May 7 12:03:48 2010 From: baldrick at free.fr (Duncan Sands) Date: Fri, 07 May 2010 17:03:48 -0000 Subject: [llvm-commits] [llvm] r103265 - in /llvm/trunk/test/CodeGen: ARM/2009-05-05-DAGCombineBug.ll X86/2009-06-03-Win64DisableRedZone.ll X86/2009-06-03-Win64SpillXMM.ll X86/2009-08-08-CastError.ll X86/call-imm.ll X86/sse-align-11.ll Message-ID: <20100507170348.8BA9C312800A@llvm.org> Author: baldrick Date: Fri May 7 12:03:48 2010 New Revision: 103265 URL: http://llvm.org/viewvc/llvm-project?rev=103265&view=rev Log: Correct some bogus target triples. Modified: llvm/trunk/test/CodeGen/ARM/2009-05-05-DAGCombineBug.ll llvm/trunk/test/CodeGen/X86/2009-06-03-Win64DisableRedZone.ll llvm/trunk/test/CodeGen/X86/2009-06-03-Win64SpillXMM.ll llvm/trunk/test/CodeGen/X86/2009-08-08-CastError.ll llvm/trunk/test/CodeGen/X86/call-imm.ll llvm/trunk/test/CodeGen/X86/sse-align-11.ll Modified: llvm/trunk/test/CodeGen/ARM/2009-05-05-DAGCombineBug.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/ARM/2009-05-05-DAGCombineBug.ll?rev=103265&r1=103264&r2=103265&view=diff ============================================================================== --- llvm/trunk/test/CodeGen/ARM/2009-05-05-DAGCombineBug.ll (original) +++ llvm/trunk/test/CodeGen/ARM/2009-05-05-DAGCombineBug.ll Fri May 7 12:03:48 2010 @@ -1,4 +1,4 @@ -; RUN: llc < %s -mtriple=arm-linuxeabi-unknown-gnu -mattr=+v6 +; RUN: llc < %s -mtriple=arm-unknown-linux-gnueabi -mattr=+v6 ; PR4166 %"byte[]" = type { i32, i8* } Modified: llvm/trunk/test/CodeGen/X86/2009-06-03-Win64DisableRedZone.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/X86/2009-06-03-Win64DisableRedZone.ll?rev=103265&r1=103264&r2=103265&view=diff ============================================================================== --- llvm/trunk/test/CodeGen/X86/2009-06-03-Win64DisableRedZone.ll (original) +++ llvm/trunk/test/CodeGen/X86/2009-06-03-Win64DisableRedZone.ll Fri May 7 12:03:48 2010 @@ -1,5 +1,5 @@ ; RUN: llc < %s | grep "subq.*\\\$40, \\\%rsp" -target triple = "x86_64-mingw64" +target triple = "x86_64-pc-mingw64" define x86_fp80 @a(i64 %x) nounwind readnone { entry: Modified: llvm/trunk/test/CodeGen/X86/2009-06-03-Win64SpillXMM.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/X86/2009-06-03-Win64SpillXMM.ll?rev=103265&r1=103264&r2=103265&view=diff ============================================================================== --- llvm/trunk/test/CodeGen/X86/2009-06-03-Win64SpillXMM.ll (original) +++ llvm/trunk/test/CodeGen/X86/2009-06-03-Win64SpillXMM.ll Fri May 7 12:03:48 2010 @@ -2,7 +2,7 @@ ; RUN: grep "subq.*\\\$72, \\\%rsp" %t1 ; RUN: grep "movaps \\\%xmm8, 32\\\(\\\%rsp\\\)" %t1 ; RUN: grep "movaps \\\%xmm7, 48\\\(\\\%rsp\\\)" %t1 -target triple = "x86_64-mingw64" +target triple = "x86_64-pc-mingw64" define i32 @a() nounwind { entry: Modified: llvm/trunk/test/CodeGen/X86/2009-08-08-CastError.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/X86/2009-08-08-CastError.ll?rev=103265&r1=103264&r2=103265&view=diff ============================================================================== --- llvm/trunk/test/CodeGen/X86/2009-08-08-CastError.ll (original) +++ llvm/trunk/test/CodeGen/X86/2009-08-08-CastError.ll Fri May 7 12:03:48 2010 @@ -1,4 +1,4 @@ -; RUN: llc < %s -mtriple=x86_64-mingw64 | grep movabsq +; RUN: llc < %s -mtriple=x86_64-pc-mingw64 | grep movabsq target datalayout = "e-p:64:64:64-i1:8:8-i8:8:8-i16:16:16-i32:32:32-i64:64:64-f32:32:32-f64:64:64-v64:64:64-v128:128:128-a0:0:64-s0:64:64-f80:128:128" Modified: llvm/trunk/test/CodeGen/X86/call-imm.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/X86/call-imm.ll?rev=103265&r1=103264&r2=103265&view=diff ============================================================================== --- llvm/trunk/test/CodeGen/X86/call-imm.ll (original) +++ llvm/trunk/test/CodeGen/X86/call-imm.ll Fri May 7 12:03:48 2010 @@ -1,5 +1,5 @@ -; RUN: llc < %s -mtriple=i386-darwin-apple -relocation-model=static | grep {call.*12345678} -; RUN: llc < %s -mtriple=i386-darwin-apple -relocation-model=pic | not grep {call.*12345678} +; RUN: llc < %s -mtriple=i386-apple-darwin -relocation-model=static | grep {call.*12345678} +; RUN: llc < %s -mtriple=i386-apple-darwin -relocation-model=pic | not grep {call.*12345678} ; RUN: llc < %s -mtriple=i386-pc-linux -relocation-model=dynamic-no-pic | grep {call.*12345678} ; Call to immediate is not safe on x86-64 unless we *know* that the Modified: llvm/trunk/test/CodeGen/X86/sse-align-11.ll URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/test/CodeGen/X86/sse-align-11.ll?rev=103265&r1=103264&r2=103265&view=diff ============================================================================== --- llvm/trunk/test/CodeGen/X86/sse-align-11.ll (original) +++ llvm/trunk/test/CodeGen/X86/sse-align-11.ll Fri May 7 12:03:48 2010 @@ -1,5 +1,5 @@ ; RUN: llc < %s -march=x86 -mcpu=yonah -mtriple=i686-apple-darwin8 | grep movaps -; RUN: llc < %s -march=x86 -mcpu=yonah -mtriple=linux | grep movups +; RUN: llc < %s -march=x86 -mcpu=yonah -mtriple=i686-linux-gnu | grep movups define <4 x float> @foo(float %a, float %b, float %c, float %d) nounwind { entry: From kremenek at apple.com Fri May 7 12:13:21 2010 From: kremenek at apple.com (Ted Kremenek) Date: Fri, 07 May 2010 17:13:21 -0000 Subject: [llvm-commits] [llvm] r103266 - /llvm/trunk/lib/Transforms/Scalar/CMakeLists.txt Message-ID: <20100507171321.20492312800A@llvm.org> Author: kremenek Date: Fri May 7 12:13:20 2010 New Revision: 103266 URL: http://llvm.org/viewvc/llvm-project?rev=103266&view=rev Log: Update CMake build. Modified: llvm/trunk/lib/Transforms/Scalar/CMakeLists.txt Modified: llvm/trunk/lib/Transforms/Scalar/CMakeLists.txt URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Transforms/Scalar/CMakeLists.txt?rev=103266&r1=103265&r2=103266&view=diff ============================================================================== --- llvm/trunk/lib/Transforms/Scalar/CMakeLists.txt (original) +++ llvm/trunk/lib/Transforms/Scalar/CMakeLists.txt Fri May 7 12:13:20 2010 @@ -26,6 +26,7 @@ SimplifyCFGPass.cpp SimplifyHalfPowrLibCalls.cpp SimplifyLibCalls.cpp + Sink.cpp TailDuplication.cpp TailRecursionElimination.cpp ) From sabre at nondot.org Fri May 7 12:17:42 2010 From: sabre at nondot.org (Chris Lattner) Date: Fri, 07 May 2010 17:17:42 -0000 Subject: [llvm-commits] [llvm] r103267 - in /llvm/trunk: include/llvm/CodeGen/TargetLoweringObjectFileImpl.h include/llvm/MC/MCContext.h include/llvm/MC/MCSection.h include/llvm/MC/MCSectionCOFF.h lib/CodeGen/TargetLoweringObjectFileImpl.cpp lib/MC/MCContext.cpp lib/MC/MCSection.cpp lib/MC/MCSectionCOFF.cpp lib/Target/X86/AsmPrinter/X86AsmPrinter.cpp Message-ID: <20100507171742.27745312800A@llvm.org> Author: lattner Date: Fri May 7 12:17:41 2010 New Revision: 103267 URL: http://llvm.org/viewvc/llvm-project?rev=103267&view=rev Log: switch MCSectionCOFF from a syntactic to semantic representation, patch by Peter Housel! Added: llvm/trunk/include/llvm/MC/MCSectionCOFF.h llvm/trunk/lib/MC/MCSectionCOFF.cpp Modified: llvm/trunk/include/llvm/CodeGen/TargetLoweringObjectFileImpl.h llvm/trunk/include/llvm/MC/MCContext.h llvm/trunk/include/llvm/MC/MCSection.h llvm/trunk/lib/CodeGen/TargetLoweringObjectFileImpl.cpp llvm/trunk/lib/MC/MCContext.cpp llvm/trunk/lib/MC/MCSection.cpp llvm/trunk/lib/Target/X86/AsmPrinter/X86AsmPrinter.cpp Modified: llvm/trunk/include/llvm/CodeGen/TargetLoweringObjectFileImpl.h URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/include/llvm/CodeGen/TargetLoweringObjectFileImpl.h?rev=103267&r1=103266&r2=103267&view=diff ============================================================================== --- llvm/trunk/include/llvm/CodeGen/TargetLoweringObjectFileImpl.h (original) +++ llvm/trunk/include/llvm/CodeGen/TargetLoweringObjectFileImpl.h Fri May 7 12:17:41 2010 @@ -161,13 +161,15 @@ class TargetLoweringObjectFileCOFF : public TargetLoweringObjectFile { - mutable void *UniquingMap; + const MCSection *DrectveSection; public: - TargetLoweringObjectFileCOFF() : UniquingMap(0) {} - ~TargetLoweringObjectFileCOFF(); + TargetLoweringObjectFileCOFF() {} + ~TargetLoweringObjectFileCOFF() {} virtual void Initialize(MCContext &Ctx, const TargetMachine &TM); + virtual const MCSection *getDrectveSection() const { return DrectveSection; } + virtual const MCSection * getExplicitSectionGlobal(const GlobalValue *GV, SectionKind Kind, Mangler *Mang, const TargetMachine &TM) const; @@ -175,11 +177,6 @@ virtual const MCSection * SelectSectionForGlobal(const GlobalValue *GV, SectionKind Kind, Mangler *Mang, const TargetMachine &TM) const; - - /// getCOFFSection - Return the MCSection for the specified COFF section. - /// FIXME: Switch this to a semantic view eventually. - const MCSection *getCOFFSection(StringRef Name, bool isDirective, - SectionKind K) const; }; } // end namespace llvm Modified: llvm/trunk/include/llvm/MC/MCContext.h URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/include/llvm/MC/MCContext.h?rev=103267&r1=103266&r2=103267&view=diff ============================================================================== --- llvm/trunk/include/llvm/MC/MCContext.h (original) +++ llvm/trunk/include/llvm/MC/MCContext.h Fri May 7 12:17:41 2010 @@ -50,7 +50,7 @@ /// objects. BumpPtrAllocator Allocator; - void *MachOUniquingMap, *ELFUniquingMap; + void *MachOUniquingMap, *ELFUniquingMap, *COFFUniquingMap; public: explicit MCContext(const MCAsmInfo &MAI); ~MCContext(); @@ -97,6 +97,9 @@ const MCSection *getELFSection(StringRef Section, unsigned Type, unsigned Flags, SectionKind Kind, bool IsExplicit = false); + + const MCSection *getCOFFSection(StringRef Section, unsigned Flags, + SectionKind Kind); /// @} Modified: llvm/trunk/include/llvm/MC/MCSection.h URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/include/llvm/MC/MCSection.h?rev=103267&r1=103266&r2=103267&view=diff ============================================================================== --- llvm/trunk/include/llvm/MC/MCSection.h (original) +++ llvm/trunk/include/llvm/MC/MCSection.h Fri May 7 12:17:41 2010 @@ -48,32 +48,6 @@ return false; } }; - - class MCSectionCOFF : public MCSection { - // The memory for this string is stored in the same MCContext as *this. - StringRef Name; - - /// IsDirective - This is true if the section name is a directive, not - /// something that should be printed with ".section". - /// - /// FIXME: This is a hack. Switch to a semantic view of the section instead - /// of a syntactic one. - bool IsDirective; - - MCSectionCOFF(StringRef name, bool isDirective, SectionKind K) - : MCSection(K), Name(name), IsDirective(isDirective) { - } - public: - - static MCSectionCOFF *Create(StringRef Name, bool IsDirective, - SectionKind K, MCContext &Ctx); - - StringRef getName() const { return Name; } - bool isDirective() const { return IsDirective; } - - virtual void PrintSwitchToSection(const MCAsmInfo &MAI, - raw_ostream &OS) const; - }; } // end namespace llvm Added: llvm/trunk/include/llvm/MC/MCSectionCOFF.h URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/include/llvm/MC/MCSectionCOFF.h?rev=103267&view=auto ============================================================================== --- llvm/trunk/include/llvm/MC/MCSectionCOFF.h (added) +++ llvm/trunk/include/llvm/MC/MCSectionCOFF.h Fri May 7 12:17:41 2010 @@ -0,0 +1,83 @@ +//===- MCSectionCOFF.h - COFF Machine Code Sections -------------*- C++ -*-===// +// +// The LLVM Compiler Infrastructure +// +// This file is distributed under the University of Illinois Open Source +// License. See LICENSE.TXT for details. +// +//===----------------------------------------------------------------------===// +// +// This file declares the MCSectionCOFF class. +// +//===----------------------------------------------------------------------===// + +#ifndef LLVM_MC_MCSECTIONCOFF_H +#define LLVM_MC_MCSECTIONCOFF_H + +#include "llvm/MC/MCSection.h" + +namespace llvm { + +/// MCSectionCOFF - This represents a section on Windows + class MCSectionCOFF : public MCSection { + // The memory for this string is stored in the same MCContext as *this. + StringRef SectionName; + + /// Flags - This is the Characteristics field of a section, drawn + /// from the enums below. + unsigned Flags; + + private: + friend class MCContext; + MCSectionCOFF(StringRef Section, unsigned flags, SectionKind K) + : MCSection(K), SectionName(Section), Flags(flags) { + } + ~MCSectionCOFF(); + + public: + /// ShouldOmitSectionDirective - Decides whether a '.section' directive + /// should be printed before the section name + bool ShouldOmitSectionDirective(StringRef Name, const MCAsmInfo &MAI) const; + + /// Valid section flags. + enum { + IMAGE_SCN_TYPE_NO_PAD = 0x00000008, + IMAGE_SCN_CNT_CODE = 0x00000020, + IMAGE_SCN_CNT_INITIALIZED_DATA = 0x00000040, + IMAGE_SCN_CNT_UNINITIALIZED_DATA = 0x00000080, + IMAGE_SCN_LNK_OTHER = 0x00000100, + IMAGE_SCN_LNK_INFO = 0x00000200, + IMAGE_SCN_LNK_REMOVE = 0x00000800, + IMAGE_SCN_LNK_COMDAT = 0x00001000, + IMAGE_SCN_MEM_FARDATA = 0x00008000, + IMAGE_SCN_MEM_PURGEABLE = 0x00020000, + IMAGE_SCN_MEM_16BIT = 0x00020000, + IMAGE_SCN_MEM_LOCKED = 0x00040000, + IMAGE_SCN_MEM_PRELOAD = 0x00080000, + IMAGE_SCN_ALIGN_1BYTES = 0x00100000, + IMAGE_SCN_ALIGN_2BYTES = 0x00200000, + IMAGE_SCN_ALIGN_4BYTES = 0x00300000, + IMAGE_SCN_ALIGN_8BYTES = 0x00400000, + IMAGE_SCN_ALIGN_16BYTES = 0x00500000, + IMAGE_SCN_ALIGN_32BYTES = 0x00600000, + IMAGE_SCN_ALIGN_64BYTES = 0x00700000, + IMAGE_SCN_LNK_NRELOC_OVFL = 0x01000000, + IMAGE_SCN_MEM_DISCARDABLE = 0x02000000, + IMAGE_SCN_MEM_NOT_CACHED = 0x04000000, + IMAGE_SCN_MEM_NOT_PAGED = 0x08000000, + IMAGE_SCN_MEM_SHARED = 0x10000000, + IMAGE_SCN_MEM_EXECUTE = 0x20000000, + IMAGE_SCN_MEM_READ = 0x40000000, + IMAGE_SCN_MEM_WRITE = 0x80000000 + }; + + StringRef getSectionName() const { return SectionName; } + unsigned getFlags() const { return Flags; } + + virtual void PrintSwitchToSection(const MCAsmInfo &MAI, + raw_ostream &OS) const; + }; + +} // end namespace llvm + +#endif Modified: llvm/trunk/lib/CodeGen/TargetLoweringObjectFileImpl.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/CodeGen/TargetLoweringObjectFileImpl.cpp?rev=103267&r1=103266&r2=103267&view=diff ============================================================================== --- llvm/trunk/lib/CodeGen/TargetLoweringObjectFileImpl.cpp (original) +++ llvm/trunk/lib/CodeGen/TargetLoweringObjectFileImpl.cpp Fri May 7 12:17:41 2010 @@ -22,6 +22,7 @@ #include "llvm/MC/MCExpr.h" #include "llvm/MC/MCSectionMachO.h" #include "llvm/MC/MCSectionELF.h" +#include "llvm/MC/MCSectionCOFF.h" #include "llvm/MC/MCSymbol.h" #include "llvm/Target/Mangler.h" #include "llvm/Target/TargetData.h" @@ -794,89 +795,147 @@ // COFF //===----------------------------------------------------------------------===// -typedef StringMap COFFUniqueMapTy; - -TargetLoweringObjectFileCOFF::~TargetLoweringObjectFileCOFF() { - delete (COFFUniqueMapTy*)UniquingMap; -} - - -const MCSection *TargetLoweringObjectFileCOFF:: -getCOFFSection(StringRef Name, bool isDirective, SectionKind Kind) const { - // Create the map if it doesn't already exist. - if (UniquingMap == 0) - UniquingMap = new COFFUniqueMapTy(); - COFFUniqueMapTy &Map = *(COFFUniqueMapTy*)UniquingMap; - - // Do the lookup, if we have a hit, return it. - const MCSectionCOFF *&Entry = Map[Name]; - if (Entry) return Entry; - - return Entry = MCSectionCOFF::Create(Name, isDirective, Kind, getContext()); -} - void TargetLoweringObjectFileCOFF::Initialize(MCContext &Ctx, const TargetMachine &TM) { - if (UniquingMap != 0) - ((COFFUniqueMapTy*)UniquingMap)->clear(); TargetLoweringObjectFile::Initialize(Ctx, TM); - TextSection = getCOFFSection("\t.text", true, SectionKind::getText()); - DataSection = getCOFFSection("\t.data", true, SectionKind::getDataRel()); + TextSection = + getContext().getCOFFSection(".text", + MCSectionCOFF::IMAGE_SCN_CNT_CODE | + MCSectionCOFF::IMAGE_SCN_MEM_EXECUTE | + MCSectionCOFF::IMAGE_SCN_MEM_READ, + SectionKind::getText()); + DataSection = + getContext().getCOFFSection(".data", + MCSectionCOFF::IMAGE_SCN_CNT_INITIALIZED_DATA | + MCSectionCOFF::IMAGE_SCN_MEM_READ | + MCSectionCOFF::IMAGE_SCN_MEM_WRITE, + SectionKind::getDataRel()); + ReadOnlySection = + getContext().getCOFFSection(".rdata", + MCSectionCOFF::IMAGE_SCN_CNT_INITIALIZED_DATA | + MCSectionCOFF::IMAGE_SCN_MEM_READ, + SectionKind::getReadOnly()); StaticCtorSection = - getCOFFSection(".ctors", false, SectionKind::getDataRel()); + getContext().getCOFFSection(".ctors", + MCSectionCOFF::IMAGE_SCN_CNT_INITIALIZED_DATA | + MCSectionCOFF::IMAGE_SCN_MEM_READ | + MCSectionCOFF::IMAGE_SCN_MEM_WRITE, + SectionKind::getDataRel()); StaticDtorSection = - getCOFFSection(".dtors", false, SectionKind::getDataRel()); + getContext().getCOFFSection(".dtors", + MCSectionCOFF::IMAGE_SCN_CNT_INITIALIZED_DATA | + MCSectionCOFF::IMAGE_SCN_MEM_READ | + MCSectionCOFF::IMAGE_SCN_MEM_WRITE, + SectionKind::getDataRel()); // FIXME: We're emitting LSDA info into a readonly section on COFF, even // though it contains relocatable pointers. In PIC mode, this is probably a // big runtime hit for C++ apps. Either the contents of the LSDA need to be // adjusted or this should be a data section. LSDASection = - getCOFFSection(".gcc_except_table", false, SectionKind::getReadOnly()); + getContext().getCOFFSection(".gcc_except_table", + MCSectionCOFF::IMAGE_SCN_CNT_INITIALIZED_DATA | + MCSectionCOFF::IMAGE_SCN_MEM_READ, + SectionKind::getReadOnly()); EHFrameSection = - getCOFFSection(".eh_frame", false, SectionKind::getDataRel()); + getContext().getCOFFSection(".eh_frame", + MCSectionCOFF::IMAGE_SCN_CNT_INITIALIZED_DATA | + MCSectionCOFF::IMAGE_SCN_MEM_READ | + MCSectionCOFF::IMAGE_SCN_MEM_WRITE, + SectionKind::getDataRel()); // Debug info. - // FIXME: Don't use 'directive' mode here. DwarfAbbrevSection = - getCOFFSection("\t.section\t.debug_abbrev,\"dr\"", - true, SectionKind::getMetadata()); + getContext().getCOFFSection(".debug_abbrev", + MCSectionCOFF::IMAGE_SCN_MEM_DISCARDABLE | + MCSectionCOFF::IMAGE_SCN_MEM_READ, + SectionKind::getMetadata()); DwarfInfoSection = - getCOFFSection("\t.section\t.debug_info,\"dr\"", - true, SectionKind::getMetadata()); + getContext().getCOFFSection(".debug_info", + MCSectionCOFF::IMAGE_SCN_MEM_DISCARDABLE | + MCSectionCOFF::IMAGE_SCN_MEM_READ, + SectionKind::getMetadata()); DwarfLineSection = - getCOFFSection("\t.section\t.debug_line,\"dr\"", - true, SectionKind::getMetadata()); + getContext().getCOFFSection(".debug_line", + MCSectionCOFF::IMAGE_SCN_MEM_DISCARDABLE | + MCSectionCOFF::IMAGE_SCN_MEM_READ, + SectionKind::getMetadata()); DwarfFrameSection = - getCOFFSection("\t.section\t.debug_frame,\"dr\"", - true, SectionKind::getMetadata()); + getContext().getCOFFSection(".debug_frame", + MCSectionCOFF::IMAGE_SCN_MEM_DISCARDABLE | + MCSectionCOFF::IMAGE_SCN_MEM_READ, + SectionKind::getMetadata()); DwarfPubNamesSection = - getCOFFSection("\t.section\t.debug_pubnames,\"dr\"", - true, SectionKind::getMetadata()); + getContext().getCOFFSection(".debug_pubnames", + MCSectionCOFF::IMAGE_SCN_MEM_DISCARDABLE | + MCSectionCOFF::IMAGE_SCN_MEM_READ, + SectionKind::getMetadata()); DwarfPubTypesSection = - getCOFFSection("\t.section\t.debug_pubtypes,\"dr\"", - true, SectionKind::getMetadata()); + getContext().getCOFFSection(".debug_pubtypes", + MCSectionCOFF::IMAGE_SCN_MEM_DISCARDABLE | + MCSectionCOFF::IMAGE_SCN_MEM_READ, + SectionKind::getMetadata()); DwarfStrSection = - getCOFFSection("\t.section\t.debug_str,\"dr\"", - true, SectionKind::getMetadata()); + getContext().getCOFFSection(".debug_str", + MCSectionCOFF::IMAGE_SCN_MEM_DISCARDABLE | + MCSectionCOFF::IMAGE_SCN_MEM_READ, + SectionKind::getMetadata()); DwarfLocSection = - getCOFFSection("\t.section\t.debug_loc,\"dr\"", - true, SectionKind::getMetadata()); + getContext().getCOFFSection(".debug_loc", + MCSectionCOFF::IMAGE_SCN_MEM_DISCARDABLE | + MCSectionCOFF::IMAGE_SCN_MEM_READ, + SectionKind::getMetadata()); DwarfARangesSection = - getCOFFSection("\t.section\t.debug_aranges,\"dr\"", - true, SectionKind::getMetadata()); + getContext().getCOFFSection(".debug_aranges", + MCSectionCOFF::IMAGE_SCN_MEM_DISCARDABLE | + MCSectionCOFF::IMAGE_SCN_MEM_READ, + SectionKind::getMetadata()); DwarfRangesSection = - getCOFFSection("\t.section\t.debug_ranges,\"dr\"", - true, SectionKind::getMetadata()); + getContext().getCOFFSection(".debug_ranges", + MCSectionCOFF::IMAGE_SCN_MEM_DISCARDABLE | + MCSectionCOFF::IMAGE_SCN_MEM_READ, + SectionKind::getMetadata()); DwarfMacroInfoSection = - getCOFFSection("\t.section\t.debug_macinfo,\"dr\"", - true, SectionKind::getMetadata()); + getContext().getCOFFSection(".debug_macinfo", + MCSectionCOFF::IMAGE_SCN_MEM_DISCARDABLE | + MCSectionCOFF::IMAGE_SCN_MEM_READ, + SectionKind::getMetadata()); + + DrectveSection = + getContext().getCOFFSection(".drectve", + MCSectionCOFF::IMAGE_SCN_LNK_INFO, + SectionKind::getMetadata()); +} + +static unsigned +getCOFFSectionFlags(SectionKind K) { + unsigned Flags = 0; + + if (!K.isMetadata()) + Flags |= MCSectionCOFF::IMAGE_SCN_MEM_DISCARDABLE; + else if (K.isText()) + Flags |= + MCSectionCOFF::IMAGE_SCN_MEM_EXECUTE | + MCSectionCOFF::IMAGE_SCN_CNT_CODE; + else if (K.isReadOnly()) + Flags |= + MCSectionCOFF::IMAGE_SCN_CNT_INITIALIZED_DATA | + MCSectionCOFF::IMAGE_SCN_MEM_READ; + else if (K.isWriteable()) + Flags |= + MCSectionCOFF::IMAGE_SCN_CNT_INITIALIZED_DATA | + MCSectionCOFF::IMAGE_SCN_MEM_READ | + MCSectionCOFF::IMAGE_SCN_MEM_WRITE; + + return Flags; } const MCSection *TargetLoweringObjectFileCOFF:: getExplicitSectionGlobal(const GlobalValue *GV, SectionKind Kind, Mangler *Mang, const TargetMachine &TM) const { - return getCOFFSection(GV->getSection(), false, Kind); + return getContext().getCOFFSection(GV->getSection(), + getCOFFSectionFlags(Kind), + Kind); } static const char *getCOFFSectionPrefixForUniqueGlobal(SectionKind Kind) { @@ -900,7 +959,9 @@ SmallString<128> Name(Prefix, Prefix+strlen(Prefix)); MCSymbol *Sym = Mang->getSymbol(GV); Name.append(Sym->getName().begin(), Sym->getName().end()); - return getCOFFSection(Name.str(), false, Kind); + return getContext().getCOFFSection(Name.str(), + getCOFFSectionFlags(Kind), + Kind); } if (Kind.isText()) Modified: llvm/trunk/lib/MC/MCContext.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/MC/MCContext.cpp?rev=103267&r1=103266&r2=103267&view=diff ============================================================================== --- llvm/trunk/lib/MC/MCContext.cpp (original) +++ llvm/trunk/lib/MC/MCContext.cpp Fri May 7 12:17:41 2010 @@ -11,6 +11,7 @@ #include "llvm/MC/MCAsmInfo.h" #include "llvm/MC/MCSectionMachO.h" #include "llvm/MC/MCSectionELF.h" +#include "llvm/MC/MCSectionCOFF.h" #include "llvm/MC/MCSymbol.h" #include "llvm/ADT/SmallString.h" #include "llvm/ADT/Twine.h" @@ -18,11 +19,13 @@ typedef StringMap MachOUniqueMapTy; typedef StringMap ELFUniqueMapTy; +typedef StringMap COFFUniqueMapTy; MCContext::MCContext(const MCAsmInfo &mai) : MAI(mai), NextUniqueID(0) { MachOUniquingMap = 0; ELFUniquingMap = 0; + COFFUniquingMap = 0; } MCContext::~MCContext() { @@ -32,6 +35,7 @@ // If we have the MachO uniquing map, free it. delete (MachOUniqueMapTy*)MachOUniquingMap; delete (ELFUniqueMapTy*)ELFUniquingMap; + delete (COFFUniqueMapTy*)COFFUniquingMap; } //===----------------------------------------------------------------------===// @@ -122,4 +126,19 @@ return Result; } - +const MCSection *MCContext:: +getCOFFSection(StringRef Section, unsigned Flags, SectionKind Kind) { + if (COFFUniquingMap == 0) + COFFUniquingMap = new COFFUniqueMapTy(); + COFFUniqueMapTy &Map = *(COFFUniqueMapTy*)COFFUniquingMap; + + // Do the lookup, if we have a hit, return it. + StringMapEntry &Entry = Map.GetOrCreateValue(Section); + if (Entry.getValue()) return Entry.getValue(); + + MCSectionCOFF *Result = new (*this) MCSectionCOFF(Entry.getKey(), Flags, + Kind); + + Entry.setValue(Result); + return Result; +} Modified: llvm/trunk/lib/MC/MCSection.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/MC/MCSection.cpp?rev=103267&r1=103266&r2=103267&view=diff ============================================================================== --- llvm/trunk/lib/MC/MCSection.cpp (original) +++ llvm/trunk/lib/MC/MCSection.cpp Fri May 7 12:17:41 2010 @@ -20,30 +20,3 @@ MCSection::~MCSection() { } -//===----------------------------------------------------------------------===// -// MCSectionCOFF -//===----------------------------------------------------------------------===// - -MCSectionCOFF *MCSectionCOFF:: -Create(StringRef Name, bool IsDirective, SectionKind K, MCContext &Ctx) { - char *NameCopy = static_cast( - Ctx.Allocate(Name.size(), /*Alignment=*/1)); - memcpy(NameCopy, Name.data(), Name.size()); - return new (Ctx) MCSectionCOFF(StringRef(NameCopy, Name.size()), - IsDirective, K); -} - -void MCSectionCOFF::PrintSwitchToSection(const MCAsmInfo &MAI, - raw_ostream &OS) const { - - if (isDirective()) { - OS << getName() << '\n'; - return; - } - OS << "\t.section\t" << getName() << ",\""; - if (getKind().isText()) - OS << 'x'; - if (getKind().isWriteable()) - OS << 'w'; - OS << "\"\n"; -} Added: llvm/trunk/lib/MC/MCSectionCOFF.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/MC/MCSectionCOFF.cpp?rev=103267&view=auto ============================================================================== --- llvm/trunk/lib/MC/MCSectionCOFF.cpp (added) +++ llvm/trunk/lib/MC/MCSectionCOFF.cpp Fri May 7 12:17:41 2010 @@ -0,0 +1,49 @@ +//===- lib/MC/MCSectionCOFF.cpp - COFF Code Section Representation --------===// +// +// The LLVM Compiler Infrastructure +// +// This file is distributed under the University of Illinois Open Source +// License. See LICENSE.TXT for details. +// +//===----------------------------------------------------------------------===// + +#include "llvm/MC/MCSectionCOFF.h" +#include "llvm/MC/MCAsmInfo.h" +#include "llvm/MC/MCContext.h" +#include "llvm/MC/MCSymbol.h" +#include "llvm/Support/raw_ostream.h" +using namespace llvm; + +MCSectionCOFF::~MCSectionCOFF() {} // anchor. + +// ShouldOmitSectionDirective - Decides whether a '.section' directive +// should be printed before the section name +bool MCSectionCOFF::ShouldOmitSectionDirective(StringRef Name, + const MCAsmInfo &MAI) const { + + // FIXME: Does .section .bss/.data/.text work everywhere?? + if (Name == ".text" || Name == ".data" || Name == ".bss") + return true; + + return false; +} + +void MCSectionCOFF::PrintSwitchToSection(const MCAsmInfo &MAI, + raw_ostream &OS) const { + + if (ShouldOmitSectionDirective(SectionName, MAI)) { + OS << '\t' << getSectionName() << '\n'; + return; + } + + OS << "\t.section\t" << getSectionName() << ",\""; + if (getKind().isText()) + OS << 'x'; + if (getKind().isWriteable()) + OS << 'w'; + else + OS << 'r'; + if (getFlags() & MCSectionCOFF::IMAGE_SCN_MEM_DISCARDABLE) + OS << 'n'; + OS << "\"\n"; +} Modified: llvm/trunk/lib/Target/X86/AsmPrinter/X86AsmPrinter.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Target/X86/AsmPrinter/X86AsmPrinter.cpp?rev=103267&r1=103266&r2=103267&view=diff ============================================================================== --- llvm/trunk/lib/Target/X86/AsmPrinter/X86AsmPrinter.cpp (original) +++ llvm/trunk/lib/Target/X86/AsmPrinter/X86AsmPrinter.cpp Fri May 7 12:17:41 2010 @@ -598,9 +598,7 @@ // Output linker support code for dllexported globals on windows. if (!DLLExportedGlobals.empty() || !DLLExportedFns.empty()) { - OutStreamer.SwitchSection(TLOFCOFF.getCOFFSection(".section .drectve", - true, - SectionKind::getMetadata())); + OutStreamer.SwitchSection(TLOFCOFF.getDrectveSection()); for (unsigned i = 0, e = DLLExportedGlobals.size(); i != e; ++i) OutStreamer.EmitRawText("\t.ascii \" -export:" + Twine(DLLExportedGlobals[i]->getName()) + From kremenek at apple.com Fri May 7 12:29:48 2010 From: kremenek at apple.com (Ted Kremenek) Date: Fri, 07 May 2010 17:29:48 -0000 Subject: [llvm-commits] [llvm] r103269 - /llvm/trunk/lib/MC/CMakeLists.txt Message-ID: <20100507172948.97CCB312800A@llvm.org> Author: kremenek Date: Fri May 7 12:29:48 2010 New Revision: 103269 URL: http://llvm.org/viewvc/llvm-project?rev=103269&view=rev Log: Update CMake build. Modified: llvm/trunk/lib/MC/CMakeLists.txt Modified: llvm/trunk/lib/MC/CMakeLists.txt URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/MC/CMakeLists.txt?rev=103269&r1=103268&r2=103269&view=diff ============================================================================== --- llvm/trunk/lib/MC/CMakeLists.txt (original) +++ llvm/trunk/lib/MC/CMakeLists.txt Fri May 7 12:29:48 2010 @@ -14,6 +14,7 @@ MCNullStreamer.cpp MCObjectWriter.cpp MCSection.cpp + MCSectionCOFF.cpp MCSectionELF.cpp MCSectionMachO.cpp MCStreamer.cpp From gkistanova at gmail.com Fri May 7 12:32:54 2010 From: gkistanova at gmail.com (Galina Kistanova) Date: Fri, 7 May 2010 10:32:54 -0700 Subject: [llvm-commits] Patch for builbot to use scripted builds In-Reply-To: References: <4BE159CA.5070108@free.fr> <4BE28113.5020404@free.fr> Message-ID: Hello everyone, Would somebody apply these patches please? Thank you for the review, Daniel. Thanks Galina On Thu, May 6, 2010 at 6:01 PM, Daniel Dunbar wrote: > Hi Galina, > > These look great to me, thank you very very very much for working on this!! > > ?- Daniel > > On Thu, May 6, 2010 at 12:37 PM, Galina Kistanova wrote: >> Hello everyone, >> >> I'd like to check the status of these two patches, one for buildbot >> and another one for llvm-gcc. >> Ok to submit? >> >> Thanks >> >> Galina >> >> >> On Thu, May 6, 2010 at 1:42 AM, Duncan Sands wrote: >>> Hi Galina, >>> >>> ?Yes, I will submit a patch to switch dragonegg to use ScriptedBuilder >>>> as soon as it will be in the svn. That was an idea and I have planed >>>> to clear this with you. But since you have asked, I assume you are Ok >>>> with it, aren't you? >>> >>> yes, I'm fine with having dragonegg use ScriptedBuilder. >>> >>> Thanks for working on this, >>> >>> Duncan. >>> _______________________________________________ >>> llvm-commits mailing list >>> llvm-commits at cs.uiuc.edu >>> http://lists.cs.uiuc.edu/mailman/listinfo/llvm-commits >>> >> >> _______________________________________________ >> llvm-commits mailing list >> llvm-commits at cs.uiuc.edu >> http://lists.cs.uiuc.edu/mailman/listinfo/llvm-commits >> > From kalle.raiskila at nokia.com Fri May 7 13:06:28 2010 From: kalle.raiskila at nokia.com (Kalle Raiskila) Date: Fri, 07 May 2010 18:06:28 -0000 Subject: [llvm-commits] [llvm] r103271 - /llvm/trunk/lib/Target/CellSPU/README.txt Message-ID: <20100507180628.F1A23312800A@llvm.org> Author: kraiskil Date: Fri May 7 13:06:28 2010 New Revision: 103271 URL: http://llvm.org/viewvc/llvm-project?rev=103271&view=rev Log: Testing svn access with a note added to documentation. Modified: llvm/trunk/lib/Target/CellSPU/README.txt Modified: llvm/trunk/lib/Target/CellSPU/README.txt URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Target/CellSPU/README.txt?rev=103271&r1=103270&r2=103271&view=diff ============================================================================== --- llvm/trunk/lib/Target/CellSPU/README.txt (original) +++ llvm/trunk/lib/Target/CellSPU/README.txt Fri May 7 13:06:28 2010 @@ -10,6 +10,8 @@ - Chandler Carruth (LLVM expertise) - Nehal Desai (debugging, i32 operations, RoadRunner SPU expertise) +Some minor fixes added by Kalle Raiskila. + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NONINFRINGEMENT, OR From dpatel at apple.com Fri May 7 13:11:55 2010 From: dpatel at apple.com (Devang Patel) Date: Fri, 07 May 2010 18:11:55 -0000 Subject: [llvm-commits] [llvm] r103272 - in /llvm/trunk: include/llvm/Analysis/DebugInfo.h lib/Analysis/DebugInfo.cpp lib/CodeGen/AsmPrinter/AsmPrinter.cpp lib/CodeGen/AsmPrinter/DwarfDebug.cpp Message-ID: <20100507181155.255ED312800A@llvm.org> Author: dpatel Date: Fri May 7 13:11:54 2010 New Revision: 103272 URL: http://llvm.org/viewvc/llvm-project?rev=103272&view=rev Log: Avoid DIDescriptor::getNode(). Use overloaded operators instead. Modified: llvm/trunk/include/llvm/Analysis/DebugInfo.h llvm/trunk/lib/Analysis/DebugInfo.cpp llvm/trunk/lib/CodeGen/AsmPrinter/AsmPrinter.cpp llvm/trunk/lib/CodeGen/AsmPrinter/DwarfDebug.cpp Modified: llvm/trunk/include/llvm/Analysis/DebugInfo.h URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/include/llvm/Analysis/DebugInfo.h?rev=103272&r1=103271&r2=103272&view=diff ============================================================================== --- llvm/trunk/include/llvm/Analysis/DebugInfo.h (original) +++ llvm/trunk/include/llvm/Analysis/DebugInfo.h Fri May 7 13:11:54 2010 @@ -63,7 +63,9 @@ bool Verify() const { return DbgNode != 0; } - MDNode *getNode() const { return DbgNode; } + MDNode *getNode() const { return DbgNode; } + operator MDNode *() const { return DbgNode; } + MDNode *operator ->() const { return DbgNode; } unsigned getVersion() const { return getUnsignedField(0) & LLVMDebugVersionMask; @@ -397,7 +399,7 @@ DICompositeType DCT(getFieldAs(8)); if (DCT.Verify()) { DIArray A = DCT.getTypeArray(); - DIType T(A.getElement(0).getNode()); + DIType T(A.getElement(0)); return T.getName(); } DIType T(getFieldAs(8)); Modified: llvm/trunk/lib/Analysis/DebugInfo.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Analysis/DebugInfo.cpp?rev=103272&r1=103271&r2=103272&view=diff ============================================================================== --- llvm/trunk/lib/Analysis/DebugInfo.cpp (original) +++ llvm/trunk/lib/Analysis/DebugInfo.cpp Fri May 7 13:11:54 2010 @@ -271,9 +271,9 @@ // which, due to uniquing, has merged with the source. We shield clients from // this detail by allowing a value to be replaced with replaceAllUsesWith() // itself. - if (getNode() != D.getNode()) { + if (getNode() != D) { MDNode *Node = DbgNode; - Node->replaceAllUsesWith(D.getNode()); + Node->replaceAllUsesWith(D); Node->destroy(); } } @@ -394,7 +394,7 @@ if (!BaseType.isValid()) return getSizeInBits(); if (BaseType.isDerivedType()) - return DIDerivedType(BaseType.getNode()).getOriginalTypeSize(); + return DIDerivedType(BaseType).getOriginalTypeSize(); else return BaseType.getSizeInBits(); } @@ -410,7 +410,7 @@ return false; // This variable is not inlined function argument if its scope // does not describe current function. - return !(DISubprogram(getContext().getNode()).describes(CurFn)); + return !(DISubprogram(getContext()).describes(CurFn)); } /// describes - Return true if this subprogram provides debugging @@ -691,7 +691,7 @@ Elts.push_back(llvm::Constant::getNullValue(Type::getInt32Ty(VMContext))); else for (unsigned i = 0; i != NumTys; ++i) - Elts.push_back(Tys[i].getNode()); + Elts.push_back(Tys[i]); return DIArray(MDNode::get(VMContext,Elts.data(), Elts.size())); } @@ -744,7 +744,7 @@ GetTagConstant(dwarf::DW_TAG_file_type), MDString::get(VMContext, Filename), MDString::get(VMContext, Directory), - CU.getNode() + CU }; return DIFile(MDNode::get(VMContext, &Elts[0], 4)); @@ -772,9 +772,9 @@ unsigned Encoding) { Value *Elts[] = { GetTagConstant(dwarf::DW_TAG_base_type), - Context.getNode(), + Context, MDString::get(VMContext, Name), - F.getNode(), + F, ConstantInt::get(Type::getInt32Ty(VMContext), LineNumber), ConstantInt::get(Type::getInt64Ty(VMContext), SizeInBits), ConstantInt::get(Type::getInt64Ty(VMContext), AlignInBits), @@ -797,9 +797,9 @@ unsigned Encoding) { Value *Elts[] = { GetTagConstant(dwarf::DW_TAG_base_type), - Context.getNode(), + Context, MDString::get(VMContext, Name), - F.getNode(), + F, ConstantInt::get(Type::getInt32Ty(VMContext), LineNumber), SizeInBits, AlignInBits, @@ -816,7 +816,7 @@ return Ty; SmallVector Elts; - MDNode *N = Ty.getNode(); + MDNode *N = Ty; assert (N && "Unexpected input DIType!"); for (unsigned i = 0, e = N->getNumOperands(); i != e; ++i) { if (Value *V = N->getOperand(i)) @@ -848,15 +848,15 @@ DIType DerivedFrom) { Value *Elts[] = { GetTagConstant(Tag), - Context.getNode(), + Context, MDString::get(VMContext, Name), - F.getNode(), + F, ConstantInt::get(Type::getInt32Ty(VMContext), LineNumber), ConstantInt::get(Type::getInt64Ty(VMContext), SizeInBits), ConstantInt::get(Type::getInt64Ty(VMContext), AlignInBits), ConstantInt::get(Type::getInt64Ty(VMContext), OffsetInBits), ConstantInt::get(Type::getInt32Ty(VMContext), Flags), - DerivedFrom.getNode(), + DerivedFrom, }; return DIDerivedType(MDNode::get(VMContext, &Elts[0], 10)); } @@ -876,15 +876,15 @@ DIType DerivedFrom) { Value *Elts[] = { GetTagConstant(Tag), - Context.getNode(), + Context, MDString::get(VMContext, Name), - F.getNode(), + F, ConstantInt::get(Type::getInt32Ty(VMContext), LineNumber), SizeInBits, AlignInBits, OffsetInBits, ConstantInt::get(Type::getInt32Ty(VMContext), Flags), - DerivedFrom.getNode(), + DerivedFrom, }; return DIDerivedType(MDNode::get(VMContext, &Elts[0], 10)); } @@ -907,16 +907,16 @@ Value *Elts[] = { GetTagConstant(Tag), - Context.getNode(), + Context, MDString::get(VMContext, Name), - F.getNode(), + F, ConstantInt::get(Type::getInt32Ty(VMContext), LineNumber), ConstantInt::get(Type::getInt64Ty(VMContext), SizeInBits), ConstantInt::get(Type::getInt64Ty(VMContext), AlignInBits), ConstantInt::get(Type::getInt64Ty(VMContext), OffsetInBits), ConstantInt::get(Type::getInt32Ty(VMContext), Flags), - DerivedFrom.getNode(), - Elements.getNode(), + DerivedFrom, + Elements, ConstantInt::get(Type::getInt32Ty(VMContext), RuntimeLang), ContainingType }; @@ -940,16 +940,16 @@ Value *Elts[] = { GetTagConstant(Tag), - Context.getNode(), + Context, MDString::get(VMContext, Name), - F.getNode(), + F, ConstantInt::get(Type::getInt32Ty(VMContext), LineNumber), SizeInBits, AlignInBits, OffsetInBits, ConstantInt::get(Type::getInt32Ty(VMContext), Flags), - DerivedFrom.getNode(), - Elements.getNode(), + DerivedFrom, + Elements, ConstantInt::get(Type::getInt32Ty(VMContext), RuntimeLang) }; return DICompositeType(MDNode::get(VMContext, &Elts[0], 12)); @@ -975,18 +975,18 @@ Value *Elts[] = { GetTagConstant(dwarf::DW_TAG_subprogram), llvm::Constant::getNullValue(Type::getInt32Ty(VMContext)), - Context.getNode(), + Context, MDString::get(VMContext, Name), MDString::get(VMContext, DisplayName), MDString::get(VMContext, LinkageName), - F.getNode(), + F, ConstantInt::get(Type::getInt32Ty(VMContext), LineNo), - Ty.getNode(), + Ty, ConstantInt::get(Type::getInt1Ty(VMContext), isLocalToUnit), ConstantInt::get(Type::getInt1Ty(VMContext), isDefinition), ConstantInt::get(Type::getInt32Ty(VMContext), (unsigned)VK), ConstantInt::get(Type::getInt32Ty(VMContext), VIndex), - ContainingType.getNode(), + ContainingType, ConstantInt::get(Type::getInt1Ty(VMContext), isArtificial), ConstantInt::get(Type::getInt1Ty(VMContext), isOptimized) }; @@ -997,9 +997,9 @@ /// given declaration. DISubprogram DIFactory::CreateSubprogramDefinition(DISubprogram &SPDeclaration) { if (SPDeclaration.isDefinition()) - return DISubprogram(SPDeclaration.getNode()); + return DISubprogram(SPDeclaration); - MDNode *DeclNode = SPDeclaration.getNode(); + MDNode *DeclNode = SPDeclaration; Value *Elts[] = { GetTagConstant(dwarf::DW_TAG_subprogram), llvm::Constant::getNullValue(Type::getInt32Ty(VMContext)), @@ -1032,13 +1032,13 @@ Value *Elts[] = { GetTagConstant(dwarf::DW_TAG_variable), llvm::Constant::getNullValue(Type::getInt32Ty(VMContext)), - Context.getNode(), + Context, MDString::get(VMContext, Name), MDString::get(VMContext, DisplayName), MDString::get(VMContext, LinkageName), - F.getNode(), + F, ConstantInt::get(Type::getInt32Ty(VMContext), LineNo), - Ty.getNode(), + Ty, ConstantInt::get(Type::getInt1Ty(VMContext), isLocalToUnit), ConstantInt::get(Type::getInt1Ty(VMContext), isDefinition), Val @@ -1063,11 +1063,11 @@ DIType Ty) { Value *Elts[] = { GetTagConstant(Tag), - Context.getNode(), + Context, MDString::get(VMContext, Name), - F.getNode(), + F, ConstantInt::get(Type::getInt32Ty(VMContext), LineNo), - Ty.getNode(), + Ty, }; return DIVariable(MDNode::get(VMContext, &Elts[0], 6)); } @@ -1083,11 +1083,11 @@ SmallVector &addr) { SmallVector Elts; Elts.push_back(GetTagConstant(Tag)); - Elts.push_back(Context.getNode()); + Elts.push_back(Context); Elts.push_back(MDString::get(VMContext, Name)); - Elts.push_back(F.getNode()); + Elts.push_back(F); Elts.push_back(ConstantInt::get(Type::getInt32Ty(VMContext), LineNo)); - Elts.push_back(Ty.getNode()); + Elts.push_back(Ty); Elts.insert(Elts.end(), addr.begin(), addr.end()); return DIVariable(MDNode::get(VMContext, &Elts[0], 6+addr.size())); @@ -1100,7 +1100,7 @@ unsigned LineNo, unsigned Col) { Value *Elts[] = { GetTagConstant(dwarf::DW_TAG_lexical_block), - Context.getNode(), + Context, ConstantInt::get(Type::getInt32Ty(VMContext), LineNo), ConstantInt::get(Type::getInt32Ty(VMContext), Col) }; @@ -1114,9 +1114,9 @@ unsigned LineNo) { Value *Elts[] = { GetTagConstant(dwarf::DW_TAG_namespace), - Context.getNode(), + Context, MDString::get(VMContext, Name), - F.getNode(), + F, ConstantInt::get(Type::getInt32Ty(VMContext), LineNo) }; return DINameSpace(MDNode::get(VMContext, &Elts[0], 5)); @@ -1128,8 +1128,8 @@ Value *Elts[] = { ConstantInt::get(Type::getInt32Ty(VMContext), LineNo), ConstantInt::get(Type::getInt32Ty(VMContext), ColumnNo), - S.getNode(), - OrigLoc.getNode(), + S, + OrigLoc, }; return DILocation(MDNode::get(VMContext, &Elts[0], 4)); } @@ -1140,7 +1140,7 @@ Value *Elts[] = { ConstantInt::get(Type::getInt32Ty(VMContext), LineNo), ConstantInt::get(Type::getInt32Ty(VMContext), ColumnNo), - S.getNode(), + S, OrigLoc }; return DILocation(MDNode::get(VMContext, &Elts[0], 4)); @@ -1154,12 +1154,12 @@ Instruction *DIFactory::InsertDeclare(Value *Storage, DIVariable D, Instruction *InsertBefore) { assert(Storage && "no storage passed to dbg.declare"); - assert(D.getNode() && "empty DIVariable passed to dbg.declare"); + assert(D && "empty DIVariable passed to dbg.declare"); if (!DeclareFn) DeclareFn = Intrinsic::getDeclaration(&M, Intrinsic::dbg_declare); Value *Args[] = { MDNode::get(Storage->getContext(), &Storage, 1), - D.getNode() }; + D }; return CallInst::Create(DeclareFn, Args, Args+2, "", InsertBefore); } @@ -1167,12 +1167,12 @@ Instruction *DIFactory::InsertDeclare(Value *Storage, DIVariable D, BasicBlock *InsertAtEnd) { assert(Storage && "no storage passed to dbg.declare"); - assert(D.getNode() && "empty DIVariable passed to dbg.declare"); + assert(D && "empty DIVariable passed to dbg.declare"); if (!DeclareFn) DeclareFn = Intrinsic::getDeclaration(&M, Intrinsic::dbg_declare); Value *Args[] = { MDNode::get(Storage->getContext(), &Storage, 1), - D.getNode() }; + D }; // If this block already has a terminator then insert this intrinsic // before the terminator. @@ -1186,13 +1186,13 @@ DIVariable D, Instruction *InsertBefore) { assert(V && "no value passed to dbg.value"); - assert(D.getNode() && "empty DIVariable passed to dbg.value"); + assert(D && "empty DIVariable passed to dbg.value"); if (!ValueFn) ValueFn = Intrinsic::getDeclaration(&M, Intrinsic::dbg_value); Value *Args[] = { MDNode::get(V->getContext(), &V, 1), ConstantInt::get(Type::getInt64Ty(V->getContext()), Offset), - D.getNode() }; + D }; return CallInst::Create(ValueFn, Args, Args+3, "", InsertBefore); } @@ -1201,13 +1201,13 @@ DIVariable D, BasicBlock *InsertAtEnd) { assert(V && "no value passed to dbg.value"); - assert(D.getNode() && "empty DIVariable passed to dbg.value"); + assert(D && "empty DIVariable passed to dbg.value"); if (!ValueFn) ValueFn = Intrinsic::getDeclaration(&M, Intrinsic::dbg_value); Value *Args[] = { MDNode::get(V->getContext(), &V, 1), ConstantInt::get(Type::getInt64Ty(V->getContext()), Offset), - D.getNode() }; + D }; return CallInst::Create(ValueFn, Args, Args+3, "", InsertAtEnd); } @@ -1232,11 +1232,11 @@ DIDescriptor Scope(Loc.getScope(Ctx)); if (Scope.isCompileUnit()) - addCompileUnit(DICompileUnit(Scope.getNode())); + addCompileUnit(DICompileUnit(Scope)); else if (Scope.isSubprogram()) - processSubprogram(DISubprogram(Scope.getNode())); + processSubprogram(DISubprogram(Scope)); else if (Scope.isLexicalBlock()) - processLexicalBlock(DILexicalBlock(Scope.getNode())); + processLexicalBlock(DILexicalBlock(Scope)); if (MDNode *IA = Loc.getInlinedAt(Ctx)) processLocation(DILocation(IA)); @@ -1258,13 +1258,13 @@ /// processLocation - Process DILocation. void DebugInfoFinder::processLocation(DILocation Loc) { if (!Loc.Verify()) return; - DIDescriptor S(Loc.getScope().getNode()); + DIDescriptor S(Loc.getScope()); if (S.isCompileUnit()) - addCompileUnit(DICompileUnit(S.getNode())); + addCompileUnit(DICompileUnit(S)); else if (S.isSubprogram()) - processSubprogram(DISubprogram(S.getNode())); + processSubprogram(DISubprogram(S)); else if (S.isLexicalBlock()) - processLexicalBlock(DILexicalBlock(S.getNode())); + processLexicalBlock(DILexicalBlock(S)); processLocation(Loc.getOrigLocation()); } @@ -1275,18 +1275,18 @@ addCompileUnit(DT.getCompileUnit()); if (DT.isCompositeType()) { - DICompositeType DCT(DT.getNode()); + DICompositeType DCT(DT); processType(DCT.getTypeDerivedFrom()); DIArray DA = DCT.getTypeArray(); for (unsigned i = 0, e = DA.getNumElements(); i != e; ++i) { DIDescriptor D = DA.getElement(i); if (D.isType()) - processType(DIType(D.getNode())); + processType(DIType(D)); else if (D.isSubprogram()) - processSubprogram(DISubprogram(D.getNode())); + processSubprogram(DISubprogram(D)); } } else if (DT.isDerivedType()) { - DIDerivedType DDT(DT.getNode()); + DIDerivedType DDT(DT); processType(DDT.getTypeDerivedFrom()); } } @@ -1295,9 +1295,9 @@ void DebugInfoFinder::processLexicalBlock(DILexicalBlock LB) { DIScope Context = LB.getContext(); if (Context.isLexicalBlock()) - return processLexicalBlock(DILexicalBlock(Context.getNode())); + return processLexicalBlock(DILexicalBlock(Context)); else - return processSubprogram(DISubprogram(Context.getNode())); + return processSubprogram(DISubprogram(Context)); } /// processSubprogram - Process DISubprogram. @@ -1317,7 +1317,7 @@ if (!DV.isVariable()) return; - if (!NodesSeen.insert(DV.getNode())) + if (!NodesSeen.insert(DV)) return; addCompileUnit(DIVariable(N).getCompileUnit()); @@ -1329,10 +1329,10 @@ if (!DT.isValid()) return false; - if (!NodesSeen.insert(DT.getNode())) + if (!NodesSeen.insert(DT)) return false; - TYs.push_back(DT.getNode()); + TYs.push_back(DT); return true; } @@ -1341,34 +1341,34 @@ if (!CU.Verify()) return false; - if (!NodesSeen.insert(CU.getNode())) + if (!NodesSeen.insert(CU)) return false; - CUs.push_back(CU.getNode()); + CUs.push_back(CU); return true; } /// addGlobalVariable - Add global variable into GVs. bool DebugInfoFinder::addGlobalVariable(DIGlobalVariable DIG) { - if (!DIDescriptor(DIG.getNode()).isGlobalVariable()) + if (!DIDescriptor(DIG).isGlobalVariable()) return false; - if (!NodesSeen.insert(DIG.getNode())) + if (!NodesSeen.insert(DIG)) return false; - GVs.push_back(DIG.getNode()); + GVs.push_back(DIG); return true; } // addSubprogram - Add subprgoram into SPs. bool DebugInfoFinder::addSubprogram(DISubprogram SP) { - if (!DIDescriptor(SP.getNode()).isSubprogram()) + if (!DIDescriptor(SP).isSubprogram()) return false; - if (!NodesSeen.insert(SP.getNode())) + if (!NodesSeen.insert(SP)) return false; - SPs.push_back(SP.getNode()); + SPs.push_back(SP); return true; } @@ -1383,8 +1383,8 @@ DIDescriptor DIG(cast_or_null(NMD->getOperand(i))); if (!DIG.isGlobalVariable()) continue; - if (DIGlobalVariable(DIG.getNode()).getGlobal() == V) - return DIG.getNode(); + if (DIGlobalVariable(DIG).getGlobal() == V) + return DIG; } return 0; } @@ -1462,7 +1462,7 @@ return DISubprogram(Scope); if (D.isLexicalBlock()) - return getDISubprogram(DILexicalBlock(Scope).getContext().getNode()); + return getDISubprogram(DILexicalBlock(Scope).getContext()); return DISubprogram(); } @@ -1470,10 +1470,10 @@ /// getDICompositeType - Find underlying composite type. DICompositeType llvm::getDICompositeType(DIType T) { if (T.isCompositeType()) - return DICompositeType(T.getNode()); + return DICompositeType(T); if (T.isDerivedType()) - return getDICompositeType(DIDerivedType(T.getNode()).getTypeDerivedFrom()); + return getDICompositeType(DIDerivedType(T).getTypeDerivedFrom()); return DICompositeType(); } Modified: llvm/trunk/lib/CodeGen/AsmPrinter/AsmPrinter.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/CodeGen/AsmPrinter/AsmPrinter.cpp?rev=103272&r1=103271&r2=103272&view=diff ============================================================================== --- llvm/trunk/lib/CodeGen/AsmPrinter/AsmPrinter.cpp (original) +++ llvm/trunk/lib/CodeGen/AsmPrinter/AsmPrinter.cpp Fri May 7 13:11:54 2010 @@ -509,7 +509,7 @@ // cast away const; DIetc do not take const operands for some reason. DIVariable V(const_cast(MI->getOperand(2).getMetadata())); if (V.getContext().isSubprogram()) - OS << DISubprogram(V.getContext().getNode()).getDisplayName() << ":"; + OS << DISubprogram(V.getContext()).getDisplayName() << ":"; OS << V.getName() << " <- "; // Register or immediate value. Register 0 means undef. Modified: llvm/trunk/lib/CodeGen/AsmPrinter/DwarfDebug.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/CodeGen/AsmPrinter/DwarfDebug.cpp?rev=103272&r1=103271&r2=103272&view=diff ============================================================================== --- llvm/trunk/lib/CodeGen/AsmPrinter/DwarfDebug.cpp (original) +++ llvm/trunk/lib/CodeGen/AsmPrinter/DwarfDebug.cpp Fri May 7 13:11:54 2010 @@ -232,7 +232,7 @@ void setParent(DbgScope *P) { Parent = P; } DIDescriptor getDesc() const { return Desc; } MDNode *getInlinedAt() const { return InlinedAtLocation; } - MDNode *getScopeNode() const { return Desc.getNode(); } + MDNode *getScopeNode() const { return Desc; } const SmallVector &getScopes() { return Scopes; } const SmallVector &getVariables() { return Variables; } const SmallVector &getRanges() { return Ranges; } @@ -304,7 +304,7 @@ void DbgScope::dump() const { raw_ostream &err = dbgs(); err.indent(IndentLevel); - MDNode *N = Desc.getNode(); + MDNode *N = Desc; N->dump(); if (AbstractScope) err << "Abstract Scope\n"; @@ -564,16 +564,16 @@ unsigned tag = Ty.getTag(); if (tag == dwarf::DW_TAG_pointer_type) { - DIDerivedType DTy = DIDerivedType(Ty.getNode()); + DIDerivedType DTy = DIDerivedType(Ty); subType = DTy.getTypeDerivedFrom(); } - DICompositeType blockStruct = DICompositeType(subType.getNode()); + DICompositeType blockStruct = DICompositeType(subType); DIArray Elements = blockStruct.getTypeArray(); for (unsigned i = 0, N = Elements.getNumElements(); i < N; ++i) { DIDescriptor Element = Elements.getElement(i); - DIDerivedType DT = DIDerivedType(Element.getNode()); + DIDerivedType DT = DIDerivedType(Element); if (Name == DT.getName()) return (DT.getTypeDerivedFrom()); } @@ -704,12 +704,12 @@ StringRef varName = VD.getName(); if (Tag == dwarf::DW_TAG_pointer_type) { - DIDerivedType DTy = DIDerivedType(Ty.getNode()); + DIDerivedType DTy = DIDerivedType(Ty); TmpTy = DTy.getTypeDerivedFrom(); isPointer = true; } - DICompositeType blockStruct = DICompositeType(TmpTy.getNode()); + DICompositeType blockStruct = DICompositeType(TmpTy); // Find the __forwarding field and the variable field in the __Block_byref // struct. @@ -719,7 +719,7 @@ for (unsigned i = 0, N = Fields.getNumElements(); i < N; ++i) { DIDescriptor Element = Fields.getElement(i); - DIDerivedType DT = DIDerivedType(Element.getNode()); + DIDerivedType DT = DIDerivedType(Element); StringRef fieldName = DT.getName(); if (fieldName == "__forwarding") forwardingField = Element; @@ -729,9 +729,9 @@ // Get the offsets for the forwarding field and the variable field. unsigned forwardingFieldOffset = - DIDerivedType(forwardingField.getNode()).getOffsetInBits() >> 3; + DIDerivedType(forwardingField).getOffsetInBits() >> 3; unsigned varFieldOffset = - DIDerivedType(varField.getNode()).getOffsetInBits() >> 3; + DIDerivedType(varField).getOffsetInBits() >> 3; // Decode the original location, and use that as the start of the byref // variable's location. @@ -877,12 +877,12 @@ /// addToContextOwner - Add Die into the list of its context owner's children. void DwarfDebug::addToContextOwner(DIE *Die, DIDescriptor Context) { if (Context.isType()) { - DIE *ContextDIE = getOrCreateTypeDIE(DIType(Context.getNode())); + DIE *ContextDIE = getOrCreateTypeDIE(DIType(Context)); ContextDIE->addChild(Die); } else if (Context.isNameSpace()) { - DIE *ContextDIE = getOrCreateNameSpace(DINameSpace(Context.getNode())); + DIE *ContextDIE = getOrCreateNameSpace(DINameSpace(Context)); ContextDIE->addChild(Die); - } else if (DIE *ContextDIE = ModuleCU->getDIE(Context.getNode())) + } else if (DIE *ContextDIE = ModuleCU->getDIE(Context)) ContextDIE->addChild(Die); else ModuleCU->addDie(Die); @@ -891,20 +891,20 @@ /// getOrCreateTypeDIE - Find existing DIE or create new DIE for the /// given DIType. DIE *DwarfDebug::getOrCreateTypeDIE(DIType Ty) { - DIE *TyDIE = ModuleCU->getDIE(Ty.getNode()); + DIE *TyDIE = ModuleCU->getDIE(Ty); if (TyDIE) return TyDIE; // Create new type. TyDIE = new DIE(dwarf::DW_TAG_base_type); - ModuleCU->insertDIE(Ty.getNode(), TyDIE); + ModuleCU->insertDIE(Ty, TyDIE); if (Ty.isBasicType()) - constructTypeDIE(*TyDIE, DIBasicType(Ty.getNode())); + constructTypeDIE(*TyDIE, DIBasicType(Ty)); else if (Ty.isCompositeType()) - constructTypeDIE(*TyDIE, DICompositeType(Ty.getNode())); + constructTypeDIE(*TyDIE, DICompositeType(Ty)); else { assert(Ty.isDerivedType() && "Unknown kind of DIType"); - constructTypeDIE(*TyDIE, DIDerivedType(Ty.getNode())); + constructTypeDIE(*TyDIE, DIDerivedType(Ty)); } addToContextOwner(TyDIE, Ty.getContext()); @@ -917,7 +917,7 @@ return; // Check for pre-existence. - DIEEntry *Entry = ModuleCU->getDIEEntry(Ty.getNode()); + DIEEntry *Entry = ModuleCU->getDIEEntry(Ty); // If it exists then use the existing value. if (Entry) { Entity->addValue(dwarf::DW_AT_type, dwarf::DW_FORM_ref4, Entry); @@ -929,7 +929,7 @@ // Set up proxy. Entry = createDIEEntry(Buffer); - ModuleCU->insertDIEEntry(Ty.getNode(), Entry); + ModuleCU->insertDIEEntry(Ty, Entry); Entity->addValue(dwarf::DW_AT_type, dwarf::DW_FORM_ref4, Entry); } @@ -998,9 +998,9 @@ // Add enumerators to enumeration type. for (unsigned i = 0, N = Elements.getNumElements(); i < N; ++i) { DIE *ElemDie = NULL; - DIDescriptor Enum(Elements.getElement(i).getNode()); + DIDescriptor Enum(Elements.getElement(i)); if (Enum.isEnumerator()) { - ElemDie = constructEnumTypeDIE(DIEnumerator(Enum.getNode())); + ElemDie = constructEnumTypeDIE(DIEnumerator(Enum)); Buffer.addChild(ElemDie); } } @@ -1010,7 +1010,7 @@ // Add return type. DIArray Elements = CTy.getTypeArray(); DIDescriptor RTy = Elements.getElement(0); - addType(&Buffer, DIType(RTy.getNode())); + addType(&Buffer, DIType(RTy)); // Add prototype flag. addUInt(&Buffer, dwarf::DW_AT_prototyped, dwarf::DW_FORM_flag, 1); @@ -1019,7 +1019,7 @@ for (unsigned i = 1, N = Elements.getNumElements(); i < N; ++i) { DIE *Arg = new DIE(dwarf::DW_TAG_formal_parameter); DIDescriptor Ty = Elements.getElement(i); - addType(Arg, DIType(Ty.getNode())); + addType(Arg, DIType(Ty)); Buffer.addChild(Arg); } } @@ -1040,9 +1040,9 @@ DIDescriptor Element = Elements.getElement(i); DIE *ElemDie = NULL; if (Element.isSubprogram()) - ElemDie = createSubprogramDIE(DISubprogram(Element.getNode())); + ElemDie = createSubprogramDIE(DISubprogram(Element)); else if (Element.isVariable()) { - DIVariable DV(Element.getNode()); + DIVariable DV(Element); ElemDie = new DIE(dwarf::DW_TAG_variable); addString(ElemDie, dwarf::DW_AT_name, dwarf::DW_FORM_string, DV.getName()); @@ -1051,7 +1051,7 @@ addUInt(ElemDie, dwarf::DW_AT_external, dwarf::DW_FORM_flag, 1); addSourceLine(ElemDie, &DV); } else if (Element.isDerivedType()) - ElemDie = createMemberDIE(DIDerivedType(Element.getNode())); + ElemDie = createMemberDIE(DIDerivedType(Element)); else continue; Buffer.addChild(ElemDie); @@ -1066,9 +1066,9 @@ dwarf::DW_FORM_data1, RLang); DICompositeType ContainingType = CTy.getContainingType(); - if (DIDescriptor(ContainingType.getNode()).isCompositeType()) + if (DIDescriptor(ContainingType).isCompositeType()) addDIEEntry(&Buffer, dwarf::DW_AT_containing_type, dwarf::DW_FORM_ref4, - getOrCreateTypeDIE(DIType(ContainingType.getNode()))); + getOrCreateTypeDIE(DIType(ContainingType))); break; } default: @@ -1139,7 +1139,7 @@ for (unsigned i = 0, N = Elements.getNumElements(); i < N; ++i) { DIDescriptor Element = Elements.getElement(i); if (Element.getTag() == dwarf::DW_TAG_subrange_type) - constructSubrangeDIE(Buffer, DISubrange(Element.getNode()), IdxTy); + constructSubrangeDIE(Buffer, DISubrange(Element), IdxTy); } } @@ -1266,7 +1266,7 @@ /// createSubprogramDIE - Create new DIE using SP. DIE *DwarfDebug::createSubprogramDIE(const DISubprogram &SP, bool MakeDecl) { - DIE *SPDie = ModuleCU->getDIE(SP.getNode()); + DIE *SPDie = ModuleCU->getDIE(SP); if (SPDie) return SPDie; @@ -1296,7 +1296,7 @@ if (Args.getNumElements() == 0 || SPTag != dwarf::DW_TAG_subroutine_type) addType(SPDie, SPTy); else - addType(SPDie, DIType(Args.getElement(0).getNode())); + addType(SPDie, DIType(Args.getElement(0))); unsigned VK = SP.getVirtuality(); if (VK) { @@ -1306,7 +1306,7 @@ addUInt(Block, 0, dwarf::DW_FORM_data1, SP.getVirtualIndex()); addBlock(SPDie, dwarf::DW_AT_vtable_elem_location, 0, Block); ContainingTypeMap.insert(std::make_pair(SPDie, - SP.getContainingType().getNode())); + SP.getContainingType())); } if (MakeDecl || !SP.isDefinition()) { @@ -1321,7 +1321,7 @@ if (SPTag == dwarf::DW_TAG_subroutine_type) for (unsigned i = 1, N = Args.getNumElements(); i < N; ++i) { DIE *Arg = new DIE(dwarf::DW_TAG_formal_parameter); - DIType ATy = DIType(DIType(Args.getElement(i).getNode())); + DIType ATy = DIType(DIType(Args.getElement(i))); addType(Arg, ATy); if (ATy.isArtificial()) addUInt(Arg, dwarf::DW_AT_artificial, dwarf::DW_FORM_flag, 1); @@ -1339,7 +1339,7 @@ addUInt(SPDie, dwarf::DW_AT_APPLE_optimized, dwarf::DW_FORM_flag, 1); // DW_TAG_inlined_subroutine may refer to this DIE. - ModuleCU->insertDIE(SP.getNode(), SPDie); + ModuleCU->insertDIE(SP, SPDie); return SPDie; } @@ -1357,7 +1357,7 @@ if (Scope.isLexicalBlock()) { DILexicalBlock DB(N); DIDescriptor ParentDesc = DB.getContext(); - Parent = getOrCreateAbstractScope(ParentDesc.getNode()); + Parent = getOrCreateAbstractScope(ParentDesc); } AScope = new DbgScope(Parent, DIDescriptor(N), NULL); @@ -1380,7 +1380,7 @@ if (D.isSubprogram()) return true; if (D.isType()) - return isSubprogramContext(DIType(Context).getContext().getNode()); + return isSubprogramContext(DIType(Context).getContext()); return false; } @@ -1400,7 +1400,7 @@ // specification DIE for a function defined inside a function. if (SP.isDefinition() && !SP.getContext().isCompileUnit() && !SP.getContext().isFile() && - !isSubprogramContext(SP.getContext().getNode())) { + !isSubprogramContext(SP.getContext())) { addUInt(SPDie, dwarf::DW_AT_declaration, dwarf::DW_FORM_flag, 1); // Add arguments. @@ -1410,7 +1410,7 @@ if (SPTag == dwarf::DW_TAG_subroutine_type) for (unsigned i = 1, N = Args.getNumElements(); i < N; ++i) { DIE *Arg = new DIE(dwarf::DW_TAG_formal_parameter); - DIType ATy = DIType(DIType(Args.getElement(i).getNode())); + DIType ATy = DIType(DIType(Args.getElement(i))); addType(Arg, ATy); if (ATy.isArtificial()) addUInt(Arg, dwarf::DW_AT_artificial, dwarf::DW_FORM_flag, 1); @@ -1508,8 +1508,8 @@ DIScope DS(Scope->getScopeNode()); DIE *ScopeDIE = new DIE(dwarf::DW_TAG_inlined_subroutine); - DISubprogram InlinedSP = getDISubprogram(DS.getNode()); - DIE *OriginDIE = ModuleCU->getDIE(InlinedSP.getNode()); + DISubprogram InlinedSP = getDISubprogram(DS); + DIE *OriginDIE = ModuleCU->getDIE(InlinedSP); assert(OriginDIE && "Unable to find Origin DIE!"); addDIEEntry(ScopeDIE, dwarf::DW_AT_abstract_origin, dwarf::DW_FORM_ref4, OriginDIE); @@ -1521,12 +1521,12 @@ // Track the start label for this inlined function. DenseMap >::iterator - I = InlineInfo.find(InlinedSP.getNode()); + I = InlineInfo.find(InlinedSP); if (I == InlineInfo.end()) { - InlineInfo[InlinedSP.getNode()].push_back(std::make_pair(StartLabel, + InlineInfo[InlinedSP].push_back(std::make_pair(StartLabel, ScopeDIE)); - InlinedSPNodes.push_back(InlinedSP.getNode()); + InlinedSPNodes.push_back(InlinedSP); } else I->second.push_back(std::make_pair(StartLabel, ScopeDIE)); @@ -1571,8 +1571,8 @@ if (AbsDIE) { DIScope DS(Scope->getScopeNode()); - DISubprogram InlinedSP = getDISubprogram(DS.getNode()); - DIE *OriginSPDIE = ModuleCU->getDIE(InlinedSP.getNode()); + DISubprogram InlinedSP = getDISubprogram(DS); + DIE *OriginSPDIE = ModuleCU->getDIE(InlinedSP); (void) OriginSPDIE; assert(OriginSPDIE && "Unable to find Origin DIE for the SP!"); DIE *AbsDIE = DV->getAbstractVariable()->getDIE(); @@ -1655,13 +1655,13 @@ DIArray Args = SPTy.getTypeArray(); for (unsigned i = 0, e = Args.getNumElements(); i != e; ++i) { - DIType ATy(Args.getElement(i).getNode()); + DIType ATy(Args.getElement(i)); if (!ATy.isValid()) continue; DICompositeType CATy = getDICompositeType(ATy); - if (DIDescriptor(CATy.getNode()).Verify() && !CATy.getName().empty() + if (DIDescriptor(CATy).Verify() && !CATy.getName().empty() && !CATy.isForwardDecl()) { - if (DIEEntry *Entry = ModuleCU->getDIEEntry(CATy.getNode())) + if (DIEEntry *Entry = ModuleCU->getDIEEntry(CATy)) ModuleCU->addGlobalType(CATy.getName(), Entry->getEntry()); } } @@ -1678,9 +1678,9 @@ ScopeDIE = constructInlinedScopeDIE(Scope); else if (DS.isSubprogram()) { if (Scope->isAbstractScope()) - ScopeDIE = ModuleCU->getDIE(DS.getNode()); + ScopeDIE = ModuleCU->getDIE(DS); else - ScopeDIE = updateSubprogramScopeDIE(DS.getNode()); + ScopeDIE = updateSubprogramScopeDIE(DS); } else ScopeDIE = constructLexicalScopeDIE(Scope); @@ -1704,7 +1704,7 @@ } if (DS.isSubprogram()) - addPubTypes(DISubprogram(DS.getNode())); + addPubTypes(DISubprogram(DS)); return ScopeDIE; } @@ -1748,11 +1748,11 @@ /// getOrCreateNameSpace - Create a DIE for DINameSpace. DIE *DwarfDebug::getOrCreateNameSpace(DINameSpace NS) { - DIE *NDie = ModuleCU->getDIE(NS.getNode()); + DIE *NDie = ModuleCU->getDIE(NS); if (NDie) return NDie; NDie = new DIE(dwarf::DW_TAG_namespace); - ModuleCU->insertDIE(NS.getNode(), NDie); + ModuleCU->insertDIE(NS, NDie); if (!NS.getName().empty()) addString(NDie, dwarf::DW_AT_name, dwarf::DW_FORM_string, NS.getName()); addSourceLine(NDie, &NS); @@ -1811,7 +1811,7 @@ return; // Check for pre-existence. - if (ModuleCU->getDIE(DI_GV.getNode())) + if (ModuleCU->getDIE(DI_GV)) return; DIE *VariableDie = createGlobalVariableDIE(DI_GV); @@ -1827,7 +1827,7 @@ // or a subprogram. if (DI_GV.isDefinition() && !GVContext.isCompileUnit() && !GVContext.isFile() && - !isSubprogramContext(GVContext.getNode())) { + !isSubprogramContext(GVContext)) { // Create specification DIE. DIE *VariableSpecDIE = new DIE(dwarf::DW_TAG_variable); addDIEEntry(VariableSpecDIE, dwarf::DW_AT_specification, @@ -1854,7 +1854,7 @@ DIType GTy = DI_GV.getType(); if (GTy.isCompositeType() && !GTy.getName().empty() && !GTy.isForwardDecl()) { - DIEEntry *Entry = ModuleCU->getDIEEntry(GTy.getNode()); + DIEEntry *Entry = ModuleCU->getDIEEntry(GTy); assert(Entry && "Missing global type!"); ModuleCU->addGlobalType(GTy.getName(), Entry->getEntry()); } @@ -2040,11 +2040,11 @@ unsigned FrameIdx, DebugLoc ScopeLoc) { - DbgVariable *AbsDbgVariable = AbstractVariables.lookup(Var.getNode()); + DbgVariable *AbsDbgVariable = AbstractVariables.lookup(Var); if (AbsDbgVariable) return AbsDbgVariable; - LLVMContext &Ctx = Var.getNode()->getContext(); + LLVMContext &Ctx = Var->getContext(); DbgScope *Scope = AbstractScopes.lookup(ScopeLoc.getScope(Ctx)); if (!Scope) return NULL; @@ -2052,7 +2052,7 @@ AbsDbgVariable = new DbgVariable(Var, FrameIdx, NULL /* No more-abstract variable*/); Scope->addVariable(AbsDbgVariable); - AbstractVariables[Var.getNode()] = AbsDbgVariable; + AbstractVariables[Var] = AbsDbgVariable; return AbsDbgVariable; } @@ -2062,11 +2062,11 @@ const MachineInstr *MI, DebugLoc ScopeLoc) { - DbgVariable *AbsDbgVariable = AbstractVariables.lookup(Var.getNode()); + DbgVariable *AbsDbgVariable = AbstractVariables.lookup(Var); if (AbsDbgVariable) return AbsDbgVariable; - LLVMContext &Ctx = Var.getNode()->getContext(); + LLVMContext &Ctx = Var->getContext(); DbgScope *Scope = AbstractScopes.lookup(ScopeLoc.getScope(Ctx)); if (!Scope) return NULL; @@ -2074,7 +2074,7 @@ AbsDbgVariable = new DbgVariable(Var, MI, NULL /* No more-abstract variable*/); Scope->addVariable(AbsDbgVariable); - AbstractVariables[Var.getNode()] = AbsDbgVariable; + AbstractVariables[Var] = AbsDbgVariable; DbgValueStartMap[MI] = AbsDbgVariable; return AbsDbgVariable; } @@ -2236,7 +2236,7 @@ DbgScopeMap.insert(std::make_pair(Scope, WScope)); if (DIDescriptor(Scope).isLexicalBlock()) { DbgScope *Parent = - getOrCreateDbgScope(DILexicalBlock(Scope).getContext().getNode(), NULL); + getOrCreateDbgScope(DILexicalBlock(Scope).getContext(), NULL); WScope->setParent(Parent); Parent->addScope(WScope); } @@ -2258,7 +2258,7 @@ DbgScopeMap.insert(std::make_pair(InlinedAt, WScope)); DILocation DL(InlinedAt); DbgScope *Parent = - getOrCreateDbgScope(DL.getScope().getNode(), DL.getOrigLocation().getNode()); + getOrCreateDbgScope(DL.getScope(), DL.getOrigLocation()); WScope->setParent(Parent); Parent->addScope(WScope); From dpatel at apple.com Fri May 7 13:12:57 2010 From: dpatel at apple.com (Devang Patel) Date: Fri, 07 May 2010 18:12:57 -0000 Subject: [llvm-commits] [llvm-gcc-4.2] r103274 - /llvm-gcc-4.2/trunk/gcc/llvm-debug.cpp Message-ID: <20100507181257.9DB2A312800A@llvm.org> Author: dpatel Date: Fri May 7 13:12:57 2010 New Revision: 103274 URL: http://llvm.org/viewvc/llvm-project?rev=103274&view=rev Log: Avoid use of DIDescriptor::getNode(). Use overloaded operators instead. Modified: llvm-gcc-4.2/trunk/gcc/llvm-debug.cpp Modified: llvm-gcc-4.2/trunk/gcc/llvm-debug.cpp URL: http://llvm.org/viewvc/llvm-project/llvm-gcc-4.2/trunk/gcc/llvm-debug.cpp?rev=103274&r1=103273&r2=103274&view=diff ============================================================================== --- llvm-gcc-4.2/trunk/gcc/llvm-debug.cpp (original) +++ llvm-gcc-4.2/trunk/gcc/llvm-debug.cpp Fri May 7 13:12:57 2010 @@ -268,7 +268,8 @@ // grand, but it should be fixed so nothing weird happens if they're // equal. llvm::DIDescriptor D = findRegion(desired); - RegionStack.push_back(D.getNode()); + llvm::MDNode *DN = D; + RegionStack.push_back(DN); } // Pop the current region/lexical-block back to 'grand', then push @@ -302,11 +303,11 @@ DISubprogram SPDecl(cast(I->second)); DISubprogram SP = DebugFactory.CreateSubprogramDefinition(SPDecl); - SPDecl.getNode()->replaceAllUsesWith(SP.getNode()); + SPDecl->replaceAllUsesWith(SP); // Push function on region stack. - RegionStack.push_back(WeakVH(SP.getNode())); - RegionMap[FnDecl] = WeakVH(SP.getNode()); + RegionStack.push_back(WeakVH(SP)); + RegionMap[FnDecl] = WeakVH(SP); return; } @@ -329,11 +330,11 @@ DISubprogram SPDecl(cast(I->second)); DISubprogram SP = DebugFactory.CreateSubprogramDefinition(SPDecl); - SPDecl.getNode()->replaceAllUsesWith(SP.getNode()); + SPDecl->replaceAllUsesWith(SP); // Push function on region stack. - RegionStack.push_back(WeakVH(SP.getNode())); - RegionMap[FnDecl] = WeakVH(SP.getNode()); + RegionStack.push_back(WeakVH(SP)); + RegionMap[FnDecl] = WeakVH(SP); return; } @@ -368,11 +369,11 @@ Virtuality, VIndex, ContainingType, DECL_ARTIFICIAL (FnDecl), optimize); - SPCache[FnDecl] = WeakVH(SP.getNode()); + SPCache[FnDecl] = WeakVH(SP); // Push function on region stack. - RegionStack.push_back(WeakVH(SP.getNode())); - RegionMap[FnDecl] = WeakVH(SP.getNode()); + RegionStack.push_back(WeakVH(SP)); + RegionMap[FnDecl] = WeakVH(SP); } /// getOrCreateNameSpace - Get name space descriptor for the tree node. @@ -387,7 +388,7 @@ DebugFactory.CreateNameSpace(Context, GetNodeName(Node), getOrCreateFile(Loc.file), Loc.line); - NameSpaceCache[Node] = WeakVH(DNS.getNode()); + NameSpaceCache[Node] = WeakVH(DNS); return DNS; } @@ -403,12 +404,12 @@ if (TYPE_P (Node)) { DIType Ty = getOrCreateType(Node); - return DIDescriptor(Ty.getNode()); + return DIDescriptor(Ty); } else if (DECL_P (Node)) { if (TREE_CODE (Node) == NAMESPACE_DECL) { DIDescriptor NSContext = findRegion(DECL_CONTEXT(Node)); DINameSpace NS = getOrCreateNameSpace(Node, NSContext); - return DIDescriptor(NS.getNode()); + return DIDescriptor(NS); } return findRegion (DECL_CONTEXT (Node)); } else if (TREE_CODE(Node) == BLOCK) { @@ -417,7 +418,7 @@ DIDescriptor context = findRegion(BLOCK_SUPERCONTEXT(Node)); DILexicalBlock lexical_block = DebugFactory.CreateLexicalBlock(context, CurLineNo); - RegionMap[Node] = WeakVH(lexical_block.getNode()); + RegionMap[Node] = WeakVH(lexical_block); return DIDescriptor(lexical_block); } @@ -467,7 +468,7 @@ Instruction *Call = DebugFactory.InsertDeclare(AI, D, Builder.GetInsertBlock()); - Call->setDebugLoc(DebugLoc::get(CurLineNo, 0, VarScope.getNode())); + Call->setDebugLoc(DebugLoc::get(CurLineNo, 0, VarScope)); } @@ -624,11 +625,12 @@ getOrCreateFile(main_input_filename), 0, 0, 0, 0, 0, llvm::DIType(), llvm::DIArray()); - llvm::TrackingVH FwdTypeNode = FwdType.getNode(); - TypeCache[type] = WeakVH(FwdType.getNode()); + llvm::MDNode *FTN = FwdType; + llvm::TrackingVH FwdTypeNode = FTN; + TypeCache[type] = WeakVH(FwdType); // Push the struct on region stack. - RegionStack.push_back(WeakVH(FwdType.getNode())); - RegionMap[type] = WeakVH(FwdType.getNode()); + RegionStack.push_back(WeakVH(FwdType)); + RegionMap[type] = WeakVH(FwdType); llvm::SmallVector EltTys; @@ -701,7 +703,7 @@ 0 /*offset */, 0 /*flags*/, FromTy); - TypeCache[TyName] = WeakVH(Ty.getNode()); + TypeCache[TyName] = WeakVH(Ty); return Ty; } @@ -888,12 +890,13 @@ return FwdDecl; // Insert into the TypeCache so that recursive uses will find it. - llvm::TrackingVH FwdDeclNode = FwdDecl.getNode(); - TypeCache[type] = WeakVH(FwdDecl.getNode()); + llvm::MDNode *FDN = FwdDecl; + llvm::TrackingVH FwdDeclNode = FDN; + TypeCache[type] = WeakVH(FwdDecl); // Push the struct on region stack. - RegionStack.push_back(WeakVH(FwdDecl.getNode())); - RegionMap[type] = WeakVH(FwdDecl.getNode()); + RegionStack.push_back(WeakVH(FwdDecl)); + RegionMap[type] = WeakVH(FwdDecl); // Convert all the elements. llvm::SmallVector EltTys; @@ -1017,7 +1020,7 @@ Virtuality, VIndex, ContainingType, DECL_ARTIFICIAL (Member), optimize); EltTys.push_back(SP); - SPCache[Member] = WeakVH(SP.getNode()); + SPCache[Member] = WeakVH(SP); } } @@ -1041,8 +1044,8 @@ Loc.line, NodeSizeInBits(type), NodeAlignInBits(type), 0, SFlags, llvm::DIType(), Elements, - RunTimeLang, ContainingType.getNode()); - RegionMap[type] = WeakVH(RealDecl.getNode()); + RunTimeLang, ContainingType); + RegionMap[type] = WeakVH(RealDecl); // Now that we have a real decl for the struct, replace anything using the // old decl with the new one. This will recursively update the debug info. @@ -1072,7 +1075,7 @@ 0 /*offset */, 0 /*flags*/, MainTy); - TypeCache[TyDef] = WeakVH(Ty.getNode()); + TypeCache[TyDef] = WeakVH(Ty); return Ty; } } @@ -1104,7 +1107,7 @@ MainTy); if (TYPE_VOLATILE(type) || TYPE_READONLY(type)) { - TypeCache[type] = WeakVH(Ty.getNode()); + TypeCache[type] = WeakVH(Ty); return Ty; } @@ -1196,7 +1199,7 @@ Ty = createBasicType(type); break; } - TypeCache[type] = WeakVH(Ty.getNode()); + TypeCache[type] = WeakVH(Ty); return Ty; } From bob.wilson at apple.com Fri May 7 13:14:28 2010 From: bob.wilson at apple.com (Bob Wilson) Date: Fri, 07 May 2010 18:14:28 -0000 Subject: [llvm-commits] [llvm-gcc-4.2] r103275 - /llvm-gcc-4.2/trunk/gcc/config/arm/llvm-arm.cpp Message-ID: <20100507181428.25DED312800A@llvm.org> Author: bwilson Date: Fri May 7 13:14:27 2010 New Revision: 103275 URL: http://llvm.org/viewvc/llvm-project?rev=103275&view=rev Log: Use fadd, fsub, etc. for floating-point operations. Modified: llvm-gcc-4.2/trunk/gcc/config/arm/llvm-arm.cpp Modified: llvm-gcc-4.2/trunk/gcc/config/arm/llvm-arm.cpp URL: http://llvm.org/viewvc/llvm-project/llvm-gcc-4.2/trunk/gcc/config/arm/llvm-arm.cpp?rev=103275&r1=103274&r2=103275&view=diff ============================================================================== --- llvm-gcc-4.2/trunk/gcc/config/arm/llvm-arm.cpp (original) +++ llvm-gcc-4.2/trunk/gcc/config/arm/llvm-arm.cpp Fri May 7 13:14:27 2010 @@ -781,7 +781,10 @@ case NEON_BUILTIN_vadd: if (datatype == neon_datatype_polynomial) return BadImmediateError(exp, Result); - Result = Builder.CreateAdd(Ops[0], Ops[1]); + if (datatype == neon_datatype_float) + Result = Builder.CreateFAdd(Ops[0], Ops[1]); + else + Result = Builder.CreateAdd(Ops[0], Ops[1]); break; case NEON_BUILTIN_vaddl: @@ -868,7 +871,9 @@ intID = Intrinsic::arm_neon_vmulp; intFn = Intrinsic::getDeclaration(TheModule, intID, &ResultType, 1); Result = Builder.CreateCall2(intFn, Ops[0], Ops[1]); - } else + } else if (datatype == neon_datatype_float) + Result = Builder.CreateFMul(Ops[0], Ops[1]); + else Result = Builder.CreateMul(Ops[0], Ops[1]); break; @@ -886,7 +891,10 @@ } if (datatype == neon_datatype_polynomial) return BadImmediateError(exp, Result); - Result = Builder.CreateAdd(Ops[0], Builder.CreateMul(Ops[1], Ops[2])); + if (datatype == neon_datatype_float) + Result = Builder.CreateFAdd(Ops[0], Builder.CreateFMul(Ops[1], Ops[2])); + else + Result = Builder.CreateAdd(Ops[0], Builder.CreateMul(Ops[1], Ops[2])); break; case NEON_BUILTIN_vmls_lane: @@ -903,7 +911,10 @@ } if (datatype == neon_datatype_polynomial) return BadImmediateError(exp, Result); - Result = Builder.CreateSub(Ops[0], Builder.CreateMul(Ops[1], Ops[2])); + if (datatype == neon_datatype_float) + Result = Builder.CreateFSub(Ops[0], Builder.CreateFMul(Ops[1], Ops[2])); + else + Result = Builder.CreateSub(Ops[0], Builder.CreateMul(Ops[1], Ops[2])); break; case NEON_BUILTIN_vmlal_lane: @@ -1233,7 +1244,10 @@ case NEON_BUILTIN_vsub: if (datatype == neon_datatype_polynomial) return BadImmediateError(exp, Result); - Result = Builder.CreateSub(Ops[0], Ops[1]); + if (datatype == neon_datatype_float) + Result = Builder.CreateFSub(Ops[0], Ops[1]); + else + Result = Builder.CreateSub(Ops[0], Ops[1]); break; case NEON_BUILTIN_vsubl: @@ -1573,7 +1587,10 @@ if (datatype != neon_datatype_signed && datatype != neon_datatype_float) return BadImmediateError(exp, Result); - Result = Builder.CreateNeg(Ops[0]); + if (datatype == neon_datatype_float) + Result = Builder.CreateFNeg(Ops[0]); + else + Result = Builder.CreateNeg(Ops[0]); break; case NEON_BUILTIN_vqneg: From dpatel at apple.com Fri May 7 13:19:32 2010 From: dpatel at apple.com (Devang Patel) Date: Fri, 07 May 2010 18:19:32 -0000 Subject: [llvm-commits] [llvm] r103276 - in /llvm/trunk/lib: Analysis/DebugInfo.cpp Target/PIC16/PIC16DebugInfo.cpp Target/X86/AsmPrinter/X86MCInstLower.cpp Transforms/Utils/CloneFunction.cpp Transforms/Utils/PromoteMemoryToRegister.cpp Message-ID: <20100507181932.C3696312800A@llvm.org> Author: dpatel Date: Fri May 7 13:19:32 2010 New Revision: 103276 URL: http://llvm.org/viewvc/llvm-project?rev=103276&view=rev Log: Use overloaded operators instead of DIDescriptor::getNode() Modified: llvm/trunk/lib/Analysis/DebugInfo.cpp llvm/trunk/lib/Target/PIC16/PIC16DebugInfo.cpp llvm/trunk/lib/Target/X86/AsmPrinter/X86MCInstLower.cpp llvm/trunk/lib/Transforms/Utils/CloneFunction.cpp llvm/trunk/lib/Transforms/Utils/PromoteMemoryToRegister.cpp Modified: llvm/trunk/lib/Analysis/DebugInfo.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Analysis/DebugInfo.cpp?rev=103276&r1=103275&r2=103276&view=diff ============================================================================== --- llvm/trunk/lib/Analysis/DebugInfo.cpp (original) +++ llvm/trunk/lib/Analysis/DebugInfo.cpp Fri May 7 13:19:32 2010 @@ -271,7 +271,7 @@ // which, due to uniquing, has merged with the source. We shield clients from // this detail by allowing a value to be replaced with replaceAllUsesWith() // itself. - if (getNode() != D) { + if (DbgNode != D) { MDNode *Node = DbgNode; Node->replaceAllUsesWith(D); Node->destroy(); Modified: llvm/trunk/lib/Target/PIC16/PIC16DebugInfo.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Target/PIC16/PIC16DebugInfo.cpp?rev=103276&r1=103275&r2=103276&view=diff ============================================================================== --- llvm/trunk/lib/Target/PIC16/PIC16DebugInfo.cpp (original) +++ llvm/trunk/lib/Target/PIC16/PIC16DebugInfo.cpp Fri May 7 13:19:32 2010 @@ -70,7 +70,7 @@ // We also need to encode the information about the base type of // pointer in TypeNo. - DIType BaseType = DIDerivedType(Ty.getNode()).getTypeDerivedFrom(); + DIType BaseType = DIDerivedType(Ty).getTypeDerivedFrom(); PopulateDebugInfo(BaseType, TypeNo, HasAux, Aux, TagName); } @@ -79,7 +79,7 @@ bool &HasAux, int Aux[], std::string &TagName) { - DICompositeType CTy = DICompositeType(Ty.getNode()); + DICompositeType CTy = DICompositeType(Ty); DIArray Elements = CTy.getTypeArray(); unsigned short size = 1; unsigned short Dimension[4]={0,0,0,0}; @@ -88,7 +88,7 @@ if (Element.getTag() == dwarf::DW_TAG_subrange_type) { TypeNo = TypeNo << PIC16Dbg::S_DERIVED; TypeNo = TypeNo | PIC16Dbg::DT_ARY; - DISubrange SubRange = DISubrange(Element.getNode()); + DISubrange SubRange = DISubrange(Element); Dimension[i] = SubRange.getHi() - SubRange.getLo() + 1; // Each dimension is represented by 2 bytes starting at byte 9. Aux[8+i*2+0] = Dimension[i]; @@ -111,7 +111,7 @@ unsigned short &TypeNo, bool &HasAux, int Aux[], std::string &TagName) { - DICompositeType CTy = DICompositeType(Ty.getNode()); + DICompositeType CTy = DICompositeType(Ty); TypeNo = TypeNo << PIC16Dbg::S_BASIC; if (Ty.getTag() == dwarf::DW_TAG_structure_type) TypeNo = TypeNo | PIC16Dbg::T_STRUCT; @@ -124,7 +124,7 @@ // llvm.dbg.composite* global variable. Since we need to revisit // PIC16DebugInfo implementation anyways after the MDNodes based // framework is done, let us continue with the way it is. - std::string UniqueSuffix = "." + Ty.getNode()->getNameStr().substr(18); + std::string UniqueSuffix = "." + Ty->getNameStr().substr(18); TagName += UniqueSuffix; unsigned short size = CTy.getSizeInBits()/8; // 7th and 8th byte represent size. @@ -303,7 +303,7 @@ bool HasAux = false; int ElementAux[PIC16Dbg::AuxSize] = { 0 }; std::string TagName = ""; - DIDerivedType DITy(Element.getNode()); + DIDerivedType DITy(Element); unsigned short ElementSize = DITy.getSizeInBits()/8; // Get mangleddd name for this structure/union element. std::string MangMemName = DITy.getName().str() + SuffixNo; @@ -336,7 +336,7 @@ CTy.getTag() == dwarf::DW_TAG_structure_type ) { // Get the number after llvm.dbg.composite and make UniqueSuffix from // it. - std::string DIVar = CTy.getNode()->getNameStr(); + std::string DIVar = CTy->getNameStr(); std::string UniqueSuffix = "." + DIVar.substr(18); std::string MangledCTyName = CTy.getName().str() + UniqueSuffix; unsigned short size = CTy.getSizeInBits()/8; Modified: llvm/trunk/lib/Target/X86/AsmPrinter/X86MCInstLower.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/lib/Target/X86/AsmPrinter/X86MCInstLower.cpp?rev=103276&r1=103275&r2=103276&view=diff ============================================================================== --- llvm/trunk/lib/Target/X86/AsmPrinter/X86MCInstLower.cpp (original) +++ llvm/trunk/lib/Target/X86/AsmPrinter/X86MCInstLower.cpp Fri May 7 13:19:32 2010 @@ -346,7 +346,7 @@ // cast away const; DIetc do not take const operands for some reason. DIVariable V(const_cast(MI->getOperand(NOps-1).getMetadata())); if (V.getContext().isSubprogram()) - O << DISubprogram(V.getContext().getNode()).getDisplayName() << ":"; + O << DISubprogram(V.getContext()).getDisplayName() << ":"; O << V.getName(); O << " <- "; // Frame address. Currently handles register +- offset only. Modified: llvm/trunk/lib/Transforms/Utils/CloneFunction.cpp URL: http://llvm.org/viewvc/llvm-project/llvm/trunk