lto.h revision ca3ca138d88139e24a8e60fef982436575a19f38
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 1677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik#ifndef LTO_H 1777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik#define LTO_H 1 1877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 1977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik#include <stdbool.h> 2077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik#include <stddef.h> 2177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 22cbad58624090933cb8fb85587e03be613a481309Nick Kledzik#define LTO_API_VERSION 3 23cbad58624090933cb8fb85587e03be613a481309Nick Kledzik 2477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziktypedef enum { 2577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik LTO_SYMBOL_ALIGNMENT_MASK = 0x0000001F, /* log2 of alignment */ 2677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik LTO_SYMBOL_PERMISSIONS_MASK = 0x000000E0, 2777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik LTO_SYMBOL_PERMISSIONS_CODE = 0x000000A0, 2877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik LTO_SYMBOL_PERMISSIONS_DATA = 0x000000C0, 2977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik LTO_SYMBOL_PERMISSIONS_RODATA = 0x00000080, 3077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik LTO_SYMBOL_DEFINITION_MASK = 0x00000700, 3177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik LTO_SYMBOL_DEFINITION_REGULAR = 0x00000100, 3277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik LTO_SYMBOL_DEFINITION_TENTATIVE = 0x00000200, 3377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik LTO_SYMBOL_DEFINITION_WEAK = 0x00000300, 3477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik LTO_SYMBOL_DEFINITION_UNDEFINED = 0x00000400, 357431af050f287011fd52e64034ede6dd98193febRafael Espindola LTO_SYMBOL_DEFINITION_WEAKUNDEF = 0x00000500, 364fd40e884c76ffbf1157ab4ca48a099c55eebb4fNick Lewycky LTO_SYMBOL_SCOPE_MASK = 0x00003800, 3777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik LTO_SYMBOL_SCOPE_INTERNAL = 0x00000800, 3877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik LTO_SYMBOL_SCOPE_HIDDEN = 0x00001000, 394fd40e884c76ffbf1157ab4ca48a099c55eebb4fNick Lewycky LTO_SYMBOL_SCOPE_PROTECTED = 0x00002000, 4077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik LTO_SYMBOL_SCOPE_DEFAULT = 0x00001800 4177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik} lto_symbol_attributes; 4277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 4377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziktypedef enum { 4477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik LTO_DEBUG_MODEL_NONE = 0, 4577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik LTO_DEBUG_MODEL_DWARF = 1 4677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik} lto_debug_model; 4777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 4877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziktypedef enum { 4977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik LTO_CODEGEN_PIC_MODEL_STATIC = 0, 5077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik LTO_CODEGEN_PIC_MODEL_DYNAMIC = 1, 5177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik LTO_CODEGEN_PIC_MODEL_DYNAMIC_NO_PIC = 2 5277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik} lto_codegen_model; 5377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 5477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 5577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** opaque reference to a loaded object module */ 5677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziktypedef struct LTOModule* lto_module_t; 5777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 5877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** opaque reference to a code generator */ 5977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziktypedef struct LTOCodeGenerator* lto_code_gen_t; 6077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 6177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik#ifdef __cplusplus 6277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern "C" { 6377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik#endif 6477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 6577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 6677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Returns a printable string. 6777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 6877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern const char* 6916c1f44d91211a225497062ea508d58fd25085a9Gordon Henriksenlto_get_version(void); 7077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 7177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 7277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 7377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Returns the last error string or NULL if last operation was sucessful. 7477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 7577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern const char* 7616c1f44d91211a225497062ea508d58fd25085a9Gordon Henriksenlto_get_error_message(void); 7777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 7877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 7977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Checks if a file is a loadable object file. 8077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 8177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern bool 8277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziklto_module_is_object_file(const char* path); 8377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 8477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 8577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 8677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Checks if a file is a loadable object compiled for requested target. 8777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 8877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern bool 8977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziklto_module_is_object_file_for_target(const char* path, 90b454eabe7ff0824356ccdb75459a0312f43254c1Nick Lewycky const char* target_triple_prefix); 9177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 9277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 9377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 9477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Checks if a buffer is a loadable object file. 9577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 9677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern bool 9777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziklto_module_is_object_file_in_memory(const void* mem, size_t length); 9877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 9977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 10077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 10177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Checks if a buffer is a loadable object compiled for requested target. 10277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 10377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern bool 10477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziklto_module_is_object_file_in_memory_for_target(const void* mem, size_t length, 105ca3ca138d88139e24a8e60fef982436575a19f38Eric Christopher const char* target_triple_prefix); 10677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 10777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 10877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 10977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Loads an object file from disk. 11077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Returns NULL on error (check lto_get_error_message() for details). 11177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 11277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern lto_module_t 1130e7a54672cf346ee7c4aae10822c74f7c74f3fedOwen Andersonlto_module_create(const char* path); 11477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 11577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 11677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 11777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Loads an object file from memory. 11877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Returns NULL on error (check lto_get_error_message() for details). 11977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 12077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern lto_module_t 1210e7a54672cf346ee7c4aae10822c74f7c74f3fedOwen Andersonlto_module_create_from_memory(const void* mem, size_t length); 12277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 12377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 12477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 12577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Frees all memory internally allocated by the module. 12677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Upon return the lto_module_t is no longer valid. 12777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 12877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern void 12977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziklto_module_dispose(lto_module_t mod); 13077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 13177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 13277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 13377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Returns triple string which the object module was compiled under. 13477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 13577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern const char* 13677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziklto_module_get_target_triple(lto_module_t mod); 13777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 13877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 13977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 14077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Returns the number of symbols in the object module. 14177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 14277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern unsigned int 14377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziklto_module_get_num_symbols(lto_module_t mod); 14477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 14577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 14677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 14777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Returns the name of the ith symbol in the object module. 14877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 14977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern const char* 15077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziklto_module_get_symbol_name(lto_module_t mod, unsigned int index); 15177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 15277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 15377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 15477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Returns the attributes of the ith symbol in the object module. 15577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 15677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern lto_symbol_attributes 15777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziklto_module_get_symbol_attribute(lto_module_t mod, unsigned int index); 15877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 15977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 16077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 16177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Instantiates a code generator. 16277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Returns NULL on error (check lto_get_error_message() for details). 16377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 16477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern lto_code_gen_t 1650e7a54672cf346ee7c4aae10822c74f7c74f3fedOwen Andersonlto_codegen_create(void); 16677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 16777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 16877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 16977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Frees all code generator and all memory it internally allocated. 17077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Upon return the lto_code_gen_t is no longer valid. 17177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 17277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern void 17377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziklto_codegen_dispose(lto_code_gen_t); 17477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 17577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 17677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 17777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 17877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Add an object module to the set of modules for which code will be generated. 17977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Returns true on error (check lto_get_error_message() for details). 18077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 18177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern bool 18277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziklto_codegen_add_module(lto_code_gen_t cg, lto_module_t mod); 18377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 18477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 18577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 18677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 18777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Sets if debug info should be generated. 18877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Returns true on error (check lto_get_error_message() for details). 18977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 19077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern bool 19177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziklto_codegen_set_debug_model(lto_code_gen_t cg, lto_debug_model); 19277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 19377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 19477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 19577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Sets which PIC code model to generated. 19677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Returns true on error (check lto_get_error_message() for details). 19777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 19877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern bool 19977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziklto_codegen_set_pic_model(lto_code_gen_t cg, lto_codegen_model); 20077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 20177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 20277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 2031d621f71c84c4f4d0574c0fa17fc5a8f6c49b46fNick Lewycky * Sets the location of the "gcc" to run. If not set, libLTO will search for 2041d621f71c84c4f4d0574c0fa17fc5a8f6c49b46fNick Lewycky * "gcc" on the path. 2051d621f71c84c4f4d0574c0fa17fc5a8f6c49b46fNick Lewycky */ 2061d621f71c84c4f4d0574c0fa17fc5a8f6c49b46fNick Lewyckyextern void 2071d621f71c84c4f4d0574c0fa17fc5a8f6c49b46fNick Lewyckylto_codegen_set_gcc_path(lto_code_gen_t cg, const char* path); 2081d621f71c84c4f4d0574c0fa17fc5a8f6c49b46fNick Lewycky 2091d621f71c84c4f4d0574c0fa17fc5a8f6c49b46fNick Lewycky 2101d621f71c84c4f4d0574c0fa17fc5a8f6c49b46fNick Lewycky/** 211cbad58624090933cb8fb85587e03be613a481309Nick Kledzik * Sets the location of the assembler tool to run. If not set, libLTO 212cbad58624090933cb8fb85587e03be613a481309Nick Kledzik * will use gcc to invoke the assembler. 213cbad58624090933cb8fb85587e03be613a481309Nick Kledzik */ 214cbad58624090933cb8fb85587e03be613a481309Nick Kledzikextern void 215cbad58624090933cb8fb85587e03be613a481309Nick Kledziklto_codegen_set_assembler_path(lto_code_gen_t cg, const char* path); 216cbad58624090933cb8fb85587e03be613a481309Nick Kledzik 217cbad58624090933cb8fb85587e03be613a481309Nick Kledzik 218cbad58624090933cb8fb85587e03be613a481309Nick Kledzik/** 21977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Adds to a list of all global symbols that must exist in the final 22077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * generated code. If a function is not listed, it might be 22177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * inlined into every usage and optimized away. 22277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 22377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern void 22477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziklto_codegen_add_must_preserve_symbol(lto_code_gen_t cg, const char* symbol); 22577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 22677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 22777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 22877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Writes a new object file at the specified path that contains the 22977595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * merged contents of all modules added so far. 23077595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Returns true on error (check lto_get_error_message() for details). 23177595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 23277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzikextern bool 23377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziklto_codegen_write_merged_modules(lto_code_gen_t cg, const char* path); 23477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 23577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 23677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik/** 23777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * Generates code for all added modules into one native object file. 23877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * On sucess returns a pointer to a generated mach-o/ELF buffer and 239ef194ed74033eba099f4f391ffdfc176f9aa6f26Nick Kledzik * length set to the buffer size. The buffer is owned by the 240ef194ed74033eba099f4f391ffdfc176f9aa6f26Nick Kledzik * lto_code_gen_t and will be freed when lto_codegen_dispose() 241ef194ed74033eba099f4f391ffdfc176f9aa6f26Nick Kledzik * is called, or lto_codegen_compile() is called again. 24277595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik * On failure, returns NULL (check lto_get_error_message() for details). 24377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik */ 244ef194ed74033eba099f4f391ffdfc176f9aa6f26Nick Kledzikextern const void* 24577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledziklto_codegen_compile(lto_code_gen_t cg, size_t* length); 24677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 24777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 248a93ae711a91dd151ca4d28e4172e0de89d1594f3Devang Patel/** 249a93ae711a91dd151ca4d28e4172e0de89d1594f3Devang Patel * Sets options to help debug codegen bugs. 250a93ae711a91dd151ca4d28e4172e0de89d1594f3Devang Patel */ 251a93ae711a91dd151ca4d28e4172e0de89d1594f3Devang Patelextern void 252a93ae711a91dd151ca4d28e4172e0de89d1594f3Devang Patellto_codegen_debug_options(lto_code_gen_t cg, const char *); 25377595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik#ifdef __cplusplus 25477595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik} 25577595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik#endif 25677595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 25777595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik 25877595fc35642f990bfc5ad05b8e68d4056695ecaNick Kledzik#endif 259