Microsoft MVP성태의 닷넷 이야기
디버깅 기술: 160. Windbg 확장 DLL 만들기 (3) - C#으로 만드는 방법 [링크 복사], [링크+제목 복사],
조회: 20508
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 
(연관된 글이 1개 있습니다.)
(시리즈 글이 5개 있습니다.)
디버깅 기술: 45. Windbg 확장 DLL 만들기 (1) - 스레드를 강제 종료시키는 명령어
; https://www.sysnet.pe.kr/2/0/1198

디버깅 기술: 46. Windbg 확장 DLL 만들기 (2) - Debugger Extension API 사용
; https://www.sysnet.pe.kr/2/0/1200

디버깅 기술: 118. windbg - 닷넷 개발자를 위한 MEX Debugging Extension 소개
; https://www.sysnet.pe.kr/2/0/11644

디버깅 기술: 160. Windbg 확장 DLL 만들기 (3) - C#으로 만드는 방법
; https://www.sysnet.pe.kr/2/0/12119

디버깅 기술: 177. windbg - (ASP.NET 환경에서 유용한) netext 확장
; https://www.sysnet.pe.kr/2/0/12462




Windbg 확장 DLL 만들기 (3) - C#으로 만드는 방법

이전 글에서 Windbg 확장 만드는 방법을 소개했습니다.

Windbg 확장 DLL 만들기 (1) - 스레드를 강제 종료시키는 명령어
; https://www.sysnet.pe.kr/2/0/1198

Windbg 확장 DLL 만들기 (2) - Debugger Extension API 사용
; https://www.sysnet.pe.kr/2/0/1200

windbg 확장의 동작 방식이 결국 DLL 측에서 export시킨 함수를 호출하는 것에 불과하기 때문에 당연히 C#으로도 UnmanagedExports를 이용해 만들 수 있습니다.

C# DLL에서 Win32 C/C++처럼 dllexport 함수를 제공하는 방법 - 세 번째 이야기
; https://www.sysnet.pe.kr/2/0/12118

게다가 이미 dbgeng.dll 관련 pinvoke 인터페이스들도 모두 마이크로소프트 측에서 친절하게 만들어 두었기 때문에,

DbgShell/ClrMemDiag/Debugger/
; https://github.com/microsoft/DbgShell/tree/master/ClrMemDiag/Debugger

다음과 같이 기본 확장 DLL의 뼈대를 쉽게 작성할 수 있습니다.

using Microsoft.Diagnostics.Runtime.Interop;
using System;
using System.Runtime.InteropServices;

namespace NetDbgExt
{
    public enum DebugNotifySession
    {
        Active = 0x0,
        Inactive = 0x01,
        Accessible = 0x02,
        InAccessible = 0x03,
    }

    public class UnmanagedMain
    {
        [DllExport(CallingConvention = CallingConvention.StdCall)]
        public static uint DebugExtensionInitialize(IntPtr version, IntPtr flags)
        {
            version.WriteValue(DEBUG_EXTENSION_VERSION(1, 0));
            flags.WriteValue(0);

            NativeMethods.OutputDebugString("NetDbgExt.DebugExtensionInitialize");
            return 0;
        }

        public static uint DEBUG_EXTENSION_VERSION(int Major, int Minor)
        {
            return (uint)((((Major) & 0xffff) << 16) | ((Minor) & 0xffff));
        }

        [DllExport(CallingConvention = CallingConvention.StdCall)]
        public static void DebugExtensionNotify(DebugNotifySession notify, long argument)
        {
            switch (notify)
            {
                case DebugNotifySession.Active:
                    NativeMethods.OutputDebugString("DEBUG_NOTIFY_SESSION_ACTIVE");
                    break;
                case DebugNotifySession.Inactive:
                    NativeMethods.OutputDebugString("DEBUG_NOTIFY_SESSION_INACTIVE");
                    break;
                case DebugNotifySession.Accessible:
                    NativeMethods.OutputDebugString("DEBUG_NOTIFY_SESSION_ACCESSIBLE");
                    break;
                case DebugNotifySession.InAccessible:
                    NativeMethods.OutputDebugString("DEBUG_NOTIFY_SESSION_INACCESSIBLE");
                    break;
            }
        }

        [DllExport(CallingConvention = CallingConvention.StdCall)]
        public static void DebugExtensionUninitialize()
        {
            NativeMethods.OutputDebugString("NetDbgExt.DebugExtensionUninitialize");
        }
    }
}

빌드된 dll을 windbg에서 다음과 같이 로드/언로드해 보면,

[로드]
.load D:\temp\DotNetSamples\WinLib\NetDbgExt\bin\Debug\x64\NetDbgExt.dll

[언로드]
.unload D:\temp\DotNetSamples\WinLib\NetDbgExt\bin\Debug\x64\NetDbgExt.dll

DebugView에서 OutputDebugString 메시지들이 정상적으로 출력되는 것을 확인할 수 있습니다.




