USBDK/Documentation/WdfLogDumping.txt
Leonid Bloch 50a1e5058d Documentation: Include directions for older versions of Windows in WDF log dumping manual
Signed-off-by: Leonid Bloch <leonid@daynix.com>
Signed-off-by: Dmitry Fleytman <dfleytma@redhat.com>
2016-01-27 09:52:13 +02:00

73 lines
2.7 KiB
Text

1) Download and install the latest version of UsbDk, if you haven't done so
already. It is available from:
http://www.spice-space.org/download.html
2) Download WDK suitable for your system:
Windows 7 and newer versions:
https://msdn.microsoft.com/en-us/windows/hardware/hh852365.aspx
Look for the link named "Download WDK 8.1 Update", or whatever the latest
version is. It is advised to use the latest version always.
Windows XP/Server 2003:
https://www.microsoft.com/en-us/download/details.aspx?id=11800
Download Windows Driver Kit Version 7.1.0, newer versions will not work.
3) Enable local kernel-mode debugging:
* On Windows Vista/Server 2008 and later:
a) Open a Command Prompt window as the Administrator.
b) Run "bcdedit /debug on".
c) On Windows 8 and later, run "bcdedit /dbgsettings local".
d) Reboot the computer.
* On Windows 2000/XP/Server 2003:
a) Open the Command Prompt.
b) Run "bootcfg", and note the ID of the targeted operating system.
c) Run "bootcfg /debug ON /ID X" (REPLACE X WITH ID NOTED BEFORE).
d) Reboot the computer.
4) Set logging parameters for UsbDk: run the "Tools/RegSettingsForWdfLog.reg"
file from UsbDk source tree on the intended machine.
5) Reboot the machine.
6) Start the WinDbg debugger, that was installed as a part of WDK:
a) Open a Command Prompt window as the Administrator.
b) Change directory to where WinDbg is installed. FOR EXAMPLE:
'cd "C:\Program Files (x86)\Windows Kits\8.1\Debuggers\x64"'
(or 'cd C:\WinDDK\7600.16385.1\Debuggers' on Windows XP)
c) Run WinDbg connected to the local machine: "windbg -kl"
d) Load the WDF debugger extension:
"!load wdfkd.dll"
e) Load the system symbols:
".symfix+"
".reload"
f) Specify the WDF .tmf file. FOR EXAMPLE:
Windows 7 and later:
"!wdftmffile C:\temp\Wudf01011.tmf"
Windows XP:
"!wdftmffile C:\WinDDK\7600.16385.1\Tools\tracing\i386\Wudf01009.tmf"
* The default path to this file on later versions than XP/2003 looks like:
For 64-bit systems:
"C:\Program Files (x86)\Windows Kits\8.1\Tools\x64\Tracing",
For 32-bit systems:
"C:\Program Files (x86)\Windows Kits\8.1\Tools\x86\Tracing",
but it is necessary to copy it to some folder with no spaces in its
name, such as "C:\temp\", in the example above.
* Choose file for correct WDF version:
WDF 1.11 (Wudf01011.tmf) for Windows 7/Server 2008 R2
WDF 1.09 (Wudf01009.tmf) fir Windows XP/Server 2003/Server 2003 R2
7) Dump the log with "!wdflogdump <driver_name>.sys". FOR EXAMPLE:
"!wdflogdump usbdk.sys"