[COFF] Dump string table size for COFF file headers
[lldb.git] / llvm / include / llvm-c / LinkTimeOptimizer.h
1 //===-- llvm/LinkTimeOptimizer.h - LTO Public C Interface -------*- C++ -*-===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 //
9 // This header provides a C API to use the LLVM link time optimization
10 // library. This is intended to be used by linkers which are C-only in
11 // their implementation for performing LTO.
12 //
13 //===----------------------------------------------------------------------===//
14
15 #ifndef LLVM_C_LINKTIMEOPTIMIZER_H
16 #define LLVM_C_LINKTIMEOPTIMIZER_H
17
18 #include "llvm-c/ExternC.h"
19
20 LLVM_C_EXTERN_C_BEGIN
21
22 /**
23  * @defgroup LLVMCLinkTimeOptimizer Link Time Optimization
24  * @ingroup LLVMC
25  *
26  * @{
27  */
28
29   /// This provides a dummy type for pointers to the LTO object.
30   typedef void* llvm_lto_t;
31
32   /// This provides a C-visible enumerator to manage status codes.
33   /// This should map exactly onto the C++ enumerator LTOStatus.
34   typedef enum llvm_lto_status {
35     LLVM_LTO_UNKNOWN,
36     LLVM_LTO_OPT_SUCCESS,
37     LLVM_LTO_READ_SUCCESS,
38     LLVM_LTO_READ_FAILURE,
39     LLVM_LTO_WRITE_FAILURE,
40     LLVM_LTO_NO_TARGET,
41     LLVM_LTO_NO_WORK,
42     LLVM_LTO_MODULE_MERGE_FAILURE,
43     LLVM_LTO_ASM_FAILURE,
44
45     //  Added C-specific error codes
46     LLVM_LTO_NULL_OBJECT
47   } llvm_lto_status_t;
48
49   /// This provides C interface to initialize link time optimizer. This allows
50   /// linker to use dlopen() interface to dynamically load LinkTimeOptimizer.
51   /// extern "C" helps, because dlopen() interface uses name to find the symbol.
52   extern llvm_lto_t llvm_create_optimizer(void);
53   extern void llvm_destroy_optimizer(llvm_lto_t lto);
54
55   extern llvm_lto_status_t llvm_read_object_file
56     (llvm_lto_t lto, const char* input_filename);
57   extern llvm_lto_status_t llvm_optimize_modules
58     (llvm_lto_t lto, const char* output_filename);
59
60 /**
61  * @}
62  */
63
64   LLVM_C_EXTERN_C_END
65
66 #endif