예제를 좀 더 확장해 볼까요? ^^ 이를 기반으로 windbg에서 지원하지 않는 DateTime 형식의 값 출력을,

windbg - 메모리 덤프로부터 DateTime 형식의 값을 알아내는 방법
; https://www.sysnet.pe.kr/2/0/11313

C#으로 만든 확장 DLL에서 "printdt"라는 명령어로 다음과 같이 추가할 수 있습니다.

[DllExport(CallingConvention = CallingConvention.StdCall)]
public static uint printdt(IDebugClient pDebugClient, [MarshalAs(UnmanagedType.LPStr)] string args)
{
    IDebugControl dbgControl = pDebugClient as IDebugControl;
    if (dbgControl == null)
    {
        return 0;
    }

    DEBUG_VALUE dbgValue;
    uint remainderIndex;

    int result = dbgControl.Evaluate(args, DEBUG_VALUE_TYPE.INT64, out dbgValue, out remainderIndex);
    if (result != 0)
    {
        return 0;
    }

    ulong u64Value = dbgValue.I64;
    DateTime dt = Util.ToDateTime((long)u64Value);

    dbgControl.Output(DEBUG_OUTPUT.NORMAL, $"0x{u64Value:x}, 0n{u64Value} ==> {dt}\n");

    return 0;
}

따라서 sos.dll을 이용한 분석 작업에서 다음과 같이 DateTime 필드의 값이 나오면,

0:000> !DumpObj 000000ebd15ff688
Name:        Test.Worker
MethodTable: 00007fff290d1bf0
EEClass:     00007fff290cd7d0
Size:        136(0x88) bytes
File:        C:\Windows\Microsoft.Net\assembly\GAC_MSIL\Test\v1.0_0.0.0.4__5ac6f597e34281b7\Test.dll
Fields:
              MT    Field   Offset                 Type VT     Attr            Value Name
...[생략]...
00007fff272586e8  40000fc       78      System.DateTime  1 instance 48d503b5497a92ea _checkTime
...[생략]...

printdt를 이용해 출력해 볼 수 있습니다.^^

0:007> !printdt 48d503b5497a92ea
0x48d503b5497a92ea, 0n5248105017926914794 ==> 2017-09-25 오전 1:32:29

전체 소스 코드는 다음의 github에 올렸으니 참고하시고.

DotNetSamples/WinConsole/Debugger/NetDbgExt/
; https://github.com/stjeong/DotNetSamples/tree/master/WinConsole/Debugger/NetDbgExt




마치기 전에, windbg 확장 dll을 관리하는 방법에 대해 알아보겠습니다. 물론 거의 사용하지 않는다면 그때마다 ".load" 명령어를 이용하겠지만,

0:007> .load C:\NetDbgExt\x64\NetDbgExt.dll

그렇지 않다면 PATH 환경 변수에 등록해 두면 .chahin 명령에서 확인할 수 있는 확장 DLL 검색 경로에 포함됩니다.

0:007> .chain
Extension DLL search Path:
    C:\Program Files (x86)\Windows Kits\10\Debuggers\x64\WINXP;...[생략]...;C:\Program Files\Git\cmd;
Extension DLL chain:
    dbghelp: image 10.0.18362.1, API 10.0.6, 
        [path: C:\Program Files (x86)\Windows Kits\10\Debuggers\x64\dbghelp.dll]
    ext: image 10.0.18362.1, API 1.0.0, 
        [path: C:\Program Files (x86)\Windows Kits\10\Debuggers\x64\winext\ext.dll]
    exts: image 10.0.18362.1, API 1.0.0, 
        [path: C:\Program Files (x86)\Windows Kits\10\Debuggers\x64\WINXP\exts.dll]
    uext: image 10.0.18362.1, API 1.0.0, 
        [path: C:\Program Files (x86)\Windows Kits\10\Debuggers\x64\winext\uext.dll]
    ntsdexts: image 10.0.18362.1, API 1.0.0, 
        [path: C:\Program Files (x86)\Windows Kits\10\Debuggers\x64\WINXP\ntsdexts.dll]

PATH 환경 변수를 어지럽히지 않고 싶다면 별도로 _NT_DEBUGGER_EXTENSION_PATH 환경 변수를 이용할 수 있습니다.

Loading Debugger Extension DLLs
; https://learn.microsoft.com/en-us/windows-hardware/drivers/debugger/loading-debugger-extension-dlls

_NT_DEBUGGER_EXTENSION_PATH=C:\NetDbgExt\x64

그런데, PATH든 _NT_DEBUGGER_EXTENSION_PATH든 플랫폼(x86/x64)에 따른 구분이 없어서 x64/x86 windbg를 모두 쓰는 사용자라면 어떤 거 하나를 지정하는 수밖에 없습니다. 그래서 제 경우에는 windbg의 x86 및 x64 단축 아이콘에 각각 다음과 같이 "-c" 옵션을 추가합니다.

