You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
111 lines
5.1 KiB
111 lines
5.1 KiB
#ifndef CONN_MGR_H |
|
#define CONN_MGR_H |
|
|
|
#ifdef __cplusplus |
|
extern "C" { |
|
#endif |
|
|
|
#include <stdint.h> |
|
#include "../lib/ll_queue.h" |
|
#include "topo_node.h" |
|
|
|
struct CONN_MGR; /* opaque */ |
|
struct CONN_MGR_HANDLE; /* opaque */ |
|
struct UTUN_INSTANCE; |
|
struct ETCP_CONN; |
|
struct TOPO_GROUP; |
|
|
|
/** |
|
* @file conn_mgr.h |
|
* @brief Подключение к узлам P2P-сети. Handle-based API. |
|
* |
|
* Подключает к удалегному узлу либо напрямую, либо через посредника с прямыми адресами. |
|
* При открытии выдаёт handle. и держит подключение открытым пока не закроешь handle. |
|
* Отправлять можно обычным send через роутер - он сам разберётся как отправить, |
|
* либо send этого моделя - он точно отправит через этот мост. |
|
* |
|
* Один CONN_MGR = одна TOPO_GROUP. Создаётся conn_mgr_init(group), живёт пока |
|
* существует группа. Внутри: кеш entries (по одной на целевой узел), список |
|
* handle'ов (по одному на каждый вызов open), фоновые ping/idle/мониторинг. |
|
* |
|
* === Единая точка входа: conn_mgr_open === |
|
* |
|
* 3-фазное подключение (DIRECT→REVERSE→INDIRECT). |
|
* Коллбэк: CONN_EVENT_UP (успех) или CONN_EVENT_TIMEOUT (провал). |
|
* |
|
* === 3 фазы === |
|
* |
|
* 1. DIRECT: node_conn_direct на все адреса, NAT-фильтрация, LAN broadcast ping. |
|
* 2. REVERSE: у нас прямой IP — шлём DIRECT_REQ цели через BGP. |
|
* 3. INDIRECT: через посредника с минимальной суммой RTT (etcp_router). |
|
* |
|
* === Фоновые процессы === |
|
* |
|
* bg_ping: раз в ~100ms один узел группы за тик. Поддерживает свежие RTT. |
|
* candidate_ping: раз в ~2с, удаляет протухших кандидатов. |
|
* |
|
* === Refcounting и закрытие === |
|
* |
|
* Несколько handle на один ETCP_CONN. conn_mgr_close удаляет ОДИН handle. |
|
* Последний handle: DIRECT/REVERSE — DISCONNECT + NCD CLOSE. |
|
*/ |
|
|
|
enum conn_mgr_event { |
|
CONN_EVENT_UP = 0, /* связь есть. handle жив, можно отправлять данные */ |
|
CONN_EVENT_DOWN = 1, /* временный обрыв. handle жив, само восстановится. НЕ закрывать */ |
|
CONN_EVENT_TIMEOUT = 2, /* подключение не удалось. handle жив, закройте сами */ |
|
}; |
|
|
|
/** |
|
* Единый коллбэк для всех операций. |
|
* @param h handle (NULL при ошибках до создания handle) |
|
* @param node_id целевой узел |
|
* @param group_id группа |
|
* @param event UP / DOWN / TIMEOUT |
|
*/ |
|
typedef void (*conn_mgr_cb_t)(struct CONN_MGR_HANDLE* h, |
|
uint64_t node_id, uint64_t group_id, |
|
enum conn_mgr_event event, void* arg); |
|
|
|
/* ═══════ lifecycle ═══════ */ |
|
|
|
struct CONN_MGR* conn_mgr_init(struct TOPO_GROUP* group); |
|
void conn_mgr_destroy(struct CONN_MGR* mgr); |
|
void conn_mgr_router_recv_handler(struct ETCP_CONN* conn, struct ll_entry* entry); |
|
|
|
/* ═══════ единая точка входа ═══════ */ |
|
|
|
/** |
|
* Единственная публичная функция подключения — 3-фазное (DIRECT→REVERSE→INDIRECT). |
|
* Используется медиа-доставкой. Пиры/группы подключаются через node_conn_direct, |
|
* invite — через topo_group_invite. |
|
* |
|
* Ошибка/таймаут: CONN_EVENT_TIMEOUT. |
|
* node_id и group_id ВСЕГДА валидны в коллбэке (даже при TIMEOUT). |
|
*/ |
|
int conn_mgr_open(struct UTUN_INSTANCE* inst, |
|
uint64_t group_id, |
|
uint64_t node_id, |
|
conn_mgr_cb_t cb, void* cb_arg, |
|
struct CONN_MGR_HANDLE** out_handle); |
|
|
|
/** Закрыть handle. Последний handle рвёт соединение. */ |
|
void conn_mgr_close(struct CONN_MGR_HANDLE* h); |
|
|
|
/* ═══════ доступ к соединению ═══════ */ |
|
|
|
/** ETCP_CONN для DIRECT/REVERSE, NULL для INDIRECT. */ |
|
struct ETCP_CONN* conn_mgr_get_conn(struct CONN_MGR_HANDLE* h); |
|
|
|
/** Отправить данные (для INDIRECT — через посредников). Забирает владение e. */ |
|
int conn_mgr_send(struct CONN_MGR_HANDLE* h, struct ll_entry* e); |
|
|
|
/* ═══════ мониторинг (вызывается извне) ═══════ */ |
|
|
|
/** Обновить RTT кандидата-посредника (≤3, сортировка по возрастанию). */ |
|
void conn_mgr_update_best_candidates(struct CONN_MGR* mgr, uint64_t node_id, uint16_t rtt); |
|
|
|
#ifdef __cplusplus |
|
} |
|
#endif |
|
#endif
|
|
|