class TargetSymbols
Defined at line 35 of file ../../src/developer/debug/zxdb/symbols/target_symbols.h
Symbol interface for a Target. A target may or may not have a process, so this interface does not
deal with anything related to addresses. See ProcessSymbols for that (which is most of the
stuff).
We can know about symbols associated with a target even when the process isn't loaded. For
example, when setting a breakpoint on a symbol we can validate that it's a real symbol.
The current implementation is that all modifications to the list of symbol modules is done by the
ProcessSymbols which knows the actual symbols of the running program. This provides the minor
benefit of symbols being available between identical runs of the same binary (useful for setting
breakpoints).
More useful would be that the symbols could be automatically loaded when we know the binary we'll
be running, regardless of whether it's been started yet. This requires some system integration
(how do you find the local binary for something on the target?) and may also depend on how
typical programs will be started in the debugger (which may evolve).
Public Methods
void TargetSymbols (SystemSymbols * system_symbols)This class is copyable and assignable (to support cloning Targets). The SessionSymbolsImpl
object must outlive this class.
Defined at line 25 of file ../../src/developer/debug/zxdb/symbols/target_symbols.cc
void TargetSymbols (const TargetSymbols & other)Defined at line 26 of file ../../src/developer/debug/zxdb/symbols/target_symbols.cc
void ~TargetSymbols ()Defined at line 30 of file ../../src/developer/debug/zxdb/symbols/target_symbols.cc
TargetSymbols & operator= (const TargetSymbols & other)Defined at line 32 of file ../../src/developer/debug/zxdb/symbols/target_symbols.cc
void AddModule (fxl::RefPtr<ModuleSymbols> module)Notifications from ProcessSymbols to keep things in sync. Multiple add notifications are
allowed for the same module (this happens when the symbols exist, then the process is started
and the module is loaded for real).
Defined at line 38 of file ../../src/developer/debug/zxdb/symbols/target_symbols.cc
std::vector<fxl::RefPtr<ModuleSymbols>> TakeModules ()Returns |modules_| to the caller and clears |module_|.
Defined at line 42 of file ../../src/developer/debug/zxdb/symbols/target_symbols.cc
SystemSymbols * system_symbols ()Defined at line 45 of file ../../src/developer/debug/zxdb/symbols/target_symbols.h
std::vector<const ModuleSymbols *> GetModuleSymbols ()Returns the symbol information for all the modules known for this target.
Defined at line 49 of file ../../src/developer/debug/zxdb/symbols/target_symbols.cc
std::vector<Location> ResolveInputLocation (const InputLocation & input_location, const ResolveOptions & options)Converts the given InputLocation into one or more locations. The input can match zero, one, or
many locations.
If symbolize is true, the results will be symbolized, otherwise the output locations will be
regular addresses (this will be slightly faster).
This function will assert if given a kAddress-based InputLocation since that requires a running
process. If you need that, use the variant on ProcessSymbols.
Since the modules aren't loaded, there are no load addresses. As a result, all output addresses
will be 0. This function's purpose is to expand file/line information for symbols.
Defined at line 56 of file ../../src/developer/debug/zxdb/symbols/target_symbols.cc
std::vector<std::pair<std::string, std::string>> FindFileMatches (std::string_view name)Gets file matches across all known modules. Unlike ModuleSymbols::FindFileMatches(), it returns
a list of pairs of filenames and build directories associated with the filenames.
Defined at line 77 of file ../../src/developer/debug/zxdb/symbols/target_symbols.cc
std::string GetShortestUniqueFileName (std::string_view file_name)Returns the shortest possible name that uniquely identifies the given file in the index.
Multiple files with the same name can exist in the different directories. If a name is unique,
returns only the name part, otherwise appends directories from the right until the input is
disambiguated from all other files of the same name.
If the name isn't in the index, returns just the file part.
Defined at line 96 of file ../../src/developer/debug/zxdb/symbols/target_symbols.cc
void WillDestroyProcess ()A notification that the process associated with this target will be destroyed soon.
We use this notification to manage our ModuleSymbols cache.
Defined at line 118 of file ../../src/developer/debug/zxdb/symbols/target_symbols.cc