netguard

type Choice struct {
	Index4, Index6 uint32
	// Alias4, Alias6 — имена интерфейсов для вывода («Ethernet 3», «Wi-Fi»,
	// «enp7s0»).
	Alias4, Alias6 string
}

type Guard struct {

	// Logf, если задан, получает строку на каждый привязанный сокет:
	// «[NETGUARD] tcp4 203.0.113.80:443 → интерфейс 3». Главный инструмент
	// отладки петли; CLI ставит его при -v. Задаётся до первого сокета.
	// Имени хоста в строке нет: в Control адрес приходит уже разрешённым.
	Logf func(format string, args ...any)

	// Mark, если не 0, ставится сокетам опцией SO_MARK (только Linux): по
	// ней защита DNS узнаёт сокеты tt и пропускает их запросы к DNS для
	// доменов VK (plan-e4.md, D1). Метке нужен CAP_NET_ADMIN, без него
	// сокет не создаётся (EPERM), поэтому CLI ставит её, только когда
	// защита DNS включена. Задаётся до первого сокета. На Windows не
	// используется: там защита DNS пропускает весь процесс tt.
	Mark uint32

	// NoIPv6 — сокетам ядра IPv6 не давать: выбор интерфейса IPv6
	// отбрасывается, и сокет IPv6 не создаётся, а Go уходит на IPv4. Нужно,
	// когда ответы IPv6 на физический интерфейс отбросит обратный фильтр
	// (firewalld, plan-e4.md, T3). Задаётся до SelectInterfaces и Watch.
	NoIPv6 bool
	// contains filtered or unexported fields
}

type WatchOptions struct {
	// Exclude — свой адаптер на момент события (AdapterID datapath: на
	// Windows — LUID, на Linux — индекс интерфейса); 0 или nil —
	// исключать нечего. События этого интерфейса пропускаются, и в выбор он
	// не попадает: иначе туннель, ставя свои маршруты, перезапускал бы
	// себя сам.
	Exclude func() uint64

	// Changed получает новый и прежний выбор — один раз на свёрнутую серию,
	// когда новые индексы уже стоят. Выборы могут совпасть: интерфейс
	// пропадал и вернулся (сон, переподключение Wi-Fi), и открытые через
	// него сокеты уже мертвы. Вызовы не перекрываются. Обязателен.
	Changed func(now, before Choice)

	// Settle и MaxWait — окно сворачивания; 0 — DefaultSettle
	// и DefaultMaxWait.
	Settle, MaxWait time.Duration
}