llvm-project/lldb/tools
Pavel Labath 90b0a53499 lldb-test symbols: Add ability to do name-based lookup
Summary:
lldb-test already had the ability to dump all symbol information in a
module. This is interesting, but it can be too verbose, and it also does
not use the same APIs that lldb uses to query symbol information. The
last part is interesting to me now, because I am about to add DWARF v5
debug_names support, which needs to implement these APIs.

This patch adds a set of arguments to lldb-test, which modify it's
behavior from dumping all symbols to dumping only the requested
information:
- --find={function,namespace,type,variable} - search for the given
  kind of objects.

- --name - the name to search for.

- --regex - whether to treat the "name" as a regular expression. This is
  not available for all lookup types (we do not have the required APIs
  for namespaces and types).

- --context - specifies the context, which can be used to restrict the
  search. This argument takes a variable name (which must be defined and
  be unique), and we then use the context that this variable is defined
  in as the search context.

- --function-flags={auto,full,base,method,selector} - a set of flags to
  further restrict the search for function symbols.

Together, these flags and their combinations cover the main SymbolFile
entry points which I will need to modify for the accelerator table
support, and so I plan to do most of the regression testing this way.
(I've also found this a useful tool for exploration of what the given
APIs are supposed to do.)

I add a couple of tests to demonstrate the usage of the usage of the
various options, and also an xfailed test which demonstrates a bug I
found while playing with this. The only requirement for these tests is
the presence of lld -- the should run on any platform which is able to
build lldb.

These tests use c++ code as input, but this isn't a requirement. It is also
possible to use IR, assembly or json to create the test module.

Reviewers: davide, zturner, asmith, JDevlieghere, clayborg, alexshap

Subscribers: mgorny, aprantl, lldb-commits

Differential Revision: https://reviews.llvm.org/D46318

llvm-svn: 331447
2018-05-03 10:57:16 +00:00
..
argdumper Fix LLVM_LINK_LLVM_DYLIB build (pr35053) 2017-10-31 13:23:19 +00:00
compact-unwind *** This commit represents a complete reformatting of the LLDB source code 2016-09-06 20:57:50 +00:00
darwin-debug [CMake] Refactor LLDB libraries and tools to be components 2016-12-15 22:01:17 +00:00
darwin-threads the thread id is easier to read in base16. 2018-03-06 23:33:02 +00:00
debugserver Silence compiler warning. 2018-05-02 17:11:43 +00:00
driver Fix LLVM_LINK_LLVM_DYLIB build (pr35053) 2017-10-31 13:23:19 +00:00
install-headers add back an Xcode-specific Makefile for header installation 2016-01-28 22:34:36 +00:00
intel-features Enable AUTOBRIEF in doxygen configuration. 2018-05-02 16:55:16 +00:00
lldb-mi Replace an accidentally added "break" with an LLVM_FALLTHROUGH. 2017-12-19 23:16:38 +00:00
lldb-perf Make lldb -Werror clean for -Wstring-conversion 2017-01-06 00:38:06 +00:00
lldb-server Move Args.cpp from Interpreter to Utility 2018-04-17 18:53:35 +00:00
lldb-test lldb-test symbols: Add ability to do name-based lookup 2018-05-03 10:57:16 +00:00
CMakeLists.txt Add lldb-test. 2017-12-01 00:52:51 +00:00