LinkTimeOptimizer.h revision 193323 
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 inteded 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
20extern "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