[llvm] [llvm-c] Deprecate functions working on the global context (PR #163979)
via llvm-commits
llvm-commits at lists.llvm.org
Wed Oct 22 03:22:07 PDT 2025
llvmbot wrote:
<!--LLVM PR SUMMARY COMMENT-->
@llvm/pr-subscribers-llvm-ir
Author: Nikita Popov (nikic)
<details>
<summary>Changes</summary>
One of the most common mistakes when working with the LLVM C API is to mix functions that work on the global context and those that work on an explicit context. This often results in seemingly nonsensical errors because types from different contexts are mixed.
We have considered the APIs working on the global context to be obsolete for a long time already, and do not add any new APIs using the global context. However, the fact that these still exist (and have shorter names) continues to cause issues.
This PR proposes to deprecate these APIs, with intent to remove them at some point in the future.
RFC: https://discourse.llvm.org/t/rfc-deprecate-c-api-functions-using-the-global-context/88639
---
Patch is 67.52 KiB, truncated to 20.00 KiB below, full version: https://github.com/llvm/llvm-project/pull/163979.diff
24 Files Affected:
- (modified) llvm/bindings/ocaml/llvm/llvm_ocaml.c (+3-1)
- (modified) llvm/docs/ReleaseNotes.md (+35)
- (modified) llvm/examples/OrcV2Examples/OrcV2CBindingsAddObjectFile/OrcV2CBindingsAddObjectFile.c (+6-5)
- (modified) llvm/examples/OrcV2Examples/OrcV2CBindingsBasicUsage/OrcV2CBindingsBasicUsage.c (+6-5)
- (modified) llvm/examples/OrcV2Examples/OrcV2CBindingsDumpObjects/OrcV2CBindingsDumpObjects.c (+6-5)
- (modified) llvm/examples/OrcV2Examples/OrcV2CBindingsIRTransforms/OrcV2CBindingsIRTransforms.c (+6-5)
- (modified) llvm/examples/OrcV2Examples/OrcV2CBindingsMCJITLikeMemoryManager/OrcV2CBindingsMCJITLikeMemoryManager.c (+6-5)
- (modified) llvm/examples/OrcV2Examples/OrcV2CBindingsRemovableCode/OrcV2CBindingsRemovableCode.c (+6-5)
- (modified) llvm/include/llvm-c/BitReader.h (+22-11)
- (modified) llvm/include/llvm-c/Core.h (+117-33)
- (modified) llvm/include/llvm-c/Target.h (+9-2)
- (modified) llvm/include/llvm/IR/LLVMContext.h (+3)
- (modified) llvm/lib/Bitcode/Reader/BitReader.cpp (+6-4)
- (modified) llvm/lib/IR/Core.cpp (+32-28)
- (modified) llvm/lib/Target/Target.cpp (+3-5)
- (modified) llvm/tools/llvm-c-test/attributes.c (+6-2)
- (modified) llvm/tools/llvm-c-test/calc.c (+11-6)
- (modified) llvm/tools/llvm-c-test/debuginfo.c (+39-33)
- (modified) llvm/tools/llvm-c-test/diagnostic.c (+3-2)
- (modified) llvm/tools/llvm-c-test/echo.cpp (+5-3)
- (modified) llvm/tools/llvm-c-test/metadata.c (+21-13)
- (modified) llvm/tools/llvm-c-test/module.c (+9-3)
- (modified) llvm/tools/llvm-c-test/object.c (+6-4)
- (modified) llvm/unittests/ExecutionEngine/MCJIT/MCJITCAPITest.cpp (+68-54)
``````````diff
diff --git a/llvm/bindings/ocaml/llvm/llvm_ocaml.c b/llvm/bindings/ocaml/llvm/llvm_ocaml.c
index 472519ccfab30..53158c88be19c 100644
--- a/llvm/bindings/ocaml/llvm/llvm_ocaml.c
+++ b/llvm/bindings/ocaml/llvm/llvm_ocaml.c
@@ -239,7 +239,9 @@ value llvm_dispose_context(value C) {
}
/* unit -> llcontext */
-value llvm_global_context(value Unit) { return to_val(LLVMGetGlobalContext()); }
+value llvm_global_context(value Unit) {
+ return to_val(getGlobalContextForCAPI());
+}
/* llcontext -> string -> int */
value llvm_mdkind_id(value C, value Name) {
diff --git a/llvm/docs/ReleaseNotes.md b/llvm/docs/ReleaseNotes.md
index 754cd409f83eb..f069b5bead848 100644
--- a/llvm/docs/ReleaseNotes.md
+++ b/llvm/docs/ReleaseNotes.md
@@ -157,6 +157,41 @@ Changes to the C API
* Add `LLVMGetOrInsertFunction` to get or insert a function, replacing the combination of `LLVMGetNamedFunction` and `LLVMAddFunction`.
* Allow `LLVMGetVolatile` to work with any kind of Instruction.
+* Functions working on the global context have been deprecated. Use the
+ functions that work on a specific context instead.
+
+ * `LLVMGetGlobalContext` -> use `LLVMContextCreate` context instead
+ * `LLVMInt1Type` -> `LLVMInt1TypeInContext`
+ * `LLVMInt8Type` -> `LLVMInt8TypeInContext`
+ * `LLVMInt16Type` -> `LLVMInt16TypeInContext`
+ * `LLVMInt32Type` -> `LLVMInt32TypeInContext`
+ * `LLVMInt64Type` -> `LLVMInt64TypeInContext`
+ * `LLVMInt128Type` -> `LLVMInt128TypeInContext`
+ * `LLVMIntType` -> `LLVMIntTypeInContext`
+ * `LLVMHalfType` -> `LLVMHalfTypeInContext`
+ * `LLVMBFloatType` -> `LLVMBFloatTypeInContext`
+ * `LLVMFloatType` -> `LLVMFloatTypeInContext`
+ * `LLVMDoubleType` -> `LLVMDoubleTypeInContext`
+ * `LLVMX86FP80Type` -> `LLVMX86FP80TypeInContext`
+ * `LLVMFP128Type` -> `LLVMFP128TypeInContext`
+ * `LLVMPPCFP128Type` -> `LLVMPPCFP128TypeInContext`
+ * `LLVMStructType` -> `LLVMStructTypeInContext`
+ * `LLVMVoidType` -> `LLVMVoidTypeInContext`
+ * `LLVMLabelType` -> `LLVMLabelTypeInContext`
+ * `LLVMX86AMXType` -> `LLVMX86AMXTypeInContext`
+ * `LLVMConstString` -> `LLVMConstStringInContext2`
+ * `LLVMConstStruct` -> `LLVMConstStructInContext`
+ * `LLVMMDString` -> `LLVMMDStringInContext2`
+ * `LLVMMDNode` -> `LLVMMDNodeInContext2`
+ * `LLVMAppendBasicBlock` -> `LLVMAppendBasicBlockInContext`
+ * `LLVMInsertBasicBlock` -> `LLVMInsertBasicBlockInContext`
+ * `LLVMCreateBuilder` -> `LLVMCreateBuilderInContext`
+ * `LLVMIntPtrType` -> `LLVMIntPtrTypeInContext`
+ * `LLVMIntPtrTypeForAS` -> `LLVMIntPtrTypeForASInContext`
+ * `LLVMParseBitcode` -> `LLVMParseBitcodeInContext2`
+ * `LLVMParseBitcode2` -> `LLVMParseBitcodeInContext2`
+ * `LLVMGetBitcodeModule` -> `LLVMGetBitcodeModuleInContext2`
+ * `LLVMGetBitcodeModule2` -> `LLVMGetBitcodeModuleInContext2`
Changes to the CodeGen infrastructure
-------------------------------------
diff --git a/llvm/examples/OrcV2Examples/OrcV2CBindingsAddObjectFile/OrcV2CBindingsAddObjectFile.c b/llvm/examples/OrcV2Examples/OrcV2CBindingsAddObjectFile/OrcV2CBindingsAddObjectFile.c
index b51fc930c4318..7c2446709018a 100644
--- a/llvm/examples/OrcV2Examples/OrcV2CBindingsAddObjectFile/OrcV2CBindingsAddObjectFile.c
+++ b/llvm/examples/OrcV2Examples/OrcV2CBindingsAddObjectFile/OrcV2CBindingsAddObjectFile.c
@@ -28,16 +28,17 @@ LLVMModuleRef createDemoModule(LLVMContextRef Ctx) {
// Add a "sum" function":
// - Create the function type and function instance.
- LLVMTypeRef ParamTypes[] = {LLVMInt32Type(), LLVMInt32Type()};
- LLVMTypeRef SumFunctionType =
- LLVMFunctionType(LLVMInt32Type(), ParamTypes, 2, 0);
+ LLVMTypeRef Int32Type = LLVMInt32TypeInContext(Ctx);
+ LLVMTypeRef ParamTypes[] = {Int32Type, Int32Type};
+ LLVMTypeRef SumFunctionType = LLVMFunctionType(Int32Type, ParamTypes, 2, 0);
LLVMValueRef SumFunction = LLVMAddFunction(M, "sum", SumFunctionType);
// - Add a basic block to the function.
- LLVMBasicBlockRef EntryBB = LLVMAppendBasicBlock(SumFunction, "entry");
+ LLVMBasicBlockRef EntryBB =
+ LLVMAppendBasicBlockInContext(Ctx, SumFunction, "entry");
// - Add an IR builder and point it at the end of the basic block.
- LLVMBuilderRef Builder = LLVMCreateBuilder();
+ LLVMBuilderRef Builder = LLVMCreateBuilderInContext(Ctx);
LLVMPositionBuilderAtEnd(Builder, EntryBB);
// - Get the two function arguments and use them co construct an "add"
diff --git a/llvm/examples/OrcV2Examples/OrcV2CBindingsBasicUsage/OrcV2CBindingsBasicUsage.c b/llvm/examples/OrcV2Examples/OrcV2CBindingsBasicUsage/OrcV2CBindingsBasicUsage.c
index 30806dc8d29e8..ae8362a18d361 100644
--- a/llvm/examples/OrcV2Examples/OrcV2CBindingsBasicUsage/OrcV2CBindingsBasicUsage.c
+++ b/llvm/examples/OrcV2Examples/OrcV2CBindingsBasicUsage/OrcV2CBindingsBasicUsage.c
@@ -30,16 +30,17 @@ LLVMOrcThreadSafeModuleRef createDemoModule(void) {
// Add a "sum" function":
// - Create the function type and function instance.
- LLVMTypeRef ParamTypes[] = {LLVMInt32Type(), LLVMInt32Type()};
- LLVMTypeRef SumFunctionType =
- LLVMFunctionType(LLVMInt32Type(), ParamTypes, 2, 0);
+ LLVMTypeRef Int32Type = LLVMInt32TypeInContext(Ctx);
+ LLVMTypeRef ParamTypes[] = {Int32Type, Int32Type};
+ LLVMTypeRef SumFunctionType = LLVMFunctionType(Int32Type, ParamTypes, 2, 0);
LLVMValueRef SumFunction = LLVMAddFunction(M, "sum", SumFunctionType);
// - Add a basic block to the function.
- LLVMBasicBlockRef EntryBB = LLVMAppendBasicBlock(SumFunction, "entry");
+ LLVMBasicBlockRef EntryBB =
+ LLVMAppendBasicBlockInContext(Ctx, SumFunction, "entry");
// - Add an IR builder and point it at the end of the basic block.
- LLVMBuilderRef Builder = LLVMCreateBuilder();
+ LLVMBuilderRef Builder = LLVMCreateBuilderInContext(Ctx);
LLVMPositionBuilderAtEnd(Builder, EntryBB);
// - Get the two function arguments and use them co construct an "add"
diff --git a/llvm/examples/OrcV2Examples/OrcV2CBindingsDumpObjects/OrcV2CBindingsDumpObjects.c b/llvm/examples/OrcV2Examples/OrcV2CBindingsDumpObjects/OrcV2CBindingsDumpObjects.c
index 42a27c7054d47..07491c697cfd1 100644
--- a/llvm/examples/OrcV2Examples/OrcV2CBindingsDumpObjects/OrcV2CBindingsDumpObjects.c
+++ b/llvm/examples/OrcV2Examples/OrcV2CBindingsDumpObjects/OrcV2CBindingsDumpObjects.c
@@ -33,12 +33,13 @@ int handleError(LLVMErrorRef Err) {
LLVMOrcThreadSafeModuleRef createDemoModule(void) {
LLVMContextRef Ctx = LLVMContextCreate();
LLVMModuleRef M = LLVMModuleCreateWithNameInContext("demo", Ctx);
- LLVMTypeRef ParamTypes[] = {LLVMInt32Type(), LLVMInt32Type()};
- LLVMTypeRef SumFunctionType =
- LLVMFunctionType(LLVMInt32Type(), ParamTypes, 2, 0);
+ LLVMTypeRef Int32Type = LLVMInt32TypeInContext(Ctx);
+ LLVMTypeRef ParamTypes[] = {Int32Type, Int32Type};
+ LLVMTypeRef SumFunctionType = LLVMFunctionType(Int32Type, ParamTypes, 2, 0);
LLVMValueRef SumFunction = LLVMAddFunction(M, "sum", SumFunctionType);
- LLVMBasicBlockRef EntryBB = LLVMAppendBasicBlock(SumFunction, "entry");
- LLVMBuilderRef Builder = LLVMCreateBuilder();
+ LLVMBasicBlockRef EntryBB =
+ LLVMAppendBasicBlockInContext(Ctx, SumFunction, "entry");
+ LLVMBuilderRef Builder = LLVMCreateBuilderInContext(Ctx);
LLVMPositionBuilderAtEnd(Builder, EntryBB);
LLVMValueRef SumArg0 = LLVMGetParam(SumFunction, 0);
LLVMValueRef SumArg1 = LLVMGetParam(SumFunction, 1);
diff --git a/llvm/examples/OrcV2Examples/OrcV2CBindingsIRTransforms/OrcV2CBindingsIRTransforms.c b/llvm/examples/OrcV2Examples/OrcV2CBindingsIRTransforms/OrcV2CBindingsIRTransforms.c
index 7e4d2387cb14e..d2d800389c7a5 100644
--- a/llvm/examples/OrcV2Examples/OrcV2CBindingsIRTransforms/OrcV2CBindingsIRTransforms.c
+++ b/llvm/examples/OrcV2Examples/OrcV2CBindingsIRTransforms/OrcV2CBindingsIRTransforms.c
@@ -34,12 +34,13 @@ int handleError(LLVMErrorRef Err) {
LLVMOrcThreadSafeModuleRef createDemoModule(void) {
LLVMContextRef Ctx = LLVMContextCreate();
LLVMModuleRef M = LLVMModuleCreateWithNameInContext("demo", Ctx);
- LLVMTypeRef ParamTypes[] = {LLVMInt32Type(), LLVMInt32Type()};
- LLVMTypeRef SumFunctionType =
- LLVMFunctionType(LLVMInt32Type(), ParamTypes, 2, 0);
+ LLVMTypeRef Int32Type = LLVMInt32TypeInContext(Ctx);
+ LLVMTypeRef ParamTypes[] = {Int32Type, Int32Type};
+ LLVMTypeRef SumFunctionType = LLVMFunctionType(Int32Type, ParamTypes, 2, 0);
LLVMValueRef SumFunction = LLVMAddFunction(M, "sum", SumFunctionType);
- LLVMBasicBlockRef EntryBB = LLVMAppendBasicBlock(SumFunction, "entry");
- LLVMBuilderRef Builder = LLVMCreateBuilder();
+ LLVMBasicBlockRef EntryBB =
+ LLVMAppendBasicBlockInContext(Ctx, SumFunction, "entry");
+ LLVMBuilderRef Builder = LLVMCreateBuilderInContext(Ctx);
LLVMPositionBuilderAtEnd(Builder, EntryBB);
LLVMValueRef SumArg0 = LLVMGetParam(SumFunction, 0);
LLVMValueRef SumArg1 = LLVMGetParam(SumFunction, 1);
diff --git a/llvm/examples/OrcV2Examples/OrcV2CBindingsMCJITLikeMemoryManager/OrcV2CBindingsMCJITLikeMemoryManager.c b/llvm/examples/OrcV2Examples/OrcV2CBindingsMCJITLikeMemoryManager/OrcV2CBindingsMCJITLikeMemoryManager.c
index 6962c6980e787..f15a1145586af 100644
--- a/llvm/examples/OrcV2Examples/OrcV2CBindingsMCJITLikeMemoryManager/OrcV2CBindingsMCJITLikeMemoryManager.c
+++ b/llvm/examples/OrcV2Examples/OrcV2CBindingsMCJITLikeMemoryManager/OrcV2CBindingsMCJITLikeMemoryManager.c
@@ -158,16 +158,17 @@ LLVMOrcThreadSafeModuleRef createDemoModule(void) {
// Add a "sum" function":
// - Create the function type and function instance.
- LLVMTypeRef ParamTypes[] = {LLVMInt32Type(), LLVMInt32Type()};
- LLVMTypeRef SumFunctionType =
- LLVMFunctionType(LLVMInt32Type(), ParamTypes, 2, 0);
+ LLVMTypeRef Int32Type = LLVMInt32TypeInContext(Ctx);
+ LLVMTypeRef ParamTypes[] = {Int32Type, Int32Type};
+ LLVMTypeRef SumFunctionType = LLVMFunctionType(Int32Type, ParamTypes, 2, 0);
LLVMValueRef SumFunction = LLVMAddFunction(M, "sum", SumFunctionType);
// - Add a basic block to the function.
- LLVMBasicBlockRef EntryBB = LLVMAppendBasicBlock(SumFunction, "entry");
+ LLVMBasicBlockRef EntryBB =
+ LLVMAppendBasicBlockInContext(Ctx, SumFunction, "entry");
// - Add an IR builder and point it at the end of the basic block.
- LLVMBuilderRef Builder = LLVMCreateBuilder();
+ LLVMBuilderRef Builder = LLVMCreateBuilderInContext(Ctx);
LLVMPositionBuilderAtEnd(Builder, EntryBB);
// - Get the two function arguments and use them co construct an "add"
diff --git a/llvm/examples/OrcV2Examples/OrcV2CBindingsRemovableCode/OrcV2CBindingsRemovableCode.c b/llvm/examples/OrcV2Examples/OrcV2CBindingsRemovableCode/OrcV2CBindingsRemovableCode.c
index 7f8a9cd334c6b..2d3e334b6a8ce 100644
--- a/llvm/examples/OrcV2Examples/OrcV2CBindingsRemovableCode/OrcV2CBindingsRemovableCode.c
+++ b/llvm/examples/OrcV2Examples/OrcV2CBindingsRemovableCode/OrcV2CBindingsRemovableCode.c
@@ -30,16 +30,17 @@ LLVMOrcThreadSafeModuleRef createDemoModule(void) {
// Add a "sum" function":
// - Create the function type and function instance.
- LLVMTypeRef ParamTypes[] = {LLVMInt32Type(), LLVMInt32Type()};
- LLVMTypeRef SumFunctionType =
- LLVMFunctionType(LLVMInt32Type(), ParamTypes, 2, 0);
+ LLVMTypeRef Int32Type = LLVMInt32TypeInContext(Ctx);
+ LLVMTypeRef ParamTypes[] = {Int32Type, Int32Type};
+ LLVMTypeRef SumFunctionType = LLVMFunctionType(Int32Type, ParamTypes, 2, 0);
LLVMValueRef SumFunction = LLVMAddFunction(M, "sum", SumFunctionType);
// - Add a basic block to the function.
- LLVMBasicBlockRef EntryBB = LLVMAppendBasicBlock(SumFunction, "entry");
+ LLVMBasicBlockRef EntryBB =
+ LLVMAppendBasicBlockInContext(Ctx, SumFunction, "entry");
// - Add an IR builder and point it at the end of the basic block.
- LLVMBuilderRef Builder = LLVMCreateBuilder();
+ LLVMBuilderRef Builder = LLVMCreateBuilderInContext(Ctx);
LLVMPositionBuilderAtEnd(Builder, EntryBB);
// - Get the two function arguments and use them co construct an "add"
diff --git a/llvm/include/llvm-c/BitReader.h b/llvm/include/llvm-c/BitReader.h
index 9dcdbf436454f..c38c3ce3e01b2 100644
--- a/llvm/include/llvm-c/BitReader.h
+++ b/llvm/include/llvm-c/BitReader.h
@@ -19,6 +19,7 @@
#ifndef LLVM_C_BITREADER_H
#define LLVM_C_BITREADER_H
+#include "llvm-c/Deprecated.h"
#include "llvm-c/ExternC.h"
#include "llvm-c/Types.h"
#include "llvm-c/Visibility.h"
@@ -37,14 +38,19 @@ LLVM_C_EXTERN_C_BEGIN
Optionally returns a human-readable error message via OutMessage.
This is deprecated. Use LLVMParseBitcode2. */
-LLVM_C_ABI LLVMBool LLVMParseBitcode(LLVMMemoryBufferRef MemBuf,
- LLVMModuleRef *OutModule,
- char **OutMessage);
+LLVM_C_ABI LLVM_ATTRIBUTE_C_DEPRECATED(
+ LLVMBool LLVMParseBitcode(LLVMMemoryBufferRef MemBuf,
+ LLVMModuleRef *OutModule, char **OutMessage),
+ "Use of the global context is deprecated, use LLVMParseBitcodeInContext2 "
+ "instead");
/* Builds a module from the bitcode in the specified memory buffer, returning a
reference to the module via the OutModule parameter. Returns 0 on success. */
-LLVM_C_ABI LLVMBool LLVMParseBitcode2(LLVMMemoryBufferRef MemBuf,
- LLVMModuleRef *OutModule);
+LLVM_C_ABI LLVM_ATTRIBUTE_C_DEPRECATED(
+ LLVMBool LLVMParseBitcode2(LLVMMemoryBufferRef MemBuf,
+ LLVMModuleRef *OutModule),
+ "Use of the global context is deprecated, use LLVMParseBitcodeInContext2 "
+ "instead");
/* This is deprecated. Use LLVMParseBitcodeInContext2. */
LLVM_C_ABI LLVMBool LLVMParseBitcodeInContext(LLVMContextRef ContextRef,
@@ -77,12 +83,17 @@ LLVM_C_ABI LLVMBool LLVMGetBitcodeModuleInContext2(LLVMContextRef ContextRef,
LLVMModuleRef *OutM);
/* This is deprecated. Use LLVMGetBitcodeModule2. */
-LLVM_C_ABI LLVMBool LLVMGetBitcodeModule(LLVMMemoryBufferRef MemBuf,
- LLVMModuleRef *OutM,
- char **OutMessage);
-
-LLVM_C_ABI LLVMBool LLVMGetBitcodeModule2(LLVMMemoryBufferRef MemBuf,
- LLVMModuleRef *OutM);
+LLVM_C_ABI LLVM_ATTRIBUTE_C_DEPRECATED(
+ LLVMBool LLVMGetBitcodeModule(LLVMMemoryBufferRef MemBuf,
+ LLVMModuleRef *OutM, char **OutMessage),
+ "Use of the global context is deprecated, use "
+ "LLVMGetBitcodeModuleInContext2 instead");
+
+LLVM_C_ABI LLVM_ATTRIBUTE_C_DEPRECATED(
+ LLVMBool LLVMGetBitcodeModule2(LLVMMemoryBufferRef MemBuf,
+ LLVMModuleRef *OutM),
+ "Use of the global context is deprecated, use "
+ "LLVMGetBitcodeModuleInContext2 instead");
/**
* @}
diff --git a/llvm/include/llvm-c/Core.h b/llvm/include/llvm-c/Core.h
index 4e380d9bd5969..aa5c78c0a7686 100644
--- a/llvm/include/llvm-c/Core.h
+++ b/llvm/include/llvm-c/Core.h
@@ -582,7 +582,10 @@ LLVM_C_ABI LLVMContextRef LLVMContextCreate(void);
/**
* Obtain the global context instance.
*/
-LLVM_C_ABI LLVMContextRef LLVMGetGlobalContext(void);
+LLVM_C_ABI
+LLVM_ATTRIBUTE_C_DEPRECATED(LLVMContextRef LLVMGetGlobalContext(void),
+ "Use of the global context is deprecated, create "
+ "one using LLVMContextCreate instead");
/**
* Set the diagnostic handler for this context.
@@ -655,7 +658,10 @@ LLVMGetDiagInfoSeverity(LLVMDiagnosticInfoRef DI);
LLVM_C_ABI unsigned LLVMGetMDKindIDInContext(LLVMContextRef C, const char *Name,
unsigned SLen);
-LLVM_C_ABI unsigned LLVMGetMDKindID(const char *Name, unsigned SLen);
+LLVM_C_ABI LLVM_ATTRIBUTE_C_DEPRECATED(
+ unsigned LLVMGetMDKindID(const char *Name, unsigned SLen),
+ "Use of the global context is deprecated, use LLVMGetMDKindIDInContext "
+ "instead");
/**
* Maps a synchronization scope name to a ID unique within this context.
@@ -774,7 +780,10 @@ LLVM_C_ABI LLVMTypeRef LLVMGetTypeByName2(LLVMContextRef C, const char *Name);
* Every invocation should be paired with LLVMDisposeModule() or memory
* will be leaked.
*/
-LLVM_C_ABI LLVMModuleRef LLVMModuleCreateWithName(const char *ModuleID);
+LLVM_C_ABI LLVM_ATTRIBUTE_C_DEPRECATED(
+ LLVMModuleRef LLVMModuleCreateWithName(const char *ModuleID),
+ "Use of the global context is deprecated, use "
+ "LLVMModuleCreateWithNameInContext instead");
/**
* Create a new, empty module in a specific context.
@@ -1369,13 +1378,35 @@ LLVM_C_ABI LLVMTypeRef LLVMIntTypeInContext(LLVMContextRef C, unsigned NumBits);
* Obtain an integer type from the global context with a specified bit
* width.
*/
-LLVM_C_ABI LLVMTypeRef LLVMInt1Type(void);
-LLVM_C_ABI LLVMTypeRef LLVMInt8Type(void);
-LLVM_C_ABI LLVMTypeRef LLVMInt16Type(void);
-LLVM_C_ABI LLVMTypeRef LLVMInt32Type(void);
-LLVM_C_ABI LLVMTypeRef LLVMInt64Type(void);
-LLVM_C_ABI LLVMTypeRef LLVMInt128Type(void);
-LLVM_C_ABI LLVMTypeRef LLVMIntType(unsigned NumBits);
+LLVM_C_ABI
+LLVM_ATTRIBUTE_C_DEPRECATED(LLVMTypeRef LLVMInt1Type(void),
+ "Use of the global context is deprecated, use "
+ "LLVMInt1TypeInContext instead");
+LLVM_C_ABI
+LLVM_ATTRIBUTE_C_DEPRECATED(LLVMTypeRef LLVMInt8Type(void),
+ "Use of the global context is deprecated, use "
+ "LLVMInt8TypeInContext instead");
+LLVM_C_ABI
+LLVM_ATTRIBUTE_C_DEPRECATED(LLVMTypeRef LLVMInt16Type(void),
+ "Use of the global context is deprecated, use "
+ "LLVMInt16TypeInContext instead");
+LLVM_C_ABI
+LLVM_ATTRIBUTE_C_DEPRECATED(LLVMTypeRef LLVMInt32Type(void),
+ "Use of the global context is deprecated, use "
+ "LLVMInt32TypeInContext instead");
+LLVM_C_ABI
+LLVM_ATTRIBUTE_C_DEPRECATED(LLVMTypeRef LLVMInt64Type(void),
+ "Use of the global context is deprecated, use "
+ "LLVMInt64TypeInContext instead");
+LLVM_C_ABI
+LLVM_ATTRIBUTE_C_DEPRECATED(LLVMTypeRef LLVMInt128Type(void),
+ "Use of the global context is deprecated, use "
+ "LLVMInt128TypeInContext instead");
+LLVM_C_ABI
+LLVM_ATTRIBUTE_C_DEPRECATED(LLVMTypeRef LLVMIntType(unsigned NumBits),
+ "Use of the global context is deprecated, use "
+ "LLVMIntTypeInContext instead");
+
LLVM_C_ABI unsigned LLVMGetIntTypeWidth(LLVMTypeRef IntegerTy);
/**
@@ -1429,13 +1460,34 @@ LLVM_C_ABI LLVMTypeRef LLVMPPCFP128TypeInContext(LLVMContextRef C);
*
* These map to the functions in this group of the same name.
*/
-LLVM_C_ABI LLVMTypeRef LLVMHalfType(void);
-LLVM_C_ABI LLVMTypeRef LLVMBFloatType(void);
-LLVM_C_ABI LLVMTypeRef LLVMFloatType(void);
-LLVM_C_ABI LLVMTypeRef LLVMDoubleType(void);
-LLVM_C_ABI LLVMTypeRef LLVMX86FP80Type(void);
-LLVM_C_ABI LLVMTypeRef LLVMFP128Type(void);
-LLVM_C_ABI LLVMTypeRef LLVMPPCFP128Type(void);
+LLVM_C_ABI
+LLVM_ATTRIBUTE_C_DEPRECATED(LLVMTypeRef LLVMHalfType(void),
+ "Use of the global context is deprecated, use "
+ "LLVMHalfTypeInContext instead");
+LLVM_C_ABI
+LLVM_ATTRIBUTE_C_DEPRECATED(LLVMTypeRef LLVMBFloatType(void),
+ "Use of the global context is deprecated, use "
+ "LLVMBFloatTypeInContext instead");
+LLVM_C_ABI
+LLVM_ATTRIBUTE_C_DEPRECATED(LLVMTypeRef LLVMFloatType(void),
+ "Use of the global context is deprecated, use "
+ "LLVMFloatTypeInContext instead");
+LLVM_C_ABI
+LLVM_ATTRIBUTE_C_DEPRECATED(LLVMTypeRef LLVMDoubleType(void),
+ "Use of the global context is deprecated, use "
+ "LLVMDoubleTypeInContext instead");
+LLVM_C_ABI
+LLVM_ATTRIBUTE_C_DEPRECATED(LLVMTypeRef LLVMX86FP80Type(void),
+ "Use of the global context is deprecated, use "
+ "LLVMX86FP80TypeInContext instead");
+LLVM_C_ABI
+LLVM_ATTRIBUTE_C_DEPRECATED(LLVMTypeRef LLVMFP128Type(void),
+ "Use of the global context is deprecated, use "
+ "LLVMFP128TypeInContext instead");
+LLVM_C_ABI
+LLVM...
[truncated]
``````````
</details>
https://github.com/llvm/llvm-project/pull/163979
More information about the llvm-commits
mailing list