mirror of
https://github.com/RPCS3/llvm-mirror.git
synced 2024-11-25 20:23:11 +01:00
43c1c2e000
This gives a lot of love to the docs for the C API. Like Clang's documentation, the C API is now organized into a Doxygen "module" (LLVMC). Each C header file is a child of the main module. Some modules (like Core) have a hierarchy of there own. The produced documentation is thus better organized (before everything was in one monolithic list). This patch also includes a lot of new documentation for APIs in Core.h. It doesn't document them all, but is better than none. Function docs are missing @param and @return annotation, but the documentation body now commonly provides help details (like the expected llvm::Value sub-type to expect). llvm-svn: 153157
70 lines
1.9 KiB
C++
70 lines
1.9 KiB
C++
//===-- llvm/LinkTimeOptimizer.h - LTO Public C Interface -------*- C++ -*-===//
|
|
//
|
|
// The LLVM Compiler Infrastructure
|
|
//
|
|
// This file is distributed under the University of Illinois Open Source
|
|
// License. See LICENSE.TXT for details.
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
//
|
|
// This header provides a C API to use the LLVM link time optimization
|
|
// library. This is intended to be used by linkers which are C-only in
|
|
// their implementation for performing LTO.
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#ifndef __LTO_CAPI_H__
|
|
#define __LTO_CAPI_H__
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* @defgroup LLVMCLinkTimeOptimizer Link Time Optimization
|
|
* @ingroup LLVMC
|
|
*
|
|
* @{
|
|
*/
|
|
|
|
/// This provides a dummy type for pointers to the LTO object.
|
|
typedef void* llvm_lto_t;
|
|
|
|
/// This provides a C-visible enumerator to manage status codes.
|
|
/// This should map exactly onto the C++ enumerator LTOStatus.
|
|
typedef enum llvm_lto_status {
|
|
LLVM_LTO_UNKNOWN,
|
|
LLVM_LTO_OPT_SUCCESS,
|
|
LLVM_LTO_READ_SUCCESS,
|
|
LLVM_LTO_READ_FAILURE,
|
|
LLVM_LTO_WRITE_FAILURE,
|
|
LLVM_LTO_NO_TARGET,
|
|
LLVM_LTO_NO_WORK,
|
|
LLVM_LTO_MODULE_MERGE_FAILURE,
|
|
LLVM_LTO_ASM_FAILURE,
|
|
|
|
// Added C-specific error codes
|
|
LLVM_LTO_NULL_OBJECT
|
|
} llvm_lto_status_t;
|
|
|
|
/// This provides C interface to initialize link time optimizer. This allows
|
|
/// linker to use dlopen() interface to dynamically load LinkTimeOptimizer.
|
|
/// extern "C" helps, because dlopen() interface uses name to find the symbol.
|
|
extern llvm_lto_t llvm_create_optimizer(void);
|
|
extern void llvm_destroy_optimizer(llvm_lto_t lto);
|
|
|
|
extern llvm_lto_status_t llvm_read_object_file
|
|
(llvm_lto_t lto, const char* input_filename);
|
|
extern llvm_lto_status_t llvm_optimize_modules
|
|
(llvm_lto_t lto, const char* output_filename);
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif
|