Files
utun2/lib/swm_min_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

2.8 KiB

Sliding Window Minimum (swm_min.h)

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

Структура данных для отслеживания минимума в скользящем окне фиксированного размера. Добавление значения и запрос минимума — O(1) амортизированное время. Память — O(window_size). Предназначена для отслеживания минимального RTT в ETCP/BBR (в кодовой базе зарезервирована, ожидает интеграции).

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

Создать окно заданного размера, добавлять значения по мере поступления, запрашивать текущий минимум.

SlidingWindowMin *swm = swm_create(10); // окно из 10 последних значений

for (int i = 0; i < 100; i++) {
    swm_add(swm, get_new_rtt());
    int min_rtt = swm_get_min(swm); // минимум последних ≤10 значений
}

swm_destroy(swm);

Нюансы:

  • swm_get_min на пустом окне возвращает INT_MAX
  • window_size должен быть > 0, иначе swm_create вернёт NULL
  • Значения — int, отрицательные допустимы

3. API

Структура

  • SlidingWindowMin — непрозрачная структура (opaque pointer). Содержит кольцевой буфер значений, deque индексов, позицию и размер окна.

Функции

  • swm_create(window_size) — выделяет SlidingWindowMin, инициализирует пустой deque и кольцевой буфер размера window_size. Возвращает NULL при ошибке выделения памяти.
  • swm_destroy(swm) — освобождает все ресурсы структуры.
  • swm_add(swm, val) — добавляет значение в окно. Автоматически вытесняет индексы, вышедшие за границу окна, и удаляет из deque значения, которые больше текущего (поддерживает монотонный минимум).
  • swm_get_min(swm) — возвращает минимум текущего окна за O(1). Для пустого окна — INT_MAX.

Алгоритм

Использует монотонный deque: в голове deque всегда индекс минимального элемента текущего окна. При добавлении из хвоста удаляются элементы ≥ нового — они никогда не станут минимумом, пока новый элемент в окне.

Тест: tests/test_swm_min.c