LLDB  mainline
Public Member Functions | Protected Types | Protected Member Functions | Protected Attributes | List of all members
lldb_private::Options Class Referenceabstract

#include "lldb/Interpreter/Options.h"

Inherited by CommandObjectBreakpointClear::CommandOptions, CommandObjectBreakpointCommandDelete::CommandOptions, CommandObjectBreakpointDelete::CommandOptions, CommandObjectBreakpointList::CommandOptions, CommandObjectBreakpointRead::CommandOptions, CommandObjectBreakpointWrite::CommandOptions, CommandObjectCommandsAddRegex::CommandOptions, CommandObjectCommandsScriptAdd::CommandOptions, CommandObjectCommandsScriptImport::CommandOptions, CommandObjectCommandsSource::CommandOptions, CommandObjectFrameDiagnose::CommandOptions, CommandObjectFrameRecognizerAdd::CommandOptions, CommandObjectFrameSelect::CommandOptions, CommandObjectLogEnable::CommandOptions, CommandObjectObjC_ClassTable_Dump::CommandOptions, CommandObjectPlatformFRead::CommandOptions, CommandObjectPlatformFWrite::CommandOptions, CommandObjectPlatformProcessAttach::CommandOptions, CommandObjectPlatformProcessList::CommandOptions, CommandObjectPlatformShell::CommandOptions, CommandObjectProcessAttach::CommandOptions, CommandObjectProcessConnect::CommandOptions, CommandObjectProcessContinue::CommandOptions, CommandObjectProcessDetach::CommandOptions, CommandObjectProcessHandle::CommandOptions, CommandObjectProcessLoad::CommandOptions, CommandObjectProcessSaveCore::CommandOptions, CommandObjectProcessStatus::CommandOptions, CommandObjectProcessTraceSave::CommandOptions, CommandObjectRenderScriptRuntimeAllocationDump::CommandOptions, CommandObjectRenderScriptRuntimeAllocationList::CommandOptions, CommandObjectRenderScriptRuntimeKernelBreakpointSet::CommandOptions, CommandObjectRenderScriptRuntimeReductionBreakpointSet::CommandOptions, CommandObjectReproducerDump::CommandOptions, CommandObjectReproducerXCrash::CommandOptions, CommandObjectSessionHistory::CommandOptions, CommandObjectSettingsClear::CommandOptions, CommandObjectSettingsRead::CommandOptions, CommandObjectSettingsSet::CommandOptions, CommandObjectSettingsWrite::CommandOptions, CommandObjectSourceInfo::CommandOptions, CommandObjectSourceList::CommandOptions, CommandObjectStatsDump::CommandOptions, CommandObjectTargetModulesDumpLineTable::CommandOptions, CommandObjectTargetModulesDumpSymtab::CommandOptions, CommandObjectTargetModulesList::CommandOptions, CommandObjectTargetModulesLookup::CommandOptions, CommandObjectTargetModulesShowUnwind::CommandOptions, CommandObjectThreadBacktrace::CommandOptions, CommandObjectThreadInfo::CommandOptions, CommandObjectThreadJump::CommandOptions, CommandObjectThreadPlanList::CommandOptions, CommandObjectThreadReturn::CommandOptions, CommandObjectThreadUntil::CommandOptions, CommandObjectTraceDump::CommandOptions, CommandObjectTraceDumpInfo::CommandOptions, CommandObjectTraceDumpInstructions::CommandOptions, CommandObjectTraceLoad::CommandOptions, CommandObjectTraceSchema::CommandOptions, CommandObjectTypeFormatterClear::CommandOptions, CommandObjectTypeFormatterDelete::CommandOptions, CommandObjectTypeFormatterList< FormatterType >::CommandOptions, CommandObjectTypeSummaryAdd::CommandOptions, CommandObjectTypeSynthAdd::CommandOptions, CommandObjectWatchpointCommandAdd::CommandOptions, CommandObjectWatchpointDelete::CommandOptions, CommandObjectWatchpointIgnore::CommandOptions, CommandObjectWatchpointList::CommandOptions, CommandObjectWatchpointModify::CommandOptions, lldb_private::CommandObjectDisassemble::CommandOptions, lldb_private::CommandObjectHelp::CommandOptions, lldb_private::CommandObjectScript::CommandOptions, lldb_private::ctf::CommandObjectThreadTraceExportCTF::CommandOptions, lldb_private::OptionGroupOptions, lldb_private::trace_intel_pt::CommandObjectProcessTraceStartIntelPT::CommandOptions, lldb_private::trace_intel_pt::CommandObjectThreadTraceStartIntelPT::CommandOptions, and sddarwinlog_private::EnableOptions.

