CommandObjectTarget.cpp File Reference

#include "CommandObjectTarget.h"
#include "lldb/Core/Debugger.h"
#include "lldb/Core/IOHandler.h"
#include "lldb/Core/Module.h"
#include "lldb/Core/ModuleSpec.h"
#include "lldb/Core/Section.h"
#include "lldb/Core/ValueObjectVariable.h"
#include "lldb/DataFormatters/ValueObjectPrinter.h"
#include "lldb/Host/OptionParser.h"
#include "lldb/Interpreter/CommandInterpreter.h"
#include "lldb/Interpreter/CommandReturnObject.h"
#include "lldb/Interpreter/OptionArgParser.h"
#include "lldb/Interpreter/OptionGroupArchitecture.h"
#include "lldb/Interpreter/OptionGroupBoolean.h"
#include "lldb/Interpreter/OptionGroupFile.h"
#include "lldb/Interpreter/OptionGroupFormat.h"
#include "lldb/Interpreter/OptionGroupString.h"
#include "lldb/Interpreter/OptionGroupUInt64.h"
#include "lldb/Interpreter/OptionGroupUUID.h"
#include "lldb/Interpreter/OptionGroupValueObjectDisplay.h"
#include "lldb/Interpreter/OptionGroupVariable.h"
#include "lldb/Interpreter/Options.h"
#include "lldb/Symbol/CompileUnit.h"
#include "lldb/Symbol/FuncUnwinders.h"
#include "lldb/Symbol/LineTable.h"
#include "lldb/Symbol/LocateSymbolFile.h"
#include "lldb/Symbol/ObjectFile.h"
#include "lldb/Symbol/SymbolFile.h"
#include "lldb/Symbol/UnwindPlan.h"
#include "lldb/Symbol/VariableList.h"
#include "lldb/Target/ABI.h"
#include "lldb/Target/Process.h"
#include "lldb/Target/RegisterContext.h"
#include "lldb/Target/SectionLoadList.h"
#include "lldb/Target/StackFrame.h"
#include "lldb/Target/Thread.h"
#include "lldb/Target/ThreadSpec.h"
#include "lldb/Utility/Args.h"
#include "lldb/Utility/State.h"
#include "lldb/Utility/Timer.h"
#include "llvm/Support/FileSystem.h"
#include "llvm/Support/FormatAdapters.h"
#include "CommandOptions.inc"

Include dependency graph for CommandObjectTarget.cpp:

Go to the source code of this file.

Classes
class	OptionGroupDependents
class	CommandObjectTargetCreate
class	CommandObjectTargetList
class	CommandObjectTargetSelect
class	CommandObjectTargetDelete
class	CommandObjectTargetShowLaunchEnvironment
class	CommandObjectTargetVariable
class	CommandObjectTargetModulesSearchPathsAdd
class	CommandObjectTargetModulesSearchPathsClear
class	CommandObjectTargetModulesSearchPathsInsert
class	CommandObjectTargetModulesSearchPathsList
class	CommandObjectTargetModulesSearchPathsQuery
class	CommandObjectTargetModulesModuleAutoComplete
class	CommandObjectTargetModulesSourceFileAutoComplete
class	CommandObjectTargetModulesDumpObjfile
class	CommandObjectTargetModulesDumpSymtab
class	CommandObjectTargetModulesDumpSymtab::CommandOptions
class	CommandObjectTargetModulesDumpSections
class	CommandObjectTargetModulesDumpClangAST
class	CommandObjectTargetModulesDumpSymfile
class	CommandObjectTargetModulesDumpLineTable
class	CommandObjectTargetModulesDumpLineTable::CommandOptions
class	CommandObjectTargetModulesDump
class	CommandObjectTargetModulesAdd
class	CommandObjectTargetModulesLoad
class	CommandObjectTargetModulesList
class	CommandObjectTargetModulesList::CommandOptions
class	CommandObjectTargetModulesShowUnwind
class	CommandObjectTargetModulesShowUnwind::CommandOptions
class	CommandObjectTargetModulesLookup
class	CommandObjectTargetModulesLookup::CommandOptions
class	CommandObjectTargetModulesImageSearchPaths
class	CommandObjectTargetModules
class	CommandObjectTargetSymbolsAdd
class	CommandObjectTargetSymbols
class	CommandObjectTargetStopHookAdd
class	CommandObjectTargetStopHookAdd::CommandOptions
class	CommandObjectTargetStopHookDelete
class	CommandObjectTargetStopHookEnableDisable
class	CommandObjectTargetStopHookList
class	CommandObjectMultiwordTargetStopHooks

