jeka/utun2

0 Fork 0

Files

T

evgeny 72e2c89e3b Fix sockless TCP keepalive and require complete UTUN initialization

Receive keepalive through the owning ETCP link, preserve RX deadlines, and report routing metrics without TUN. Use independent netlink requests and track installed routes for rollback. Reject incomplete resource initialization and release partially constructed cores while preserving caller config ownership.

Validated startup failure and rollback, padded keepalive, standby, STCP traffic, transport lifecycle, dynamic sockets, and daemon startup. Real TUN/netlink checks passed in an isolated Linux network namespace; modified modules passed FreeBSD compilation checks.

2026-10-12 14:24:32 +02:00

4.7 KiB

Raw Blame History

TUN Route (tun_route)

1. Назначение

Модуль управления маршрутами в системной таблице маршрутизации. Добавляет маршруты к заданным подсетям через TUN-интерфейс, чтобы исходящий трафик на эти подсети направлялся в виртуальный интерфейс uTun. Удаляет их при завершении работы. Кроссплатформенный: использует разные механизмы ОС с fallback-стратегией.

2. Как пользоваться

// Добавить один маршрут
tun_route_add(ifindex, "tun0", 0x0A000000, 8);   // 10.0.0.0/8

// Добавить все маршруты из конфига
struct tun_route* installed = NULL;
int result = tun_route_add_all(ifindex, "tun0", cfg.routes, &installed);

// Удалить все маршруты из конфига
tun_route_del_all(ifindex, "tun0", &installed); // также при result < 0

// Удалить все маршруты через интерфейс (очистка)
tun_route_flush("tun0");

Network передаётся в host byte order (внутри конвертируется в network byte order). tun_route_add_all читает CFG_ROUTE_ENTRY, выделяет запись владения до операции и сохраняет только успешно добавленные маршруты. При ошибке возвращает -1, оставляя созданный список для отката. tun_route_del_all удаляет и освобождает этот список независимо от дальнейших изменений конфига. IPv6 пока не реализован: его присутствие в route_subnet возвращает ошибку, а не молча пропускается.

Root-права: требуются для изменения системной таблицы маршрутизации.

3. API

Функции

tun_route_add(ifindex, ifname, network, prefix_len) — добавляет маршрут к подсети network/prefix_len через интерфейс ifindex. Пытается использовать нативный механизм платформы, при неудаче — fallback на shell-команду
tun_route_del(ifindex, ifname, network, prefix_len) — удаляет аналогичный маршрут
tun_route_add_all(ifindex, ifname, routes, installed) — 0, если установлены все маршруты, -1 при первой ошибке; installed изначально пуст
tun_route_del_all(ifindex, ifname, installed) — удаляет принадлежащие сервису маршруты; 0 при полном успехе, -1 при любой ошибке; обнуляет список
tun_route_flush(ifname) — удаление всех маршрутов, привязанных к интерфейсу ifname, без привязки к конфигу

Платформенные механизмы

Linux:

Netlink socket (AF_NETLINK, NETLINK_ROUTE) на одну операцию с автоматически назначенным port ID, без подписок. Работает независимо от уже открытых сокетов мониторинга.
RTM_NEWROUTE/RTM_DELROUTE с RTA_DST и RTA_OIF; успех только после корректного ACK ядра с совпавшим sequence и error=0. Общий срок ожидания — 1с, включая EINTR и посторонние ответы. Add/delete не используют shell-fallback.
tun_route_flush: отдельный API ip route flush dev <ifname>; UTUN stop/rollback используют список владения, а не flush.

Windows:

netsh interface ip add/delete route через system() (первичный метод)
Fallback: IP Helper API — CreateIpForwardEntry/DeleteIpForwardEntry с заполнением MIB_IPFORWARDROW
tun_route_flush: GetIpForwardTable → перебор записей по dwForwardIfIndex → DeleteIpForwardEntry

BSD/macOS:

Routing socket (PF_ROUTE, SOCK_RAW): сообщения RTM_ADD/RTM_DELETE, адреса RTA_DST + RTA_NETMASK + RTA_IFP (sockaddr_dl)
Fallback: route add/delete -net <net>/<prefix> -interface <ifname> через system()
tun_route_flush: route -n show -interface <ifname> → парсинг awk → route delete

4.7 KiB Raw Blame History Unescape Escape