Collaboration diagram for lldb_private::Options:
Collaboration graph
[legend]

Public Member Functions

 Options ()
 
virtual ~Options ()
 
void BuildGetoptTable ()
 
void BuildValidOptionSets ()
 
uint32_t NumCommandOptions ()
 
Option * GetLongOptions ()
 Get the option definitions to use when parsing Args options. More...
 
void OptionSeen (int short_option)
 
bool VerifyOptions (CommandReturnObject &result)
 
bool VerifyPartialOptions (CommandReturnObject &result)
 
void OutputFormattedUsageText (Stream &strm, const OptionDefinition &option_def, uint32_t output_max_columns)
 
void GenerateOptionUsage (Stream &strm, CommandObject &cmd, uint32_t screen_width)
 
bool SupportsLongOption (const char *long_option)
 
virtual llvm::ArrayRef< OptionDefinition > GetDefinitions ()
 
void NotifyOptionParsingStarting (ExecutionContext *execution_context)
 
llvm::Expected< Args > Parse (const Args &args, ExecutionContext *execution_context, lldb::PlatformSP platform_sp, bool require_validation)
 Parse the provided arguments. More...
 
llvm::Expected< Args > ParseAlias (const Args &args, OptionArgVector *option_arg_vector, std::string &input_line)
 
OptionElementVector ParseForCompletion (const Args &args, uint32_t cursor_index)
 
Status NotifyOptionParsingFinished (ExecutionContext *execution_context)
 
virtual Status SetOptionValue (uint32_t option_idx, llvm::StringRef option_arg, ExecutionContext *execution_context)=0
 Set the value of an option. More...
 
bool HandleOptionCompletion (lldb_private::CompletionRequest &request, OptionElementVector &option_map, CommandInterpreter &interpreter)
 Handles the generic bits of figuring out whether we are in an option, and if so completing it. More...
 
virtual void HandleOptionArgumentCompletion (lldb_private::CompletionRequest &request, OptionElementVector &opt_element_vector, int opt_element_index, CommandInterpreter &interpreter)
 Handles the generic bits of figuring out whether we are in an option, and if so completing it. More...
 

Protected Types

typedef std::set< int > OptionSet
 
typedef std::vector< OptionSet > OptionSetVector
 

Protected Member Functions

OptionSetVector & GetRequiredOptions ()
 
OptionSetVector & GetOptionalOptions ()
 
bool IsASubset (const OptionSet &set_a, const OptionSet &set_b)
 
size_t OptionsSetDiff (const OptionSet &set_a, const OptionSet &set_b, OptionSet &diffs)
 
void OptionsSetUnion (const OptionSet &set_a, const OptionSet &set_b, OptionSet &union_set)
 
virtual void OptionParsingStarting (ExecutionContext *execution_context)=0
 
virtual Status OptionParsingFinished (ExecutionContext *execution_context)
 

Protected Attributes

std::vector< Option > m_getopt_table
 
OptionSet m_seen_options
 
OptionSetVector m_required_options
 
OptionSetVector m_optional_options
 

Detailed Description

A command line option parsing protocol class.

Options is designed to be subclassed to contain all needed options for a given command. The options can be parsed by calling the Parse function.

The options are specified using the format defined for the libc options parsing function getopt_long_only:

#include <getopt.h>
int getopt_long_only(int argc, char * const *argv, const char
*optstring, const struct option *longopts, int *longindex);

Definition at line 57 of file Options.h.

Member Typedef Documentation

◆ OptionSet

typedef std::set<int> lldb_private::Options::OptionSet
protected

Definition at line 194 of file Options.h.

◆ OptionSetVector

typedef std::vector<OptionSet> lldb_private::Options::OptionSetVector
protected

Definition at line 195 of file Options.h.

Constructor & Destructor Documentation