Macros
#define	LLDB_OPTIONS_target_dependents
#define	LLDB_OPTIONS_target_modules_dump_symtab
#define	LLDB_OPTIONS_target_modules_dump
#define	LLDB_OPTIONS_target_modules_list
#define	LLDB_OPTIONS_target_modules_show_unwind
#define	LLDB_OPTIONS_target_modules_lookup
#define	LLDB_OPTIONS_target_stop_hook_add

Functions
static void	DumpTargetInfo (uint32_t target_idx, Target *target, const char *prefix_cstr, bool show_stopped_process_status, Stream &strm)
static uint32_t	DumpTargetList (TargetList &target_list, bool show_stopped_process_status, Stream &strm)
static void	DumpModuleArchitecture (Stream &strm, Module *module, bool full_triple, uint32_t width)
static void	DumpModuleUUID (Stream &strm, Module *module)
static uint32_t	DumpCompileUnitLineTable (CommandInterpreter &interpreter, Stream &strm, Module *module, const FileSpec &file_spec, lldb::DescriptionLevel desc_level)
static void	DumpFullpath (Stream &strm, const FileSpec *file_spec_ptr, uint32_t width)
static void	DumpDirectory (Stream &strm, const FileSpec *file_spec_ptr, uint32_t width)
static void	DumpBasename (Stream &strm, const FileSpec *file_spec_ptr, uint32_t width)
static size_t	DumpModuleObjfileHeaders (Stream &strm, ModuleList &module_list)
static void	DumpModuleSymtab (CommandInterpreter &interpreter, Stream &strm, Module *module, SortOrder sort_order, Mangled::NamePreference name_preference)
static void	DumpModuleSections (CommandInterpreter &interpreter, Stream &strm, Module *module)
static bool	DumpModuleSymbolFile (Stream &strm, Module *module)
static void	DumpAddress (ExecutionContextScope *exe_scope, const Address &so_addr, bool verbose, Stream &strm)
static bool	LookupAddressInModule (CommandInterpreter &interpreter, Stream &strm, Module *module, uint32_t resolve_mask, lldb::addr_t raw_addr, lldb::addr_t offset, bool verbose)
static uint32_t	LookupSymbolInModule (CommandInterpreter &interpreter, Stream &strm, Module *module, const char *name, bool name_is_regex, bool verbose)
static void	DumpSymbolContextList (ExecutionContextScope *exe_scope, Stream &strm, SymbolContextList &sc_list, bool verbose)
static size_t	LookupFunctionInModule (CommandInterpreter &interpreter, Stream &strm, Module *module, const char *name, bool name_is_regex, bool include_inlines, bool include_symbols, bool verbose)
static size_t	LookupTypeInModule (CommandInterpreter &interpreter, Stream &strm, Module *module, const char *name_cstr, bool name_is_regex)
static size_t	LookupTypeHere (CommandInterpreter &interpreter, Stream &strm, Module &module, const char *name_cstr, bool name_is_regex)
static uint32_t	LookupFileAndLineInModule (CommandInterpreter &interpreter, Stream &strm, Module *module, const FileSpec &file_spec, uint32_t line, bool check_inlines, bool verbose)
static size_t	FindModulesByName (Target *target, const char *module_name, ModuleList &module_list, bool check_global_list)

Variables
static constexpr OptionEnumValueElement	g_dependents_enumaration []
static constexpr OptionEnumValueElement	g_sort_option_enumeration []

Macro Definition Documentation

LLDB_OPTIONS_target_dependents

#define LLDB_OPTIONS_target_dependents

Definition at line 153 of file CommandObjectTarget.cpp.

LLDB_OPTIONS_target_modules_dump

#define LLDB_OPTIONS_target_modules_dump

Definition at line 2325 of file CommandObjectTarget.cpp.

LLDB_OPTIONS_target_modules_dump_symtab

#define LLDB_OPTIONS_target_modules_dump_symtab

Definition at line 1945 of file CommandObjectTarget.cpp.

