tree: b2798a65f994d72c80eef1ee823704e69dbe7cbd [path history] [tgz]
  1. BUILD.gn
  2. OWNERS
  3. README.md
  4. command_line_options.cc
  5. command_line_options.h
  6. command_line_options_test.cc
  7. error.h
  8. main.cc
  9. reader.cc
  10. reader.h
  11. reader_test.cc
  12. symbol_index.cc
  13. symbol_index.h
  14. symbol_index_test.cc
tools/symbol-index/README.md

symbol-index: Manipulate symbol-index file

symbol-index is a host tool that manipulates the symbol-index file, which is typically located at ~/.fuchsia/debug/symbol-index. This file stores the locations of debug symbols from multiple source code checkouts on the local machine, thus debugging tools can read symbols across different checkouts.

File format

A symbol-index could contain multiple lines. Each line could contain one or two paths, separated by “\t”. The first path points to the debug symbols, either in ids.txt format or .build-id directory format. The optional second path points to the build directory, which is used by debugging tools to lookup source code.

For example, a Fuchsia checkout located at /home/me/fuchsia could have the following content in the file.

/home/me/fuchsia/out/default/.build-id    /home/me/fuchsia/out/default
/home/me/fuchsia/out/default.zircon/.build-id    /home/me/fuchsia/out/default.zircon
/home/me/fuchsia/prebuilt/.build-id
/home/me/fuchsia/prebuilt/third_party/clang/mac-x64/lib/debug/.build-id