0580563299
## Purpose This patch is one in a series of code-mods that annotate LLVM’s public interface for export. This patch annotates the `llvm-c` interface with a new `LLVM_C_ABI` annotation, which behaves like the `LLVM_ABI`. This annotation currently has no meaningful impact on the LLVM build; however, it is a prerequisite to support an LLVM Windows DLL (shared library) build. ## Overview 1. Add a new `llvm-c/Visibility.h` header file that defines a new `LLVM_C_ABI` macro. The macro resolves to the proper DLL export/import annotation on Windows and a "default" visibility annotation elsewhere. 2. Add a new `LLVM_ENABLE_LLVM_C_EXPORT_ANNOTATIONS` `#cmakedefine` that is used to gate the definition of `LLVM_C_ABI`. 3. Remove the existing `LLVM_C_ABI` definition from `llvm/Support/Compiler.h`. Update the small number of `LLVM_C_ABI` references to get it from the new `llvm-c/Visibility.h` header. 4. Code-mod annotate the public `llvm-c` interface using the [Interface Definition Scanner (IDS)](https://github.com/compnerd/ids) tool. 5. Format the changes with `clang-format`. ## Background This effort is tracked in #109483. Additional context is provided in [this discourse](https://discourse.llvm.org/t/psa-annotating-llvm-public-interface/85307), and documentation for `LLVM_ABI` and related annotations is found in the LLVM repo [here](https://github.com/llvm/llvm-project/blob/main/llvm/docs/InterfaceExportAnnotations.rst). ## Validation Local builds and tests to validate cross-platform compatibility. This included llvm, clang, and lldb on the following configurations: - Windows with MSVC - Windows with Clang - Linux with GCC - Linux with Clang - Darwin with Clang
112 lines
4.9 KiB
C
112 lines
4.9 KiB
C
/*===-- llvm-c/Disassembler.h - Disassembler Public C Interface ---*- C -*-===*\
|
|
|* *|
|
|
|* Part of the LLVM Project, under the Apache License v2.0 with LLVM *|
|
|
|* Exceptions. *|
|
|
|* See https://llvm.org/LICENSE.txt for license information. *|
|
|
|* SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception *|
|
|
|* *|
|
|
|*===----------------------------------------------------------------------===*|
|
|
|* *|
|
|
|* This header provides a public interface to a disassembler library. *|
|
|
|* LLVM provides an implementation of this interface. *|
|
|
|* *|
|
|
\*===----------------------------------------------------------------------===*/
|
|
|
|
#ifndef LLVM_C_DISASSEMBLER_H
|
|
#define LLVM_C_DISASSEMBLER_H
|
|
|
|
#include "llvm-c/DisassemblerTypes.h"
|
|
#include "llvm-c/ExternC.h"
|
|
#include "llvm-c/Visibility.h"
|
|
|
|
/**
|
|
* @defgroup LLVMCDisassembler Disassembler
|
|
* @ingroup LLVMC
|
|
*
|
|
* @{
|
|
*/
|
|
|
|
LLVM_C_EXTERN_C_BEGIN
|
|
|
|
/**
|
|
* Create a disassembler for the TripleName. Symbolic disassembly is supported
|
|
* by passing a block of information in the DisInfo parameter and specifying the
|
|
* TagType and callback functions as described above. These can all be passed
|
|
* as NULL. If successful, this returns a disassembler context. If not, it
|
|
* returns NULL. This function is equivalent to calling
|
|
* LLVMCreateDisasmCPUFeatures() with an empty CPU name and feature set.
|
|
*/
|
|
LLVM_C_ABI LLVMDisasmContextRef LLVMCreateDisasm(
|
|
const char *TripleName, void *DisInfo, int TagType,
|
|
LLVMOpInfoCallback GetOpInfo, LLVMSymbolLookupCallback SymbolLookUp);
|
|
|
|
/**
|
|
* Create a disassembler for the TripleName and a specific CPU. Symbolic
|
|
* disassembly is supported by passing a block of information in the DisInfo
|
|
* parameter and specifying the TagType and callback functions as described
|
|
* above. These can all be passed * as NULL. If successful, this returns a
|
|
* disassembler context. If not, it returns NULL. This function is equivalent
|
|
* to calling LLVMCreateDisasmCPUFeatures() with an empty feature set.
|
|
*/
|
|
LLVM_C_ABI LLVMDisasmContextRef LLVMCreateDisasmCPU(
|
|
const char *Triple, const char *CPU, void *DisInfo, int TagType,
|
|
LLVMOpInfoCallback GetOpInfo, LLVMSymbolLookupCallback SymbolLookUp);
|
|
|
|
/**
|
|
* Create a disassembler for the TripleName, a specific CPU and specific feature
|
|
* string. Symbolic disassembly is supported by passing a block of information
|
|
* in the DisInfo parameter and specifying the TagType and callback functions as
|
|
* described above. These can all be passed * as NULL. If successful, this
|
|
* returns a disassembler context. If not, it returns NULL.
|
|
*/
|
|
LLVM_C_ABI LLVMDisasmContextRef LLVMCreateDisasmCPUFeatures(
|
|
const char *Triple, const char *CPU, const char *Features, void *DisInfo,
|
|
int TagType, LLVMOpInfoCallback GetOpInfo,
|
|
LLVMSymbolLookupCallback SymbolLookUp);
|
|
|
|
/**
|
|
* Set the disassembler's options. Returns 1 if it can set the Options and 0
|
|
* otherwise.
|
|
*/
|
|
LLVM_C_ABI int LLVMSetDisasmOptions(LLVMDisasmContextRef DC, uint64_t Options);
|
|
|
|
/* The option to produce marked up assembly. */
|
|
#define LLVMDisassembler_Option_UseMarkup 1
|
|
/* The option to print immediates as hex. */
|
|
#define LLVMDisassembler_Option_PrintImmHex 2
|
|
/* The option use the other assembler printer variant */
|
|
#define LLVMDisassembler_Option_AsmPrinterVariant 4
|
|
/* The option to set comment on instructions */
|
|
#define LLVMDisassembler_Option_SetInstrComments 8
|
|
/* The option to print latency information alongside instructions */
|
|
#define LLVMDisassembler_Option_PrintLatency 16
|
|
/* The option to print in color */
|
|
#define LLVMDisassembler_Option_Color 32
|
|
|
|
/**
|
|
* Dispose of a disassembler context.
|
|
*/
|
|
LLVM_C_ABI void LLVMDisasmDispose(LLVMDisasmContextRef DC);
|
|
|
|
/**
|
|
* Disassemble a single instruction using the disassembler context specified in
|
|
* the parameter DC. The bytes of the instruction are specified in the
|
|
* parameter Bytes, and contains at least BytesSize number of bytes. The
|
|
* instruction is at the address specified by the PC parameter. If a valid
|
|
* instruction can be disassembled, its string is returned indirectly in
|
|
* OutString whose size is specified in the parameter OutStringSize. This
|
|
* function returns the number of bytes in the instruction or zero if there was
|
|
* no valid instruction.
|
|
*/
|
|
LLVM_C_ABI size_t LLVMDisasmInstruction(LLVMDisasmContextRef DC, uint8_t *Bytes,
|
|
uint64_t BytesSize, uint64_t PC,
|
|
char *OutString, size_t OutStringSize);
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
LLVM_C_EXTERN_C_END
|
|
|
|
#endif /* LLVM_C_DISASSEMBLER_H */
|