Files
utun2/src/control_server_doc.md
T
evgeny 38c9f229bc stcp: ed25519 pubkey exchange in handshake, fix instance destroy segfault, fix chat_tcp_test
- u_async.c: process immediate_queue BEFORE epoll_wait in uasync_poll
- stcp_link.c: defensive NULL etcp_conn/etcp_link in stcp_link_close
- utun_instance.c: move stcp_server_list_destroy_all to Phase J (before ETCP),
  add deferred drain in both Phase J and L
- stcp.h/c: STCP_HS_ENC_CLIENT 6→38, STCP_HS_ENC_SERVER 7→39,
  exchange ed25519_pubkey in both handshake directions
- etcp_connections.c: copy peer_ed25519 from STCP to ETCP_CONN in
  etcp_link_enter_ready_tcp; guard link->etcp in tcp_link_close_cb
- chat_sync.c: fix lk->conn NULL dereference for TCP links
- test_stcp.c: update stcp_server_create/stcp_client_connect callsites
- tools/chat_tcp_test: change transport udp→tcp
2026-08-07 00:48:27 +03:00

4.4 KiB
Raw Blame History

Control Server (control_server)

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

TCP-сервер для мониторинга ETCP-соединений. Принимает подключения от GUI-клиента etcpmon, отдаёт по запросу метрики соединений/каналов/TUN/роутера, список узлов BGP-топологии, позволяет менять уровни отладки на лету. Уведомляет подписанных клиентов об изменениях узлов через control_server_notify_node_change().

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

  1. Вызвать control_server_init() — создаёт слушающий TCP-сокет на адресе из конфига control_sock, регистрирует accept-колбэк в uasync.
  2. Периодически вызывать control_server_process_updates() для обработки накопившихся данных клиентов.
  3. При изменении/удалении узла BGP-топологии вызывать control_server_notify_node_change() / control_server_notify_node_removed() — сервер сам разошлёт уведомления подписанным клиентам.
  4. При остановке вызвать control_server_shutdown().

Нюансы:

  • Доступ по IP контролируется через control_allow в конфиге (белый список); без правил доступ запрещён.
  • Клиенты отключаются по idle-таймауту (300 секунд без команд).
  • Лог пишется в control_server.log (полные дампы RX/TX).

3. API

Структуры

Структура Назначение
struct control_server Состояние сервера: listen_fd, связный список clients, uasync-контекст, счётчик клиентов.
struct control_client Состояние клиента: fd, буфер приёма (recv_buffer), output_queue для асинхронной отправки, selected_peer_id, флаг подписки на узлы.

Функции

Функция Назначение
control_server_init(server, ua, instance, bind_addr, max_clients) Создать слушающий сокет, зарегистрировать в uasync. Возвращает 0 / -1.
control_server_shutdown(server) Закрыть всех клиентов, освободить слушающий сокет, закрыть лог-файл.
control_server_process_updates(server) Обработать накопившиеся данные всех клиентов (вызывать периодически).
control_server_get_client_count(server) Вернуть количество подключённых клиентов.
control_server_notify_node_change(server, node) Разослать подписанным клиентам сериализованную информацию об узле.
control_server_notify_node_removed(server, node_id) Разослать подписанным клиентам уведомление об удалении узла.

Поддерживаемые команды ETCPMON

Команда Ответ Описание
CMD_LIST_CONN RSP_CONN_LIST Список активных ETCP-соединений.
CMD_SELECT_CONN — Выбрать соединение по peer_node_id для метрик.
CMD_GET_METRICS RSP_METRICS Полные метрики: ETCP, TUN, router, все каналы с BBR.
CMD_LIST_SOCKETS RSP_SOCKET_LIST Список локальных сокетов с NAT-типом и NAT-адресом.
CMD_ACTION RSP_ACTION_RESULT "nat" — запрос NAT-проверки; "nodes" — дамп BGP-узлов текстом.
CMD_GET_DEBUG_CONFIG RSP_DEBUG_CONFIG Текущие уровни отладки (глобальный + по категориям).
CMD_SET_DEBUG_CONFIG — Установить уровни отладки.
CMD_SUBSCRIBE_NODES RSP_NODE_INFO (список) + RSP_NODE_INFO_END Подписка на изменения узлов + текущий список.
CMD_DISCONNECT — Отключение клиента.