◆ Options()

Options::Options ( )

Definition at line 29 of file Options.cpp.

◆ ~Options()

Options::~Options ( )
virtualdefault

Member Function Documentation

◆ BuildGetoptTable()

void lldb_private::Options::BuildGetoptTable ( )

◆ BuildValidOptionSets()

void Options::BuildValidOptionSets ( )

Definition at line 149 of file Options.cpp.

References LLDB_MAX_NUM_OPTION_SETS, and LLDB_OPT_SET_ALL.

Referenced by GetOptionalOptions(), and GetRequiredOptions().

◆ GenerateOptionUsage()

void Options::GenerateOptionUsage ( Stream &  strm,
CommandObject &  cmd,
uint32_t  screen_width 
)

Definition at line 391 of file Options.cpp.

References eDisplayBestOption, eDisplayLongOption, eDisplayShortOption, lldb_private::OptionDefinition::enum_values, lldb_private::Stream::EOL(), lldb_private::CommandObject::GetCommandName(), lldb_private::CommandObject::GetFormattedCommandArguments(), lldb_private::Stream::GetIndentLevel(), lldb_private::StreamString::GetSize(), lldb_private::StreamString::GetString(), lldb_private::OptionDefinition::HasShortOption(), lldb_private::Stream::Indent(), lldb_private::Stream::IndentLess(), lldb_private::Stream::IndentMore(), lldb_private::CommandObject::IsDashDashCommand(), lldb_private::Stream::Printf(), PrintOption(), lldb_private::Stream::PutChar(), lldb_private::Stream::PutCString(), lldb_private::Stream::SetIndentLevel(), lldb_private::OptionDefinition::short_option, lldb_private::OptionDefinition::usage_text, and lldb_private::CommandObject::WantsRawCommandString().

Referenced by lldb_private::CommandObjectDisassemble::DoExecute(), lldb_private::CommandObject::GenerateHelpText(), lldb_private::CommandObject::HelpTextContainsWord(), and lldb_private::CommandObject::ParseOptions().

◆ GetDefinitions()

virtual llvm::ArrayRef<OptionDefinition> lldb_private::Options::GetDefinitions ( )
inlinevirtual

