Skip to main content

symstore

A python module and command line utility for publishing windows debugging symbols to symbols store. The symbols published in this format can be consumed by the common development tools for windows, such as Visual Studio and WinDbg. See Using SymStore for more information on windows symbols store.

Currently it is possible to publish PDB and PE (exe and dll) files to a local file system.

Installing

Install with pip utility by running:

$ pip install symstore

This will install the command line utility symstore as well as python module symstore.

It is also possible to install symstore package from source code. For example, clone symstore’s git repository with:

$ git clone <repo-url> symstore

and install it with pip:

$ pip install symstore/

Using

command line

Use the symstore command to publish the symbols. Run symstore --help for details.

Python module

To publish symbols programmatically use the symstore module. See symstore/command_line.py for an example on how to use the API.

Compression

The symstore package supports compressing the data files when publishing them. This can lead to significant reduction of data that needs to be transferred while accessing symbols.

The compression mode is activated with --compress or -z flag to symstore command line utility.

Symstore uses the native gcab library via introspection to compress data. The required packages must be available on the system for the compression mode to work.

On ubuntu 18.04, install following packages:

  • gir1.2-gcab-1.0

  • python-gi

On ubuntu 16.04, install following packages:

  • gir1.2-libgcab-1.0

  • python-gi

In case symstore is not able to locate python-gi and gir packages while compression mode is requested, following error message will be displayed:

gcab module not available, compression not supported

Change Log

0.2.6 (29 August 2019)

  • don’t leak open file handles during operation (issue #10)

0.2.5 (16 December 2018)

  • officially support python 3.7

  • fixed write errors to history.txt on windows/python2.7

0.2.4 (31 January 2018)

  • improved error handling on missing GCab python binding

0.2.3 (24 June 2017)

  • support publishing PDBs with longer root stream (even larger files)

  • officially support python 3.6

0.2.2 (16 January 2017)

  • support republishing same file in a new transaction

  • print nice error message on unexpected file extensions

  • more details in the docs on how to setup gcab to enable compression

0.2.1 (29 September 2016)

  • generate correct signature for PDBs with age larger then 10

  • support publishing PDBs with multi-page root stream (larger files)

  • fetch PDB age from DBI stream

  • support publishing PDBs without DBI stream

0.2.0 (22 March 2016)

  • added compression support

0.1.1 (10 February 2016)

  • dropped dependency to pdbparse and construct modules

  • added support for python 3

0.1.0 (14 January 2016)

  • dropped dependency to pefile module

  • print nice error message on currupt PE files

Metadata

Release files for symstore 0.2.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for symstore 0.2.6
File Size Uploaded Provenance
symstore-0.2.6.tar.gz 10.2 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for symstore 0.2.6
File Interpreter ABI Platform
symstore-0.2.6-py2.py3-none-any.whl Python 2, Python 3 none any Details

Total release size: 22.7 kB

Release files / symstore-0.2.6.tar.gz

Download URL symstore-0.2.6.tar.gz
Size 10.2 kB
Tags Source
SHA-256 checksum
How to use checksums
f49ac8031b7572b5f3bcac3a8296d498fcd2a410225b3886f1c6b90b21c5bbf0
BLAKE2b-256 checksum
How to use checksums
6f6576a2016ba3fc3e834fe2b0ee33c25bc86e9aae4e1cbe862dbefcb4aa0a86
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.13.0 pkginfo/1.5.0.1 requests/2.18.4 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.35.0 CPython/3.6.7

Release files / symstore-0.2.6-py2.py3-none-any.whl

Download URL symstore-0.2.6-py2.py3-none-any.whl
Size 12.5 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
e96fba9f0c43678e88bbfcbebd58f5354dc89bc7fd2e42ea18807bf484a0a30c
BLAKE2b-256 checksum
How to use checksums
0a132addd4add0156a3e819b20b6e980900a305491035de0527f23bc9ba3290a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.13.0 pkginfo/1.5.0.1 requests/2.18.4 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.35.0 CPython/3.6.7

Security for symstore 0.2.6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page