e39ddab2bc
This new function is the same as LLVMParseIRInContext except it doesn't take ownership of the memory buffer. This fixes a wart that has been in place since 5ebb7b311223bcd21d2b3d25413d1edacefcc63d changed the underlying internal API to avoid taking ownership. Reduce nesting in the implementation of LLVMParseIRInContext (now LLVMParseIRInContext2) as well. Update examples, OCaml bindings, and tests including plugging some pre-existing memory leaks. OCaml bindings have renamed `parse_ir` to `parse_ir_bitcode_or_assembly` to provoke compilation failures in downstream code; this is intentional as this function now requires the memory buffer to be disposed by the caller.
68 lines
2.6 KiB
C
68 lines
2.6 KiB
C
/*===-- llvm-c/IRReader.h - IR Reader 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 file defines the C interface to the IR Reader. *|
|
|
|* *|
|
|
\*===----------------------------------------------------------------------===*/
|
|
|
|
#ifndef LLVM_C_IRREADER_H
|
|
#define LLVM_C_IRREADER_H
|
|
|
|
#include "llvm-c/ExternC.h"
|
|
#include "llvm-c/Types.h"
|
|
#include "llvm-c/Visibility.h"
|
|
|
|
LLVM_C_EXTERN_C_BEGIN
|
|
|
|
/**
|
|
* @defgroup LLVMCCoreIRReader IR Reader
|
|
* @ingroup LLVMCCore
|
|
*
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* Read LLVM IR from a memory buffer and convert it into an in-memory Module
|
|
* object. Returns 0 on success.
|
|
* Optionally returns a human-readable description of any errors that
|
|
* occurred during parsing IR. OutMessage must be disposed with
|
|
* LLVMDisposeMessage.
|
|
* The memory buffer is consumed by this function.
|
|
* This is deprecated. Use LLVMParseIRInContext2 instead.
|
|
*
|
|
* @see llvm::ParseIR()
|
|
*/
|
|
LLVM_C_ABI LLVMBool LLVMParseIRInContext(LLVMContextRef ContextRef,
|
|
LLVMMemoryBufferRef MemBuf,
|
|
LLVMModuleRef *OutM,
|
|
char **OutMessage);
|
|
/**
|
|
* Read LLVM IR from a memory buffer and convert it into an in-memory Module
|
|
* object. Returns 0 on success.
|
|
* Optionally returns a human-readable description of any errors that
|
|
* occurred during parsing IR. OutMessage must be disposed with
|
|
* LLVMDisposeMessage.
|
|
* The memory buffer is not consumed by this function. It is the responsibility
|
|
* of the caller to free it with \c LLVMDisposeMemoryBuffer.
|
|
*
|
|
* @see llvm::ParseIR()
|
|
*/
|
|
LLVM_C_ABI LLVMBool LLVMParseIRInContext2(LLVMContextRef ContextRef,
|
|
LLVMMemoryBufferRef MemBuf,
|
|
LLVMModuleRef *OutM,
|
|
char **OutMessage);
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
LLVM_C_EXTERN_C_END
|
|
|
|
#endif
|