!mapped_file

!mapped_file扩展命令显示指定地址所在的内存映射文件所关联的文件名字。

语法

!mapped_file Address 

参数

Address

指定映射文件的地址。如果Address不在内存映射文件中，则命令失败。

DLL

!mapped_file 扩展命令只能用于活动、非远程调试。

注释

这里有三个例子。前两个地址是从文件映射出来的，第三个地址不是。

0:000> !mapped_file 4121ec 
Mapped file name for 004121ec: '\Device\HarddiskVolume2\CODE\TimeTest\Debug\TimeTest.exe'

0:000> !mapped_file 77150000 
Mapped file name for 77150000: '\Device\HarddiskVolume2\Windows\System32\kernel32.dll'

0:000> !mapped_file 80310000 
No information found for 80310000: error 87

.dump (Create Dump File)

.dump命令创建一个用户模式或内核模式崩溃转储文件。

语法

.dump Options FileName 
.dump /? 

参数

Options

指定下面这些选项的一个或多个。

/o

覆盖具有相同名字的dump文件。如果没有使用该选项又存在一个相同名字的文件，则dump文件不会被写入。

/f

(内核模式：) 创建一个完整内存dump。

 (用户模式：) 创建一个完整用户模式dump。不管怎么称呼，最大的minidump文件实际比完整用户模式dump文件包含更多信息。例如，.dump /mf 或.dump /ma会创建比.dump /f创建更大更完整的文件。在用户模式下，.dump
/m[MiniOptions] 总是比.dump /f更可取。

/m[MiniOptions]

创建一个小内存dump(内核模式)或者
minidump
(用户模式)。如果没有指定/f和/m ，/m
是默认选项。

用户模式下，/m 后面可以跟附加的MiniOptions
用来指定dump文件中包含的数据。如果没有使用MiniOptions
，dump文件包含模块、线程和调用堆栈信息，但是没有其他附加信息。可以使用下面的任意MiniOptions
来改变dump文件的内容，它们区分大小写。

MiniOption	作用
a	创建一个包含所有附加选项的minidump。/ma选项相当于/mfFhut —它会在minidump中添加完整的内存数据、句柄数据、已卸载模块信息、基本内存信息和线程时间信息。
f	在minidump中包含完整内存数据。目标程序拥有的所有 可访问的已交付的页面(committed pages)都会包含进去。
F	在minidump中添加所有基本内存信息。这会将一个流加入到包含完整基本内存信息的minidump中，而不单是可使用的内存。这样可以使得调试器能够重建minidump生成时进程的完整虚拟内存布局。
h	在minidump中包含和目标进程相关的句柄信息。
u	在minidump中包含已卸载模块信息。仅在Windows Server 2003和之后版本的Windows中可用。
t	在minidump中包含附加的线程信息。包括可以在调试minidump时使用!runaway扩展命令或.ttime (Display Thread Times)命令进行显示的线程时间。
i	在minidump中包含次级内存(secondary memory)。次级内存是由堆栈中的指针或备份存储(backing store)中引用到的任何内存，加上该地址周围的一小段区域。
p	在minidump中包含进程环境块(PEB)和线程环境块(TEB)。这在想访问程序的进程和线程相关的Windows系统信息时很有用。
w	将所有已交付的可读写的私有页面包含进minidump。
d	在minidump中包含可执行映像中所有可读写的数据段。
c	加入映像中的代码段。
r	从minidump中去掉对重建调用堆栈无用的堆栈和存储内存部分。局部变量和其他数据类型值也被删除。这个选项不会使得minidump变小(因为这些内存节仅仅是变成0)，但是当想保护其他程序中的机密信息时有用。
R	在minidump中去掉完整的模块路径。仅包含模块名。如果想保护用户的目录结构时该选项有用。

这些MiniOptions 只能在创建用户模式minidump时使用。它们需要跟在 /m 修饰符后面。

/u

在dump文件名中添加日期、时间和PID。这可以确保dump文件名的唯一性。

/a

为所有当前正在调试的进程创建dump。如果使用了/a，也必须使用/u
选项来保证每个文件有唯一的名字。

/b[a]

创建一个.cab 文件。如果包含该选项， FileName
会被当作CAB文件名，而不是dump文件名。会先创建一个临时的dump文件，然后将该文件打包为CAB，然后删除它。如果b后面跟了a，所有的符号和映像文件也会打包到CAB中。

/c "Comment"

指定要写入dump文件的注释字符串。如果Comment 中包含空格，则必须用双引号将它括起来。当dump文件加载时会显示这个Comment
字符串。

/xc Address

(仅用户模式minidump) 在dump文件中加入上下文记录。Address必须指定上下文记录的地址。

/xr Address

(仅用户模式minidump) 在dump文件中加入一个异常记录。Address 必须指定该异常记录开始的地址。

/xp Address

