{"id":19356778,"url":"https://github.com/ajkhoury/pdbfetch","last_synced_at":"2025-06-17T19:07:16.438Z","repository":{"id":45219837,"uuid":"222252410","full_name":"ajkhoury/pdbfetch","owner":"ajkhoury","description":"Fetch PDB symbols directly from Microsoft's symbol servers","archived":false,"fork":false,"pushed_at":"2021-12-30T15:06:33.000Z","size":52,"stargazers_count":41,"open_issues_count":0,"forks_count":10,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-23T10:46:36.664Z","etag":null,"topics":["debug","downloader","go","golang","pdb","portable-executable","symbols"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ajkhoury.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-11-17T13:29:53.000Z","updated_at":"2025-03-30T00:46:14.000Z","dependencies_parsed_at":"2022-09-09T04:22:42.673Z","dependency_job_id":null,"html_url":"https://github.com/ajkhoury/pdbfetch","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/ajkhoury/pdbfetch","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ajkhoury%2Fpdbfetch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ajkhoury%2Fpdbfetch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ajkhoury%2Fpdbfetch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ajkhoury%2Fpdbfetch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ajkhoury","download_url":"https://codeload.github.com/ajkhoury/pdbfetch/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ajkhoury%2Fpdbfetch/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260424782,"owners_count":23007044,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["debug","downloader","go","golang","pdb","portable-executable","symbols"],"created_at":"2024-11-10T07:05:29.307Z","updated_at":"2025-06-17T19:07:11.419Z","avatar_url":"https://github.com/ajkhoury.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# pdbfetch\n\nA cross platform standalone cli application written in Go that fetches PDB symbol files directly from Microsoft's symbol servers by parsing an associated PE formatted executable.\n\n## Usage\n\n```\npdbfetch pefile [directory]\n```\n#### Windows\n```\npdbfetch ExamplePE.exe \"C:\\symbols\"\n```\n#### Unix\n```\npdbfetch ExamplePE.exe \"/usr/share/symbols\"\n```\n\n## How\n\nBy parsing a given PE file's `IMAGE_DIRECTORY_ENTRY_DEBUG` directory for PDB symbol information of type `IMAGE_DEBUG_TYPE_CODEVIEW`, and compiling a valid symbol server URL.\nThe PDB `Name`, `Signtaure`, and `Age` fields are used to compile the symbol download URL.\n\nThe `Name` is the name (or path?) of the PDB that is emitted by the linker.\n\nThe `Signtaure` is a Windows formatted 128-bit GUID that is emitted by the linker.\n\nThe  `Age` is the version of the same PDB (or simply the number of times the PDB file has been written by the linker).\n\nCompiling the link is as simple as:\n\n`https://msdl.microsoft.com/download/symbols/{PDB_NAME}/{PDB_GUID}+{PDB_AGE}/{PDB_NAME}`\n\nLet's take for example `netbios.sys`. The following PDB symbol information is extracted from the PE:\n```\nPDB Name: netbios.pdb\nPDB GUID: 109096de-2cf2-44bd-8d03-0e5473c5253a\nPDB Age:  1\n```\nThe resulting valid symbol link for this is:\n\nhttp://msdl.microsoft.com/download/symbols/netbios.pdb/109096DE2CF244BD8D030E5473C5253A1/netbios.pdb  \n\n## References\n\nThis would not have been so simple without the help of `PDB-Downloader`:\n\nhttps://github.com/rajkumar-rangaraj/PDB-Downloader\n\nSpecial thanks to Sam O (and Ero Carrera) for a great start to a PE file parser in golang:\n\nhttps://github.com/soluwalana/pefile-go\n\nLLVM PDB Documentation:\n\nhttps://llvm.org/docs/PDB/PdbStream.html#matching-a-pdb-to-its-executable\n\nhttps://github.com/llvm/llvm-project/blob/master/llvm/include/llvm/Object/CVDebugRecord.h\n\n## License\n\nThis project is licensed under the Apache 2.0 license.\n\nAdditional licenses pertaining to this project can be found under the LICENSES sub-folder.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fajkhoury%2Fpdbfetch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fajkhoury%2Fpdbfetch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fajkhoury%2Fpdbfetch/lists"}