Reimplemented in CommandObjectRenderScriptRuntimeAllocationList::CommandOptions, CommandObjectRenderScriptRuntimeAllocationDump::CommandOptions, CommandObjectRenderScriptRuntimeKernelBreakpointSet::CommandOptions, CommandObjectRenderScriptRuntimeReductionBreakpointSet::CommandOptions, CommandObjectTargetModulesLookup::CommandOptions, CommandObjectTargetModulesShowUnwind::CommandOptions, CommandObjectTargetModulesList::CommandOptions, CommandObjectTargetModulesDumpLineTable::CommandOptions, CommandObjectTraceDumpInfo::CommandOptions, CommandObjectBreakpointWrite::CommandOptions, CommandObjectTraceDumpInstructions::CommandOptions, CommandObjectBreakpointRead::CommandOptions, CommandObjectTargetModulesDumpSymtab::CommandOptions, CommandObjectThreadPlanList::CommandOptions, CommandObjectProcessTraceSave::CommandOptions, CommandObjectPlatformShell::CommandOptions, CommandObjectThreadJump::CommandOptions, CommandObjectPlatformProcessAttach::CommandOptions, CommandObjectCommandsScriptAdd::CommandOptions, CommandObjectThreadReturn::CommandOptions, CommandObjectProcessHandle::CommandOptions, CommandObjectPlatformProcessList::CommandOptions, CommandObjectBreakpointDelete::CommandOptions, CommandObjectProcessStatus::CommandOptions, CommandObjectCommandsScriptImport::CommandOptions, CommandObjectBreakpointClear::CommandOptions, CommandObjectThreadInfo::CommandOptions, CommandObjectProcessSaveCore::CommandOptions, CommandObjectBreakpointList::CommandOptions, CommandObjectSettingsClear::CommandOptions, CommandObjectCommandsAddRegex::CommandOptions, CommandObjectTypeFormatterList< FormatterType >::CommandOptions, CommandObjectTypeFormatterClear::CommandOptions, CommandObjectThreadUntil::CommandOptions, CommandObjectProcessLoad::CommandOptions, CommandObjectObjC_ClassTable_Dump::CommandOptions, CommandObjectFrameRecognizerAdd::CommandOptions, CommandObjectProcessConnect::CommandOptions, CommandObjectTypeFormatterDelete::CommandOptions, CommandObjectWatchpointModify::CommandOptions, CommandObjectPlatformFWrite::CommandOptions, CommandObjectSourceList::CommandOptions, CommandObjectProcessDetach::CommandOptions, CommandObjectPlatformFRead::CommandOptions, CommandObjectWatchpointIgnore::CommandOptions, sddarwinlog_private::EnableOptions, CommandObjectProcessContinue::CommandOptions, CommandObjectBreakpointCommandDelete::CommandOptions, CommandObjectWatchpointDelete::CommandOptions, CommandObjectSettingsRead::CommandOptions, CommandObjectReproducerDump::CommandOptions, CommandObjectSettingsWrite::CommandOptions, CommandObjectProcessAttach::CommandOptions, CommandObjectTypeSynthAdd::CommandOptions, lldb_private::OptionGroupOptions, CommandObjectWatchpointCommandAdd::CommandOptions, CommandObjectFrameSelect::CommandOptions, CommandObjectReproducerXCrash::CommandOptions, CommandObjectTraceSchema::CommandOptions, CommandObjectWatchpointList::CommandOptions, CommandObjectTraceDump::CommandOptions, CommandObjectLogEnable::CommandOptions, CommandObjectCommandsSource::CommandOptions, CommandObjectSessionHistory::CommandOptions, CommandObjectTypeSummaryAdd::CommandOptions, CommandObjectSettingsSet::CommandOptions, CommandObjectSourceInfo::CommandOptions, CommandObjectThreadBacktrace::CommandOptions, CommandObjectFrameDiagnose::CommandOptions, CommandObjectStatsDump::CommandOptions, lldb_private::trace_intel_pt::CommandObjectProcessTraceStartIntelPT::CommandOptions, lldb_private::CommandObjectHelp::CommandOptions, CommandObjectTraceLoad::CommandOptions, lldb_private::CommandObjectDisassemble::CommandOptions, lldb_private::trace_intel_pt::CommandObjectThreadTraceStartIntelPT::CommandOptions, lldb_private::ctf::CommandObjectThreadTraceExportCTF::CommandOptions, and lldb_private::CommandObjectScript::CommandOptions.

Definition at line 97 of file Options.h.

◆ GetLongOptions()

Option * Options::GetLongOptions ( )

Get the option definitions to use when parsing Args options.

See also
Args::ParseOptions (Options&)
man getopt_long_only

Definition at line 202 of file Options.cpp.

◆ GetOptionalOptions()

OptionSetVector& lldb_private::Options::GetOptionalOptions ( )
inlineprotected

Definition at line 207 of file Options.h.

References BuildValidOptionSets(), and m_optional_options.

◆ GetRequiredOptions()

OptionSetVector& lldb_private::Options::GetRequiredOptions ( )
inlineprotected

Definition at line 202 of file Options.h.

References BuildValidOptionSets(), and m_required_options.

◆ HandleOptionArgumentCompletion()

void Options::HandleOptionArgumentCompletion ( lldb_private::CompletionRequest &  request,
OptionElementVector &  opt_element_vector,
int  opt_element_index,
CommandInterpreter &  interpreter 
)
virtual

Handles the generic bits of figuring out whether we are in an option, and if so completing it.

Parameters
[in,out]requestThe completion request that we need to act upon.
[in]interpreterThe command interpreter doing the completion.

Reimplemented in CommandObjectBreakpointRead::CommandOptions.

Definition at line 678 of file Options.cpp.

References lldb_private::CommandObject::ArgumentTableEntry::completion_type, lldb::eArgTypeNone, lldb_private::Args::GetArgumentAtIndex(), lldb_private::CommandInterpreter::GetDebugger(), lldb_private::CompletionRequest::GetParsedLine(), lldb_private::Debugger::GetSelectedTarget(), and lldb_private::CompletionRequest::TryCompleteCurrentArg().

◆ HandleOptionCompletion()

bool Options::HandleOptionCompletion ( lldb_private::CompletionRequest &  request,
OptionElementVector &  option_map,
CommandInterpreter &  interpreter 
)

