
WinDbg에서 메모리 덤프와 중지된 라이브 프로세스를 분석하기 위해 Prolog를 사용합니다.
영구적인 SWI-Prolog 워커를 갖춘 네이티브 x64 및 ARM64 WinDbg 확장입니다. 사용자 모드 덤프 또는 중지된 네이티브 x64 또는 ARM64 프로세스로부터 스레드, 스택 프레임, 심볼, 로드된 모듈, 메모리를 노출합니다. 자신의 Prolog 파일을 로드하고 디버거 명령 창에서 쿼리를 실행하세요.
버전: 0.2.0 (실험적; 네이티브 ARM64 지원).
디버거의 아키텍처에 맞게 빌드된 DLL을 사용하세요. 디버거, DLL, 네이티브 대상은 일치해야 합니다: x64/AMD64는 함께, 또는 ARM64는 함께. 교차 아키텍처 스코프 컨텍스트, WOW64, ARM32, ARM64EC 대상은 이 릴리스의 범위 밖입니다. 네이티브 x64 및 ARM64 빌드는 99개의 이식 가능 검사와 CDB 덤프/라이브 스모크 테스트를 모두 통과했습니다. 실행, 로그, 남은 수동 검사는 docs/VALIDATION.md를 참조하세요.
소스 저장소에는 컴파일된 바이너리가 포함되어 있지 않습니다. 아래의 Windows 지침을 사용하여 빌드해 dist/x64/ 또는 dist/arm64/를 채우세요. 릴리스 아카이브의 이름은 PrologWinDbg-v0.2.0-win-x64.zip 및 PrologWinDbg-v0.2.0-win-arm64.zip이며, 각각 선택된 바이너리를 dist/에 넣습니다. 아래 예제는 해당 릴리스 아카이브 레이아웃을 사용합니다. 소스 빌드의 경우 경로에서 dist/arm64 또는 dist/x64로 대체하세요.
SWI-Prolog의 Windows 콘솔 버전을 설치하세요. 네이티브 ARM64 설치 프로그램은 개발 다운로드에서 이용할 수 있습니다. CI 매트릭스는 두 아키텍처 모두에서 네이티브 SWI-Prolog 10.1.18-1을 사용합니다. SWI는 별도 프로세스로 실행되며, DLL에 링크되거나 번들로 포함되지 않습니다.
dist/prolog.dll을 dist/prolog 및 dist/examples 디렉터리와 함께 유지하세요.
일치하는 x64 또는 ARM64 WinDbg에서 네이티브 사용자 모드 덤프를 열거나, 해당 아키텍처의 네이티브 프로세스에 연결하여 중단하세요. 재현 가능한 덤프를 만들려면 PowerShell에서 다음을 실행하세요:
.\dist\prologdbg_target.exe --dump C:\Temp\prologdbg-sample.dmp
WinDbg에서 이 경로들을 실제 프로젝트 디렉터리로 바꾸십시오. 따옴표로 묶인 경로에는 슬래시(/)를 사용하십시오. 디버거는 백슬래시를 이스케이프로 처리합니다.
.load C:/PrologWinDbg/dist/prolog.dll
!prolog.runtime "C:/Program Files/swipl/bin/swipl.exe"
!prolog.info
!prolog.consult "C:/PrologWinDbg/dist/examples/patterns.pl"
!prolog.query wd:current_snapshot(S), wd:architecture(S,Architecture).
!prolog.query wd:current_snapshot(S), wd:thread_id(S,T,WindowsTid).
!prolog.query wd:current_snapshot(S), wd:stack_frame(S,T,Depth,IP).
!prolog.query wd:current_snapshot(S), patterns:stack_contains(S,T,Module,Function).
확장은 명시적 런타임 경로, PROLOGDBG_SWIPL 환경 변수 또는 표준 Program Files\swipl\bin\swipl.exe 설치를 사용합니다. 필요할 때 처음으로 워커를 시작합니다. 모든 통신은 로컬 파이프를 사용합니다.
제공된 대상에 대해 알려진 8바이트 마커를 검사합니다:
!prolog.query wd:current_snapshot(S), wd:lookup(S,'prologdbg_target!g_magic',ok(A)), patterns:inspect_magic(S,A,Verdict).
예상 판정: matched(prologdb, Address). 마커 바이트는 PROLOGDB를
나타냅니다. 대상이 이 이름들을 내보내므로 이 예제에는 PDB가 필요하지
않습니다. 프라이빗 PDB는 다른 함수와 애플리케이션에 유용합니다.
WinDbg에서 prologdbg_target.exe --live를 실행하십시오. 초기
로더 중단점을 지나 계속 진행하십시오. 그러면 대상은 두 개의 워커
스레드가 시작된 후 CapturePoint에서 중단됩니다. 덤프와 동일한 쿼리를
사용하십시오.
또는 prologdbg_target.exe --wait를 실행하고 출력된 PID에 연결한
다음 중단하십시오. 이 모드는 더 일찍 중지하지 않으면 10분 후에
종료됩니다.
실행을 제어하려면 일반적인 WinDbg bp, g, p, t 명령을
사용하십시오. 모든 !prolog.query는 새로운 스냅샷을 수집합니다.
등록된 Prolog 중단점 액션과 자동 계속 실행은 향후 버전에서 계획되어
있습니다.
| 명령 | 용도 |
|---|---|
!prolog.help | 명령 도움말 표시 |
!prolog.runtime "absolute path to swipl.exe" | 런타임을 선택하고 기존 워커 중지 |
!prolog.info | 워커를 시작하고 버전 보고 |
!prolog.consult "absolute path to rules.pl" | Prolog 소스 로드 또는 다시 로드 |
!prolog.query Goal. | 증거를 수집하고 해를 열거 |
!prolog.queryfile "absolute path to goal.txt" | 파일에서 단일 UTF-8 목표를 읽은 후 쿼리 |
!prolog.eval Goal. | 디버거 증거 없이 Prolog 평가 |
!prolog.limits | 현재 제한 표시 |
!prolog.limits 5000 100 128 10000000 | 밀리초, 답변 수, 스레드당 프레임, 추론 제한 설정 |
!prolog.reset | 워커 중지; 로드된 규칙과 사용자 지정 런타임 상태가 손실됨 |
단순한 목표는 명령 뒤에 직접 전달됩니다. 표준 Prolog 작은따옴표는
아톰을 구분합니다. 마지막 마침표는 생략할 수 있습니다. 명령당 하나의
목표를 사용하고, 하위 목표는 쉼표로 결합하십시오. Prolog 논리합(;)의
경우 WinDbg의 명령 구분자로부터 보호하기 위해 전체 목표를 큰따옴표로
묶으십시오:
!prolog.eval "(X=a;X=b), writeln(X)."
복잡한 인용, 유니코드 텍스트 또는 여러 줄 목표의 경우, 목표를 UTF-8 텍스트 파일에 넣고 !prolog.queryfile "C:/rules/goal.txt"를 사용하세요. 파일 내용은 WinDbg의 명령 텍스트 파싱을 우회하여 Prolog로 직접 전달됩니다. 파일 크기 제한은 1 MiB입니다. 재사용 가능한 로직의 경우, consult된 .pl 파일에 술어를 정의하세요.
대상이 없는 예제:
!prolog.eval member(X,[1,2,3]), Y is X*X.
답변은 bindings([Name=Value, ...], ResidualGoals) 형식으로 출력됩니다. 두 번째
목록은 잔여 제약 조건을 보존합니다. 최종 상태는 탐색 소진, 실패, 답변 한도, 추론 한도, 타임아웃, 예외를 구분합니다.
답변 한도에 도달했다고 해서 더 많은 해가 존재한다고 단정하는 것은 아닙니다.
파일을 참조하면 일반적인 Prolog 로딩과 초기화가 실행됩니다. 로드 오류는 보고되지만, Prolog 로딩은 트랜잭션이 아니므로 오류가 발생하기 전에 일부 절이 이미 로드되었을 수 있습니다. 파일을 수정하고 다시 로드하거나 워커를 재설정하십시오.
:- module(my_rules, [in_function/4]).
:- use_module('C:/PrologWinDbg/dist/prolog/wd.pl').
in_function(S, T, Module, Function) :-
wd:stack_frame(S, T, _, IP),
wd:symbol(S, IP, Module, Function, _).
그런 다음:
!prolog.consult "C:/rules/my_rules.pl"
!prolog.query wd:current_snapshot(S), my_rules:in_function(S,T,myapp,'ProcessRequest').
술어 모드와 증거 의미론은 docs/API.md를 참조하십시오. 초기 규칙은 스택 매칭, 스레드 간 공유 함수, 명시적 스택 증거, 읽을 수 없는 주소, 그리고 불확정 결과를 동반한 메모리 시그니처 진단을 제공합니다.
기본 쿼리 예산은 5초, 100개 답변, 스레드당 128개 프레임, 1,000만 회 추론입니다. 스냅샷 수집은 동일한 크기의 자체 시간 예산을 받습니다. 초기 심볼 로딩은 느릴 수 있으므로 심볼 캐시를 미리 데우거나 !prolog.limits로 첫 번째 값을 높이십시오.
메모리 요청은 각각 최대 64 KiB이며 쿼리당 총 16 MiB입니다. 스냅샷 캡처는 4,096개 스레드, 4,096개 로드된 모듈, 8 MiB의 팩트 텍스트로 제한됩니다. 워커는 512 MiB Prolog 스택 제한과 768 MiB Windows 프로세스 메모리 제한을 사용합니다. 네이티브 브리지는 출력, RPC 횟수, IPC 대기 시간도 제한합니다.
명령을 중단하려면 WinDbg의 Break 동작 / Ctrl+Break를 사용하십시오. 워커를 기다리거나 스냅샷 항목을 순회하는 동안 확장은 GetInterrupt를 확인합니다. 중단된 IPC는 워커를 재설정하므로 이후 규칙을 다시 확인하십시오. 정상적인 Prolog 시간/추론 제한은 워커를 보존합니다. !prolog.reset 명령은 현재 명령이 반환된 후에 사용할 수 있으며, 동시 취소 명령이 아닙니다.
개별 DbgEng 호출, 특히 심볼 로딩과 원격 읽기는 동기식입니다. 확장은 호출 사이의 경과 시간과 중단을 확인하지만, DbgEng 자체가 차단된 동안에는 엄격한 기한을 보장할 수 없습니다.
수동 중단 확인:
!prolog.limits 600000 100 128 1000000000
!prolog.eval sleep(300).
Ctrl+Break를 누릅니다. 프롬프트가 반환되는지 확인한 다음 !prolog.info와
!prolog.eval X is 2+2.를 실행합니다. 그런 다음 정상 제한으로 복원합니다.
Visual Studio 2022(C++를 사용한 데스크톱 개발), CMake, 그리고 Debugging Tools for Windows가 포함된
Windows SDK를 설치합니다. ARM64의 경우 Visual
Studio C++ ARM64 빌드 도구를 설치합니다. 모든 이식 가능한 테스트를 실행하려면 SWI-Prolog와 Python 3가
필요합니다. swipl.exe와 python.exe를 PATH에 추가합니다.
Visual Studio Developer PowerShell에서:
.\scripts\build-windows.ps1 -Architecture ARM64
.\scripts\smoke-windows.ps1 -Architecture ARM64
x64의 경우 -Architecture x64를 사용하십시오. 이를 생략하면 에뮬레이션된 PowerShell 프로세스에서도 네이티브 Windows 호스트 아키텍처가 선택됩니다. 빌드 디렉터리와 패키지는 별도로 구성됩니다(build-windows-arm64, dist/arm64, 그리고 x64에 해당하는 항목들). x64 호스트는 ARM64를 크로스 컴파일할 수 있지만 네이티브 C++ 테스트는 건너뜁니다. ARM64 Windows에서 스모크 테스트와 CTest를 실행하십시오.
디버거 SDK가 다른 위치에 있다면 -DebuggingTools를 전달하십시오. 해당 경로에는 sdk\inc\dbgeng.h(또는 inc\dbgeng.h)가 포함되어 있어야 하며, 컴파일러는 해당 Windows SDK include 경로를 사용할 수도 있습니다. CDB 또는 SWI-Prolog가 다른 위치에 있다면 -Cdb와 -Swipl을 전달하십시오. 스모크 스크립트는 Debuggers/arm64/cdb.exe 또는 Debuggers/x64/cdb.exe를 선택하고, 실행 전에 CDB, DLL, 테스트 대상의 PE 아키텍처를 검증합니다. 추출된 릴리스 아카이브를 테스트하려면 -Dist .\dist를 전달하십시오. MSVC 빌드는 C++ 런타임을 정적으로 링크하며 테스트 대상 PDB를 포함합니다.
스모크 스크립트는 새로운 임시 디렉터리에 자체 대상 프로세스, 전체 덤프, 디버거 명령 파일, 로그를 생성합니다. 덤프 세션과 라이브 세션 모두, 스레드/스코프 복원, 메모리 증거, 타임아웃 복구, 워커 재설정, DLL 언로드/재로드를 테스트합니다. 로그와 덤프를 보존하고 해당 디렉터리를 출력합니다. 관련 없는 기존 프로세스에는 연결하지 않습니다.
cmake -S . -B build
cmake --build build
ctest --test-dir build --output-on-failure
선택적 MinGW 크로스 빌드는 cmake/mingw-x64.cmake와 DEBUGGING_TOOLS_ROOT를 통해 별도로 제공되는 최신 Microsoft DbgEng 헤더를 사용합니다. MinGW에 번들로 포함된 헤더는 여기서 사용되는 와이드 문자 인터페이스에 비해 너무 오래되었습니다. 작은 dbgeng_compat.hpp 래퍼는 Microsoft의 헤더나 인터페이스 레이아웃을 변경하지 않고 누락된 SAL 주석을 처리합니다.
cmake -S . -B build-cross -G Ninja \
-DCMAKE_TOOLCHAIN_FILE=cmake/mingw-x64.cmake \
-DDEBUGGING_TOOLS_ROOT=/path/to/debugger-sdk
cmake --build build-cross
cmake --install build-cross --prefix dist