/pdb-guid

💻🪟👀 Peek into Windows symbol files to read their unique identifiers

Primary LanguageTypeScript

bugsplat-github-banner-basic-outline

BugSplat

Crash and error reporting built for busy developers.

Follow @bugsplatco on Twitter Join BugSplat on Discord

pdb-guid

A nifty little library for reading unique identifiers from pdb, exe, and dll files.

Command Line

  1. Install this package globally npm i -g pdb-guid
  2. Run pdb-guid with -h to see the latest usage information:
bobby@BugSplat % ~ % pdb-guid -h

pdb-guid

  A command line utility and library for reading the GUID of a .pdb, .exe, or   
  .dll file.                                                                    

Usage

  --path string   Path to a .pdb, .exe, or .dll file. 
  -h, --help      Print this usage guide.             

Example

  pdb-guid path-to-exe-dll-or-pdb-file 

Links

  🐛 https://bugsplat.com                     
                                              
  💻 https://github.com/BugSplat-Git/pdb-guid 
                                              
  💌 support@bugsplat.com 
  1. Run pdb-guid specifying a path to a pdb, exe, or dll file:
bobby@BugSplat % ~ % pdb-guid ./path/to/bugsplat.pdb
E546B55B6D214E86871B40AC35CD0D461

API

  1. Install this package locally npm i @bugsplat/pdb-guid.
  2. Create a new instance of PdbFile by awaiting a call to the static factory function PdbFile.createFromFile. This method accepts files with a .pdb extension.
const pdbFile = await PdbFile.createFromFile('./path/to/bugsplat.pdb');
  1. Create a new instance of PeFile by awaiting a call to the static factory function PeFile.createFromFile. This method accepts files with a .exe or .dll extension.
const peFile = await PeFile.createFromFile('./path/to/bugsplat.exe');
  1. The guid property of PdbFile and PeFile instances will contain the unique identifier for the file.
const guid = pdbFile.guid;

🐛 About

BugSplat is a software crash and error reporting service with support for Windows Native C++, Qt, Unreal Engine and many more. BugSplat automatically captures critical diagnostic data such as stack traces, log files, and other runtime information. BugSplat also provides automated incident notifications, a convenient dashboard for monitoring trends and prioritizing engineering efforts, and integrations with popular development tools to maximize productivity and ship more profitable software.