Handles the generic bits of figuring out whether we are in an option, and if so completing it.

Parameters
[in,out]requestThe completion request that we need to act upon.
[in]interpreterThe interpreter that's doing the completing.

FIXME: This is the wrong return value, since we also need to make a distinction between total number of matches, and the window the user wants returned.

Returns
true if we were in an option, false otherwise.

Definition at line 583 of file Options.cpp.

References lldb_private::CompletionRequest::AddCompletion(), lldb_private::CompletionRequest::GetCursorArgumentPrefix(), lldb_private::CompletionRequest::GetCursorIndex(), lldb_private::OptionDefinition::long_option, string(), and lldb_private::OptionDefinition::usage_text.

Referenced by lldb_private::CommandObject::HandleCompletion().

◆ IsASubset()

bool Options::IsASubset ( const OptionSet &  set_a,
const OptionSet &  set_b 
)
protected

Definition at line 48 of file Options.cpp.

◆ NotifyOptionParsingFinished()

Status Options::NotifyOptionParsingFinished ( ExecutionContext *  execution_context)

Definition at line 40 of file Options.cpp.

Referenced by lldb_private::CommandObject::ParseOptions(), and lldb_private::CommandObject::ParseOptionsAndNotify().

◆ NotifyOptionParsingStarting()

void Options::NotifyOptionParsingStarting ( ExecutionContext *  execution_context)

Definition at line 33 of file Options.cpp.

Referenced by lldb_private::CommandObject::ParseOptions(), and ProcessAliasOptionsArgs().

◆ NumCommandOptions()

uint32_t Options::NumCommandOptions ( )

Definition at line 200 of file Options.cpp.

Referenced by lldb_private::CommandObject::GenerateHelpText().

◆ OptionParsingFinished()

virtual Status lldb_private::Options::OptionParsingFinished ( ExecutionContext *  execution_context)
inlineprotectedvirtual

Reimplemented in CommandObjectTargetModulesLookup::CommandOptions, lldb_private::OptionGroupOptions, and lldb_private::CommandObjectDisassemble::CommandOptions.

Definition at line 225 of file Options.h.

References error().

◆ OptionParsingStarting()

virtual void lldb_private::Options::OptionParsingStarting ( ExecutionContext *  execution_context)
protectedpure virtual

