1 //===-- llvm/LinkTimeOptimizer.h - LTO Public C Interface -------*- C++ -*-===// 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 header provides a C API to use the LLVM link time optimization 11 // library. This is intended to be used by linkers which are C-only in 12 // their implementation for performing LTO. 13 // 14 //===----------------------------------------------------------------------===// 15 16 #ifndef LLVM_C_LINKTIMEOPTIMIZER_H 17 #define LLVM_C_LINKTIMEOPTIMIZER_H 18 19 #ifdef __cplusplus 20 extern "C" { 21 #endif 22 23 /** 24 * @defgroup LLVMCLinkTimeOptimizer Link Time Optimization 25 * @ingroup LLVMC 26 * 27 * @{ 28 */ 29 30 /// This provides a dummy type for pointers to the LTO object. 31 typedef void* llvm_lto_t; 32 33 /// This provides a C-visible enumerator to manage status codes. 34 /// This should map exactly onto the C++ enumerator LTOStatus. 35 typedef enum llvm_lto_status { 36 LLVM_LTO_UNKNOWN, 37 LLVM_LTO_OPT_SUCCESS, 38 LLVM_LTO_READ_SUCCESS, 39 LLVM_LTO_READ_FAILURE, 40 LLVM_LTO_WRITE_FAILURE, 41 LLVM_LTO_NO_TARGET, 42 LLVM_LTO_NO_WORK, 43 LLVM_LTO_MODULE_MERGE_FAILURE, 44 LLVM_LTO_ASM_FAILURE, 45 46 // Added C-specific error codes 47 LLVM_LTO_NULL_OBJECT 48 } llvm_lto_status_t; 49 50 /// This provides C interface to initialize link time optimizer. This allows 51 /// linker to use dlopen() interface to dynamically load LinkTimeOptimizer. 52 /// extern "C" helps, because dlopen() interface uses name to find the symbol. 53 extern llvm_lto_t llvm_create_optimizer(void); 54 extern void llvm_destroy_optimizer(llvm_lto_t lto); 55 56 extern llvm_lto_status_t llvm_read_object_file 57 (llvm_lto_t lto, const char* input_filename); 58 extern llvm_lto_status_t llvm_optimize_modules 59 (llvm_lto_t lto, const char* output_filename); 60 61 /** 62 * @} 63 */ 64 65 #ifdef __cplusplus 66 } 67 #endif 68 69 #endif 70