LLDB_OPTIONS_target_modules_list

#define LLDB_OPTIONS_target_modules_list

Definition at line 2900 of file CommandObjectTarget.cpp.

LLDB_OPTIONS_target_modules_lookup

#define LLDB_OPTIONS_target_modules_lookup

Definition at line 3565 of file CommandObjectTarget.cpp.

LLDB_OPTIONS_target_modules_show_unwind

#define LLDB_OPTIONS_target_modules_show_unwind

Definition at line 3242 of file CommandObjectTarget.cpp.

LLDB_OPTIONS_target_stop_hook_add

#define LLDB_OPTIONS_target_stop_hook_add

Definition at line 4402 of file CommandObjectTarget.cpp.

Function Documentation

DumpAddress()

static void DumpAddress ( ExecutionContextScope *  exe_scope, const Address &  so_addr, bool  verbose, Stream &  strm  )

static

Definition at line 1458 of file CommandObjectTarget.cpp.

References lldb_private::Address::Dump(), lldb_private::Stream::EOL(), lldb_private::Stream::GetIndentLevel(), lldb_private::Stream::Indent(), lldb_private::Stream::IndentLess(), lldb_private::Stream::IndentMore(), lldb_private::Stream::PutCString(), and lldb_private::Stream::SetIndentLevel().

Referenced by DWARFDebugRanges::Dump(), DumpSymbolContextList(), LookupAddressInModule(), and LookupSymbolInModule().

DumpBasename()

static void DumpBasename ( Stream &  strm, const FileSpec *  file_spec_ptr, uint32_t  width  )

static

Definition at line 1380 of file CommandObjectTarget.cpp.

References lldb_private::ConstString::AsCString(), lldb_private::ConstString::Dump(), lldb_private::FileSpec::GetFilename(), and lldb_private::Stream::Printf().

Referenced by CommandObjectTargetModulesList::PrintModule().

DumpCompileUnitLineTable()

static uint32_t DumpCompileUnitLineTable ( CommandInterpreter &  interpreter, Stream &  strm, Module *  module, const FileSpec &  file_spec, lldb::DescriptionLevel  desc_level  )

static

Definition at line 1318 of file CommandObjectTarget.cpp.

References lldb_private::SymbolContext::comp_unit, lldb_private::SymbolContextList::GetContextAtIndex(), lldb_private::LineTable::GetDescription(), lldb_private::CommandInterpreter::GetExecutionContext(), lldb_private::FileSpec::GetFilename(), lldb_private::Module::GetFileSpec(), lldb_private::CompileUnit::GetLineTable(), lldb_private::CompileUnit::GetPrimaryFile(), lldb_private::ExecutionContext::GetTargetPtr(), and lldb_private::Module::ResolveSymbolContextsForFileSpec().

Referenced by CommandObjectTargetModulesDumpLineTable::DoExecute().

DumpDirectory()

static void DumpDirectory ( Stream &  strm, const FileSpec *  file_spec_ptr, uint32_t  width  )

static

Definition at line 1366 of file CommandObjectTarget.cpp.

References lldb_private::ConstString::AsCString(), lldb_private::ConstString::Dump(), lldb_private::FileSpec::GetDirectory(), and lldb_private::Stream::Printf().

Referenced by CommandObjectProcessMinidumpDump::DoExecute(), and CommandObjectTargetModulesList::PrintModule().

DumpFullpath()

static void DumpFullpath ( Stream &  strm, const FileSpec *  file_spec_ptr, uint32_t  width  )

static

Definition at line 1349 of file CommandObjectTarget.cpp.

References lldb_private::Stream::AsRawOstream(), lldb_private::FileSpec::Dump(), lldb_private::FileSpec::GetPath(), and lldb_private::Stream::Printf().

Referenced by LookupFileAndLineInModule(), LookupFunctionInModule(), LookupSymbolInModule(), LookupTypeHere(), LookupTypeInModule(), and CommandObjectTargetModulesList::PrintModule().

DumpModuleArchitecture()

static void DumpModuleArchitecture ( Stream &  strm, Module *  module, bool  full_triple, uint32_t  width  )

static

Definition at line 1293 of file CommandObjectTarget.cpp.

