109 lines
7.0 KiB
C
109 lines
7.0 KiB
C
/* conn_mgr — оптимальная P2P-доставка больших объёмов данных: медиа, файлы, звонки.
|
||
* Один менеджер принадлежит одной группе; DIRECT/REVERSE/INDIRECT подбирают путь к получателю.
|
||
*
|
||
* Архитектурная роль CONN_MGR_HANDLE:
|
||
* - принадлежит сервису и выражает его потребность в доставке данных конкретному узлу;
|
||
* - существует, пока идёт звонок или передача файла; владелец закрывает его по окончании/отмене;
|
||
* - потеря пути и TIMEOUT попытки не освобождают handle и не отменяют потребность владельца;
|
||
* - не является NCD handle и не привязан временем жизни к одному ETCP_CONN.
|
||
*
|
||
* NCD обеспечивает общий прямой мультиадресный транспорт для BGP/topo_group.
|
||
* CM удерживает свой NCD handle для позднего UP и мониторинга прямого пути;
|
||
* группа приобретает независимое NCD-владение при согласовании своей сессии.
|
||
* CM handle остаётся у медиа-сервиса. Закрытие CM handle отменяет его запрос, а не владение группы.
|
||
* Групповые сессии открывают через topo_group_peer_open(). Все операции — в потоке uasync. */
|
||
#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;
|
||
|
||
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 ═══════ */
|
||
|
||
/* Создать менеджер группы и его фоновые проверки; NULL при ошибке. */
|
||
struct CONN_MGR* conn_mgr_init(struct TOPO_GROUP* group);
|
||
/* Остановить проверки и освободить менеджер. Все клиентские handles закрыть ДО destroy. */
|
||
void conn_mgr_destroy(struct CONN_MGR* mgr);
|
||
/* Приём управляющего пакета от etcp_router; забирает entry. */
|
||
void conn_mgr_router_recv_handler(struct ETCP_CONN* conn, struct ll_entry* entry);
|
||
|
||
/* ═══════ единая точка входа ═══════ */
|
||
|
||
/**
|
||
* Параллельные пробы: DIRECT сразу, REVERSE через 0/500мс, INDIRECT через 0/1000мс от общего старта.
|
||
* Посредник используется сразу после проверки; поздний прямой путь заменяет его без повторного UP.
|
||
* Возврат 0 — запрос принят, -1 — ошибка запуска. cb обязателен.
|
||
* Ошибка до запуска может возвращаться без callback. В callback h может быть NULL.
|
||
* Успешно выданный handle закрывает вызывающий, в том числе после 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 и отменить его callbacks, в том числе отложенный UP.
|
||
* Допустимо из callback (также закрытие другого handle). После close указатель больше не использовать.
|
||
* Очистка внутренней записи CM отсоединяет handles, но владельцы всё равно обязаны вызвать close.
|
||
* Последний handle освобождает ресурсы CM; чужие NCD-владельцы сохраняют транспорт. */
|
||
void conn_mgr_close(struct CONN_MGR_HANDLE* h);
|
||
|
||
/* ═══════ доступ к соединению ═══════ */
|
||
|
||
/** Заимствованный READY прямой ETCP_CONN; NULL для INDIRECT, ожидания или отсоединённого handle. */
|
||
struct ETCP_CONN* conn_mgr_get_conn(struct CONN_MGR_HANDLE* h);
|
||
|
||
/** Передать e->dgram через маршрутизатор CM. Освобождает entry при ненулевом h;
|
||
* буфер dgram отдельно не освобождает. При h==NULL entry остаётся у вызывающего. */
|
||
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);
|
||
|
||
/** Запланировать перепроверку путей после изменения маршрутов или READY групповых сессий. */
|
||
void conn_mgr_routes_changed(struct CONN_MGR* mgr);
|
||
|
||
/** Изменились локальные сокеты: начать восстановление без ожидания backoff, сохраняя работающие пути. */
|
||
void conn_mgr_network_changed(struct CONN_MGR* mgr);
|
||
|
||
/** Заимствованный next hop: READY прямой путь/подтверждённый посредник; allow_probe — только для управляющего обмена CM. */
|
||
struct ETCP_CONN* conn_mgr_route_conn(struct CONN_MGR* mgr, uint64_t node_id, int allow_probe);
|
||
|
||
/** Тип живого транспорта к node_id: исходящий DIRECT, только входящие REVERSE, другой next hop INDIRECT. */
|
||
uint8_t conn_mgr_connection_type(const struct ETCP_CONN* conn, uint64_t node_id);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
#endif
|