Close transport header audit and record integration validation

This commit is contained in:
evgeny committed 2026-10-26 00:00:11 +01:00
1 parent e86a16fb8b
commit deccd337fc
2 files changed
+109 -9

No files matched your search

+17 -9
View File
@@ -4,15 +4,23 @@
## Текущие задачи
[ ] **socket_monitor: исправить FreeBSD-разбор уведомлений адреса** — найдено статической сверкой 25.10.2026.
В `src/transport_layer/socket_monitor.c:329` обработчик RTM_NEWADDR/RTM_DELADDR вызывает
`bsd_parse_rtm(..., NULL, 0, ...)`, а разборщик на строке272 безусловно выполняет `gw[0]='\0'`.
Получение такого уведомления ведёт к записи по NULL до разбора атрибутов; Linux-ветка этот код не исполняет.
Нужно согласовать обязательность выходов разборщика, проверять отсутствие/размер каждого выходного буфера
и проверить корректность заголовков/границ всех FreeBSD-уведомлений по актуальным определениям ОС.
При ошибке выдавать понятную диагностику socket/warn; проверить изменение/удаление адреса на FreeBSD.
Код не исправлялся, runtime-проверка FreeBSD не выполнялась. Аудит остановлен по AGENTS.md:10;
socket_monitor.h остаётся частично проверенным, остальные ветки lifecycle ещё требуют отдельной проверки.
[+] **transport_layer: завершить аудит заголовков и документов** — завершено 25.10.2026.
С учётом прежних этапов сверены все32 собственных заголовка и17 документов каталога плюс doc/stun_nat.md.
Закрыты auto_socket/socket_monitor/SOCKS/call_ring/REALITY/STUN; исправлены владение endpoints/posts,
потеря TCP banner, ошибки запуска/очистки, relay HUP/half-close и двойной STUN recheck.
Обычная сборка PASS; check.sh194/194 PASS,0 skipped, proxy9/9,burst1/1,load8/8,134217728 байт,170с.
Динамические IPv4/IPv6 auto_socket PASS; проверки build.sh44/44; ASAN/UBSan/LSan12/12,detect_leaks=1.
Два первых отказа sanitizer-стенда вызваны отсутствием glibc FORTIFY wrappers; исправлены, повторные прогоны PASS.
Нативные сборки/runtime Windows и FreeBSD не выполнялись; платформенные ветки сверены по исходникам.
Подробности, ограничения и логи: [transport_layer_audit_findings.txt](transport_layer_audit_findings.txt).
[+] **socket_monitor: исправить FreeBSD-разбор уведомлений адреса** — исправлено 25.10.2026.
Прежний bsd_parse_rtm безусловно писал gw[0] при NULL из RTM_NEWADDR/RTM_DELADDR.
Ненужный разбор sockaddr удалён; уведомления проверяются по длине/версии и правильным native структурам
ifa_msghdr/if_msghdr/if_announcemsghdr/rt_msghdr с копированием выровненного заголовка.
Также исправлены исчезновение адресов, IPv6 scope, изменение endpoints внутри callbacks и pending Windows post.
Linux native-fixture, init faults и ASAN/UBSan/LSan PASS; FreeBSD определения сверены с releng/14.3.
Нативный runtime FreeBSD недоступен; он не подменяется Linux-тестом. Заголовок и lifecycle-контракт согласованы.
[+] **packet_dump: ограничить чтение входного IPv4-пакета** — исправлено 25.10.2026 по указанию пользователя.
Единый hex-цикл читает min(32, total length-IHL) байт; проверяются NULL/version/IHL/total length,
+92
View File
@@ -0,0 +1,92 @@
Аудит оставшихся контрактов transport_layer — 25.10.2026
Область и итог
Закрыты оставшиеся auto_socket, socket_monitor, socks_client, call_ring,
reality/reality_fingerprint/reality_record/reality_io/reality_relay и stun_nat.
Полностью прочитаны их реализации, заголовки и связанные участки владельцев/API.
С учётом ранее завершённых ETCP/STCP/crypto/normalizer/NCD/dummynet/packet_dump/CRC
сверены все 32 собственных заголовка и 17 документов src/transport_layer, а также doc/stun_nat.md.
Вложенный BBR/bbr_v3.c не имеет отдельного заголовка/документа и относится к ранее сверенной
реализации etcp_bbr. Это закрытие аудита описаний и найденных
при нём дефектов, а не утверждение об отсутствии любых возможных ошибок транспорта.
socket_monitor
- Удалён разбор FreeBSD sockaddr, безусловно писавший gw[0] при переданном NULL.
Уведомления разбираются по родному типу if_msghdr/ifa_msghdr/if_announcemsghdr/rt_msghdr;
проверяются длина и версия, используется только нужный индекс интерфейса.
- При исчезновении адреса сбрасываются старые IPv4/IPv6, сохраняется порт, корректируется IPv6 scope.
- Обход callbacks использует ID/поколение: удаление/пересоздание сокетов не оставляет висячий next.
- Linux проверяет источник, границы netlink, EINTR/overflow; init откатывает каждый отказ.
- Windows объединяет уведомления и отменяет pending post при остановке после завершения native producers.
auto_socket
- UDP factory возвращает именно созданный endpoint; один общий reconcile заменяет дубли IPv4/IPv6 × UDP/TCP.
- При замене сначала снимается старый слот, неудачная попытка не оставляет dangling pointer;
частичный начальный запуск откатывается, последующие ошибки сохраняют работающие endpoints.
- Для wildcard TCP listener отдельно хранится опубликованный IP интерфейса: неизменённый listener стабилен,
реальная смена адреса/типа пересоздаёт его. DOWN/исчезнувшие интерфейсы удаляются после полного scan.
- Порты SQLite проверяются по типу/диапазону, атомарный INSERT не оставляет открытую транзакцию.
RNG проверяется, 65535 доступен. Остановка сохраняет кеш портов, удаление интерфейса очищает его.
- Внешние/Windows scans объединяются в отменяемый post; native источники отключаются до освобождения.
Внешние producers должны завершиться до destroy согласно контракту.
- Android reload сохраняет одинаковые port=0 endpoints, учитывает scope/опции и обновляет ссылки client links
до освобождения старого config. Ошибка частичного reload логируется, новый config остаётся владельцу instance.
- Проверены длины/границы Linux/FreeBSD уведомлений, ошибки nonblocking/register и Windows API.
socks_client
- CONNECT читает ровно control frame и сохраняет следующий TCP banner для владельца.
- Start не вызывает completion inline при немедленном connect; timer/nonblocking обязательны с полным rollback.
- Проверяются пределы строк, VER/RSV/REP, relay port/ATYP; wildcard UDP BND IP берётся из TCP peer.
- Отправка учитывает EINTR, SIGPIPE и нулевой прогресс, проверяются переключения write monitoring.
- UDP send возвращает payload bytes, не wire bytes; размер проверяется до сложения, NULL/0 допустимы.
Unwrap сохраняет выходы при отказе и допускает in-place payload.
- DNS start остаётся синхронным getaddrinfo с первым адресом; это явно отражено в контракте.
call_ring
- История отдельная для каждого потока; насыщенный count сохраняет последние 1024 записи после wrap idx.
- Указатели печатаются через PRIxPTR, включая Win64. Dump учитывает short write/EINTR и отказ файла,
продолжает stderr без обычного logger/выделений памяти. snprintf не объявлен async-signal-safe.
REALITY
- Уточнены одноразовость session, zero-init/cleanup, сохранение traffic после Finished,
границы codec, отсутствие replay-защиты в stateless обёртках и отдельное владение owner/I/O.
- Traffic init сбрасывает generation, KeyUpdate увеличивает его; replay entries различают пустой slot и Unix time=0.
- Ошибки client_start полностью удаляют новое I/O; send забирает вход только при успехе.
- Resume сохраняет штатный finish при close_notify; transient recv EINTR не закрывает поток.
- Relay строго проверяет destination port/timeout/длину prefix, mandatory nonblocking/timer/monitor setup.
SIGPIPE/EINTR/send=0 обрабатываются, счётчики учитывают каждый отправленный байт.
- HUP дочитывает остаток/EOF: прежде uasync снимал регистрацию без except handler и relay ждал idle timeout.
Регрессия отключает idle timeout и требует полного двустороннего half-close.
- Закрытые relay остаются в owner до call_soon; отказ его выделения не теряет контекст.
Shutdown отменяет отложенные frees и синхронно освобождает оба списка до уничтожения owner/UASYNC.
STUN
- Recheck одним scan перезапускает старые и создаёт новые пути по одному разу; раньше новый путь
немедленно открывал второй тестовый fd, расходуя первый свежий порт без измерения.
- Уточнены исключение TCP/probe_only/SOCKS/only_local из API, SKIPPED IPv6/неизвестного IPv4,
статусы результата, неизменность выхода при -1 и обязанность caller проверять TTL.
- Контракты и RFC-последовательность сверены с https://www.rfc-editor.org/rfc/rfc5780
и https://www.rfc-editor.org/rfc/rfc8489; обычный MATCH не объявляется доказательством EIM.
Проверки
- ./build.sh --no-gui -j4: PASS, /tmp/transport-audit-final-build.log.
- ./check.sh: 194/194 PASS, 0 failed/0 skipped; proxy 9/9, burst 1/1, load 8/8,
134217728 проверенных байт, 170 секунд; /tmp/transport-audit-final-check.log.
- Динамические IPv4/IPv6 сценарии auto_socket во всех UDP/TCP режимах и 8 циклах: PASS,
/tmp/transport-audit-auto-dynamic-final.log, в отдельном Linux netns.
- Проверки скрипта сборки: 44/44 PASS, /tmp/transport-audit-build-script.log.
- ASAN/UBSan/LSan: 12/12 PASS с detect_leaks=1/ halt_on_error=1:
socket_monitor, auto_socket_faults, socks_client, call_ring, reality_record, reality_hello,
reality_tls, reality_fallback, reality_relay_faults, stcp_reality_rotation, stun_nat, tun_route.
Все встроенные lib/src/Opus инструментированы согласованно в /tmp/utun-packet-dump-asan-20261025.
Сборка: /tmp/transport-audit-asan-build.log и /tmp/transport-audit-asan-tests-build.log.
Первый прогон /tmp/transport-audit-asan-results.log: 10 PASS и 2 отказа тестовых перехватов glibc FORTIFY.
Добавлены checked recvfrom/poll wrappers; оба повторных прогона PASS, без отчётов санитайзеров:
/tmp/transport-audit-asan-test_socket_monitor-final.log,
/tmp/transport-audit-asan-test_tun_route-final.log. Последние изменения только стенда проверены адресно.
Остальные индивидуальные логи: /tmp/transport-audit-asan-test_*.log.
- Нативные runtime/сборки Windows и FreeBSD недоступны и не заявляются.
FreeBSD типы уведомлений сверены с официальными заголовками releng/14.3:
https://github.com/freebsd/freebsd-src/blob/releng/14.3/sys/net/if.h
https://github.com/freebsd/freebsd-src/blob/releng/14.3/sys/net/route.h
Полнота [V] означает сверку описаний по исходникам; платформенные runtime-ограничения сохранены здесь явно.