MLIR  20.0.0git
Public Member Functions | Static Public Member Functions | Protected Attributes | List of all members
mlir::MlirOptMainConfig Class Reference

Configuration options for the mlir-opt tool. More...

#include "mlir/Tools/mlir-opt/MlirOptMain.h"

Public Member Functions

MlirOptMainConfigallowUnregisteredDialects (bool allow)
 Options. More...
 
bool shouldAllowUnregisteredDialects () const
 
MlirOptMainConfigsetDebugConfig (tracing::DebugConfig config)
 Set the debug configuration to use. More...
 
tracing::DebugConfiggetDebugConfig ()
 
const tracing::DebugConfiggetDebugConfig () const
 
MlirOptMainConfigdumpPassPipeline (bool dump)
 Print the pass-pipeline as text before executing. More...
 
bool shouldDumpPassPipeline () const
 
MlirOptMainConfigemitBytecode (bool emit)
 Set the output format to bytecode instead of textual IR. More...
 
bool shouldEmitBytecode () const
 
bool shouldElideResourceDataFromBytecode () const
 
MlirOptMainConfigsetIrdlFile (StringRef file)
 Set the IRDL file to load before processing the input. More...
 
StringRef getIrdlFile () const
 
MlirOptMainConfigsetEmitBytecodeVersion (int64_t version)
 Set the bytecode version to emit. More...
 
std::optional< int64_t > bytecodeVersionToEmit () const
 
MlirOptMainConfigsetPassPipelineSetupFn (std::function< LogicalResult(PassManager &)> callback)
 Set the callback to populate the pass manager. More...
 
MlirOptMainConfigsetPassPipelineParser (const PassPipelineCLParser &parser)
 Set the parser to use to populate the pass manager. More...
 
LogicalResult setupPassPipeline (PassManager &pm) const
 Populate the passmanager, if any callback was set. More...
 
MlirOptMainConfiglistPasses (bool list)
 List the registered passes and return. More...
 
bool shouldListPasses () const
 
MlirOptMainConfigrunReproducer (bool enableReproducer)
 Enable running the reproducer information stored in resources (if present). More...
 
bool shouldRunReproducer () const
 Return true if the reproducer should be run. More...
 
MlirOptMainConfigshowDialects (bool show)
 Show the registered dialects before trying to load the input file. More...
 
bool shouldShowDialects () const
 
MlirOptMainConfigsplitInputFile (std::string splitMarker=kDefaultSplitMarker)
 Set the marker on which to split the input into chunks and process each chunk independently. More...
 
StringRef inputSplitMarker () const
 
MlirOptMainConfigoutputSplitMarker (std::string splitMarker=kDefaultSplitMarker)
 Set whether to merge the output chunks into one file using the given marker. More...
 
StringRef outputSplitMarker () const
 
MlirOptMainConfiguseExplicitModule (bool useExplicitModule)
 Disable implicit addition of a top-level module op during parsing. More...
 
bool shouldUseExplicitModule () const
 
MlirOptMainConfigverifyDiagnostics (bool verify)
 Set whether to check that emitted diagnostics match expected-* lines on the corresponding line. More...
 
bool shouldVerifyDiagnostics () const
 
MlirOptMainConfigverifyPasses (bool verify)
 Set whether to run the verifier after each transformation pass. More...
 
bool shouldVerifyPasses () const
 
MlirOptMainConfigverifyOnParsing (bool verify)
 Set whether to run the verifier on parsing. More...
 
bool shouldVerifyOnParsing () const
 
MlirOptMainConfigverifyRoundtrip (bool verify)
 Set whether to run the verifier after each transformation pass. More...
 
bool shouldVerifyRoundtrip () const
 
StringRef getReproducerFilename () const
 Reproducer file generation (no crash required). More...
 

Static Public Member Functions

static void registerCLOptions (DialectRegistry &dialectRegistry)
 Register the options as global LLVM command line options. More...
 
static MlirOptMainConfig createFromCLOptions ()
 Create a new config with the default set from the CL options. More...
 

