windbg에서 python 스크립트 실행하는 방법 - pykd
windbg에서 python 스크립트를 실행하는 다음의 플러그-인이 있습니다.
Python extension for WinDbg
; http://pykd.codeplex.com/
; https://githomelab.ru/pykd
위의 홈페이지에 다운로드 받은 pykd.dll 파일을 x64/x86에 따라 다음의 windbg 폴더에 복사해 주면 됩니다.
// x64
C:\Program Files (x86)\Windows Kits\10\Debuggers\x64\winext
// x86
C:\Program Files (x86)\Windows Kits\10\Debuggers\x86\winext
(당연히 Python 2.7 버전이 설치된 상태에서) windbg 실행 후 pykd 확장을 로드한 다음,
.load pykd
c:\temp\test.py 파일을 다음과 같이 만들어,
# test.py
print("Hello")
pykd를 통해 실행해 줄 수 있습니다.
0:005> !py c:\temp\test.py
Hello
사실, python 스크립트만 실행하는 것으로는 windbg에서 크게 효용성이 있지는 않습니다. 당연히 ^^ windbg 객체 모델을 접근할 수 있어야 하는데, 이 기능은 별도로 pykd.pyd 파일에서 제공합니다. pykd.pyd 파일 설치는 windbg 내에서 다음과 같이 pip 명령어로 간단하게 끝낼 수 있습니다.
0:005> !pip install pykd
Downloading/unpacking pykd
Installing collected packages: pykd
Successfully installed pykd
Cleaning up...
0:005> !pip install pykd --upgrade
Requirement already up-to-date: pykd in c:\python27\lib\site-packages
Cleaning up...
pykd.pyd 파일은 "C:\Python27\Lib\site-packages\pykd" 폴더에 생성되고, 이후로는 windbg에서 다음과 같은 내용의 python 소스 파일을 실행할 수 있습니다.
# test.py
from pykd import *
dprintln("Hello2")
0:005> !py c:\temp\test.py
Hello2
그리고, 이런 Python 스크립트로 windbg를 잘 활용하도록 만들어진 사례가 바로 mona입니다.
Mona
; http://expdev-kiuhnm.rhcloud.com/2015/05/19/mona-2/
따라서 다음의 경로에 있는 python 소스 코드 2개를 내려받아,
https://raw.githubusercontent.com/corelan/windbglib/master/windbglib.py
https://raw.githubusercontent.com/corelan/mona/master/mona.py
Python 2.7 설치 경로 하위의 Lib 폴더에 복사해 주면 됩니다.
C:\Python27\Lib
이후, mona.py의 기능을 활용해 windbg 기능을 보다 편리하게 사용할 수 있습니다.
현시점(2017-06-19)에 x64 버전의 windbg에서는 !py mona를 실행하는 경우 다음과 같은 경고 메시지가 뜰 수 있습니다.
0:006> !py mona heap
*******************************************************************************************
You are running a newer version of pykd.pyd
mona.py was tested against v0.2.0.29
and not against v0.3.2.6
This version may not work properly.
If you are having issues, I recommend to download the correct version from
https://github.com/corelan/windbglib/raw/master/pykd/pykd.zip
(unzip with 7zip)
NOTE: PyKD v0.3.2.6 requires msdia120.dll, which only gets installed via Visual Studio 2013 (yup, I know)
Alternatively, you can use the copy of msdia120.dll from the pykd.pyd file
(https://github.com/corelan/windbglib/raw/master/pykd/pykd03.zip), but use this file at your own risk
*******************************************************************************************
...[생략]...
이유는, mona.py가 0.2.0.29 버전의 pykd.pyd 모듈에 대해 테스트되었다는 것인데 현재 "c:\python27\lib\site-packages" 경로에 설치된 pykd.pyd 버전은 0.3.2.6이기 때문입니다.
메시지에서는 "
https://github.com/corelan/windbglib/raw/master/pykd/pykd.zip" 경로에서 0.2.0.29 버전의 pykd.pyd 파일을 다운로드할 수 있다고 하는데, 이는 x86 버전이기 때문에 x64에는 적용할 수 없습니다. (아마도, x64 버전은 0.2.0.29 버전이 아닌 곧바로 0.3.2.6 버전부터 개발된 것으로 보입니다.) 따라서, 현재는 x64 버전으로 실행하는 경우 감수해야 하는 경고 메시지입니다. (아니면, mona.py 소스 코드에서 삭제하거나!)
참고로, 원하는 버전의 모듈이 있는 경우라면 버전을 지정해 "pip install"로 설치할 수 있습니다.
0:006> !pip install pykd==0.2.0.29
Collecting pykd==0.2.0.29
Could not find a version that satisfies the requirement pykd==0.2.0.29 (from versions: 0.3.0.11, 0.3.0.12, 0.3.0.13, 0.3.0.14, 0.3.0.15, 0.3.0.16, 0.3.0.17, 0.3.0.18, 0.3.0.19, 0.3.0.20, 0.3.0.21, 0.3.0.22, 0.3.0.23, 0.3.0.24, 0.3.0.25, 0.3.0.26, 0.3.0.27, 0.3.0.28, 0.3.0.29, 0.3.0.30, 0.3.0.31, 0.3.0.32, 0.3.0.33, 0.3.0.34, 0.3.0.35, 0.3.0.36, 0.3.0.37, 0.3.1.3, 0.3.1.4, 0.3.1.5, 0.3.1.6, 0.3.1.7, 0.3.1.8, 0.3.1.9, 0.3.1.10, 0.3.2.0, 0.3.2.1, 0.3.2.2, 0.3.2.4, 0.3.2.5, 0.3.2.6)
No matching distribution found for pykd==0.2.0.29
보는 바와 같이, x64에서는 0.2.0.29 버전은 제공되지 않기 때문에 설치가 안됩니다.
만약 다음과 같은 오류가 발생한다면?
0:005> !py c:\temp\test.py
failed to find python interpreter
HKEY_LOCAL_MACHINE 또는 HKEY_CURRENT_USER 노드 하위에 "SOFTWARE\\Python\\PythonCore" 설정이 있는지 확인합니다. 없는 경우, 다음의 내용을 .reg 파일로 저장한 후 등록해 줍니다.
Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\Python]
[HKEY_LOCAL_MACHINE\SOFTWARE\Python\PythonCore]
[HKEY_LOCAL_MACHINE\SOFTWARE\Python\PythonCore\2.7]
[HKEY_LOCAL_MACHINE\SOFTWARE\Python\PythonCore\2.7\Help]
[HKEY_LOCAL_MACHINE\SOFTWARE\Python\PythonCore\2.7\Help\Main Python Documentation]
@="c:\\Python27\\Doc\\python2710.chm"
[HKEY_LOCAL_MACHINE\SOFTWARE\Python\PythonCore\2.7\InstallPath]
@="c:\\Python27\\"
[HKEY_LOCAL_MACHINE\SOFTWARE\Python\PythonCore\2.7\InstallPath\InstallGroup]
@="Python 2.7"
[HKEY_LOCAL_MACHINE\SOFTWARE\Python\PythonCore\2.7\Modules]
[HKEY_LOCAL_MACHINE\SOFTWARE\Python\PythonCore\2.7\PythonPath]
@="c:\\Python27\\Lib;c:\\Python27\\DLLs;c:\\Python27\\Lib\\lib-tk"
혹은, 다음과 같이 오류가 발생할 수 있습니다.
0:006> .load pykd
0:006> !py c:\temp\test.py
Traceback (most recent call last):
File "c:\temp\test.py", line 1, in <module>
from pykd import *
ImportError: No module named pykd
이런 경우는 pykd.pyd 파일 설치가 안되어 있기 때문입니다. 본문에서 설명한 pip install을 이용해 pykd를 설치해 주면 됩니다.
혹은, 다음과 같이 오류가 발생할 수 있습니다.
0:006> !py mona heap
Do not run this script outside of a debugger !
위와 같이 나오면 pykd.pyd 파일의 유무와 플랫폼이 맞는지 확인해야 합니다. 가령, x86 버전의 pykd.pyd 파일을 x64 버전 환경에서 로딩되도록 설정한 상태일 수 있습니다.
[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]