zapret-kvn/xray_fluent/engines/exit_codes.py
loop-uh 169a5cd933
Some checks failed
Windows project source guards / test (push) Failing after 28s
Разбор аварии sing-box: код выхода с причиной и подсказка про чужой Zapret в режиме TUN
Вместо пустого «Crashed ()» сообщение называет код (например 0xC0000417) и поясняет его.
В режиме TUN при аварии ядра добавляется подсказка, если рядом работает Zapret из другой папки.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-04 16:05:50 -05:00

37 lines
1.9 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

"""Коды завершения процессов Windows простыми словами.
Ядро упало — в журнале и в окне остаётся число вроде ``-1073740777``, по которому человек
ничего не поймёт, а поддержка не найдёт причину. Здесь число приводится к привычному виду
(``0xC0000417``) и, если код известен, получает короткое объяснение.
"""
from __future__ import annotations
_KNOWN: dict[int, str] = {
0xC0000005: "обращение к недоступной памяти",
0xC0000409: "аварийная остановка по защите от переполнения буфера",
0xC0000417: (
"недопустимый параметр в нативной библиотеке; так падают библиотеки драйвера сетевого адаптера "
"или WinDivert, когда рядом работает ещё один перехватчик пакетов"
),
0xC000013A: "прервано сигналом Ctrl+C",
0xC0000135: "не найдена нужная библиотека",
0xC000007B: "библиотека другой разрядности",
0xC0000142: "не удалось запустить библиотеку",
}
def describe_exit_code(code: int | None) -> str:
"""``0xC0000417 (объяснение)`` для кода Windows; обычные небольшие коды — числом."""
if code is None:
return "код неизвестен"
unsigned = int(code) & 0xFFFFFFFF
if unsigned < 0x10000:
return f"код {unsigned}"
meaning = _KNOWN.get(unsigned)
text = f"код 0x{unsigned:08X}"
return f"{text} ({meaning})" if meaning else text
__all__ = ["describe_exit_code"]