Protected Attributes

bool allowUnregisteredDialectsFlag = false
 Allow operation with no registered dialects. More...
 
tracing::DebugConfig debugConfig
 Configuration for the debugging hooks. More...
 
bool dumpPassPipelineFlag = false
 Print the pipeline that will be run. More...
 
bool emitBytecodeFlag = false
 Emit bytecode instead of textual assembly when generating output. More...
 
bool elideResourceDataFromBytecodeFlag = false
 Elide resources when generating bytecode. More...
 
bool enableDebuggerActionHookFlag = false
 Enable the Debugger action hook: Debugger can intercept MLIR Actions. More...
 
std::string irdlFileFlag = ""
 IRDL file to register before processing the input. More...
 
std::vector< tracing::BreakpointManager * > logActionLocationFilter
 Location Breakpoints to filter the action logging. More...
 
std::optional< int64_t > emitBytecodeVersion = std::nullopt
 Emit bytecode at given version. More...
 
std::function< LogicalResult(PassManager &)> passPipelineCallback
 The callback to populate the pass manager. More...
 
bool listPassesFlag = false
 List the registered passes and return. More...
 
bool runReproducerFlag = false
 Enable running the reproducer. More...
 
bool showDialectsFlag = false
 Show the registered dialects before trying to load the input file. More...
 
std::string splitInputFileFlag = ""
 Split the input file based on the given marker into chunks and process each chunk independently. More...
 
std::string outputSplitMarkerFlag = ""
 Merge output chunks into one file using the given marker. More...
 
bool useExplicitModuleFlag = false
 Use an explicit top-level module op during parsing. More...
 
bool verifyDiagnosticsFlag = false
 Set whether to check that emitted diagnostics match expected-* lines on the corresponding line. More...
 
bool verifyPassesFlag = true
 Run the verifier after each transformation pass. More...
 
bool disableVerifierOnParsingFlag = false
 Disable the verifier on parsing. More...
 
bool verifyRoundtripFlag = false
 Verify that the input IR round-trips perfectly. More...
 
std::string generateReproducerFileFlag = ""
 The reproducer output filename (no crash required). More...
 

Detailed Description

Configuration options for the mlir-opt tool.

This is intended to help building tools like mlir-opt by collecting the supported options. The API is fluent, and the options are sorted in alphabetical order below. The options can be exposed to the LLVM command line by registering them with MlirOptMainConfig::registerCLOptions(DialectRegistry &); and creating a config using auto config = MlirOptMainConfig::createFromCLOptions();.

Definition at line 41 of file MlirOptMain.h.

Member Function Documentation

◆ allowUnregisteredDialects()

MlirOptMainConfig& mlir::MlirOptMainConfig::allowUnregisteredDialects ( bool  allow)
inline

Options.

Allow operation with no registered dialects. This option is for convenience during testing only and discouraged in general.

Definition at line 56 of file MlirOptMain.h.

References allowUnregisteredDialectsFlag.

◆ bytecodeVersionToEmit()

std::optional<int64_t> mlir::MlirOptMainConfig::bytecodeVersionToEmit ( ) const
inline

Definition at line 101 of file MlirOptMain.h.

References emitBytecodeVersion.

Referenced by performActions().

◆ createFromCLOptions()

MlirOptMainConfig MlirOptMainConfig::createFromCLOptions ( )
static

Create a new config with the default set from the CL options.

Definition at line 219 of file MlirOptMain.cpp.

References clOptionsConfig, and mlir::tracing::DebugConfig::createFromCLOptions().

Referenced by mlir::MlirOptMain().

◆ dumpPassPipeline()

MlirOptMainConfig& mlir::MlirOptMainConfig::dumpPassPipeline ( bool  dump)
inline

Print the pass-pipeline as text before executing.

Definition at line 73 of file MlirOptMain.h.

References dumpPassPipelineFlag.

◆ emitBytecode()

MlirOptMainConfig& mlir::MlirOptMainConfig::emitBytecode ( bool  emit)
inline