Implemented in CommandObjectTargetModulesLookup::CommandOptions, CommandObjectTargetModulesShowUnwind::CommandOptions, CommandObjectTargetModulesList::CommandOptions, CommandObjectTargetModulesDumpLineTable::CommandOptions, CommandObjectTraceDumpInfo::CommandOptions, CommandObjectBreakpointWrite::CommandOptions, CommandObjectTraceDumpInstructions::CommandOptions, CommandObjectBreakpointRead::CommandOptions, CommandObjectTargetModulesDumpSymtab::CommandOptions, CommandObjectThreadPlanList::CommandOptions, CommandObjectPlatformShell::CommandOptions, CommandObjectProcessTraceSave::CommandOptions, CommandObjectThreadJump::CommandOptions, CommandObjectPlatformProcessAttach::CommandOptions, CommandObjectThreadReturn::CommandOptions, CommandObjectCommandsScriptAdd::CommandOptions, CommandObjectProcessHandle::CommandOptions, CommandObjectPlatformProcessList::CommandOptions, CommandObjectBreakpointDelete::CommandOptions, CommandObjectProcessStatus::CommandOptions, CommandObjectCommandsScriptImport::CommandOptions, CommandObjectBreakpointClear::CommandOptions, CommandObjectThreadInfo::CommandOptions, CommandObjectProcessSaveCore::CommandOptions, CommandObjectBreakpointList::CommandOptions, CommandObjectSettingsClear::CommandOptions, CommandObjectCommandsAddRegex::CommandOptions, CommandObjectTypeFormatterList< FormatterType >::CommandOptions, CommandObjectTypeFormatterClear::CommandOptions, CommandObjectThreadUntil::CommandOptions, CommandObjectProcessLoad::CommandOptions, CommandObjectObjC_ClassTable_Dump::CommandOptions, CommandObjectFrameRecognizerAdd::CommandOptions, CommandObjectProcessConnect::CommandOptions, CommandObjectTypeFormatterDelete::CommandOptions, CommandObjectWatchpointModify::CommandOptions, CommandObjectPlatformFWrite::CommandOptions, CommandObjectSourceList::CommandOptions, CommandObjectProcessDetach::CommandOptions, CommandObjectPlatformFRead::CommandOptions, CommandObjectWatchpointIgnore::CommandOptions, CommandObjectProcessContinue::CommandOptions, CommandObjectBreakpointCommandDelete::CommandOptions, CommandObjectWatchpointDelete::CommandOptions, sddarwinlog_private::EnableOptions, CommandObjectSettingsRead::CommandOptions, CommandObjectReproducerDump::CommandOptions, CommandObjectSettingsWrite::CommandOptions, CommandObjectProcessAttach::CommandOptions, CommandObjectTypeSynthAdd::CommandOptions, lldb_private::OptionGroupOptions, CommandObjectWatchpointCommandAdd::CommandOptions, CommandObjectFrameSelect::CommandOptions, CommandObjectReproducerXCrash::CommandOptions, CommandObjectTraceSchema::CommandOptions, CommandObjectWatchpointList::CommandOptions, CommandObjectTraceDump::CommandOptions, CommandObjectLogEnable::CommandOptions, CommandObjectTypeSummaryAdd::CommandOptions, CommandObjectCommandsSource::CommandOptions, CommandObjectSessionHistory::CommandOptions, CommandObjectSettingsSet::CommandOptions, CommandObjectThreadBacktrace::CommandOptions, CommandObjectFrameDiagnose::CommandOptions, CommandObjectSourceInfo::CommandOptions, CommandObjectStatsDump::CommandOptions, lldb_private::trace_intel_pt::CommandObjectProcessTraceStartIntelPT::CommandOptions, CommandObjectTraceLoad::CommandOptions, lldb_private::CommandObjectHelp::CommandOptions, lldb_private::CommandObjectDisassemble::CommandOptions, lldb_private::trace_intel_pt::CommandObjectThreadTraceStartIntelPT::CommandOptions, lldb_private::CommandObjectScript::CommandOptions, lldb_private::ctf::CommandObjectThreadTraceExportCTF::CommandOptions, CommandObjectRenderScriptRuntimeAllocationList::CommandOptions, CommandObjectRenderScriptRuntimeAllocationDump::CommandOptions, CommandObjectRenderScriptRuntimeKernelBreakpointSet::CommandOptions, and CommandObjectRenderScriptRuntimeReductionBreakpointSet::CommandOptions.

◆ OptionSeen()

void Options::OptionSeen ( int  short_option)

Definition at line 44 of file Options.cpp.

◆ OptionsSetDiff()

size_t Options::OptionsSetDiff ( const OptionSet &  set_a,
const OptionSet &  set_b,
OptionSet &  diffs 
)
protected

Definition at line 68 of file Options.cpp.

◆ OptionsSetUnion()

void Options::OptionsSetUnion ( const OptionSet &  set_a,
const OptionSet &  set_b,
OptionSet &  union_set 
)
protected

Definition at line 88 of file Options.cpp.

◆ OutputFormattedUsageText()

void Options::OutputFormattedUsageText ( Stream &  strm,
const OptionDefinition &  option_def,
uint32_t  output_max_columns 
)

Definition at line 266 of file Options.cpp.

References lldb_private::Stream::EOL(), lldb_private::Stream::GetIndentLevel(), lldb_private::Stream::Indent(), string(), lldb_private::OptionDefinition::usage_text, lldb_private::OptionDefinition::validator, and lldb_private::Stream::Write().

◆ Parse()

llvm::Expected< Args > Options::Parse ( const Args &  args,
ExecutionContext *  execution_context,
lldb::PlatformSP  platform_sp,
bool  require_validation 
)

Parse the provided arguments.

The parsed options are set via calls to SetOptionValue. In case of a successful parse, the function returns a copy of the input arguments with the parsed options removed. Otherwise, it returns an error.

param[in] platform_sp The platform used for option validation. This is necessary because an empty execution_context is not enough to get us to a reasonable platform. If the platform isn't given, we'll try to get it from the execution context. If we can't get it from the execution context, we'll skip validation.

