evgeny
38c9f229bc
- 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
2.9 KiB
NTP Node Time
1. Назначение
Синхронизация времени между узлами uTun через ETCP-канал. Позволяет вычислять смещение часов относительно каждого соседа, обнаруживать дрейф и, если узел сам не синхронизирован с NTP, корректировать свои часы по времени синхронизированного соседа. Используется для точной координации событий между узлами (db_sync, timestamp-ы сообщений в чате).
2. Как пользоваться
ntp_node_time_init() регистрирует callback на новые ETCP-соединения и callback на приём данных через raw etcp_bind (packet ID ETCP_ID_NTP_TIME = 0x04, P2P без роутера). При установке нового соединения автоматически вызывается ntp_node_on_conn_init — отправка TIME_SYNC соседу. При получении TIME_SYNC вычисляется per-peer offset, проверяется дрейф, и если мы не синхронизированы а сосед синхронизирован — корректируем свои часы и рассылаем коррекцию всем остальным соседям.
ntp_node_sync_peers() — широковещательная рассылка TIME_SYNC всем активным соседям. Вызывается автоматически после успешной NTP-синхронизации из ntp_time.
Нюансы:
- До 32 соседей (
NTP_NODE_MAX_PEERS), при переполнении новый не добавляется - Дрейф >2с — WARN, >10с — ERROR. Смещение не применяется автоматически к глобальному offset_us, кроме случая когда свой узел не синхронизирован
- Offset считается как
t4 - t_sender_us(одностороннее смещение, без учёта RTT — предполагается что задержка ETCP мала)
3. API
Структуры:
struct NTP_NODE_PEER— параnode_id+offset_usдля одного соседаstruct NTP_NODE_TIME— фиксированный массивpeers[32]+ счётчикpeer_count
Функции:
ntp_node_time_init(inst)— регистрирует bind вetcp_bind(ID 0x04) и callback на новые соединенияntp_node_time_destroy(inst)— снимает регистрацию bind и callback, обнуляет peer_countntp_node_sync_peers(inst)— отправляетTIME_SYNCвсем активным/initialized соседям (вызывается после NTP-синхронизации)