Home | History | Annotate | Download | only in llvm-c
      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 __LTO_CAPI_H__
     17 #define __LTO_CAPI_H__
     18 
     19 #ifdef __cplusplus
     20 extern "C" {
     21 #endif
     22 
     23   /// This provides a dummy type for pointers to the LTO object.
     24   typedef void* llvm_lto_t;
     25 
     26   /// This provides a C-visible enumerator to manage status codes.
     27   /// This should map exactly onto the C++ enumerator LTOStatus.
     28   typedef enum llvm_lto_status {
     29     LLVM_LTO_UNKNOWN,
     30     LLVM_LTO_OPT_SUCCESS,
     31     LLVM_LTO_READ_SUCCESS,
     32     LLVM_LTO_READ_FAILURE,
     33     LLVM_LTO_WRITE_FAILURE,
     34     LLVM_LTO_NO_TARGET,
     35     LLVM_LTO_NO_WORK,
     36     LLVM_LTO_MODULE_MERGE_FAILURE,
     37     LLVM_LTO_ASM_FAILURE,
     38 
     39     //  Added C-specific error codes
     40     LLVM_LTO_NULL_OBJECT
     41   } llvm_lto_status_t;
     42 
     43   /// This provides C interface to initialize link time optimizer. This allows
     44   /// linker to use dlopen() interface to dynamically load LinkTimeOptimizer.
     45   /// extern "C" helps, because dlopen() interface uses name to find the symbol.
     46   extern llvm_lto_t llvm_create_optimizer(void);
     47   extern void llvm_destroy_optimizer(llvm_lto_t lto);
     48 
     49   extern llvm_lto_status_t llvm_read_object_file
     50     (llvm_lto_t lto, const char* input_filename);
     51   extern llvm_lto_status_t llvm_optimize_modules
     52     (llvm_lto_t lto, const char* output_filename);
     53 
     54 #ifdef __cplusplus
     55 }
     56 #endif
     57 
     58 #endif
     59