param[in] require_validation When true, it will fail option parsing if validation could not occur due to not having a platform.

Definition at line 1227 of file Options.cpp.

References BuildShortOptions(), lldb_private::Option::definition, error(), lldb_private::Option::flag, GetArgvForParsing(), lldb_private::ExecutionContext::GetTargetSP(), lldb_private::OptionDefinition::long_option, lldb_private::OptionDefinition::option_has_arg, ReconstituteArgsAfterParsing(), string(), lldb_private::Option::val, and lldb_private::OptionDefinition::validator.

Referenced by lldb_private::CommandObject::ParseOptions().

◆ ParseAlias()

llvm::Expected< Args > Options::ParseAlias ( const Args &  args,
OptionArgVector *  option_arg_vector,
std::string &  input_line 
)

Definition at line 911 of file Options.cpp.

References BuildShortOptions(), lldb_private::Option::definition, lldb_private::Args::DeleteArgumentAtIndex(), FindArgumentIndexForOption(), lldb_private::Option::flag, lldb_private::Args::GetArgumentCount(), GetArgvForParsing(), lldb_private::StreamString::GetString(), lldb_private::OptionDefinition::option_has_arg, lldb_private::Stream::Printf(), string(), and lldb_private::Option::val.

Referenced by ProcessAliasOptionsArgs().

◆ ParseForCompletion()

OptionElementVector Options::ParseForCompletion ( const Args &  args,
uint32_t  cursor_index 
)

Definition at line 1040 of file Options.cpp.

References BuildShortOptions(), lldb_private::Option::definition, FindOriginalIndex(), lldb_private::Option::flag, GetArgvForParsing(), lldb_private::Args::ArgEntry::IsQuoted(), lldb_private::OptionDefinition::option_has_arg, lldb_private::Args::ArgEntry::ref(), string(), and lldb_private::Option::val.

Referenced by lldb_private::CommandObject::HandleCompletion().

◆ SetOptionValue()

virtual Status lldb_private::Options::SetOptionValue ( uint32_t  option_idx,
llvm::StringRef  option_arg,
ExecutionContext *  execution_context 
)
pure virtual

Set the value of an option.

Parameters
[in]option_idxThe index into the "struct option" array that was returned by Options::GetLongOptions().
[in]option_argThe argument value for the option that the user entered, or nullptr if there is no argument for the current option.
[in]execution_contextThe execution context to use for evaluating the option. May be nullptr if the option is to be evaluated outside any particular context.
See also
Args::ParseOptions (Options&)
man getopt_long_only

