lto.cpp revision 7a2bdde0a0eebcd2125055e0eacaca040f0b766c
1//===-lto.cpp - LLVM Link Time Optimizer ----------------------------------===// 2// 3// The LLVM Compiler Infrastructure 4// 5// This file is distributed under the University of Illinois Open Source 6// License. See LICENSE.TXT for details. 7// 8//===----------------------------------------------------------------------===// 9// 10// This file implements the Link Time Optimization library. This library is 11// intended to be used by linker to optimize code at link time. 12// 13//===----------------------------------------------------------------------===// 14 15#include "llvm-c/lto.h" 16#include "llvm-c/Core.h" 17 18#include "LTOModule.h" 19#include "LTOCodeGenerator.h" 20 21 22// holds most recent error string 23// *** not thread safe *** 24static std::string sLastErrorString; 25 26 27 28// 29// returns a printable string 30// 31extern const char* lto_get_version() 32{ 33 return LTOCodeGenerator::getVersionString(); 34} 35 36// 37// returns the last error string or NULL if last operation was successful 38// 39const char* lto_get_error_message() 40{ 41 return sLastErrorString.c_str(); 42} 43 44 45 46// 47// validates if a file is a loadable object file 48// 49bool lto_module_is_object_file(const char* path) 50{ 51 return LTOModule::isBitcodeFile(path); 52} 53 54 55// 56// validates if a file is a loadable object file compilable for requested target 57// 58bool lto_module_is_object_file_for_target(const char* path, 59 const char* target_triplet_prefix) 60{ 61 return LTOModule::isBitcodeFileForTarget(path, target_triplet_prefix); 62} 63 64 65// 66// validates if a buffer is a loadable object file 67// 68bool lto_module_is_object_file_in_memory(const void* mem, size_t length) 69{ 70 return LTOModule::isBitcodeFile(mem, length); 71} 72 73 74// 75// validates if a buffer is a loadable object file compilable for the target 76// 77bool lto_module_is_object_file_in_memory_for_target(const void* mem, 78 size_t length, const char* target_triplet_prefix) 79{ 80 return LTOModule::isBitcodeFileForTarget(mem, length, target_triplet_prefix); 81} 82 83 84 85// 86// loads an object file from disk 87// returns NULL on error (check lto_get_error_message() for details) 88// 89lto_module_t lto_module_create(const char* path) 90{ 91 return LTOModule::makeLTOModule(path, sLastErrorString); 92} 93 94// 95// loads an object file from disk 96// returns NULL on error (check lto_get_error_message() for details) 97// 98lto_module_t lto_module_create_from_fd(int fd, const char *path, size_t size) 99{ 100 return LTOModule::makeLTOModule(fd, path, size, sLastErrorString); 101} 102 103// 104// loads an object file from disk 105// returns NULL on error (check lto_get_error_message() for details) 106// 107lto_module_t lto_module_create_from_fd_at_offset(int fd, const char *path, 108 size_t file_size, 109 size_t map_size, 110 off_t offset) 111{ 112 return LTOModule::makeLTOModule(fd, path, file_size, map_size, 113 offset, sLastErrorString); 114} 115 116// 117// loads an object file from memory 118// returns NULL on error (check lto_get_error_message() for details) 119// 120lto_module_t lto_module_create_from_memory(const void* mem, size_t length) 121{ 122 return LTOModule::makeLTOModule(mem, length, sLastErrorString); 123} 124 125 126// 127// frees all memory for a module 128// upon return the lto_module_t is no longer valid 129// 130void lto_module_dispose(lto_module_t mod) 131{ 132 delete mod; 133} 134 135 136// 137// returns triplet string which the object module was compiled under 138// 139const char* lto_module_get_target_triple(lto_module_t mod) 140{ 141 return mod->getTargetTriple(); 142} 143 144// 145// sets triple string with which the object will be codegened. 146// 147void lto_module_set_target_triple(lto_module_t mod, const char *triple) 148{ 149 return mod->setTargetTriple(triple); 150} 151 152 153// 154// returns the number of symbols in the object module 155// 156unsigned int lto_module_get_num_symbols(lto_module_t mod) 157{ 158 return mod->getSymbolCount(); 159} 160 161// 162// returns the name of the ith symbol in the object module 163// 164const char* lto_module_get_symbol_name(lto_module_t mod, unsigned int index) 165{ 166 return mod->getSymbolName(index); 167} 168 169 170// 171// returns the attributes of the ith symbol in the object module 172// 173lto_symbol_attributes lto_module_get_symbol_attribute(lto_module_t mod, 174 unsigned int index) 175{ 176 return mod->getSymbolAttributes(index); 177} 178 179 180 181 182 183// 184// instantiates a code generator 185// returns NULL if there is an error 186// 187lto_code_gen_t lto_codegen_create(void) 188{ 189 return new LTOCodeGenerator(); 190} 191 192 193 194// 195// frees all memory for a code generator 196// upon return the lto_code_gen_t is no longer valid 197// 198void lto_codegen_dispose(lto_code_gen_t cg) 199{ 200 delete cg; 201} 202 203 204 205// 206// add an object module to the set of modules for which code will be generated 207// returns true on error (check lto_get_error_message() for details) 208// 209bool lto_codegen_add_module(lto_code_gen_t cg, lto_module_t mod) 210{ 211 return cg->addModule(mod, sLastErrorString); 212} 213 214 215// 216// sets what if any format of debug info should be generated 217// returns true on error (check lto_get_error_message() for details) 218// 219bool lto_codegen_set_debug_model(lto_code_gen_t cg, lto_debug_model debug) 220{ 221 return cg->setDebugInfo(debug, sLastErrorString); 222} 223 224 225// 226// sets what code model to generated 227// returns true on error (check lto_get_error_message() for details) 228// 229bool lto_codegen_set_pic_model(lto_code_gen_t cg, lto_codegen_model model) 230{ 231 return cg->setCodePICModel(model, sLastErrorString); 232} 233 234// 235// sets the cpu to generate code for 236// 237void lto_codegen_set_cpu(lto_code_gen_t cg, const char* cpu) 238{ 239 return cg->setCpu(cpu); 240} 241 242// 243// sets the path to the assembler tool 244// 245void lto_codegen_set_assembler_path(lto_code_gen_t cg, const char* path) 246{ 247 // In here only for backwards compatibility. We use MC now. 248} 249 250 251// 252// sets extra arguments that libLTO should pass to the assembler 253// 254void lto_codegen_set_assembler_args(lto_code_gen_t cg, const char** args, 255 int nargs) 256{ 257 // In here only for backwards compatibility. We use MC now. 258} 259 260// 261// adds to a list of all global symbols that must exist in the final 262// generated code. If a function is not listed there, it might be 263// inlined into every usage and optimized away. 264// 265void lto_codegen_add_must_preserve_symbol(lto_code_gen_t cg, const char* symbol) 266{ 267 cg->addMustPreserveSymbol(symbol); 268} 269 270 271// 272// writes a new file at the specified path that contains the 273// merged contents of all modules added so far. 274// returns true on error (check lto_get_error_message() for details) 275// 276bool lto_codegen_write_merged_modules(lto_code_gen_t cg, const char* path) 277{ 278 return cg->writeMergedModules(path, sLastErrorString); 279} 280 281 282// 283// Generates code for all added modules into one native object file. 284// On success returns a pointer to a generated mach-o/ELF buffer and 285// length set to the buffer size. The buffer is owned by the 286// lto_code_gen_t and will be freed when lto_codegen_dispose() 287// is called, or lto_codegen_compile() is called again. 288// On failure, returns NULL (check lto_get_error_message() for details). 289// 290extern const void* 291lto_codegen_compile(lto_code_gen_t cg, size_t* length) 292{ 293 return cg->compile(length, sLastErrorString); 294} 295 296extern bool 297lto_codegen_compile_to_file(lto_code_gen_t cg, const char **name) 298{ 299 return cg->compile_to_file(name, sLastErrorString); 300} 301 302 303// 304// Used to pass extra options to the code generator 305// 306extern void 307lto_codegen_debug_options(lto_code_gen_t cg, const char * opt) 308{ 309 cg->setCodeGenDebugOptions(opt); 310} 311