Set the output format to bytecode instead of textual IR.

Definition at line 80 of file MlirOptMain.h.

References emitBytecodeFlag.

◆ getDebugConfig() [1/2]

tracing::DebugConfig& mlir::MlirOptMainConfig::getDebugConfig ( )
inline

Definition at line 69 of file MlirOptMain.h.

References debugConfig.

◆ getDebugConfig() [2/2]

const tracing::DebugConfig& mlir::MlirOptMainConfig::getDebugConfig ( ) const
inline

Definition at line 70 of file MlirOptMain.h.

References debugConfig.

◆ getIrdlFile()

StringRef mlir::MlirOptMainConfig::getIrdlFile ( ) const
inline

Definition at line 94 of file MlirOptMain.h.

References irdlFileFlag.

Referenced by doVerifyRoundTrip().

◆ getReproducerFilename()

StringRef mlir::MlirOptMainConfig::getReproducerFilename ( ) const
inline

Reproducer file generation (no crash required).

Definition at line 201 of file MlirOptMain.h.

References generateReproducerFileFlag.

Referenced by performActions().

◆ inputSplitMarker()

StringRef mlir::MlirOptMainConfig::inputSplitMarker ( ) const
inline

Definition at line 153 of file MlirOptMain.h.

References splitInputFileFlag.

◆ listPasses()

MlirOptMainConfig& mlir::MlirOptMainConfig::listPasses ( bool  list)
inline

List the registered passes and return.

Definition at line 123 of file MlirOptMain.h.

References listPassesFlag.

◆ outputSplitMarker() [1/2]

StringRef mlir::MlirOptMainConfig::outputSplitMarker ( ) const
inline

Definition at line 162 of file MlirOptMain.h.

References outputSplitMarkerFlag.

◆ outputSplitMarker() [2/2]

MlirOptMainConfig& mlir::MlirOptMainConfig::outputSplitMarker ( std::string  splitMarker = kDefaultSplitMarker)
inline

Set whether to merge the output chunks into one file using the given marker.

Definition at line 158 of file MlirOptMain.h.

References outputSplitMarkerFlag.

◆ registerCLOptions()

void MlirOptMainConfig::registerCLOptions ( DialectRegistry dialectRegistry)
static

Register the options as global LLVM command line options.

Definition at line 214 of file MlirOptMain.cpp.

References clOptionsConfig, and mlir::tracing::DebugConfig::registerCLOptions().

Referenced by mlir::registerAndParseCLIOptions().

◆ runReproducer()

MlirOptMainConfig& mlir::MlirOptMainConfig::runReproducer ( bool  enableReproducer)
inline

Enable running the reproducer information stored in resources (if present).

Definition at line 131 of file MlirOptMain.h.

References runReproducerFlag.

◆ setDebugConfig()

MlirOptMainConfig& mlir::MlirOptMainConfig::setDebugConfig ( tracing::DebugConfig  config)
inline

Set the debug configuration to use.

Definition at line 65 of file MlirOptMain.h.

References debugConfig.

◆ setEmitBytecodeVersion()

MlirOptMainConfig& mlir::MlirOptMainConfig::setEmitBytecodeVersion ( int64_t  version)
inline

Set the bytecode version to emit.

Definition at line 97 of file MlirOptMain.h.

References emitBytecodeVersion.

◆ setIrdlFile()

MlirOptMainConfig& mlir::MlirOptMainConfig::setIrdlFile ( StringRef  file)
inline

Set the IRDL file to load before processing the input.

Definition at line 90 of file MlirOptMain.h.

References irdlFileFlag.

◆ setPassPipelineParser()

MlirOptMainConfig & MlirOptMainConfig::setPassPipelineParser ( const PassPipelineCLParser parser)

Set the parser to use to populate the pass manager.

Definition at line 224 of file MlirOptMain.cpp.

References mlir::PassPipelineCLParser::addToPipeline(), mlir::emitError(), and mlir::get().