References lldb_private::Stream::AsRawOstream(), lldb_private::ArchSpec::DumpTriple(), lldb_private::Module::GetArchitecture(), lldb_private::ArchSpec::GetArchitectureName(), lldb_private::StreamString::GetString(), lldb_private::Stream::Printf(), and lldb_private::Stream::PutCString().

Referenced by CommandObjectTargetModulesList::PrintModule().

DumpModuleObjfileHeaders()

static size_t DumpModuleObjfileHeaders ( Stream &  strm, ModuleList &  module_list  )

static

Definition at line 1394 of file CommandObjectTarget.cpp.

References lldb_private::ObjectFile::Dump(), lldb_private::Stream::EOL(), lldb_private::Stream::Format(), lldb_private::Module::GetFileSpec(), lldb_private::ModuleList::GetModulePointerAtIndexUnlocked(), lldb_private::ModuleList::GetMutex(), lldb_private::Module::GetObjectFile(), lldb_private::ModuleList::GetSize(), lldb_private::Stream::IndentLess(), lldb_private::Stream::IndentMore(), and lldb_private::Stream::Printf().

Referenced by CommandObjectTargetModulesDumpObjfile::DoExecute().

DumpModuleSections()

static void DumpModuleSections ( CommandInterpreter &  interpreter, Stream &  strm, Module *  module  )

static

Definition at line 1433 of file CommandObjectTarget.cpp.

References lldb_private::Stream::AsRawOstream(), lldb_private::SectionList::Dump(), lldb_private::Module::GetArchitecture(), lldb_private::ArchSpec::GetArchitectureName(), lldb_private::CommandInterpreter::GetExecutionContext(), lldb_private::Stream::GetIndentLevel(), lldb_private::Module::GetSectionList(), lldb_private::Module::GetSpecificationDescription(), lldb_private::ExecutionContext::GetTargetPtr(), lldb_private::Stream::Printf(), and UINT32_MAX.

Referenced by CommandObjectTargetModulesDumpSections::DoExecute().

DumpModuleSymbolFile()

static bool DumpModuleSymbolFile ( Stream &  strm, Module *  module  )

static

Definition at line 1448 of file CommandObjectTarget.cpp.

References lldb_private::Module::GetSymbolFile().

Referenced by CommandObjectTargetModulesDumpSymfile::DoExecute().

DumpModuleSymtab()

static void DumpModuleSymtab ( CommandInterpreter &  interpreter, Stream &  strm, Module *  module, SortOrder  sort_order, Mangled::NamePreference  name_preference  )

static

Definition at line 1423 of file CommandObjectTarget.cpp.

References lldb_private::CommandInterpreter::GetExecutionContext(), lldb_private::Module::GetSymtab(), and lldb_private::ExecutionContext::GetTargetPtr().

Referenced by CommandObjectTargetModulesDumpSymtab::DoExecute().

DumpModuleUUID()

static void DumpModuleUUID ( Stream &  strm, Module *  module  )

static

Definition at line 1311 of file CommandObjectTarget.cpp.

References lldb_private::UUID::Dump(), lldb_private::Module::GetUUID(), lldb_private::UUID::IsValid(), and lldb_private::Stream::PutCString().

Referenced by CommandObjectTargetModulesList::PrintModule().

DumpSymbolContextList()

static void DumpSymbolContextList ( ExecutionContextScope *  exe_scope, Stream &  strm, SymbolContextList &  sc_list, bool  verbose  )

static

Definition at line 1573 of file CommandObjectTarget.cpp.

References DumpAddress(), lldb_private::SymbolContext::GetAddressRange(), lldb_private::AddressRange::GetBaseAddress(), lldb_private::SymbolContextList::GetContextAtIndex(), lldb_private::SymbolContextList::GetSize(), lldb_private::Stream::IndentLess(), and lldb_private::Stream::IndentMore().

Referenced by LookupFileAndLineInModule(), and LookupFunctionInModule().

DumpTargetInfo()

static void DumpTargetInfo ( uint32_t  target_idx, Target *  target, const char *  prefix_cstr, bool  show_stopped_process_status, Stream &  strm  )

static

Definition at line 58 of file CommandObjectTarget.cpp.