(仅用户模式minidumps) 在dump文件中加入一个上下文记录和异常记录。Address
必须指定一个包含上下文记录和异常记录指针的 EXCEPTION_POINTERS 结构的地址。

/xt ThreadID

(仅用户模式minidumps) 指定将会作为dump文件的异常线程的系统线程的ID。

/kpmf File

(仅创建内核模式完整内存dump) 指定一个包含物理内存页面数据的文件。

FileName

指定dump文件名。可以设置完整路径和文件名，或者只设置文件名。如果文件名中包含空格，则需要用引号将FileName
括起来。如果没有指定路径，会使用当前目录。

-?

显示该命令的帮助。在用户模式和内核模式下显示的文本是不同的。

环境

注释

该命令可以在各种情况下使用：

• 进行用户模式活动调试时，该命令创建目标程序的dump文件，但是目标程序不会被结束。
• 内核模式活动调试时，该命令创建目标机的dump文件，但是目标机不会崩溃。
• 调试dump文件时，该命令从旧文件创建出一个新的dump文件。这在有一个大的dump文件但是又想创建一个更小的文件时有用。

可以控制dump文件的类型：

• 内核模式下，使用/f选项来生成完整内存转储。使用/m选项(或不带选项)来生成小内存转储。.dump命令不能创建内核内存转储。
• 用户模式下，使用.dump /m[MiniOptions] 是最好的选择。虽然"m" 代表着"minidump"，但是使用MiniOption创建的dump文件可以很小也可以很大。通过指定合适的MiniOptions
  ，可以精确的控制包含的信息。例如，.dump /ma 产生包含大量信息的dumo文件。.dump /f命令产生大小适中的"标准dump"文件，并且不能进行自定义。

不能指定要转储的进程。所有运行中的进程都会转储下来。

/xc、/xr、 /xp和/xt
选项用来在dump文件中保存异常和上下文信息。这使得该dump文件可以使用
.ecxr (Display Exception Context Record)。

下面的示例创建一个包含完整内存和句柄信息的用户模式minidump：

0:000> .dump /mfh myfile.dmp 

.dumpcab (Create Dump File CAB)

.dumpcab命令创建一个包含当前dump文件的CAB文件。

语法

.dumpcab [-a] CabName 

参数

-a

使得当前加载的符号也包含在CAB文件中。对于minidump，所有以加载的映像也会包含进去。使用lml来查看加载了哪些符号和映像。

CabName

包含扩展名的CAB文件名。CabName 可以包含绝对或者相对路径；相对路径是相对于调试器启动的目录的。建议使用.cab扩展名。

环境

注释

该命令只有在调试dump文件时可以使用。(这句话似乎和前面的表格有冲突。—译者注)

如果在调试活动目标时想创建CAB中的dump文件，需要使用.dump (Create Dump File)命令。然后，打开一个使用该dump文件作为目标的新的调试会话，然后再使用.dumpcab。

.dumpcab命令不能将多个dump文件放入一个CAB文件中。

.f+, .f- (Shift Local Context)

.f+ 命令将帧序号移动到当前堆栈中的下一帧。.f- 命令将帧序号移动到当前堆栈中的上一帧。

语法

.f+  
.f-  

环境

注释

帧 (frame)用来指定调试器用来解析局部变量的局部上下文(作用域)。

.f+和.f-
命令是用来在当前调用堆栈中移动到下一帧或者前一帧的快捷方式。这些命令和下面的.frame
命令作用相同，但是.f 要更短更方便：

• .f+ 和 .frame @$frame + 1一样。
• .f- 和 .frame @$frame - 1一样。

美元符号($)表示帧的值是一个伪寄存器。At符号(@)使得调试器访问该值更快，因为它告诉调试器后面的字符串是一个寄存器或者伪寄存器。

程序运行时，局部变量的意义由程序计数器的位置决定，因为这些变量的作用域仅在定义它们的函数内部。如果没有使用.f+ 或.f-
命令(或者 .frame 命令)，调试器会使用当前函数(调用堆栈中的当前帧)的作用域作为局部上下文。

帧序号(frame number)是堆栈帧在堆栈回溯中的位置。可以使用k, kb, kd, kp, kP, kv (Display Stack Backtrace)命令或者Calls
窗口查看堆栈回溯。第一行 (当前帧) 的帧序号是0。后面的行分别是1、2、3等等。

可以将局部上下文设置到另一个堆栈帧来查看新的局部变量信息。但是，实际可用的变量由执行的代码决定。

如果又对程序进行执行，调试器会将局部上下文重置为程序计数器的作用域。如果寄存器上下文改变，局部上下文也重置到调用堆栈顶部的帧。

微软符号服务器已经很久没ping通了，挂上全局代理可以下载符号，但是又不想总是开着全局代理。

后来找到一种替代方案，可以通过设置系统环境变量，来让下载符号的流量走代理服务器

_NT_SYMBOL_PROXY