◆ setPassPipelineSetupFn()

MlirOptMainConfig& mlir::MlirOptMainConfig::setPassPipelineSetupFn ( std::function< LogicalResult(PassManager &)>  callback)
inline

Set the callback to populate the pass manager.

Definition at line 107 of file MlirOptMain.h.

References passPipelineCallback.

◆ setupPassPipeline()

LogicalResult mlir::MlirOptMainConfig::setupPassPipeline ( PassManager pm) const
inline

Populate the passmanager, if any callback was set.

Definition at line 116 of file MlirOptMain.h.

References passPipelineCallback.

Referenced by performActions().

◆ shouldAllowUnregisteredDialects()

bool mlir::MlirOptMainConfig::shouldAllowUnregisteredDialects ( ) const
inline

Definition at line 60 of file MlirOptMain.h.

References allowUnregisteredDialectsFlag.

◆ shouldDumpPassPipeline()

bool mlir::MlirOptMainConfig::shouldDumpPassPipeline ( ) const
inline

Definition at line 77 of file MlirOptMain.h.

References dumpPassPipelineFlag.

◆ shouldElideResourceDataFromBytecode()

bool mlir::MlirOptMainConfig::shouldElideResourceDataFromBytecode ( ) const
inline

Definition at line 85 of file MlirOptMain.h.

References elideResourceDataFromBytecodeFlag.

Referenced by performActions().

◆ shouldEmitBytecode()

bool mlir::MlirOptMainConfig::shouldEmitBytecode ( ) const
inline

Definition at line 84 of file MlirOptMain.h.

References emitBytecodeFlag.

Referenced by performActions().

◆ shouldListPasses()

bool mlir::MlirOptMainConfig::shouldListPasses ( ) const
inline

Definition at line 127 of file MlirOptMain.h.

References listPassesFlag.

Referenced by mlir::MlirOptMain().

◆ shouldRunReproducer()

bool mlir::MlirOptMainConfig::shouldRunReproducer ( ) const
inline

Return true if the reproducer should be run.

Definition at line 137 of file MlirOptMain.h.

References runReproducerFlag.

Referenced by performActions().

◆ shouldShowDialects()

bool mlir::MlirOptMainConfig::shouldShowDialects ( ) const
inline

Definition at line 144 of file MlirOptMain.h.

References showDialectsFlag.

Referenced by mlir::MlirOptMain().

◆ shouldUseExplicitModule()

bool mlir::MlirOptMainConfig::shouldUseExplicitModule ( ) const
inline

Definition at line 169 of file MlirOptMain.h.

References useExplicitModuleFlag.

Referenced by performActions().

◆ shouldVerifyDiagnostics()

bool mlir::MlirOptMainConfig::shouldVerifyDiagnostics ( ) const
inline

Definition at line 177 of file MlirOptMain.h.

References verifyDiagnosticsFlag.

◆ shouldVerifyOnParsing()

bool mlir::MlirOptMainConfig::shouldVerifyOnParsing ( ) const
inline

Definition at line 191 of file MlirOptMain.h.

References disableVerifierOnParsingFlag.

Referenced by doVerifyRoundTrip(), and performActions().

◆ shouldVerifyPasses()

bool mlir::MlirOptMainConfig::shouldVerifyPasses ( ) const
inline

Definition at line 184 of file MlirOptMain.h.

References verifyPassesFlag.

Referenced by performActions().

◆ shouldVerifyRoundtrip()

bool mlir::MlirOptMainConfig::shouldVerifyRoundtrip ( ) const
inline

Definition at line 198 of file MlirOptMain.h.

References verifyRoundtripFlag.

Referenced by performActions().

◆ showDialects()

MlirOptMainConfig& mlir::MlirOptMainConfig::showDialects ( bool  show)
inline

Show the registered dialects before trying to load the input file.

Definition at line 140 of file MlirOptMain.h.

References showDialectsFlag.

◆ splitInputFile()