References lldb_private::Stream::AsRawOstream(), lldb_private::ArchSpec::DumpTriple(), lldb_private::Stream::EOL(), lldb_private::Target::GetArchitecture(), lldb_private::Target::GetExecutableModulePointer(), lldb_private::Module::GetFileSpec(), lldb_private::FileSpec::GetPath(), lldb_private::Target::GetPlatform(), lldb_private::Target::GetProcessSP(), lldb_private::ArchSpec::IsValid(), LLDB_INVALID_PROCESS_ID, PATH_MAX, lldb_private::Stream::Printf(), lldb_private::Stream::PutCString(), lldb_private::StateAsCString(), and lldb_private::StateIsStoppedState().

Referenced by DumpTargetList().

DumpTargetList()

static uint32_t DumpTargetList ( TargetList &  target_list, bool  show_stopped_process_status, Stream &  strm  )

static

Definition at line 115 of file CommandObjectTarget.cpp.

References DumpTargetInfo(), lldb_private::TargetList::GetNumTargets(), lldb_private::TargetList::GetSelectedTarget(), lldb_private::TargetList::GetTargetAtIndex(), and lldb_private::Stream::PutCString().

Referenced by CommandObjectTargetList::DoExecute(), and CommandObjectTargetSelect::DoExecute().

FindModulesByName()

static size_t FindModulesByName ( Target *  target, const char *  module_name, ModuleList &  module_list, bool  check_global_list  )

static

Definition at line 1745 of file CommandObjectTarget.cpp.

References lldb_private::ModuleList::AppendIfNeeded(), lldb_private::ModuleList::FindModules(), lldb_private::ModuleSpec::GetArchitecture(), lldb_private::Target::GetArchitecture(), lldb_private::Target::GetImages(), lldb_private::ModuleList::GetSize(), and lldb_private::Module::MatchesModuleSpec().

Referenced by CommandObjectTargetModulesDumpObjfile::DoExecute(), CommandObjectTargetModulesDumpSymtab::DoExecute(), CommandObjectTargetModulesDumpSections::DoExecute(), CommandObjectTargetModulesDumpClangAST::DoExecute(), CommandObjectTargetModulesDumpSymfile::DoExecute(), CommandObjectTargetModulesLoad::DoExecute(), CommandObjectTargetModulesList::DoExecute(), and CommandObjectTargetModulesLookup::DoExecute().

LookupAddressInModule()

static bool LookupAddressInModule ( CommandInterpreter &  interpreter, Stream &  strm, Module *  module, uint32_t  resolve_mask, lldb::addr_t  raw_addr, lldb::addr_t  offset, bool  verbose  )

static

Definition at line 1479 of file CommandObjectTarget.cpp.

References DumpAddress(), lldb_private::ExecutionContext::GetBestExecutionContextScope(), lldb_private::CommandInterpreter::GetExecutionContext(), lldb_private::Address::GetModule(), lldb_private::Target::GetSectionLoadList(), lldb_private::ExecutionContext::GetTargetPtr(), lldb_private::SectionLoadList::IsEmpty(), lldb_private::Module::ResolveFileAddress(), and lldb_private::SectionLoadList::ResolveLoadAddress().

Referenced by CommandObjectTargetModulesLookup::LookupInModule().

LookupFileAndLineInModule()

static uint32_t LookupFileAndLineInModule ( CommandInterpreter &  interpreter, Stream &  strm, Module *  module, const FileSpec &  file_spec, uint32_t  line, bool  check_inlines, bool  verbose  )

static

Definition at line 1717 of file CommandObjectTarget.cpp.

References DumpFullpath(), DumpSymbolContextList(), lldb_private::ExecutionContext::GetBestExecutionContextScope(), lldb_private::CommandInterpreter::GetExecutionContext(), lldb_private::Module::GetFileSpec(), lldb_private::Stream::Indent(), lldb_private::Stream::Printf(), lldb_private::Stream::PutCString(), and lldb_private::Module::ResolveSymbolContextsForFileSpec().

Referenced by CommandObjectTargetModulesLookup::LookupInModule().

LookupFunctionInModule()

static size_t LookupFunctionInModule ( CommandInterpreter &  interpreter, Stream &  strm, Module *  module, const char *  name, bool  name_is_regex, bool  include_inlines, bool  include_symbols, bool  verbose  )

static

Definition at line 1593 of file CommandObjectTarget.cpp.

