本文将告诉大家如何读取 PE 文件头信息,拼接 PDB 符号文件下载地址,从微软公共符号服务器拉取符号文件
本文将以拉取 ntdll.dll 为例子告诉大家如何从 msdl.microsoft.com 下载符号
我先将自己电脑上的 ntdll.dll 拷贝到输出路径,方便我进行访问。读取 C 盘的 Windows 文件夹的 DLL 文件也是有读取权限的,即不拷贝到输出路径也不会有任何的问题的
整体步骤是先读取 dll 的 PE 文件信息,获取到调试信息,即 PDB 名加 Guid 和 Age 参数,由以上三个参数拼接为下载地址
本文使用的 PEReader 等辅助类为 .NET Core 1.0 引入,如需在 .NET Framework 使用,请安装 System.Reflection.Metadata 库
本文建立的是 dotnet 9 的控制台文件
先使用 File.OpenRead 打开要读取的 DLL 文件,代码如下
var file = @"ntdll.dll";
using var fileStream = File.OpenRead(file);
接着放入到 PEReader 里面读取,如此即可非常方便完成对 PE 文件的读取,代码如下
var peReader = new PEReader(fileStream);
尝试读取传入的 PE 文件的调试目录信息,代码如下
var debugDirectoryEntries = peReader.ReadDebugDirectory();
这里的调试目录可能有很多,咱只需使用 DebugDirectoryEntryType.CodeView 类型的即可
foreach (var debugDirectoryEntry in debugDirectoryEntries)
{
if (debugDirectoryEntry.Type != DebugDirectoryEntryType.CodeView)
{
continue;
}
...
}
在 DebugDirectoryEntry 里面存放的只是一些地址偏移和大小的信息,需要进一步调用 ReadCodeViewDebugDirectoryData 方法读取到更多信息,代码如下
foreach (var debugDirectoryEntry in debugDirectoryEntries)
{
if (debugDirectoryEntry.Type != DebugDirectoryEntryType.CodeView)
{
continue;
}
var readCodeViewDebugDirectoryData = peReader.ReadCodeViewDebugDirectoryData(debugDirectoryEntry);
var path = readCodeViewDebugDirectoryData.Path;
var guid = readCodeViewDebugDirectoryData.Guid;
var age = readCodeViewDebugDirectoryData.Age;
var pdbName = path;
...
}
如此即可获取到下载地址拼接的信息
var downloadUrl = $"http://msdl.microsoft.com/download/symbols/{pdbName}/{(guid.ToString("N").ToUpperInvariant() + age.ToString())}/{pdbName}";
继续使用 HttpClient 将其下载下来,代码如下
var httpClient = new HttpClient();
using var httpResponseMessage = await httpClient.GetAsync(downloadUrl, HttpCompletionOption.ResponseHeadersRead);
var pdbFile = Path.GetFullPath(pdbName);
await using var downloadFileStream = File.Create(pdbFile);
await httpResponseMessage.Content.CopyToAsync(downloadFileStream);
下载文件的方法十分简单,先是准备要下载的文件存放的路径,我这里使用的是相对工作路径的方式,即 var pdbFile = Path.GetFullPath(pdbName);
简单的方式拿到绝对路径。这里获取绝对路径仅仅只是为了方便调试而已,无实际逻辑意义
接着使用 File.Create 方法创建文件,且返回 FileStream 对象,方便进行下载内容的 CopyToAsync 写入到文件
以上代码的另一个细节是请求的时候带上了 HttpCompletionOption.ResponseHeadersRead 参数,带上这个参数将告诉 HttpClient 不要等待内容都拉取完了再让 GetAsync 方法返回,而是只要 http 的头信息拿到了,就应该返回了。这一点对下载文件来说,比较有优化,大部分下载的文件的文件长度都不小,全等待下载完成再让 GetAsync 返回,再拷贝到文件,这个逻辑相对来说是比较亏的。只有对 API 调用形的后台访问,才合适使用默认的 HttpCompletionOption.ResponseContentRead 参数,全部完成再返回,如此可以更简化异常处理情况,确保网络通讯完成再返回
通过上文简单的方式即可完成对 DLL 的符号文件下载
以上代码其实还隐藏了另一个功能,那就是自己组建符号服务器,可以自己在构建完成之后,根据如上信息,将 PDB 符号文件存放到合适的路径里面或记录到数据库里面,不依赖 symstore 工具
本文的 Program.cs 代码如下
using System.Reflection.PortableExecutable;
using System.Runtime.InteropServices;
using System.Text;
var file = @"ntdll.dll";
using var fileStream = File.OpenRead(file);
var peReader = new PEReader(fileStream);
var httpClient = new HttpClient();
var debugDirectoryEntries = peReader.ReadDebugDirectory();
foreach (var debugDirectoryEntry in debugDirectoryEntries)
{
if (debugDirectoryEntry.Type != DebugDirectoryEntryType.CodeView)
{
continue;
}
var readCodeViewDebugDirectoryData = peReader.ReadCodeViewDebugDirectoryData(debugDirectoryEntry);
var path = readCodeViewDebugDirectoryData.Path;
var guid = readCodeViewDebugDirectoryData.Guid;
var age = readCodeViewDebugDirectoryData.Age;
var pdbName = path;
var downloadUrl = $"http://msdl.microsoft.com/download/symbols/{pdbName}/{(guid.ToString("N").ToUpperInvariant() + age.ToString())}/{pdbName}";
using var httpResponseMessage = await httpClient.GetAsync(downloadUrl, HttpCompletionOption.ResponseHeadersRead);
var pdbFile = Path.GetFullPath(pdbName);
await using var downloadFileStream = File.Create(pdbFile);
await httpResponseMessage.Content.CopyToAsync(downloadFileStream);
}
本文代码放在 github 和 gitee 上,可以使用如下命令行拉取代码。我整个代码仓库比较庞大,使用以下命令行可以进行部分拉取,拉取速度比较快
先创建一个空文件夹,接着使用命令行 cd 命令进入此空文件夹,在命令行里面输入以下代码,即可获取到本文的代码
git init
git remote add origin https://gitee.com/lindexi/lindexi_gd.git
git pull origin 6bc0a171f53f4da8a968257c621c9df7a6de77a3
以上使用的是国内的 gitee 的源,如果 gitee 不能访问,请替换为 github 的源。请在命令行继续输入以下代码,将 gitee 源换成 github 源进行拉取代码。如果依然拉取不到代码,可以发邮件向我要代码
git remote remove origin
git remote add origin https://github.com/lindexi/lindexi_gd.git
git pull origin 6bc0a171f53f4da8a968257c621c9df7a6de77a3
获取代码之后,进入 Workbench/WerjiwaijogoNemcuryecho 文件夹,即可获取到源代码
更多技术博客,请参阅 博客导航
本文会经常更新,请阅读原文: https://blog.lindexi.com/post/dotnet-%E7%AE%80%E5%8D%95%E5%86%99%E4%B8%80%E4%B8%AA-pdb-%E7%AC%A6%E5%8F%B7%E6%96%87%E4%BB%B6%E4%B8%8B%E8%BD%BD%E5%99%A8.html ,以避免陈旧错误知识的误导,同时有更好的阅读体验。
如果你想持续阅读我的最新博客,请点击 RSS 订阅,推荐使用RSS Stalker订阅博客,或者收藏我的博客导航
本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。欢迎转载、使用、重新发布,但务必保留文章署名林德熙(包含链接: https://blog.lindexi.com ),不得用于商业目的,基于本文修改后的作品务必以相同的许可发布。如有任何疑问,请 与我联系 。
无盈利,不卖课,做纯粹的技术博客
以下是广告时间
推荐关注 Edi.Wang 的公众号
欢迎进入 Eleven 老师组建的 .NET 社区
以上广告全是友情推广,无盈利