
Используйте Prolog для анализа дампов памяти и остановленных живых процессов в WinDbg.
Нативное расширение WinDbg для x64 и ARM64 с постоянным рабочим процессом SWI-Prolog. Оно предоставляет доступ к потокам, кадрам стека, символам, загруженным модулям и памяти из дампа пользовательского режима или из остановленного нативного процесса 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.
Откройте нативный дамп пользовательского режима в соответствующем WinDbg для x64 или ARM64 либо подключитесь к нативному процессу этой архитектуры и прервите его выполнение. Для воспроизводимого дампа выполните следующее в 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. Оно запускает рабочий процесс при первой необходимости. Вся связь осуществляется через локальные каналы.
Для предоставленной цели проверьте известный восьмибайтовый маркер:
!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 полезны для других функций и приложений.
Запустите prologdbg_target.exe --live под WinDbg. Продолжите выполнение после начальной
точки останова загрузчика. Затем цель останавливается на CapturePoint после запуска двух рабочих
потоков. Используйте те же запросы, что и для дампа.
В качестве альтернативы запустите prologdbg_target.exe --wait, подключитесь к выведенному PID
и выполните остановку. В этом режиме работа завершается через десять минут, если не остановить её раньше.
Используйте обычные команды 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)."
Для сложного цитирования, текста Unicode или многострочных целей поместите цель в UTF-8
текстовый файл и используйте !prolog.queryfile "C:/rules/goal.txt". Его содержимое передаётся
напрямую в Prolog, минуя разбор текста команд WinDbg. Ограничение размера файла —
1 MiB. Для переиспользуемой логики определите предикаты в подключаемом .pl файле.
Пример без цели:
!prolog.eval member(X,[1,2,3]), Y is X*X.
Ответы выводятся в виде bindings([Name=Value, ...], ResidualGoals). Второй
список сохраняет остаточные ограничения. Итоговый статус различает исчерпанный
поиск, неудачу, лимиты ответов, лимиты вывода, тайм-ауты и исключения.
Достижение лимита ответов не означает, что существуют другие решения.
Обращение к файлу выполняет обычную загрузку и инициализацию Prolog. Ошибки загрузки сообщаются, но загрузка Prolog не является транзакционной: некоторые клаузы могут быть загружены до возникновения ошибки. Исправьте и перезагрузите файл или сбросьте worker.
:- 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 кадров на поток и
10 миллионов выводов. Сбор снимка получает собственный бюджет времени того же
размера. Начальная загрузка символов может быть медленной: прогрейте кэш
символов или увеличьте первое значение с помощью !prolog.limits.
Запросы к памяти составляют не более 64 КиБ каждый и 16 МиБ суммарно на запрос. Захват снимка ограничен 4 096 потоками, 4 096 загруженными модулями и 8 МиБ текста фактов. Воркер использует лимит стека Prolog в 512 МиБ и лимит памяти процесса Windows в 768 МиБ. Нативный мост также ограничивает вывод, количество RPC и время ожидания IPC.