MlirOptMainConfig& mlir::MlirOptMainConfig::splitInputFile ( std::string  splitMarker = kDefaultSplitMarker)
inline

Set the marker on which to split the input into chunks and process each chunk independently.

Input is not split if empty.

Definition at line 149 of file MlirOptMain.h.

References splitInputFileFlag.

◆ useExplicitModule()

MlirOptMainConfig& mlir::MlirOptMainConfig::useExplicitModule ( bool  useExplicitModule)
inline

Disable implicit addition of a top-level module op during parsing.

Definition at line 165 of file MlirOptMain.h.

References useExplicitModuleFlag.

◆ verifyDiagnostics()

MlirOptMainConfig& mlir::MlirOptMainConfig::verifyDiagnostics ( bool  verify)
inline

Set whether to check that emitted diagnostics match expected-* lines on the corresponding line.

This is meant for implementing diagnostic tests.

Definition at line 173 of file MlirOptMain.h.

References mlir::verify(), and verifyDiagnosticsFlag.

◆ verifyOnParsing()

MlirOptMainConfig& mlir::MlirOptMainConfig::verifyOnParsing ( bool  verify)
inline

Set whether to run the verifier on parsing.

Definition at line 187 of file MlirOptMain.h.

References disableVerifierOnParsingFlag, and mlir::verify().

◆ verifyPasses()

MlirOptMainConfig& mlir::MlirOptMainConfig::verifyPasses ( bool  verify)
inline

Set whether to run the verifier after each transformation pass.

Definition at line 180 of file MlirOptMain.h.

References mlir::verify(), and verifyPassesFlag.

◆ verifyRoundtrip()

MlirOptMainConfig& mlir::MlirOptMainConfig::verifyRoundtrip ( bool  verify)
inline

Set whether to run the verifier after each transformation pass.

Definition at line 194 of file MlirOptMain.h.

References mlir::verify(), and verifyRoundtripFlag.

Member Data Documentation

◆ allowUnregisteredDialectsFlag

bool mlir::MlirOptMainConfig::allowUnregisteredDialectsFlag = false
protected

Allow operation with no registered dialects.

This option is for convenience during testing only and discouraged in general.

Definition at line 207 of file MlirOptMain.h.

Referenced by allowUnregisteredDialects(), and shouldAllowUnregisteredDialects().

◆ debugConfig

tracing::DebugConfig mlir::MlirOptMainConfig::debugConfig
protected

Configuration for the debugging hooks.

Definition at line 210 of file MlirOptMain.h.

Referenced by getDebugConfig(), and setDebugConfig().

◆ disableVerifierOnParsingFlag

bool mlir::MlirOptMainConfig::disableVerifierOnParsingFlag = false
protected

Disable the verifier on parsing.

Definition at line 263 of file MlirOptMain.h.

Referenced by shouldVerifyOnParsing(), and verifyOnParsing().

◆ dumpPassPipelineFlag

bool mlir::MlirOptMainConfig::dumpPassPipelineFlag = false
protected

Print the pipeline that will be run.

Definition at line 213 of file MlirOptMain.h.

Referenced by dumpPassPipeline(), and shouldDumpPassPipeline().

◆ elideResourceDataFromBytecodeFlag

bool mlir::MlirOptMainConfig::elideResourceDataFromBytecodeFlag = false
protected

Elide resources when generating bytecode.

Definition at line 219 of file MlirOptMain.h.

Referenced by shouldElideResourceDataFromBytecode().

◆ emitBytecodeFlag

bool mlir::MlirOptMainConfig::emitBytecodeFlag = false
protected

Emit bytecode instead of textual assembly when generating output.

Definition at line 216 of file MlirOptMain.h.

Referenced by emitBytecode(), and shouldEmitBytecode().

◆ emitBytecodeVersion

std::optional<int64_t> mlir::MlirOptMainConfig::emitBytecodeVersion = std::nullopt
protected

Emit bytecode at given version.

Definition at line 231 of file MlirOptMain.h.

Referenced by bytecodeVersionToEmit(), and setEmitBytecodeVersion().

