[clang] [clang-repl] Handle mllvm args for clang-repl before calling executeAction (PR #197133)
Anutosh Bhat via cfe-commits
cfe-commits at lists.llvm.org
Tue May 12 02:30:06 PDT 2026
https://github.com/anutosh491 updated https://github.com/llvm/llvm-project/pull/197133
>From 707120c326feb3ae99be02863e21cf7efeef58b9 Mon Sep 17 00:00:00 2001
From: anutosh491 <andersonbhat491 at gmail.com>
Date: Tue, 12 May 2026 14:22:33 +0530
Subject: [PATCH 1/2] Handle -mllvm args for clang-repl before calling
executeAction
---
clang/include/clang/Frontend/CompilerInstance.h | 5 +++++
.../clang/Interpreter/IncrementalExecutor.h | 3 +++
clang/lib/Frontend/CompilerInstance.cpp | 14 ++++++++++++++
.../FrontendTool/ExecuteCompilerInvocation.cpp | 16 +---------------
clang/lib/Interpreter/IncrementalExecutor.cpp | 2 +-
clang/lib/Interpreter/Interpreter.cpp | 7 +++++++
clang/lib/Interpreter/Wasm.cpp | 17 ++++++++++++++++-
clang/lib/Interpreter/Wasm.h | 5 ++++-
clang/unittests/Interpreter/CMakeLists.txt | 1 +
clang/unittests/Interpreter/InterpreterTest.cpp | 16 ++++++++++++++++
.../Interpreter/InterpreterTestFixture.h | 12 +++++++++++-
11 files changed, 79 insertions(+), 19 deletions(-)
diff --git a/clang/include/clang/Frontend/CompilerInstance.h b/clang/include/clang/Frontend/CompilerInstance.h
index bce9ff421ec87..6502c22e9dd83 100644
--- a/clang/include/clang/Frontend/CompilerInstance.h
+++ b/clang/include/clang/Frontend/CompilerInstance.h
@@ -259,6 +259,11 @@ class CompilerInstance : public ModuleLoader {
/// Load the list of plugins requested in the \c FrontendOptions.
void LoadRequestedPlugins();
+ /// Parse and apply LLVM command line arguments from FrontendOptions.
+ /// This processes the LLVMArgs option that comes from -mllvm flags.
+ /// This should be called after plugins are loaded and before ExecuteAction.
+ void parseLLVMArgs();
+
/// @}
/// @name Compiler Invocation and Options
/// @{
diff --git a/clang/include/clang/Interpreter/IncrementalExecutor.h b/clang/include/clang/Interpreter/IncrementalExecutor.h
index 0e879efa0b55f..a293978b2917b 100644
--- a/clang/include/clang/Interpreter/IncrementalExecutor.h
+++ b/clang/include/clang/Interpreter/IncrementalExecutor.h
@@ -52,6 +52,9 @@ class IncrementalExecutorBuilder {
std::optional<llvm::CodeModel::Model> CM = std::nullopt;
/// An optional external IncrementalExecutor
std::unique_ptr<IncrementalExecutor> IE;
+ /// mllvm args from the frontend; on wasm these are re-applied after each
+ /// lldMain call because lld resets all cl options for test-isolation purposes.
+ std::vector<std::string> LLVMArgs;
/// An optional external orc jit builder
std::unique_ptr<llvm::orc::LLJITBuilder> JITBuilder;
/// A default callback that can be used in the IncrementalCompilerBuilder to
diff --git a/clang/lib/Frontend/CompilerInstance.cpp b/clang/lib/Frontend/CompilerInstance.cpp
index 91eda7392784f..52357fd86a3b4 100644
--- a/clang/lib/Frontend/CompilerInstance.cpp
+++ b/clang/lib/Frontend/CompilerInstance.cpp
@@ -1108,6 +1108,20 @@ void CompilerInstance::LoadRequestedPlugins() {
}
}
+void CompilerInstance::parseLLVMArgs() {
+ if (!getFrontendOpts().LLVMArgs.empty()) {
+ unsigned NumArgs = getFrontendOpts().LLVMArgs.size();
+ auto Args = std::make_unique<const char *[]>(NumArgs + 2);
+ Args[0] = "clang (LLVM option parsing)";
+ for (unsigned i = 0; i != NumArgs; ++i)
+ Args[i + 1] = getFrontendOpts().LLVMArgs[i].c_str();
+ Args[NumArgs + 1] = nullptr;
+ llvm::cl::ParseCommandLineOptions(NumArgs + 1, Args.get(), /*Overview=*/"",
+ /*Errs=*/nullptr,
+ /*VFS=*/&getVirtualFileSystem());
+ }
+}
+
/// Determine the appropriate source input kind based on language
/// options.
static Language getLanguageFromOptions(const LangOptions &LangOpts) {
diff --git a/clang/lib/FrontendTool/ExecuteCompilerInvocation.cpp b/clang/lib/FrontendTool/ExecuteCompilerInvocation.cpp
index e4622496758ac..7ecf356f15641 100644
--- a/clang/lib/FrontendTool/ExecuteCompilerInvocation.cpp
+++ b/clang/lib/FrontendTool/ExecuteCompilerInvocation.cpp
@@ -239,21 +239,7 @@ bool ExecuteCompilerInvocation(CompilerInstance *Clang) {
Clang->LoadRequestedPlugins();
- // Honor -mllvm.
- //
- // FIXME: Remove this, one day.
- // This should happen AFTER plugins have been loaded!
- if (!Clang->getFrontendOpts().LLVMArgs.empty()) {
- unsigned NumArgs = Clang->getFrontendOpts().LLVMArgs.size();
- auto Args = std::make_unique<const char*[]>(NumArgs + 2);
- Args[0] = "clang (LLVM option parsing)";
- for (unsigned i = 0; i != NumArgs; ++i)
- Args[i + 1] = Clang->getFrontendOpts().LLVMArgs[i].c_str();
- Args[NumArgs + 1] = nullptr;
- llvm::cl::ParseCommandLineOptions(NumArgs + 1, Args.get(), /*Overview=*/"",
- /*Errs=*/nullptr,
- /*VFS=*/&Clang->getVirtualFileSystem());
- }
+ Clang->parseLLVMArgs();
#if CLANG_ENABLE_STATIC_ANALYZER
// These should happen AFTER plugins have been loaded!
diff --git a/clang/lib/Interpreter/IncrementalExecutor.cpp b/clang/lib/Interpreter/IncrementalExecutor.cpp
index 65cb29a2f441a..51a601433e552 100644
--- a/clang/lib/Interpreter/IncrementalExecutor.cpp
+++ b/clang/lib/Interpreter/IncrementalExecutor.cpp
@@ -393,7 +393,7 @@ IncrementalExecutorBuilder::create(llvm::orc::ThreadSafeContext &TSC,
llvm::Error Err = llvm::Error::success();
std::unique_ptr<IncrementalExecutor> Executor;
#ifdef __EMSCRIPTEN__
- Executor = std::make_unique<WasmIncrementalExecutor>(Err);
+ Executor = std::make_unique<WasmIncrementalExecutor>(Err, LLVMArgs);
#else
Executor = std::make_unique<OrcIncrementalExecutor>(TSC, *JITBuilder, Err);
#endif
diff --git a/clang/lib/Interpreter/Interpreter.cpp b/clang/lib/Interpreter/Interpreter.cpp
index 2684a00ce5f07..5d02dceb472a2 100644
--- a/clang/lib/Interpreter/Interpreter.cpp
+++ b/clang/lib/Interpreter/Interpreter.cpp
@@ -257,6 +257,9 @@ Interpreter::Interpreter(std::unique_ptr<CompilerInstance> Instance,
auto LLVMCtx = std::make_unique<llvm::LLVMContext>();
TSCtx = std::make_unique<llvm::orc::ThreadSafeContext>(std::move(LLVMCtx));
+ // Honor -mllvm options
+ CI->parseLLVMArgs();
+
Act = TSCtx->withContextDo([&](llvm::LLVMContext *Ctx) {
return std::make_unique<IncrementalAction>(*CI, *Ctx, ErrOut, *this,
std::move(Consumer));
@@ -499,6 +502,10 @@ llvm::Error Interpreter::CreateExecutor() {
if (!IncrExecutorBuilder)
IncrExecutorBuilder = std::make_unique<IncrementalExecutorBuilder>();
+ // Propagate mllvm args so the wasm executor can restore them after each
+ // lldMain invocation (which resets all cl options for test isolation).
+ IncrExecutorBuilder->LLVMArgs = CI->getFrontendOpts().LLVMArgs;
+
auto ExecutorOrErr = IncrExecutorBuilder->create(*TSCtx, CI->getTarget());
if (ExecutorOrErr)
IncrExecutor = std::move(*ExecutorOrErr);
diff --git a/clang/lib/Interpreter/Wasm.cpp b/clang/lib/Interpreter/Wasm.cpp
index 96600cf9fa6d0..9ebd23da5f564 100644
--- a/clang/lib/Interpreter/Wasm.cpp
+++ b/clang/lib/Interpreter/Wasm.cpp
@@ -12,6 +12,7 @@
#include "Wasm.h"
+#include "llvm/Support/CommandLine.h"
#include "llvm/Support/FileSystem.h"
#include "llvm/Support/Path.h"
#include <llvm/IR/LegacyPassManager.h>
@@ -59,7 +60,9 @@ bool link(llvm::ArrayRef<const char *> args, llvm::raw_ostream &stdoutOS,
namespace clang {
-WasmIncrementalExecutor::WasmIncrementalExecutor(llvm::Error &Err) {
+WasmIncrementalExecutor::WasmIncrementalExecutor(llvm::Error &Err,
+ std::vector<std::string> LLVMArgs)
+ : StoredLLVMArgs(std::move(LLVMArgs)) {
llvm::ErrorAsOutParameter EAO(&Err);
if (Err)
@@ -132,6 +135,18 @@ llvm::Error WasmIncrementalExecutor::addModule(PartialTranslationUnit &PTU) {
lld::Result Result =
lld::lldMain(LinkerArgs, llvm::outs(), llvm::errs(), WasmDriverArgs);
+ // lld::wasm::linkerMain calls cl::ResetAllOptionOccurrences() which wipes
+ // all global LLVM cl options, including mllvm flags set by the frontend
+ // (e.g. -wasm-enable-eh, -wasm-enable-sjlj). Re-apply them so the next
+ // Parse() call's WebAssemblyTargetMachine creation finds the correct state.
+ if (!StoredLLVMArgs.empty()) {
+ std::vector<const char *> ArgPtrs;
+ ArgPtrs.push_back("clang-repl (restoring LLVM options)");
+ for (const std::string &Arg : StoredLLVMArgs)
+ ArgPtrs.push_back(Arg.c_str());
+ llvm::cl::ParseCommandLineOptions(ArgPtrs.size(), ArgPtrs.data());
+ }
+
if (Result.retCode)
return llvm::make_error<llvm::StringError>(
"Failed to link incremental module", llvm::inconvertibleErrorCode());
diff --git a/clang/lib/Interpreter/Wasm.h b/clang/lib/Interpreter/Wasm.h
index bf8777a41eac2..6340393dc6b9b 100644
--- a/clang/lib/Interpreter/Wasm.h
+++ b/clang/lib/Interpreter/Wasm.h
@@ -19,12 +19,14 @@
#include "clang/Interpreter/IncrementalExecutor.h"
#include "llvm/ADT/SmallString.h"
+#include <string>
+#include <vector>
namespace clang {
class WasmIncrementalExecutor : public IncrementalExecutor {
public:
- WasmIncrementalExecutor(llvm::Error &Err);
+ WasmIncrementalExecutor(llvm::Error &Err, std::vector<std::string> LLVMArgs);
~WasmIncrementalExecutor() override;
llvm::Error addModule(PartialTranslationUnit &PTU) override;
@@ -38,6 +40,7 @@ class WasmIncrementalExecutor : public IncrementalExecutor {
private:
llvm::SmallString<256> TempDir;
+ std::vector<std::string> StoredLLVMArgs;
};
} // namespace clang
diff --git a/clang/unittests/Interpreter/CMakeLists.txt b/clang/unittests/Interpreter/CMakeLists.txt
index 66b396b53cb55..9fdd69ea49069 100644
--- a/clang/unittests/Interpreter/CMakeLists.txt
+++ b/clang/unittests/Interpreter/CMakeLists.txt
@@ -76,6 +76,7 @@ get_target_property(LINKED_LIBS ClangReplInterpreterTests LINK_LIBRARIES)
list(REMOVE_ITEM LINKED_LIBS LLVMSupport)
set_target_properties(ClangReplInterpreterTests PROPERTIES LINK_LIBRARIES "${LINKED_LIBS}")
target_link_options(ClangReplInterpreterTests
+ PUBLIC "SHELL: -fwasm-exceptions"
PUBLIC "SHELL: -s MAIN_MODULE=1"
PUBLIC "SHELL: -s ALLOW_MEMORY_GROWTH=1"
PUBLIC "SHELL: -s STACK_SIZE=32mb"
diff --git a/clang/unittests/Interpreter/InterpreterTest.cpp b/clang/unittests/Interpreter/InterpreterTest.cpp
index 9ff9092524d21..32b6e00e05a67 100644
--- a/clang/unittests/Interpreter/InterpreterTest.cpp
+++ b/clang/unittests/Interpreter/InterpreterTest.cpp
@@ -443,4 +443,20 @@ TEST_F(InterpreterTest, TranslationUnit_CanonicalDecl) {
sema.getASTContext().getTranslationUnitDecl()->getCanonicalDecl());
}
+TEST_F(InterpreterTest, EmscriptenExceptionHandling) {
+#ifndef __EMSCRIPTEN__
+ GTEST_SKIP() << "This test only applies to Emscripten builds.";
+#endif
+
+ using Args = std::vector<const char *>;
+ Args ExtraArgs = {"-std=c++23", "-v",
+ "-fwasm-exceptions",
+ "-mllvm", "-wasm-enable-sjlj"};
+
+ std::unique_ptr<Interpreter> Interp = createInterpreter(ExtraArgs);
+
+ llvm::cantFail(
+ Interp->ParseAndExecute("try { throw 1; } catch (...) { 0; }"));
+}
+
} // end anonymous namespace
diff --git a/clang/unittests/Interpreter/InterpreterTestFixture.h b/clang/unittests/Interpreter/InterpreterTestFixture.h
index b088fa4a5f896..c4a30dd06220c 100644
--- a/clang/unittests/Interpreter/InterpreterTestFixture.h
+++ b/clang/unittests/Interpreter/InterpreterTestFixture.h
@@ -55,7 +55,17 @@ class InterpreterTestBase : public ::testing::Test {
llvm::InitializeNativeTargetAsmPrinter();
}
- static void TearDownTestSuite() { llvm::llvm_shutdown(); }
+ static void TearDownTestSuite() {
+ // llvm_shutdown() cleans up JIT (LLJIT/ORC) state between test suites.
+ // On Emscripten, WasmIncrementalExecutor is used instead of LLJIT, so
+ // there is no JIT state to tear down. Calling llvm_shutdown() here would
+ // destroy the ManagedStatic<CommandLineParser> global, permanently
+ // deregistering all cl::opt options (wasm-enable-eh, etc.) since their
+ // constructors already ran and will not fire again after the reset.
+#ifndef __EMSCRIPTEN__
+ llvm::llvm_shutdown();
+#endif
+ }
};
} // namespace clang
>From 8abb6c1f71112016c9252ebfb19fd388a12b691e Mon Sep 17 00:00:00 2001
From: anutosh491 <andersonbhat491 at gmail.com>
Date: Tue, 12 May 2026 14:59:50 +0530
Subject: [PATCH 2/2] clang format suggestions
---
clang/include/clang/Interpreter/IncrementalExecutor.h | 3 ++-
clang/lib/Interpreter/Wasm.cpp | 4 ++--
clang/unittests/Interpreter/InterpreterTest.cpp | 5 ++---
3 files changed, 6 insertions(+), 6 deletions(-)
diff --git a/clang/include/clang/Interpreter/IncrementalExecutor.h b/clang/include/clang/Interpreter/IncrementalExecutor.h
index a293978b2917b..64a7627c01983 100644
--- a/clang/include/clang/Interpreter/IncrementalExecutor.h
+++ b/clang/include/clang/Interpreter/IncrementalExecutor.h
@@ -53,7 +53,8 @@ class IncrementalExecutorBuilder {
/// An optional external IncrementalExecutor
std::unique_ptr<IncrementalExecutor> IE;
/// mllvm args from the frontend; on wasm these are re-applied after each
- /// lldMain call because lld resets all cl options for test-isolation purposes.
+ /// lldMain call because lld resets all cl options for test-isolation
+ /// purposes.
std::vector<std::string> LLVMArgs;
/// An optional external orc jit builder
std::unique_ptr<llvm::orc::LLJITBuilder> JITBuilder;
diff --git a/clang/lib/Interpreter/Wasm.cpp b/clang/lib/Interpreter/Wasm.cpp
index 9ebd23da5f564..f55530e54b0a7 100644
--- a/clang/lib/Interpreter/Wasm.cpp
+++ b/clang/lib/Interpreter/Wasm.cpp
@@ -60,8 +60,8 @@ bool link(llvm::ArrayRef<const char *> args, llvm::raw_ostream &stdoutOS,
namespace clang {
-WasmIncrementalExecutor::WasmIncrementalExecutor(llvm::Error &Err,
- std::vector<std::string> LLVMArgs)
+WasmIncrementalExecutor::WasmIncrementalExecutor(
+ llvm::Error &Err, std::vector<std::string> LLVMArgs)
: StoredLLVMArgs(std::move(LLVMArgs)) {
llvm::ErrorAsOutParameter EAO(&Err);
diff --git a/clang/unittests/Interpreter/InterpreterTest.cpp b/clang/unittests/Interpreter/InterpreterTest.cpp
index 32b6e00e05a67..15468e916c94e 100644
--- a/clang/unittests/Interpreter/InterpreterTest.cpp
+++ b/clang/unittests/Interpreter/InterpreterTest.cpp
@@ -449,9 +449,8 @@ TEST_F(InterpreterTest, EmscriptenExceptionHandling) {
#endif
using Args = std::vector<const char *>;
- Args ExtraArgs = {"-std=c++23", "-v",
- "-fwasm-exceptions",
- "-mllvm", "-wasm-enable-sjlj"};
+ Args ExtraArgs = {"-std=c++23", "-v", "-fwasm-exceptions", "-mllvm",
+ "-wasm-enable-sjlj"};
std::unique_ptr<Interpreter> Interp = createInterpreter(ExtraArgs);
More information about the cfe-commits
mailing list