[x64 windbg인 경우]
-c ".extpath+ d:\wext\x64"

[x86 windbg인 경우]
-c ".extpath+ d:\wext\x86"

그럼, windbg는 초기 실행 시 ".extpath+" 명령어를 실행하게 되고 확장 DLL 검색 목록에 경로를 추가합니다.

0:007> .extpath+ d:\wext\x64
Extension search path is: C:\Program Files (x86)\Windows Kits\10\Debuggers\x64\WINXP;...[생략]...;C:\Program Files\Git\cmd;d:\wext\x64

이렇게 검색 목록에 있으면 좋은 이유가 굳이 ".load" 명령어를 할 필요없이 해당 확장에 있는 명령어를 full 경로로 실행해 주면,

0:007> !NetDbgExt.printdt 0
0x0, 0n0 ==> 0001-01-01 오전 12:00:00

알아서 로딩까지 자동으로 이뤄지는 편리함이 있습니다.




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]

[연관 글]






[최초 등록일: ]
[최종 수정일: 3/9/2024]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 




1  2  3  4  5  6  7  8  9  10  11  [12]  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
13679정성태7/16/20247558Linux: 76. Linux - C++ (getaddrinfo 등을 담고 있는) libnss 정적 링크
13678정성태7/15/20248175VS.NET IDE: 191. Visual Studio 2022 - .NET 5 프로젝트를 Docker Support로 실행했을 때 오류
13677정성태7/15/20248580오류 유형: 916. MSBuild - CheckEolTargetFramework (warning NETSDK1138)
13676정성태7/14/20248299Linux: 75. gdb에서 glibc의 함수에 Breakpoint 걸기
13675정성태7/13/202410631C/C++: 166. C/C++ - DLL에서 template 함수를 export하는 방법 [1]파일 다운로드1
13674정성태7/13/20249209오류 유형: 915. Unhandled Exception: Microsoft.Diagnostics.NETCore.Client.ServerNotAvailableException: Unable to connect to Process
13673정성태7/11/20249934닷넷: 2275. C# 13 - (1) 신규 이스케이프 시퀀스 '\e'파일 다운로드1
13672정성태7/10/20247947닷넷: 2274. IIS - (프로세스 종료 없는) AppDomain Recycle
13671정성태7/10/20248279오류 유형: 914. Package ca-certificates is not installed.
13669정성태7/9/20248330오류 유형: 913. C# - AOT StaticExecutable 정적 링킹 시 빌드 오류
13668정성태7/8/20248627개발 환경 구성: 716. Hyper-V - Ubuntu 22.04 Generation 2 유형의 VM 설치
13667정성태7/7/20247221닷넷: 2273. C# - 리눅스 환경에서의 Hyper-V Socket 연동 (AF_VSOCK)파일 다운로드1
13666정성태7/7/20249110Linux: 74. C++ - Vsock 예제 (Hyper-V Socket 연동)파일 다운로드1
13665정성태7/6/20249398Linux: 73. Linux 측의 socat을 이용한 Hyper-V 호스트와의 vsock 테스트파일 다운로드1
13663정성태7/5/20248527닷넷: 2272. C# - Hyper-V Socket 통신(AF_HYPERV, AF_VSOCK)의 VMID Wildcards 유형파일 다운로드1
13662정성태7/4/20248315닷넷: 2271. C# - WSL 2 VM의 VM ID를 알아내는 방법 - Host Compute System API파일 다운로드1
13661정성태7/3/20248206Linux: 72. g++ - 다른 버전의 GLIBC로 소스코드 빌드
13660정성태7/3/20249020오류 유형: 912. Visual C++ - Linux 프로젝트 빌드 오류
13659정성태7/1/20248939개발 환경 구성: 715. Windows - WSL 2 환경의 Docker Desktop 네트워크
13658정성태6/28/20249669개발 환경 구성: 714. WSL 2 인스턴스와 호스트 측의 Hyper-V에 운영 중인 VM과 네트워크 연결을 하는 방법 - 두 번째 이야기
13657정성태6/27/20248772닷넷: 2270. C# - Hyper-V Socket 통신(AF_HYPERV, AF_VSOCK)을 위한 EndPoint 사용자 정의
13656정성태6/27/20249485Windows: 264. WSL 2 VM의 swap 파일 위치
13655정성태6/24/20249051닷넷: 2269. C# - Win32 Resource 포맷 해석파일 다운로드1
13654정성태6/24/20248726오류 유형: 911. shutdown - The entered computer name is not valid or remote shutdown is not supported on the target computer.
13653정성태6/22/20248903닷넷: 2268. C# 코드에서 MAKEINTREOURCE 매크로 처리
13652정성태6/21/202410403닷넷: 2267. C# - Linux 환경에서 (Reflection 없이) DLL AssemblyFileVersion 구하는 방법파일 다운로드2
1  2  3  4  5  6  7  8  9  10  11  [12]  13  14  15  ...