◆ enableDebuggerActionHookFlag

bool mlir::MlirOptMainConfig::enableDebuggerActionHookFlag = false
protected

Enable the Debugger action hook: Debugger can intercept MLIR Actions.

Definition at line 222 of file MlirOptMain.h.

◆ generateReproducerFileFlag

std::string mlir::MlirOptMainConfig::generateReproducerFileFlag = ""
protected

The reproducer output filename (no crash required).

Definition at line 269 of file MlirOptMain.h.

Referenced by getReproducerFilename().

◆ irdlFileFlag

std::string mlir::MlirOptMainConfig::irdlFileFlag = ""
protected

IRDL file to register before processing the input.

Definition at line 225 of file MlirOptMain.h.

Referenced by getIrdlFile(), and setIrdlFile().

◆ listPassesFlag

bool mlir::MlirOptMainConfig::listPassesFlag = false
protected

List the registered passes and return.

Definition at line 237 of file MlirOptMain.h.

Referenced by listPasses(), and shouldListPasses().

◆ logActionLocationFilter

std::vector<tracing::BreakpointManager *> mlir::MlirOptMainConfig::logActionLocationFilter
protected

Location Breakpoints to filter the action logging.

Definition at line 228 of file MlirOptMain.h.

◆ outputSplitMarkerFlag

std::string mlir::MlirOptMainConfig::outputSplitMarkerFlag = ""
protected

Merge output chunks into one file using the given marker.

Definition at line 250 of file MlirOptMain.h.

Referenced by outputSplitMarker().

◆ passPipelineCallback

std::function<LogicalResult(PassManager &)> mlir::MlirOptMainConfig::passPipelineCallback
protected

The callback to populate the pass manager.

Definition at line 234 of file MlirOptMain.h.

Referenced by setPassPipelineSetupFn(), and setupPassPipeline().

◆ runReproducerFlag

bool mlir::MlirOptMainConfig::runReproducerFlag = false
protected

Enable running the reproducer.

Definition at line 240 of file MlirOptMain.h.

Referenced by runReproducer(), and shouldRunReproducer().

◆ showDialectsFlag

bool mlir::MlirOptMainConfig::showDialectsFlag = false
protected

Show the registered dialects before trying to load the input file.

Definition at line 243 of file MlirOptMain.h.

Referenced by shouldShowDialects(), and showDialects().

◆ splitInputFileFlag

std::string mlir::MlirOptMainConfig::splitInputFileFlag = ""
protected

Split the input file based on the given marker into chunks and process each chunk independently.

Input is not split if empty.

Definition at line 247 of file MlirOptMain.h.

Referenced by inputSplitMarker(), and splitInputFile().

◆ useExplicitModuleFlag

bool mlir::MlirOptMainConfig::useExplicitModuleFlag = false
protected

Use an explicit top-level module op during parsing.

Definition at line 253 of file MlirOptMain.h.

Referenced by shouldUseExplicitModule(), and useExplicitModule().

◆ verifyDiagnosticsFlag

bool mlir::MlirOptMainConfig::verifyDiagnosticsFlag = false
protected

Set whether to check that emitted diagnostics match expected-* lines on the corresponding line.

This is meant for implementing diagnostic tests.

Definition at line 257 of file MlirOptMain.h.

Referenced by shouldVerifyDiagnostics(), and verifyDiagnostics().

◆ verifyPassesFlag

bool mlir::MlirOptMainConfig::verifyPassesFlag = true
protected

Run the verifier after each transformation pass.

Definition at line 260 of file MlirOptMain.h.

Referenced by shouldVerifyPasses(), and verifyPasses().

◆ verifyRoundtripFlag

bool mlir::MlirOptMainConfig::verifyRoundtripFlag = false
protected

Verify that the input IR round-trips perfectly.

Definition at line 266 of file MlirOptMain.h.

Referenced by shouldVerifyRoundtrip(), and verifyRoundtrip().


The documentation for this class was generated from the following files: