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.
108 lines
7.0 KiB
108 lines
7.0 KiB
/* 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
|
|
|