References DumpFullpath(), DumpSymbolContextList(), lldb_private::Module::FindFunctions(), lldb_private::ExecutionContext::GetBestExecutionContextScope(), lldb_private::CommandInterpreter::GetExecutionContext(), lldb_private::Module::GetFileSpec(), lldb_private::SymbolContextList::GetSize(), lldb_private::Stream::Indent(), lldb_private::Stream::Printf(), and lldb_private::Stream::PutCString().

Referenced by CommandObjectTargetModulesLookup::LookupInModule().

LookupSymbolInModule()

static uint32_t LookupSymbolInModule ( CommandInterpreter &  interpreter, Stream &  strm, Module *  module, const char *  name, bool  name_is_regex, bool  verbose  )

static

Definition at line 1529 of file CommandObjectTarget.cpp.

References lldb_private::Symtab::AppendSymbolIndexesMatchingRegExAndType(), lldb_private::Symtab::AppendSymbolIndexesWithName(), DumpAddress(), DumpFullpath(), lldb::eSymbolTypeAny, lldb_private::Symbol::GetAddressRef(), lldb_private::ExecutionContext::GetBestExecutionContextScope(), lldb_private::CommandInterpreter::GetExecutionContext(), lldb_private::Module::GetFileSpec(), lldb_private::ConstString::GetStringRef(), lldb_private::Module::GetSymtab(), lldb_private::Stream::Indent(), lldb_private::Stream::IndentLess(), lldb_private::Stream::IndentMore(), lldb_private::Stream::Printf(), lldb_private::Stream::PutCString(), lldb_private::Symtab::SymbolAtIndex(), and lldb_private::Symbol::ValueIsAddress().

Referenced by CommandObjectTargetModulesLookup::LookupInModule().

LookupTypeHere()

static size_t LookupTypeHere ( CommandInterpreter &  interpreter, Stream &  strm, Module &  module, const char *  name_cstr, bool  name_is_regex  )

static

Definition at line 1674 of file CommandObjectTarget.cpp.

References DumpFullpath(), lldb::eDescriptionLevelFull, lldb_private::TypeList::Empty(), lldb_private::Stream::EOL(), lldb_private::Module::FindTypes(), lldb_private::Module::GetFileSpec(), lldb_private::TypeList::GetSize(), lldb_private::TypeList::GetTypeAtIndex(), lldb_private::Stream::Indent(), lldb_private::Stream::Printf(), lldb_private::Stream::PutCString(), and UINT32_MAX.

Referenced by CommandObjectTargetModulesLookup::LookupHere().

LookupTypeInModule()

static size_t LookupTypeInModule ( CommandInterpreter &  interpreter, Stream &  strm, Module *  module, const char *  name_cstr, bool  name_is_regex  )

static

Definition at line 1627 of file CommandObjectTarget.cpp.

References DumpFullpath(), lldb::eDescriptionLevelFull, lldb_private::TypeList::Empty(), lldb_private::Stream::EOL(), lldb_private::Module::FindTypes(), lldb_private::Module::GetFileSpec(), lldb_private::TypeList::GetSize(), lldb_private::Stream::Indent(), lldb_private::Stream::Printf(), lldb_private::Stream::PutCString(), lldb_private::TypeList::Types(), and UINT32_MAX.

Referenced by CommandObjectTargetModulesLookup::LookupInModule().

Variable Documentation

g_dependents_enumaration

constexpr OptionEnumValueElement g_dependents_enumaration[]

static

Initial value:

= {
    {
        eLoadDependentsDefault,
        "default",
        "Only load dependents when the target is an executable.",
    },
    {
        eLoadDependentsNo,
        "true",
        "Don't load dependents, even if the target is an executable.",
    },
    {
        eLoadDependentsYes,
        "false",
        "Load dependents, even if the target is not an executable.",
    },
}

Definition at line 135 of file CommandObjectTarget.cpp.

g_sort_option_enumeration

constexpr OptionEnumValueElement g_sort_option_enumeration[]

static

Initial value:

= {
    {
        eSortOrderNone,
        "none",
        "No sorting, use the original symbol table order.",
    },
    {
        eSortOrderByAddress,
        "address",
        "Sort output by symbol address.",
    },
    {
        eSortOrderByName,
        "name",
        "Sort output by symbol name.",
    },
}

Definition at line 1927 of file CommandObjectTarget.cpp.