Implemented in CommandObjectTargetModulesLookup::CommandOptions, CommandObjectTargetModulesShowUnwind::CommandOptions, CommandObjectTargetModulesList::CommandOptions, CommandObjectTargetModulesDumpLineTable::CommandOptions, CommandObjectTraceDumpInfo::CommandOptions, CommandObjectBreakpointWrite::CommandOptions, CommandObjectTraceDumpInstructions::CommandOptions, CommandObjectBreakpointRead::CommandOptions, CommandObjectTargetModulesDumpSymtab::CommandOptions, CommandObjectThreadPlanList::CommandOptions, CommandObjectPlatformShell::CommandOptions, CommandObjectProcessTraceSave::CommandOptions, CommandObjectThreadJump::CommandOptions, CommandObjectPlatformProcessAttach::CommandOptions, CommandObjectThreadReturn::CommandOptions, CommandObjectCommandsScriptAdd::CommandOptions, CommandObjectProcessHandle::CommandOptions, CommandObjectBreakpointDelete::CommandOptions, CommandObjectProcessStatus::CommandOptions, CommandObjectPlatformProcessList::CommandOptions, CommandObjectCommandsScriptImport::CommandOptions, CommandObjectBreakpointClear::CommandOptions, CommandObjectThreadInfo::CommandOptions, CommandObjectProcessSaveCore::CommandOptions, CommandObjectBreakpointList::CommandOptions, CommandObjectSettingsClear::CommandOptions, CommandObjectCommandsAddRegex::CommandOptions, CommandObjectTypeFormatterList< FormatterType >::CommandOptions, CommandObjectTypeFormatterClear::CommandOptions, CommandObjectProcessLoad::CommandOptions, CommandObjectThreadUntil::CommandOptions, CommandObjectObjC_ClassTable_Dump::CommandOptions, CommandObjectProcessConnect::CommandOptions, CommandObjectFrameRecognizerAdd::CommandOptions, CommandObjectTypeFormatterDelete::CommandOptions, CommandObjectWatchpointModify::CommandOptions, CommandObjectPlatformFWrite::CommandOptions, CommandObjectProcessDetach::CommandOptions, CommandObjectSourceList::CommandOptions, CommandObjectPlatformFRead::CommandOptions, CommandObjectWatchpointIgnore::CommandOptions, CommandObjectProcessContinue::CommandOptions, CommandObjectBreakpointCommandDelete::CommandOptions, sddarwinlog_private::EnableOptions, CommandObjectWatchpointDelete::CommandOptions, CommandObjectSettingsRead::CommandOptions, CommandObjectSettingsWrite::CommandOptions, CommandObjectProcessAttach::CommandOptions, lldb_private::OptionGroupOptions, CommandObjectTypeSynthAdd::CommandOptions, CommandObjectWatchpointCommandAdd::CommandOptions, CommandObjectFrameSelect::CommandOptions, CommandObjectTraceSchema::CommandOptions, CommandObjectWatchpointList::CommandOptions, CommandObjectTraceDump::CommandOptions, CommandObjectTypeSummaryAdd::CommandOptions, CommandObjectCommandsSource::CommandOptions, CommandObjectLogEnable::CommandOptions, CommandObjectSettingsSet::CommandOptions, CommandObjectSessionHistory::CommandOptions, CommandObjectStatsDump::CommandOptions, lldb_private::trace_intel_pt::CommandObjectProcessTraceStartIntelPT::CommandOptions, CommandObjectThreadBacktrace::CommandOptions, CommandObjectFrameDiagnose::CommandOptions, CommandObjectSourceInfo::CommandOptions, lldb_private::CommandObjectHelp::CommandOptions, lldb_private::CommandObjectDisassemble::CommandOptions, lldb_private::trace_intel_pt::CommandObjectThreadTraceStartIntelPT::CommandOptions, lldb_private::CommandObjectScript::CommandOptions, lldb_private::ctf::CommandObjectThreadTraceExportCTF::CommandOptions, CommandObjectRenderScriptRuntimeAllocationList::CommandOptions, CommandObjectRenderScriptRuntimeAllocationDump::CommandOptions, CommandObjectRenderScriptRuntimeKernelBreakpointSet::CommandOptions, and CommandObjectRenderScriptRuntimeReductionBreakpointSet::CommandOptions.

◆ SupportsLongOption()

bool Options::SupportsLongOption ( const char *  long_option)

Definition at line 326 of file Options.cpp.

◆ VerifyOptions()

bool Options::VerifyOptions ( CommandReturnObject &  result)

Definition at line 106 of file Options.cpp.

References lldb_private::CommandReturnObject::AppendError(), lldb::eReturnStatusSuccessFinishNoResult, and lldb_private::CommandReturnObject::SetStatus().

Referenced by lldb_private::CommandObject::ParseOptions().

◆ VerifyPartialOptions()

bool Options::VerifyPartialOptions ( CommandReturnObject &  result)

Definition at line 563 of file Options.cpp.

Referenced by ProcessAliasOptionsArgs().

Member Data Documentation

◆ m_getopt_table

std::vector<Option> lldb_private::Options::m_getopt_table
protected

Definition at line 197 of file Options.h.

Referenced by lldb_private::CommandObjectHelp::CommandOptions::SetOptionValue().

◆ m_optional_options

OptionSetVector lldb_private::Options::m_optional_options
protected

Definition at line 200 of file Options.h.

Referenced by GetOptionalOptions().

◆ m_required_options

OptionSetVector lldb_private::Options::m_required_options
protected

Definition at line 199 of file Options.h.

Referenced by GetRequiredOptions().

◆ m_seen_options

OptionSet lldb_private::Options::m_seen_options
protected

Definition at line 198 of file Options.h.

The documentation for this class was generated from the following files:
Generated on Tue May 17 2022 21:01:22 for LLDB by   doxygen 1.8.17