JetBrains.Platform.Symbols

Default implementation which is required for the subsystem to be runnable on its own. Override in host-specific environments if needed.

Default implementation which is required for the subsystem to be runnable on its own. Override in host-specific environments for relevant logging mechanisms (e.g. to VS Output window).

Chosen directory to place downloaded sources

Downloads source file specified by to . Handles errors by itself

Downloads symbols for to , asks for specific pdbSignature instead of gettting it from Handles errors by itself, overwrites existing files.

whether pdb was successfully downloaded and saved to designated location Does not check the signature and type of the found pdb files. But the signature and type (from ) can be used to locate pdb files

Downloads symbols file for

on downloading cancelled by progress indicator true if the file was downloaded, false otherwise Does not check the signature and type of the found pdb files. But the signature and type (from ) can be used to locate pdb files

Cache for unpacked sources (embedded into portable pdb) and sources downloaded from source server (for pdb with SourceLink) Structure case 1 (source with valid checksum in pdb): (cache dir)\(hex presentation of source checksum)\(source short name) - corresponds to the folder structure of Visual Studio embedded sources cache case 2 (source with invalid checksum): (cache dir)\(assembly MVID in hex + assembly size in hex)\(source index in hex)\(source short name) (source index > 0 (index > DebugDocument.NullDocumentIndex)) case 2' (source with invalid checksum, source index is 0 (DebugDocument.NullDocumentIndex), i.e. source without sequence points, e.g. source for enum or interface): (cache dir)\(assembly MVID in hex + assembly size in hex)\_(source name hash)\(source short name) Properties file near the cached source (only in case 1): checksum + assembly ids list (may be empty) for assemblies referencing this source via pdb

Cache root folder

Path relative to cache folder case 2: (assembly MVID in hex + assembly size in hex)\(source index in hex)\(source short name) case 2': (assembly MVID in hex + assembly size in hex)\_(source name hash)\(source short name)

Path relative to cache folder case 1: (VS hex presentation of source checksum)\(source short name) case 2: (assembly MVID in hex + assembly size in hex)\(source index in hex)\(source short name) case 2':(assembly MVID in hex + assembly size in hex)\_(source name hash)\(source short name)

Gets cached source (null if source is not cached / is not embedded)

Embedded source can be extracted to cache, but cannot be downloaded from source server

Source index or checksum based on cache folder structure or PdbDocumentInfo.Invalid if cacheItemPath is not inside cache

SourceLink.json file path in cache for assembly

SHA1 checksum

Chosen directory to place downloaded sources

File/folder structure of cache (inside symbols cache folder): pdbName.pdb/signature/pdbName.pdb (or pdbFileName/signature/pdbFileName, pdbFileName = pdbName.pdb) signature - pdb signature (Guid in hex) and age (int in hex)

pdb file name with extension pdb file name with extension