lto.h revision 07d5aef3057b2e403b20d683e7477c93fde67d99
177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/*===-- llvm-c/lto.h - LTO Public C Interface ---------------------*- C -*-===*\ 277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik|* *| 377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik|* The LLVM Compiler Infrastructure *| 477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik|* *| 577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik|* This file is distributed under the University of Illinois Open Source *| 677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik|* License. See LICENSE.TXT for details. *| 777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik|* *| 877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik|*===----------------------------------------------------------------------===*| 977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik|* *| 1077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik|* This header provides public interface to an abstract link time optimization*| 1177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik|* library. LLVM provides an implementation of this interface for use with *| 1277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik|* llvm bitcode files. *| 1377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik|* *| 1477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik\*===----------------------------------------------------------------------===*/ 1577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 16674be02d525d4e24bc6943ed9274958c580bcfbcJakub Staszak#ifndef LLVM_C_LTO_H 17674be02d525d4e24bc6943ed9274958c580bcfbcJakub Staszak#define LLVM_C_LTO_H 1877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 1977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik#include <stddef.h> 20e8a665f696b60834a3087e3d5bccf8cacf3ca39dPeter Collingbourne#include <sys/types.h> 2177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 2207d5aef3057b2e403b20d683e7477c93fde67d99Reid Kleckner#ifndef __cplusplus 2307d5aef3057b2e403b20d683e7477c93fde67d99Reid Kleckner#if !defined(_MSC_VER) 2407d5aef3057b2e403b20d683e7477c93fde67d99Reid Kleckner#include <stdbool.h> 2507d5aef3057b2e403b20d683e7477c93fde67d99Reid Klecknertypedef bool lto_bool_t; 2607d5aef3057b2e403b20d683e7477c93fde67d99Reid Kleckner#else 2707d5aef3057b2e403b20d683e7477c93fde67d99Reid Kleckner// MSVC in particular does not have anything like _Bool or bool in C, but we can 2807d5aef3057b2e403b20d683e7477c93fde67d99Reid Kleckner// at least make sure the type is the same size. The implementation side will 2907d5aef3057b2e403b20d683e7477c93fde67d99Reid Kleckner// use C++ bool. 3007d5aef3057b2e403b20d683e7477c93fde67d99Reid Klecknertypedef unsigned char lto_bool_t; 3107d5aef3057b2e403b20d683e7477c93fde67d99Reid Kleckner#endif 3207d5aef3057b2e403b20d683e7477c93fde67d99Reid Kleckner#else 3307d5aef3057b2e403b20d683e7477c93fde67d99Reid Klecknertypedef bool lto_bool_t; 3407d5aef3057b2e403b20d683e7477c93fde67d99Reid Kleckner#endif 3507d5aef3057b2e403b20d683e7477c93fde67d99Reid Kleckner 366244b518880842f2c15200ee041e06799e4cc779Gregory Szorc/** 376244b518880842f2c15200ee041e06799e4cc779Gregory Szorc * @defgroup LLVMCLTO LTO 386244b518880842f2c15200ee041e06799e4cc779Gregory Szorc * @ingroup LLVMC 396244b518880842f2c15200ee041e06799e4cc779Gregory Szorc * 406244b518880842f2c15200ee041e06799e4cc779Gregory Szorc * @{ 416244b518880842f2c15200ee041e06799e4cc779Gregory Szorc */ 426244b518880842f2c15200ee041e06799e4cc779Gregory Szorc 43438900938c3ac9d7fac2dd5d2c85ca4b9b2e35f7Rafael Espindola#define LTO_API_VERSION 5 44cbad58624090933cb8fb85587e03be613a481309Nick Kledzik 4577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziktypedef enum { 467afea0cfc4abebaf4cadcc37acd30fb251a5faf3Bill Wendling LTO_SYMBOL_ALIGNMENT_MASK = 0x0000001F, /* log2 of alignment */ 47168f1428346f3d51304db0be64e1d5e4a09ca4c2Bill Wendling LTO_SYMBOL_PERMISSIONS_MASK = 0x000000E0, 48168f1428346f3d51304db0be64e1d5e4a09ca4c2Bill Wendling LTO_SYMBOL_PERMISSIONS_CODE = 0x000000A0, 49168f1428346f3d51304db0be64e1d5e4a09ca4c2Bill Wendling LTO_SYMBOL_PERMISSIONS_DATA = 0x000000C0, 50168f1428346f3d51304db0be64e1d5e4a09ca4c2Bill Wendling LTO_SYMBOL_PERMISSIONS_RODATA = 0x00000080, 51168f1428346f3d51304db0be64e1d5e4a09ca4c2Bill Wendling LTO_SYMBOL_DEFINITION_MASK = 0x00000700, 52168f1428346f3d51304db0be64e1d5e4a09ca4c2Bill Wendling LTO_SYMBOL_DEFINITION_REGULAR = 0x00000100, 53168f1428346f3d51304db0be64e1d5e4a09ca4c2Bill Wendling LTO_SYMBOL_DEFINITION_TENTATIVE = 0x00000200, 54168f1428346f3d51304db0be64e1d5e4a09ca4c2Bill Wendling LTO_SYMBOL_DEFINITION_WEAK = 0x00000300, 55168f1428346f3d51304db0be64e1d5e4a09ca4c2Bill Wendling LTO_SYMBOL_DEFINITION_UNDEFINED = 0x00000400, 567afea0cfc4abebaf4cadcc37acd30fb251a5faf3Bill Wendling LTO_SYMBOL_DEFINITION_WEAKUNDEF = 0x00000500, 57168f1428346f3d51304db0be64e1d5e4a09ca4c2Bill Wendling LTO_SYMBOL_SCOPE_MASK = 0x00003800, 58168f1428346f3d51304db0be64e1d5e4a09ca4c2Bill Wendling LTO_SYMBOL_SCOPE_INTERNAL = 0x00000800, 59168f1428346f3d51304db0be64e1d5e4a09ca4c2Bill Wendling LTO_SYMBOL_SCOPE_HIDDEN = 0x00001000, 60168f1428346f3d51304db0be64e1d5e4a09ca4c2Bill Wendling LTO_SYMBOL_SCOPE_PROTECTED = 0x00002000, 617afea0cfc4abebaf4cadcc37acd30fb251a5faf3Bill Wendling LTO_SYMBOL_SCOPE_DEFAULT = 0x00001800, 627afea0cfc4abebaf4cadcc37acd30fb251a5faf3Bill Wendling LTO_SYMBOL_SCOPE_DEFAULT_CAN_BE_HIDDEN = 0x00002800 6377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik} lto_symbol_attributes; 6477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 6577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziktypedef enum { 6677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik LTO_DEBUG_MODEL_NONE = 0, 6777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik LTO_DEBUG_MODEL_DWARF = 1 6877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik} lto_debug_model; 6977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 7077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziktypedef enum { 7177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik LTO_CODEGEN_PIC_MODEL_STATIC = 0, 7277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik LTO_CODEGEN_PIC_MODEL_DYNAMIC = 1, 7377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik LTO_CODEGEN_PIC_MODEL_DYNAMIC_NO_PIC = 2 7477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik} lto_codegen_model; 7577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 7677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 7777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** opaque reference to a loaded object module */ 7877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziktypedef struct LTOModule* lto_module_t; 7977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 8077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** opaque reference to a code generator */ 8177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziktypedef struct LTOCodeGenerator* lto_code_gen_t; 8277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 8377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik#ifdef __cplusplus 8477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern "C" { 8577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik#endif 8677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 8777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 8877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Returns a printable string. 8977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 9077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern const char* 9116c1f44d91211a225497062ea508d58fd25085a9Gordon Henriksenlto_get_version(void); 9277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 9377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 9477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 957a2bdde0a0eebcd2125055e0eacaca040f0b766cChris Lattner * Returns the last error string or NULL if last operation was successful. 9677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 9777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern const char* 9816c1f44d91211a225497062ea508d58fd25085a9Gordon Henriksenlto_get_error_message(void); 9977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 10077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 10177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Checks if a file is a loadable object file. 10277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 10307d5aef3057b2e403b20d683e7477c93fde67d99Reid Klecknerextern lto_bool_t 10477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziklto_module_is_object_file(const char* path); 10577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 10677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 10777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 10877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Checks if a file is a loadable object compiled for requested target. 10977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 11007d5aef3057b2e403b20d683e7477c93fde67d99Reid Klecknerextern lto_bool_t 111168f1428346f3d51304db0be64e1d5e4a09ca4c2Bill Wendlinglto_module_is_object_file_for_target(const char* path, 112b454eabe7ff0824356ccdb75459a0312f43254c1Nick Lewycky const char* target_triple_prefix); 11377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 11477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 11577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 11677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Checks if a buffer is a loadable object file. 11777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 11807d5aef3057b2e403b20d683e7477c93fde67d99Reid Klecknerextern lto_bool_t 11977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziklto_module_is_object_file_in_memory(const void* mem, size_t length); 12077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 12177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 12277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 12377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Checks if a buffer is a loadable object compiled for requested target. 12477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 12507d5aef3057b2e403b20d683e7477c93fde67d99Reid Klecknerextern lto_bool_t 126168f1428346f3d51304db0be64e1d5e4a09ca4c2Bill Wendlinglto_module_is_object_file_in_memory_for_target(const void* mem, size_t length, 127ca3ca138d88139e24a8e60fef982436575a19f38Eric Christopher const char* target_triple_prefix); 12877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 12977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 13077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 13177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Loads an object file from disk. 13277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Returns NULL on error (check lto_get_error_message() for details). 13377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 13477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern lto_module_t 1350e7a54672cf346ee7c4aae10822c74f7c74f3fedOwen Andersonlto_module_create(const char* path); 13677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 13777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 13877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 13977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Loads an object file from memory. 14077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Returns NULL on error (check lto_get_error_message() for details). 14177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 14277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern lto_module_t 1430e7a54672cf346ee7c4aae10822c74f7c74f3fedOwen Andersonlto_module_create_from_memory(const void* mem, size_t length); 14477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 145b4cc031a3e1306fea74c9211d50c5cde6d9a8cd5Rafael Espindola/** 146b4cc031a3e1306fea74c9211d50c5cde6d9a8cd5Rafael Espindola * Loads an object file from disk. The seek point of fd is not preserved. 147b4cc031a3e1306fea74c9211d50c5cde6d9a8cd5Rafael Espindola * Returns NULL on error (check lto_get_error_message() for details). 148b4cc031a3e1306fea74c9211d50c5cde6d9a8cd5Rafael Espindola */ 149b4cc031a3e1306fea74c9211d50c5cde6d9a8cd5Rafael Espindolaextern lto_module_t 150f21b1058a194f411000bdd8000a8b675a7874056Rafael Espindolalto_module_create_from_fd(int fd, const char *path, size_t file_size); 151f21b1058a194f411000bdd8000a8b675a7874056Rafael Espindola 152f21b1058a194f411000bdd8000a8b675a7874056Rafael Espindola/** 153f21b1058a194f411000bdd8000a8b675a7874056Rafael Espindola * Loads an object file from disk. The seek point of fd is not preserved. 154f21b1058a194f411000bdd8000a8b675a7874056Rafael Espindola * Returns NULL on error (check lto_get_error_message() for details). 155f21b1058a194f411000bdd8000a8b675a7874056Rafael Espindola */ 156f21b1058a194f411000bdd8000a8b675a7874056Rafael Espindolaextern lto_module_t 157f21b1058a194f411000bdd8000a8b675a7874056Rafael Espindolalto_module_create_from_fd_at_offset(int fd, const char *path, size_t file_size, 158f21b1058a194f411000bdd8000a8b675a7874056Rafael Espindola size_t map_size, off_t offset); 159b4cc031a3e1306fea74c9211d50c5cde6d9a8cd5Rafael Espindola 16077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 16177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 16277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Frees all memory internally allocated by the module. 16377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Upon return the lto_module_t is no longer valid. 16477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 16577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern void 16677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziklto_module_dispose(lto_module_t mod); 16777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 16877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 16977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 17077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Returns triple string which the object module was compiled under. 17177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 17277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern const char* 17377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziklto_module_get_target_triple(lto_module_t mod); 17477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 175cbb170d057aa6692b19f577b1e09a6c1c7a26969Rafael Espindola/** 176cbb170d057aa6692b19f577b1e09a6c1c7a26969Rafael Espindola * Sets triple string with which the object will be codegened. 177cbb170d057aa6692b19f577b1e09a6c1c7a26969Rafael Espindola */ 178cbb170d057aa6692b19f577b1e09a6c1c7a26969Rafael Espindolaextern void 179cbb170d057aa6692b19f577b1e09a6c1c7a26969Rafael Espindolalto_module_set_target_triple(lto_module_t mod, const char *triple); 180cbb170d057aa6692b19f577b1e09a6c1c7a26969Rafael Espindola 18177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 18277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 18377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Returns the number of symbols in the object module. 18477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 1856a6623c596fc12f64c813ea14a006ac6da3e33feDevang Patelextern unsigned int 18677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziklto_module_get_num_symbols(lto_module_t mod); 18777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 18877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 18977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 19077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Returns the name of the ith symbol in the object module. 19177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 19277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern const char* 1936a6623c596fc12f64c813ea14a006ac6da3e33feDevang Patellto_module_get_symbol_name(lto_module_t mod, unsigned int index); 19477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 19577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 19677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 19777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Returns the attributes of the ith symbol in the object module. 19877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 19977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern lto_symbol_attributes 2006a6623c596fc12f64c813ea14a006ac6da3e33feDevang Patellto_module_get_symbol_attribute(lto_module_t mod, unsigned int index); 20177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 20277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 20377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 20477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Instantiates a code generator. 20577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Returns NULL on error (check lto_get_error_message() for details). 20677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 20777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern lto_code_gen_t 2080e7a54672cf346ee7c4aae10822c74f7c74f3fedOwen Andersonlto_codegen_create(void); 20977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 21077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 21177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 21277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Frees all code generator and all memory it internally allocated. 21377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Upon return the lto_code_gen_t is no longer valid. 21477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 21577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern void 21677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziklto_codegen_dispose(lto_code_gen_t); 21777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 21877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 21977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 22077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 22177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Add an object module to the set of modules for which code will be generated. 22277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Returns true on error (check lto_get_error_message() for details). 22377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 22407d5aef3057b2e403b20d683e7477c93fde67d99Reid Klecknerextern lto_bool_t 22577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziklto_codegen_add_module(lto_code_gen_t cg, lto_module_t mod); 22677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 22777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 22877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 22977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 23077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Sets if debug info should be generated. 23177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Returns true on error (check lto_get_error_message() for details). 23277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 23307d5aef3057b2e403b20d683e7477c93fde67d99Reid Klecknerextern lto_bool_t 23477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziklto_codegen_set_debug_model(lto_code_gen_t cg, lto_debug_model); 23577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 23677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 23777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 23877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Sets which PIC code model to generated. 23977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Returns true on error (check lto_get_error_message() for details). 24077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 24107d5aef3057b2e403b20d683e7477c93fde67d99Reid Klecknerextern lto_bool_t 24277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziklto_codegen_set_pic_model(lto_code_gen_t cg, lto_codegen_model); 24377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 24477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 24577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 2462d643ef32891859ec73b6eea2959748f5ebc3af7Rafael Espindola * Sets the cpu to generate code for. 2472d643ef32891859ec73b6eea2959748f5ebc3af7Rafael Espindola */ 2482d643ef32891859ec73b6eea2959748f5ebc3af7Rafael Espindolaextern void 2492d643ef32891859ec73b6eea2959748f5ebc3af7Rafael Espindolalto_codegen_set_cpu(lto_code_gen_t cg, const char *cpu); 2502d643ef32891859ec73b6eea2959748f5ebc3af7Rafael Espindola 2512d643ef32891859ec73b6eea2959748f5ebc3af7Rafael Espindola 2522d643ef32891859ec73b6eea2959748f5ebc3af7Rafael Espindola/** 253cbad58624090933cb8fb85587e03be613a481309Nick Kledzik * Sets the location of the assembler tool to run. If not set, libLTO 254cbad58624090933cb8fb85587e03be613a481309Nick Kledzik * will use gcc to invoke the assembler. 255cbad58624090933cb8fb85587e03be613a481309Nick Kledzik */ 256cbad58624090933cb8fb85587e03be613a481309Nick Kledzikextern void 257cbad58624090933cb8fb85587e03be613a481309Nick Kledziklto_codegen_set_assembler_path(lto_code_gen_t cg, const char* path); 258cbad58624090933cb8fb85587e03be613a481309Nick Kledzik 25998197e55c10176c3ef9100f7d852abbd2347225fRafael Espindola/** 26098197e55c10176c3ef9100f7d852abbd2347225fRafael Espindola * Sets extra arguments that libLTO should pass to the assembler. 26198197e55c10176c3ef9100f7d852abbd2347225fRafael Espindola */ 26298197e55c10176c3ef9100f7d852abbd2347225fRafael Espindolaextern void 26398197e55c10176c3ef9100f7d852abbd2347225fRafael Espindolalto_codegen_set_assembler_args(lto_code_gen_t cg, const char **args, 26498197e55c10176c3ef9100f7d852abbd2347225fRafael Espindola int nargs); 265cbad58624090933cb8fb85587e03be613a481309Nick Kledzik 266cbad58624090933cb8fb85587e03be613a481309Nick Kledzik/** 267438900938c3ac9d7fac2dd5d2c85ca4b9b2e35f7Rafael Espindola * Tells LTO optimization passes that this symbol must be preserved 268438900938c3ac9d7fac2dd5d2c85ca4b9b2e35f7Rafael Espindola * because it is referenced by native code or a command line option. 26977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 27077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern void 27177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziklto_codegen_add_must_preserve_symbol(lto_code_gen_t cg, const char* symbol); 27277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 273438900938c3ac9d7fac2dd5d2c85ca4b9b2e35f7Rafael Espindola 274438900938c3ac9d7fac2dd5d2c85ca4b9b2e35f7Rafael Espindola/** 275438900938c3ac9d7fac2dd5d2c85ca4b9b2e35f7Rafael Espindola * Tells LTO optimization passes that a dynamic shared library is being 276438900938c3ac9d7fac2dd5d2c85ca4b9b2e35f7Rafael Espindola * built and this symbol may be exported. Unless IR semantics allow the symbol 277438900938c3ac9d7fac2dd5d2c85ca4b9b2e35f7Rafael Espindola * to be made local to the library, it should remain so it can be exported by 278438900938c3ac9d7fac2dd5d2c85ca4b9b2e35f7Rafael Espindola * the shared library. 279438900938c3ac9d7fac2dd5d2c85ca4b9b2e35f7Rafael Espindola */ 280438900938c3ac9d7fac2dd5d2c85ca4b9b2e35f7Rafael Espindolaextern void lto_codegen_add_dso_symbol(lto_code_gen_t cg, const char *symbol); 281438900938c3ac9d7fac2dd5d2c85ca4b9b2e35f7Rafael Espindola 28277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 28377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Writes a new object file at the specified path that contains the 28477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * merged contents of all modules added so far. 28577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Returns true on error (check lto_get_error_message() for details). 28677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 28707d5aef3057b2e403b20d683e7477c93fde67d99Reid Klecknerextern lto_bool_t 28877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziklto_codegen_write_merged_modules(lto_code_gen_t cg, const char* path); 28977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 29077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 29177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Generates code for all added modules into one native object file. 2927a2bdde0a0eebcd2125055e0eacaca040f0b766cChris Lattner * On success returns a pointer to a generated mach-o/ELF buffer and 293168f1428346f3d51304db0be64e1d5e4a09ca4c2Bill Wendling * length set to the buffer size. The buffer is owned by the 294ef194ed74033eba099f4f391ffdfc176f9aa6f26Nick Kledzik * lto_code_gen_t and will be freed when lto_codegen_dispose() 295ef194ed74033eba099f4f391ffdfc176f9aa6f26Nick Kledzik * is called, or lto_codegen_compile() is called again. 29677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * On failure, returns NULL (check lto_get_error_message() for details). 29777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 298ef194ed74033eba099f4f391ffdfc176f9aa6f26Nick Kledzikextern const void* 29977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziklto_codegen_compile(lto_code_gen_t cg, size_t* length); 30077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 3016421a8815e14189121a5e20731fd005ea08793e1Rafael Espindola/** 3026421a8815e14189121a5e20731fd005ea08793e1Rafael Espindola * Generates code for all added modules into one native object file. 3036421a8815e14189121a5e20731fd005ea08793e1Rafael Espindola * The name of the file is written to name. Returns true on error. 3046421a8815e14189121a5e20731fd005ea08793e1Rafael Espindola */ 30507d5aef3057b2e403b20d683e7477c93fde67d99Reid Klecknerextern lto_bool_t 3066421a8815e14189121a5e20731fd005ea08793e1Rafael Espindolalto_codegen_compile_to_file(lto_code_gen_t cg, const char** name); 3076421a8815e14189121a5e20731fd005ea08793e1Rafael Espindola 30877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 309a93ae711a91dd151ca4d28e4172e0de89d1594f3Devang Patel/** 310a93ae711a91dd151ca4d28e4172e0de89d1594f3Devang Patel * Sets options to help debug codegen bugs. 311a93ae711a91dd151ca4d28e4172e0de89d1594f3Devang Patel */ 312a93ae711a91dd151ca4d28e4172e0de89d1594f3Devang Patelextern void 313a93ae711a91dd151ca4d28e4172e0de89d1594f3Devang Patellto_codegen_debug_options(lto_code_gen_t cg, const char *); 314168f1428346f3d51304db0be64e1d5e4a09ca4c2Bill Wendling 3158a2ce5d32987f99185f40eb3085a8972291f8d5cBenjamin Kramer/** 3168a2ce5d32987f99185f40eb3085a8972291f8d5cBenjamin Kramer * Initializes LLVM disassemblers. 3178a2ce5d32987f99185f40eb3085a8972291f8d5cBenjamin Kramer * FIXME: This doesn't really belong here. 3188a2ce5d32987f99185f40eb3085a8972291f8d5cBenjamin Kramer */ 3198a2ce5d32987f99185f40eb3085a8972291f8d5cBenjamin Kramerextern void 3208a2ce5d32987f99185f40eb3085a8972291f8d5cBenjamin Kramerlto_initialize_disassembler(void); 3218a2ce5d32987f99185f40eb3085a8972291f8d5cBenjamin Kramer 32277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik#ifdef __cplusplus 32377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik} 32477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik#endif 32577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 3266244b518880842f2c15200ee041e06799e4cc779Gregory Szorc/** 3276244b518880842f2c15200ee041e06799e4cc779Gregory Szorc * @} 3286244b518880842f2c15200ee041e06799e4cc779Gregory Szorc */ 32977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 33077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik#endif 331