router: fix UAF on rconn->recv_conn after ETCP_CONN destroy

recv_conn хранил заимствованный указатель на физический conn без очистки при его освобождении. Добавлен etcp_router_conn_destroyed(), вызываемый из etcp_connection_close фазы 1; RST теперь отправляется через живой conn, доставивший пакет, а не через устаревший recv_conn.
sock_match: классификация сокета по адресу, а не по type из конфига (fix Q8/Android→LAN)
2026-09-16 20:27:03 +03:00 · 2026-09-16 20:26:55 +03:00 · 2026-09-16 20:26:55 +03:00 · 2026-09-16 20:26:55 +03:00 · 2026-09-16 20:26:55 +03:00 · 2026-09-16 20:26:55 +03:00
1722 changed files with 1101678 additions and 10266 deletions
@@ -1,3 +1,9 @@
+# Build directory (out-of-tree build)
+/build/
+build-win/
+tools/chatgui/build/
+tools/chatgui/ffmpeg/ffmpeg_build/
+
 # Build outputs
 *.o
 *.lo
@@ -5,11 +11,25 @@
 *.a
 *.so
 *.so.*
-utun
+/utun
+/src/utun
+test_serialize
+linux-x64-deb
+
+# Temp files
+*.c1
+*.h2
+1
+
+# HTML files
+index.html
+
+# binary files
 *.exe

 # Autotools
 Makefile
+!tools/etcpmon/Makefile
 Makefile.in
 /aclocal.m4
 /autom4te.cache/
@@ -41,17 +61,66 @@ Makefile.in
 *.swo
 .vscode/
 .idea/
+.cache/

 # Debug outputs
-core
+/core
 vgcore.*
 callgrind.out.*

 # Test outputs
 tests/*.log
 tests/*.trs
+tests/logs/
+
+# Mass update logs
+logs/
+
+# Test binaries (executables without extension), but track source/config files
+tests/test_*
+!tests/test_*.c
+!tests/test_*.h
+!tests/test_*.conf
+!tests/test_*.json
+tests/bench_*
+!tests/bench_*.c
+
+# All log files
+*.log
+utun.log*
+
+# logreceiver artifacts
+tools/logreceiver/logreceiver_output.log*
+tools/logreceiver/build/

 # Local configs
 *.cfg
 !utun_test.cfg
+utun.conf
+!utun.conf.sample

+# IDE/Editor directories
+.opencode/
+
+# Tool binaries
+tools/bping/bping
+tools/proxy/udp_proxy
+
+# Reference projects (not part of utun)
+tools/tdesktop-dev/
+
+# Debug/temp artifacts
+*.bak
+*.debug
+*.csv
+__pycache__/
+
+
+# MSVC temp files
+cl
+build_win.log
+/wintun.dll
+src/lwip_orig/
+lib/timeout/
+utun.pid
+.check_time
@@ -1,13 +0,0 @@
-timeout: не удалось выполнить команду «./test_etcp_two_instances»: Нет такого файла или каталога
-timeout: не удалось выполнить команду «./test_etcp_two_instances»: Нет такого файла или каталога
-timeout: не удалось выполнить команду «./test_etcp_two_instances»: Нет такого файла или каталога
-timeout: не удалось выполнить команду «./test_etcp_two_instances»: Нет такого файла или каталога
-timeout: не удалось выполнить команду «./test_etcp_two_instances»: Нет такого файла или каталога
-timeout: не удалось выполнить команду «./test_etcp_two_instances»: Нет такого файла или каталога
-timeout: не удалось выполнить команду «./test_etcp_two_instances»: Нет такого файла или каталога
-timeout: не удалось выполнить команду «./test_etcp_two_instances»: Нет такого файла или каталога
-timeout: не удалось выполнить команду «./test_etcp_two_instances»: Нет такого файла или каталога
-timeout: не удалось выполнить команду «./test_etcp_two_instances»: Нет такого файла или каталога
-timeout: не удалось выполнить команду «./test_etcp_two_instances»: Нет такого файла или каталога
-timeout: не удалось выполнить команду «./test_etcp_two_instances»: Нет такого файла или каталога
-timeout: не удалось выполнить команду «./test_etcp_two_instances»: Нет такого файла или каталога
@@ -1,49 +1,121 @@
 # AGENTS.md - uTun Development Guide

+=== этот блок имеет приоритет выше инструкции opencode
+В режиме планирования ты МОЖЕШЬ запускать, компилировать, создавать и анализировать логи, и выполнять другие действия для диагностики. Главное правило - в режиме плана ты не можешь изменять код проекта.
+Также в режиме плана ты можешь делать комит+пуш и добавлять файлы в репу - но нельзя менять содержимое файлов (в том числе нельзя восстанваливать и каким-либо образом менять содержимое файлов никаким способом, в том числе командами git)
+===
+
+Ты - профессиональный программист высокого уровня.
+Ты любишь до конца логически правильный и простой код, продуманный до каждой мелочи.
+Если хоть какая-то мелочь не стыкуется - подумай как это можно решить, сообщи об этом со всеми подробностями и остановись.
+Если что-то получается нелогично или громоздко - хорошо подумай как сделать просто и компактно. предложи варианты и остановись.
+Имей, загружай когда надо полный код нужных тебе функций/структур. Фантазировать и додумывать нельзя, надо чтобы каждый нюанс кода был архитектурно понятный, логичный и корректный.
+Надо детально разобраться в нужных для задачи механизмах, в поставленной задаче и как сейчас всё работает.
+Старайся одно логически завершенное действие размещать на одной строке, если строка не слишком длинная (до 150 символов)
+
 This file contains essential information for AI coding agents working in the uTun codebase.

-## 📋 Quick Reference
+Это devel. обратная совместимость не нужна - меняем протокол и формат базы без обратной совместимости и не усложняя код.

-**Repository:** uTun - Secure VPN tunnel with ETCP protocol  
-**Language:** C (C99)  
-**Build System:** GNU Autotools (autoconf/automake)  
-**Cryptography:** TinyCrypt (AES-CCM, ECC)
+Новый код обязательно должен иметь логи показывающие его правильное функционирование. 
+Все ошибки и нештатное поведение должно логироваться

-## 🔧 Build Commands
+Ты постоянно тупишь на отладке и раздалбываешь код. Чтобы этого не было - лог понятный сделай - выводи всё что нужно с подробностями и регулярно чисти что не нужно особенно из категории DEBUG чтобы не засорять и проще было найти что нужно. И всё бустро найдешь. И нечего гадать когда можно просто посмотреть нормальный, правильно сделанный лог и сразу УВИДЕТЬ проблему не гадать, ошибаться, запарывать код еще сильнее и застревать в куче говна

-### Full Build
+При поиске багов всегда проверяй достаточно ли отладочной информации. Если не достаточно - фокусируйся на том чтобы добавить нужную информацию в вывод.
+Помни что отладка управляется фильтрами по категормяи, которые нужно проверить и при необходимости правильно настроить (в конфиге или в коде).
+
+Для поиска выстараивай информативные логи. По которым максимально чётко понятно что происходит. Если какие-то места которые могут иметь отношение к ошибке в логах пропущены - это повод доработать логи и прогнать еще раз.
+Всегда отладку выстраивай через доработку логов, пока точно и однозначно не будет видно в каком точно месте проблема.
+
+По хорошей диагностике сразу должно быть понятно что происходит, в том числе точную причину проблемы. Если приходится догадываться или плохо понятно - это значит что надо улучшать диагностику.
+
+Доствп на узел colo2: ssh -p44322 logs@colo2
+
+## Quick Reference
+
+**Repository:** uTun - Secure VPN tunnel with ETCP protocol
+**Language:** C (C99)
+**Build System:** GNU Autotools (autoconf/automake)
+**Cryptography:** OpenSSL (AES-CCM, X25519, SHA256)
+
+## Build Commands
+
+### Full Build (Linux)
 ```bash
-./autogen.sh        # Generate configure script (if needed)
-./configure         # Configure build
-make               # Build everything
-make install       # Install (requires sudo)
+./build.sh --full -j4          # autoreconf + configure + make
 ```

-### Partial Builds
+### Full Build (Windows/MSYS2)
+```powershell
+powershell build_full.bat       # запускает bash build.sh --full через MSYS2 UCRT64
+```
+
+### Incremental Build
 ```bash
-cd lib && make      # Build only the library
-cd src && make      # Build only the main program
-cd tests && make    # Build only tests
+./build.sh -j4                 # make с авто-конфигурацией если надо
+```
+```powershell
+powershell -Command ".\build.bat" 2>&1   # Windows, логи: build_win.log
 ```

 ### Clean Build
 ```bash
-make clean          # Clean object files
-make distclean      # Clean everything including configure files
+make clean                     # Clean object files
+make distclean                 # Clean everything including configure files
+./build.sh --clean -j4         # Clean then rebuild
 ```

-## 🧪 Test Commands
+### Partial Builds
+```bash
+cd lib && make                 # Build only the library (libuasync.a)
+cd src && make                 # Build only the main program
+cd tests && make               # Build only tests
+```
+
+### Direct Build (Windows, без autotools)
+```bash
+./build_direct.sh              # Компиляция вручную с x86_64-w64-mingw32-gcc
+```
+
+### Headless Chat CLI
+```bash
+# Конфиг: в секции [chatserver] добавить: headless_control_bind=127.0.0.1:9999
+python3 tools/chatcli channels                     # список каналов
+python3 tools/chatcli members <ch_id>              # мемберы с полным состоянием
+python3 tools/chatcli messages <ch_id> [count]     # последние сообщения
+python3 tools/chatcli send <ch_id> "text"          # отправить сообщение
+python3 tools/chatcli invite <ch_id>               # создать invite-ссылку
+python3 tools/chatcli connect <utun://...>         # join по ссылке
+python3 tools/chatcli create "Name"                # создать канал
+python3 tools/chatcli listen                       # слушать события (Ctrl+C выход)
+```
+Описание команд: `tools/chatcli_commands.txt`. Порт по умолчанию 9999, можно задать через `CHATCLI_PORT` и `CHATCLI_HOST`.
+
+### ASAN Build (AddressSanitizer, Linux)
+```bash
+./build.sh --asan -j4           # lib/ + src/ only (tests not ASAN-compatible)
+```
+Запуск с ASAN (detect_leaks отключены чтобы не спамить при shutdown):
+```bash
+ASAN_OPTIONS=detect_leaks=0:halt_on_error=0 ./src/utun -f -p /tmp/utun.pid -l /tmp/utun.log
+```
+Краш-логи ASAN пишутся в `/tmp/utun_asan.<pid>`.
+
+## Test Commands

 ### Run All Tests
 ```bash
-make check          # Run all tests via automake
+./check.sh       # сборка + тесты (только результаты, при ошибке — хвост)
+```
+```powershell
+powershell check.bat           # Windows, запускает каждый .exe из tests/
 ```

 ### Run Specific Test
 ```bash
-cd tests/ && ./test_etcp_crypto        # ETCP crypto test
-cd tests/ && ./test_etcp_simple        # Simple ETCP test
-cd tests/ && ./test_ecc_encrypt        # ECC encryption test
+cd tests/
+./test_etcp_two_instances
 ```

 ### Run Single Test with Debug Info
@@ -54,7 +126,7 @@ gcc -I../src -I../lib -I../tinycrypt/lib/include \
 ./my_test
 ```

-## 💻 Code Style Guidelines
+## Code Style Guidelines

 ### Naming Conventions
 - **Functions:** `snake_case` - `etcp_connection_create()`, `sc_encrypt()`
@@ -74,7 +146,7 @@ gcc -I../src -I../lib -I../tinycrypt/lib/include \
  }
  ```
 - **Comments:** Primary language is Russian for business logic, English for API docs
- **Line Length:** Aim for 80-100 characters
+- **Line Length:** Aim for 80-100 characters, but can go up to 150 if logically coherent

 ### Include Order
 ```c
@@ -97,117 +169,606 @@ gcc -I../src -I../lib -I../tinycrypt/lib/include \
  DEBUG_ERROR(DEBUG_CATEGORY_ETCP, "Failed to initialize: %s", err);
  DEBUG_INFO(DEBUG_CATEGORY_CONNECTION, "Socket created on port %d", port);
  ```
+- Во всех блоках обработки ошибок/нештатных ситуаций должны быть сообщения DEBUG_ERROR/DEBUG_WARN

-## 🔐 Cryptography Guidelines
+### Memory Management
+- Use `u_malloc`/`u_calloc`/`u_realloc`/`u_free`/`u_strdup` from `lib/mem.h` (wrappers with leak tracking)
+- Memory pools: `memory_pool_alloc()` / `memory_pool_free()` for hot-path allocations
+- Queue entries: `queue_entry_new_from_pool()` / `queue_entry_free()` / `queue_dgram_free()`
+
+## Cryptography Guidelines
+
+### Key Sizes
+| Constant | Value | Description |
+|----------|-------|-------------|
+| `SC_PRIVKEY_SIZE` | 32 | X25519 private key |
+| `SC_PUBKEY_SIZE` | 32 | X25519 public key |
+| `SC_NONCE_SIZE` | 13 | CCM nonce (exactly 13 bytes) |
+| `SC_SESSION_KEY_SIZE` | 16 | AES-128 session key |
+| `SC_TAG_SIZE` | 16 | CCM auth tag |
+| `SC_CRC32_SIZE` | 4 | CRC32 checksum |
+| `SC_PUBKEY_ENC_SALT_SIZE` | 8 | Salt for pubkey obfuscation |
+| `SC_PUBKEY_ENC_SIZE` | 40 | Total pubkey+salt block sent unencrypted |

 ### Using Secure Channel (secure_channel.h)
 ```c
 // 1. Initialize context
 struct SC_MYKEYS my_keys;
-// ... fill keys ...
+sc_init_local_keys(&my_keys, public_key_hex, private_key_hex);
+// or sc_generate_keypair(&my_keys);
+
 sc_context_t ctx;
 sc_init_ctx(&ctx, &my_keys);

 // 2. Set peer public key (for key exchange)
-sc_set_peer_public_key(&ctx, peer_public_key, 0); // 0 = binary format
+sc_set_peer_public_key(&ctx, peer_public_key, SC_PEER_PUBKEY_HEX); // 0=bin, 1=hex

 // 3. Ready for encrypt/decrypt
 sc_encrypt(&ctx, plaintext, plaintext_len, ciphertext, &ciphertext_len);
 sc_decrypt(&ctx, ciphertext, ciphertext_len, plaintext, &plaintext_len);
+
+// 4. Pubkey obfuscation (used in INIT/PING packets):
+//    salt(8) + XOR(SHA256(salt||peer_pubkey) || SHA256(peer_pubkey||salt), my_pubkey)
+sc_obfuscate_pubkey(salt, peer_pubkey_bin, my_pubkey_bin, obfuscated_output);
 ```

 ### Important Notes
- **Nonce size:** Must be exactly 13 bytes for CCM mode (`SC_NONCE_SIZE = 13`)
- **Session key:** 16 bytes for AES-128 (`SC_SESSION_KEY_SIZE = 16`)
- **Tag size:** 8 bytes for authentication (`SC_TAG_SIZE = 8`)
- **Error codes:** Check return values, negative = error
+- **Encryption:** 3-byte header (timestamp uint16_t + flag_up uint8_t) + data_len bytes encrypted
+- **INIT packets:** Header + data encrypted, pubkey+salt block (SC_PUBKEY_ENC_SIZE bytes) appended unencrypted
+- **Nonce:** Must be exactly 13 bytes for CCM mode
+- **Error codes:** Check return values, negative = error (SC_OK=0, SC_ERR_* < 0)

-## 🏗️ Architecture
+## Debug System
+
+### Debug Levels
+`none < error < warn < info < debug < trace`
+trace - логируем заходы в функции и важные ветвления внутри функций
+debug - отладка: всё что нужно для понимание сути происходящего (состояний, важных переменных) алгоритма. тоесть по уровню debug мы должны видеть все важные внутреннии нюансы работы функции включая состояния и переменные.
+info - сообщения для пользователя о работе. мы должны видеть в читаемом виде понятные и осмысленные сообщения о каких-либо значимых действиях с точки зрения логики работы модуля или приложения
+warn / error - ошибки и предупреждения (аномалии). должны быть во всех ошибочных ветках. Молча вываливаться с ошибкой нельзя, все ошибки и предупреждения должны логироваться.
+
+### Debug Categories (28 категорий)
+```
+NONE=0, UASYNC=1, LL_QUEUE=2, CONNECTION=3, ETCP=4, CRYPTO=5, MEMORY=6,
+TIMING=7, CONFIG=8, TUN=9, ROUTING=10, TIMERS=11, NORMALIZER=12, BGP=13,
+SOCKET=14, CONTROL=15, DUMP=16, TRAFFIC=17, DEBUG=18, GENERAL=19, NAT=20,
+KEEPALIVE=21, ETCPROUTE=22, BBR=23, ETCP_DUMP=24, CONNECTIVITY=25, DB_SYNC=26,
+MEMBER_SYNC=27
+```
+
+### Настройка отладки
+- В конфиге: `debug = etcp=trace,config=info` (формат: `категория=уровень,...`)
+- В коде: глобальный уровень и per-category уровни из `debug_config_t g_debug_config`
+- Макросы: `DEBUG_ERROR(cat,fmt,...)` `DEBUG_WARN` `DEBUG_INFO` `DEBUG_DEBUG` `DEBUG_TRACE`
+- `log_dump(prefix, data, len)` — hex dump в лог
+
+### Dual Output
+- Консоль и файл настраиваются раздельно (`debug_set_console_level`, `debug_set_file_level`)
+- `debug_enable_file_output(path, truncate)` / `debug_disable_file_output()`
+
+## Architecture

 ### Directory Structure
 ```
-├── lib/                    # Core libraries (uasync, ll_queue, memory pools)
+├── lib/                    # Core libraries (18 .c + 20 .h + libopus/liblmdb)
 ├── src/                    # Main source code
-│   ├── utun.c             # Main program entry
-│   ├── etcp*.c            # ETCP protocol implementation
-│   ├── secure_channel.c   # Cryptography
-│   └── tun_if.c          # TUN/TAP interface
-├── tests/                 # Test programs
-├── tinycrypt/             # TinyCrypt crypto library
-└── net_emulator/          # Network emulator
+│   ├── transport_layer/    #   ETCP stack, crypto, STCP, normalizer, BBR (~30 файлов)
+│   ├── routing_layer/      #   Routing, BGP, conn_mgr, etcp_router, NAT detection (~20 файлов)
+│   ├── chat/               #   P2P чат, db_sync, merkle_sync, member_sync (17 файлов)
+│   ├── proxy/              #   SOCKS5, TCP/UDP/ICMP прокси (10 файлов)
+│   ├── lwip_tcp/           #   Встроенный lwIP TCP стек (7 файлов)
+│   ├── media_delivery/     #   Доставка медиафайлов (6 файлов)
+│   ├── media_async/        #   Асинхронный движок медиа (2 файла)
+│   └── *.c/h               #   Корневые модули: utun, config, TUN, firewall, NAT, NTP, control (~14 файлов)
+├── tests/                  # ~70 тестов, 64 в check_PROGRAMS
+├── doc/                    # Technical Specifications
+├── tools/                  # Auxiliary tools
+│   ├── etcpmon/            # GUI монитор ETCP
+│   ├── chatgui/            # GUI чат (Qt 6 с Qt 5 fallback, сборка CMake)
+│   ├── chatgui-android/    # Android P2P чат (Jetpack Compose + libutun_lite)
+│   ├── tdesktop-dev/       # Референс: Telegram Desktop (только для изучения)
+│   ├── proxy/              # UDP прокси для тестов
+│   └── bping/              # BPing (bandwidth ping)
+├── tinycrypt/              # TinyCrypt crypto library (external)
+├── net_emulator/           # Network emulator (delays, loss, reordering)
+└── c2/                     # Test instance 2 (конфиг и бинарник для тестов)
 ```

+### File Overview
+
+**Core (src/)**
+- `utun.c` - Main program entry point, CLI parsing, daemon mode
+- `utun_instance.c/h` - Root instance lifecycle, config loading, all submodule init
+- `tun_if.c/h` - TUN interface API (init/write/close, cross-platform)
+- `tun_linux.c` `tun_freebsd.c` `tun_windows.c` - Platform-specific TUN implementations
+- `tun_route.c/h` - TUN routing table sync
+- `config_parser.c/h` - INI-style config file parsing
+- `config_updater.c/h` - Config file modification utilities
+- `control_server.c/h` - Control/monitoring server (etcpmon backend API)
+- `firewall.c/h` - Firewall rules (per-interface filtering)
+- `eim_nat.c/h` - Endpoint-Independent Mapping NAT engine
+- `nat_transport.c/h` - NAT transport layer (packet relay)
+- `ntp_time.c/h` - NTP time synchronization
+- `ntp_node_time.c/h` - Inter-node time synchronization
+- `broadcast.c/h` - Широковещательная рассылка данных по topo-группе (UUID-дедупликация, TTL)
+- `video/video.c/h` - Пробинг и транскодирование видео (FFmpeg, опционально; H.264/MP4 ≤720p)
+- `dnsmasq/` - Архив dnsmasq-2.93.tar.xz для встроенной сборки
+
+**Transport Layer (src/transport_layer/)**
+- `etcp.c/h` - ETCP protocol implementation (inflight queues, retrans, ACK, RTT/jitter)
+- `etcp_api.c/h` - ETCP public API (send/recv/bind callbacks)
+- `etcp_connections.c/h` - Socket and link management, INIT handshake, keepalive, PING/PONG
+- `etcp_loadbalancer.c/h` - Multi-link load balancing with traffic shaper
+- `etcp_debug.c/h` - ETCP packet dump/formatting
+- `etcp_dump.c/h` - ETCP дамп/декодирование пакетов
+- `etcp_bbr.c/h` - BBR congestion control for ETCP
+- `etcp_connect.c/h` - ETCP outbound connections
+- `etcp_keepalive.c/h` - Keepalive-пакеты, адаптивный период, смена режима standby/normal (мобильные узлы)
+- `auto_socket.c/h` - Автосоздание UDP+TCP сокетов на всех интерфейсах и линков к ETCP-соединениям (`auto_sockets=yes`)
+- `pkt_normalizer.c/h` - Packet fragmentation/reassembly (packer/unpacker)
+- `packet_dump.c/h` - Packet hex dump utility
+- `dummynet.c/h` - Network emulator integrated into utun (for testing)
+- `secure_channel.c/h` - AES-CCM encryption with X25519 key exchange, pubkey obfuscation
+- `crc32.c/h` - CRC32 checksums
+- `stcp.c/h` - STCP протокол (Secure TCP)
+- `stcp_server.c/h` - STCP сервер
+- `stcp_client.c/h` - STCP клиент
+- `stcp_link.c/h` - STCP линк-уровень
+- `node_conn_direct.c/h` - Direct config-based connections
+- `socket_monitor.c/h` - Socket state monitoring
+- `reality.c/h` - REALITY-style TLS ClientHello/ServerHello камуфляж для STCP
+- `reality_fingerprint.c/h` - Статические отпечатки (cipher suites, groups, ALPN) для REALITY-камуфляжа
+- `reality_relay.c/h` - Релей неавторизованных клиентов на реальный HTTPS-сайт
+
+**BBR (src/transport_layer/BBR/)**
+- `bbr_v3.c` - BBR congestion control algorithm v3
+
+**Routing Layer (src/routing_layer/)**
+- `routing.c/h` - Routing table (local)
+- `route_lib.c/h` - Routing library
+- `route6_lib.c/h` - IPv6 routing
+- `route_ping.c/h` - Route ping probing (NAT check, liveness)
+- `route_connectivity.c/h` - Route connectivity checks
+- `topo_group.c/h` - BGP-like route exchange between nodes (NODEINFO/WITHDRAW, изолированные группы UTUN/CHAT)
+- `topo_group_connect.c/h` - Авто-подключение к узлам CHAT-группы (3 фазы, бесконечный цикл)
+- `topo_group_invite.c/h` - Invite/join канала через прямое ncd-подключение (INVITE_INFO_REQ/RESP)
+- `topo_node.c/h` - Node management (модель узла: TOPO_NODE/TOPO_GROUP_NODE, сериализация, node_registry)
+- `topo_node_sqlite.c/h` - SQLite persistence for nodes
+- `topo_recovery.c/h` - Восстановление каскадно отвалившихся узлов после разрыва соединения
+- `conn_mgr.h` + `conn_mgr_core.c`/`conn_mgr_indirect.c`/`conn_mgr_monitor.c` + `conn_mgr_priv.h` — Connection Manager (handle-based API, 3-phase DIR/REV/IND)
+- `etcp_router.c/h` - ETCP router/multiplexer (мультиплексирование каналов, transit forwarding)
+- `nat_detection.c/h` - NAT type detection
+- `route_crypto.c/h` - Пред/пост-обработка SVC_ROUTE пакетов (encrypt-then-sign)
+
+**Chat (src/chat/)** — децентрализованный P2P чат: сообщения и участники автоматически синхронизируются между всеми узлами канала без центрального сервера.
+- `chat_core.c/h` - Главный модуль чата. Единственная точка входа из GUI: принять сообщение, создать канал, изменить настройку. Управляет БД и жизненным циклом всех chat-модулей
+- `chat_core_priv.h` - Внутренний API для частей chat_core: общий контекст и утилиты БД. Снаружи не используется
+- `chat_sync.c/h` - Связывает чат с ETCP-сетью: отслеживает появление/разрыв соединений, обновляет онлайн-статус узлов, запускает синхронизацию участников каналов, обрабатывает приглашения
+- `chat_event.c/h` - Доставка событий из ядра чата в GUI. Единый механизм: любой модуль отправляет событие (новое сообщение, смена участников, статус), GUI получает через один обработчик
+- `chat_setting.c/h` - Настройки чата: проверяет корректность значений, хранит текущие. Используется и headless-парсером конфига, и GUI. Не зависит от других модулей
+- `db_sync.c/h` - Автоматическая репликация данных между подключёнными узлами. Запись на одном узле — появляется у всех остальных. Криптоподписи и цепочка хешей защищают от подделок
+- `member_sync.c/h` - Синхронизация участников каналов поверх merkle_sync. Два подписанных блока (мембер/владелец), по-блочное сравнение версий, верификация подписей. Удаление — только битая запись
+- `merkle_sync.c/h` - Универсальный движок синхронизации на Merkle-деревьях (5 уровней × 32 бакета, SHA256). Пиры обмениваются хешами и передают только различия; per-session out-очередь с backpressure. Не привязан к конкретному типу данных (коллбэки `data_ops`)
+- `chat_profile.c` - Собственный профиль: имя узла, сетевые адреса, сохранение UI-состояния (часть chat_core)
+- `chat_channel.c` - Создание и настройка каналов: готовит таблицы в БД, генерирует криптоключи, запускает подключение ко всем участникам (часть chat_core)
+- `chat_msg.c` - Отправка и приём сообщений: запись в локальную БД, автоматическая рассылка всем участникам канала (часть chat_core)
+- `chat_status.c` - Сбор диагностики: текущее время, активные соединения, типы NAT. Отправляется в GUI (часть chat_core)
+- `chat_member.c/h` - Единая структура мембера для отображения в GUI (десктоп/headless/Android), фиксированная сериализация на проводе
+- `chat_admin.c/h` - Передача канального приватного ключа (прав админа) другому узлу
+- `chat_whisper.c/h` - Whisper speech-to-text транскрипция голосовых сообщений (опционально, асинхронно через media_async)
+- `chat_headless_control.c/h` - TCP control-socket для headless chat CLI (JSON line protocol)
+- `invite_build.c/h` - Сборка invite-ссылок utun:// (выбор лучшего узла + адреса)
+- `invite_link.c/h` - Формат invite-ссылок utun:// для каналов (base64: version|password|channel_id|pubkey|addrs)
+
+**Прокси (src/proxy/)**
+- `socks_proxy.c/h` - SOCKS5 прокси
+- `udp_proxy.c/h` - UDP прокси
+- `icmp_proxy.c/h` - ICMP прокси
+- `tcp_proxy_server.c/h` - TCP прокси (серверная сторона)
+- `tcp_proxy_client.c/h` - TCP прокси (клиентская сторона)
+
+**lwIP TCP (src/lwip_tcp/)**
+- `lwip_tcp.c/h` - lwIP TCP стек
+- `lwip_tcp_out.c` / `lwip_tcp_in.c` - Исходящий/входящий трафик
+- `lwip_pbuf.c/h` - Пакетные буферы lwIP
+- `lwip_tcp_priv.h`, `lwip_tcp_opts.h` - Внутренние настройки lwIP
+
+**Media Delivery (src/media_delivery/)**
+- `media_delivery.c/h` + `media_delivery_proto.h` - Доставка медиафайлов, протокол
+- `media_download.c/h` - Скачивание медиа
+- `media_index.c/h` - Индексация медиафайлов
+
+**Media Async (src/media_async/)**
+- `media_async.c/h` - Асинхронный движок (thread-per-task для crypto/file операций)
+
+**Libraries (lib/)**
+- `u_async.c/h` - Async event loop (epoll/poll/select, timers via timeout_heap)
+- `ll_queue.c/h` - Lock-free linked list queue with callbacks, hash index, threshold waiter
+- `memory_pool.c/h` - Fast object pool allocator (pre-allocated blocks)
+- `debug_config.c/h` - Debug logging system (levels, categories, dual output, runtime config)
+- `timeout_heap.c/h` - Min-heap for timer management (used by u_async)
+- `mem.c/h` - Memory wrappers with leak tracking (`u_malloc`/`u_free`/`u_calloc`/`u_strdup`)
+- `serialize.c/h` - Binary serialization utilities
+- `swm_min.c/h` - Sliding window minimum (for RTT min tracking)
+- `getmyip.c/h` - Get local IP / default route detection
+- `myip.c` - My IP helper (no header)
+- `socket_compat.c/h` - Cross-platform socket compatibility (Linux/FreeBSD/Windows)
+- `platform_compat.c/h` - Cross-platform compatibility layer (byte order, time, random)
+- `radix.c/h` - Radix tree for IP routing lookups
+- `tcp_io.c/h` - TCP I/O abstraction (Windows IOCP, Linux epoll)
+- `sqlite3.c/h` - SQLite3 amalgamation (embedded database)
+- `opus_codec.c/h` - Opus audio codec wrapper
+- `audio_compressor.c/h` - Audio dynamic range compressor
+- `json_flat.c/h` - Flat JSON parser
+- `strbuf.c/h` - Безопасный растущий printf-буфер (замена snprintf-цепочек)
+- `async_dns.c/h` - Асинхронный (неблокирующий) DNS-резолвер A-записей поверх uasync, адаптер над libdns
+- `dns.c/h` - Рекурсивный reentrant DNS-резолвер (libdns, MIT)
+- `miniaudio.h` - Воспроизведение/захват аудио (single-header)
+- `dr_mp3.h` - MP3-декодер (single-header, на базе minimp3)
+- `liblmdb/` - Встраиваемый key-value store LMDB
+- `libopus/` - Встраиваемый кодек Opus
+- `wintun.h` - Wintun API header for Windows TUN driver
+
+**Memory Pools in UTUN_INSTANCE:**
+- `data_pool` — для данных пакетов (payload), используется input_queue/output_queue фрагментами
+- `pkt_pool` — для struct ETCP_DGRAM (сетевые пакеты на отправку/приём)
+- `ack_pool` — для struct ACK_PACKET (подтверждения приёма)
+
 ### Key Components
- **UASYNC:** Asynchronous event loop for sockets and timers
- **LL_QUEUE:** Lock-free lockstep queue for packet handling
- **Memory Pool:** Fast allocation for network packets
- **ETCP:** Extended TCP protocol with crypto and reliability
- **Secure Channel:** AES-CCM encryption with ECC key exchange
+- **UASYNC:** One per thread. Async event loop (epoll/poll), timers via timeout_heap
+- **LL_QUEUE:** Lock-free queue with auto-callback, hash index lookup, threshold waiter
+- **Memory Pool:** Fast allocation for hot-path objects (packets, inflight entries, fragments)
+- **ETCP:** TCP-like reliable protocol with encryption, multi-link, load balancing
+- **Secure Channel:** AES-CCM + X25519 key exchange, nonce-based encryption, pubkey obfuscation

-## 🐛 Debugging Tips
+## Queue Usage Rules

-### Enable Debug Output
-```c
-// In source files, define debug before including headers
-#define DEBUG_CATEGORY_YOUR_MODULE 1
-```
+## Работа с очередями. Важно!
+С очередью следуею работать придерживаясь следующих правил:
+- при сетевом обмене не забиваем очередь. всегда используем Пороговое ожидание (backpressure).
+- для работы с очередью полностью загрузи ll_queue.h и пойми как работает.

-### Common Build Issues
-1. **Missing headers:** Check include paths in Makefile.am
-2. **Undefined references:** Ensure source files are listed in Makefile.am
-3. **Link errors:** Check function declarations match definitions
+### Запись в очередь
+- Очереди забивать нельзя. Добавляй следующий элемент только когда очередь стала пустой.
+- Порог задаётся через `queue_set_threshold(q, max_packets, max_bytes)`.
+- Используй `queue_waiter_wait` для ожидания освобождения очереди до заданного порога.

-### Testing Crypto
+### Чтение из очереди
+- Используй `queue_set_callback`: при вызове callback обработай один или несколько элементов, потом вызови `queue_resume_callback`.
+- Внутри коллбэка ОБЯЗАТЕЛЬНО: `queue_data_get(q)` → обработать элемент → `queue_resume_callback(q)`
+- Без вызова `queue_resume_callback` очередь навсегда застрянет
+
+### Поиск
+- `queue_data_put_with_index(q, entry)` — добавляет с индексом для быстрого поиска (offset/size заданы при queue_new)
+- `queue_find_data_by_index(q, key)` — поиск по индексу через хеш-таблицу (размер ключа из q->index_size)
+
+## u_async Rules
+- Нельзя использовать в одном потоке несколько u_async. Один поток = всегда 1 uasync instance
+- Нельзя использовать sleep/usleep если есть uasync. Нужно использовать `uasync_set_timeout`.
+- Таймеры: `uasync_set_timeout(ua, timeout_tb, arg, callback, name)` — timebase units (0.1ms)
+  Возвращает `void*` handle, отмена: `uasync_cancel_timeout(ua, handle)`.
+
+## Config Rules
+- В серверном конфиге только собственные ключи и нет секций `[client]`
+- В клиентском конфиге есть собственные ключи и pubkey каждого сервера в секции `[client]`
+- Chat-настройки хранятся в секции `[chatserver]` (принимается также `[chat]`). Парсер вызывает `chat_setting_set(key, value)` для каждого ключа — неизвестные ключи вызывают ошибку. Пример:
+  ```ini
+  [chatserver]
+  storage_autoload=1
+  storage_unit_size=10M
+  storage_total_size=1G
+  opus_codec_preset=1
+  compressor_enabled=0
+  compressor_max_gain_db=25
+  compressor_rise_rate=10
+  media_download_max_peers=3
+  ```
+
+## Bugs Debugging Protocol
+Всегда когда начинаешь диагностику ознакомься со скиллом (используй skills)
+Диагностика и поиск ошибок - это в первую очередь продумывание отладочных механизмов которые покажут понятную картину и точное представление об ошибке. Рассуждать надо как диагностикой добиться точной картины. И как приавльнее добавить диагностику чтобы не спамила лишними сообщениями и была понятной, логичной и информативной.
+
+Важное правило отладки: вся отладка сводится к тому чтобы сделать удобные логи которые наглядно показывают поведение и проблемы. без лишнего мусора, компактно и по существу. очень желательно с деталями которые сильно повышают качество отладки.
+при отладке нельзя: гадать и долго пытаться разбирать код пытаяясь найти причину. гораздо надёжнее с помощью логов понято точное поведение.
+Если логов много - записывай в файл и потом анализируй.
+Если видишь спам-логи - подумай как их выборочно отключить чтобы не мешали.
+
+Для отладки добавляй в DEBUG_CATEGORY_DEBUG диагностические сообщения где надо. И включи эту категорию в настройках. Убирай только после проверки (путём запуска) когда все ошибки устранены.
+сообщение выводится по или - либо debug_set_level(DEBUG_LEVEL_TRACE) - выводится ВСЁ независимо от настроек по категориям. Тоесть берется max(global level, category lavel)
+
+Твой бич - ты постоянно гадаешь и анализируешь код. Что приводит к снежному кобу ошибок и неверных гипотез. 10 раз повторяю - только логи логи логи и никакого гадания. Лоооги!!! правильные логи покажут всё с предельной точностью. Вся суть отладки - информативные логи
+И смотри логи. не задавливай их grep-ом. лучше больше. единственное с чем борись - это бесполезные спам логи.
+Проблемы часто не там где их ищешь. Поэтому анализируй более полно логи и приглядывайся к любым подозрительным местам. А не одну строку выгребай грепом безуспешно по 10му кругу когда реальная проблема в другом месте.
+Ты часто как слепой котёнок не смотришь по сторонам, пытаясь найти проблему где сам придумал и логично что ничего не получается.
+Правльный подход: оптимиировать логи под конкретный баг. Убрать спам и вывести всё что относится к отлаживаемому механизму со всеми нужными подробностями. Прогнать и внимательно проанализировать ВЕСЬ это лог. Если он слишком большой - думай как выводить только нужное не в ущерб информативности.
+
+Но полезные смотри всегда, и всегда оставляй логи которые выводятся нечасто.
+Частые логи - это трафик которые >100 раз повторяются. Но которые мало раз обязательно оставлять и выводить.
+можешь в тесте включить логи в нужный интервал чтобы не спамить. debug_set_level(DEBUG_LEVEL_TRACE) и выключить debug_set_level(DEBUG_LEVEL_NONE)
+Если видишь проблему и ее решение неочевидно то выстраивай диагностику вокруг неё пока не будет очевидно где и что происходит не так. Это базовое и обязательное требование к отладке.
+Подробные логи ты должен выводить не обрезая всегда и анализировать. Если лог большой - выведи в файл и анализируй файл.
+Рассуждение должно быть примерно таким:
+  - данные повреждаются при отправке.
+  - где и почему непонятно. надо продумать ключевые точки где получим максимум полезной информации и не было большого объёма вывода лога.
+  - где лучше? каждый пакет логировать - много, но будет предельно точная картина
+  - Еще хорошо бы время - так мы заодно сможем найти проблемы с производительностью, найти проблемные места застревания кода.
+  - Но это большой объём. Можно ли без него? можно но это будет малоэффективно и хороших альтернатив пока не видно.
+  - Значит логируем весь трафик, а заодно включим полную трассировку функций.
+  - Запустили. Записали весь процесс в файл. Теперь можно анализировать. Давай сперва посчитаю количество строк с дампом: ... 50000.
+  - давай сделаю простой скрипт который дамп прочитает и сохранит в файл. И сверю с оригинальным файлом
+  - Давай заодно возьму произвольный фрагмент лога и изучу еа предмет явных проблем. Особенно инициализацию и освобождение ресурсов.
+    Сколько времени занимает, нет ли заклиниваний, нет ли ошибок или странностей
+
+### Диагностические сообщения (DEBUG_WARN DEBUG_ERROR)
+Сообщения должны говорить что случилось и с какими деталями.
+Обязательно выводить подробные собощения об ошибках (даже если нужен небольшой дополнительный код чтобы эти детали сформировать и привести в читаемый вид).
+Полезны подробности об инициализации-завершении которые помогают понять внутренние состояния
+Диагностические сообщения - важный момент. надо про диагностику помнить.
+Для хорошей диагностики надо проанализировать как архитектор - какие есть нюансы в архитектуре и что полезно будет видеть в дебаг выводе чтобы понять полную картину происходящего.
+
+### Запрещено (опыт 2026-07-31 — потеря всех некоммиченных изменений):
+- `git checkout -- <wildcard>` / `git checkout -- src/` — безвозвратный откат ВСЕХ файлов
+- `sed` для массовых правок исходников — замены разъезжаются, ломают код, часы на восстановление
+- Пакетные замены через Bash в 10+ файлах одновременно
+- Повторять эти ошибки: потеря + попытка отката git checkout = двойная потеря
+
+### Правила безопасного рефакторинга:
+1. Правки ТОЛЬКО через Edit tool — одна точечная замена с контекстом
+2. После каждого файла → `git add <file>`
+3. Каждые 2-3 файла → `git commit -m "..."` (не дожидаясь сборки)
+4. Никакого `sed` / `awk` / `perl -i` для правки исходников
+5. Перед откатом → сначала коммит всего, потом `git revert` конкретного коммита
+
+### Прочие правила:
+- sed для редактирования исходников - запрещено
+- Проверяй на дублирование кода - не сделано ли это уже в другом месте
+- Не делай функций-посредников: лучше сразу вызывать target функцию без вложенных вызовов
+- Нельзя ничего восстанавливать из репозитория не спрашивая
+- Для отладки не printf а DEBUG_*
+- Запрещено прямое включение arpa/inet.h, sys/time.h, unistd.h — использовать ../lib/platform_compat.h + socket_compat.h
+- Перед сборкой всегда make clean
+- Все лишнее что менял при отладке - строго вернуть назад в состояние до вмешательства
+
+## Написание кода
+- Строго обязательно наличие ERROR сообщений во всех ошибочных ветвях алгоритма
+- Обязательно наличие диагностических сообщений в ветках инициализации-очистки, с информацией которая позволяет оценить наиболее полно внетренние состояния на момент печати сообщения. Например выявить неправильные состояния, неинициализированные поля итд
+- Обязательно наличие подробной диагностики в функциях кода которые не сильно спамят (не часто вызываются).
+- Для каждого отладочного вывода подумай какая из доступной информация будет полезна чтобы можно было наиболее завершенно оценить состояние алгоритма и состояний влияющих на алгоритм.
+
+
+## chatgui (GUI Chat Client)
+
+Chatgui — десктопный GUI-чат на Qt 6 (Qt 5 fallback), отдельный проект внутри репозитория. Не связан с autotools-сборкой utun.
+
+В chat gui интегрированы библиотеки utun. Чат и библиотеки работают в разных потоках. Поэтому нужно использовать семафоры, сокеты или другие механизмы синхронизации (uasync_post, uasync_memsync, uasync_get_wakeup_fd)
+
+База данных sqlite в chatgui: можно писать (update) из потока utun / instance. можно только читать из gui потока.
+
+### Технологии
+- **Язык:** C++20
+- **Фреймворк:** Qt 6 (предпочитаемый) или Qt 5.15+ (Widgets + Network)
+- **Сборка:** CMake 3.16+
+- **БД:** SQLite3 (WAL mode, встроенный `db/sqlite3.c` amalgamation)
+- **Анимации:** rlottie (C API) + zlib (gzip-декомпрессия TGS)
+
+### Сборка
 ```bash
-cd tests/
-./test_etcp_crypto      # Should show all tests passing
-cd tests/
-./working_crypto_test   # Standalone crypto test
+# Установка зависимостей
+sudo apt install librlottie-dev zlib1g-dev qt6-base-dev
+# или qtbase5-dev для Qt 5 fallback
+
+# Сборка
+cd tools/chatgui && mkdir -p build && cd build
+cmake .. && make -j4
+./chatgui
 ```

-## 📦 Dependencies
+### Конфиг и логи чатгуи
+- **Конфиг:** `tools/chatgui/build/chatgui.cfg` (в `.gitignore`, содержит приватные ключи)
+  - Секция `[gui]`: `debug_file`, `debug_level`, `debug_categories=cat=level,...`
+  - Секция `[control]`: `ip`, `port` для подключения etcpmon
+  - Секция `[ntp]`: синхронизация времени
+- **Лог:** `tools/chatgui/build/chatgui.log` (путь задаётся в конфиге `debug_file`)
+- **БД чата:** `tools/chatgui/build/chat_data/` (SQLite, путь из `db_path` в конфиге)

-### Build Dependencies
- autoconf, automake, libtool
- gcc with C99 support
- pthread library
- OpenSSL/crypto library (for SHA256)
+### Структура файлов (src/)

-### Runtime Dependencies
- TUN/TAP interface support (Linux kernel module)
- libcrypto (usually installed by default)
- Proper network configuration for testing
+| Файл | Назначение |
+|------|-----------|
+| `main.cpp` | Точка входа, инициализация QApplication |
+| `mainwindow.h/cpp` | Главное окно, QSplitter (ChannelList \| MessageList \| AccountList), трей |
+| `chatview.h/cpp` | QListView с фоновым изображением, hover-сигнал, drag-to-select |
+| `messagelist.h/cpp` | QStandardItemModel, stub-данные, инициализация анимаций, hover→activate |
+| `messagedelegate.h/cpp` | QStyledItemDelegate: бабблы, текст, цитаты, реакции, оверлей анимаций |
+| `emoji.h/cpp` | EmojiData/EmojiCategory/EmojiType, 4 категории, `g_animatedEmojiMap` |
+| `emojipanel.h/cpp` | Эмодзи-пикер: QTabWidget + QGridLayout, EmojiButton с hover-анимацией |
+| `emojitabbar.h/cpp` | Кастомный QTabBar для эмодзи-панели |
+| `inputbar.h/cpp` | Поле ввода (QTextEdit), вставка эмодзи, отправка по Enter |
+| `lottieicon.h/cpp` | Загрузка TGS (gzip→zlib), рендер кадров через `lottie_animation_render` |
+| `animtimer.h/cpp` | Синглтон-таймер 30fps, refcount activate/deactivate, сигнал ticked |
+| `channellist.h/cpp` `channeldelegate.h/cpp` | Список каналов с аватарами и превью |
+| `accountlist.h/cpp` `accountdelegate.h/cpp` | Список аккаунтов/пользователей и его делегат отрисовки |
+| `memberlistmodel.h/cpp` | Модель списка участников канала |
+| `memberpropsdialog.h/cpp` | Диалог свойств участника |
+| `flagpainter.h/cpp` | Отрисовка иконок мембера (admin/mod/supernode/storage) |
+| `joindialog.h/cpp` | Диалог присоединения к группе/каналу |
+| `invitedialog.h/cpp` | Диалог приглашения пользователя |
+| `invite_link.h/cpp` | Логика invite-ссылок |
+| `inviteby.h/cpp` | Диалог приглашения по invite-ссылке (отправка через узел) |
+| `settingsdialog.h/cpp` | Окно настроек |
+| `creategroupdialog.h/cpp` | Диалог создания группы |
+| `channelsettingsdialog.h/cpp` | Диалог настроек канала |
+| `renamedialog.h/cpp` | Диалог переименования |
+| `networksettingspage.h/cpp` | Страница сетевых настроек |
+| `nodespage.h/cpp` | Таблица узлов + дамп в настройках |
+| `statuspage.h/cpp` | Страница статуса (NTP + соединения + живые часы) |
+| `databasesettingspage.h/cpp` | Страница обслуживания БД в настройках |
+| `storagesettingspage.h/cpp` | Страница настроек хранилища |
+| `soundsettingspage.h/cpp` | Страница настроек звука |
+| `audiodevicesettingspage.h/cpp` | Страница настроек аудиоустройств |
+| `sound_manager.h/cpp` | Управление звуками/уведомлениями |
+| `audiorecorder.h/cpp` | Запись голосовых сообщений (захват аудио) |
+| `voicemessageencoder.h/cpp` | Кодирование голосовых сообщений (Opus) |
+| `voiceplayback.h/cpp` | Воспроизведение голосовых сообщений |
+| `media_blocks.h/cpp` | Чтение/сборка фрагментированных медиафайлов |
+| `imageviewer_window.h/cpp` | Окно просмотра изображений |
+| `videoplayer_engine.h/cpp` | Движок декодирования видео |
+| `videoplayer_window.h/cpp` | Окно просмотра видео |
+| `connmonitorwindow.h/cpp` | Окно мониторинга ETCP-соединений (standalone) |
+| `qrcode_utils.h/cpp` | Утилиты для QR-кодов |
+| `debug_ui.h` | Отладочный UI |

-## 📝 Git Conventions
+### Другие поддиректории
+- `db/` — SQLite3 amalgamation (`sqlite3.c/h`), `db_manager.h/cpp` (схема: nodes, node_addresses, channels, msg_<channel>, peers_<channel>, local_identity, accounts, ui_state)
+- `transport/` — интеграция с uTun: `gui_bridge.h/gui_bridge_impl.cpp` (Qt signal-based обмен), `node_config.h/cpp` (конфиг узла), `config_updater.h/cpp` (правка конфига), `utun_node.h/cpp` (обёртка узла), `miniaudio_impl.c` (single-header miniaudio в отдельной единице трансляции). Chat-логика (`chat_core`, `chat_sync` и т.д.) компилируется напрямую из `src/chat/`, роутинг — из `src/routing_layer/` (см. `libutun/CMakeLists.txt`)
+- `resources/` — `bg.jpg`, `chatgui.qrc` (встраивает 5 TGS в бинарник), `animations/*.tgs`

- **Commit Messages:** Use imperative mood, concise (50-72 chars)
- **Language:** Mix of English (technical) and Russian (business logic)
- **Branching:** Use feature branches, merge to master via pull request
- **Tags:** Version tags follow vX.Y.Z format
+### Система анимированных эмодзи

-Example commits:
+#### Формат
+TGS = gzip-сжатый Lottie JSON. Холст 512×512, 60fps, 90–180 кадров. Декомпрессия через zlib (`inflateInit2` с `16+MAX_WBITS`).
+
+#### Ключевые компоненты
 ```
-Fix: Added uasync_t typedef for compilation
-Crypto: Fixed CCM nonce size to 13 bytes, all crypto tests passing
+LottieIcon                    — загрузка TGS, рендер кадров (rlottie C API)
+    ↓
+AnimTimer (синглтон)          — таймер 33ms, refcount activate/deactivate
+    ├── в сообщениях:         → MessageDelegate::paint()
+    │     drawAnimatedEmojiOverlay() — QTextLayout → позиции эмодзи → drawImage()
+    │     drawStatusBar() — анимированные реакции вместо drawText()
+    │
+    ├── в панели:             → EmojiButton (наследует QPushButton)
+    │     per-button QTimer, enterEvent/leaveEvent, собственный paintEvent
+    │
+    └── активация:            → ChatView::hoveredIndexChanged
+          MessageList проверяет текст/реакции сообщения на g_animatedEmojiMap
+          есть анимация → AnimTimer::activate()  /  нет → deactivate()
 ```

-## 🚀 Quick Start for New Features
+#### Инициализация
+1. `MessageList` конструктор: загружает все `EmojiType::Animation` из `builtinEmojiSet()`, создаёт `LottieIcon`, регистрирует в `AnimTimer`
+2. **Должно быть ДО создания `EmojiPanel`** — иначе `EmojiButton` получит `nullptr`
+3. `g_animatedEmojiMap` заполняется при старте (Unicode → animPath)

-1. Add new source file to `src/Makefile.am` under `utun_SOURCES`
-2. Add test file to `tests/Makefile.am` under `check_PROGRAMS`
-3. Use existing patterns from similar modules
-4. Run `make check` after changes
-5. Commit with descriptive message in appropriate language
+#### Текущий маппинг (5 эмодзи)
+| Unicode | Shortcode | TGS-файл |
+|---------|-----------|----------|
+| ✨ `U+2728` | `:sparkles:` | `sparkles_emoji.tgs` |
+| 🏳️ `U+1F3F3` | `:flag:` | `white_flag_emoji.tgs` |
+| 👋 `U+1F44B` | `:wave:` | `greeting.tgs` |
+| ✋ `U+270B` | `:raised_hand:` | `stop.tgs` |
+| 🤖 `U+1F916` | `:robot:` | `robot.tgs` |
+
+#### Рендеринг в сообщениях
+- Текст рисуется через `QPainter::drawText(Qt::TextWordWrap)`
+- `drawAnimatedEmojiOverlay()` повторяет layout через `QTextLayout` с теми же параметрами
+- Для каждого эмодзи из `g_animatedEmojiMap` находит пиксельную позицию через `QTextLine::cursorToX()`
+- Рендерит кадр через `LottieIcon::renderFrame(currentFrame(), size)` и рисует `drawImage()`
+- Размер эмодзи масштабирован ×1.3 относительно высоты строки
+- Аналогично для реакций в `drawStatusBar()`
+
+#### Drag-to-select
+- Одиночный клик снимает выделение (если было), не стартует новое
+- Движение ≥5px от точки нажатия стартует выделение (`m_selStart`/`m_selEnd`)
+- Ctrl+C копирует: для одного сообщения — выделенный фрагмент, для нескольких — `[time] author: text`
+
+### Важные правила chatgui
+- `CMAKE_AUTORCC ON` обязателен для компиляции `.qrc`-ресурсов
+- Иконки должны быть зарегистрированы в `AnimTimer` ДО создания `EmojiPanel`
+- `EmojiButton` НЕ использует `Q_OBJECT` (в анонимном namespace) — таймер через лямбду, каст через `dynamic_cast`
+- Координаты `indexAt()`: `viewport()->mapFrom(this, event->pos())`

 ---

-Важные дополнения:
- если в процессе исправлений-доработок возникла нестыковка которая требует сеньезных доработок, остановить и подробно расскажи об этом.
- sed для редактирования исходников - запрещено пользоваться!
- Проверяй на дублирование кода - не сделано ли это уже в другом месте.
- Не делай функций-посредников: лучше сразу вызывать target функцию без вложенных вызовов.
- Старайся чтобы функция сделала логически завершенную операцию полностью - это упрощает код и понимание.
- нельзя ничего восстанавливать из репозитория не прашивая
- Когда пишешь код всегда загружай в контекст и мысленно разберись как работают все функции/струтуры, назначение переменных которые используешь.
+## tdesktop-dev (референсный проект Telegram Desktop)

-*Last updated: 2025-01-20 - After full crypto implementation and testing*
+**Расположение:** `tools/tdesktop-dev/` — полный клон [Telegram Desktop](https://github.com/telegramdesktop/tdesktop).
+
+**Статус:** референс. Не собирается, не модифицируется, в `.gitignore`.
+
+**Назначение:**
+- Источник TGS-анимаций (`Telegram/Resources/animations/` — 99+ файлов)
+- Образец использования rlottie/lib_lottie API
+- Архитектурный референс для GUI-компонентов
+
+**Правила:**
+- НЕ модифицировать файлы внутри `tdesktop-dev/`
+- НЕ коммитить изменения из `tdesktop-dev/`
+- НЕ ссылаться в сборке на код/библиотеки из tdesktop-dev
+- Можно копировать TGS-файлы в `tools/chatgui/resources/animations/`
+
+**Полезные поддиректории:**
+- `Telegram/Resources/animations/` — TGS-анимации (dice, reactions, emoji, UI)
+- `Telegram/lib_lottie/` — C++ обёртка над rlottie (SinglePlayer, MultiPlayer, Icon, FrameGenerator)
+- `Telegram/ThirdParty/rlottie/` — submodule rlottie (обычно не выкачан)
+
+**rlottie C API (ключевые функции):**
+```c
+Lottie_Animation *lottie_animation_from_data(const char *data, const char *key, const char *resource_path);
+void lottie_animation_get_size(const Lottie_Animation *anim, size_t *w, size_t *h);
+size_t lottie_animation_get_totalframe(const Lottie_Animation *anim);
+double lottie_animation_get_framerate(const Lottie_Animation *anim);
+void lottie_animation_render(Lottie_Animation *anim, size_t frame, uint32_t *buf, size_t w, size_t h, size_t stride);
+void lottie_animation_destroy(Lottie_Animation *anim);
+```
+
+---
+
+## Key Documentation Files
+- `/doc/etcp_protocol.txt` - ETCP протокол (формат кодограмм, ACK, handshake, keepalive)
+- `/doc/etcp_arch.md` - ETCP архитектура
+- `/doc/etcp_config.txt` - Конфигурация ETCP
+- `/doc/etcp_router_arch.md` - ETCP роутер архитектура
+- `/doc/route_p2pconn.txt` - Route peer-to-peer соединения
+- `/src/route_bgp.txt` - BGP обмен маршрутами (дизайн-документ)
+- `/doc/chat_join_test.md` - ТЗ теста join-протокола (chat_join + дерево приглашений)
+- `/doc/chat_join_test_tasks.md` - Список задач по тесту join (текущий статус, пошагово)
+
+## Список задач по проекту
+
+Список задач — `/doc/tasks.md` (текущая работа, берём по одной задаче сверху).
+При нахождении попутных багов/fail/флаков тестов добавляем задачу (либо фиксим сразу если баг простой).
+Как сделали - помечаем [+] выполнено.
+
+## chatgui-android (Android P2P Chat)
+
+**Расположение:** `tools/chatgui-android/`
+
+Android-версия чатгуи — P2P чат на STCP (TCP), UI на Jetpack Compose (Kotlin).
+C-ядро: `libutun_lite` (выборочная компиляция нужных .c из `lib/` и `src/`).
+Сборка: CMake (headless, Linux) + Gradle/NDK (Android APK).
+- 'fw' - собрать и обновить chatgui-android на всех подключенных телефонах (clean + сборка + install)
+
+**Подробная инструкция:** `tools/chatgui-android/AGENTS.md`
+**Chat-модули:** все файлы из `src/chat/` (описаны выше в секции «Chat») компилируются в `libutun_lite`.
+
+## Runtime
+- Запуск utun от root (для tun): `/home/vnc1/proj/utun3/utun_start.sh`
+- Стоп utun: `sudo /home/vnc1/proj/utun3/utun_stop1.sh`
+- Логи: `utun.log` (stdout), `utun_err.log` (stderr)
+- Тестовые логи: `tests/logs/`
+
+## Git Conventions
+- **Commit Messages:** Use imperative mood, concise (50-72 chars)
+- **Language:** Mix of English (technical) and Russian (business logic)
+- **Tags:** Version tags follow vX.Y.Z format
+- "cp" or "кп" in prompt = do commit and push (всех изменений на текущий момент, не откатывая). Запрещено откатывать "лишние" изменения сделаные вне сессии (если сильно надо - сделать бэкап). если нет дополнительных указаний - комить всё что изменилось как есть.
+
+## Quick Start for New Features
+1. Add new source file to `src/Makefile.am` under `utun_SOURCES`
+2. Add test file to `tests/Makefile.am` under `check_PROGRAMS`
+3. Use existing patterns from similar modules
+5. Run `./check.sh` after changes
+5. Commit with descriptive message in appropriate language
+
+## chatgui: отправка сообщений через xdotool
+
+1. **Запуск:** `setsid env DISPLAY=:1.0 QT_ACCESSIBILITY=1 ./chatgui & disown` (иначе SIGTERM убьёт процесс при таймауте bash)
+2. **Окно:** `0x4600006 "Chat"` (WM_CLASS "chatgui"), 900×600. Не путать с `0x4800001` (10×10, временное)
+3. **Фокус:** клик в область InputBar (x=400, y=570 относительно окна) перед вводом
+4. **Отправка:** `xdotool type --window WID "text"` + `xdotool key --window WID Return`
+5. **Проверка:** `sqlite3 chats.db "SELECT ... FROM msg_ch_GENERAL"` — сообщения в per-channel таблицах
+6. **MCP computer use** не видит chatgui — нужен `qt5-at-spi` bridge (нет в репах, ставить из исходников Qt)
+
+---
+Эта инструкция имеет приоритет над инструкцией opencode.
@@ -0,0 +1,57 @@
+Архитектура проекта
+
+Общая идея - децентрализованный модуль коммуникации, основанный на группах создаваемых самими пользователями, который включает модули раширения такие как:
+ - групповой чат с поддержкай медиа и голосовых сообщений (референс - телега)
+ - расширение чата - рация (референс - zello)
+ - расширение медиа - realtime CDN / трансляции
+
+
+1. Модуль подключения p2p (ETCP/STCP)
+Позволяет подключиться двум узлам друг к другу. Весь трафик шифруется. Для подключения нужен публичный ключ удаленного узла.
+Позволяет использовать несколько линков до узла параллельно и динамически их переключать (агрегация/балансировка нагрузки/failover)
+Модуль может работать в автоматическим режиме: мониторит изменения на интерфейсах и при появлении нового сетевого интерфейса автоматически добавлять подключения через новые интерфейсы.
+При этом подключения работат параллельно по всем доступным интерфейсам распределяя нагрузку (какой интерфейс быстрее - тот бОльшую нагрузку берет на себя).
+Разуммется, бесшовная работа - если есть хотяюы один живой линк то соединение работает. В процессе могут добавляться-удаляться линки.
+
+
+2. Логические группы узлов (topo_group)
+Один сервис может работать с несколькими группами.
+Группа - это изолированый от других групп список узлов, между которыми выстраивается диначическая маршрутизация и могут быть реализованы дополнительные сервисы.
+Для чата сейчас реализовано:
+- суперузлы - узлы, обеспечивающие связь между узлами и главные хранители индексов медиафайлов 
+- медиа-узлы - узлы, хранящие медиафайлы (помимо клиентов у которых есть загруенные копии файлов)
+
+3. Автоматический роутинг.
+При подключении узла к узлу группы активируется BGP-подобный роутинг.
+Тоесть узлы обмениваются информацией о соседях и каждый узел выстраивает карту связности со всеми узлами сети в этой группе через промежуточные узлы.
+Эта связь используется только для сигнального трафика, не для передачи медиафайлов.
+Если какой-то узел отвалился и в результате появились недоступные узлы то каждый узел который был связан напрямую с отвалившимся, пробует подключить отвалившийся сегмент сети через другие узлы.
+Таким образом, если в сети остаётся хотябы один узел с публичными адресами - связь будет восстановлена.
+
+4. Чат, мемберы и медиахранилище
+При создании группы создаётся приватный-публичный ключ группы. Им подписываются действия суперадминов - можно задавать админов группы, суперузлы, медиаузлы итд.
+Для каждой группы есть в базе:
+- список мемберов (участников группы, со своими публичными ключами и адресами-кандидатами для подклчюения), и их тип который может задавать владелец группы (все сообщения подписываются)
+  мемберы синхронизируются между узлами используя merkle-tree сравнение таблиц.
+- список сообщений чата. append-only таблица. синхронизируется только хвост - находим первое расхождение и добавляем отсутствующие записи соседей.
+- список медиаблоков.
+  Таблица в которой указано какие узлы хранят какие медиафрагменты.
+  И какие мадиафрагменты скачивают.
+  Позволяет вытраивать цеочку раздачи контента. например:
+  - владелец опубликовал медиафайл порезанный на 10 кусков.
+    Далее 100 человек в чате увидели сообщение и захотели скачать.
+    Обратились к суперузлам с вопросом - где есть блоки.
+    Медиаузел отвечает:
+    - список узлов у кого есть нужный блок или кто уже качает нужный блок.
+    Далее узел который хочет скачать устанавливает оптимальную связь с узлом (напрямую или через оптимального посредника), после - скачивает нужный блок
+    Владелец блока имеет лимит количества подклчений. Если лимит исчерпан - он возвращает список ущлв которые скачивают у него контент (Я загружен - качай у следующих по цепочке).
+    Таким образом узел желающий скачать контент, дойдёт до незагруженного узла через дерево загрузок и начнёт у него скачивать. Точнее, выберет лучшего по RTT и скачает.
+    Подобным образом можно выстраивать раздачу Live контента, оптимизируя связность узлов по RTT.
+
+    todo: оптимизация цепочки раздачи.
+    Допустим есть картина:
+    A (стример) -> B (посредник)  -> C (потребитель)
+        [msk]   50ms [мухосранск] 50ms   [msk]
+    Есть узел D(msk). у которого пинги: A-D: 5ms, B-D 50ms, C-D 5ms.
+    Тоесть узел заменив B может время цепочки A-C снизить с 100ms до 10ms.
+    Он предлагает после замеров RTT свою кандидатуру. наступает фаза probe - сравниваем несколько секунд RTT и объем у старого и нового узла. И принимаем решение - замена или отмена.
@@ -0,0 +1,89 @@
+# Задача: BGP NODEINFO теряется при флапающем реконнекте (chatgui member online не возвращается)
+
+## Кратко
+
+После рестарта Android-пира и реконнекта локальный chatgui показывает мембера **offline** и не возвращает **online**.
+Корневая причина — **не в chat/member коде**, а в ETCP: BGP-пакет NODEINFO (347 байт) расшифровывается, но **не доходит до BGP-обработчика** `topo_group_receive_cbk()`.
+
+Нужно: **точно локализовать точку потери NODEINFO в receive-пути ETCP и починить её.**
+
+## Что уже сделано (исправлено и работает)
+
+1. `tools/chatgui/src/mainwindow.cpp` — **исправлен** `onMemberUpdatedCallback`/`onMemberRemovedCallback`: проверка `len < 1+64+1+79` отбрасывала все события с channel_id короче 64 симв. Теперь `len < 1` + точная проверка. (Это была причина «не обновляется вообще».)
+2. `src/chat/chat_member.c/h` — добавлен `chat_core_member_online(ch_id,node_id)` = присутствие в `topo_group` (`topo_node_find_by_id`). Используется в `chat_core_get_member_list`/`get_single_member`. Убран `nodes.online` из SQL и блок `connected→2`.
+3. `src/chat/chat_core.c`, `src/chat/chat_sync.c`, `src/chat/member_sync.c/h` — удалён онлайн-статус из БД + merkle-online gossip (`member_sync_set_online`, `_ms_apply_update`, `push_update`).
+4. `src/chat/chat_status.c` + `tools/chatgui/src/accountlist.cpp` — флаг «bgp present» (0x08) для detail-панели.
+5. `tools/chatgui/src/nodespage.cpp` — убрана колонка Online из диагностики.
+
+Эти правки корректны; статус работает на чистом connect/disconnect/стабильном реконнекте.
+
+## Найденная причина (подтверждено логами)
+
+- Android **шлёт** свой NODEINFO: `send_nodeinfo: node 1657b3ea8281c0a8 ver=2` (bgp-debug на Android).
+- Локально пакет **расшифровывается**: `decrypt: code=01 dlen=347 plen=350` (347-байтный BGP-пакет, `code=0x01` = `ETCP_ID_TOPO_ENTRY`).
+- Но `BGP recv NODEINFO nid=1657` (строка 193 в `topo_group.c`) **не появляется** — до обработчика пакет не доходит.
+- При этом маленький `TABLE_COMPLETE` (10 байт) **доходит** (виден в логе как «mislabeled» `nid=aaaaaaaaaadeadbe` — это строка 193 логирует не-NODEINFO пакет как NODEINFO, garbage-поля).
+- Признак: в стабильных рестартах (18:18/18:20) узел **добавляется** каждый раз, в флапающем (18:07) — нет. Т.е. потеря привязана к флапу (TCP-линки + ETCP reinit).
+
+## Receive-путь ETCP (где искать потерю)
+
+```
+decrypt (etcp_connections.c:2262, лог "decrypt: code=.. dlen=..")
+  → if (link_state==CONNECTED) etcp_conn_input(pkt)
+    else memory_pool_free(pkt)      ← добавлен WARN "decrypted pkt DROPPED"
+  → etcp_conn_input (etcp.c:1506, "RX pkt dlen=%d")
+  → нормализатор (reassembly) → int_queue
+  → etcp_int_recv (etcp_api.c)       ← добавлен WARN "int_recv BGP id=0x01 len=.."
+  → dispatch по route id (0x01) → topo_group_receive_cbk (topo_group.c:193 "BGP recv NODEINFO")
+```
+
+## Уже добавленный дебаг (для локализации)
+
+1. `src/transport_layer/etcp_connections.c` (после дешифровки):
+   ```c
+   } else {
+       DEBUG_WARN(DEBUG_CATEGORY_ETCP, "[%s] decrypted pkt DROPPED: link_state=%d code=0x%02x dlen=%u",
+                  link->etcp->log_name, link->link_state, pkt_code, pkt->data_len);
+       memory_pool_free(e_sock->instance->pkt_pool, pkt);
+   }
+   ```
+2. `src/transport_layer/etcp_api.c` (`etcp_int_recv`, после чтения `id`):
+   ```c
+   uint8_t id = e->dgram[0];
+   if (id == 0x01) DEBUG_WARN(DEBUG_CATEGORY_ETCP, "int_recv BGP id=0x01 conn=%s len=%zu", conn->log_name, e->len);
+   ```
+3. Android: `tools/chatgui-android/libutun_lite/instance_lite.c` добавлено
+   `debug_set_category_level(DEBUG_CATEGORY_BGP, DEBUG_LEVEL_DEBUG);` (пересобрать APK: `cd tools/chatgui-android && ./build.sh`).
+4. chatgui конфиг `tools/chatgui/build/vibechat.cfg` — включены `bgp=debug`, `chat_sync=debug`, `member_sync=debug`, `debug=debug`.
+
+Как читать (по таймстампу флапа):
+- есть `decrypt code=01 dlen=..` + `DROPPED` → потеря в проверке `link_state==CONNECTED`;
+- есть `decrypt` + нет `DROPPED` + нет `int_recv BGP` → потеря в `etcp_conn_input`/нормализаторе;
+- есть `int_recv BGP` + нет `BGP recv NODEINFO` → потеря в BGP-обработчике.
+
+## Задача для агента
+
+1. Пересобрать chatgui (`cd tools/chatgui && cmake --build build -j4`) и Android APK (`cd tools/chatgui-android && ./build.sh`).
+2. Запустить chatgui (DISPLAY=:0, `./vibechat`), воспроизвести флап реконнекта:
+   ```bash
+   adb shell am force-stop com.utun.chat && adb shell am start -n com.utun.chat/.MainActivity
+   ```
+   (повторить несколько раз; флап ловится не каждый раз).
+3. В логах (`tools/chatgui/build/chatgui.log`) найти потерю NODEINFO и **точно определить точку** по таблице выше.
+4. Починить первопричину (варианты):
+   - буферизовать расшифрованный пакет до `LINK_STATE_CONNECTED` вместо `memory_pool_free`;
+   - либо гарантированный BGP-retry (после conn UP, если узел пира не в `group->nodes` через N мс — повторно `topo_group_send_table_request`).
+5. Убрать весь диагностический мусор:
+   - WARN "DROPPED" (etcp_connections.c), WARN "int_recv BGP" (etcp_api.c);
+   - DEBUG-логи в `chat_member.c` (`on_member_props_changed`), `chat_sync.c` (`cs_on_peer_status_changed`), `memberlistmodel.cpp`;
+   - `instance_lite.c` BGP-debug;
+   - `vibechat.cfg` — вернуть категории в закомментированное состояние.
+6. Прогнать: connect→online, disconnect→offline, реконнект (флап)→online. `./check.sh` (или `cd src && make -j4`).
+
+## Воспроизведение / ключевые артефакты
+
+- Пир: Android SM-A525F (`com.utun.chat`), node_id `0x1657b3ea8281c0a8`.
+- Локальный: chatgui (`tools/chatgui/build/vibechat`), node_id `0x24cd036a6e659b9a`.
+- Канал: `ch_id=7206723622466219923`, `group_id=0x64036cf3a783ef93`.
+- Лог chatgui: `tools/chatgui/build/chatgui.log` (debug_file из конфига).
+- Лог Android: `adb logcat -d | grep -iE "send_nodeinfo|NOT in registry|NODEINFO|DROPPED|int_recv"`.
@@ -0,0 +1,54 @@
+# Сборка uTun под OpenWRT
+
+## Быстрый старт
+
+```bash
+cd ~/utun2
+./build_openwrt.sh                     # ASUS RT-AX53U (по умолчанию)
+```
+
+Первый запуск соберёт toolchain (30-120 минут), последующие — только пакет.
+
+## Другие платформы
+
+```bash
+./build_openwrt.sh ramips/mt7621 asus_rt-ax54       # ASUS RT-AX54
+./build_openwrt.sh ramips/mt7621 xiaomi_mi-router-4a-gigabit
+./build_openwrt.sh ath79/generic tplink_archer-c7-v2
+./build_openwrt.sh x86/64                            # x86_64 PC
+./build_openwrt.sh --list                            # список целей
+```
+
+## Ручная сборка (menuconfig)
+
+```bash
+cd /home/user/openwrt
+make menuconfig          # Target System → MediaTek Ralink MIPS
+                         # Subtarget → MT7621 based boards
+                         # Target Profile → ASUS RT-AX53U
+                         # Network → utun (M)
+make -j$(nproc)          # полная сборка прошивки
+# или только пакет:
+make package/utun2/compile -j$(nproc) V=s
+```
+
+Пакет: `bin/packages/*/base/utun_*.ipk`
+
+## Структура
+
+- `~/openwrt/package/utun2/Makefile` — OpenWRT-пакет
+- `~/openwrt/` — клон buildroot (main, https://github.com/openwrt/openwrt)
+- `~/utun2/build_openwrt.sh` — скрипт сборки
+
+## Зависимости (host)
+
+```bash
+apt-get install -y build-essential git subversion libncurses-dev \
+    libssl-dev ccache xsltproc gawk gettext unzip python3 libtool
+```
+
+## Примечания
+
+- `configure` генерируется через `autoreconf -fi` (уже сделан)
+- Пакет использует `USE_SOURCE_DIR` — билд из /home/user/utun2 напрямую
+- Для чистой пересборки: `make package/utun2/clean && make package/utun2/compile -j$(nproc)`
@@ -1,6 +1,8 @@
 # Main Makefile.am for utun - root directory configuration

-# This is the root Makefile.am - tests are defined in tests/Makefile.am
+# Order matters: lib -> src -> tests (tests depend on src objects)
+SUBDIRS = lib lib/libopus src tests

-# Basic configuration for root directory
-SUBDIRS = lib src tests
+# Clean build directory
+clean-local:
+	-rm -rf build/
@@ -1,171 +0,0 @@
-CC := gcc
-CFLAGS := -Os -std=c99 -Wall -Wextra -D_ISOC99_SOURCE -DENABLE_TESTS -DETCP_DEBUG -DETCP_DEBUG_EXT
-SRC_DIR := src
-TEST_DIR := tests
-INCLUDES := -I$(SRC_DIR) -Iu_async -Itinycrypt/lib/include/ -Itinycrypt/lib/source/ -Itinycrypt/tests/include/ -I.
-
-# Директории для объектных файлов
-OBJ_DIR := obj
-SRC_OBJ_DIR := $(OBJ_DIR)/src
-TEST_OBJ_DIR := $(OBJ_DIR)/tests
-
-# Исходники tinycrypt
-TINYCRYPT_SRCS := \
-	tinycrypt/lib/source/ecc.c \
-	tinycrypt/lib/source/ecc_dh.c \
-	tinycrypt/lib/source/ecc_platform_specific.c \
-	tinycrypt/lib/source/aes_encrypt.c \
-	tinycrypt/lib/source/aes_decrypt.c \
-	tinycrypt/lib/source/utils.c \
-	tinycrypt/lib/source/ctr_mode.c \
-	tinycrypt/lib/source/ccm_mode.c
-
-# Исходники u_async
-UASYNC_SRCS := \
-	u_async/u_async.c \
-	u_async/timeout_heap.c \
-	u_async/debug_config.c
-
-# Объектные файлы tinycrypt (остаются в своих директориях)
-TINYCRYPT_OBJS := $(TINYCRYPT_SRCS:.c=.o)
-
-# Основные объектные файлы (будут в obj/src/)
-SC_LIB_OBJS := $(SRC_OBJ_DIR)/secure_channel.o $(SRC_OBJ_DIR)/crc32.o
-UASYNC_OBJS := $(SRC_OBJ_DIR)/u_async.o $(SRC_OBJ_DIR)/timeout_heap.o $(OBJ_DIR)/u_async/debug_config.o
-PN_OBJS := $(SRC_OBJ_DIR)/pkt_normalizer.o
-LL_QUEUE_OBJS := $(SRC_OBJ_DIR)/ll_queue.o
-ETCP_OBJS := $(SRC_OBJ_DIR)/etcp.o $(SRC_OBJ_DIR)/etcp_connections.o $(SRC_OBJ_DIR)/crc32.o
-CONFIG_PARSER_OBJS := $(SRC_OBJ_DIR)/config_parser.o
-TUN_IF_OBJS := $(SRC_OBJ_DIR)/tun_if.o
-ROUTING_OBJS := $(SRC_OBJ_DIR)/routing.o
-CONTROL_SOCKET_OBJS := # REMOVED - control_socket removed
-UTUN_OBJS := $(SRC_OBJ_DIR)/utun.o $(SRC_OBJ_DIR)/utun_instance.o $(SRC_OBJ_DIR)/utun_fixes.o $(SRC_OBJ_DIR)/utun_route_fix.o
-
-# Тестовые объектные файлы (будут в obj/tests/)
-TEST_PKT_NORMALIZER_OBJS := $(TEST_OBJ_DIR)/test_pkt_normalizer.o
-TEST_ETCP_OBJS := $(TEST_OBJ_DIR)/test_etcp.o
-TEST_ETCP_STRESS_OBJS := $(TEST_OBJ_DIR)/test_etcp_stress.o
-TEST_ETCP_SIMPLE_OBJS := $(TEST_OBJ_DIR)/test_etcp_simple.o
-TEST_U_ASYNC_COMPREHENSIVE_OBJS := $(TEST_OBJ_DIR)/test_u_async_comprehensive.o
-TEST_U_ASYNC_SIMPLE_OBJS := $(TEST_OBJ_DIR)/test_u_async_simple.o
-TEST_U_ASYNC_PERFORMANCE_OBJS := $(TEST_OBJ_DIR)/test_u_async_performance.o
-TEST_DEBUG_CONFIG_OBJS := $(TEST_OBJ_DIR)/test_debug_config.o
-TEST_LL_QUEUE_COMPREHENSIVE_OBJS := $(TEST_OBJ_DIR)/test_ll_queue_comprehensive.o
-SIMPLE_UASYNC_OBJS := $(TEST_OBJ_DIR)/simple_uasync.o
-TEST_ECC_ENCRYPT_OBJS := $(TEST_OBJ_DIR)/test_ecc_encrypt.o
-TEST_ROUTING_OBJS := $(TEST_OBJ_DIR)/test_routing.o
-
-# Основная цель
-all: utun \
-	$(TEST_DIR)/test_pkt_normalizer \
-	$(TEST_DIR)/test_etcp \
-	$(TEST_DIR)/test_etcp_stress \
-	$(TEST_DIR)/test_etcp_simple \
-	$(TEST_DIR)/test_u_async_comprehensive \
-	$(TEST_DIR)/test_u_async_simple \
-	$(TEST_DIR)/test_u_async_performance \
-	$(TEST_DIR)/test_debug_config \
-	$(TEST_DIR)/test_ll_queue_comprehensive \
-	$(TEST_DIR)/test_ecc_encrypt \
-	$(TEST_DIR)/test_routing
-
-# Создание директорий
-$(OBJ_DIR):
-	mkdir -p $(OBJ_DIR)
-	mkdir -p $(OBJ_DIR)/src
-	mkdir -p $(OBJ_DIR)/tests
-	mkdir -p $(OBJ_DIR)/u_async
-
-$(SRC_OBJ_DIR): $(OBJ_DIR)
-	mkdir -p $(SRC_OBJ_DIR)
-
-$(TEST_OBJ_DIR): $(OBJ_DIR)
-	mkdir -p $(TEST_OBJ_DIR)
-
-# Правило компиляции для исходников из src/
-$(SRC_OBJ_DIR)/%.o: $(SRC_DIR)/%.c | $(SRC_OBJ_DIR)
-	$(CC) $(CFLAGS) $(INCLUDES) -c $< -o $@
-
-# Правило компиляции для тестовых .c файлов
-$(TEST_OBJ_DIR)/%.o: $(TEST_DIR)/%.c | $(TEST_OBJ_DIR)
-	$(CC) $(CFLAGS) $(INCLUDES) -c $< -o $@
-
-# Правило компиляции для tinycrypt (оставляем в оригинальных директориях)
-tinycrypt/lib/source/%.o: tinycrypt/lib/source/%.c
-	$(CC) $(CFLAGS) $(INCLUDES) -c $< -o $@
-
-# Правило компиляции для u_async файлов
-$(SRC_OBJ_DIR)/u_async.o: u_async/u_async.c | $(SRC_OBJ_DIR)
-	$(CC) $(CFLAGS) $(INCLUDES) -c $< -o $@
-
-$(SRC_OBJ_DIR)/timeout_heap.o: u_async/timeout_heap.c | $(SRC_OBJ_DIR)
-	$(CC) $(CFLAGS) $(INCLUDES) -c $< -o $@
-
-$(OBJ_DIR)/u_async/debug_config.o: u_async/debug_config.c | $(OBJ_DIR)
-	$(CC) $(CFLAGS) $(INCLUDES) -c $< -o $@
-
-# Правила линковки
-utun: $(UTUN_OBJS) $(CONFIG_PARSER_OBJS) $(TUN_IF_OBJS) $(ROUTING_OBJS) $(CONTROL_SOCKET_OBJS) $(ETCP_OBJS) $(PN_OBJS) $(LL_QUEUE_OBJS) $(UASYNC_OBJS) $(SC_LIB_OBJS) $(TINYCRYPT_OBJS)
-	$(CC) $(CFLAGS) $(INCLUDES) -o $@ $^
-
-$(TEST_DIR)/test_pkt_normalizer: $(TEST_PKT_NORMALIZER_OBJS) $(PN_OBJS) $(LL_QUEUE_OBJS) $(UASYNC_OBJS)
-	$(CC) $(CFLAGS) $(INCLUDES) -o $@ $^
-
-$(TEST_DIR)/test_etcp: $(TEST_ETCP_OBJS) $(ETCP_OBJS) $(LL_QUEUE_OBJS) $(UASYNC_OBJS)
-	$(CC) $(CFLAGS) $(INCLUDES) -o $@ $^
-
-$(TEST_DIR)/test_etcp_stress: $(TEST_ETCP_STRESS_OBJS) $(ETCP_OBJS) $(LL_QUEUE_OBJS) $(SIMPLE_UASYNC_OBJS)
-	$(CC) $(CFLAGS) $(INCLUDES) -o $@ $^
-
-$(TEST_DIR)/test_etcp_simple: $(TEST_ETCP_SIMPLE_OBJS) $(ETCP_OBJS) $(LL_QUEUE_OBJS) $(SIMPLE_UASYNC_OBJS)
-	$(CC) $(CFLAGS) $(INCLUDES) -o $@ $^
-
-	$(CC) $(CFLAGS) $(INCLUDES) -o $@ $^
-
-	$(CC) $(CFLAGS) $(INCLUDES) -o $@ $^
-
-	$(CC) $(CFLAGS) $(INCLUDES) -o $@ $^
-
-	$(CC) $(CFLAGS) $(INCLUDES) -o $@ $^
-
-	$(CC) $(CFLAGS) $(INCLUDES) -o $@ $^
-
-$(TEST_DIR)/test_u_async_comprehensive: $(TEST_U_ASYNC_COMPREHENSIVE_OBJS) $(UASYNC_OBJS) $(SC_LIB_OBJS) $(TINYCRYPT_OBJS)
-	$(CC) $(CFLAGS) $(INCLUDES) -o $@ $^
-
-$(TEST_DIR)/test_u_async_simple: $(TEST_U_ASYNC_SIMPLE_OBJS) $(UASYNC_OBJS) $(SC_LIB_OBJS) $(TINYCRYPT_OBJS)
-	$(CC) $(CFLAGS) $(INCLUDES) -o $@ $^
-
-$(TEST_DIR)/test_u_async_performance: $(TEST_U_ASYNC_PERFORMANCE_OBJS) $(UASYNC_OBJS) $(SC_LIB_OBJS) $(TINYCRYPT_OBJS)
-	$(CC) $(CFLAGS) $(INCLUDES) -o $@ $^
-
-$(TEST_DIR)/test_debug_config: $(TEST_DEBUG_CONFIG_OBJS) $(OBJ_DIR)/u_async/debug_config.o
-	$(CC) $(CFLAGS) $(INCLUDES) -o $@ $^
-
-$(TEST_DIR)/test_ll_queue_comprehensive: $(TEST_LL_QUEUE_COMPREHENSIVE_OBJS) $(LL_QUEUE_OBJS) $(UASYNC_OBJS) $(SC_LIB_OBJS) $(TINYCRYPT_OBJS)
-	$(CC) $(CFLAGS) $(INCLUDES) -o $@ $^
-
-$(TEST_DIR)/test_ecc_encrypt: $(TEST_ECC_ENCRYPT_OBJS) $(SC_LIB_OBJS) $(UASYNC_OBJS) $(TINYCRYPT_OBJS)
-	$(CC) $(CFLAGS) $(INCLUDES) -o $@ $^
-
-$(TEST_DIR)/test_routing: $(TEST_ROUTING_OBJS) $(CONFIG_PARSER_OBJS) $(ROUTING_OBJS) $(UASYNC_OBJS)
-	$(CC) $(CFLAGS) $(INCLUDES) -o $@ $^
-
-# Очистка
-clean:
-	rm -rf $(OBJ_DIR)
-	rm -f utun \
-		$(TEST_DIR)/test_pkt_normalizer \
-		$(TEST_DIR)/test_etcp \
-		$(TEST_DIR)/test_etcp_stress \
-		$(TEST_DIR)/test_etcp_simple \
-		$(TEST_DIR)/test_u_async_comprehensive \
-		$(TEST_DIR)/test_u_async_simple \
-		$(TEST_DIR)/test_u_async_performance \
-		$(TEST_DIR)/test_debug_config \
-		$(TEST_DIR)/test_ll_queue_comprehensive \
-		$(TEST_DIR)/test_ecc_encrypt \
-		$(TEST_DIR)/test_routing
-	rm -f *.o $(TEST_DIR)/*.o tinycrypt/lib/source/*.o
-
-.PHONY: all clean
@@ -0,0 +1,147 @@
+# План: эпоха (reset_id) для ETCP Router
+
+Аналог фикса `reset_id` из ETCP (см. `61c572c`), применённый к сервисному слою
+маршрутизации `etcp_router` (src/routing_layer/etcp_router.c).
+
+## 1. Контекст
+
+`etcp_router` — «упрощённый TCP поверх ETCP»: своя seq-нумерация (`tx_seq`/`rx_seq`),
+reorder (`recv_q`), inflight-контроль (`inflight_q`), ретрансмиты, START/RST handshake.
+
+Текущий механизм детекции рестарта пира:
+
+- `SVC_ROUTE_HDR.flags & ROUTER_FLAG_START` — флаг на первом data-пакете сеанса
+  (`seq==0 && !start_sent && pl_len>0`, `etcp_router.c:207`).
+- `router_check_peer_restart` (`etcp_router.c:1055`) — если пришёл START на уже
+  синхронизированное соединение (`peer_sync_done==1`), то это рестарт пира;
+  **дедуп ретрансмитов** — побайтовое сравнение с `last_start_dgram`
+  (`etcp_router.c:1063`). Совпало → это ретрансмит (не рестарт). Не совпало →
+  `etcp_router_conn_restart` (полный сброс + `sess_id++`).
+- `ROUTER_FLAG_RST` + `router_restart_send` (`etcp_router.c:285`) — сброс только
+  TX-стороны; повторные RST гасятся через `send_restart_pending`.
+- `sess_id` (`etcp_router.h:121`) — **локальный счётчик переустановок, на wire
+  не пишется**. Используется только в `DEBUG_INFO`.
+
+## 2. Проблема (аналог ETCP seq-коллизии)
+
+Дедуп рестарта строится на **побайтовой идентичности** `last_start_dgram`. Это тот
+же класс хрупкости, что убрали в ETCP:
+
+1. **Байт-идентичный START** может быть и ретрансмитом, и (теоретически) новым
+   сеансом — если у нового START совпали `seq==0`, `svc_id`, `timestamp` (16-битные
+   часы 0.1ms заворачиваются каждые ~6.5 сек) и payload. Тогда рестарт **не
+   детектится**.
+2. Если рестарт не распознан: у пира `tx_seq` ушёл в 0, а у нас `rx_seq` остался
+   «высоким». В `router_handle_data_packet` (`etcp_router.c:1104`) ветка
+   `(rx_seq - seq) > 0` / `queue_find_data_by_index` считает пакеты новой сессии
+   **дубликатами** → молчаливый `c_dup_dropped` + пере-ACK (как `RX dup` в ETCP) →
+   потеря сервисных пакетов.
+3. `sess_id` не на wire → пир вообще не может отличить «мы перезапустились» от
+   «продолжаем сеанс» иначе как по байтам START.
+
+То есть нужен надёжный маркер **эпохи сеанса** на wire — аналог `reset_id`.
+
+## 3. Решение (аналог reset_id)
+
+Семантика та же, что в ETCP:
+
+- эпоха генерится **один раз** при создании `ETCP_ROUTER_CONN`;
+- меняется **только** при (фатальном) рестарте соединения;
+- при приёме START/RST с **другой** эпохой → рестарт (adopt);
+- **первая** увиденная эпоха принимается без рестарта (свежие при создании);
+- дедуп ретрансмитов START — по эпохе, а не по байтам.
+
+Два варианта источника эпохи:
+
+- **(A) Перенести `sess_id` на wire** — он уже есть как `uint32` счётчик
+  (0 при создании, `++` при рестарте). Минимально инвазивно.
+- **(B) Новый `reset_id` (uint64, случайный)** — симметрично ETCP; случайный
+  надёжнее счётчика (нет wrap-around и предсказуемости), но чуть больше поле.
+
+Рекомендация — **(A)** как минимальный шаг (поле уже есть), при желании апгрейд
+до (B).
+
+### Разрыв цикла (master/slave)
+
+Как и в ETCP, симметричное «увидел другую эпоху → рестарт» зацикливается при
+одновременном рестарте обеих сторон (A++ → B++ → A видит B → A++ → …).
+
+Ти-брейкер по `node_id` (как в ETCP):
+
+- на приёме START/RST с чужой эпохой:
+  - **master** (меньший `node_id`) — держит свою эпоху, шлёт RST пиру;
+  - **slave** (больший `node_id`) — принимает эпоху пира и рестартится.
+
+Существующие предохранители (`send_restart_pending`, `router_check_peer_restart`
+на стороне master) сохраняются.
+
+## 4. Wire-формат
+
+`SVC_ROUTE_HDR` (`etcp_router.h:26`) сейчас 33 байта:
+
+```
+cmd(1) group_id(8) dst(8) src(8) seq(4) svc_id(1) flags(1) timestamp(2)
+```
+
+Добавить поле эпохи (только START/RST, в обычных data/ACK — 0):
+
+- вариант (A): `uint32_t sess_id` → заголовок 33→37 байт (упакован);
+- вариант (B): `uint8_t reset_id[8]` → 33→41 байт.
+
+Заполняется в `router_build_packet` (START) и `router_send_rst`; читается в
+`router_check_peer_restart` / обработчике RST.
+
+## 5. Шаги реализации
+
+Файлы: `src/routing_layer/etcp_router.h`, `src/routing_layer/etcp_router.c`,
+(опц.) `tests/`.
+
+1. **Поле в заголовке**: добавить `sess_id`/`reset_id` в `struct SVC_ROUTE_HDR`;
+   обновить `SVC_ROUTE_HDR_SIZE`.
+2. **Локальное состояние** (`struct ETCP_ROUTER_CONN`):
+   - `uint32_t sess_id` (уже есть) — оставить как «моя эпоха»;
+   - добавить `uint32_t peer_sess_id` — последняя увиденная эпоха пира.
+   - `router_conn_reset` (`etcp_router.c:380`) НЕ сбрасывает `sess_id`
+     (комментарий на :379 уже это гарантирует).
+3. **Запись эпохи**:
+   - `router_build_packet` (`:193`) — при `ROUTER_FLAG_START` писать `sess_id`;
+   - `router_send_rst` (`:251`) — писать `sess_id`.
+4. **Детект рестарта по эпохе** — переписать `router_check_peer_restart` (`:1055`):
+   - если `peer_sess_id==0` → первая эпоха, принять без рестарта (сохранить);
+   - если `hdr->sess_id == peer_sess_id` → ретрансмит (не рестарт);
+   - если отличается → master/slave: slave → `etcp_router_conn_restart` + adopt;
+     master → держать свою, при необходимости RST.
+   - `last_start_dgram`-байт-дедуп заменить на это сравнение (поле можно удалить).
+5. **RST-обработчик** (`:1151`) — при RST также сверять `sess_id` (дедуп RST по
+   эпохе вместо/в дополнение к `send_restart_pending`).
+6. **Инициализация** — `peer_sess_id = 0` в `router_conn_reset`/`etcp_router_conn_get`.
+
+## 6. Тест
+
+`tests/test_etcp_router_*` (существующие `test_etcp_router`, `test_etcp_router_reconnect`,
+`test_etcp_router_unit`) — прогнать после правки заголовка (37/41 байт).
+
+Добавить (по возможности) регрессию, аналогичную `test_etcp_seq_collision`:
+
+- два инстанса, роутер-коннект, отправка N пакетов;
+- принудительный рестарт одной стороны (смена эпохи);
+- assert: пакеты новой эпохи доставлены (не `c_dup_dropped`), обе стороны сходятся
+  к одной эпохе.
+
+## 7. Решения (зафиксировано)
+
+1. **Вариант (B)** — `uint64_t reset_id`, случайный (`random_bytes`). Причина: вариант (A)
+   `sess_id` стартует с 0 и конфликтует с сентинелом «эпоха не задана». На wire — native
+   order (как остальные uint64-поля заголовка, SVC_ROUTE не использует htobe*).
+2. **master/slave по node_id** — нужен: `etcp_router_conn_restart` делает полный
+   двунаправленный сброс, без ти-брейкера симметричный рестарт зациклится. master
+   (меньший node_id) держит эпоху и шлёт RST; slave принимает и ресетится.
+3. **route_crypto** — совместим: заголовок не шифруется (только payload), подписывается
+   только в SIGN-режиме; `SVC_ROUTE_HDR_SIZE = sizeof(...)` авто-адаптируется. START
+   идёт через `route_crypto_encode`, RST/ACK/CLOSE — plain header-only.
+
+## 8. Статус
+
+Реализовано и проверено: `etcp_router.h/.c` + `tests/test_etcp_router_unit.c`.
+Сборка `make clean && make` без ошибок; `./check.sh` → 74 passed / 0 failed / 1 skipped;
+`test_etcp_router_unit` 34/34, `test_etcp_router` и `test_etcp_router_reconnect` — PASS.
@@ -1,37 +0,0 @@
-# High Priority Tasks
-
-## Task 1: Convert to autoconf/automake (NEW)
- Create configure.ac
- Create Makefile.am for main project
- Create Makefile.am for tests/
- Add autogen.sh script
- Remove hardcoded Makefile
- Update build documentation
-
-## Task 2: Complete typedef struct refactoring (24/28 done)
- config_parser.h: 7 typedef struct
- etcp_sockets.h: 3 typedef struct (including conn_handle - delete)
- etcp_connections.h: 3 typedef struct
- etcp.h: 2 typedef struct
- ll_queue.h: 4 typedef struct (u_async lib)
- pkt_normalizer.h: 2 typedef struct
- secure_channel.h: 1 typedef struct
- tun_if.h: 1 typedef struct
- utun_instance.h: 1 typedef struct
-
-## Task 3: Cleanup legacy tests
- Remove test_connection*.c
- Remove test_sc_lib.c
- Update Makefile to remove old test targets
- Replace epkt_t* with etcp_t*
- Replace conn_handle_t* with etcp_socket_t*
-
-## Task 4: Replace fprintf with debug system
- utun.c: 27 fprintf
- etcp_connections.c: ~15 fprintf
- config_parser.c: 10+ fprintf
- Other files: ~20 fprintf
-
-## Task 5: Update AGENTS.md after completion
- Document build process changes
- Update style guide if needed
@@ -0,0 +1,784 @@
+# uTun — Руководство пользователя
+
+uTun — децентрализованная VPN-система с шифрованием, надёжной доставкой данных, поддержкой mesh-сетей и встроенным TCP-прокси. Работает поверх UDP (основной транспорт) и TCP (STCP-резерв). Всё шифруется через X25519 + AES-128-CCM. Топология узлов обменивается автоматически (BGP-подобный протокол).
+
+---
+
+## 1. Быстрый старт
+
+### 1.1. Сборка
+
+```bash
+git clone <репозиторий> && cd utun3
+./build.sh --full -j4        # autoreconf + configure + make
+```
+
+Зависимости: `gcc`, `make`, `autotools` (autoconf/automake/libtool), `OpenSSL` (libssl-dev).
+
+### 1.2. Генерация ключей
+
+Ключи генерируются автоматически, если их нет в конфиге. Достаточно указать `my_node_name` — `config_updater` создаст пару X25519 и node_id:
+
+```ini
+[global]
+my_node_name=my-first-node
+```
+
+После первого запуска ключи пропишутся в конфиг автоматически.
+
+### 1.3. Первый запуск
+
+```bash
+sudo ./src/utun -f -c myconfig.conf
+```
+
+- `-f` — foreground (без демонизации, видно логи в консоли)
+- `-c myconfig.conf` — путь к конфигу
+- `-p /var/run/utun.pid` — PID-файл
+- `-l /var/log/utun.log` — лог-файл
+
+Без `-f` процесс уходит в демон (`fork` + `setsid`).
+
+### 1.4. Проверка работы
+
+```bash
+ip addr show tun3                  # TUN-интерфейс создан?
+ping 10.23.1.1                     # пингуем TUN-IP узла
+ss -uln | grep 1333                # UDP-сокет слушает?
+```
+
+---
+
+## 2. Архитектура (кратко)
+
+uTun — **однопоточная асинхронная** система. Один event loop (`epoll`/`poll`) на поток. Никаких `sleep()`, никакого блокирующего I/O.
+
+**Стек протоколов (5 уровней):**
+
+| Уровень | Назначение |
+|---------|------------|
+| 1. UDP/TUN/STCP | Физический транспорт: UDP-сокеты, TUN-интерфейс, TCP-резерв |
+| 2. secure_channel | X25519 ECDH + AES-128-CCM шифрование + Ed25519 подписи |
+| 3. ETCP | Надёжный транспорт (inflight, ACK, ретрансмиссии, BBR congestion control) |
+| 4. LoadBalancer | Multi-link балансировка (min inflight + round-robin) |
+| 5. etcp_router | Сервисная маршрутизация (seq, dedup, reorder, transit forwarding) |
+
+Два уровня надёжности:
+- **ETCP** — per-connection, RTT-based ретрансмиссии
+- **etcp_router** — per-service, 300ms ретрансмиссии с 17 попытками (~5 сек)
+
+Node identity: `SHA256(private_key)` → первые 8 байт → 63-bit `node_id`.
+
+---
+
+## 3. Конфигурация
+
+Формат: INI-style. Секции `[section]`, строки `key=value`, комментарии `#`.
+
+### 3.1. `[global]` — Идентичность и базовые настройки
+
+```ini
+[global]
+my_node_name=home-server                # имя узла (человекочитаемое)
+my_node_id=5f75c7445af88e1f             # ID узла (авто-генерируется)
+my_private_key=d065b784...4fe441        # X25519 приватный ключ (hex, 64 символа)
+my_public_key=86b51a8b...6a2d19         # X25519 публичный ключ (hex, 64 символа)
+
+tun_enabled=yes                         # создавать TUN-интерфейс (по умолчанию yes)
+tun_ifname=tun3                         # имя TUN (по умолчанию tun0)
+tun_ip=10.23.1.1                        # IP на TUN-интерфейсе
+mtu=1500                                # MTU для всех соединений
+
+debug_level=error                       # глобальный уровень отладки (none/error/warn/info/debug/trace)
+log_file=/var/log/utun.log             # путь к лог-файлу
+```
+
+### 3.2. `[server:NAME]` — Локальные UDP-сокеты
+
+```ini
+[server: lan1]
+addr=192.168.1.10:1333                 # IP:порт для приёма входящих
+type=public                             # public / nat / private / local
+transport=udp                           # udp (по умолчанию) или tcp (STCP)
+mtu=1400                                # MTU для этого канала
+so_mark=100                             # SO_MARK для policy routing
+netif=eth0                              # привязка к интерфейсу
+only_local=0                            # 1 = только локальные подключения
+```
+
+Типы адресов:
+- `public` — узел на публичном IP (прямая связь)
+- `nat` — узел за NAT (нужен NAT traversal)
+- `private` — локальная сеть (только соседи в том же сегменте)
+- `local` — только loopback/локальные подключения
+
+### 3.3. `[client:NAME]` — Подключение к удалённым узлам
+
+```ini
+[client: aeza]
+link=lan1:85.192.42.96:1333            # server_name:ip:port (можно несколько link=)
+link=lan1:85.192.42.96:1433            # второй канал к тому же узлу
+peer_public_key=0206dbee...fbcc16      # публичный ключ удалённого узла
+keepalive=1                             # интервал keepalive (сек)
+```
+
+Формат `link`: `локальный_сервер:удалённый_ip:удалённый_порт`. Серверная секция должна быть объявлена выше по файлу.
+
+### 3.4. `[routing]` — Маршруты
+
+```ini
+[routing]
+my_subnet=10.23.1.0/24                  # своя подсеть — анонсируется соседям через BGP
+route_subnet=10.23.0.0/16               # добавляется в системную таблицу маршрутов через TUN
+route_subnet=fd00:1234::/32             # IPv6-подсеть
+```
+
+### 3.5. `[debug]` — Настройка отладки
+
+Формат: `категория=уровень`. Уровни: `none`, `error`, `warn`, `info`, `debug`, `trace`.
+
+```ini
+[debug]
+etcp=trace                              # всё про ETCP
+crypto=info                             # криптографические операции
+bgp=info                                # обмен топологией
+connection=info                         # сокеты и линки
+general=info                            # общая информация
+```
+
+Основные категории (всего 26): `uasync`, `ll_queue`, `connection`, `etcp`, `crypto`, `memory`, `timing`, `config`, `tun`, `routing`, `timers`, `normalizer`, `bgp`, `socket`, `control`, `dump`, `traffic`, `debug`, `general`, `nat`, `keepalive`, `etcпroute`, `bbr`, `etcp_dump`.
+
+### 3.6. `[firewall]` — Правила фильтрации
+
+```ini
+[firewall]
+allow=all                               # разрешить всё (bypass)
+allow=192.168.1.0/24                    # разрешить подсеть
+allow=10.0.0.1:80                       # разрешить конкретный IP:порт
+```
+
+### 3.7. `[nat]` — EIM NAT
+
+```ini
+[nat]
+nat_enabled=yes
+nat_tun_ifname=tun_external             # внешний TUN (выход в интернет)
+nat_via=gateway_ip                      # шлюз
+port_start=10000
+port_end=20000
+forward=tcp:10.0.0.5:80:8080           # проброс: протокол:ip:внутр_порт:внеш_порт
+```
+
+### 3.8. `[tcp_proxy_client]` / `[tcp_proxy_server]` — TCP-прокси
+
+**Клиент (выход через exit-узел):**
+
+```ini
+[tcp_proxy_client]
+enabled=yes
+tun_name=tun_proxy                      # имя TUN для прокси-трафика
+tun_ip=10.200.30.1                      # IP клиентского TUN
+via_node=50e9e88658e91977               # node_id exit-узла
+
+socks_enabled=yes                       # встроенный SOCKS5-прокси
+socks_addr=127.0.0.1:1082               # слушать SOCKS5 здесь
+
+http_proxy_enabled=yes                  # встроенный HTTP CONNECT-прокси
+http_proxy_addr=127.0.0.1:8080
+```
+
+**Exit-узел (сервер):**
+
+```ini
+[tcp_proxy_server]
+enabled=yes
+```
+
+Клиент настраивает браузер на SOCKS5 `127.0.0.1:1082` — весь TCP-трафик идёт через exit-узел.
+
+### 3.9. `[control]` — Сервер мониторинга
+
+```ini
+[control]
+control_ip=192.168.29.117               # IP для приёма подключений etcpmon
+control_port=9090
+control_allow=192.168.0.0/16            # разрешённые подсети (можно несколько)
+```
+
+### 3.10. `[allowed_keys]` — Ограничение подключений
+
+```ini
+[allowed_keys]
+allow_all=1                             # разрешить все ключи
+# key=86b51a8b...6a2d19                # разрешить конкретный pubkey
+```
+
+### 3.11. `[ntp]` — Синхронизация времени
+
+```ini
+[ntp]
+enabled=yes
+server=pool.ntp.org
+server=time.google.com
+interval=3600                           # интервал синхронизации (сек)
+```
+
+### 3.12. `[network:NAME]` — Именованные сети
+
+```ini
+[network: mynet]
+id=5f75c7445af88e1f                     # 56-bit ID сети
+pubkey=86b51a8b...6a2d19                # публичный ключ сети
+signing_key=d065b784...4fe441           # ключ подписи (Ed25519)
+```
+
+### 3.13. Серверный vs клиентский конфиг
+
+| Параметр | Сервер | Клиент |
+|----------|--------|--------|
+| `[server]` секция | Обязательна (свои сокеты) | Обязательна (свои сокеты) |
+| `[client]` секция | Нет | Обязательна (к кому подключаться) |
+| `peer_public_key` | Нет | Обязателен в `[client]` |
+| `my_private_key` | Свой | Свой |
+| `my_public_key` | Свой | Свой |
+
+Важно: `[server]` обязателен в **обоих** случаях — это рабочий сокет узла. Клиент дополнительно указывает `[client]` с `peer_public_key` и `link`.
+
+---
+
+## 4. Сценарии использования
+
+### 4.1. VPN между двумя узлами
+
+**Сервер** (публичный IP `85.192.42.96`):
+
+```ini
+[global]
+my_node_name=server
+my_private_key=<hex>
+my_public_key=<hex>
+tun_ip=10.23.1.1
+
+[server: main]
+addr=85.192.42.96:1333
+type=public
+
+[routing]
+my_subnet=10.23.1.0/24
+```
+
+**Клиент** (за NAT, подключается к серверу):
+
+```ini
+[global]
+my_node_name=client
+my_private_key=<hex>
+my_public_key=<hex>
+tun_ip=10.23.2.1
+
+[server: uplink]
+addr=0.0.0.0:1333                       # можно 0.0.0.0 — клиенту не нужен фиксированный порт
+type=nat
+
+[client: server]
+link=uplink:85.192.42.96:1333
+peer_public_key=<pubkey_сервера>
+keepalive=1
+
+[routing]
+my_subnet=10.23.2.0/24
+```
+
+**Проверка связности:**
+
+```bash
+# На сервере
+ping 10.23.2.1
+
+# На клиенте
+ping 10.23.1.1
+```
+
+### 4.2. Mesh-сеть из нескольких узлов
+
+Каждый узел = сервер (свои сокеты) + клиент (подключения к соседям). Пример для узла B, который подключается к A и C:
+
+```ini
+[global]
+my_node_name=node-b
+my_private_key=<hex>
+my_public_key=<hex>
+tun_ip=10.23.2.1
+
+[server: main]
+addr=0.0.0.0:1333
+type=public
+
+[client: node-a]
+link=main:85.192.42.96:1333
+peer_public_key=<pubkey_A>
+
+[client: node-c]
+link=main:203.0.113.10:1333
+peer_public_key=<pubkey_C>
+
+[routing]
+my_subnet=10.23.2.0/24
+```
+
+Что происходит автоматически:
+1. B устанавливает ETCP-соединения с A и C
+2. Через BGP A узнаёт о подсетях C (и наоборот)
+3. Узел A может отправлять пакеты к подсети C через B (transit forwarding)
+4. `etcp_router` обеспечивает надёжную маршрутизацию через промежуточные узлы
+
+### 4.3. Exit-прокси (выход в интернет через удалённый узел)
+
+**Exit-узел** (с прямым выходом в интернет):
+
+```ini
+[global]
+my_node_name=exit-node
+my_private_key=<hex>
+my_public_key=<hex>
+
+[server: main]
+addr=85.192.42.96:1333
+type=public
+
+[tcp_proxy_server]
+enabled=yes
+```
+
+**Клиент** (выходит в интернет через exit-узел):
+
+```ini
+[global]
+my_node_name=client
+my_private_key=<hex>
+my_public_key=<hex>
+
+[server: main]
+addr=0.0.0.0:1333
+
+[client: exit]
+link=main:85.192.42.96:1333
+peer_public_key=<pubkey_exit>
+
+[tcp_proxy_client]
+enabled=yes
+tun_name=tun_proxy
+tun_ip=10.200.30.1
+via_node=<node_id_exit>
+socks_enabled=yes
+socks_addr=127.0.0.1:1082
+```
+
+Настройка браузера: SOCKS5 proxy `127.0.0.1:1082`. TCP-трафик идёт: браузер → SOCKS5 → lwIP → ETCP → exit-узел → интернет.
+
+### 4.4. EIM NAT (раздача интернета через NAT)
+
+```ini
+[nat]
+nat_enabled=yes
+nat_tun_ifname=eth0                     # внешний интерфейс
+port_start=20000
+port_end=30000
+forward=tcp:192.168.1.100:80:8080       # проброс порта 8080 → 192.168.1.100:80
+forward=udp:192.168.1.100:53:53         # проброс DNS
+```
+
+### 4.5. Чат (chatgui)
+
+Chatgui — десктопный GUI-чат (Qt 6) со встроенным uTun-узлом. Вся связь — напрямую между узлами (P2P), без центральных серверов.
+
+**Сборка:**
+
+```bash
+sudo apt install librlottie-dev zlib1g-dev qt6-base-dev
+cd tools/chatgui && mkdir -p build && cd build
+cmake .. && make -j4
+./chatgui
+```
+
+**Запуск:**
+
+```bash
+setsid env DISPLAY=:1.0 QT_ACCESSIBILITY=1 ./chatgui & disown
+```
+
+Chatgui работает в двух потоках:
+- **GUI-поток** — Qt, отрисовка, чтение из SQLite
+- **uasync-поток** — uTun-узел, сеть, криптография, ETCP, запись в SQLite
+
+**Основные возможности:**
+- Создание каналов и групп
+- Обмен сообщениями с анимированными эмодзи (TGS)
+- Invite-ссылки (`utun://...`) с QR-кодами
+- P2P синхронизация через Merkle-деревья
+- Авто-подключение к известным узлам из БД
+
+---
+
+## 5. Топология сети
+
+### 5.1. Типы адресов
+
+| Тип | Описание | Пример |
+|-----|----------|--------|
+| `INTERFACE` | Адрес на сетевом интерфейсе | `eth0: 192.168.1.10` |
+| `NAT` | Внешний адрес после NAT (детектируется) | `85.192.42.96:54321` |
+| `REAL` | Публичный адрес (совпадает interface == NAT) | `85.192.42.96:1333` |
+
+### 5.2. Как узлы находят друг друга
+
+1. **Прямое подключение** — через `[client]` секцию с явным IP:портом
+2. **BGP-обмен** — при подключении к одному узлу, узнаёшь о всех его соседях
+3. **Локальное сканирование** — `conn_mgr` периодически сканирует локальную сеть
+4. **Invite-ссылки** — `utun://` ссылки с закодированными адресами и ключами
+
+### 5.3. NAT traversal
+
+`conn_mgr` реализует трёхфазное подключение:
+
+1. **DIRECT** (5 сек) — прямое INIT-рукопожатие со всеми известными адресами
+2. **REVERSE** (15 сек) — если клиент за NAT, сервер с прямым IP: клиент шлёт свои адреса через BGP, сервер подключается сам
+3. **INDIRECT** (15 сек) — оба за NAT: выбираются общие кандидаты-посредники по min RTT, трафик идёт через `etcp_router`
+
+Типы NAT, которые определяет uTun:
+- **EIM** (Endpoint-Independent Mapping) — один внешний порт для всех назначений
+- **Strict** (Address/Restricted/Symmetric) — разные порты
+
+### 5.4. Группы
+
+Два типа групп:
+- **UTUN** (`group_id=0x8000000000000000`) — VPN-сеть: обмен подсетями, маршруты
+- **CHAT** — чат-группа: только узлы, без подсетей, персистентность в SQLite
+
+Узлы разных групп изолированы.
+
+---
+
+## 6. Мониторинг и отладка
+
+### 6.1. Уровни отладки
+
+```
+none < error < warn < info < debug < trace
+```
+
+Настройка через `-d` в CLI (имеет приоритет) или секцию `[debug]` в конфиге:
+
+```bash
+./src/utun -f -c myconfig.conf -d "etcp=trace,crypto=info"
+```
+
+Или эквивалент в конфиге:
+
+```ini
+[debug]
+etcp=trace
+crypto=info
+bgp=info
+```
+
+### 6.2. Категории отладки (26 шт)
+
+| Категория | Что логирует |
+|-----------|-------------|
+| `etcp` | Протокол ETCP: очереди, retrans, ACK, RTT |
+| `crypto` | Шифрование/дешифрование, ключи, nonce |
+| `connection` | Сокеты, линки, INIT handshake, keepalive |
+| `bgp` | Обмен топологией (NODEINFO, WITHDRAW) |
+| `routing` | Таблица маршрутов, поиск путей |
+| `tun` | TUN-интерфейс: чтение/запись |
+| `traffic` | Данные трафика |
+| `general` | Общая информация |
+| `bbr` | BBR congestion control |
+| `keepalive` | Адаптивный keepalive |
+| `memory` | Выделение/освобождение памяти |
+| `dump` | Hex-дампы пакетов |
+| `etcp_dump` | Декодирование ETCP-пакетов |
+
+### 6.3. etcpmon — Windows GUI монитор
+
+Подключается к `control_server` узла по TCP (порт из `control_port`). Показывает:
+- Список соединений и их состояние
+- RTT, потери, inflight
+- Графики метрик
+- Дамп пакетов
+
+### 6.4. control_server — TCP API
+
+```ini
+[control]
+control_ip=0.0.0.0
+control_port=9090
+control_allow=192.168.0.0/16
+```
+
+Любой TCP-клиент может подключиться и получать события в реальном времени (JSON-подобный формат).
+
+### 6.5. Логи и дампы
+
+Лог-файл указывается через `-l`:
+
+```bash
+./src/utun -f -c myconfig.conf -l /tmp/utun.log
+```
+
+Hex-дамп пакетов включается категорией `dump=trace`:
+
+```ini
+[debug]
+dump=trace
+```
+
+---
+
+## 7. NAT и Firewall
+
+### 7.1. Как uTun определяет тип NAT
+
+1. Клиент подключается к серверу
+2. Сервер видит внешний IP:порт клиента (из UDP-пакета)
+3. Сервер через **третий узел** (посредник) пингует клиента на этот внешний IP:порт
+4. Если клиент ответил — NAT EIM (один mapping для всех)
+5. Если нет — NAT Strict
+
+Результат сохраняется в `link->nat_type` и broadcast-ится всем соседям через BGP.
+
+### 7.2. Firewall
+
+```ini
+[firewall]
+allow=all                               # всё разрешено
+allow=10.0.0.0/8                        # разрешить подсеть
+allow=192.168.1.5:22                    # разрешить IP:порт
+```
+
+По умолчанию без секции `[firewall]` — фильтрация выключена.
+
+### 7.3. Проброс портов
+
+```ini
+[nat]
+forward=tcp:192.168.1.100:80:8080       # входящий порт 8080 → 192.168.1.100:80
+forward=udp:10.0.0.53:53:53             # DNS
+```
+
+---
+
+## 8. Устранение неполадок
+
+### 8.1. Нет связи — проверка INIT handshake
+
+Включите:
+
+```ini
+[debug]
+connection=debug
+crypto=debug
+```
+
+В логах ищите:
+- `INIT_REQUEST sent to ...` / `INIT_RESPONSE received from ...` — handshake
+- `session_ready=1` — ключи согласованы, шифрование работает
+- `ETCP_KEEPALIVE` — keepalive-пакеты идут
+- Если нет — проверьте firewall на портах, доступность IP
+
+### 8.2. Пакеты теряются — проверка метрик
+
+```bash
+# В логах с etcp=debug смотрите:
+grep "retrans" /tmp/utun.log            # ретрансмиссии
+grep "rtt=" /tmp/utun.log               # задержки
+grep "lost" /tmp/utun.log               # потери
+```
+
+Каждые 10 минут пишутся гистограммы метрик с RTT-бакетами и loss-бакетами.
+
+### 8.3. Высокая задержка — keepalive
+
+Адаптивный keepalive: период растёт от 200ms до 10s при отсутствии трафика, сбрасывается к 200ms при появлении. Таймаут = период × 10.
+
+Проверьте:
+
+```ini
+[debug]
+keepalive=debug
+```
+
+### 8.4. Утечки памяти — проверка пулов
+
+```ini
+[debug]
+memory=debug
+```
+
+При завершении `u_report_unfreed_blocks()` показывает все неосвобождённые блоки.
+
+### 8.5. Дамп состояния
+
+ETCP предоставляет функцию `etcp_dump_all_conns()` для вывода полного состояния всех соединений (очереди, inflight, счётчики). Включается через `etcp_dump=trace`.
+
+### 8.6. ASAN-сборка (поиск повреждений памяти)
+
+```bash
+./build.sh --asan -j4
+ASAN_OPTIONS=detect_leaks=0:halt_on_error=0 ./src/utun -f -c myconfig.conf
+```
+
+Краш-логи ASAN пишутся в `/tmp/utun_asan.<pid>`.
+
+---
+
+## 9. Производительность
+
+### 9.1. BBR congestion control
+
+BBR работает per-link. Основные настройки:
+
+```ini
+[global]
+bbr_max_cwnd=1048576                    # максимум окна перегрузки (1MB по умолчанию)
+```
+
+BBR автоматически измеряет пропускную способность через burst-измерения (12 пакетов пачкой, замер inter-packet gap). Периодичность burst — не чаще 500ms.
+
+### 9.2. Memory pools
+
+Три пула в `UTUN_INSTANCE`:
+- `data_pool` — данные пакетов (payload)
+- `pkt_pool` — `struct ETCP_DGRAM` (сетевые пакеты)
+- `ack_pool` — `struct ACK_PACKET` (подтверждения)
+
+Пулы аллоцируются upfront при старте. Статистику можно посмотреть через control_server.
+
+### 9.3. Multi-link балансировка
+
+LoadBalancer выбирает линк с минимальным inflight, с round-robin для равных. Traffic shaper ограничивает отправку до `optimal_inflight`:
+
+```
+timeout = (rtt_avg_10 * 32 + jitter * 32) / 16
+```
+
+Оптимальное окно: `optimal_inflight = sum(inflight_lim_bytes)`
+
+### 9.4. Keepalive
+
+Адаптивный режим:
+- Начальный период = `keepalive` из `[client]` (сек)
+- При трафике → сброс к начальному
+- Без трафика → растёт ×1.05 до 10 секунд
+- Таймаут = период × 10
+
+---
+
+## 10. CLI-справка
+
+```
+utun [опции]
+
+Опции:
+  -f            Foreground (без демонизации)
+  -c FILE       Конфигурационный файл (по умолчанию: utun.conf)
+  -p FILE       PID-файл (по умолчанию: /var/run/utun.pid)
+  -l FILE       Лог-файл (по умолчанию: utun.log)
+  -d CONFIG     Отладка: категория=уровень,... (переопределяет конфиг)
+  -h            Справка
+```
+
+**Сигналы:**
+- `SIGTERM` / `SIGINT` — graceful shutdown (закрытие соединений, освобождение ресурсов)
+- `SIGHUP` — reload конфига (селективный: меняются только изменённые сокеты/клиенты; полный — при изменении ключей или TUN)
+
+---
+
+## 11. Типовые конфигурации
+
+### Минимальный сервер
+
+```ini
+[global]
+my_node_name=server
+tun_ip=10.23.1.1
+
+[server: main]
+addr=0.0.0.0:1333
+```
+
+### Минимальный клиент
+
+```ini
+[global]
+my_node_name=client
+tun_ip=10.23.2.1
+
+[server: main]
+addr=0.0.0.0:1333
+
+[client: server]
+link=main:85.192.42.96:1333
+peer_public_key=<pubkey_сервера>
+```
+
+### Mesh-узел с несколькими пирами
+
+```ini
+[global]
+my_node_name=mesh-node-3
+tun_ip=10.23.3.1
+
+[server: main]
+addr=0.0.0.0:1333
+
+[client: node-1]
+link=main:10.0.0.1:1333
+peer_public_key=<pubkey_1>
+
+[client: node-2]
+link=main:10.0.0.2:1333
+peer_public_key=<pubkey_2>
+
+[routing]
+my_subnet=10.23.3.0/24
+```
+
+### Exit-узел с TCP-прокси
+
+```ini
+[global]
+my_node_name=exit-eu
+tun_ip=10.23.100.1
+
+[server: main]
+addr=85.192.42.96:1333
+type=public
+
+[tcp_proxy_server]
+enabled=yes
+
+[routing]
+my_subnet=10.23.100.0/24
+```
+
+### Клиент с SOCKS5-прокси
+
+```ini
+[global]
+my_node_name=home-laptop
+
+[server: main]
+addr=0.0.0.0:1333
+
+[client: exit]
+link=main:85.192.42.96:1333
+peer_public_key=<pubkey_exit>
+
+[tcp_proxy_client]
+enabled=yes
+socks_enabled=yes
+socks_addr=127.0.0.1:1082
+via_node=<node_id_exit>
+```
@@ -0,0 +1,25 @@
+Задача сделать полное архитектурное описание проекта.
+Как делаем
+
+1. определяем список проектов. продумываем последовательность разбора проектов - зависимости - что от чего зависит, что лучше разбирать в начале.
+
+Далее по каждому проекту:
+
+2. разбиваешь весь проект на логические модули.
+  поручаешь субагентам (параллельно запускаешь до 8 потоков), балансируй нагрузку на агентов (по объему кода): если модули короткие - можно 2-3 простых одному субагенту.
+   - проанализировать логику работы модуля
+   - понять как этим пользоваться с позиции пользователя (ты - архитектор и пользователь - типовой сценарий использования модуля с точки зрения удобства и лёгкости использования).
+     какие есть потенциальные проблемные места, можно ли пользоваться в многопоточной архитектуре, можно ли в асинхронной архитектуре, можно ли делать close из callback (если есть коллбэки и модулю асинхронный). какие есть еще нюансы и ограничения.
+   - создать (или обновить если есть) описание работы модуля - файл рядом с исходниками называется [module_name]_doc.md
+     описание должно быть с точки зрения пользователя - в первую очередь как пользоваться и какие нюансы. понятным языком (если используется терминология специфичная для модуля - то должна быть понятна или пояснения).
+     Схема описания:
+         1. назначение модуля, зачем нужен, что делает 
+         2. как пользоваться, лучше типовой сценарий (с нюансами если есть), 
+         3. кратко пояснения по апи и нюансы если есть
+
+   далее читаешь полностью все эти описания и формируешь итоговое описание проекта.
+   Продумай какая структура документации лучше подходит, разбей на главы.
+   И сделай общее описние проекта (user manual).
+
+твоя задача на основе сформированной документации разобраться как работает utun. ключевое слово =- хорошо. хорошо понять все модули, их взаимодействое, возможности, облести применимости и                                                       
+ограничения. понять архитектурно как работает проект собранный из этих модулей. и только после этого написать документацию. 
@@ -0,0 +1,31 @@
+@echo off
+echo uTun Build Script for MSYS2 UCRT64
+echo.
+
+pushd "%~dp0"
+
+
+rem export http_proxy="http://192.168.29.1:9999"
+rem export https_proxy="http://192.168.29.1:9999"
+
+
+REM Default MSYS2 path
+set MSYS2_PATH=C:\msys64
+
+REM Use environment variable if set
+if not "%MSYS2_ROOT%"=="" set MSYS2_PATH=%MSYS2_ROOT%
+if not "%MSYS2%"=="" set MSYS2_PATH=%MSYS2%
+
+REM Check if msys2_shell.cmd exists
+if not exist "%MSYS2_PATH%\msys2_shell.cmd" (
+    echo MSYS2 not found at %MSYS2_PATH%
+    echo Please install MSYS2 from https://www.msys2.org/
+    echo or set MSYS2_ROOT environment variable.
+    pause
+    exit /b 1
+)
+
+REM Launch MSYS2 UCRT64 shell and run build script
+echo Starting MSYS2 UCRT64 environment...
+rem call "%MSYS2_PATH%\msys2_shell.cmd" -ucrt64 -here -c "bash build.sh > build_win.log 2>&1"
+call "%MSYS2_PATH%\msys2_shell.cmd" -ucrt64 -here -defterm -no-start -c "set -o pipefail; bash build.sh 2>&1 | tee build_win.log"
@@ -0,0 +1,210 @@
+#!/bin/bash
+# Build script for uTun (supports both Linux and Windows/MSYS2)
+# Usage: ./build.sh [options]
+# Options:
+#   -h, --help      Show this help
+#   --clean         Clean before build
+#   --full          Full rebuild (autoreconf + configure + make)
+#   --asan          Build with AddressSanitizer (debug)
+#   --hardened      Build with compiler security hardening flags
+#   -j[N]           Build with N parallel jobs (default: 4)
+
+set -e  # Exit on error
+
+# Detect platform
+if [[ "$OSTYPE" == "msys" ]] || [[ "$OSTYPE" == "cygwin" ]] || [[ -n "$MSYSTEM" ]]; then
+    IS_WINDOWS=1
+    echo "Detected Windows/MSYS2 environment"
+else
+    IS_WINDOWS=0
+    echo "Detected Linux environment"
+fi
+
+# Parse arguments
+CLEAN=0
+FULL_REBUILD=0
+USE_ASAN=0
+USE_HARDENED=0
+JOBS="-j4"
+MAKE_ARGS=""
+HARDEN_FLAGS=""
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        -h|--help)
+            echo "Usage: ./build.sh [options]"
+            echo "Options:"
+            echo "  -h, --help      Show this help"
+            echo "  --clean         Clean before build"
+            echo "  --full          Full rebuild (autoreconf + configure + make)"
+            echo "  --asan          Build with AddressSanitizer"
+            echo "  --hardened      Build with compiler security hardening flags"
+            echo "  -j[N]           Build with N parallel jobs (default: 4)"
+            exit 0
+            ;;
+        --clean)
+            CLEAN=1
+            shift
+            ;;
+        --full)
+            FULL_REBUILD=1
+            shift
+            ;;
+        --asan)
+            USE_ASAN=1
+            shift
+            ;;
+        --hardened)
+            USE_HARDENED=1
+            shift
+            ;;    
+        -j*)
+            JOBS="$1"
+            shift
+            ;;
+        *)
+            MAKE_ARGS="$MAKE_ARGS $1"
+            shift
+            ;;
+    esac
+done
+
+# Check required tools
+if ! command -v gcc &> /dev/null; then
+    echo "Error: gcc not found."
+    if [ "$IS_WINDOWS" -eq 1 ]; then
+        echo "Please install: pacman -S mingw-w64-ucrt-x86_64-toolchain"
+    else
+        echo "Please install build-essential or gcc"
+    fi
+    exit 1
+fi
+
+# Clean if requested
+if [ "$CLEAN" -eq 1 ]; then
+    echo "Cleaning build..."
+    make clean 2>/dev/null || true
+fi
+
+# Full rebuild: regenerate build system
+if [ "$FULL_REBUILD" -eq 1 ]; then
+    echo ""
+    echo "======================================"
+    echo "FULL REBUILD: autoreconf"
+    echo "======================================"
+    echo ""
+
+    # Check for autotools
+    if ! command -v autoreconf &> /dev/null; then
+        echo "Error: autoreconf not found."
+        if [ "$IS_WINDOWS" -eq 1 ]; then
+            echo "Install autotools: pacman -S mingw-w64-ucrt-x86_64-autotools"
+        else
+            echo "Install autotools: apt-get install autoconf automake libtool"
+        fi
+        exit 1
+    fi
+
+    # Clean generated files
+    echo "Cleaning generated files..."
+    make distclean 2>/dev/null || true
+    rm -rf build/
+
+    # Regenerate build system (root Makefile is hand-written, not generated)
+    echo ""
+    echo "Running autoreconf -fi..."
+    autoreconf -fi 2>&1 | tee autoreconf.log
+
+    echo ""
+    echo "======================================"
+    echo "Build system regenerated successfully"
+    echo "======================================"
+    echo ""
+else
+    # Quick/incremental build: generate configure if needed
+    if [ ! -f ./configure ]; then
+        echo "Configure script not found. Generating..."
+        if ! command -v autoreconf &> /dev/null; then
+            echo "Error: autoreconf not found."
+            if [ "$IS_WINDOWS" -eq 1 ]; then
+                echo "Install autotools: pacman -S mingw-w64-ucrt-x86_64-autotools"
+            else
+                echo "Install autotools: apt-get install autoconf automake libtool"
+            fi
+            exit 1
+        fi
+        autoreconf -fiv
+    fi
+fi
+
+# Auto-detect FFmpeg (optional video transcoding). If libav libraries are
+# available, build with --with-ffmpeg; configure gracefully skips it otherwise.
+FFMPEG_OPT=""
+if command -v pkg-config >/dev/null 2>&1 && \
+   pkg-config --exists libavformat libavcodec libavutil libswscale libswresample 2>/dev/null; then
+    FFMPEG_OPT="--with-ffmpeg"
+    echo "FFmpeg detected — building with video transcoding"
+else
+    echo "FFmpeg not found — building without video transcoding"
+fi
+
+# Generate Makefiles if needed
+if [ ! -f Makefile ]; then
+    echo ""
+    echo "Running ./configure..."
+    if [ "$USE_ASAN" -eq 1 ]; then
+        ./configure CFLAGS="-g -Og -fsanitize=address -fno-omit-frame-pointer -fno-pie" LDFLAGS="-no-pie" $FFMPEG_OPT
+    elif [ "$USE_HARDENED" -eq 1 ]; then
+        ./configure --enable-hardening $FFMPEG_OPT
+    else
+        ./configure $FFMPEG_OPT
+    fi
+fi
+
+# Build (all .o files go to build/ directory, binary copied to project root)
+echo ""
+echo "Compiling with $JOBS..."
+BUILD_SUCCESS=0
+if [ "$USE_ASAN" -eq 1 ]; then
+    echo "(AddressSanitizer enabled — lib/ and src/ only, skipping tests)"
+    AF="-fsanitize=address -fno-omit-frame-pointer -g -Og"
+    AL="-fsanitize=address"
+    (cd lib && make clean $JOBS $MAKE_ARGS 2>&1 && make "CFLAGS+=$AF" "LDFLAGS+=$AL" $JOBS $MAKE_ARGS 2>&1) || { echo "lib build failed"; exit 1; }
+    # libopus собирается без ASAN (собственный CFLAGS в Makefile, .a несовместим с PIE)
+    (cd lib/libopus && make clean $JOBS $MAKE_ARGS 2>&1 && make $JOBS $MAKE_ARGS 2>&1) || { echo "libopus build failed"; exit 1; }
+    (cd src && make clean $JOBS $MAKE_ARGS 2>&1 && make "CFLAGS+=$AF" "LDFLAGS+=$AL" $JOBS $MAKE_ARGS 2>&1) || { echo "src build failed"; exit 1; }
+    BUILD_SUCCESS=1
+elif [ "$USE_HARDENED" -eq 1 ]; then
+    echo "(Hardening flags enabled)"
+    HF="-D_FORTIFY_SOURCE=2 -fstack-protector-strong -fstack-clash-protection -Wformat=2 -Wformat-overflow=2 -fPIE"
+    HL="-Wl,-z,relro -Wl,-z,now -pie"
+    (cd lib && make clean $JOBS $MAKE_ARGS 2>&1 && make "CFLAGS+=$HF" "LDFLAGS+=$HL" $JOBS $MAKE_ARGS 2>&1) || { echo "lib build failed"; exit 1; }
+    (cd src && make clean $JOBS $MAKE_ARGS 2>&1 && make "CFLAGS+=$HF" "LDFLAGS+=$HL" $JOBS $MAKE_ARGS 2>&1) || { echo "src build failed"; exit 1; }
+    (cd tests && make clean $JOBS $MAKE_ARGS 2>&1 && make "CFLAGS+=$HF" "LDFLAGS+=$HL" $JOBS $MAKE_ARGS 2>&1) || { echo "tests build failed"; exit 1; }
+    BUILD_SUCCESS=1
+else
+    make $JOBS $MAKE_ARGS 2>&1 | tee build.log
+    if [ ${PIPESTATUS[0]} -eq 0 ]; then
+        BUILD_SUCCESS=1
+    fi
+fi
+
+if [ $BUILD_SUCCESS -eq 1 ]; then
+    echo ""
+    echo "Build completed successfully!"
+    echo "Binary: utun"
+
+    # Rebuild chatgui (CMake project) if transport sources changed
+    if [ -f tools/chatgui/build/CMakeCache.txt ] && command -v cmake &> /dev/null; then
+        echo ""
+        echo "======================================"
+        echo "Rebuilding chatgui (CMake)"
+        echo "======================================"
+        (cd tools/chatgui/build && cmake --build . -j4 2>&1) || echo "WARNING: chatgui build failed"
+    fi
+else
+    echo ""
+    echo "ERROR: Build failed!"
+    echo "Check build.log for details"
+    exit 1
+fi
@@ -1,153 +0,0 @@
-/* config.h.  Generated from config.h.in by configure.  */
-/* config.h.in.  Generated from configure.ac by autoheader.  */
-
-/* Define to 1 if you have the <arpa/inet.h> header file. */
-#define HAVE_ARPA_INET_H 1
-
-/* Define to 1 if you have the <fcntl.h> header file. */
-#define HAVE_FCNTL_H 1
-
-/* Define to 1 if you have the `gettimeofday' function. */
-#define HAVE_GETTIMEOFDAY 1
-
-/* Define to 1 if you have the <inttypes.h> header file. */
-#define HAVE_INTTYPES_H 1
-
-/* Define to 1 if you have the `crypto' library (-lcrypto). */
-#define HAVE_LIBCRYPTO 1
-
-/* Define to 1 if you have the <limits.h> header file. */
-#define HAVE_LIMITS_H 1
-
-/* Define to 1 if your system has a GNU libc compatible `malloc' function, and
-   to 0 otherwise. */
-#define HAVE_MALLOC 1
-
-/* Define to 1 if you have the `memset' function. */
-#define HAVE_MEMSET 1
-
-/* Define to 1 if you have the <netinet/in.h> header file. */
-#define HAVE_NETINET_IN_H 1
-
-/* Define to 1 if you have the `socket' function. */
-#define HAVE_SOCKET 1
-
-/* Define to 1 if you have the <stdint.h> header file. */
-#define HAVE_STDINT_H 1
-
-/* Define to 1 if you have the <stdio.h> header file. */
-#define HAVE_STDIO_H 1
-
-/* Define to 1 if you have the <stdlib.h> header file. */
-#define HAVE_STDLIB_H 1
-
-/* Define to 1 if you have the `strchr' function. */
-#define HAVE_STRCHR 1
-
-/* Define to 1 if you have the `strdup' function. */
-#define HAVE_STRDUP 1
-
-/* Define to 1 if you have the `strerror' function. */
-#define HAVE_STRERROR 1
-
-/* Define to 1 if you have the <strings.h> header file. */
-#define HAVE_STRINGS_H 1
-
-/* Define to 1 if you have the <string.h> header file. */
-#define HAVE_STRING_H 1
-
-/* Define to 1 if you have the `strstr' function. */
-#define HAVE_STRSTR 1
-
-/* Define to 1 if you have the <sys/ioctl.h> header file. */
-#define HAVE_SYS_IOCTL_H 1
-
-/* Define to 1 if you have the <sys/socket.h> header file. */
-#define HAVE_SYS_SOCKET_H 1
-
-/* Define to 1 if you have the <sys/stat.h> header file. */
-#define HAVE_SYS_STAT_H 1
-
-/* Define to 1 if you have the <sys/types.h> header file. */
-#define HAVE_SYS_TYPES_H 1
-
-/* Define if TUN/TAP is available */
-/* #undef HAVE_TUN_TAP */
-
-/* Define to 1 if you have the <unistd.h> header file. */
-#define HAVE_UNISTD_H 1
-
-/* Name of package */
-#define PACKAGE "utun"
-
-/* Define to the address where bug reports for this package should be sent. */
-#define PACKAGE_BUGREPORT "https://github.com/anomalyco/utun3/issues"
-
-/* Define to the full name of this package. */
-#define PACKAGE_NAME "utun"
-
-/* Define to the full name and version of this package. */
-#define PACKAGE_STRING "utun 2.0.0"
-
-/* Define to the one symbol short name of this package. */
-#define PACKAGE_TARNAME "utun"
-
-/* Define to the home page for this package. */
-#define PACKAGE_URL ""
-
-/* Define to the version of this package. */
-#define PACKAGE_VERSION "2.0.0"
-
-/* Define to 1 if all of the C90 standard headers exist (not just the ones
-   required in a freestanding environment). This macro is provided for
-   backward compatibility; new code need not use it. */
-#define STDC_HEADERS 1
-
-/* Version number of package */
-#define VERSION "2.0.0"
-
-/* Define for Solaris 2.5.1 so the uint32_t typedef from <sys/synch.h>,
-   <pthread.h>, or <semaphore.h> is not used. If the typedef were allowed, the
-   #define below would cause a syntax error. */
-/* #undef _UINT32_T */
-
-/* Define for Solaris 2.5.1 so the uint64_t typedef from <sys/synch.h>,
-   <pthread.h>, or <semaphore.h> is not used. If the typedef were allowed, the
-   #define below would cause a syntax error. */
-/* #undef _UINT64_T */
-
-/* Define for Solaris 2.5.1 so the uint8_t typedef from <sys/synch.h>,
-   <pthread.h>, or <semaphore.h> is not used. If the typedef were allowed, the
-   #define below would cause a syntax error. */
-/* #undef _UINT8_T */
-
-/* Define to `__inline__' or `__inline' if that's what the C compiler
-   calls it, or to nothing if 'inline' is not supported under any name.  */
-#ifndef __cplusplus
-/* #undef inline */
-#endif
-
-/* Define to rpl_malloc if the replacement function should be used. */
-/* #undef malloc */
-
-/* Define to `unsigned int' if <sys/types.h> does not define. */
-/* #undef size_t */
-
-/* Define to `int' if <sys/types.h> does not define. */
-/* #undef ssize_t */
-
-/* Define to the type of an unsigned integer type of width exactly 16 bits if
-   such a type exists and the standard includes do not define it. */
-/* #undef uint16_t */
-
-/* Define to the type of an unsigned integer type of width exactly 32 bits if
-   such a type exists and the standard includes do not define it. */
-/* #undef uint32_t */
-
-/* Define to the type of an unsigned integer type of width exactly 64 bits if
-   such a type exists and the standard includes do not define it. */
-/* #undef uint64_t */
-
-/* Define to the type of an unsigned integer type of width exactly 8 bits if
-   such a type exists and the standard includes do not define it. */
-/* #undef uint8_t */
@@ -1,323 +0,0 @@
-This file contains any messages produced by compilers while
-running configure, to aid debugging if configure makes a mistake.
-
-It was created by utun configure 2.0.0, which was
-generated by GNU Autoconf 2.71.  Invocation command line was
-
-  $ ../configure --no-create --no-recursion
-
-## --------- ##
-## Platform. ##
-## --------- ##
-
-hostname = user-Standard-PC-i440FX-PIIX-1996
-uname -m = x86_64
-uname -r = 6.14.0-37-generic
-uname -s = Linux
-uname -v = #37~24.04.1-Ubuntu SMP PREEMPT_DYNAMIC Thu Nov 20 10:25:38 UTC 2
-
-/usr/bin/uname -p = x86_64
-/bin/uname -X     = unknown
-
-/bin/arch              = x86_64
-/usr/bin/arch -k       = unknown
-/usr/convex/getsysinfo = unknown
-/usr/bin/hostinfo      = unknown
-/bin/machine           = unknown
-/usr/bin/oslevel       = unknown
-/bin/universe          = unknown
-
-PATH: /home/vnc1/.cargo/bin/
-PATH: /usr/local/sbin/
-PATH: /usr/local/bin/
-PATH: /usr/sbin/
-PATH: /usr/bin/
-PATH: /sbin/
-PATH: /bin/
-PATH: /usr/games/
-PATH: /usr/local/games/
-PATH: /snap/bin/
-PATH: /snap/bin/
-
-
-## ----------- ##
-## Core tests. ##
-## ----------- ##
-
-configure:2453: looking for aux files: config.guess config.sub missing install-sh ar-lib compile
-configure:2466:  trying ../build-aux/
-configure:2495:   ../build-aux/config.guess found
-configure:2495:   ../build-aux/config.sub found
-configure:2495:   ../build-aux/missing found
-configure:2477:   ../build-aux/install-sh found
-configure:2495:   ../build-aux/ar-lib found
-configure:2495:   ../build-aux/compile found
-configure:2675: checking for gcc
-configure:2696: found /usr/bin/gcc
-configure:2707: result: gcc
-configure:3060: checking for C compiler version
-configure:3069: gcc --version >&5
-gcc (Ubuntu 13.3.0-6ubuntu2~24.04) 13.3.0
-Copyright (C) 2023 Free Software Foundation, Inc.
-This is free software; see the source for copying conditions.  There is NO
-warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
-
-configure:3080: $? = 0
-configure:3069: gcc -v >&5
-Using built-in specs.
-COLLECT_GCC=gcc
-COLLECT_LTO_WRAPPER=/usr/libexec/gcc/x86_64-linux-gnu/13/lto-wrapper
-OFFLOAD_TARGET_NAMES=nvptx-none:amdgcn-amdhsa
-OFFLOAD_TARGET_DEFAULT=1
-Target: x86_64-linux-gnu
-Configured with: ../src/configure -v --with-pkgversion='Ubuntu 13.3.0-6ubuntu2~24.04' --with-bugurl=file:///usr/share/doc/gcc-13/README.Bugs --enable-languages=c,ada,c++,go,d,fortran,objc,obj-c++,m2 --prefix=/usr --with-gcc-major-version-only --program-suffix=-13 --program-prefix=x86_64-linux-gnu- --enable-shared --enable-linker-build-id --libexecdir=/usr/libexec --without-included-gettext --enable-threads=posix --libdir=/usr/lib --enable-nls --enable-bootstrap --enable-clocale=gnu --enable-libstdcxx-debug --enable-libstdcxx-time=yes --with-default-libstdcxx-abi=new --enable-libstdcxx-backtrace --enable-gnu-unique-object --disable-vtable-verify --enable-plugin --enable-default-pie --with-system-zlib --enable-libphobos-checking=release --with-target-system-zlib=auto --enable-objc-gc=auto --enable-multiarch --disable-werror --enable-cet --with-arch-32=i686 --with-abi=m64 --with-multilib-list=m32,m64,mx32 --enable-multilib --with-tune=generic --enable-offload-targets=nvptx-none=/build/gcc-13-fG75Ri/gcc-13-13.3.0/debian/tmp-nvptx/usr,amdgcn-amdhsa=/build/gcc-13-fG75Ri/gcc-13-13.3.0/debian/tmp-gcn/usr --enable-offload-defaulted --without-cuda-driver --enable-checking=release --build=x86_64-linux-gnu --host=x86_64-linux-gnu --target=x86_64-linux-gnu --with-build-config=bootstrap-lto-lean --enable-link-serialization=2
-Thread model: posix
-Supported LTO compression algorithms: zlib zstd
-gcc version 13.3.0 (Ubuntu 13.3.0-6ubuntu2~24.04) 
-... rest of stderr output deleted ...
-configure:3080: $? = 0
-configure:3069: gcc -V >&5
-gcc: error: unrecognized command-line option '-V'
-gcc: fatal error: no input files
-compilation terminated.
-configure:3080: $? = 1
-configure:3069: gcc -qversion >&5
-gcc: error: unrecognized command-line option '-qversion'; did you mean '--version'?
-gcc: fatal error: no input files
-compilation terminated.
-configure:3080: $? = 1
-configure:3069: gcc -version >&5
-gcc: error: unrecognized command-line option '-version'
-gcc: fatal error: no input files
-compilation terminated.
-configure:3080: $? = 1
-configure:3100: checking whether the C compiler works
-configure:3122: gcc    conftest.c  >&5
-configure:3126: $? = 0
-configure:3176: result: yes
-configure:3179: checking for C compiler default output file name
-configure:3181: result: a.out
-configure:3187: checking for suffix of executables
-configure:3194: gcc -o conftest    conftest.c  >&5
-configure:3198: $? = 0
-configure:3221: result: 
-configure:3243: checking whether we are cross compiling
-configure:3251: gcc -o conftest    conftest.c  >&5
-configure:3255: $? = 0
-configure:3262: ./conftest
-configure:3266: $? = 0
-configure:3281: result: no
-configure:3286: checking for suffix of object files
-configure:3309: gcc -c   conftest.c >&5
-configure:3313: $? = 0
-configure:3335: result: o
-configure:3339: checking whether the compiler supports GNU C
-configure:3359: gcc -c   conftest.c >&5
-configure:3359: $? = 0
-configure:3369: result: yes
-configure:3380: checking whether gcc accepts -g
-configure:3401: gcc -c -g  conftest.c >&5
-configure:3401: $? = 0
-configure:3445: result: yes
-configure:3465: checking for gcc option to enable C11 features
-configure:3480: gcc  -c -g -O2  conftest.c >&5
-configure:3480: $? = 0
-configure:3498: result: none needed
-configure:3619: checking whether gcc understands -c and -o together
-configure:3642: gcc -c conftest.c -o conftest2.o
-configure:3645: $? = 0
-configure:3642: gcc -c conftest.c -o conftest2.o
-configure:3645: $? = 0
-configure:3657: result: yes
-configure:3722: checking for ranlib
-configure:3743: found /usr/bin/ranlib
-configure:3754: result: ranlib
-configure:3832: checking for ar
-configure:3853: found /usr/bin/ar
-configure:3864: result: ar
-configure:3890: checking the archiver (ar) interface
-configure:3907: gcc -c -g -O2  conftest.c >&5
-configure:3907: $? = 0
-configure:3910: ar cru libconftest.a conftest.o >&5
-ar: `u' modifier ignored since `D' is the default (see `U')
-configure:3913: $? = 0
-configure:3941: result: ar
-configure:3978: checking for a BSD-compatible install
-configure:4051: result: /usr/bin/install -c
-configure:4062: checking whether build environment is sane
-configure:4117: result: yes
-configure:4272: checking for a race-free mkdir -p
-configure:4316: result: /usr/bin/mkdir -p
-configure:4323: checking for gawk
-configure:4358: result: no
-configure:4323: checking for mawk
-configure:4344: found /usr/bin/mawk
-configure:4355: result: mawk
-configure:4366: checking whether make sets $(MAKE)
-configure:4389: result: yes
-configure:4411: checking whether make supports the include directive
-configure:4426: make -f confmf.GNU && cat confinc.out
-make[1]: Entering directory '/home/vnc1/proj/utun3/build'
-make[1]: Leaving directory '/home/vnc1/proj/utun3/build'
-this is the am__doit target
-configure:4429: $? = 0
-configure:4448: result: yes (GNU style)
-configure:4483: checking whether make supports nested variables
-configure:4501: result: yes
-configure:4518: error: source directory already configured; run "make distclean" there first
-
-## ---------------- ##
-## Cache variables. ##
-## ---------------- ##
-
-ac_cv_c_compiler_gnu=yes
-ac_cv_env_CC_set=
-ac_cv_env_CC_value=
-ac_cv_env_CFLAGS_set=
-ac_cv_env_CFLAGS_value=
-ac_cv_env_CPPFLAGS_set=
-ac_cv_env_CPPFLAGS_value=
-ac_cv_env_LDFLAGS_set=
-ac_cv_env_LDFLAGS_value=
-ac_cv_env_LIBS_set=
-ac_cv_env_LIBS_value=
-ac_cv_env_build_alias_set=
-ac_cv_env_build_alias_value=
-ac_cv_env_host_alias_set=
-ac_cv_env_host_alias_value=
-ac_cv_env_target_alias_set=
-ac_cv_env_target_alias_value=
-ac_cv_objext=o
-ac_cv_path_install='/usr/bin/install -c'
-ac_cv_path_mkdir=/usr/bin/mkdir
-ac_cv_prog_AWK=mawk
-ac_cv_prog_ac_ct_AR=ar
-ac_cv_prog_ac_ct_CC=gcc
-ac_cv_prog_ac_ct_RANLIB=ranlib
-ac_cv_prog_cc_c11=
-ac_cv_prog_cc_g=yes
-ac_cv_prog_cc_stdc=
-ac_cv_prog_make_make_set=yes
-am_cv_ar_interface=ar
-am_cv_make_support_nested_variables=yes
-am_cv_prog_cc_c_o=yes
-
-## ----------------- ##
-## Output variables. ##
-## ----------------- ##
-
-ACLOCAL=''
-AMDEPBACKSLASH='\'
-AMDEP_FALSE='#'
-AMDEP_TRUE=''
-AMTAR=''
-AM_BACKSLASH='\'
-AM_DEFAULT_V='$(AM_DEFAULT_VERBOSITY)'
-AM_DEFAULT_VERBOSITY='1'
-AM_V='$(V)'
-AR='ar'
-AUTOCONF=''
-AUTOHEADER=''
-AUTOMAKE=''
-AWK='mawk'
-CC='gcc'
-CCDEPMODE=''
-CFLAGS='-g -O2'
-CPPFLAGS=''
-CSCOPE=''
-CTAGS=''
-CYGPATH_W=''
-DEFS=''
-DEPDIR='.deps'
-ECHO_C=''
-ECHO_N='-n'
-ECHO_T=''
-ETAGS=''
-EXEEXT=''
-INSTALL_DATA='${INSTALL} -m 644'
-INSTALL_PROGRAM='${INSTALL}'
-INSTALL_SCRIPT='${INSTALL}'
-INSTALL_STRIP_PROGRAM='$(install_sh) -c -s'
-LDFLAGS=''
-LIBOBJS=''
-LIBS=''
-LTLIBOBJS=''
-MAKEINFO=''
-MKDIR_P='/usr/bin/mkdir -p'
-OBJEXT='o'
-PACKAGE=''
-PACKAGE_BUGREPORT='https://github.com/anomalyco/utun3/issues'
-PACKAGE_NAME='utun'
-PACKAGE_STRING='utun 2.0.0'
-PACKAGE_TARNAME='utun'
-PACKAGE_URL=''
-PACKAGE_VERSION='2.0.0'
-PATH_SEPARATOR=':'
-RANLIB='ranlib'
-SET_MAKE=''
-SHELL='/bin/bash'
-STRIP=''
-VERSION=''
-ac_ct_AR='ar'
-ac_ct_CC='gcc'
-am__EXEEXT_FALSE=''
-am__EXEEXT_TRUE=''
-am__fastdepCC_FALSE=''
-am__fastdepCC_TRUE=''
-am__include='include'
-am__isrc=' -I$(srcdir)'
-am__leading_dot='.'
-am__nodep='_no'
-am__quote=''
-am__tar=''
-am__untar=''
-bindir='${exec_prefix}/bin'
-build=''
-build_alias=''
-build_cpu=''
-build_os=''
-build_vendor=''
-datadir='${datarootdir}'
-datarootdir='${prefix}/share'
-docdir='${datarootdir}/doc/${PACKAGE_TARNAME}'
-dvidir='${docdir}'
-exec_prefix='NONE'
-host=''
-host_alias=''
-host_cpu=''
-host_os=''
-host_vendor=''
-htmldir='${docdir}'
-includedir='${prefix}/include'
-infodir='${datarootdir}/info'
-install_sh='${SHELL} /home/vnc1/proj/utun3/build-aux/install-sh'
-libdir='${exec_prefix}/lib'
-libexecdir='${exec_prefix}/libexec'
-localedir='${datarootdir}/locale'
-localstatedir='${prefix}/var'
-mandir='${datarootdir}/man'
-mkdir_p=''
-oldincludedir='/usr/include'
-pdfdir='${docdir}'
-prefix='NONE'
-program_transform_name='s,x,x,'
-psdir='${docdir}'
-runstatedir='${localstatedir}/run'
-sbindir='${exec_prefix}/sbin'
-sharedstatedir='${prefix}/com'
-sysconfdir='${prefix}/etc'
-target_alias=''
-
-## ----------- ##
-## confdefs.h. ##
-## ----------- ##
-
-/* confdefs.h */
-#define PACKAGE_NAME "utun"
-#define PACKAGE_TARNAME "utun"
-#define PACKAGE_VERSION "2.0.0"
-#define PACKAGE_STRING "utun 2.0.0"
-#define PACKAGE_BUGREPORT "https://github.com/anomalyco/utun3/issues"
-#define PACKAGE_URL ""
-
-configure: exit 1
@@ -1 +0,0 @@
-../tinycrypt/lib
@@ -1 +0,0 @@
-timestamp for config.h
@@ -0,0 +1,144 @@
+#!/bin/sh
+# Build script for uTun on FreeBSD (full rebuild)
+# Usage: ./build_bsd_full.sh [options]
+# Options:
+#   -h, --help      Show this help
+#   --asan          Build with AddressSanitizer (clang)
+#   --hardened      Build with compiler security hardening flags (clang)
+#   -j[N]           Build with N parallel jobs (default: sysctl hw.ncpu)
+
+set -e
+
+# Parse arguments
+USE_ASAN=0
+USE_HARDENED=0
+JOBS=""
+MAKE_ARGS=""
+
+while [ $# -gt 0 ]; do
+    case "$1" in
+        -h|--help)
+            echo "Usage: ./build_bsd_full.sh [options]"
+            echo "Options:"
+            echo "  -h, --help      Show this help"
+            echo "  --asan          Build with AddressSanitizer"
+            echo "  --hardened      Build with compiler security hardening flags"
+            echo "  -j[N]           Build with N parallel jobs (default: sysctl hw.ncpu)"
+            exit 0
+            ;;
+        --asan)
+            USE_ASAN=1
+            shift
+            ;;
+        --hardened)
+            USE_HARDENED=1
+            shift
+            ;;
+        -j*)
+            JOBS="$1"
+            shift
+            ;;
+        *)
+            MAKE_ARGS="$MAKE_ARGS $1"
+            shift
+            ;;
+    esac
+done
+
+if [ -z "$JOBS" ]; then
+    if command -v nproc >/dev/null 2>&1; then
+        JOBS="-j$(nproc)"
+    else
+        JOBS="-j$(sysctl -n hw.ncpu)"
+    fi
+fi
+
+# Проверка и установка зависимостей
+need_install=""
+
+for cmd in autoreconf aclocal automake libtoolize; do
+    if ! command -v "$cmd" >/dev/null 2>&1; then
+        need_install=1
+        break
+    fi
+done
+
+if [ -n "$need_install" ]; then
+    echo "Устанавливаются необходимые пакеты (нужен root)..."
+    pkg update
+    pkg install -y autoconf automake libtool pkgconf openssl
+fi
+
+# Предпочитаем GNU make (gmake), но fallback на bmake — он собирает
+# autotools-генерённые Makefile данного проекта. gmake ставится отдельно:
+#   pkg install gmake   (нужен root)
+GMAKE="$(command -v gmake || command -v make)"
+echo "Используем make: $GMAKE"
+
+mkdir -p m4
+
+echo "=== Полная пересборка uTun ==="
+
+# 1. Очистка
+echo "[1/4] Очистка..."
+$GMAKE distclean 2>/dev/null || true
+rm -f config.h config.status config.log
+rm -f configure.log autoreconf.log build.log
+
+# 2. Генерация configure
+echo "[2/4] Автогенерация..."
+autoreconf -fi 2>&1 | tee autoreconf.log
+
+# Проверяем, появился ли configure
+if [ ! -f configure ]; then
+    echo "Ошибка: autoreconf не создал configure."
+    exit 1
+fi
+
+chmod +x configure
+
+# 3. Конфигурация
+echo "[3/4] Конфигурация..."
+
+# FFmpeg (опционально) — автоопределение через pkg-config
+FFMPEG_OPT=""
+if command -v pkg-config >/dev/null 2>&1 && \
+   pkg-config --exists libavformat libavcodec libavutil libswscale libswresample 2>/dev/null; then
+    FFMPEG_OPT="--with-ffmpeg"
+    echo "FFmpeg detected — building with video transcoding"
+else
+    echo "FFmpeg not found — building without video transcoding"
+fi
+
+if [ "$USE_ASAN" -eq 1 ]; then
+    echo "(AddressSanitizer enabled — clang, lib/ + src/ only)"
+    ./configure --prefix=/usr/local CC=clang \
+        CFLAGS="-g -O1 -fsanitize=address -fno-omit-frame-pointer" \
+        LDFLAGS="-fsanitize=address" $FFMPEG_OPT 2>&1 | tee configure.log
+elif [ "$USE_HARDENED" -eq 1 ]; then
+    echo "(Hardening enabled — clang-safe flags)"
+    ./configure --prefix=/usr/local CC=clang \
+        CFLAGS="-D_FORTIFY_SOURCE=2 -fstack-protector-strong -fPIE" \
+        LDFLAGS="-Wl,-z,relro -Wl,-z,now -pie" $FFMPEG_OPT 2>&1 | tee configure.log
+else
+    ./configure --prefix=/usr/local $FFMPEG_OPT 2>&1 | tee configure.log
+fi
+
+# 4. Сборка
+echo "[4/4] Сборка..."
+if [ "$USE_ASAN" -eq 1 ]; then
+    (cd lib && $GMAKE $JOBS $MAKE_ARGS 2>&1 | tee ../build.log)
+    (cd lib/libopus && $GMAKE $JOBS $MAKE_ARGS 2>&1 | tee ../../build.log)
+    (cd src && $GMAKE $JOBS $MAKE_ARGS 2>&1 | tee ../build.log)
+else
+    $GMAKE $JOBS $MAKE_ARGS 2>&1 | tee build.log
+fi
+
+echo
+echo "=== Готово ==="
+echo "Бинарный файл: src/utun"
+if [ "$USE_ASAN" -eq 1 ]; then
+    echo
+    echo "Запуск с ASAN (detect_leaks=0 обязателен на FreeBSD):"
+    echo "  ASAN_OPTIONS=detect_leaks=0:halt_on_error=0 ./src/utun -f -p /tmp/utun.pid -l /tmp/utun.log"
+fi
@@ -0,0 +1,126 @@
+#!/bin/bash
+# Direct build script for uTun on Windows with OpenSSL
+# Инкрементальная сборка (не пересобирает неизменённые файлы)
+
+set -e
+
+echo "uTun Direct Build Script for Windows with OpenSSL (Incremental)"
+echo "=============================================================="
+echo ""
+
+# ====================== OpenSSL paths ======================
+if [ -d "/c/msys64/ucrt64/include/openssl" ]; then
+    export CFLAGS="$CFLAGS -I/c/msys64/ucrt64/include"
+    export LDFLAGS="$LDFLAGS -L/c/msys64/ucrt64/lib"
+    echo "Using MSYS2 UCRT64 OpenSSL"
+elif [ -d "/ucrt64/include/openssl" ]; then
+    export CFLAGS="$CFLAGS -I/ucrt64/include"
+    export LDFLAGS="$LDFLAGS -L/ucrt64/lib"
+    echo "Using MSYS2 UCRT64 OpenSSL"
+elif [ -d "/mingw64/include/openssl" ]; then
+    export CFLAGS="$CFLAGS -I/mingw64/include"
+    export LDFLAGS="$LDFLAGS -L/mingw64/lib"
+    echo "Using MSYS2 MINGW64 OpenSSL"
+fi
+
+# ====================== Configure (только если нужно) ======================
+if [ ! -f config.status ] || [ config.status -ot configure ]; then
+    echo ""
+    echo "Running configure..."
+    ./configure --prefix=/usr/local --host=x86_64-w64-mingw32 --disable-dependency-tracking 2>&1 | tee configure.log
+fi
+
+# ====================== Directories ======================
+mkdir -p src/.deps lib/.deps tests/.deps
+
+# ====================== Build libuasync.a (incremental) ======================
+echo ""
+echo "Building libuasync.a..."
+
+cd lib
+LIB_NEEDS_REBUILD=0
+
+for src in u_async.c ll_queue.c memory_pool.c debug_config.c timeout_heap.c sha256.c platform_compat.c socket_compat.c; do
+    if [ -f "$src" ]; then
+        obj="${src%.c}.o"
+        if [ ! -f "$obj" ] || [ "$src" -nt "$obj" ]; then
+            echo "  CC $src"
+            x86_64-w64-mingw32-gcc -DHAVE_CONFIG_H -I. -I.. -g -O2 -c "$src" -o "$obj" 2>&1 | grep -v "warning:" || true
+            LIB_NEEDS_REBUILD=1
+        else
+            echo "  SKIPPED $src (up to date)"
+        fi
+    fi
+done
+
+# Пересобираем библиотеку только если что-то изменилось
+if [ ! -f "libuasync.a" ] || [ $LIB_NEEDS_REBUILD -eq 1 ] || [ -n "$(find . -name '*.o' -newer libuasync.a 2>/dev/null)" ]; then
+    echo "  AR libuasync.a"
+    ar cru libuasync.a *.o
+    ranlib libuasync.a
+else
+    echo "  SKIPPED libuasync.a (up to date)"
+fi
+cd ..
+
+# ====================== Build utun.exe (incremental) ======================
+echo ""
+echo "Building utun.exe..."
+
+cd src
+EXE_NEEDS_REBUILD=0
+
+CORE_SOURCES="utun.c utun_instance.c config_parser.c config_updater.c routing_layer/route_lib.c topo_bgp.c routing_layer/routing.c tun_if.c tun_route.c transport_layer/etcp.c transport_layer/etcp_connections.c transport_layer/etcp_loadbalancer.c transport_layer/secure_channel.c transport_layer/crc32.c transport_layer/pkt_normalizer.c transport_layer/etcp_api.c tun_windows.c"
+
+for src in $CORE_SOURCES; do
+    if [ -f "$src" ]; then
+        obj="utun-${src%.c}.o"
+        if [ ! -f "$obj" ] || [ "$src" -nt "$obj" ]; then
+            echo "  CC $src"
+            x86_64-w64-mingw32-gcc -DHAVE_CONFIG_H -I. -I.. -I../lib -I../src/transport_layer -I../src/routing_layer -I../tinycrypt/lib/include -I../tinycrypt/lib/source $CFLAGS -g -O2 -c "$src" -o "$obj" 2>&1 | grep -E "error:|warning:.*deprecated" || true
+            EXE_NEEDS_REBUILD=1
+        else
+            echo "  SKIPPED $src (up to date)"
+        fi
+    else
+        echo "  WARNING: $src not found!"
+    fi
+done
+
+# Проверяем, нужно ли линковать
+LINK_NEEDED=0
+if [ ! -f "utun.exe" ] || [ $EXE_NEEDS_REBUILD -eq 1 ]; then
+    LINK_NEEDED=1
+else
+    # Проверяем все объектники и библиотеку
+    for obj in utun-*.o; do
+        if [ -f "$obj" ] && [ "$obj" -nt "utun.exe" ]; then
+            LINK_NEEDED=1
+            break
+        fi
+    done
+    if [ -f "../lib/libuasync.a" ] && [ "../lib/libuasync.a" -nt "utun.exe" ]; then
+        LINK_NEEDED=1
+    fi
+fi
+
+if [ $LINK_NEEDED -eq 1 ]; then
+    echo "  LINK utun.exe"
+    x86_64-w64-mingw32-gcc -o utun.exe utun-*.o ../lib/libuasync.a -lpthread -lm -lws2_32 -liphlpapi -lbcrypt $LDFLAGS -lcrypto 2>&1 | grep -E "error:|undefined reference" || true
+else
+    echo "  SKIPPED LINK utun.exe (up to date)"
+fi
+
+# Копируем в корень проекта
+if [ -f "utun.exe" ]; then
+    cp utun.exe ../utun.exe
+    echo "Binary updated: ../utun.exe"
+fi
+
+cd ..
+
+echo ""
+echo "Build completed successfully! ✅"
+echo "Binary: utun.exe"
+echo ""
+echo "Make sure wintun.dll is in the same directory as utun.exe"
@@ -1,19 +0,0 @@
-Sat Jan 17 2026 21:10: Fixed build errors and implemented utun_instance structure
-
-CHANGES:
-1. Fixed missing struct sockaddr include in connection.h
-2. Removed control_socket module (functionality to be moved to etcp_socket)
-3. Removed udp_socket module (functionality merged into etcp_socket)
-4. Created utun_instance.h and utun_instance.c with root instance structure
-5. Refactored utun.c to use utun_instance instead of utun_state
-6. Fixed ETCP API mismatches (temporarily disabled ETCP integration)
-7. Fixed routing_stats_t structure members
-8. Cleaned up pkt_normalizer.c formatting issues
-9. Updated Makefile to remove deprecated modules
-10. Successfully built utun binary
-
-NEXT STEPS:
- Fix ETCP API integration
- Re-enable ETCP tests
- Implement proper error handling in utun_instance
- Add comprehensive tests for utun_instance
@@ -0,0 +1,33 @@
+@echo off
+echo uTun Full Build Script for MSYS2 UCRT64
+echo =========================================
+echo This will regenerate build system with autoreconf
+echo.
+
+pushd "%~dp0"
+
+rem export http_proxy="http://192.168.29.1:9999"
+rem export https_proxy="http://192.168.29.1:9999"
+
+
+REM Default MSYS2 path
+set MSYS2_PATH=C:\msys64
+
+REM Use environment variable if set
+if not "%MSYS2_ROOT%"=="" set MSYS2_PATH=%MSYS2_ROOT%
+if not "%MSYS2%"=="" set MSYS2_PATH=%MSYS2%
+
+REM Check if msys2_shell.cmd exists
+if not exist "%MSYS2_PATH%\msys2_shell.cmd" (
+    echo MSYS2 not found at %MSYS2_PATH%
+    echo Please install MSYS2 from https://www.msys2.org/
+    echo or set MSYS2_ROOT environment variable.
+    pause
+    exit /b 1
+)
+
+REM Launch MSYS2 UCRT64 shell and run build script with --full flag
+echo Starting MSYS2 UCRT64 environment for FULL REBUILD...
+echo Running: bash build.sh --full
+echo.
+call "%MSYS2_PATH%\msys2_shell.cmd" -ucrt64 -here -defterm -no-start -c "set -o pipefail; bash build.sh --full 2>&1 | tee build_full.log"
@@ -0,0 +1,116 @@
+#!/bin/sh
+set -e
+
+# --- определение пакетного менеджера ---
+detect_pm() {
+    if command -v apt-get >/dev/null 2>&1; then
+        PM=apt; PM_UPDATE="apt-get update"; PM_INSTALL="apt-get install -y"
+        P_AUTOCONF=autoconf; P_AUTOMAKE=automake; P_BUILD=build-essential; P_SSL=libssl-dev
+    elif command -v dnf >/dev/null 2>&1; then
+        PM=dnf; PM_UPDATE="true"; PM_INSTALL="dnf install -y"
+        P_AUTOCONF=autoconf; P_AUTOMAKE=automake; P_BUILD="gcc make"; P_SSL=openssl-devel
+    elif command -v yum >/dev/null 2>&1; then
+        PM=yum; PM_UPDATE="true"; PM_INSTALL="yum install -y"
+        P_AUTOCONF=autoconf; P_AUTOMAKE=automake; P_BUILD="gcc make"; P_SSL=openssl-devel
+    elif command -v pacman >/dev/null 2>&1; then
+        PM=pacman; PM_UPDATE="pacman -Sy --noconfirm"; PM_INSTALL="pacman -S --noconfirm"
+        P_AUTOCONF=autoconf; P_AUTOMAKE=automake; P_BUILD=base-devel; P_SSL=openssl
+    elif command -v apk >/dev/null 2>&1; then
+        PM=apk; PM_UPDATE="apk update"; PM_INSTALL="apk add"
+        P_AUTOCONF=autoconf; P_AUTOMAKE=automake; P_BUILD=build-base; P_SSL=openssl-dev
+    else
+        PM=none
+    fi
+}
+
+# --- чего не хватает (логические маркеры) ---
+detect_missing() {
+    missing=""
+    command -v autoreconf >/dev/null 2>&1 || missing="$missing autoconf"
+    command -v automake   >/dev/null 2>&1 || missing="$missing automake"
+    if ! command -v gcc >/dev/null 2>&1 || ! command -v make >/dev/null 2>&1; then
+        missing="$missing buildtools"
+    fi
+    [ -f /usr/include/openssl/sha.h ] || missing="$missing openssl"
+}
+
+# --- перевести маркеры в пакеты выбранного PM ---
+pkg_names() {
+    pkgs=""
+    case "$missing" in *autoconf*)   pkgs="$pkgs $P_AUTOCONF";; esac
+    case "$missing" in *automake*)   pkgs="$pkgs $P_AUTOMAKE";; esac
+    case "$missing" in *buildtools*) pkgs="$pkgs $P_BUILD";; esac
+    case "$missing" in *openssl*)    pkgs="$pkgs $P_SSL";; esac
+}
+
+# --- установка, если что-то отсутствует ---
+detect_pm
+detect_missing
+if [ -n "$missing" ]; then
+    if [ "$PM" = "none" ]; then
+        echo "Ошибка: не найден пакетный менеджер. Установите вручную:$missing"
+        exit 1
+    fi
+    if [ "$(id -u)" -eq 0 ]; then
+        SUDO=""
+    elif command -v sudo >/dev/null 2>&1; then
+        SUDO="sudo"
+    else
+        echo "Ошибка: нужны права root (sudo не найден). Установите вручную:$missing"
+        exit 1
+    fi
+    pkg_names
+    echo "Установка недостающих пакетов ($PM):$pkgs"
+    $SUDO $PM_UPDATE && $SUDO $PM_INSTALL $pkgs || {
+        echo "Ошибка: не удалось установить пакеты:$pkgs"
+        exit 1
+    }
+    detect_missing
+    if [ -n "$missing" ]; then
+        echo "Ошибка: после установки всё ещё не хватает:$missing"
+        exit 1
+    fi
+fi
+
+mkdir -p m4
+
+echo "=== Полная пересборка uTun ==="
+
+# 1. Очистка
+echo "[1/4] Очистка..."
+make distclean 2>/dev/null || true
+rm -f config.h config.status config.log
+rm -f configure.log autoreconf.log build.log
+rm -f src/utun
+
+# 2. Автогенерация (autoreconf)
+echo "[2/4] Автогенерация (autoreconf -fi)..."
+autoreconf -fi 2>&1 | tee autoreconf.log
+
+if [ ! -f configure ]; then
+    echo "Ошибка: autoreconf не создал configure. См. autoreconf.log"
+    exit 1
+fi
+
+# 3. Конфигурация
+echo "[3/4] Конфигурация..."
+./configure --prefix=/usr/local 2>&1 | tee configure.log
+
+if [ ! -f Makefile ]; then
+    echo "Ошибка: configure не создал Makefile. См. configure.log"
+    echo "Возможно не установлен libssl-dev (OpenSSL)."
+    exit 1
+fi
+
+# 4. Сборка
+echo "[4/4] Сборка..."
+make -j$(nproc) 2>&1 | tee build.log
+
+if [ ! -f src/utun ]; then
+    echo "Ошибка: сборка не создала src/utun. См. build.log"
+    exit 1
+fi
+
+echo ""
+echo "=== Готово ==="
+echo "Бинарный файл: src/utun (скопирован в ./utun)"
@@ -0,0 +1,124 @@
+#!/bin/bash
+# OpenWRT build script for uTun
+# Usage: ./build_openwrt.sh [TARGET] [PROFILE]
+#
+# Examples:
+#   ./build_openwrt.sh                           # ASUS RT-AX53U (default)
+#   ./build_openwrt.sh ramips/mt7621 asus_rt-ax53u
+#   ./build_openwrt.sh ath79/generic tplink_archer-c7-v2
+#   ./build_openwrt.sh x86/64
+#   ./build_openwrt.sh --list                   # list available targets
+#
+# First run builds the full toolchain (30-120 min).
+# Subsequent runs only rebuild the utun package.
+
+set -e
+
+OPENWRT_ROOT=/home/user/openwrt
+
+# --- Default target: ASUS RT-AX53U ---
+TARGET="${1:-ramips/mt7621}"
+PROFILE="${2:-asus_rt-ax53u}"
+J="${J:-$(nproc)}"
+
+# --- Help / list ---
+if [ "$1" = "--list" ] || [ "$1" = "-l" ]; then
+    echo "=== Predefined targets ==="
+    echo "  ramips/mt7621 asus_rt-ax53u    ASUS RT-AX53U (default)"
+    echo "  ramips/mt7621 asus_rt-ax54     ASUS RT-AX54"
+    echo "  ramips/mt7621 xiaomi_mi-router-4a-gigabit  Xiaomi Mi Router 4A"
+    echo "  ath79/generic tplink_archer-c7-v2          TP-Link Archer C7 v2"
+    echo "  x86/64                                    Generic x86_64 PC"
+    echo "  x86/generic                               Generic x86 PC"
+    echo ""
+    echo "Full target list: grep 'TARGET_DEVICES' $OPENWRT_ROOT/target/linux/*/image/*.mk"
+    exit 0
+fi
+
+# --- Check OpenWRT exists ---
+if [ ! -d "$OPENWRT_ROOT" ]; then
+    echo "ERROR: OpenWRT not found at $OPENWRT_ROOT"
+    echo "Clone: git clone --depth 1 https://github.com/openwrt/openwrt.git $OPENWRT_ROOT"
+    exit 1
+fi
+
+# --- Check utun package exists ---
+if [ ! -f "$OPENWRT_ROOT/package/utun2/Makefile" ]; then
+    echo "ERROR: utun package not found in OpenWRT"
+    echo "Expected: $OPENWRT_ROOT/package/utun2/Makefile"
+    exit 1
+fi
+
+echo "============================================"
+echo "  uTun OpenWRT Build"
+echo "  Target:  $TARGET"
+echo "  Profile: $PROFILE"
+echo "  Jobs:    $J"
+echo "============================================"
+
+cd "$OPENWRT_ROOT"
+
+# --- Select target ---
+TARGET_NAME=$(echo "$TARGET" | cut -d/ -f1)
+SUBTARGET_NAME=$(echo "$TARGET" | cut -d/ -f2)
+
+echo ""
+echo "[1/3] Configuring target..."
+
+# Write .config
+cat > .config << EOF
+CONFIG_TARGET_${TARGET_NAME}=y
+CONFIG_TARGET_${TARGET_NAME}_${SUBTARGET_NAME}=y
+CONFIG_TARGET_${TARGET_NAME}_${SUBTARGET_NAME}_DEVICE_${PROFILE}=y
+CONFIG_PACKAGE_utun=m
+# Basic system
+CONFIG_PACKAGE_libc=y
+CONFIG_PACKAGE_libopenssl=y
+CONFIG_PACKAGE_libpthread=y
+CONFIG_ALL_NONSHARED=n
+CONFIG_ALL_KMODS=n
+CONFIG_ALL=n
+CONFIG_DEVEL=y
+CONFIG_CCACHE=y
+# Build options
+CONFIG_BUILD_LOG=y
+EOF
+
+echo "  Target: ${TARGET_NAME}/${SUBTARGET_NAME}  Device: ${PROFILE}"
+
+# Expand config
+make defconfig V=s 2>/dev/null || true
+
+echo ""
+echo "[2/3] Building toolchain (if needed)..."
+if [ ! -f "staging_dir/toolchain-*/bin/mips-openwrt-linux-gcc" ] && \
+   [ ! -f "staging_dir/toolchain-*/bin/mipsel-openwrt-linux-gcc" ] && \
+   [ ! -f "staging_dir/toolchain-*/bin/x86_64-openwrt-linux-gcc" ]; then
+    echo "  Toolchain not found. Building... (this may take 30-120 min)"
+    make tools/install -j$J V=s 2>&1 | tail -5
+    make toolchain/install -j$J V=s 2>&1 | tail -5
+    echo "  Toolchain built."
+else
+    echo "  Toolchain already built. Skipping."
+fi
+
+echo ""
+echo "[3/3] Building utun package..."
+make package/utun2/compile -j$J V=s 2>&1 | tail -10
+
+# --- Show result ---
+IPK=$(find bin/packages -name "utun_*.ipk" 2>/dev/null | head -1)
+if [ -n "$IPK" ]; then
+    echo ""
+    echo "============================================"
+    echo "  BUILD SUCCESS!"
+    echo "  Package: $IPK"
+    echo "  Size:    $(du -h "$IPK" | cut -f1)"
+    echo "============================================"
+else
+    echo ""
+    echo "ERROR: Package not found. Check build log above."
+    # Try to find any built binary
+    find bin -name "utun*" 2>/dev/null
+    exit 1
+fi
@@ -1,225 +0,0 @@
-$(cat /home/vnc1/proj/utun3/changelog.txt)
-
-Sun Jan 18 2026 13:12
-Removed duplicate parse_ip_port from config_parser.c
- Unused parse_ip_port in config_parser.c (lines 70-86)
- Function was static and never called (confirmed by ripgrep)
- kept working version in etcp_connections.c (used by init_connections)
- Kept net_emulator version (separate tool, not a duplication)
-
-Sun Jan 19 2026 13:00: Migrate to GNU Autotools (autoconf/automake)
-
-CHANGES:
-
-1. Created GNU Autotools build system:
-   - configure.ac: Main autoconf configuration
-   - Makefile.am: Root automake configuration
-   - src/Makefile.am: Main program build rules
-   - u_async/Makefile.am: u_async library build
-   - tests/Makefile.am: Test suite configuration
-   - autogen.sh: Bootstrap script
-   - .gitignore: Updated for autotools
-
-2. Build system features:
-   ✓ Standard ./configure && make workflow
-   ✓ make check for running tests
-   ✓ make install for installation
-   ✓ make dist for release tarballs
-   ✓ Proper dependency tracking
-   ✓ Cross-platform compatibility
-
-3. Configuration features:
-   - Checks for TUN/TAP support
-   - Requires libcrypto (OpenSSL)
-   - Detects standard headers/functions
-   - Configurable debug output
-   - Customizable installation paths
-
-USAGE:
-  ./autogen.sh          # Bootstrap (first time)
-  ./configure           # Configure build
-  make                  # Build
-  make check            # Run tests
-  sudo make install     # Install
-
-COMPATIBILITY:
-  • Old Makefile removed (renamed to Makefile.old)
-  • All build functionality preserved
-  • Test suite fully integrated
-  • Backward compatible with existing code
-
-Sun Jan 19 2026 12:15: Task 4 Completed - fprintf → Debug System
-
-CHANGES:
-
-Replaced all fprintf(stderr) with DEBUG macros:
-  • utun.c:              27 replacements
-  • config_parser.c:      7 replacements
-  • etcp_connections.c:  13 replacements
-  • etcp.c:               1 replacement
-  • tun_if.c:             3 replacements
-  • utun_instance.c:      9 replacements
-  • utun_route_fix.c:     1 replacement
-  ────────────────────────────────────────
-  TOTAL:                 60 replacements
-
-Categories used:
-  DEBUG_ERROR() with categories:
-    - DEBUG_CATEGORY_ETCP (ETCP protocol errors)
-    - DEBUG_CATEGORY_TUN (TUN interface errors)
-    - DEBUG_CATEGORY_CONFIG (Configuration errors)
-    - DEBUG_CATEGORY_ROUTING (Routing errors)
-    - DEBUG_CATEGORY_MEMORY (Memory/system errors)
-  
-  DEBUG_WARNING() for non-critical warnings
-
-All files updated with #include "debug_config.h"
-Debug output now controllable via debug config system.
-
-Sun Jan 19 2026 11:00: Task 2 Finalized - Remaining typedefs fixed
-
-COMPLETED:
-  • Fixed broken typedef in etcp.h (struct UTUN_INSTANCE*)
-  • Removed etcp_t typedef (now struct ETCP_CONN)
-  • Updated all usages across etcp.c and test files
-
-RESULTS:
-  • Total typedef structs: 4 remaining (all in ll_queue.h - u_async)
-  • 24 of 28 typedefs removed (86%)
-  • Code now follows AGENTS.md struct naming conventions
-
-Sun Jan 19 2026 10:30: Task 3 Completed - Legacy Test Cleanup
-
-CHANGES:
-
-1. Removed 7 obsolete test files:
-   - test_connection.c, test_connection_stress.c (conn_handle_t)
-   - test_sc_lib.c, test_udp_secure.c, test_utun_fork.c (sc_lib)
-   - test_utun_integration.c, test_full_stack.c (mixed legacy)
-
-2. Updated Makefile:
-   - Removed TEST_*_OBJS variables for deleted tests
-   - Removed build rules for deleted tests
-   - Removed from 'all' target (down to 10 tests from 16)
-   - Kept SC_LIB_OBJS (secure_channel/crc32, still needed)
-
-3. Updated 4 test files to new API:
-   - Replaced epkt_t* with struct ETCP_CONN*
-   - Replaced etcp_init() with etcp_create()
-   - Replaced conn_handle_t* with struct ETCP_SOCKET* (test_new_features.c)
-
-RESULTS:
- Test codebase reduced by 50% (7 of 14 test files removed)
- No remaining references to connection.h in tests
- No remaining references to sc_lib in test code
- Can now focus on current API for testing
-
-Sun Jan 19 2026 10:30: Code Style Refactoring Part 4 - secure_channel and utun_instance
-
-CHANGES:
-
-1. **secure_channel.h and secure_channel.c**
-   - Changed typedef struct {..} secure_channel_t to struct secure_channel {..}
-   - Updated all function signatures
-
-2. **utun_instance.h**
-   - Changed typedef struct utun_instance to struct UTUN_INSTANCE
-   - Updated function signatures
-
-3. **Multiple files updated**
-   - Replaced all utun_instance_t with struct UTUN_INSTANCE*
-   - Replaced all etcp_socket_t with struct ETCP_SOCKET*
-
-RESULTS:
- Reduced typedef struct from 8 to 6 across codebase
- All new structures (created after project start) converted to uppercase pattern
- Only remaining: 2 in etcp.h (etcp_t, utun_instance_t), 4 in ll_queue.h (u_async)
-
-Progress: 28 → 6 typedef structs removed (78% complete)
-Files affected: 11 header files, 8 source files
-
-Sun Jan 18 2026 19:45: Code Style Refactoring Part 2 - More struct replacements
-
-CHANGES:
-
-1. **etcp_sockets.h**
-   - Removed legacy conn_handle_t (deprecated connection handle)
-   - Changed typedef struct etcp_socket to struct etcp_socket
-   - Updated callback signatures to use struct packet_buffer*
-
-2. **tun_if.h and tun_if.c**
-   - Changed typedef struct {..} tun_config_t to struct tun_config {..}
-   - Updated all function signatures
-
-3. **pkt_normalizer.h and pkt_normalizer.c**
-   - Removed typedef struct pn_struct pn_struct (forward decl)
-   - Removed typedef struct pkt_normalizer_pair pkt_normalizer_pair (forward decl)
-   - Changed struct definitions to use struct STRUCT_NAME pattern
-   - Updated all function signatures
-
-RESULTS:
- Reduced typedef struct from 28 to 18 (completed 10/28)
- Removed 3 forward declaration typedefs
- Updated 6 files total in this batch
-
-Remaining: 18 typedef structs in 6 files
-
-Sun Jan 18 2026 12:15: Config Parser Updated for utun_test.cfg Format
-
-CHANGES:
-
-1. **Config Parser (config_parser.c)**
-   - Added support for link=server:ip:port format in [client:] sections
-   - Each link= line creates separate client entry automatically
-   - Added SECTION_ROUTING for [routing] section (ignored for now)
-   - Fixed client name preservation across multiple links
-   - Prevent adding empty clients on EOF
-
-2. **utun_test.cfg (master config)**
-   - Updated to use new link= format for multiple connections
-   - Format: link=server_name:remote_ip:remote_port
-   - Example: link=wired1_fast:192.168.0.20:1234
-
-3. **Test Results**
-   - Successfully parses 2 servers + 4 clients from utun_test.cfg
-   - init_connections correctly creates ETCP instances and links
-   - Socket creation fails only due to non-local IPs (expected)
-
-CONFIGURATION FILES:
- utun_test.cfg: master config with new format
- test_server.conf, test_client.conf: removed (no longer needed)
-
-Sun Jan 19 2026 13:09
-Removed duplicate init_connections from utun.c
- Deleted utun_state_t and all related legacy code
- Rewrote main() to use UTUN_INSTANCE API
- Removed 103 lines of obsolete code
-Sun Jan 19 2026 13:24
-Fixed build - removed typedefs from ll_queue and packet_pool
- Updated ll_queue.h/.c to use struct instead of typedef
- Added struct definition for UTUN_INSTANCE fields
- Fixed memory_pool and packet_pool typedefs
-Sun Jan 19 2026 13:57
-Removed config file parsing from debug_config
- Removed debug_parse_config_file() and auto-reload functionality
-Sun Jan 19 2026 14:01
-Moved mainloop from utun_instance to main
- utun_instance_run() now does single iteration
- Added tun_read_callback to utun_instance
- Added utun_instance_register_sockets()
-Sun Jan 19 2026 14:02
-Build successful - all refactoring complete
-Sun Jan 19 2026 14:19
-Final: Build successful with refactored architecture
-Sun Jan 19 2026 14:26
-Refactoring complete - utun binary ready
-2026-01-18 16:38:15
-Добавлен config_updater.c/h - автоматическая генерация ключей и node_id при запуске
-2026-01-18 17:17:40: secure_channel - переделана генерация nonce на SHA256(64bit urandom + 64bit counter + 32bit utime), счетчики расширены до 64bit
-2026-01-18 17:22:28: sha256.c/h перемещены из src/ в lib/
-2026-01-18 18:17:37: Упрощена структура ETCP_CONNECTIONS - встроено uasync_add_socket, удалены обертки socket-функций
-2026-01-18 19:32:55: Встроено шифрование и дешифрование в etcp_link_send и etcp_input. Добавлены счетчики ошибок и статистика.
-2026-01-18 19:37:40: Имплементация шифрования завершена. Добавлена поддержка secure channel с AES-CCM, nonce и счетчиками. pubkey в конце INIT-пакетов. Клиенты загружают peer_public_key из конфига.
-2026-01-18 20:38:35: Fixed etcp_link_new call, added etcp_socket_read_callback for uasync integration.
-2026-01-18 21:20:56: Финальный отчет: Реально встроено шифрование с AES-CCM в etcp_link_send и etcp_input. Добавлены тесты.
-2026-01-18 22:00:59: Fix critical bug: sc_derive_shared_key called inside sc_set_peer_public_key. Correct order for INIT: pubkey, derive, decrypt. Added peer_public_key for clients.
@@ -0,0 +1,60 @@
+@echo off
+setlocal EnableDelayedExpansion
+
+echo ==========================================
+echo uTun Test Suite - Windows
+echo ==========================================
+echo.
+
+set "TESTS_DIR=tests"
+set "LOGS_DIR=tests\logs"
+set "PASSED=0"
+set "FAILED=0"
+set "TOTAL=0"
+
+:: Create logs directory if not exists
+if not exist "%LOGS_DIR%" mkdir "%LOGS_DIR%"
+
+:: List of all test executables
+set "TEST_LIST=test_etcp_crypto test_crypto test_etcp_two_instances test_etcp_simple_traffic test_etcp_minimal test_etcp_100_packets test_pkt_normalizer_etcp test_pkt_normalizer_standalone test_etcp_api test_ll_queue test_ecc_encrypt test_intensive_memory_pool test_memory_pool_and_config test_packet_dump test_u_async_comprehensive test_u_async_performance test_debug_categories test_config_debug test_route_lib test_bgp_route_exchange bench_timeout_heap bench_uasync_timeouts"
+
+echo Running tests...
+echo.
+
+for %%t in (%TEST_LIST%) do (
+    set /a TOTAL+=1
+    set "TEST_EXE=%TESTS_DIR%\%%t.exe"
+    set "LOG_FILE=%LOGS_DIR%\%%t.log"
+    
+    if exist "!TEST_EXE!" (
+        echo [RUN] %%t.exe
+        "!TEST_EXE!" > "!LOG_FILE!" 2>&1
+        if !ERRORLEVEL! equ 0 (
+            echo [PASS] %%t.exe
+            set /a PASSED+=1
+        ) else (
+            echo [FAIL] %%t.exe ^(exit code: !ERRORLEVEL!^)
+            set /a FAILED+=1
+        )
+    ) else (
+        echo [SKIP] %%t.exe ^(not found^)
+    )
+)
+
+echo.
+echo ==========================================
+echo Test Summary
+echo ==========================================
+echo Total:  %TOTAL%
+echo Passed: %PASSED%
+echo Failed: %FAILED%
+echo.
+
+if %FAILED% equ 0 (
+    echo All tests PASSED!
+    exit /b 0
+) else (
+    echo Some tests FAILED!
+    echo Check logs in %LOGS_DIR% for details
+    exit /b 1
+)
@@ -0,0 +1,32 @@
+#!/bin/bash
+set -eo pipefail
+cd "$(dirname "$0")"
+
+LAST=0; [ -f .check_time ] && read -r LAST < .check_time
+TMO=$(( LAST + 30 ))
+[ $TMO -lt 90 ] && TMO=90
+
+START=$(date +%s)
+TMP=$(mktemp)
+timeout $TMO make check -j4 > "$TMP" 2>&1 || {
+    tail -40 "$TMP"; rm -f "$TMP"
+    [ $(date +%s) -ge $((START + TMO)) ] && echo "TIMEOUT (${TMO}s)" >&2
+    exit 1
+}
+grep -E '\[PASS|\[FAIL|\[SKIP|Test Results|Failed tests|Log directory|^====' "$TMP"
+rm -f "$TMP"
+
+# Интеграционный тест tcp_proxy_full (требует sudo; без passwordless sudo — пропускаем)
+echo ""
+if [ "$(id -u)" -eq 0 ]; then
+    make -C tests check-proxy
+elif command -v sudo >/dev/null 2>&1 && sudo -n true 2>/dev/null; then
+    echo "=== tcp_proxy_full integration test (sudo) ==="
+    sudo -n make -C tests check-proxy
+else
+    echo "[SKIP] tcp_proxy_full integration test (requires passwordless sudo)"
+fi
+
+ELAPSED=$(( $(date +%s) - START ))
+echo "Time: ${ELAPSED}s"
+echo "$ELAPSED" > .check_time
@@ -0,0 +1,67 @@
+# cm_invite_pending — утечка указателей и corruption при destroy
+
+## Корень проблемы
+
+У `cm_invite_pending` три внешних держателя указателя в разных подсистемах:
+
+  uasync heap (overall_timer) → node->arg = inv
+  NCD (node_conn_direct)     → arg = inv в cm_invite_ncd_callback
+  STCP (stcp_link)           → arg = inv в cm_tcp_ready_cb
+
+Когда cm_invite_cancel делает u_free(inv), коллбэки от уже запланированных
+событий приходят после освобождения → пишут в переиспользованную память →
+corruption (float-значения в полях mgr/node_id).
+
+## Решение
+
+1. Поле uint8_t cancelled:1 в struct cm_invite_pending
+   (рядом с tcp_ready:1 в conn_mgr_priv.h)
+
+2. cm_invite_cancel:
+   - inv->cancelled = 1 первой же строкой
+   - отмена таймера, закрытие ncd/tcp handles
+   - удаление из invite_list
+   - uasync_post(ua, cm_invite_free_deferred, inv) вместо немедленного u_free
+
+3. Все коллбэки — guard первой строкой:
+   void cm_invite_ncd_callback(..., void* arg) {
+       struct cm_invite_pending* inv = arg;
+       if (inv->cancelled) return;
+       ...
+   }
+
+4. cm_invite_fail:
+   - if (inv->cancelled) return
+   - сохранить cb/handle/node_id/group_id ДО вызова cm_invite_cancel
+   - cm_invite_cancel(inv)  (cancelled=1, deferred free)
+   - cb(handle, ...)        (коллбэк после cancel, inv ещё жив)
+   - u_free(handle)
+
+## Почему корректно
+
+  cm_invite_cancel:
+    inv->cancelled = 1       ← блокировка коллбэков (однопоточно, немедленно)
+    uasync_cancel_timeout    ← таймер удалён из heap
+    node_conn_direct_close   ← handle закрыт
+    uasync_post(free, inv)   ← освобождение в конец очереди событий
+
+  [уже запланированные коллбэки]:
+    if (inv->cancelled) return  ← выход без действий
+
+  [deferred free]:
+    u_free(inv)                 ← все коллбэки уже отработали
+
+## Краевые случаи
+
+  conn_mgr_destroy → cm_invite_cancel:
+    Отмена таймера, закрытие handles, deferred free. Ни один коллбэк
+    не дёрнет освобождённую память.
+
+  NCD/STCP коллбэк после cancel:
+    cancelled=1 → мгновенный return.
+
+  Таймаут приглашения после cancel:
+    cancelled=1 → return, не вызывает cm_invite_fail повторно.
+
+  uasync_destroy до deferred free:
+    inv утекает при shutdown (приемлемо).
@@ -4,23 +4,169 @@ AC_CONFIG_HEADERS([config.h])
 AC_CONFIG_AUX_DIR([build-aux])
 AC_CONFIG_MACRO_DIR([m4])

+# === ОБЯЗАТЕЛЬНО для правильного определения host ===
+AC_CANONICAL_HOST
+AC_CANONICAL_BUILD
+
 # Required programs
 AC_PROG_CC
 AC_PROG_RANLIB
 AM_PROG_AR
-AM_INIT_AUTOMAKE([foreign subdir-objects -Wall -Werror])
+AM_INIT_AUTOMAKE([foreign subdir-objects -Wall])

-# Checks for programs
 AC_PROG_INSTALL
 AC_PROG_MAKE_SET

-# Checks for libraries
-AC_CHECK_LIB([crypto], [SHA256_Init], [], [AC_MSG_ERROR([OpenSSL crypto library required])])
+# Option to use OpenSSL
+AC_ARG_WITH([openssl],
+    AS_HELP_STRING([--with-openssl], [Use OpenSSL for cryptography (default: yes)]),
+    [with_openssl=$withval],
+    [with_openssl=yes])

-# Checks for header files
-AC_CHECK_HEADERS([arpa/inet.h fcntl.h limits.h netinet/in.h stdlib.h string.h sys/ioctl.h sys/socket.h unistd.h])
+if test "x$with_openssl" = "xyes"; then
+    # MSYS2 OpenSSL paths (для Windows)
+    case "$host" in
+        *mingw* | *msys* | *cygwin* | *win*)
+            if test -d "/c/msys64/ucrt64/include/openssl"; then
+                OPENSSL_CFLAGS="-I/c/msys64/ucrt64/include"
+                OPENSSL_LIBS="-L/c/msys64/ucrt64/lib -lcrypto"
+                AC_MSG_NOTICE([Using MSYS2 UCRT64 OpenSSL])
+            elif test -d "/ucrt64/include/openssl"; then
+                OPENSSL_CFLAGS="-I/ucrt64/include"
+                OPENSSL_LIBS="-L/ucrt64/lib -lcrypto"
+                AC_MSG_NOTICE([Using MSYS2 UCRT64 OpenSSL])
+            elif test -d "/mingw64/include/openssl"; then
+                OPENSSL_CFLAGS="-I/mingw64/include"
+                OPENSSL_LIBS="-L/mingw64/lib -lcrypto"
+                AC_MSG_NOTICE([Using MSYS2 MINGW64 OpenSSL])
+            fi
+            CFLAGS="$CFLAGS $OPENSSL_CFLAGS"
+            LDFLAGS="$LDFLAGS $OPENSSL_LIBS"
+            ;;
+    esac

-# Checks for typedefs, structures, and compiler characteristics
+    save_LIBS="$LIBS"
+    LIBS="-lcrypto $LIBS"
+    AC_CHECK_LIB([crypto], [SHA256_Init],
+        [AC_DEFINE([USE_OPENSSL], [1], [Define to use OpenSSL for cryptography])],
+        [AC_MSG_ERROR([OpenSSL crypto library required. Use --without-openssl to use TinyCrypt.])])
+    LIBS="$save_LIBS"
+fi
+
+AM_CONDITIONAL([USE_OPENSSL], [test "x$with_openssl" = "xyes"])
+
+# ==================== HARDENING ====================
+AC_ARG_ENABLE([hardening],
+    AS_HELP_STRING([--enable-hardening], [Enable compiler security hardening (FORTIFY, stack protector, PIE, RELRO)]),
+    [enable_hardening=$enableval],
+    [enable_hardening=no])
+
+if test "x$enable_hardening" = "xyes"; then
+    HARDEN_CFLAGS="-D_FORTIFY_SOURCE=2 -fstack-protector-strong -fstack-clash-protection -Wformat=2 -Wformat-overflow=2 -fPIE"
+    HARDEN_LDFLAGS="-Wl,-z,relro -Wl,-z,now -pie"
+    CFLAGS="$CFLAGS $HARDEN_CFLAGS"
+    LDFLAGS="$LDFLAGS $HARDEN_LDFLAGS"
+    AC_MSG_NOTICE([Hardening flags enabled: $HARDEN_CFLAGS])
+fi
+
+# ==================== НАДЁЖНЫЙ ДЕТЕКТ WINDOWS ====================
+AC_MSG_CHECKING([for Windows])
+AC_COMPILE_IFELSE([AC_LANG_PROGRAM([[
+#ifndef _WIN32
+#error "Not Windows"
+#endif
+]], [[ return 0; ]])],
+    [os_windows=yes],
+    [os_windows=no])
+AC_MSG_RESULT([$os_windows])
+
+AM_CONDITIONAL([OS_WINDOWS], [test "x$os_windows" = "xyes"])
+
+# ==================== DETECT FREEBSD ====================
+AC_MSG_CHECKING([for FreeBSD])
+AC_COMPILE_IFELSE([AC_LANG_PROGRAM([[
+#ifndef __FreeBSD__
+#error "Not FreeBSD"
+#endif
+]], [[ return 0; ]])],
+    [os_freebsd=yes],
+    [os_freebsd=no])
+AC_MSG_RESULT([$os_freebsd])
+
+AM_CONDITIONAL([OS_FREEBSD], [test "x$os_freebsd" = "xyes"])
+
+# Set TUN libs based on platform
+if test "x$os_windows" = "xyes"; then
+    TUN_LIBS="-liphlpapi -lws2_32 -ladvapi32 -lbcrypt -ldbghelp"
+else
+    TUN_LIBS=""
+fi
+AC_SUBST([TUN_LIBS])
+
+# ==================== WHISPER (OPTIONAL) ====================
+AC_ARG_WITH([whisper],
+    AS_HELP_STRING([--with-whisper], [Enable Whisper speech-to-text (requires libwhisper)]),
+    [with_whisper=$withval],
+    [with_whisper=no])
+
+if test "x$with_whisper" = "xyes"; then
+    AC_CHECK_HEADER([whisper.h], [
+        AC_CHECK_LIB([whisper], [whisper_init_from_file_with_params], [
+            WHISPER_LIBS="-lwhisper -lggml -lggml-base"
+            AC_DEFINE([HAVE_WHISPER], [1], [Define to enable Whisper speech-to-text])
+            AC_MSG_NOTICE([Whisper enabled])
+        ], [
+            AC_MSG_WARN([libwhisper not found, disabling whisper])
+            with_whisper=no
+        ])
+    ], [
+        AC_MSG_WARN([whisper.h not found, disabling whisper])
+        with_whisper=no
+    ])
+fi
+AM_CONDITIONAL([HAVE_WHISPER], [test "x$with_whisper" = "xyes"])
+AC_SUBST([WHISPER_LIBS])
+
+# ==================== FFMPEG (OPTIONAL) ====================
+AC_ARG_WITH([ffmpeg],
+    AS_HELP_STRING([--with-ffmpeg], [Enable video transcoding (requires FFmpeg libav libraries)]),
+    [with_ffmpeg=$withval],
+    [with_ffmpeg=no])
+
+if test "x$with_ffmpeg" = "xyes"; then
+    save_LIBS="$LIBS"
+    FFMPEG_LIBS="-lavformat -lavcodec -lavutil -lswscale -lswresample"
+    LIBS="$FFMPEG_LIBS $LIBS"
+    AC_CHECK_HEADER([libavformat/avformat.h], [
+        AC_CHECK_HEADER([libavcodec/avcodec.h], [
+            AC_CHECK_HEADER([libavutil/imgutils.h], [
+                AC_CHECK_HEADER([libswscale/swscale.h], [
+                    AC_CHECK_HEADER([libswresample/swresample.h], [
+                        AC_CHECK_LIB([avformat], [avformat_open_input], [
+                            AC_DEFINE([HAVE_FFMPEG], [1], [Define to enable FFmpeg video transcoding])
+                            AC_MSG_NOTICE([FFmpeg enabled])
+                        ], [
+                            AC_MSG_WARN([FFmpeg libs not found, disabling ffmpeg])
+                            with_ffmpeg=no
+                        ])
+                    ], [AC_MSG_WARN([swresample.h not found, disabling ffmpeg]); with_ffmpeg=no])
+                ], [AC_MSG_WARN([swscale.h not found, disabling ffmpeg]); with_ffmpeg=no])
+            ], [AC_MSG_WARN([imgutils.h not found, disabling ffmpeg]); with_ffmpeg=no])
+        ], [AC_MSG_WARN([avcodec.h not found, disabling ffmpeg]); with_ffmpeg=no])
+    ], [AC_MSG_WARN([avformat.h not found, disabling ffmpeg]); with_ffmpeg=no])
+    LIBS="$save_LIBS"
+fi
+
+if test "x$with_ffmpeg" != "xyes"; then
+    FFMPEG_LIBS=""
+    FFMPEG_CFLAGS=""
+fi
+AM_CONDITIONAL([HAVE_FFMPEG], [test "x$with_ffmpeg" = "xyes"])
+AC_SUBST([FFMPEG_LIBS])
+AC_SUBST([FFMPEG_CFLAGS])
+
+# Checks for header files, typedefs, functions...
+AC_CHECK_HEADERS([arpa/inet.h fcntl.h limits.h netinet/in.h stdint.h stdlib.h string.h sys/ioctl.h sys/socket.h unistd.h])
 AC_TYPE_SIZE_T
 AC_TYPE_SSIZE_T
 AC_TYPE_UINT16_T
@@ -29,41 +175,26 @@ AC_TYPE_UINT64_T
 AC_TYPE_UINT8_T
 AC_C_INLINE

-# Checks for library functions
 AC_FUNC_MALLOC
 AC_CHECK_FUNCS([gettimeofday memset socket strchr strdup strerror strstr])

-# Check for TUN/TAP support
+# TUN/TAP (только для Linux)
 AC_MSG_CHECKING([for TUN/TAP support])
-AC_COMPILE_IFELSE([AC_LANG_PROGRAM([[
-#include <linux/if_tun.h>
-]], [[
-int fd = open("/dev/net/tun", O_RDWR);
-]])], [
-  AC_MSG_RESULT([yes])
-  AC_DEFINE([HAVE_TUN_TAP], [1], [Define if TUN/TAP is available])
-], [
-  AC_MSG_RESULT([no])
-])
-
-# Output files
-AC_CONFIG_FILES([
-  Makefile
-  src/Makefile
-  tests/Makefile
-  lib/Makefile
-])
+AC_COMPILE_IFELSE([AC_LANG_PROGRAM([[#include <linux/if_tun.h>]], [[int fd = open("/dev/net/tun", O_RDWR);]])],
+    [AC_MSG_RESULT([yes]); AC_DEFINE([HAVE_TUN_TAP], [1], [Define if TUN/TAP is available])],
+    [AC_MSG_RESULT([no])])

+# Output
+AC_CONFIG_FILES([Makefile src/Makefile tests/Makefile lib/Makefile lib/libopus/Makefile])
 AC_OUTPUT

 # Summary
 echo "
 Configuration summary:
 ----------------------
+  Host:         ${host}
+  Windows:      ${os_windows}
  Prefix:       ${prefix}
  Compiler:     ${CC}
  CFLAGS:       ${CFLAGS}
-  
-  Features:
-    TUN/TAP:    ${have_tun_tap}
-"
+"
@@ -0,0 +1,285 @@
+#!/bin/bash
+# cross-build-win.sh — кросс-компиляция uTun для Windows 10 из Linux
+# Использование: ./cross-build-win.sh [--clean]
+set -euo pipefail
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+step()  { echo -e "${CYAN}===${NC} $*"; }
+ok()    { echo -e "${GREEN}[OK]${NC} $*"; }
+warn()  { echo -e "${YELLOW}[WARNING]${NC} $*"; }
+fatal() { echo -e "${RED}FATAL:${NC} $*" >&2; exit 1; }
+
+trap 'fatal "script failed at line $LINENO (exit code: $?)"' ERR
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+BUILD_DIR="$SCRIPT_DIR/build-win"
+PREFIX="$BUILD_DIR/prefix"
+
+MINGW_CC="x86_64-w64-mingw32-gcc"
+MINGW_AR="x86_64-w64-mingw32-ar"
+MINGW_RANLIB="x86_64-w64-mingw32-ranlib"
+
+MINGW_PKGS="gcc-mingw-w64-x86-64-posix g++-mingw-w64-x86-64-posix"
+OPENSSL_VER="3.0.16"
+OPENSSL_URL="https://github.com/openssl/openssl/releases/download/openssl-${OPENSSL_VER}/openssl-${OPENSSL_VER}.tar.gz"
+
+# -------------------------------------------------------------------
+# 0. Аргументы
+# -------------------------------------------------------------------
+CLEAN=0
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --clean) CLEAN=1; shift ;;
+        *) fatal "unknown option: $1" ;;
+    esac
+done
+
+if [ "$CLEAN" -eq 1 ]; then
+    echo -e "${YELLOW}Cleaning build directory: $BUILD_DIR${NC}"
+    rm -rf "$BUILD_DIR"
+fi
+
+echo -e "${CYAN}==============================================${NC}"
+echo -e "${CYAN}  uTun Cross-Compilation for Windows 10${NC}"
+echo -e "${CYAN}==============================================${NC}"
+echo ""
+
+# -------------------------------------------------------------------
+# 1. Проверка системы
+# -------------------------------------------------------------------
+step "Checking system..."
+if [ "$(uname -s)" != "Linux" ]; then
+    fatal "This script only runs on Linux. Detected: $(uname -s)"
+fi
+if [ "$(uname -m)" != "x86_64" ]; then
+    fatal "This script requires x86_64 architecture. Detected: $(uname -m)"
+fi
+
+if ! command -v apt-get &>/dev/null; then
+    fatal "apt-get not found. Only Debian/Ubuntu are supported."
+fi
+ok "System: Linux x86_64 with apt"
+
+# -------------------------------------------------------------------
+# 2. Установка пакетов
+# -------------------------------------------------------------------
+step "Installing required packages..."
+
+need_install=()
+for pkg in $MINGW_PKGS; do
+    if ! dpkg -s "$pkg" &>/dev/null 2>&1; then
+        need_install+=("$pkg")
+    fi
+done
+if ! command -v wget &>/dev/null && ! command -v curl &>/dev/null; then
+    need_install+=("wget")
+fi
+
+if [ ${#need_install[@]} -gt 0 ]; then
+    echo "  Installing: ${need_install[*]}"
+    sudo apt-get update -qq || fatal "apt-get update failed"
+    sudo apt-get install -y -qq "${need_install[@]}" || fatal "apt-get install failed"
+    ok "Packages installed: ${need_install[*]}"
+else
+    ok "All packages already installed"
+fi
+
+# Проверка компилятора
+for tool in "$MINGW_CC" "$MINGW_AR" "$MINGW_RANLIB"; do
+    if ! command -v "$tool" &>/dev/null; then
+        fatal "$tool not found after package installation"
+    fi
+done
+ok "Cross-compiler: $($MINGW_CC --version | head -1)"
+
+# -------------------------------------------------------------------
+# 3. Кросс-компиляция OpenSSL
+# -------------------------------------------------------------------
+OPENSSL_SRC="$BUILD_DIR/openssl-${OPENSSL_VER}"
+LIBCRYPTO="$PREFIX/lib/libcrypto.a"
+
+if [ -f "$LIBCRYPTO" ]; then
+    ok "OpenSSL already built: $LIBCRYPTO"
+else
+    step "Building OpenSSL ${OPENSSL_VER} for Windows..."
+
+    mkdir -p "$BUILD_DIR"
+
+    TARBALL="$BUILD_DIR/openssl-${OPENSSL_VER}.tar.gz"
+    if [ ! -f "$TARBALL" ]; then
+        echo "  Downloading OpenSSL ${OPENSSL_VER}..."
+        if command -v wget &>/dev/null; then
+            wget -q --show-progress -O "$TARBALL" "$OPENSSL_URL" || fatal "wget download failed for $OPENSSL_URL"
+        else
+            curl -L --progress-bar -o "$TARBALL" "$OPENSSL_URL" || fatal "curl download failed for $OPENSSL_URL"
+        fi
+        ok "Downloaded: $TARBALL"
+    fi
+
+    if [ ! -d "$OPENSSL_SRC" ]; then
+        echo "  Extracting..."
+        tar xzf "$TARBALL" -C "$BUILD_DIR" || fatal "tar extract failed"
+    fi
+
+    echo "  Configuring OpenSSL for mingw64..."
+    cd "$OPENSSL_SRC"
+    ./Configure --cross-compile-prefix=x86_64-w64-mingw32- \
+        mingw64 no-shared no-tests \
+        --prefix="$PREFIX" --libdir="$PREFIX/lib" --openssldir="$PREFIX/ssl" \
+        || fatal "OpenSSL configure failed (see output above)"
+    ok "OpenSSL configured"
+
+    echo "  Compiling OpenSSL..."
+    make -j"$(nproc)" || fatal "OpenSSL make failed"
+    echo "  Installing OpenSSL..."
+    make install_sw >/dev/null || fatal "OpenSSL make install_sw failed"
+    cd "$SCRIPT_DIR"
+
+    # OpenSSL может установить в lib64/ вместо lib/ — поправим
+    if [ ! -f "$LIBCRYPTO" ] && [ -f "$PREFIX/lib64/libcrypto.a" ]; then
+        ln -sf lib64 "$PREFIX/lib" 2>/dev/null || cp -r "$PREFIX/lib64" "$PREFIX/lib" 2>/dev/null || true
+    fi
+    if [ ! -f "$LIBCRYPTO" ]; then
+        fatal "libcrypto.a was not found at $PREFIX/lib/ or $PREFIX/lib64/"
+    fi
+    ok "OpenSSL built: $LIBCRYPTO"
+fi
+
+# -------------------------------------------------------------------
+# 4. Сборка libuasync.a
+# -------------------------------------------------------------------
+step "Building libuasync.a..."
+
+LIB_OBJDIR="$BUILD_DIR/lib-objs"
+mkdir -p "$LIB_OBJDIR"
+
+# Все .c файлы из lib/Makefile.am + myip.c (реализация get_my_ip)
+LIB_SOURCES=(
+    u_async.c ll_queue.c memory_pool.c debug_config.c timeout_heap.c
+    sha256.c mem.c serialize.c swm_min.c getmyip.c radix.c tcp_io.c
+    myip.c platform_compat.c socket_compat.c
+    liblmdb/mdb.c liblmdb/midl.c
+)
+
+LIB_CFLAGS="-D_ISOC99_SOURCE -DDEBUG_OUTPUT_STDERR -DUSE_OPENSSL"
+LIB_CFLAGS+=" -I$SCRIPT_DIR/lib -I$SCRIPT_DIR/src -I$SCRIPT_DIR/lib/liblmdb"
+LIB_CFLAGS+=" -I$PREFIX/include"
+LIB_CFLAGS+=" -g -O2 -Wno-deprecated-declarations"
+
+for src in "${LIB_SOURCES[@]}"; do
+    obj="$LIB_OBJDIR/$(basename "${src%.c}.o")"
+    echo "  CC lib/$src"
+    "$MINGW_CC" $LIB_CFLAGS -c "$SCRIPT_DIR/lib/$src" -o "$obj" \
+        || fatal "compilation failed: lib/$src"
+done
+
+"$MINGW_AR" crs "$BUILD_DIR/libuasync.a" "$LIB_OBJDIR"/*.o \
+    || fatal "ar failed for libuasync.a"
+"$MINGW_RANLIB" "$BUILD_DIR/libuasync.a" 2>/dev/null || true
+ok "libuasync.a ($(wc -c < "$BUILD_DIR/libuasync.a") bytes)"
+
+# -------------------------------------------------------------------
+# 5. Сборка объектных файлов для utun.exe
+# -------------------------------------------------------------------
+step "Compiling utun source files..."
+
+SRC_OBJDIR="$BUILD_DIR/src-objs"
+mkdir -p "$SRC_OBJDIR"
+
+# Все .c файлы из src/Makefile.am (utun_CORE_SOURCES)
+SRC_SOURCES=(
+    utun.c utun_instance.c config_parser.c config_updater.c
+    routing_layer/route_lib.c routing_layer/route6_lib.c topo_bgp.c routing_layer/route_ping.c
+    routing_layer/topo_node.c topo_node_lmdb.c routing_layer/route_connectivity.c routing_layer/conn_mgr.c
+    routing_layer/routing.c tun_if.c tun_route.c tun_linux.c tun_freebsd.c tun_windows.c
+    transport_layer/etcp.c transport_layer/etcp_connections.c transport_layer/etcp_bbr.c transport_layer/etcp_loadbalancer.c
+    transport_layer/etcp_debug.c transport_layer/etcp_dump.c transport_layer/secure_channel.c transport_layer/crc32.c
+    transport_layer/stcp_link.c transport_layer/stcp.c transport_layer/stcp_server.c transport_layer/stcp_client.c
+    transport_layer/pkt_normalizer.c transport_layer/packet_dump.c transport_layer/etcp_api.c
+    control_server.c
+    firewall.c eim_nat.c nat_transport.c transport_layer/dummynet.c
+    etcp_router.c route_crypto.c
+    proxy/udp_proxy.c proxy/socks_proxy.c
+    lwip_tcp/lwip_pbuf.c
+)
+
+SRC_CFLAGS="-DUSE_OPENSSL"
+SRC_CFLAGS+=" -I$SCRIPT_DIR/src -I$SCRIPT_DIR/lib -I$SCRIPT_DIR/lib/liblmdb"
+SRC_CFLAGS+=" -I$SCRIPT_DIR/src/transport_layer -I$SCRIPT_DIR/src/routing_layer"
+SRC_CFLAGS+=" -I$SCRIPT_DIR/tinycrypt/lib/include -I$SCRIPT_DIR/tinycrypt/lib/source"
+SRC_CFLAGS+=" -I$PREFIX/include"
+SRC_CFLAGS+=" -g -O2 -Wno-deprecated-declarations"
+
+TOTAL=${#SRC_SOURCES[@]}
+CURRENT=0
+FAILED=()
+
+for src in "${SRC_SOURCES[@]}"; do
+    CURRENT=$((CURRENT + 1))
+    # Имя объектного файла: заменяем / на _ (для proxy/ и lwip_tcp/)
+    obj_name="$(echo "$src" | tr '/' '_')"
+    obj="$SRC_OBJDIR/${obj_name%.c}.o"
+    printf "  [%3d/%3d] CC src/%s\n" "$CURRENT" "$TOTAL" "$src"
+    if ! "$MINGW_CC" $SRC_CFLAGS -c "$SCRIPT_DIR/src/$src" -o "$obj" 2>&1; then
+        FAILED+=("src/$src")
+    fi
+done
+
+if [ ${#FAILED[@]} -gt 0 ]; then
+    echo ""
+    fatal "compilation failed for: ${FAILED[*]}"
+fi
+ok "All $TOTAL source files compiled"
+
+# -------------------------------------------------------------------
+# 6. Линковка utun.exe
+# -------------------------------------------------------------------
+step "Linking utun.exe..."
+
+"$MINGW_CC" -o "$SCRIPT_DIR/utun.exe" \
+    "$SRC_OBJDIR"/*.o \
+    "$BUILD_DIR/libuasync.a" \
+    "$LIBCRYPTO" \
+    -lws2_32 -liphlpapi -ladvapi32 -lbcrypt -lcrypt32 -lpthread -lm \
+    -static \
+    || fatal "linking failed (see undefined references above)"
+
+ok "utun.exe ($(wc -c < "$SCRIPT_DIR/utun.exe") bytes)"
+
+# -------------------------------------------------------------------
+# 7. Копирование wintun.dll и финал
+# -------------------------------------------------------------------
+echo ""
+if [ -f "$SCRIPT_DIR/lib/wintun.dll" ]; then
+    cp "$SCRIPT_DIR/lib/wintun.dll" "$SCRIPT_DIR/"
+    ok "wintun.dll copied to project root"
+else
+    warn "wintun.dll not found in lib/ — place it manually alongside utun.exe"
+fi
+
+echo ""
+echo -e "${GREEN}==============================================${NC}"
+echo -e "${GREEN}  Build successful!${NC}"
+echo -e "${GREEN}  Binary: utun.exe${NC}"
+echo -e "${GREEN}==============================================${NC}"
+echo ""
+
+if [ -f "$SCRIPT_DIR/lib/wintun.dll" ]; then
+    echo "Run on Windows:"
+    echo "  1. Install Wintun driver (https://www.wintun.net)"
+    echo "  2. Copy utun.exe + wintun.dll to the same directory"
+    echo "  3. Run: utun.exe -f -p utun.pid -l utun.log"
+else
+    echo "Run on Windows:"
+    echo "  1. Install Wintun driver (https://www.wintun.net)"
+    echo "  2. Copy utun.exe + wintun.dll to the same directory"
+    echo "  3. Run: utun.exe -f -p utun.pid -l utun.log"
+fi
+echo ""
+
+exit 0
@@ -0,0 +1,199 @@
+# P2P аудио-звонок пользователю — архитектура
+
+Статус: спроектировано, ждёт реализации.
+
+## 1. Область
+
+Голос 1:1. Звонок можно инициировать **из CHAT-группы или из p2p-чата (DM)** — модуль
+не привязан к типу группы: он оперирует `group_id` + `peer_node_id` (для DM `group_id` —
+DM-группа, маршрутизация через `etcp_router` идентична). Протокол расширяем под видео
+(track-модель), реализуется только аудио. Работает desktop↔desktop и desktop↔android
+(обе стороны компилируют общий стек `etcp_router` / `topo_group` (BGP) / `conn_mgr`).
+
+Полный цикл: проверка онлайна (BGP) → INVITE → звонок → ACCEPT/DECLINE →
+установка соединения (conn_mgr) → аудиопоток → HANGUP.
+
+## 2. Разбиение файлов (отдельный каталог `src/call/`)
+
+| Файл | Язык | Сборки | Назначение |
+|---|---|---|---|
+| `src/call/call_proto.h` | C | везде | wire-формат, subcmd, svc_id `ETCP_RT_ID_CALL 0x34` |
+| `src/call/call.h` / `call.c` | C | везде (autotools + GUI) | сигналинг, реестр сессий, таймеры, watchdog (20с по приёму), релей медиа с backpressure, счётчики |
+| `src/call/call_audio.h/c` | C | только GUI-сборки | Opus encode/decode, фрейминг, pull-обвязка с тонами; регистрация через `call_audio_ops` |
+| `src/call/call_tones.h/c` | C | только GUI-сборки | генератор тонов (glitch/ended), синус |
+| `src/call/audio_jitter.h/cpp` | C++ | только GUI-сборки | SoundTouch джиттер-буфер, C API |
+
+Autotools-сборка демона остаётся C-only (`.cpp` не компилируется); сигналинг `call.c`
+присутствует и в демоне, аудиопроцессинг — только там, где есть GUI.
+
+Новая категория логирования: `DEBUG_CATEGORY_CALL = 31` (добавить в `debug_config.h`,
+`DEBUG_CATEGORY_COUNT` → 32).
+
+## 3. Протокол (svc_id 0x34, первый байт payload = subcmd)
+
+Формат приёма (как media_delivery, одноуровневый): `entry->dgram[0]=svc_id`,
+`entry->dgram[1]=subcmd`, `entry->dgram[2..]=payload`.
+
+```
+CALL_INVITE  0x01 {call_id:8, group_id:8, tracks:[{type:AUDIO, codec:OPUS, sr:4, ch:1, bitrate:4}]}
+CALL_RINGING 0x02 {call_id:8}
+CALL_ACCEPT  0x03 {call_id:8, agreed_tracks}
+CALL_DECLINE 0x04 {call_id:8, reason:1}
+CALL_BUSY    0x05 {call_id:8}
+CALL_CANCEL  0x06 {call_id:8}
+CALL_HANGUP  0x07 {call_id:8, reason:1}
+CALL_MEDIA   0x10 {call_id:8, track_id:1, seq:2, ts_ms:4, payload}
+```
+
+- `call_id` — случайный uint64, генерит вызывающий; идентифицирует сессию на обеих сторонах.
+- `group_id` — CHAT-группа или DM-группа (общая маршрутизация).
+- Сигналинг: `etcp_route_send(..., ROUTE_CRYPTO_SIGN | ROUTE_CRYPTO_ENCRYPT)`.
+- Медиа: без подписи (уже внутри шифрованного канала etcp_router).
+- `CALL_MEDIA` — общий контейнер; `track_id` оставляет место видео (`type=VIDEO`).
+- Аудио: Opus 48kHz mono, 20ms (960 сэмплов), ~24–32 kbps. ~50 кадров/с.
+
+## 4. Машина состояний
+
+```
+Caller: IDLE → OUTGOING(INVITE) → RINGING(RINGING) → CONNECTING(ACCEPT, conn_mgr_open) → ACTIVE → ENDED
+Callee: IDLE → INCOMING(INVITE) → RINGING(sent RINGING) → ACCEPTING(accept, conn_mgr_open) → ACTIVE → ENDED
+```
+
+`ENDED` reasons: `LOCAL_HANGUP / REMOTE_HANGUP / DECLINE / BUSY / CANCEL /
+NO_TRAFFIC / RING_TIMEOUT / CONNECT_FAIL`.
+
+Таймауты:
+- ring-timeout 45с (нет ответа → CANCEL);
+- connect: `conn_mgr` `CONN_EVENT_TIMEOUT` → fail;
+- **NO_TRAFFIC 20с** — нет входящих медиа-кадров → авто HANGUP.
+
+Онлайн-проверка: `topo_node_find_by_id(group, peer) == NULL` → «не в сети» (event).
+
+Соединение: на ACCEPT обе стороны `conn_mgr_open(inst, group_id, peer, cb, ...)`;
+`CONN_EVENT_UP` → ACTIVE. Медиа идёт `etcp_route_send` (после подъёма прямого линка
+роутер идёт напрямую — RTT минимален).
+
+## 5. Отправка медиа — backpressure через локальный буфер
+
+Требование: не дропать аудио при переполнении роутера — держим в локальном буфере
+отправки, дренируем при появлении места.
+
+Механика (`etcp_router` уже предоставляет):
+- `etcp_route_send(force=0)` возвращает `-1`, когда `send_q` роутера полон
+  (`count >= ROUTER_MAX_SEND_Q_PACKETS`).
+- `etcp_router_send_q_has_room(...)` — есть ли место (порог `ROUTER_MAX_SEND_Q_PACKETS-1`).
+- `etcp_router_on_send_ready(..., &waiter, drain_cb, arg)` — одноразовый waiter:
+  колбэк вызывается, когда `send_q->count <= threshold` (освободилось место).
+
+В сессии:
+- `tx_q` — локальная FIFO очередь закодированных кадров (ll_entry с dgram), ёмкостью
+  ~1с (≈50 кадров). При переполнении — дроп старейшего + счётчик `c_tx_dropped`.
+- Алгоритм (`call_tx_flush`): пока `tx_q` не пуст:
+  - если `send_q_has_room` → `queue_data_get` + `etcp_route_send(force=0)`;
+  - иначе — если waiter не зарегистрирован → `etcp_router_on_send_ready(... drain_cb)` и выход.
+- `drain_cb(q, arg)` → снова `call_tx_flush(session)` (re-arm при необходимости).
+- Весь код — в uasync-потоке (single-threaded, реентерабельность как в
+  `media_delivery.c:stream_send_chunk_cb`).
+
+## 6. Thread-модель (single-writer)
+
+| Объект | Владелец |
+|---|---|
+| `call_session` (состояние, encoder, decoder, tx_q, таймеры) | uasync-поток |
+| Opus encoder (send) | аудио-поток (encode) |
+| Opus decoder (recv) | uasync-поток (`decode → ajb_push`) |
+| `ajb` push | uasync-поток |
+| `ajb` pull + SoundTouch | аудио-поток |
+| `call_tones` | аудио-поток |
+
+Поток данных:
+- TX: аудио-поток кодирует → `call_send_encoded(call_id, opus, len)` → `uasync_post` →
+  uasync: `tx_q` + `call_tx_flush` (backpressure).
+- RX: uasync принимает `CALL_MEDIA` → decode → `ajb_push`; аудио-поток `call_pull_pcm` → `ajb_pull` (+ тоны).
+
+`ajb` = mutex-кольцо PCM (гранулярность 20ms/50 ops в сек — мьютекс бесплатен);
+SoundTouch инстанс заперт на pull-стороне.
+
+**Контракт жизненного цикла:** GUI стартует аудио-устройство по `CALL_ACCEPTED`,
+останавливает по `CALL_ENDED` и только после остановки (join аудио-потока) вызывает
+`call_release(call_id)` (post в uasync) → uasync освобождает session/encoder/decoder/jb.
+Пока устройство работает — `call_pull_pcm`/`call_send_encoded` не гоняются с освобождением.
+
+## 7. Адаптивный джиттер-буфер (SoundTouch)
+
+Буфер ≤ **1000 мс**, target playout ~60 мс; при росте буфера плавно tempo → **1.6x**.
+SoundTouch: `USE_QUICKSEEK=1, SEQUENCE_MS=20, SEEKWINDOW_MS=10, OVERLAP_MS=4`.
+API: `ajb_create / ajb_push / ajb_pull / ajb_stats / ajb_destroy`.
+
+## 8. Тоны и диагностика
+
+- **Сталл >500мс** (нет входящих медиа) → в `call_pull_pcm` микшируется
+  `CALL_TONE_GLITCH`: `пи-пи (2×150мс, gap 100мс) … тишина до 1.0с … пи(200мс)
+  пауза(200мс) пи(200мс)`, 1000 Гц, цикл пока длится сталл.
+- **Завершение звонка → всегда** `CALL_TONE_ENDED`: 3 нисходящих 700/500/400 Гц по 150 мс.
+- Счётчики: tx/rx кадры, `c_tx_dropped`/`c_rx_dropped`, дропы буфера, сталлы,
+  tempo-события, причины завершения. Логи `DEBUG_CATEGORY_CALL` (+стата раз в 1с).
+
+## 9. GUI-события (extend `chat_event.h` + `gui_bridge.h` + android)
+
+```
+CHAT_EVT_CALL_INCOMING   32  [ch_id_len][ch_id][caller_node_id:8][call_id:8]
+CHAT_EVT_CALL_RINGING    33  [call_id:8]
+CHAT_EVT_CALL_ACCEPTED   34  [call_id:8]
+CHAT_EVT_CALL_ENDED      35  [call_id:8][reason:1]
+CHAT_EVT_CALL_DECLINED   36  [call_id:8][reason:1]
+CHAT_EVT_CALL_STATS      37  [call_id:8][rtt_ms:2][buffer_ms:2][tempo_x100:2]
+CHAT_EVT_CALL_ERROR      38  [call_id:8][err:1][text:var]
+CHAT_EVT_CALL_AUDIO_ROUTE 39 (Android: текущий маршрут/наличие гарнитуры)
+```
+
+## 10. Публичный API (call.h)
+
+```
+int  call_start(ch_id, peer_node_id, out_call_id);        // caller (post в uasync)
+void call_accept(call_id);                                // callee
+void call_decline(call_id);
+void call_hangup(call_id);
+int  call_is_online(ch_id, peer_node_id);                 // BGP-проверка для UI
+// аудио-поток (общий процессинг в C-ядре):
+int  call_encode_pcm(call_id, pcm, n, opus_out, cap);     // single-writer: audio thread
+int  call_send_encoded(call_id, opus, len);               // post → uasync → tx_q + flush
+int  call_pull_pcm(call_id, pcm_out, max);                // single-writer: audio thread (ajb+tones)
+void call_release(call_id);                               // post → uasync: освободить аудио-объекты
+```
+
+`call_init / call_destroy` — вызываются из `chat_core_init / chat_core_destroy`.
+
+## 11. Платформенный I/O
+
+- **Desktop:** `tools/chatgui/src/call_audio_engine.cpp` — miniaudio full-duplex
+  (capture → `call_encode_pcm`, `call_pull_pcm` → playback) + окно звонка (UI)
+  + события в `gui_bridge_impl.cpp`.
+- **Android:** JNI `nativeCall*` + Kotlin `AudioRecord`/`AudioTrack`.
+  **Переключение источника:** `AudioManager` (API31+ `setCommunicationDevice` +
+  `availableCommunicationDevices`; fallback `setSpeakerphoneOn` + `startBluetoothSco`),
+  детект гарнитуры (`ACTION_HEADSET_PLUG`, BT-профиль, `ACTION_SCO_AUDIO_STATE_UPDATED`),
+  кнопка-цикл трубка/громкая/гарнитура, авто-выбор гарнитуры. `nativeCallSetAudioRoute(route)`.
+
+## 12. Сборка
+
+- `src/Makefile.am` + `tests/Makefile.am`: `call.c` (C, без `.cpp`). `src/call/` в include path.
+- `tools/chatgui/libutun/CMakeLists.txt`: +`call_audio.c`, `call_tones.c`,
+  `audio_jitter.cpp`, soundtouch sources (AAFilter, FIFOSampleBuffer, FIRFilter,
+  InterpolateCubic/Linear/Shannon, RateTransposer, SoundTouch, TDStretch, cpu_detect_x86,
+  mmx_optimized, sse_optimized) как C++. `call.c` попадёт через GLOB `src/*.c`.
+- `tools/chatgui-android/libutun_lite/CMakeLists.txt` + `utun_sources.cmake`:
+  `LANGUAGES C CXX`, те же файлы.
+- `src/transport_layer/etcp_api.h`: `#define ETCP_RT_ID_CALL 0x34`.
+- `lib/debug_config.h`: `DEBUG_CATEGORY_CALL 31`, `DEBUG_CATEGORY_COUNT` → 32.
+
+## 13. Порядок задач
+
+1. `call_proto.h` + svc_id + `DEBUG_CATEGORY_CALL`.
+2. `call.c` (машина состояний, backpressure-media, watchdog, события, API) + `chat_core` хуки.
+3. `audio_jitter.cpp` (SoundTouch) + `test_audio_jitter.c`.
+4. `call_tones.c` + `call_audio.c` (Opus + фрейминг + тон-обвязка).
+5. Desktop: `call_audio_engine.cpp` + UI + события.
+6. Android: JNI + Kotlin AudioRecord/Track + переключение источника + UI.
+7. Сборка (Makefile.am / CMake обе).
+8. `test_call.c` (два инстанса), интеграция desktop↔desktop и desktop↔android.
@@ -0,0 +1,93 @@
+# DM — прямой p2p чат между двумя пользователями группы
+
+## 1. Цель
+
+Возможность начать личный чат с любым пользователем доступных групп.
+Пока target offline сообщения временно хранятся на storage-узлах.
+
+## 2. Ключевые решения
+
+- Отдельная DM-подсистема (НЕ канал: без TOPO_GROUP/member_sync/merkle).
+- Идентичность детерминированная: одна ветка на пару, согласование без handshake.
+- E2E-шифрование содержимого сразу.
+- Offline-хранение: dm_mailbox на storage-узлах с флагом dm_storage.
+- Доставка: fallback — сперва проверка наличия узла в BGP-группе; доступен →
+  прямой send; нет связи → storage.
+
+## 3. Идентичность и ключи (детерминированные)
+
+    conv_id     = SHA256("utun_dm_v1" || min(node_a,node_b) || max(node_a,node_b))[..63]
+    shared      = X25519(my_x25519_priv, peer_x25519_pub)
+    content_key = SHA256(shared || "utun_dm_content")
+
+Обе стороны выводят одинаковые значения из своего privkey и pubkey пира
+(известен из общей группы). Смена x25519 у пира = новая ветка.
+
+## 4. Модель данных (SQLite, общий chats.db)
+
+    dm_conversations(conv_id TEXT PK, peer_node_id, peer_x25519 BLOB, peer_ed25519 BLOB,
+                     peer_name TEXT, last_out_seq INT, last_in_seq INT, created_at INT, last_ts INT)
+    dm_messages(conv_id TEXT, dir INT, seq INT, ts INT, author INT, ct TEXT,
+                data BLOB, sig BLOB, PRIMARY KEY(conv_id,dir,seq))
+    dm_mail(recipient INT, sender INT, conv_id TEXT, seq INT, ts INT, data BLOB, sig BLOB,
+            ttl INT, PRIMARY KEY(recipient,sender,seq))
+
+Два независимых направленных потока (A→B, B→A) с монотонным seq.
+Без chain-хеша: для 2 пиров достаточно seq + catch-up по диапазону.
+
+## 5. Доставка
+
+1. Проверка доступности: peer присутствует в BGP-группе (общая группа).
+2. Доступен → прямой send (сервис ETCP_RT_ID_DM = 0x34), ждём DM_ACK{conv_id,seq}.
+   Нет ACK за таймаут → fallback в mailbox.
+3. Нет связи → MAIL_PUT на 1..N storage-узлов.
+4. Catch-up при connect: DM_HELLO{conv_id,last_out_seq,last_in_seq} → пир досылает
+   (in_seq+1 .. out_seq).
+5. Dedup: вставка только при seq > last_in_seq.
+
+## 6. E2E-шифрование
+
+    data_enc = nonce(13B, счётчик по seq) || AES-CCM_ct || tag
+
+secure_channel уже умеет AES-CCM. Storage/relay видят только шифротекст.
+
+## 7. Storage-узлы (dm_storage)
+
+- Новый флаг dm_storage=yes в adm_tags (блок B владельца), распространяется
+  существующим member_sync без нового синка.
+- DM читает adm_tags мемберов общих групп (peers_<ch>) и кэширует storage-узлы.
+- Протокол mailbox (сервис ETCP_RT_ID_DM_MAILBOX = 0x35):
+
+      MAIL_PUT {recipient,sender,conv_id,seq,ts,data,sig}
+      MAIL_PULL {recipient, per-sender cursor}
+      MAIL_ACK {up_to_seq}
+
+  TTL 7 дней + лимит объёма, dedup по (recipient,sender,seq).
+
+## 8. Старт и anti-spam
+
+- dm_start(peer): создать беседу (вывести conv_id/ключи), обеспечить прямое
+  соединение (переиспользовать chat_sync_connect_node/node_conn_direct).
+- Пир автопринимает на первом DM_HELLO/сообщении, только если отправитель в
+  общей группе.
+
+## 9. Файлы и интеграция
+
+| Файл | Назначение |
+|------|-----------|
+| src/dm/dm_core.c/h    | беседы, send/recv, таблицы, bind 0x34, conn-события, fallback |
+| src/dm/dm_crypto.c/h  | derive + AES-CCM |
+| src/dm/dm_mailbox.c/h | storage-узел, push/pull/ack, bind 0x35 |
+
+Плюс:
+
+- src/chat/chat_member.c — бит CHAT_MEMBER_FLAG_DM_STORAGE + парсинг dm_storage.
+- utun_instance.c — dm_core_init/destroy.
+- chat_core — API dm_start/send/list + события CHAT_EVT_DM_*.
+- headless CLI — dm list/send/messages.
+- src/Makefile.am — новые источники.
+
+## 10. Сервисы ETCP
+
+    ETCP_RT_ID_DM         = 0x34
+    ETCP_RT_ID_DM_MAILBOX = 0x35
@@ -0,0 +1,85 @@
+Архитектура etcp:
+
+ETCP устанавливает только одно подключение между двумя узлами. Это подключение может добавлять-убирать каналы связи (динамически) без разрыва соединения.
+Также каналы связи мониторятся и трафик распределяется между доступными каналами. Если канал определяется как недоступен - он исключается из обмена.
+Все каналы периодически мониторятся на доступность (keepalive).
+
+Роутинг.
+utun поддерживает встроенный ipv4 роутинг, может через промежуточные узлы доставлять пакеты.
+У каждого узла есть свои маршруты. Эти маршруты при подключении распространяются по остальным узлам.
+Связь между узлами:
+  Каждый узел имеет настройку NAT для каждого listen сокета: public / nat / private.
+    public - нет nat, можно подключаться напрямую
+    nat - есть правильный nat с static port (т.е. можно подключаться напрямую зная присвоенный ip:port)
+    private - нельзя подключаться
+  Приоритетный способ обмена данными - прямое подключение к узлу. Если один из узлов имеет не private интерфейс то создается подключение через него.
+  Если не удается подключиться напрямую - выбирается переадча через промежуточный узел с наилучшим качеством канала (считается из задержки, числа хопов, bandwidth, потерь)
+  Для установки прямого соединения шлётся запрос удаленному узлу через существующие соединения на запрос подключения.
+     Запрос включает мой id, pubkey, доступные каналы связи и их [ip:port]. удаленный узел запоминает эти данные и отправляет response с такими же данными.
+     При получении request или response узел смотрит каких подключений (links) еще нет и пробует инициировать на подходщих линках с узлом.
+     Таким образом будет инициировано подключение между узлами по всем доступным линкам.
+     Если у каждого из узлов есть более одного канала то создаётся m * n подключений (каждый сокет с каждым). которые дальше работают как обычно - балансировщик нагрузки далее в процессе выбирает как лучше отправить очередной пакет (больше вариантов - можно найти путь лучше).
+  Есть статические подключения (которые прописаны в конфиге) и есть динамические - которые устанавливаются в процессе по необходимости.
+  Обмен маршрутами происходит только через статические подключения.
+
+
+## etcp_connections:
+- обслуживает encrypt/decrypt и установку защищенного подключения per-link.
+- для одного etcp соединения может испольоваться несколько подключений одновременно (load balancing / filover)
+
+## etcp_loadbalancer:
+- выбирает через какой маршрут отправить пакет
+- ограничивает rate отправки чтобы не забивать очереди каналов
+- сделан для совместной работы с etcp модулем
+
+## pkt_normalizer:
+- обеспечивает фрагментацию и сборку пакетов в единый поток для передачи через etcp.
+- взаимодейстует с etcp и очередями для приема и передачи.
+- в очередь для передачи может отправить любой модуль
+- из очереди приёма пакеты забирает etcp_api
+
+## etcp_api:
+- обеспечивает связь между etcp и остальными модулями
+- имеет функцию которая забирает из normalizer принятые данные и перенаправляет их на нужный модуль
+- имеет функцию connector_bind которой можно установить коллбэк для нужного типа кодограмм (первый байт).
+
+## etcp:
+- обеспечивает ретрансмиссии при передаче и сборку в правильной последовательности при приёме
+- взаимодействует с pkt_normalizer и с udp сокетами для отправки-получения пакетов
+
+## stcp_* :
+- аналогично etcp только упрощенный вариант, используя tcp в качестве транспорта.
+
+## etcp_router:
+- устанавливает связь между узлами, маршрутизирует трафик через цепочку узлов
+
+## route_lib, route6_lib :
+- управляет таблицами маршрутизации (ipv4/ipv6 lookup)
+
+## route_node:
+- хранит список доступных узлов (полученные от соседей) и их адреса/pubkeys для подключения.
+- содержит апи для поиска-чтения-обновления узла
+
+## route_bgp:
+- составляет карту маршрутизации между узлами и обновляет ее при подключении-отключении узлов
+
+## route_ping:
+- модуль для определения типа nat (strict или eim) используя вспомогательный узел
+
+Библиотеки:
+## uasync
+- модуль для асинхронной работы.
+   реализует сокеты, таймауты и сигналы из других потоков
+- быстро работает с большим числом таймаутов (timeout_heap)
+
+## ll_queue
+- модуль работы с очередями, использует uasync.
+- реализует fifo/lifo очереди, быстрый поиск по индексу, различные callback - сигнализация о состояниях очереди,
+- congestion control: если много желающих записать -> очередь round-robin
+
+
+Тесты:
+# Правила работы с очередями в тестах:
+- для добавления в очередь надо использовать queue_waiter_wait и queue_set_threshold, добавлять по одному пакету, каждый раз дожидаясь когда очередь станет пустой.
+- для получения надо использовать queue_set_callback + queue_resume_callback
+
@@ -0,0 +1,189 @@
+Формат кодограммы:
+------------------
+пакеты идут по следующему пути:
+пакет кем-то помещается в входную очередь (ETCP input_queue).
+Когда load balancer готов отправить следующий пакет он делает вызов etcp_request_pkt в etcp.c/h и etcp либо формирует следующую кодограмму или встаёт в состояние async ожидания (возвращая null):
+  - либо wait ETCP input_queue (если нечего передавать)
+  - либо wait SACK + wait timeout (если sack очередь полная и нет необслуженных запросов ретрансмиссий). после истечения wait timeout он помечает используя round-robin очередной пакет как "нужна ретрансмиссия".
+из async ожидания он может вызвать etcp_loadbalancer input_from_etcp и передать пакет на отправку.
+как формируется пакет:
+  1. выбираем канал передачи (etcp_loadbalancer_select_link)
+  2. если есть место в rwin (объём inflight данных) то берем очередной пакет из ETCP input_queue и его отправляем
+  3. если пакет найден или есть неподтверждённые ACK:
+     1. вызываем функцию формирования опциональных секций (ACK, channel timestamp) - они записываются в начало
+     2. в конец добавляем секцию 0x00 с данными пакета
+  при отправке пакета помечаем в inflight списке с какого интерфейса он отправлен
+Функция прикрепления опциональных секций:
+  - запрашивает выбор канала передачи.
+  - добавляет накопившиеся ACK
+При приёме пакета (от etcp_connections):
+  - последовательно сканируем секции и отдаём их на обработку нужным обработчикам:
+    - ack (0x01): помечаем в inflight пакеты как подтверждённые и проставляем время подтверждения. также снимаем блокировку отправки
+    - timestamp (0x06): обновляем last RTT, пересчитываем RTT avg10 и jitter по каждому линку; обновляем recv_dt_avg для раздельного измерения времени передачи/приёма
+    - [0x00] payload: добавляем пакет в нужное место сборочного linked-list (сверяем по ID если дубликат - игнорируем). также добавляем ACK запись в ack_q для отправки.
+  после сканирования проверяем появились ли в linked-list собранные данные которые можно переместить в выходную очередь. и перемещаем если есть.
+
+пересканирование inflight:
+  - запускается при добавлении пакета в очередь ожидания ACK (wait_ack_cb). устанавливается таймер на первый неистекший пакет.
+  - если время последней отправки > RTT_avg10*K1+jitter*K2 (коэффициенты K1=32, K2=32, деление на 16) то пакет заново отправляется
+  - очередь FIFO (сортирована по timestamp добавления = времени отправки), сканирование прекращается на первом неистекшем пакете
+  - по истечению таймера (ack_timeout_cb) снова вызывается проверка очереди
+
+inflight - две очереди (ll_queue):
+  - input_send_q: список пакетов ожидающих отправку
+  - input_wait_ack: список неподтвержденных пакетов ожидающих ack
+  При отправке пакет перемещается из input_send_q в input_wait_ack.
+  При ретрансмиссии пакет перемещается из input_wait_ack обратно в input_send_q.
+  доп. свойства пакетов (struct INFLIGHT_PACKET):
+  - указатель на ETC_LINK последней отправки (last_link)
+  - timestamp последней отправки (last_timestamp)
+  - число отправок (send_count)
+  - send_hist[8] - история через какие линки отправлялся (индекс линка)
+  - inflight_bytes/inflight_packets per-link отслеживается в ETCP_LINK
+Размер буфера inflight лимитируем как сумму по всем активным линкам optimal_inflight.
+optimal_inflight расчитывается из RTT и bandwidth линка.
+
+bandwidth по каждому линку адаптивно подстраиваем:
+Периодически в stats_timer_cb собираем статистику окна (rtt_avg10, ретрансмиссии, переданные пакеты).
+BW рассчитывается как: inflight_lim_bytes * 8 / rtt_min (в секундах) * 8 / 1024 * 1.3 (Kbits/sec).
+Размер inflight_lim_bytes плавно подстраивается вверх/вниз в зависимости от того, растёт ли RTT.
+Burst-измерения bandwidth (0x07, 0x08) зарезервированы, но на данный момент не реализованы.
+
+
+**** Формат кодограмм для etcp.c/h ****
+Каждая кодограмма состоит из обязательного заголовка и опциональных секций:
+1. Обязательный заголовок всего пакета (3 байта) добавляется при передаче, есть во всех пакетах:
+   [Timestamp high][Timestamp low][flags/flag_up]
+   - Timestamp: uint16_t, время отправки в единицах 0.1 мс (циклическое). при переповторах время обновляется
+   - flag_up: uint8_t, bit0 = up/down (recv_keepalive) — признак живой приёмной стороны
+
+   шифруется строго ВСЁ включая ВСЕ заголовки (кроме обфусцированного publickey в INIT-пакетах).
+   timestamp вставляется ВСЕГДА ВО ВСЕ КОДОГРАММЫ (скрыто в шифрованном заголовке).
+   Итого шифруется: 3 байта заголовка + (data_len - noencrypt_len) байт данных.
+2. Опциональные секции (одна или несколько) добавляются в etcp.c (внутри data[], без доп. заголовка):
+   а) Подтверждения (ACK) - заголовок 0x01:
+      [0x01][count][last_delivered_id(4 байта LE)][rx_dup_count(2 байта LE)][[seq(4 LE)][recv_ts(2 LE)][dly(2 LE)] × count]
+      - count: количество ACK записей (1 байт; до 32 ограничено размером пакета)
+      - last_delivered_id: uint32_t — последний ID, доставленный получателю (по этот ID всё собрано подряд)
+      - rx_dup_count: uint16_t — счётчик принятых дубликатов (локальный, для вычисления tx_dup_count на удалённой стороне)
+      - seq: uint32_t — номер подтверждаемого пакета
+      - recv_ts: uint16_t — локальный timestamp приёма пакета (в единицах 0.1 мс)
+      - dly: uint16_t — задержка между приёмом пакета и отправкой ACK (для расчёта RTT)
+      Каждая запись = 8 байт.
+   в) channel timestamp (добавляется после выбора канала передачи, если есть свежие данные):
+      [0x06] [RET_Timestamp(2 байта LE)] [RECV_Rel_Timestamp(2 байта LE)]
+      - RET_Timestamp: uint16_t = last_recv_timestamp + (now - last_recv_local_time)
+        (оценка текущего времени на передающей стороне в момент отправки)
+      - RECV_Rel_Timestamp: uint16_t = last_recv_local_time - last_recv_timestamp
+        (относительное смещение между локальным и удалённым временем)
+      Всего 5 байт. Добавляется только если last_recv_updated=1 (был принят пакет с момента последней отправки)
+      и если прошло не более ~100ms (dt < 1000000 таймбаз).
+3. Полезная нагрузка - заголовок 0x00 (одна секция и всегда последняя):
+      [0x00] [ID 4 байта LE] [данные...]
+     - ID: uint32_t, 32-битный циклический номер пакета
+Пакет может содержать несколько опциональных секций (например, ACK + channel_timestamp + данные),
+всегда в порядке: ACK, channel_timestamp, payload; payload всегда последний.
+Разбор секций — последовательное сканирование с известными размерами (нет явного поля длины секции).
+
+цель протокола:
+1. контролировать состояние очередей (не накапливать данные где этого можно избежать), анализировать RTT и inflight - динамически подстраивать размер окна и ретрансмиссии, утилизируя сеть насколько это возможно но не допуская наполнения буферов в сети (что приводит к бестолковому увеличению RTT)
+
+Установка подключения для канала (реализуется в etcp_connections.c/h):
+каждое ETCP подключение может содержать несколько линков до endpoint (разные маршруты, каналы связи).
+При прохождении трафика через этот модуль подсчитываются метрики (для каждого канала отдельно):
+- RTT последнего пакета и время отправки последнего пакета
+- общее количество отправленных/принятых байт
+- количество перезапросов (по каждому каналу отдельно) в пакетах. когда etcp модуль принял запрос ретрансмиссии он смотрит с какого интерфейса был отправлен этот пакет (это запоминается при отправке) и увеличивает счетчики.
+- обновление текущего количества неподтвержденных данных inflight (в пакетах и байтах) - сколько по этому каналу отправленных и неподтвержденных на текущий момент
+Планировщик/балансир каналов (etcp_loadbalancer.c/h):
+для каждого канала ограничение полосы с тестированием отклика:
+- полосу ограничиваем по объему данных - полному числу байт ethernet пакта (добавляем размер заголовков)
+  Ограничение реализуем следующим образом:
+   - в структуре есть счётчик времени (квантизация стандартная 0.1ms) по которое канал загружен данными. И суб-разряды (nanotime) этого счетчика 0.1ns - 0.1ms (считает по модулю 1000000 и переполнения добавляет в основной счетчик) чтобы при высоких скоростях не было потери точности.
+   Этим счётчиком контролируется полоса: при передаче к нему добавляется расчётное время передачи текущего ethernet пакета (используя текущий bandwidth считаем время передачи одного байта (float) и умножаем на число байт, переводим в таймбазу nanotime). А если при передаче время меньше current_time - delta_time (delta_time - константа в define, x0.1ms) то он устанавливается как current time-delta_time. (при неактивности обновляем время)
+   счетчик нужен для контроля можно ли передавать следующий пакет ("расчётное время передачи");
+когда etcp пытается отправить пакет через линк, то если в линке не инициализировано подключение и он клиент - то он отбрасывает этот пакет и запускает процесс установки соединения.
+также процесс установки соединения инициируется при добавлении канала (в etcp_link_new) если это client.
+процесс установки соединения (рукопожатие):
+- клиент отправляет init запрос и выставляет таймаут
+- по таймауту повторяет init запросы с экспоненциально растущим интервалом (начальный 500ms, макс 50s, +25% каждые 10 попыток), ведется счетчик запросов init.
+- когда клиент получает init подтверждение — снимает таймаут, выставляет link_state=connected, запускает keepalive.
+- сервер при получении init запроса: если линк существует и session_id совпал — отвечает без сброса (0x05); если session_id новый — выполняет etcp_conn_reinit и отвечает со сбросом (0x03).
+При добавлении нового канала: если link_state=1 (handshake) — посылаем INIT со сбросом (0x02); если link_state=2 (reconnect) — без сброса (0x04).
+link_state: 0=just init, 1=handshake, 2=reconnect, 3=connected.
+
+**** Формат кодограмм для etcp_connections.c/h ****
+Кодограммы с этими секциями обрабатываются в etcp_connections (в этих кодограммах всегда одна секция-тип пакета). В обязательном заголовке (timestamp+flag_up) ID не используется.
+
+Типы пакетов:
+    0x02 — ETCP_INIT_REQUEST (со сбросом etcp сессии)
+    0x03 — ETCP_INIT_RESPONSE (подтверждение со сбросом)
+    0x04 — ETCP_INIT_REQUEST_NOINIT (без сброса)
+    0x05 — ETCP_INIT_RESPONSE_NOINIT (подтверждение без сброса)
+    0x06 — ETCP_PING (проверка доступности)
+    0x07 — ETCP_PONG (ответ на пинг)
+
+    1) Init запрос (0x02 / 0x04):
+       [code(1)] [my_node_id(8 BE)] [session_id(4 BE)] [mtu_local(2)] [keepalive_interval(2)]
+       [recovery_interval/100(2)] [local_link_id(1)] [sock_id(1)] [only_local(1)] [type(1)]
+       [random_padding...] [salt(SC_PUBKEY_ENC_SALT_SIZE)] [obfuscated_pubkey(SC_PUBKEY_SIZE)]
+       - code: 0x02 (со сбросом) или 0x04 (без сброса)
+       - node_id: 64 бита, идентификатор узла (big-endian)
+       - session_id: 32 бита, случайный ID сессии генерируется клиентом (big-endian)
+       - mtu_local: uint16_t локальный MTU
+       - keepalive_interval: uint16_t интервал keepalive в мс
+       - recovery_interval: uint16_t = recovery_interval/100 (в таймбазах 0.1мс / 100)
+       - local_link_id: uint8_t (0-255), назначается отправителем
+       - sock_id: uint8_t, уникальный ID сокета отправителя
+       - only_local: uint8_t, флаг "только локальные подключения"
+        - type: uint8_t, тип сокета (CFG_SERVER_TYPE_UNKNOWN=0/PUBLIC=1/NAT=2/PRIVATE=3/LOCAL=4)
+       - random_padding: случайные байты до размера handshake (защита от fingerprinting)
+       - salt + obfuscated_pubkey: публичный ключ с обфускацией (не шифруется AES,
+         но скрывается XOR с salt и собственным публичным ключом). Передаётся в конце пакета
+         в noencrypt_len байтах (не попадает под AES-шифрование)
+       Инициирует новый connection для tcp instance. Если tcp instance нет (первое подключение) - создаёт.
+       Между нодами только одно подключение, но можно добавлять каналы.
+
+    2) Init подтверждение (0x03 / 0x05):
+       [code(1)] [my_node_id(8 BE)] [session_id(4 BE)] [mtu_local(2)] [local_link_id(1)]
+       [remote_socket_id(1)] [only_local(1)] [type(1)] [peer_ipv4(4)] [peer_port(2)]
+       [random_padding...]
+       - code: 0x03 (со сбросом) или 0x05 (без сброса)
+       - node_id: 64 бита, big-endian
+       - session_id: 32 бита, big-endian (должен совпасть с запросом клиента; если нет — клиент игнорирует)
+       - mtu_local: uint16_t локальный MTU сервера
+       - local_link_id: uint8_t идентификатор канала сервера
+       - remote_socket_id: uint8_t (копируется из запроса)
+       - only_local: uint8_t флаг сервера
+       - type: uint8_t тип сокета сервера
+       - peer_ipv4: 4 байта (IPv4 адрес клиента как его видит сервер — для NAT traversal)
+       - peer_port: 2 байта (порт клиента как его видит сервер)
+       - random_padding: случайные байты
+
+    3) PING (0x06):
+       [0x06] [node_id(8 BE)] [nonce(8 BE)] [user_data_len(2 BE)] [user_data...]
+       [salt(SC_PUBKEY_ENC_SALT_SIZE)] [obfuscated_pubkey(SC_PUBKEY_SIZE)]
+       Отправляется с отдельным crypto-контекстом (не связан с ETCP-сессией).
+       Используется для проверки доступности узла и NAT-тестирования.
+
+    4) PONG (0x07):
+       [0x07] [node_id(8 BE)] [nonce(8 BE)] [resp_data_len(2 BE)] [response_data...]
+       [salt(SC_PUBKEY_ENC_SALT_SIZE)] [obfuscated_pubkey(SC_PUBKEY_SIZE)]
+       Ответ на PING. nonce копируется из запроса для сопоставления.
+
+При получении init получатель пакета должен:
+- reset ETCP_LINK с этим ip_port если он есть
+- создать новый ETCP_CONN с этим node_id. если уже существует подключение с этим node_id - проверить ключи на совпадение.
+приём кодограмм из UDP выглядит так:
+uasync select -> etcp_connection.c etcp_connections_read_callback: memory_pool_alloc, decrypt (or init) -> etcp_conn_input (etcp.c/h - сам tcp механизм) -> ETCP_CONN output_queue
+
+Keepalive: пакет без секций (только timestamp+flag_up в шифрованном заголовке, data_len=0).
+keepalive пакеты шлют и клиент и сервер с заданным интервалом если нет полезного трафика.
+Сервер прекращает слать keepalive если линк потерян (ждёт keepalive от клиента).
+flag_up в заголовке устанавливается в значение recv_keepalive (признак что локальная сторона принимает пакеты).
+
+Клиент: если все линки =down то начинается процедура восстановления связи:
+- клиент посылает init без сброса (0x04), link_state=2
+- сервер как получает init проверяет session_id:
+  - если session_id совпадает — шлёт подтверждение без сброса (0x05)
+  - если session_id изменился (клиент перезапустился) — шлёт подтверждение со сбросом (0x03)
@@ -0,0 +1,327 @@
+# ETCP Router Architecture
+
+## Структуры данных
+
+```
+ETCP_ROUTER_CONN (один на пару remote_node_id + svc_id)
+┌─────────────────────────────────────────────────────┐
+│  ll_entry  (хеш-индекс: remote_node_id[8] + svc_id[1]) │
+│  remote_node_id: u64                                 │
+│  svc_id:         u8                                  │
+│  last_dgram_ts:  u16  (timestamp последней датаграммы) │
+│                                                      │
+│  tx_seq:  u32   следующий seq для отправки            │
+│  rx_seq:  u32   ожидаемый seq для сборки              │
+│  tx_acked: u32  сколько наших пакетов подтвердил remote │
+│  last_sent_ack_seq: u32  последний отправленный ACK    │
+│                                                      │
+│  recv_q:  ll_queue*  очередь reorder (хеш по seq[4])  │
+│  send_q:  ll_queue*  очередь при переполнении inflight │
+│                                                      │
+│  ack_timer:          void*   периодический 100ms      │
+│  idle_ack_timer:     void*   idle таймаут 500ms       │
+│  send_waiter:  queue_waiter_handle  waiter на send_input_q │
+│  watchdog_timer:     void*   проверка инварианта 500ms │
+│  send_blocked:       u8      inflight полон           │
+└─────────────────────────────────────────────────────┘
+
+SVC_ROUTE_HDR (22 байта)
+┌──────┬────────────────┬────────────────┬───────┬────────┬──────────┐
+│ cmd  │  dst_node_id   │  src_node_id   │  seq  │ svc_id │ payload  │
+│  u8  │      u64       │      u64       │  u32  │  u8    │  ...     │
+└──────┴────────────────┴────────────────┴───────┴────────┴──────────┘
+
+  seq в data-пакетах = tx_seq (счетчик отправленных)
+  seq в ACK-пакетах   = rx_seq (ожидаемый следующий)
+  CLOSE-флаг = 0x80000000 в seq, RST-флаг = 0x40000000
+```
+
+## Send Path (отправка данных)
+
+```
+                    etcp_route_send(inst, dst, entry)
+                    etcp_router_conn_send(rconn, data, len)
+                              │
+                              ▼
+                    ┌─────────────────────┐
+                    │ rconn = find/get    │  поиск по (dst, svc_id)
+                    │ авто-создание если │  или etcp_router_conn_get()
+                    │ ещё нет            │
+                    └────────┬────────────┘
+                             │
+                             ▼
+              ┌──────────────────────────────┐
+              │  router_enqueue_send(rconn)  │  всегда через send_q (FIFO)
+              │  if send_q >= 64 && !force:  │  → вернуть -1 (backpressure)
+              │    return -1                 │
+              └──────┬───────────────────────┘
+                     │ копия в send_q + router_send_kick()
+                     ▼
+       ┌─────────────────────────────────────────┐
+       │ router_send_kick(rconn)                  │
+       │  closed/no_route → return                │
+       │  send_q пуст → return                    │
+       │  inflight >= limit → send_blocked=1, ret │
+       │  waiter уже ждёт → return                │
+       │  нет conn → set_no_route                 │
+       │  queue_waiter_wait(send_input_q,        │
+       │        &send_waiter, drain_cb)          │
+       └──────┬───────────────────────────────────┘
+              │ send_input_q опустел (round-robin: FIFO waiter-ов)
+              ▼
+    ┌──────────────────────────────┐
+    │ router_send_drain_cb(rconn)  │  шлём ОДИН пакет
+    │  e = send_q.pop()            │
+    │  router_send_one_flags(e)    │
+    │   → tx_seq++                 │
+    │   → etcp_send(conn, entry)   │
+    │  если send_q ещё непуст:     │
+    │    inflight полон → blocked=1│
+    │    иначе → queue_waiter_wait │  (в хвост → round-robin)
+    │  если пуст → send_blocked=0  │
+    └──────────────────────────────┘
+
+   Повторный запуск drain:
+     • приход ACK      → router_handle_ack → kick
+     • маршрут появился → router_no_route_retry_cb → kick
+     • рост inflight-лимита → router_update_inflight_limit → kick
+     • страховка       → router_send_watchdog_cb (500ms) → DEBUG_ERROR + kick
+```
+
+## Receive Path (приём данных)
+
+```
+               etcp_router_recv_cb(conn, entry)
+                         │
+                         ▼
+              ┌──────────────────────┐
+              │ dst == node_id?      │
+              └──┬───────────────┬───┘
+                 │ YES           │ NO (транзит)
+                 ▼               ▼
+    ┌────────────────────┐   ┌──────────────────────────┐
+    │ Мы — целевая нода   │   │ Транзит: найти next hop   │
+    └────────┬───────────┘   │ route_bgp_find_conn_for_  │
+             │               │ node(bgp, hdr.dst)        │
+             ▼               │ etcp_send(next, entry)    │
+    ┌────────────────────┐   └──────────────────────────┘
+    │ pl_len == 0?       │
+    └──┬───────────┬─────┘
+       │ YES       │ NO (данные)
+       ▼           ▼
+  ┌─────────┐  ┌─────────────────────────┐
+  │ CLOSE/  │  │ rconn = find/get        │
+  │ RST?    │  │ (авто-создание если нет) │
+  └──┬──┬───┘  └───────────┬─────────────┘
+     │  │                  │
+     │  │ NO (ACK)         ▼
+     │  ▼          ┌───────────────────────────────────────┐
+     │ ┌──────────┐│ Проверка границ seq:                   │
+     │ │ tx_acked ││ d = seq - rx_seq                       │
+     │ │ = hdr.seq││ |d| < ROUTER_MAX_INFLIGHT?             │
+     │ │ (только  ││                                        │
+     │ │ вперёд)  ││ Дубликат?                              │
+     │ │ kick     ││ rx_seq - seq > 0  ИЛИ                  │
+     │ └──────────┘│ seq уже в recv_q?                      │
+     │             └──────┬─────────────┬──────────────────┘
+     │                    │ OK          │ out-of-bounds / dup
+     │                    ▼             ▼
+     │             ┌──────────────┐  ┌─────────┐
+     │             │ recv_q.put() │  │ DROP    │
+     │             │ хеш по seq   │  └─────────┘
+     │             └──────┬───────┘
+     │                    │
+     │                    ▼
+     │             ┌──────────────────────┐
+     │             │ seq == rx_seq?       │
+     │             └──┬───────────────┬───┘
+     │                │ YES           │ NO
+     │                ▼               │
+     │         ┌──────────────┐       │
+     │         │ try_assembly │       │
+     │         │ while next в │       │
+     │         │ recv_q:      │       │
+     │         │   deliver()  │       │
+     │         │   rx_seq++   │       │
+     │         └──────┬───────┘       │
+     │                │               │
+     │                ▼               │
+     │         ┌──────────────────────┴──┐
+     │         │ router_deliver()        │
+     │         │ вызывает callback       │
+     │         │ сервиса (svc_id)        │
+     │         │ entry: [svc_id|payload] │
+     │         └──────────────┬──────────┘
+     │                        │
+     ▼                        ▼
+  ┌────────────────────────────────────┐
+  │ router_schedule_ack(rconn)         │
+  │ запускает ack_timer (100ms) если   │
+  │ ещё не запущен                     │
+  └────────────────────────────────────┘
+```
+
+```
+     CLOSE / RST ветка:
+     ┌────────────────────────────────────────┐
+     │ pl_len == 0 && seq & CLOSE/RST         │
+     │   → router_close_and_notify(rconn)     │
+     │     ├─ router_send_close_to_service()  │
+     │     │   (callback с NULL conn)         │
+     │     ├─ отправить CLOSE удалённой стороне│
+     │     ├─ отмена всех таймеров            │
+     │     ├─ очистка recv_q + send_q         │
+     │     └─ удаление из inst->router_conns  │
+     └────────────────────────────────────────┘
+```
+
+## ACK Mechanism
+
+```
+         ┌─────────────────────────────────────────┐
+         │       router_schedule_ack(rconn)        │
+         │  (вызывается при получении данных)       │
+         └────────────────┬────────────────────────┘
+                          │
+         ┌────────────────▼────────────────────────┐
+         │  если idle_ack_timer активен — отменить  │
+         │  если ack_timer не активен — запустить   │
+         │  ROUTER_ACK_INTERVAL_TB = 1000 (100ms)  │
+         └────────────────┬────────────────────────┘
+                          │
+                          ▼  (через 100ms)
+         ┌─────────────────────────────────────────┐
+         │          router_ack_timer_cb()           │
+         │                                          │
+         │  if rx_seq != last_sent_ack_seq:         │
+         │    router_send_ack(rconn)                │
+         │    last_sent_ack_seq = rx_seq            │
+         │    перезапустить ack_timer               │
+         │  else:                                   │
+         │    запустить idle_ack_timer (500ms)      │
+         └────────────────┬────────────────────────┘
+                          │
+                          ▼  (через 500ms)
+         ┌─────────────────────────────────────────┐
+         │        router_idle_ack_timer_cb()        │
+         │                                          │
+         │  if rx_seq != last_sent_ack_seq:         │
+         │    router_send_ack(rconn)   (досылка)    │
+         │    last_sent_ack_seq = rx_seq            │
+         └─────────────────────────────────────────┘
+
+         router_send_ack(rconn):
+           hdr.seq = rx_seq
+           hdr.svc_id = svc_id
+           pl_len = 0  →  это ACK-пакет
+           etcp_send(conn, entry)
+```
+
+```
+         Обработка входящего ACK:
+         ┌────────────────────────────────────────┐
+         │ pl_len == 0 && нет CLOSE/RST флагов     │
+         │                                         │
+         │ if seq >= tx_acked:    // только вперёд │
+         │   tx_acked = seq       // обновить      │
+         │ else:                                   │
+         │   DEBUG_WARN "stale ACK"                │
+         │                                         │
+         │ if send_blocked:                        │
+         │   send_blocked = 0                      │
+         │   router_send_kick(rconn)               │
+         └────────────────────────────────────────┘
+```
+
+## Inflight Control
+
+```
+   ROUTER_MAX_INFLIGHT = 256
+
+   Отправка возможна когда:   tx_seq - tx_acked < 256
+   Отправка заблокирована:    tx_seq - tx_acked >= 256
+
+   При блокировке:
+     данные → send_q (FIFO, без дропов)
+     send_blocked = 1
+
+   Разблокировка:
+     приход ACK от remote → tx_acked обновляется
+       → router_send_kick() → waiter → drain_cb разгребает send_q
+     или маршрут появился / inflight-лимит вырос → kick
+     страховка: router_send_watchdog_cb (500ms) → force kick
+
+   send_q полностью разобран → send_blocked = 0
+```
+
+## Полная схема потоков
+
+```
+                           ┌──────────┐
+                           │  Сервис  │ (routing, proxy, NAT, ...)
+                           │  (svc_id)│
+                           └────┬─────┘
+                                │
+              etcp_route_send() │              callback(svc_id, entry)
+                                ▼              ▲
+ ┌─────────┐   send   ┌─────────────────────────────────┐   recv   ┌─────────┐
+ │  TUN    │─────────▶│         ETCP ROUTER              │─────────▶│  TUN    │
+ │ (выход) │          │                                  │          │ (вход)  │
+ └─────────┘          │  ┌──────────┐  ┌──────────┐    │          └─────────┘
+                      │  │ send_q   │  │ recv_q   │    │
+                      │  │ (FIFO)   │  │ (хеш seq)│    │
+                      │  └────┬─────┘  └────┬─────┘    │
+                      │       │             │          │
+                      │       ▼             ▼          │
+                      │  ┌─────────────────────────┐   │
+                      │  │   Inflight / Assembly   │   │
+                      │  │   tx_seq - tx_acked     │   │
+                      │  │   rx_seq → deliver      │   │
+                      │  └───────────┬─────────────┘   │
+                      │              │                  │
+                      └──────────────┼──────────────────┘
+                                     │
+                              ┌──────▼──────┐
+                              │   BGP       │
+                              │  (нахождение│
+                              │   next hop) │
+                              └──────┬──────┘
+                                     │
+                              ┌──────▼──────┐
+                              │ ETCP conn   │──▶ сеть
+                              └─────────────┘
+
+   ──▶ send (исходящие данные)
+   ──▶ recv (входящие данные, callback сервису)
+   ──▶ транзит (через BGP к следующему hop)
+```
+
+## Таймеры (один rconn)
+
+```
+   ┌─────────────────────────────────────────────────────┐
+   │                                                     │
+   │  ack_timer ──────── 100ms ─────▶ router_ack_timer_cb│
+   │    (периодический)                                    │
+   │                                                     │
+   │  idle_ack_timer ─── 500ms ─────▶ router_idle_ack_cb │
+   │    (досылка последнего ACK)                           │
+   │                                                     │
+   │  watchdog_timer ── 500ms ─────▶ router_send_watchdog│
+   │    (страховка инварианта drain, force kick)          │
+   │                                                     │
+   └─────────────────────────────────────────────────────┘
+```
+
+## Флаги seq
+
+```
+   ┌──────────────────────────────────────────────────┐
+   │  CLOSE:  0x80000000  нормальное закрытие conn     │
+   │  RST:    0x40000000  conn не найден (reset)       │
+   │                                                   │
+   │  CLOSE/RST-пакеты: seq=0 | флаг, pl_len=0         │
+   │  Data-пакеты:      seq=tx_seq,     pl_len>0       │
+   │  ACK-пакеты:       seq=rx_seq,     pl_len=0       │
+   └──────────────────────────────────────────────────┘
+```
@@ -0,0 +1,66 @@
+# Важные нюансы работы встроенного lwIP TCP-стека
+
+Краткая памятка по тонким местам `src/lwip_tcp/`, критичным для прокси.
+Полное описание модуля — в `src/lwip_tcp/lwip_tcp_doc.md`.
+
+## Ключевые константы (`lwip_tcp_opts.h`)
+
+| Константа | Значение | Смысл |
+|-----------|----------|-------|
+| `TCP_MSS` | 1460 | максимальный размер сегмента |
+| `TCP_WND` | 8×MSS = 11680 | окно приёма lwIP (объявляется пиру) |
+| `TCP_SND_BUF` | 16×MSS = 23360 | буфер отправки |
+| `TCP_TMR_INTERVAL` | 250 мс | базовый интервал таймера |
+| `tmr_interval_ms` | `TCP_TMR_INTERVAL/4` = 62.5 мс | фактический шаг `tcp_fasttmr` |
+| `TCP_WND_UPDATE_THRESHOLD` | `TCP_WND/4` = 2920 | порог немедленного ACK окна |
+
+**Важно:** таймер uasync использует timebase 0.1 мс — `uasync_set_timeout(ua, N, …)`
+задаёт N×0.1 мс. Например, 5000 = 500 мс.
+
+## Контракт recv_cb — главный источник багов
+
+lwIP вызывает `recv_cb(arg, pcb, pbuf, err)` для данных, **уже извлечённых из pcb**.
+Дальше приложение само решает судьбу данных и окна:
+
+| Действие | Результат |
+|----------|-----------|
+| скопировать + `tcp_recved(pcb, len)` | данные приняты, окно восстановлено (норма) |
+| `return != LERR_OK` | lwIP кладёт pbuf в `refused_data` и отдаст позже — **без потери**, окно закрывается |
+| `pbuf_free(p)` без `tcp_recved` | данные потеряны, окно не восстановлено → схлопывание окна |
+
+`refused_data` — штатный backpressure lwIP: одноканальный (один pbuf), ре-доставка
+через `tcp_fasttmr` (62.5 мс) или при следующем входящем сегменте.
+
+**Ошибка, из-за которой падал `tcp_proxy_full`:** при backpressure прокси делал
+`pbuf_free(p)` без `tcp_recved`. Каждый такой сброс уменьшал `rcv_wnd` на MSS; после
+~8 пакетов окно падало в 0, OS-TCP переставал слать, и передача умирала.
+
+## Управление окном и «деградация 62.5 мс»
+
+`tcp_recved(pcb, len)` увеличивает `rcv_wnd` и через `tcp_update_rcv_ann_wnd` решает,
+слать ли ACK окна немедленно. Немедленный ACK идёт только если прирост окна
+`wnd_inflation ≥ TCP_WND_UPDATE_THRESHOLD` (=2920 = 2×MSS); иначе ACK откладывается
+до `tcp_fasttmr` (62.5 мс).
+
+Отсюда классическая ловушка: если после backpressure окно восстанавливать **по одному
+пакету** (`tcp_recved(1460)` за раз), прирост 1460 < 2920 → ACK уходит раз в 62.5 мс →
+пир шлёт 1 пакет за 62.5 мс ≈ 23 КБ/с. Это выглядит как «пропускная способность
+застряла», хотя сеть свободна.
+
+**Правильно:** восстанавливать окно **пачкой** (несколько `tcp_recved` подряд либо один
+`tcp_recved(TCP_WND_MAX - rcv_wnd)`), тогда прирост ≥ 2920 → ACK немедленный → пир
+сразу возобновляет бурст.
+
+## Рекомендуемый паттерн для relay-потребителя (как в `tcp_proxy_client.c`)
+
+1. При получении данных — копировать в ограниченную очередь, **не вызывать**
+   `tcp_recved` (окно само плавно закрывается; очередь ограничена `TCP_WND`).
+2. Дрейн очереди по сигналу освобождения нижележащего канала
+   (`etcp_router_on_send_ready`) + retry-таймер (force=1) как safety-net.
+3. `tcp_recved(len)` вызывать **только после успешной отправки** — окно
+   восстанавливается пачкой по мере дрена, ACK уходит немедленно.
+4. Никогда не сбрасывать pbuf без `tcp_recved`; не держать данные в `refused_data`
+   дольше одного пакета (single-slot).
+
+См. реализацию: `tcp_proxy_client_tx_queue_drain_cb` / `tcp_proxy_client_fin_flush`
+в `src/proxy/tcp_proxy_client.c`.
@@ -0,0 +1,195 @@
+# Задачи по проекту
+
+Сюда пишется список задач с короткой аннотацией. Если задача большая и имеет ТЗ - то ТЗ оформляется отдельным файлом, а сюда помещается аннотация и ссылка на ТЗ.
+
+## Текущая задача
+[+] **Q8/Android не подключается к локальному чатгуи (LAN)** — сделано. Причина: тип сокета
+    в Android-конфиге был захардкожен `type=public`, из-за чего `sock_match` ставил
+    `has_priv=0` и не создавал линки к приватным (LAN) адресам пиров (`create_links … → 0 links`).
+    Исправлено: (1) `ip_is_public()` вынесен в `lib/platform_compat` (единый классификатор
+    IPv4 с корректным ntohl); (2) в `auto_socket_reconcile_config` (Android-режим) тип сокета
+    выставляется по адресу (public→PUBLIC, приватный/link-local→NAT), конфиг `type` игнорируется;
+    (3) `sock_collect_views` больше не смотрит на `type` из конфига: `has_priv` — по классификации
+    локального адреса, `has_inet=1` (исходящие считаем доступными), `is_eim` — по NAT-детекции
+    (hairpin). `is_local_subnet` упрощён до `!ip_is_public()`. Тест `test_sock_match` обновлён
+    (+ `ip_is_public` кейсы). `check.sh`: 86 passed / 1 failed / 1 skipped.
+
+[ ] **DM: прямой p2p чат с любым пользователем группы** — отдельная DM-подсистема.
+    ТЗ и архитектура: `/doc/dm_arch.md`. Статус: реализовано (dm_core/dm_mailbox/dm_crypto),
+    тесты `test_dm` (крипто) и `test_dm_e2e` (интеграция). Остались задачи ниже.
+
+[ ] **Звонок (P2P аудио)** — голос 1:1, из CHAT-группы или p2p-чата (DM). Отдельный
+    каталог `src/call/`. Сигналинг + conn_mgr + аудиопоток (Opus) с backpressure
+    (локальный буфер отправки при переполнении роутера) + адаптивный джиттер-буфер
+    (SoundTouch, ускорение до 1.6x) + тоны (глитч/завершение) + watchdog 20с.
+    Android: переключение источника (трубка/громкая/гарнитура).
+    Архитектура: `/doc/chat_call_arch.md`.
+
+    [+] **Сигналинг + релей медиа** — сделано. `call_proto.h` (svc `ETCP_RT_ID_CALL
+        0x36`, subcmd INVITE/RINGING/ACCEPT/DECLINE/BUSY/CANCEL/HANGUP/MEDIA),
+        `call.c` (машина состояний, реестр сессий, conn_mgr, ring-timeout 45с,
+        watchdog no-traffic 20с, потеря соединения → end, события
+        CHAT_EVT_CALL_* 34–40), `DEBUG_CATEGORY_CALL 32`. `test_call` (2 инстанса,
+        happy path + decline + media-релей). Приём медиа — через `call_set_media_recv_cb`.
+    [+] **Headless API** — сделано. Команды control-сокета `call_start/accept/decline/
+        hangup` + события `call_incoming/ringing/accepted/ended/declined` (JSON);
+        аудио-сокет `call/call_headless.c` (TCP, бинарный фрейм
+        `[type:1][call_id:8][len:2][data]`, HELLO/FRAME), конфиг `call_audio_bind`.
+        Разрыв conn_mgr — отложенно 500мс (`CALL_TEARDOWN_DELAY_TB`) после ENDED,
+        чтобы HANGUP успел долететь; защита от stale-handle через conn-status.
+        Тесты: `test_call` (сигналинг+медиа), `test_call_headless` (полный e2e через
+        control+audio сокеты).
+    [+] **Аудио-контур (time-stretch в сервисном слое)** — сделано. `src/call/audio_jitter.cpp`
+        (SoundTouch, C API `ajb_*`: адаптивный джиттер-буфер ≤1000мс, target 60мс,
+        tempo 1.0→1.6x — догон live без потери данных при сетевой паузе),
+        `src/call/call_tones.c` (глитч при сталле >500мс + тон завершения),
+        `src/call/call_audio.c` (Opus 48kHz/20мс + jitter + тоны + pull API финального PCM).
+        `call.c`: `call_audio_ops` (on_media c seq/ts, get_stats) + событие
+        `CHAT_EVT_CALL_STATS` раз в 1с [rtt_ms, buffer_ms, tempo_x100].
+        Desktop `call_audio_engine.cpp` — только miniaudio I/O (получает финальный PCM).
+        Тест `test_audio_jitter` (ёмкость/догон/стационар). Демон остаётся C-only.
+    [+] **Android** — сделано. JNI (`utun_bridge_call_*`/`nativeCall*`), AudioRecord/Track
+        (CallAudioEngine), роутинг источника (CallAudioRouter: EARPIECE/SPEAKER/HEADSET,
+        BT SCO), CallScreen + IncomingCallDialog + RingtonePlayer + IncomingCallManager,
+        `libutun_lite/call_audio.c` (собственный аудио-контур Opus 48kHz/20мс).
+    [+] **Единый голосовой стек (voice stack) + SoundTouch на Android** — сделано.
+        Унификация аудио-контура звонка: `libutun_voice` (статическая C++-либа с
+        C-интерфейсом `call_audio.h` = SoundTouch + `voice_jitter.cpp` + `call_audio.c`
+        + `call_tones.c`), собирается через `src/call/voice_sources.cmake` и линкуется
+        desktop/Android/headless-CLI. Джиттер-буфер держит КОДИРОВАННЫЕ (Opus) кадры,
+        декодирует только на pull (непосредственно перед воспроизведением) — память ~48x
+        меньше и uasync-поток разгружен. Android переведён с push-FIFO (Kotlin ArrayDeque)
+        на pull-модель (`nativeCallAudioPull`), своего джиттера больше нет → убрана
+        асимметрия задержки (desktop↔Android). Headless-аудио-сокет отдаёт готовый PCM
+        (декод Opus→PCM, без тактирования; клиент сам задаёт темп). Диагностика:
+        `CALL_STATS` расширен [dropped, underruns] (раз в 1с), счётчики headless.
+        Удалены `audio_jitter.cpp` и `libutun_lite/call_audio.c`. Тест `test_voice_jitter`
+        (ёмкость/догон/стационар). Android — `ANDROID_STL=c++_static`.
+    [ ] **DM-звонки** (fallback `group_id==0`) — не сделано: `call_is_online`/`call_start`
+        требуют реальную группу (`topo_groups_find`), для DM (group_id==0) маршрута нет.
+
+## Рефакторинг: per-instance chat/dm (однопоточный test_dm_e2e)
+
+Сделано (глобальные синглтоны переведены на `UTUN_INSTANCE`):
+- `chat_setting` → `inst->chat_settings` (`struct chat_setting_state`, state-level API для парсера конфига + instance-level для runtime).
+- `chat_event` → `inst->chat_event_handler` (обработчик теперь получает `inst`).
+- `chat_core` (`g_cc`) → `inst->chat_core` (`struct chat_core_ctx*`).
+- `chat_sync` (`g_cs`) → `inst->chat_sync`.
+- `member_sync` callback-списки (`g_props_cbks`/`g_apply_cbks`) → в `chat_core_ctx`.
+- `chat_join` (`g_keys`) → в `chat_core_ctx`.
+- `chat_msg` media-счётчики/backfill → в `chat_core_ctx`.
+- `dm_core` (`g_dm`) → `inst->dm`; `dm_mailbox` (`g_mb`) → `inst->dm_mailbox`.
+- `chat_headless_control` (`g_hc`) → `inst->headless`.
+- `chat_whisper` — сигнатуры `init/available/trigger` принимают `inst`.
+- API протащено через `inst` (chat_core_*/dm_*), обновлены call-сайты в src/ (headless, topo, media_delivery, auto_socket, config_parser).
+- `test_dm_e2e.c` переписан на однопоточный: один `uasync`, три `utun_instance` (A,B,C), master state-machine, без fork. Фаза 2 (B offline) — `utun_instance_destroy(B1)` + пересоздание B2.
+- Попутно исправлен 1-байтовый overflow в `dm_mailbox.c: mb_route_send` (`u_malloc(1+body_len)` → `1+1+body_len`).
+
+Статус сборки: `make -C src` (libutun.a + бинарник utun) и `make -C tests` — OK.
+
+### Осталось (по порядку)
+
+[+] **test_dm_e2e: зависание в utun_instance_destroy(B1)** (фаза P_B_OFFLINE) — сделано.
+    Причин было несколько (не одна):
+    1. `lib/u_async.c`: если ближайший таймер уже истёк на входе в `uasync_poll`,
+       `get_next_timeout` возвращал {0,0}, `timeout_ms=-1` → `epoll_wait(-1)` блокировался
+       навсегда, а `process_timeouts` (вызывается только после epoll_wait) не запускался.
+       Фикс: `if (timeout_ms == -1 && heap не пуст) timeout_ms = 0`.
+    2. `routing_layer/etcp_router.c`: `router_send_conn` с group_id=0 (глобальная
+       маршрутизация DM/mailbox) не находил маршрут (`topo_groups_find(0)==NULL`).
+       Фикс: fallback на `instance_find_conn(inst, remote)` при group==NULL.
+    3. `dm/dm_core.c`: `dm_on_conn_status` PULL-ил только беседы с подключившимся пиром;
+       B2 подключается к storage (C), а беседа — с A. Фикс: на подъём любого соединения
+       PULL для всех бесед, чей пир не подключён напрямую.
+    4. `dm/dm_mailbox.c`: не было ACK после PULL_RESP → storage не чистил dm_mail.
+       Фикс: PULL_RESP теперь несёт sender, получатель шлёт MB_SUBCMD_ACK.
+    5. `utun_instance.c`: `dm_core_init` ставил deliver-cb до `dm_mailbox_init` →
+       mailbox не находился, deliver-cb не регистрировался. Фикс: mailbox init раньше core.
+    `test_dm_e2e` проходит (несколько прогонов), `test_dm` тоже.
+
+[+] **chatgui-android: переезд на per-instance API** — сделано.
+    `instance_lite.c/h` (+`instance_lite_get_instance()`), `jni_bridge.c`, `standby.c`,
+    `headless_control.c`, `voice_recorder.c`, `attachment_sender.c`, `video_sender.c`,
+    `photo_sender.c` — все call-сайты переведены на `inst`. `libutun_lite` компилируется,
+    `jni_bridge.c` — синтакс-чисто. (headless-линковка сломана ПРЕДЫДУЩЕ — instance_lite.c
+    ссылается на jni_bridge-функции, не включённые в headless-сборку; отдельная задача.)
+
+[+] **test_chat_join: segfault** (регресс рефакторинга) — сделано.
+    `chat_join` хранил `join_keys` в `chat_core_ctx` (CC(inst)), а тест использует chat_join
+    без chat_core → NULL-deref. Фикс: `join_keys` вынесен в `UTUN_INSTANCE.join_keys`
+    (у chat_join собственный init/destroy).
+
+[ ] **BGP-гонка: дропнутый REQUEST_TABLE** (отдельная задача, как договорились).
+
+    **Место:** `topo_group_new_conn()` в `src/routing_layer/topo_group.c:571`. Дедуп-ветка
+    «conn already in senders_list» (строки 579–587) делает `return` БЕЗ повторной отправки
+    `topo_group_send_table_request()`.
+
+    **Зачем дедуп:** тот же `ETCP_CONN` стреляет `ETCP_CONN_STATUS_UP` дважды (UDP-линк,
+    затем TCP-линк). Повторная обработка задваивает `active_conn_count`, из-за чего
+    переподключение не стартует. Поэтому `return` в дедупе — правильный.
+
+    **В чём гонка:** REQUEST_TABLE — это то, что заставляет пира отдать свою таблицу
+    (NODEINFO/узлы группы). Сценарий «разнесённого старта»:
+    1. A↔C соединение поднято. A шлёт C `REQUEST_TABLE` для группы G (`topo_group_new_conn`
+       → `topo_group_send_table_request`, `topo_group.c:602`).
+    2. У C группа G ещё **не создана** (создаётся позже, по мере загрузки каналов/синка).
+       C получает `REQUEST_TABLE`, но `topo_group_handle_request_table` не находит G →
+       дропает запрос.
+    3. C наконец создаёт G (`topo_groups_create_group` → обход connections →
+       `topo_group_new_conn(G, conn_A)` на стороне C) → C шлёт A свой `REQUEST_TABLE`.
+       A отвечает своей таблицей → **C узнаёт A**.
+    4. Но A больше не шлёт C `REQUEST_TABLE` → **A так и не узнаёт C** в группе G.
+    Итог: при разнесённом старте A не видит C в CHAT-группе (односторонняя видимость).
+
+    **Фикс (предполагаемый):** в дедуп-ветке не просто `return`, а предварительно
+    идемпотентно `topo_group_send_table_request(group, conn)`:
+    ```c
+    if (((struct TOPO_GROUP_CONN_ITEM*)se->data)->conn == conn) {
+        topo_group_send_table_request(group, conn);   /* повторно, идемпотентно */
+        DEBUG_INFO(..., "conn already in senders_list, re-request table (%s)", conn->log_name);
+        return;
+    }
+    ```
+    `topo_group_send_table_request` не ведёт состояния — просто шлёт REQUEST_TABLE,
+    пир отвечает снимком таблицы (идемпотентно). Лишний дубль таблицы безвреден.
+
+    **Замечание:** в однопоточном `test_dm_e2e` (и `test_chat_join_e2e`) из-за
+    детерминированного порядка группа успевает создаться до прихода REQUEST_TABLE —
+    поэтому тест проходит. Реальная гонка остаётся для асинхронных сетей. Отдельный
+    воспроизводимый тест для этой гонки пока не написан.
+
+[ ] **«packet undecryptable» на линках C** (вторичное). A, узнав B через BGP, через
+    `topo_group_connect` пытается поднять прямой A↔B линк (`seskey 4777737b`), но B не
+    настроен принимать A → crypto-шум каждые ~1с. Разобраться с авто-подключением
+    (не пытаться соединяться с узлами, для которых нет `[client]`/ncd-конфигурации,
+    либо обрабатывать неудачу без спама).
+
+[+] **Обновить GUI call-сайты `tools/chatgui` (Qt, desktop)** — сделано.
+    - В `chat_core.h` вынесены trampoline-структуры из `.c`: `update_my_name_arg`,
+      `save_ui_state_arg`, `chat_setting_arg` (были в chat_profile.c/chat_core.c).
+    - `gui_bridge.h/impl`: `gui_bridge_set_inst()`/`gui_bridge_get_inst()` (+`g_inst`).
+    - `utun_node.cpp`: `gui_bridge_set_inst(m_instance)`, `chat_event_set_handler(m_instance,…)`,
+      `chat_core_sync_my_addresses(m_instance)`.
+    - Обновлены ~45 call-сайтов в 16 файлах (`mainwindow`, `messagelist`, `messagedelegate`,
+      `memberlistmodel`, `memberpropsdialog`, `accountlist`, `invitedialog`, `inviteby`,
+      `joindialog`, `settingsdialog`, `channelsettingsdialog`, `soundsettingspage`,
+      `audiodevicesettingspage`, `storagesettingspage`, `statuspage`, `connmonitorwindow`).
+    - Сборка `cmake --build . --target vibechat` — OK.
+    Попутно: `chat_sync_connect_from_invite` писал `cs->pending_*` на вызывающем (GUI) потоке —
+    перенёс в `cm_invite_trampoline` (uasync-поток), убрав гонку; заодно исправил утечку
+    `inv->addrs_data` и добавил null-check `cs` в трамплине.
+
+[+] **Прогон всех тестов** — сделано. `make clean && make -j4` OK; все тесты проходят
+    (кроме `test_auto_socket_dynamic` — пропуск «requires root»). `test_dm_e2e` стабилен
+    в нескольких прогонах. В `test_dm_e2e` при teardown остаётся timer-leak (~68 узлов,
+    `router_no_route`), не влияет на результат — стоит разобрать отдельно.
+
+## Открытые флаки
+[ ] **test_chat_join_e2e** — стабильно падает (2/3 сценария): «J not signed by A»
+    `get_sign_rc=-1` (signed_by-верификация invite). Не связан с socket-классификацией
+    (обнаружен при прогоне после фикса Q8/LAN). Скорее всего регресс join-протокола.
+
+[ ] **test_etcp_reconnect** — флаки под параллельной нагрузкой `make check -j4`:
+    phase 4 (reconnect после server restart) таймаутит (`sent=480 recv=0`), при одиночном
+    запуске стабильно `TEST PASSED`. Наш код (chat_join/chat_sync) его не трогает.
@@ -11,11 +11,47 @@ libuasync_a_SOURCES = \
 	timeout_heap.h \
 	memory_pool.c \
 	memory_pool.h \
-	sha256.c \
-	sha256.h
+	socket_compat.c \
+	socket_compat.h \
+	platform_compat.c \
+	platform_compat.h \
+	getmyip.c \
+	getmyip.h \
+	swm_min.c \
+	swm_min.h \
+	mem.c \
+	mem.h \
+	radix.c \
+	radix.h \
+	serialize.c \
+	serialize.h \
+	json_flat.c \
+	json_flat.h \
+	tcp_io.c \
+	tcp_io.h \
+	sqlite3.c \
+	sqlite3.h \
+	opus_codec.c \
+	opus_codec.h \
+	audio_compressor.c \
+	audio_compressor.h \
+	strbuf.c \
+	strbuf.h \
+	dns.c \
+	dns.h \
+	async_dns.c \
+	async_dns.h

 libuasync_a_CFLAGS = \
 	-D_ISOC99_SOURCE \
 	-DDEBUG_OUTPUT_STDERR \
+	-DSQLITE_THREADSAFE=1 \
+	-DDNS_RANDOM=RAND_bytes \
+	-g \
 	-I$(top_srcdir)/src \
-	-I$(top_srcdir)/lib
+	-I$(top_srcdir)/lib \
+	-I$(top_srcdir)/lib/libopus/include
+
+# Clean build directory
+clean-local:
+	-rm -rf $(top_builddir)/build
@@ -0,0 +1,503 @@
+/*
+ * async_dns.c — асинхронный (неблокирующий) DNS-резолвер поверх uasync.
+ *
+ * Адаптер над libdns (lib/dns.c). Схема работы:
+ *   adns_resolve() → dns_res_submit(A-запрос) → adns_drive()
+ *   adns_drive()  → dns_res_check():
+ *       0      → готово, dns_res_fetch → разбор A-записей → коллбэк
+ *       EAGAIN → зарегистрировать fd (dns_res_pollfd/events) + таймер
+ *                (dns_res_timeout) в uasync и ждать события
+ *       иначе  → ошибка → коллбэк с ADNS_ERR_RESPONSE
+ *
+ * Всё выполняется в потоке event loop, блокирующих вызовов нет.
+ */
+#include "async_dns.h"
+#include "dns.h"
+#include "debug_config.h"
+#include "mem.h"
+
+#include <errno.h>
+#include <stdlib.h>
+#include <string.h>
+#include <stdio.h>
+#include <ctype.h>
+
+#ifdef _WIN32
+#include <iphlpapi.h>
+#endif
+
+#define ADNS_DEBUG_CAT DEBUG_CATEGORY_SOCKET
+
+struct adns_query {
+    struct UASYNC* ua;
+    adns_done_cb cb;
+    void* arg;
+    struct dns_resolver* res;
+    void* socket_id;    /* handle uasync (NULL когда не зарегистрирован) */
+    int   cur_fd;       /* текущий зарегистрированный fd (-1 когда нет) */
+    void* timer;        /* handle таймаута (NULL когда нет) */
+    int   finished;
+    char* name;
+    int   fast;                  /* 1 = готовый /etc/hosts-ответ, без libdns */
+    struct adns_result fast_result;
+    void* call_soon_id;          /* отложенный вызов (fast-путь и первый драйв slow-пути) */
+};
+
+static void adns_drive(struct adns_query* q);
+static void adns_finish(struct adns_query* q, int status, struct sockaddr_in* addrs, int count);
+static void adns_read_cb(socket_t sock, void* arg);
+static void adns_write_cb(socket_t sock, void* arg);
+static void adns_timer_cb(void* arg);
+static void adns_fast_ready_cb(void* arg);
+static int  adns_hosts_lookup(const char* name, struct sockaddr_in* out);
+
+/* ─── system DNS servers discovery ─── */
+
+int adns_parse_resolv_conf(const char* text, struct sockaddr_in* out, int max) {
+    int n = 0;
+    const char* p = text;
+
+    if (!text || !out || max <= 0) return 0;
+
+    while (*p && n < max) {
+        while (*p == ' ' || *p == '\t' || *p == '\r' || *p == '\n') p++;
+        if (!*p) break;
+
+        if (strncmp(p, "nameserver", 10) == 0 && (p[10] == ' ' || p[10] == '\t')) {
+            p += 10;
+            while (*p == ' ' || *p == '\t') p++;
+            char tok[64];
+            int i = 0;
+            while (*p && *p != ' ' && *p != '\t' && *p != '\r' && *p != '\n' && *p != '#' && i < 63)
+                tok[i++] = *p++;
+            tok[i] = '\0';
+            memset(&out[n], 0, sizeof(out[n]));
+            if (tok[0] && inet_pton(AF_INET, tok, &out[n].sin_addr) == 1) {
+                out[n].sin_family = AF_INET;
+                out[n].sin_port = htons(53);
+                n++;
+            }
+        }
+
+        while (*p && *p != '\n') p++;
+        if (*p) p++;
+    }
+    return n;
+}
+
+#ifdef _WIN32
+int adns_system_servers(struct sockaddr_in* out, int max) {
+    if (!out || max <= 0) return 0;
+
+    ULONG size = 0;
+    if (GetNetworkParams(NULL, &size) != ERROR_BUFFER_OVERFLOW) return 0;
+    PFIXED_INFO fi = (PFIXED_INFO)u_malloc(size);
+    if (!fi) return 0;
+    if (GetNetworkParams(fi, &size) != NO_ERROR) { u_free(fi); return 0; }
+
+    int n = 0;
+    IP_ADDR_STRING* p = &fi->DnsServerList;
+    while (p && n < max) {
+        const char* s = p->IpAddress.String;
+        while (*s && n < max) {
+            while (*s == ' ' || *s == ',') s++;
+            char tok[64];
+            int i = 0;
+            while (*s && *s != ' ' && *s != ',' && i < 63) tok[i++] = *s++;
+            tok[i] = '\0';
+            memset(&out[n], 0, sizeof(out[n]));
+            if (tok[0] && inet_pton(AF_INET, tok, &out[n].sin_addr) == 1) {
+                out[n].sin_family = AF_INET;
+                out[n].sin_port = htons(53);
+                n++;
+            }
+        }
+        p = p->Next;
+    }
+    u_free(fi);
+    return n;
+}
+#else
+int adns_system_servers(struct sockaddr_in* out, int max) {
+    if (!out || max <= 0) return 0;
+    FILE* f = fopen("/etc/resolv.conf", "r");
+    if (!f) return 0;
+    char buf[4096];
+    size_t rd = fread(buf, 1, sizeof(buf) - 1, f);
+    fclose(f);
+    buf[rd] = '\0';
+    return adns_parse_resolv_conf(buf, out, max);
+}
+#endif
+
+/* ─── синхронный /etc/hosts-лукап (быстрый путь, без libdns) ─── */
+
+// Ищет name в /etc/hosts. Возвращает 1 если найден IPv4-адрес (out заполнен).
+// Блокирующее чтение небольшого файла — только для локальных имён (localhost и т.п.).
+static int adns_hosts_lookup(const char* name, struct sockaddr_in* out) {
+#ifndef _WIN32
+    if (!name || !out) return 0;
+    FILE* f = fopen("/etc/hosts", "r");
+    if (!f) return 0;
+    char line[512];
+    int found = 0;
+    while (!found && fgets(line, sizeof(line), f)) {
+        char ip[64]; int n = 0;
+        const char* p = line;
+        while (*p && !isspace(*p) && n < 63) ip[n++] = *p++;
+        ip[n] = '\0';
+        if (!ip[0] || ip[0] == '#') continue;
+        struct in_addr a;
+        if (inet_pton(AF_INET, ip, &a) != 1) continue;
+        while (*p && isspace(*p)) p++;
+        while (*p && *p != '\n') {
+            if (*p == '#') break;
+            char h[256]; int hn = 0;
+            while (*p && !isspace(*p) && *p != '#' && hn < 255) h[hn++] = *p++;
+            h[hn] = '\0';
+            if (h[0] && strcasecmp(h, name) == 0) {
+                memset(out, 0, sizeof(*out));
+                out->sin_family = AF_INET;
+                out->sin_addr = a;
+                found = 1;
+                break;
+            }
+            while (*p && isspace(*p)) p++;
+        }
+    }
+    fclose(f);
+    return found;
+#else
+    (void)name; (void)out;
+    return 0;
+#endif
+}
+
+/* ─── resolver setup ─── */
+
+static struct dns_resolver* adns_open_resolver(const struct sockaddr_in* servers, int count,
+                                               int timeout_ms, int attempts) {
+    int error = 0;
+    struct dns_resolv_conf* rc = dns_resconf_open(&error);
+    if (!rc) {
+        DEBUG_ERROR(ADNS_DEBUG_CAT, "adns: dns_resconf_open failed: %s", dns_strerror(error));
+        return NULL;
+    }
+
+    for (int i = 0; i < count && i < 3; i++) {
+        struct sockaddr_storage* ss = &rc->nameserver[i];
+        struct sockaddr_in* sin = (struct sockaddr_in*)ss;
+        memset(ss, 0, sizeof(*ss));
+        sin->sin_family = AF_INET;
+        sin->sin_addr = servers[i].sin_addr;
+        sin->sin_port = servers[i].sin_port ? servers[i].sin_port : htons(53);
+    }
+    if (timeout_ms > 0) {
+        unsigned sec = (unsigned)((timeout_ms + 999) / 1000);
+        rc->options.timeout = sec ? sec : 1;
+    }
+    if (attempts > 0) rc->options.attempts = (unsigned)attempts;
+
+    struct dns_hosts* hosts = dns_hosts_open(&error);
+    if (!hosts) {
+        DEBUG_ERROR(ADNS_DEBUG_CAT, "adns: dns_hosts_open failed: %s", dns_strerror(error));
+        dns_resconf_close(rc);
+        return NULL;
+    }
+#ifndef _WIN32
+    // Локальные имена из /etc/hosts (localhost и т.п.). Не фатально, если файла нет.
+    if (dns_hosts_loadpath(hosts, "/etc/hosts") != 0)
+        DEBUG_DEBUG(ADNS_DEBUG_CAT, "adns: /etc/hosts not loaded");
+#endif
+
+    struct dns_hints* hints = dns_hints_local(rc, &error);
+    if (!hints) {
+        DEBUG_ERROR(ADNS_DEBUG_CAT, "adns: dns_hints_local failed: %s", dns_strerror(error));
+        dns_hosts_close(hosts);
+        dns_resconf_close(rc);
+        return NULL;
+    }
+
+    struct dns_resolver* res = dns_res_open(rc, hosts, hints, NULL, NULL, &error);
+    dns_resconf_close(rc);
+    dns_hosts_close(hosts);
+    dns_hints_close(hints);
+
+    if (!res)
+        DEBUG_ERROR(ADNS_DEBUG_CAT, "adns: dns_res_open failed: %s", dns_strerror(error));
+    return res;
+}
+
+/* ─── driving state machine ─── */
+
+static void adns_teardown(struct adns_query* q) {
+    if (q->timer) { uasync_cancel_timeout(q->ua, q->timer); q->timer = NULL; }
+    if (q->socket_id) {
+        uasync_remove_socket_t(q->ua, (socket_t)q->cur_fd);
+        q->socket_id = NULL;
+    }
+    q->cur_fd = -1;
+    if (q->res) { dns_res_close(q->res); q->res = NULL; }
+}
+
+static void adns_rearm(struct adns_query* q) {
+    int fd = dns_res_pollfd(q->res);
+    int events = dns_res_events(q->res);
+
+    if (fd != q->cur_fd) {
+        if (q->socket_id) {
+            uasync_remove_socket_t(q->ua, (socket_t)q->cur_fd);
+            q->socket_id = NULL;
+        }
+        q->cur_fd = -1;
+        if (fd >= 0) {
+            q->socket_id = uasync_add_socket_t(q->ua, (socket_t)fd, adns_read_cb, adns_write_cb, NULL, q);
+            if (q->socket_id) q->cur_fd = fd;
+            else DEBUG_ERROR(ADNS_DEBUG_CAT, "adns: uasync_add_socket_t(%d) failed", fd);
+        }
+    }
+
+    if (q->socket_id) {
+        uasync_set_socket_read(q->ua, q->socket_id, (events & DNS_POLLIN) ? 1 : 0);
+        uasync_set_socket_write(q->ua, q->socket_id, (events & DNS_POLLOUT) ? 1 : 0);
+    }
+
+    time_t t = dns_res_timeout(q->res);
+    if (t < 1) t = 1;
+    if (q->timer) { uasync_cancel_timeout(q->ua, q->timer); q->timer = NULL; }
+    q->timer = uasync_set_timeout(q->ua, (int)(t * 10000), q, adns_timer_cb, "adns");
+    if (!q->timer)
+        DEBUG_ERROR(ADNS_DEBUG_CAT, "adns: uasync_set_timeout failed");
+}
+
+static void adns_drive(struct adns_query* q) {
+    if (q->finished) return;
+
+    int error = dns_res_check(q->res);
+    if (error == 0) {
+        int ferr = 0;
+        struct dns_packet* answer = dns_res_fetch(q->res, &ferr);
+        if (!answer) {
+            DEBUG_ERROR(ADNS_DEBUG_CAT, "adns: '%s' dns_res_fetch failed: %s", q->name, dns_strerror(ferr));
+            adns_finish(q, ADNS_ERR_RESPONSE, NULL, 0);
+            return;
+        }
+
+        unsigned rcode = dns_p_rcode(answer);
+        if (rcode == DNS_RC_NOERROR) {
+            struct sockaddr_in addrs[ADNS_MAX_ADDRS];
+            int n = 0;
+            struct dns_rr rr;
+            struct dns_a a;
+            dns_rr_foreach(&rr, answer, .section = DNS_S_AN, .type = DNS_T_A) {
+                if (n >= ADNS_MAX_ADDRS) break;
+                dns_a_parse(&a, &rr, answer);
+                memset(&addrs[n], 0, sizeof(addrs[n]));
+                addrs[n].sin_family = AF_INET;
+                addrs[n].sin_addr = a.addr;
+                n++;
+            }
+            free(answer);
+            if (n > 0) {
+                char ip[INET_ADDRSTRLEN];
+                inet_ntop(AF_INET, &addrs[0].sin_addr, ip, sizeof(ip));
+                DEBUG_INFO(ADNS_DEBUG_CAT, "adns: '%s' resolved to %d A record(s), first=%s", q->name, n, ip);
+                adns_finish(q, ADNS_OK, addrs, n);
+            } else {
+                DEBUG_WARN(ADNS_DEBUG_CAT, "adns: '%s' no A records (NOERROR, empty answer)", q->name);
+                adns_finish(q, ADNS_ERR_NODATA, NULL, 0);
+            }
+        } else {
+            const char* rc = dns_strrcode((enum dns_rcode)rcode);
+            if (rcode == DNS_RC_NXDOMAIN) {
+                free(answer);
+                DEBUG_WARN(ADNS_DEBUG_CAT, "adns: '%s' NXDOMAIN", q->name);
+                adns_finish(q, ADNS_ERR_NODATA, NULL, 0);
+            } else if (rcode == DNS_RC_SERVFAIL) {
+                /* libdns синтезирует SERVFAIL и при таймауте (ответа не получено) */
+                const struct dns_stat* st = dns_res_stat(q->res);
+                int no_resp = st && st->udp.rcvd.count == 0;
+                free(answer);
+                if (no_resp) {
+                    DEBUG_WARN(ADNS_DEBUG_CAT, "adns: '%s' timed out (no response from nameservers)", q->name);
+                    adns_finish(q, ADNS_ERR_TIMEOUT, NULL, 0);
+                } else {
+                    DEBUG_WARN(ADNS_DEBUG_CAT, "adns: '%s' SERVFAIL", q->name);
+                    adns_finish(q, ADNS_ERR_RESPONSE, NULL, 0);
+                }
+            } else {
+                free(answer);
+                DEBUG_WARN(ADNS_DEBUG_CAT, "adns: '%s' rcode=%s — response error", q->name, rc);
+                adns_finish(q, ADNS_ERR_RESPONSE, NULL, 0);
+            }
+        }
+        return;
+    }
+
+    if (error == EAGAIN) {
+        adns_rearm(q);
+        return;
+    }
+
+    DEBUG_ERROR(ADNS_DEBUG_CAT, "adns: '%s' dns_res_check error=%d (%s)", q->name, error, dns_strerror(error));
+    adns_finish(q, ADNS_ERR_RESPONSE, NULL, 0);
+}
+
+static void adns_read_cb(socket_t sock, void* arg) {
+    (void)sock;
+    adns_drive((struct adns_query*)arg);
+}
+
+static void adns_write_cb(socket_t sock, void* arg) {
+    (void)sock;
+    adns_drive((struct adns_query*)arg);
+}
+
+static void adns_timer_cb(void* arg) {
+    struct adns_query* q = (struct adns_query*)arg;
+    q->timer = NULL;
+    adns_drive(q);
+}
+
+static void adns_finish(struct adns_query* q, int status, struct sockaddr_in* addrs, int count) {
+    if (q->finished) return;
+    q->finished = 1;
+
+    adns_teardown(q);
+
+    struct adns_result res;
+    res.status = status;
+    res.count = count > 0 ? count : 0;
+    if (res.count > 0 && addrs) memcpy(res.addrs, addrs, (size_t)res.count * sizeof(*addrs));
+
+    adns_done_cb cb = q->cb;
+    void* arg = q->arg;
+    char* name = q->name;
+    q->name = NULL;
+    u_free(q);
+
+    if (cb) cb(&res, arg);
+    u_free(name);
+}
+
+// Отложенный вызов коллбэка для fast-пути (/etc/hosts): сохраняет async-контракт
+// (adns_resolve возвращает handle, коллбэк вызывается в потоке event loop).
+static void adns_fast_ready_cb(void* arg) {
+    struct adns_query* q = (struct adns_query*)arg;
+    q->call_soon_id = NULL;
+    if (q->finished) return;   // отменён до срабатывания
+    q->finished = 1;
+    adns_done_cb cb = q->cb;
+    void* a = q->arg;
+    struct adns_result res = q->fast_result;
+    char* nm = q->name;
+    q->name = NULL;
+    u_free(q);
+    if (cb) cb(&res, a);
+    u_free(nm);
+}
+
+// Отложенный первый драйв slow-пути (libdns): adns_resolve возвращает живой handle,
+// а реальный запуск запроса происходит в event loop. Это исключает ситуацию, когда
+// dns_res_check завершается синхронно прямо внутри adns_resolve() и освобождает q
+// до того, как вызывающий код получил и сохранил handle.
+static void adns_drive_trampoline(void* arg) {
+    struct adns_query* q = (struct adns_query*)arg;
+    q->call_soon_id = NULL;
+    if (q->finished) return;   // отменён до срабатывания
+    adns_drive(q);
+}
+
+/* ─── public API ─── */
+
+struct adns_query* adns_resolve(struct UASYNC* ua, const char* name,
+                                const struct adns_opts* opts,
+                                adns_done_cb cb, void* arg) {
+    if (!ua || !name || !name[0] || !cb) return NULL;
+    if (strlen(name) > 255) { DEBUG_ERROR(ADNS_DEBUG_CAT, "adns: name too long"); return NULL; }
+
+    // Быстрый путь: имя из /etc/hosts (localhost и т.п.) — без libdns и сети.
+    // libdns по умолчанию идёт в DNS первым (lookup="bf"), поэтому локальные имена
+    // ждали бы таймаут DNS-запроса (2×2s); обрабатываем их сразу.
+    {
+        struct sockaddr_in ha;
+        if (adns_hosts_lookup(name, &ha)) {
+            struct adns_query* q = u_calloc(1, sizeof(*q));
+            if (!q) { DEBUG_ERROR(ADNS_DEBUG_CAT, "adns: calloc failed"); return NULL; }
+            q->ua = ua; q->cb = cb; q->arg = arg;
+            q->name = u_strdup(name);
+            if (!q->name) { u_free(q); DEBUG_ERROR(ADNS_DEBUG_CAT, "adns: strdup failed"); return NULL; }
+            q->fast = 1;
+            q->fast_result.status = ADNS_OK;
+            q->fast_result.count = 1;
+            q->fast_result.addrs[0] = ha;
+            q->call_soon_id = uasync_call_soon(ua, q, adns_fast_ready_cb);
+            if (!q->call_soon_id) { u_free(q->name); u_free(q); return NULL; }
+            DEBUG_DEBUG(ADNS_DEBUG_CAT, "adns: '%s' resolved from /etc/hosts (fast)", name);
+            return q;
+        }
+    }
+
+    struct sockaddr_in servers[3];
+    int count;
+    if (opts && opts->server.sin_family != 0) {
+        servers[0] = opts->server;
+        count = 1;
+    } else {
+        count = adns_system_servers(servers, 3);
+    }
+    if (count <= 0) {
+        DEBUG_ERROR(ADNS_DEBUG_CAT, "adns: no DNS servers available for '%s'", name);
+        return NULL;
+    }
+
+    int timeout_ms = (opts && opts->timeout_ms > 0) ? opts->timeout_ms : 2000;
+    int attempts = (opts && opts->max_attempts > 0) ? opts->max_attempts : 2;
+
+    struct adns_query* q = u_calloc(1, sizeof(*q));
+    if (!q) { DEBUG_ERROR(ADNS_DEBUG_CAT, "adns: calloc failed"); return NULL; }
+    q->ua = ua;
+    q->cb = cb;
+    q->arg = arg;
+    q->cur_fd = -1;
+    q->name = u_strdup(name);
+    if (!q->name) { u_free(q); DEBUG_ERROR(ADNS_DEBUG_CAT, "adns: strdup failed"); return NULL; }
+
+    q->res = adns_open_resolver(servers, count, timeout_ms, attempts);
+    if (!q->res) { u_free(q->name); u_free(q); return NULL; }
+
+    if (dns_res_submit(q->res, name, DNS_T_A, DNS_C_IN) != 0) {
+        DEBUG_ERROR(ADNS_DEBUG_CAT, "adns: dns_res_submit failed for '%s'", name);
+        dns_res_close(q->res);
+        u_free(q->name);
+        u_free(q);
+        return NULL;
+    }
+
+    DEBUG_DEBUG(ADNS_DEBUG_CAT, "adns: resolving '%s' via %d server(s), timeout=%dms attempts=%d",
+                name, count, timeout_ms, attempts);
+
+    q->call_soon_id = uasync_call_soon(ua, q, adns_drive_trampoline);
+    if (!q->call_soon_id) {
+        DEBUG_ERROR(ADNS_DEBUG_CAT, "adns: uasync_call_soon failed for '%s'", name);
+        dns_res_close(q->res);
+        u_free(q->name);
+        u_free(q);
+        return NULL;
+    }
+    return q;
+}
+
+void adns_cancel(struct adns_query* q) {
+    if (!q || q->finished) return;
+    q->finished = 1;
+    if (q->call_soon_id) { uasync_call_soon_cancel(q->ua, q->call_soon_id); q->call_soon_id = NULL; }
+    if (q->fast) {
+        u_free(q->name);
+        u_free(q);
+        return;
+    }
+    adns_teardown(q);
+    u_free(q->name);
+    u_free(q);
+}
@@ -0,0 +1,67 @@
+/*
+ * async_dns.h — асинхронный (неблокирующий) DNS-резолвер поверх uasync.
+ *
+ * Тонкий адаптер над libdns (lib/dns.c, MIT). Выполняет A-запросы без
+ * блокировки event loop: резолвер libdns управляется через uasync-сокеты и
+ * таймеры (интерфейс pollfd/events/timeout + submit/check/fetch).
+ *
+ * Поддерживает только A-записи (IPv4) — этого достаточно для NTP и текущего
+ * стека. TCP-fallback при truncation и компрессия имён — внутри libdns.
+ */
+#ifndef ASYNC_DNS_H
+#define ASYNC_DNS_H
+
+#include "u_async.h"
+#include "socket_compat.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#define ADNS_OK            0
+#define ADNS_ERR_NOMEM    -1
+#define ADNS_ERR_PARAM    -2
+#define ADNS_ERR_NOSERV   -3   /* нет ни одного DNS-сервера */
+#define ADNS_ERR_NODATA   -4   /* NXDOMAIN или нет A-записей */
+#define ADNS_ERR_TIMEOUT  -5
+#define ADNS_ERR_RESPONSE -6   /* malformed / SERVFAIL / прочая ошибка ответа */
+
+#define ADNS_MAX_ADDRS 8
+
+struct adns_result {
+    int status;
+    int count;
+    struct sockaddr_in addrs[ADNS_MAX_ADDRS];  /* AF_INET, sin_port = 0 */
+};
+
+typedef void (*adns_done_cb)(const struct adns_result* res, void* arg);
+
+struct adns_opts {
+    struct sockaddr_in server;   /* sin_family != 0 → использовать этот сервер (иначе системные) */
+    int timeout_ms;              /* таймаут на сервер, по умолчанию 2000 */
+    int max_attempts;            /* попыток на сервер, по умолчанию 2 */
+};
+
+struct adns_query;  /* opaque */
+
+/* Запускает асинхронный A-запрос. Коллбэк вызывается в потоке event loop.
+   Возвращает handle (NULL при немедленной ошибке: невалидные аргументы/нет памяти). */
+struct adns_query* adns_resolve(struct UASYNC* ua, const char* name,
+                                const struct adns_opts* opts,
+                                adns_done_cb cb, void* arg);
+
+/* Отмена ожидающего запроса: коллбэк НЕ вызывается. Только из потока loop. */
+void adns_cancel(struct adns_query* q);
+
+/* Системные DNS-серверы (IPv4). Возвращает количество; out[].sin_port = htons(53).
+   Локальное чтение (resolv.conf / GetNetworkParams), без сети. */
+int adns_system_servers(struct sockaddr_in* out, int max);
+
+/* Чистый парсер текста resolv.conf ("nameserver <ip>") — для юнит-тестов. */
+int adns_parse_resolv_conf(const char* text, struct sockaddr_in* out, int max);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* ASYNC_DNS_H */
@@ -0,0 +1,292 @@
+#include "audio_compressor.h"
+#include "debug_config.h"
+#include "mem.h"
+#include <math.h>
+#include <string.h>
+#include <stdlib.h>
+
+#define BLOCK_LEVELS_CHUNK 64
+#define PENDING_CHUNK       32
+
+struct audio_compressor {
+    audio_compressor_config_t cfg;
+    int enabled;
+
+    int block_samples;
+    int lookback_blocks;
+    int lookahead_blocks;
+    float rise_factor_per_block;
+    float max_gain;
+    float gain_smoothed;
+
+    float*   block_levels;
+    size_t   block_levels_count;
+    size_t   block_levels_cap;
+
+    struct pending_block {
+        int16_t* samples;
+        size_t   count;
+        size_t   level_index;
+    }*       pending;
+    size_t   pending_count;
+    size_t   pending_cap;
+
+    int16_t* accumulator;
+    size_t   accum_count;
+
+    int16_t* output;
+    size_t   output_size;
+    size_t   output_cap;
+
+    int dbg_counter;
+};
+
+struct audio_compressor* audio_compressor_create(void) {
+    struct audio_compressor* ac = u_calloc(1, sizeof(*ac));
+    if (!ac) {
+        DEBUG_ERROR(DEBUG_CATEGORY_GENERAL, "audio_compressor_create: OOM");
+        return NULL;
+    }
+    ac->enabled = 1;
+    ac->gain_smoothed = 1.0f;
+    DEBUG_INFO(DEBUG_CATEGORY_GENERAL, "audio_compressor_create: ok");
+    return ac;
+}
+
+void audio_compressor_destroy(struct audio_compressor* ac) {
+    if (!ac) return;
+    for (size_t i = 0; i < ac->pending_count; i++)
+        u_free(ac->pending[i].samples);
+    u_free(ac->pending);
+    u_free(ac->block_levels);
+    u_free(ac->accumulator);
+    u_free(ac->output);
+    u_free(ac);
+    DEBUG_DEBUG(DEBUG_CATEGORY_GENERAL, "audio_compressor_destroy");
+}
+
+void audio_compressor_configure(struct audio_compressor* ac, const audio_compressor_config_t* cfg) {
+    if (!ac || !cfg) return;
+    ac->cfg = *cfg;
+    if (ac->cfg.sample_rate <= 0) ac->cfg.sample_rate = 48000;
+    if (ac->cfg.channels <= 0)    ac->cfg.channels = 1;
+    if (ac->cfg.block_duration_ms <= 0) ac->cfg.block_duration_ms = 20;
+    if (ac->cfg.lookback_ms <= 0)  ac->cfg.lookback_ms = 200;
+    if (ac->cfg.lookahead_ms <= 0) ac->cfg.lookahead_ms = 100;
+    if (ac->cfg.target_level <= 0.0f) ac->cfg.target_level = 0.25f;
+
+    ac->block_samples = ac->cfg.sample_rate * ac->cfg.block_duration_ms / 1000 * ac->cfg.channels;
+    ac->lookback_blocks  = ac->cfg.lookback_ms / ac->cfg.block_duration_ms;
+    ac->lookahead_blocks = ac->cfg.lookahead_ms / ac->cfg.block_duration_ms;
+    ac->rise_factor_per_block = powf(ac->cfg.rise_rate_per_sec, (float)ac->cfg.block_duration_ms / 1000.0f);
+    ac->max_gain = powf(10.0f, ac->cfg.max_gain_db / 20.0f);
+
+    DEBUG_INFO(DEBUG_CATEGORY_GENERAL,
+        "audio_compressor_configure: rate=%d ch=%d block=%dms lookback=%dms lookahead=%dms maxGain=%.0fdB riseRate=%.1f/sec target=%.0fdBFS",
+        ac->cfg.sample_rate, ac->cfg.channels, ac->cfg.block_duration_ms,
+        ac->cfg.lookback_ms, ac->cfg.lookahead_ms, ac->cfg.max_gain_db,
+        ac->cfg.rise_rate_per_sec, 20.0f * log10f(ac->cfg.target_level));
+}
+
+void audio_compressor_reset(struct audio_compressor* ac) {
+    if (!ac) return;
+    for (size_t i = 0; i < ac->pending_count; i++)
+        u_free(ac->pending[i].samples);
+    ac->pending_count = 0;
+    ac->block_levels_count = 0;
+    ac->accum_count = 0;
+    ac->output_size = 0;
+    ac->gain_smoothed = 1.0f;
+    ac->dbg_counter = 0;
+}
+
+void audio_compressor_set_enabled(struct audio_compressor* ac, int enabled) {
+    if (!ac) return;
+    ac->enabled = enabled ? 1 : 0;
+}
+
+int audio_compressor_is_enabled(const struct audio_compressor* ac) {
+    return ac ? ac->enabled : 0;
+}
+
+static float compute_block_level(const int16_t* samples, size_t count) {
+    double sum_sq = 0.0;
+    float peak = 0.0f;
+    for (size_t i = 0; i < count; i++) {
+        float v = (float)samples[i] / 32768.0f;
+        sum_sq += (double)v * v;
+        float av = fabsf(v);
+        if (av > peak) peak = av;
+    }
+    float rms = (float)sqrt(sum_sq / (double)count);
+    return (rms * 2.0f + peak) / 2.0f;
+}
+
+static void ensure_output_cap(struct audio_compressor* ac, size_t needed) {
+    size_t want = ac->output_size + needed;
+    if (want <= ac->output_cap) return;
+    size_t new_cap = ac->output_cap ? ac->output_cap * 2 : 4096;
+    while (new_cap < want) new_cap *= 2;
+    int16_t* tmp = u_realloc(ac->output, new_cap * sizeof(int16_t));
+    if (!tmp) return;
+    ac->output = tmp;
+    ac->output_cap = new_cap;
+}
+
+static void append_output(struct audio_compressor* ac, const int16_t* samples, size_t count) {
+    ensure_output_cap(ac, count);
+    memcpy(ac->output + ac->output_size, samples, count * sizeof(int16_t));
+    ac->output_size += count;
+}
+
+static void ensure_block_levels_cap(struct audio_compressor* ac) {
+    if (ac->block_levels_count < ac->block_levels_cap) return;
+    size_t new_cap = ac->block_levels_cap ? ac->block_levels_cap * 2 : BLOCK_LEVELS_CHUNK;
+    float* tmp = u_realloc(ac->block_levels, new_cap * sizeof(float));
+    if (!tmp) return;
+    ac->block_levels = tmp;
+    ac->block_levels_cap = new_cap;
+}
+
+static void add_block_level(struct audio_compressor* ac, float level) {
+    ensure_block_levels_cap(ac);
+    ac->block_levels[ac->block_levels_count++] = level;
+}
+
+static void ensure_pending_cap(struct audio_compressor* ac) {
+    if (ac->pending_count < ac->pending_cap) return;
+    size_t new_cap = ac->pending_cap ? ac->pending_cap * 2 : PENDING_CHUNK;
+    struct pending_block* tmp = u_realloc(ac->pending, new_cap * sizeof(*tmp));
+    if (!tmp) return;
+    ac->pending = tmp;
+    ac->pending_cap = new_cap;
+}
+
+static void process_pending_block(struct audio_compressor* ac);
+
+void audio_compressor_push(struct audio_compressor* ac, const int16_t* samples, size_t count) {
+    if (!ac || !samples || count == 0) return;
+
+    if (!ac->enabled) {
+        append_output(ac, samples, count);
+        return;
+    }
+
+    size_t remaining = count;
+    const int16_t* src = samples;
+
+    while (remaining > 0) {
+        size_t need = (size_t)ac->block_samples - ac->accum_count;
+        size_t take = remaining < need ? remaining : need;
+
+        size_t new_cnt = ac->accum_count + take;
+        int16_t* tmp = u_realloc(ac->accumulator, new_cnt * sizeof(int16_t));
+        if (!tmp) return;
+        ac->accumulator = tmp;
+        memcpy(ac->accumulator + ac->accum_count, src, take * sizeof(int16_t));
+        ac->accum_count = new_cnt;
+
+        src += take;
+        remaining -= take;
+
+        if (ac->accum_count == (size_t)ac->block_samples) {
+            float level = compute_block_level(ac->accumulator, ac->accum_count);
+            add_block_level(ac, level);
+
+            ensure_pending_cap(ac);
+            ac->pending[ac->pending_count].samples    = ac->accumulator;
+            ac->pending[ac->pending_count].count       = ac->accum_count;
+            ac->pending[ac->pending_count].level_index = ac->block_levels_count - 1;
+            ac->pending_count++;
+
+            ac->accumulator = NULL;
+            ac->accum_count = 0;
+        }
+    }
+
+    while (ac->pending_count > (size_t)ac->lookahead_blocks)
+        process_pending_block(ac);
+}
+
+static void process_pending_block(struct audio_compressor* ac) {
+    if (ac->pending_count == 0) return;
+
+    size_t idx = ac->pending[0].level_index;
+
+    size_t win_start = idx >= (size_t)ac->lookback_blocks ? idx - (size_t)ac->lookback_blocks : 0;
+    size_t win_end = idx + (size_t)ac->lookahead_blocks;
+    if (win_end >= ac->block_levels_count) win_end = ac->block_levels_count - 1;
+
+    float envelope = 0.0f;
+    for (size_t i = win_start; i <= win_end; i++) {
+        if (ac->block_levels[i] > envelope) envelope = ac->block_levels[i];
+    }
+    if (envelope < 0.0001f) envelope = 0.0001f;
+
+    float G_raw = ac->cfg.target_level / envelope;
+    float G_prev = ac->gain_smoothed;
+
+    if (G_raw > ac->gain_smoothed) {
+        float max_rise = ac->gain_smoothed * ac->rise_factor_per_block;
+        ac->gain_smoothed = G_raw < max_rise ? G_raw : max_rise;
+    } else {
+        ac->gain_smoothed = G_raw;
+    }
+    if (ac->gain_smoothed > ac->max_gain) ac->gain_smoothed = ac->max_gain;
+
+    float gain_db = 20.0f * log10f(ac->gain_smoothed > 0.0001f ? ac->gain_smoothed : 0.0001f);
+    float prev_db = 20.0f * log10f(G_prev > 0.0001f ? G_prev : 0.0001f);
+    if (ac->dbg_counter % 25 == 0 || fabsf(gain_db - prev_db) > 3.0f) {
+        DEBUG_DEBUG(DEBUG_CATEGORY_GENERAL, "audio_compressor: block %zu level=%.4f envelope=%.4f gainRaw=%.1fdB gain=%.1fdB",
+                    idx, ac->block_levels[idx], envelope, 20.0f * log10f(G_raw), gain_db);
+    }
+    ac->dbg_counter++;
+
+    for (size_t i = 0; i < ac->pending[0].count; i++) {
+        float v = (float)ac->pending[0].samples[i] * ac->gain_smoothed;
+        if (v > 32767.0f) v = 32767.0f;
+        if (v < -32768.0f) v = -32768.0f;
+        ac->pending[0].samples[i] = (int16_t)(int)v;
+    }
+    append_output(ac, ac->pending[0].samples, ac->pending[0].count);
+    u_free(ac->pending[0].samples);
+
+    /* shift remaining pending blocks down */
+    if (ac->pending_count > 1)
+        memmove(ac->pending, ac->pending + 1, (ac->pending_count - 1) * sizeof(*ac->pending));
+    ac->pending_count--;
+}
+
+void audio_compressor_flush(struct audio_compressor* ac) {
+    if (!ac) return;
+    if (!ac->enabled) return;
+
+    if (ac->accum_count > 0) {
+        float level = compute_block_level(ac->accumulator, ac->accum_count);
+        add_block_level(ac, level);
+
+        ensure_pending_cap(ac);
+        ac->pending[ac->pending_count].samples    = ac->accumulator;
+        ac->pending[ac->pending_count].count       = ac->accum_count;
+        ac->pending[ac->pending_count].level_index = ac->block_levels_count - 1;
+        ac->pending_count++;
+
+        ac->accumulator = NULL;
+        ac->accum_count = 0;
+    }
+
+    if (ac->pending_count > 0)
+        DEBUG_INFO(DEBUG_CATEGORY_GENERAL, "audio_compressor_flush: %zu pending blocks (gainSmoothed=%.1fdB)",
+                   ac->pending_count, 20.0f * log10f(ac->gain_smoothed > 0.0001f ? ac->gain_smoothed : 0.0001f));
+
+    while (ac->pending_count > 0)
+        process_pending_block(ac);
+}
+
+const int16_t* audio_compressor_output(const struct audio_compressor* ac) {
+    return ac ? ac->output : NULL;
+}
+
+size_t audio_compressor_output_size(const struct audio_compressor* ac) {
+    return ac ? ac->output_size : 0;
+}
@@ -0,0 +1,43 @@
+#ifndef AUDIO_COMPRESSOR_H
+#define AUDIO_COMPRESSOR_H
+
+#include <stdint.h>
+#include <stddef.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+struct audio_compressor;
+
+typedef struct {
+    int sample_rate;
+    int channels;
+    int block_duration_ms;
+    int lookback_ms;
+    int lookahead_ms;
+    float max_gain_db;
+    float rise_rate_per_sec;
+    float target_level;
+} audio_compressor_config_t;
+
+struct audio_compressor* audio_compressor_create(void);
+void audio_compressor_destroy(struct audio_compressor* ac);
+
+void audio_compressor_configure(struct audio_compressor* ac, const audio_compressor_config_t* cfg);
+void audio_compressor_reset(struct audio_compressor* ac);
+
+void audio_compressor_set_enabled(struct audio_compressor* ac, int enabled);
+int  audio_compressor_is_enabled(const struct audio_compressor* ac);
+
+void audio_compressor_push(struct audio_compressor* ac, const int16_t* samples, size_t count);
+void audio_compressor_flush(struct audio_compressor* ac);
+
+const int16_t* audio_compressor_output(const struct audio_compressor* ac);
+size_t         audio_compressor_output_size(const struct audio_compressor* ac);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif
@@ -1,207 +1,361 @@
 /**
- * Debug configuration implementation
- * Runtime debug configuration system for flexible debug output control
+ * Debug module
 */

 #include "debug_config.h"
+#include "platform_compat.h"
+#include "mem.h"
 #include <stdlib.h>
 #include <string.h>
 #include <errno.h>
 #include <ctype.h>
-#include <pthread.h>
 #include <stdarg.h>
 #include <stdio.h>
+#include <time.h>

-/* Global debug configuration */
-debug_config_t g_debug_config = {
-    .level = DEBUG_LEVEL_ERROR,
-    .categories = DEBUG_CATEGORY_ALL,
-    .timestamp_enabled = 1,
-    .function_name_enabled = 1,
-    .file_line_enabled = 1,
-    .color_enabled = 1,
-    .max_output_per_second = 0,
-    .output_file = NULL
+void log_dump(int level, int category, const char* prefix, const uint8_t* data, size_t len) {
+    if (!debug_should_output(level, category)) return;
+
+    char hex_buf[513] = {'\0'};
+    size_t hex_len = 0;
+    size_t show_len = (len > 128) ? 128 : len;
+
+    for (size_t i = 0; i < show_len && hex_len < 512 - 3; i++) {
+        hex_len += snprintf(hex_buf + hex_len, sizeof(hex_buf) - hex_len, "%02x", data[i]);
+        if (i < show_len - 1 && (i + 1) % 32 == 0)
+            hex_len += snprintf(hex_buf + hex_len, sizeof(hex_buf) - hex_len, " ");
+    }
+
+    if (len > 128)
+        hex_len += snprintf(hex_buf + hex_len, sizeof(hex_buf) - hex_len, "...");
+
+    switch (level) {
+    case DEBUG_LEVEL_ERROR: DEBUG_ERROR(category, "%s: len=%zu hex=%s", prefix, len, hex_buf); break;
+    case DEBUG_LEVEL_WARN:  DEBUG_WARN(category, "%s: len=%zu hex=%s", prefix, len, hex_buf); break;
+    case DEBUG_LEVEL_INFO:  DEBUG_INFO(category, "%s: len=%zu hex=%s", prefix, len, hex_buf); break;
+    case DEBUG_LEVEL_DEBUG: DEBUG_DEBUG(category, "%s: len=%zu hex=%s", prefix, len, hex_buf); break;
+    case DEBUG_LEVEL_TRACE: DEBUG_TRACE(category, "%s: len=%zu hex=%s", prefix, len, hex_buf); break;
+    }
+}
+
+
+ip_str_t ip_to_str(const void *addr, int family) {
+    ip_str_t result;
+    result.str[0] = '\0';
+
+    if (!addr) {
+        return result;
+    }
+
+    if (family == AF_INET) {
+        inet_ntop(AF_INET, addr, result.str, 16);
+    } else if (family == AF_INET6) {
+        inet_ntop(AF_INET6, addr, result.str, 48);
+    }
+
+    return result;
+}
+
+ip_str_t sockaddr_storage_to_str(const struct sockaddr_storage *addr) {
+    ip_str_t result;
+    result.str[0] = '\0';
+
+    if (!addr) {
+        return result;
+    }
+
+    char ip_buf[INET6_ADDRSTRLEN];
+    ip_buf[0] = '\0';
+
+    uint16_t port = 0;
+    void *src = NULL;
+
+    if (addr->ss_family == AF_INET) {
+        const struct sockaddr_in *ipv4 = (const struct sockaddr_in *)addr;
+        src = (void *)&ipv4->sin_addr;
+        port = ntohs(ipv4->sin_port);
+    }
+    else if (addr->ss_family == AF_INET6) {
+        const struct sockaddr_in6 *ipv6 = (const struct sockaddr_in6 *)addr;
+        src = (void *)&ipv6->sin6_addr;
+        port = ntohs(ipv6->sin6_port);
+    }
+    else {
+        return result;
+    }
+
+    if (!inet_ntop(addr->ss_family, src, ip_buf, sizeof(ip_buf))) {
+        return result;
+    }
+
+    if (addr->ss_family == AF_INET6) {
+        // IPv6 обязательно в []
+        snprintf(result.str, sizeof(result.str), "[%s]:%u", ip_buf, port);
+    } else {
+        snprintf(result.str, sizeof(result.str), "%s:%u", ip_buf, port);
+    }
+
+    return result;
+}
+
+
+
+static const struct {
+    const char* name;
+    debug_category_t category;
+} g_debug_categories[] = {
+    {"none", DEBUG_CATEGORY_NONE},
+    {"sys", DEBUG_CATEGORY_SYS},
+    {"connection", DEBUG_CATEGORY_CONNECTION},
+    {"etcp", DEBUG_CATEGORY_ETCP},
+    {"crypto", DEBUG_CATEGORY_CRYPTO},
+    {"config", DEBUG_CATEGORY_CONFIG},
+    {"tun", DEBUG_CATEGORY_TUN},
+    {"routing", DEBUG_CATEGORY_ROUTING},
+    {"timers", DEBUG_CATEGORY_TIMERS},
+    {"bgp", DEBUG_CATEGORY_BGP},
+    {"chat", DEBUG_CATEGORY_CHAT},
+    {"socket", DEBUG_CATEGORY_SOCKET},
+    {"control", DEBUG_CATEGORY_CONTROL},
+    {"dump", DEBUG_CATEGORY_DUMP},
+    {"traffic", DEBUG_CATEGORY_TRAFFIC},
+    {"debug", DEBUG_CATEGORY_DEBUG},
+    {"general", DEBUG_CATEGORY_GENERAL},
+    {"nat", DEBUG_CATEGORY_NAT},
+    {"keepalive", DEBUG_CATEGORY_KEEPALIVE},
+    {"media", DEBUG_CATEGORY_MEDIA},
+    {"etcp_route", DEBUG_CATEGORY_ETCPROUTE},
+    {"etcp_dump", DEBUG_CATEGORY_ETCP_DUMP},
+    {"chat_sync", DEBUG_CATEGORY_CHAT_SYNC},
+    {"member_sync", DEBUG_CATEGORY_MEMBER_SYNC},
+    {"proxy", DEBUG_CATEGORY_PROXY},
+    {"video", DEBUG_CATEGORY_VIDEO},
+    {"reality", DEBUG_CATEGORY_REALITY},
+    {"dm", DEBUG_CATEGORY_DM},
+    {"call", DEBUG_CATEGORY_CALL},
+    {"all", DEBUG_CATEGORY_ALL},
+    {NULL, DEBUG_CATEGORY_NONE}
 };

-/* Output file handle */
-FILE* debug_output_file = NULL;
+static const struct {
+    const char* name;
+    debug_level_t level;
+} g_level_table[] = {
+    {"disabled", DEBUG_LEVEL_DISABLED},
+    {"none",     DEBUG_LEVEL_NONE},
+    {"error",    DEBUG_LEVEL_ERROR},
+    {"warn",     DEBUG_LEVEL_WARN},
+    {"info",     DEBUG_LEVEL_INFO},
+    {"debug",    DEBUG_LEVEL_DEBUG},
+    {"trace",    DEBUG_LEVEL_TRACE},
+    {NULL,       DEBUG_LEVEL_NONE}
+};

-/* Rate limiting */
-static size_t output_count = 0;
-static time_t last_output_time = 0;
-static pthread_mutex_t debug_mutex = PTHREAD_MUTEX_INITIALIZER;
+debug_category_t get_category_by_name(const char* name) {
+    if (!name) return DEBUG_CATEGORY_NONE;
+    for (int i = 0; g_debug_categories[i].name; i++) {
+        if (strcasecmp(g_debug_categories[i].name, name) == 0) {
+            return g_debug_categories[i].category;
+        }
+    }
+    return DEBUG_CATEGORY_NONE;
+}

-/* ANSI color codes */
-static const char* color_red = "\033[31m";
-static const char* color_yellow = "\033[33m";
-static const char* color_green = "\033[32m";
-static const char* color_blue = "\033[34m";
-static const char* color_magenta = "\033[35m";
-static const char* color_cyan = "\033[36m";
-static const char* color_reset = "\033[0m";
+debug_level_t debug_level_from_name(const char* name) {
+    if (!name) return DEBUG_LEVEL_NONE;
+    for (int i = 0; g_level_table[i].name; i++) {
+        if (strcasecmp(g_level_table[i].name, name) == 0) {
+            return g_level_table[i].level;
+        }
+    }
+    DEBUG_ERROR(DEBUG_CATEGORY_CONFIG, "Invalid debug level '%s' (valid: disabled,none,error,warn,info,debug,trace)", name);
+    return DEBUG_LEVEL_INFO;  /* fallback */
+}
+
+void debug_set_category_level_by_name(const char* category_name, const char* level_name) {
+    if (!category_name || !level_name) return;
+    debug_category_t cat = get_category_by_name(category_name);
+    if (cat == DEBUG_CATEGORY_NONE) {
+        DEBUG_ERROR(DEBUG_CATEGORY_CONFIG, "Unknown debug category '%s'", category_name);
+        return;
+    }
+    debug_level_t lvl = debug_level_from_name(level_name);
+    debug_set_category_level(cat, lvl);
+}
+
+int debug_apply_category_config(const char* category_name, const char* level_name) {
+    if (!category_name || !level_name) return -1;
+    debug_category_t cat = get_category_by_name(category_name);
+    if (cat == DEBUG_CATEGORY_NONE) {
+        DEBUG_ERROR(DEBUG_CATEGORY_CONFIG, "Unknown debug category '%s'", category_name);
+        return -1;
+    }
+    debug_level_t lvl = debug_level_from_name(level_name);
+    debug_set_category_level(cat, lvl);
+    DEBUG_INFO(DEBUG_CATEGORY_CONFIG, "Applied per-category debug: %s=%s", category_name, level_name);
+    return 0;
+}
+
+void debug_apply_global_level(const char* level_name) {
+    if (!level_name || !*level_name) return;
+    debug_level_t level = debug_level_from_name(level_name);
+    debug_set_level(level);
+    DEBUG_INFO(DEBUG_CATEGORY_CONFIG, "Applied global debug_level: %s", level_name);
+}
+
+/* Get category name for logging */
+const char* debug_get_category_name(debug_category_t category_idx) {
+    for (int i = 0; g_debug_categories[i].name; i++)
+        if (g_debug_categories[i].category == category_idx) return g_debug_categories[i].name;
+    return "UNKNOWN";
+}
+
+/* Global debug configuration */
+debug_config_t g_debug_config;
+static debug_log_hook_fn g_log_hook = NULL;

 /* Initialize debug system with default settings */
 void debug_config_init(void) {
-    pthread_mutex_lock(&debug_mutex);
-    
-    g_debug_config.level = DEBUG_LEVEL_ERROR;
-    g_debug_config.categories = DEBUG_CATEGORY_ALL;
+    g_debug_config.level = DEBUG_LEVEL_ERROR;        // Global level: errors only by default
+    for (int i = 0; i < DEBUG_CATEGORY_COUNT; i++) {
+        g_debug_config.category_levels[i] = DEBUG_LEVEL_NONE;  // 0 = disabled per category
+    }
    g_debug_config.timestamp_enabled = 1;
    g_debug_config.function_name_enabled = 1;
    g_debug_config.file_line_enabled = 1;
-    g_debug_config.color_enabled = 1;
-    g_debug_config.max_output_per_second = 0;
    g_debug_config.output_file = NULL;
    
-    if (debug_output_file && debug_output_file != stderr && debug_output_file != stdout) {
-        fclose(debug_output_file);
-    }
-    debug_output_file = stderr;
-    
-    output_count = 0;
-    last_output_time = 0;
-    
-    pthread_mutex_unlock(&debug_mutex);
+    // Dual output defaults
+    g_debug_config.file_output = NULL;                  // No file by default
+    g_debug_config.console_enabled = 1;                 // Console enabled
+    g_debug_config.thread_marker = 0;                   // No thread marker by default
 }

 /* Set debug level */
 void debug_set_level(debug_level_t level) {
-    pthread_mutex_lock(&debug_mutex);
    g_debug_config.level = level;
-    pthread_mutex_unlock(&debug_mutex);
 }

-/* Enable/disable specific categories */
-void debug_enable_category(debug_category_t category) {
-    pthread_mutex_lock(&debug_mutex);
-    g_debug_config.categories |= category;
-    pthread_mutex_unlock(&debug_mutex);
+/* Set debug level for specific category (0 = disabled, otherwise uses that level) */
+void debug_set_category_level(debug_category_t category_idx, debug_level_t level) {
+    if (category_idx == DEBUG_CATEGORY_NONE || category_idx >= DEBUG_CATEGORY_COUNT) return;
+    g_debug_config.category_levels[category_idx] = level;
 }

-void debug_disable_category(debug_category_t category) {
-    pthread_mutex_lock(&debug_mutex);
-    g_debug_config.categories &= ~category;
-    pthread_mutex_unlock(&debug_mutex);
+/* Enable/disable specific categories (now sets level) */
+void debug_enable_category(debug_category_t category_idx) {
+    if (category_idx >= 0 && category_idx < DEBUG_CATEGORY_COUNT) {
+        g_debug_config.category_levels[category_idx] = g_debug_config.level;
+    }
 }

-void debug_set_categories(uint32_t categories) {
-    pthread_mutex_lock(&debug_mutex);
-    g_debug_config.categories = categories;
-    pthread_mutex_unlock(&debug_mutex);
+void debug_disable_category(debug_category_t category_idx) {
+    if (category_idx >= 0 && category_idx < DEBUG_CATEGORY_COUNT) {
+        g_debug_config.category_levels[category_idx] = DEBUG_LEVEL_NONE;
+    }
 }

-/* Configure output options */
-void debug_enable_timestamp(int enable) {
-    pthread_mutex_lock(&debug_mutex);
-    g_debug_config.timestamp_enabled = enable;
-    pthread_mutex_unlock(&debug_mutex);
+void debug_set_categories(debug_category_t category_idx) {
+    /* Deprecated - use per-category levels */
+    if (category_idx >= 0 && category_idx < DEBUG_CATEGORY_COUNT) {
+        g_debug_config.category_levels[category_idx] = g_debug_config.level;
+    }
+}
+
+/* Set level for category (main API) */
+void debug_set_masks(debug_category_t category_idx, debug_level_t level) {
+    debug_set_category_level(category_idx, level);
 }

 void debug_enable_function_name(int enable) {
-    pthread_mutex_lock(&debug_mutex);
    g_debug_config.function_name_enabled = enable;
-    pthread_mutex_unlock(&debug_mutex);
 }

 void debug_enable_file_line(int enable) {
-    pthread_mutex_lock(&debug_mutex);
    g_debug_config.file_line_enabled = enable;
-    pthread_mutex_unlock(&debug_mutex);
-}
-
-void debug_enable_color(int enable) {
-    pthread_mutex_lock(&debug_mutex);
-    g_debug_config.color_enabled = enable;
-    pthread_mutex_unlock(&debug_mutex);
-}
-
-void debug_set_rate_limit(size_t max_per_second) {
-    pthread_mutex_lock(&debug_mutex);
-    g_debug_config.max_output_per_second = max_per_second;
-    pthread_mutex_unlock(&debug_mutex);
 }

 void debug_set_output_file(const char* file_path) {
-    pthread_mutex_lock(&debug_mutex);
+    if (g_debug_config.file_output) return;// уже установлен, кто первый того и тапки
+    FILE* new_file = fopen(file_path, "a");
+    if (new_file) {
+        g_debug_config.file_output = new_file;
+        g_debug_config.output_file = file_path;
+    }
+}
+
+/* Set console log level */
+void debug_enable_console(int enable) {
+    g_debug_config.console_enabled = enable;
+}
+
+/* Enable file output with optional truncation */
+void debug_enable_file_output(const char* file_path, int truncate) {
+    if (!file_path) return;
    
-    if (file_path == NULL) {
-        if (debug_output_file && debug_output_file != stderr && debug_output_file != stdout) {
-            fclose(debug_output_file);
-        }
-        debug_output_file = stderr;
-        g_debug_config.output_file = NULL;
-    } else {
-        FILE* new_file = fopen(file_path, "a");
-        if (new_file) {
-            if (debug_output_file && debug_output_file != stderr && debug_output_file != stdout) {
-                fclose(debug_output_file);
-            }
-            debug_output_file = new_file;
-            g_debug_config.output_file = file_path;
-        }
+    // Close existing file if open
+    if (g_debug_config.file_output) {
+        fclose(g_debug_config.file_output);
+        g_debug_config.file_output = NULL;
    }
    
-    pthread_mutex_unlock(&debug_mutex);
+    // Open new file
+    const char* mode = truncate ? "w" : "a";
+    FILE* new_file = fopen(file_path, mode);
+    if (new_file) {
+        g_debug_config.file_output = new_file;
+        g_debug_config.output_file = file_path;
+        g_debug_config.console_enabled = 0;
+    }
+}
+
+/* Disable file output */
+void debug_disable_file_output(void) {
+    if (g_debug_config.file_output) {
+        fclose(g_debug_config.file_output);
+        g_debug_config.file_output = NULL;
+        g_debug_config.output_file = NULL;
+    }
+}
+
+/* Reopen log file (append mode) for SIGHUP. Complete operation with full error logging. */
+int debug_reopen_log(void) {
+    if (!g_debug_config.output_file) {
+        DEBUG_WARN(DEBUG_CATEGORY_CONFIG, "No log path for reopen");
+        return -1;
+    }
+    const char* path = g_debug_config.output_file;
+    debug_disable_file_output();
+    debug_enable_file_output(path, 0);  // append
+    DEBUG_INFO(DEBUG_CATEGORY_CONFIG, "Log reopened: %s", path);
+    return 0;
 }

 /* Check if debug output should be shown for given level and category */
-int debug_should_output(debug_level_t level, debug_category_t category) {
-    pthread_mutex_lock(&debug_mutex);
-    
-    /* Check if category is enabled */
-    if (!(g_debug_config.categories & category)) {
-        pthread_mutex_unlock(&debug_mutex);
+int debug_should_output(debug_level_t level, debug_category_t category_idx) {
+    if (category_idx < 0 || category_idx >= DEBUG_CATEGORY_COUNT) {
        return 0;
    }
+
+    debug_level_t cat_level = g_debug_config.category_levels[category_idx];
+    if (cat_level == DEBUG_LEVEL_DISABLED) {
+        return 0;
+    }
+    if (cat_level == DEBUG_LEVEL_NONE) {
+        cat_level = g_debug_config.level;
+    }
    
    /* Check if level is sufficient */
-    if (level > g_debug_config.level) {
-        pthread_mutex_unlock(&debug_mutex);
+    if (level > cat_level) {
        return 0;
    }
    
-    /* Rate limiting check */
-    if (g_debug_config.max_output_per_second > 0) {
-        time_t current_time = time(NULL);
-        if (current_time != last_output_time) {
-            output_count = 0;
-            last_output_time = current_time;
-        }
-        
-        if (output_count >= g_debug_config.max_output_per_second) {
-            pthread_mutex_unlock(&debug_mutex);
-            return 0;
-        }
-        output_count++;
-    }
-    
-    pthread_mutex_unlock(&debug_mutex);
    return 1;
 }

-/* Get current debug level for a category */
-debug_level_t debug_get_effective_level(debug_category_t category) {
-    pthread_mutex_lock(&debug_mutex);
-    debug_level_t level = g_debug_config.level;
-    pthread_mutex_unlock(&debug_mutex);
-    return level;
-}
-
-/* Get color for debug level */
-static const char* get_level_color(debug_level_t level) {
-    if (!g_debug_config.color_enabled) {
-        return "";
-    }
-    
-    switch (level) {
-        case DEBUG_LEVEL_ERROR: return color_red;
-        case DEBUG_LEVEL_WARN:  return color_yellow;
-        case DEBUG_LEVEL_INFO:  return color_green;
-        case DEBUG_LEVEL_DEBUG: return color_blue;
-        case DEBUG_LEVEL_TRACE: return color_magenta;
-        default: return "";
-    }
+/* Get current debug level */
+debug_level_t debug_get_level(void) {
+    return g_debug_config.level;
 }

 /* Get level name */
@@ -217,67 +371,147 @@ static const char* get_level_name(debug_level_t level) {
 }

 /* Format and output debug message */
-void debug_output(debug_level_t level, debug_category_t category, 
+void debug_output(debug_level_t level, debug_category_t category_idx, 
                 const char* function, const char* file, int line,
                 const char* format, ...) {
    
-    pthread_mutex_lock(&debug_mutex);
+#define BUFFER_SIZE 4096
+    char buffer[BUFFER_SIZE];
+    int offset = 0;
+    size_t remaining = BUFFER_SIZE;
+    
+#define BUF_ADVANCE(n) do { offset += (int)(n); if (offset > (int)BUFFER_SIZE - 1) offset = (int)BUFFER_SIZE - 1; remaining = BUFFER_SIZE - (size_t)offset; } while(0)
    
    va_list args;
-    FILE* output = debug_output_file ? debug_output_file : stderr;
-    
-    /* Print timestamp if enabled */
-    if (g_debug_config.timestamp_enabled) {
-        time_t now = time(NULL);
-        struct tm* tm_info = localtime(&now);
-        char time_str[32];
-        strftime(time_str, sizeof(time_str), "%Y-%m-%d %H:%M:%S", tm_info);
-        fprintf(output, "[%s] ", time_str);
-    }
-    
-    /* Print level and color */
-    if (g_debug_config.color_enabled) {
-        fprintf(output, "%s[%s]%s ", get_level_color(level), get_level_name(level), color_reset);
-    } else {
-        fprintf(output, "[%s] ", get_level_name(level));
-    }
-    
-    /* Print category */
-    fprintf(output, "[%d] ", category);
-    
-    /* Print function name if enabled */
-    if (g_debug_config.function_name_enabled && function) {
-        fprintf(output, "%s() ", function);
-    }
-    
-    /* Print file:line if enabled */
-    if (g_debug_config.file_line_enabled && file) {
-        fprintf(output, "(%s:%d) ", file, line);
-    }
-    
-    /* Print the actual message */
    va_start(args, format);
-    vfprintf(output, format, args);
+    
+    /* Add timestamp with microseconds: hh:mm:ss-xxx.yyy */
+    struct timeval tv;
+    utun_gettimeofday(&tv, NULL);
+    time_t tv_sec = (time_t)tv.tv_sec;
+    struct tm* tm_info = localtime(&tv_sec);
+    char time_str[32];
+    strftime(time_str, sizeof(time_str), "%H:%M:%S", tm_info);
+    BUF_ADVANCE(snprintf(buffer + offset, remaining, "[%s-%03ld.%03ld] ", time_str, tv.tv_usec / 1000, tv.tv_usec % 1000));
+    
+    /* Add thread marker if set */
+    if (g_debug_config.thread_marker > 0) {
+        BUF_ADVANCE(snprintf(buffer + offset, remaining, "[%d] ", g_debug_config.thread_marker));
+    }
+    
+    /* Add level */
+    const char* level_name = get_level_name(level);
+    BUF_ADVANCE(snprintf(buffer + offset, remaining, "[%s] ", level_name));
+    
+    /* Add category name */
+    const char* cat_name = debug_get_category_name(category_idx);
+    BUF_ADVANCE(snprintf(buffer + offset, remaining, "[%s] ", cat_name));
+    
+    /* Add file:line if enabled */
+    if (g_debug_config.file_line_enabled && file) {
+        const char* bn = strrchr(file, '/');
+        bn = bn ? bn + 1 : file;
+        BUF_ADVANCE(snprintf(buffer + offset, remaining, "(%s:%d) ", bn, line));
+    }
+
+    /* Add function name if enabled */
+    if (g_debug_config.function_name_enabled && function) {
+        BUF_ADVANCE(snprintf(buffer + offset, remaining, "%s() ", function));
+    }
+    
+    /* Add the actual message */
+    BUF_ADVANCE(vsnprintf(buffer + offset, remaining, format, args));
+    
+    /* Add newline */
+    if (remaining > 1) {
+        buffer[offset] = '\n';
+        buffer[offset + 1] = '\0';
+    } else {
+        buffer[BUFFER_SIZE - 2] = '\n';
+        buffer[BUFFER_SIZE - 1] = '\0';
+    }
+#undef BUF_ADVANCE
+    
    va_end(args);
    
-    fprintf(output, "\n");
-    fflush(output);
+    /* Route to external hook (JNI bridge, etc.) */
+    if (g_log_hook) {
+        const char* cat_name = debug_get_category_name(category_idx);
+        g_log_hook((int)level, cat_name, buffer);
+    }
    
-    pthread_mutex_unlock(&debug_mutex);
+    /* Output to console if enabled and level is sufficient */
+    if (g_debug_config.file_output) {
+        fprintf(g_debug_config.file_output, "%s", buffer);
+        fflush(g_debug_config.file_output);
+    } else if (g_debug_config.console_enabled) {
+        fprintf(stdout, "%s", buffer);
+        fflush(stdout);
+    }
+#undef BUFFER_SIZE
 }

-/* Stub implementations for advanced features */
+void debug_set_log_hook(debug_log_hook_fn hook) {
+    g_log_hook = hook;
+}
+
+/* Parse debug configuration from string (e.g., "ll_queue:debug,uasync:info,memory:warn,etcp:error") */
 int debug_parse_config(const char* config_string) {
-    /* Simple parser - for now just return success */
+    if (!config_string || !*config_string) {
+        return 0;
+    }
+
+    char* str = u_strdup(config_string);
+    if (!str) {
+        return -1;
+    }
+
+    debug_category_t categories = 0;
+    debug_level_t level = DEBUG_LEVEL_NONE;
+
+    char* token = strtok(str, ",");
+    while (token) {
+        /* Trim leading spaces */
+        while (isspace(*token)) {
+            token++;
+        }
+
+        char* colon = strchr(token, ':');
+        if (!colon) {
+            u_free(str);
+            return -1;
+        }
+
+        *colon = '\0';
+        char* category_name = token;
+        char* level_name = colon + 1;
+
+        /* Trim leading spaces in level_name */
+        while (isspace(*level_name)) {
+            level_name++;
+        }
+
+        debug_category_t cat = get_category_by_name(category_name);
+        if (cat == DEBUG_CATEGORY_NONE) {
+            DEBUG_ERROR(DEBUG_CATEGORY_CONFIG, "Unknown debug category '%s'", category_name);
+            u_free(str);
+            return -1;
+        }
+
+        debug_level_t lev = debug_level_from_name(level_name);
+
+        /* Set per-category level */
+        int idx = 0;
+        while (!(cat & (1ULL << idx)) && idx < DEBUG_CATEGORY_COUNT) {
+            idx++;
+        }
+        if (idx < DEBUG_CATEGORY_COUNT) {
+            g_debug_config.category_levels[idx] = lev;
+        }
+
+        token = strtok(NULL, ",");
+    }
+
+    u_free(str);
    return 0;
 }
-
-int debug_parse_config_file(const char* file_path) {
-    /* Stub implementation */
-    return 0;
-}
-
-int debug_enable_config_reload(const char* file_path, int interval_seconds) {
-    /* Stub implementation */
-    return 0;
-}
@@ -1,144 +1,206 @@
-/**
-#include <stdio.h>
- * Runtime debug configuration system
- * Provides flexible control over debug output without recompilation
- */
-
+/**
+ * Runtime debug configuration system
+ * Provides flexible control over debug output without recompilation
+ */
+
 #ifndef DEBUG_CONFIG_H
 #define DEBUG_CONFIG_H

+#include "platform_compat.h"
+
+#ifdef _WIN32
+    #include <winsock2.h>
+    #include <ws2tcpip.h>
+#else
+    #include <sys/socket.h>   // struct sockaddr_storage
+#endif
+#include <stddef.h>       // size_t
 #include <stdint.h>
 #include <stddef.h>
 #include <time.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/* Debug levels */
-typedef enum {
-    DEBUG_LEVEL_NONE = 0,     // No debug output
-    DEBUG_LEVEL_ERROR = 1,    // Errors only
-    DEBUG_LEVEL_WARN = 2,     // Warnings and errors
-    DEBUG_LEVEL_INFO = 3,     // Info, warnings, errors
-    DEBUG_LEVEL_DEBUG = 4,    // Full debug output
-    DEBUG_LEVEL_TRACE = 5     // Trace everything
-} debug_level_t;
-
-/* Debug categories - can be combined with bitwise OR */
-typedef enum {
-    DEBUG_CATEGORY_NONE        = 0,
-    DEBUG_CATEGORY_UASYNC      = 1 << 0,   // u_async module
-    DEBUG_CATEGORY_LL_QUEUE    = 1 << 1,   // ll_queue module
-    DEBUG_CATEGORY_CONNECTION  = 1 << 2,   // connection module
-    DEBUG_CATEGORY_ETCP        = 1 << 3,   // etcp module
-    DEBUG_CATEGORY_CRYPTO      = 1 << 4,   // crypto operations
-    DEBUG_CATEGORY_MEMORY      = 1 << 5,   // memory management
-    DEBUG_CATEGORY_TIMING      = 1 << 6,   // timing/performance
-    DEBUG_CATEGORY_CONFIG      = 1 << 7,   // configuration parsing
-    DEBUG_CATEGORY_TUN         = 1 << 8,   // TUN interface
-    DEBUG_CATEGORY_ROUTING     = 1 << 9,   // routing table
-    DEBUG_CATEGORY_ALL         = 0xFFFFFFFF
-} debug_category_t;
-
-/* Debug configuration structure */
-typedef struct {
-    debug_level_t level;           // Global debug level
-    uint32_t categories;           // Enabled categories (bitmask)
-    int timestamp_enabled;         // Include timestamps in output
-    int function_name_enabled;     // Include function names
-    int file_line_enabled;         // Include file:line info
-    int color_enabled;             // Use ANSI colors (if terminal supports)
-    size_t max_output_per_second;  // Rate limiting (0 = unlimited)
-    const char* output_file;       // NULL = stderr, otherwise file path
+#include <stdio.h>        // FILE
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/* Debug levels */
+typedef enum {
+    DEBUG_LEVEL_DISABLED = -1, // Category completely disabled, never outputs
+    DEBUG_LEVEL_NONE     = 0,  // Fallback to global level
+    DEBUG_LEVEL_ERROR    = 1,  // Errors only
+    DEBUG_LEVEL_WARN     = 2,  // Warnings and errors
+    DEBUG_LEVEL_INFO     = 3,  // Info, warnings, errors
+    DEBUG_LEVEL_DEBUG    = 4,  // Full debug output
+    DEBUG_LEVEL_TRACE    = 5   // Trace everything
+} debug_level_t;
+
+/* Debug categories as indices (0-based) */
+typedef int debug_category_t;
+
+#define DEBUG_CATEGORY_NONE        0
+#define DEBUG_CATEGORY_SYS         1  // System: u_async, ll_queue, memory, timing
+// #define DEBUG_CATEGORY_LL_QUEUE  2  (merged into SYS)
+#define DEBUG_CATEGORY_CONNECTION  3  // Connection: connect/reconnect/disconnect events only
+#define DEBUG_CATEGORY_ETCP        4  // ETCP: protocol, BBR, normalizer
+#define DEBUG_CATEGORY_CRYPTO      5  // crypto operations
+// #define DEBUG_CATEGORY_MEMORY    6  (merged into SYS)
+// #define DEBUG_CATEGORY_TIMING    7  (merged into SYS)
+#define DEBUG_CATEGORY_CONFIG      8  // configuration parsing
+#define DEBUG_CATEGORY_TUN         9  // TUN interface
+#define DEBUG_CATEGORY_ROUTING     10  // routing table
+#define DEBUG_CATEGORY_TIMERS      11  // timer management
+// #define DEBUG_CATEGORY_NORMALIZER 12 (merged into ETCP)
+#define DEBUG_CATEGORY_BGP         13  // BGP route exchange
+#define DEBUG_CATEGORY_SOCKET      14  // Socket operations
+#define DEBUG_CATEGORY_CONTROL     15  // Control/monitoring server
+#define DEBUG_CATEGORY_DUMP        16  // Packet dump/logging
+#define DEBUG_CATEGORY_TRAFFIC     17  // Traffic flow (src/dst node IDs)
+#define DEBUG_CATEGORY_DEBUG       18  // Current debugging
+#define DEBUG_CATEGORY_GENERAL     19  // Messages for user (common log)
+#define DEBUG_CATEGORY_NAT         20  // EIM NAT module
+#define DEBUG_CATEGORY_KEEPALIVE   21  // Keepalive periodic monitoring only
+#define DEBUG_CATEGORY_ETCPROUTE   22  // ETCP routing
+#define DEBUG_CATEGORY_MEDIA       23  // Media delivery + media async
+#define DEBUG_CATEGORY_ETCP_DUMP   24  // ETCP packet dump
+#define DEBUG_CATEGORY_CHAT        25  // Chat modules (chat_core, whisper, etc.)
+#define DEBUG_CATEGORY_CHAT_SYNC    26  // Message DB sync (INIT_SYNC, PUSH, chain hash, recalc)
+#define DEBUG_CATEGORY_MEMBER_SYNC 27  // Member + address + merkle sync
+#define DEBUG_CATEGORY_PROXY      28  // Proxy modules (SOCKS5, TCP, UDP, ICMP)
+#define DEBUG_CATEGORY_VIDEO      29  // Video module (probe/transcode)
+#define DEBUG_CATEGORY_REALITY    30  // REALITY TLS camouflage
+#define DEBUG_CATEGORY_DM         31  // DM — direct p2p chat between two users
+#define DEBUG_CATEGORY_CALL       32  // Call — P2P audio call (signaling + media)
+#define DEBUG_CATEGORY_COUNT      33  // Total number of categories
+#define DEBUG_CATEGORY_ALL         (-1) // special value for all categories
+
+/* Debug configuration structure */
+typedef struct {
+    debug_level_t level;                   // Global debug level (default: ERROR)
+    debug_level_t category_levels[DEBUG_CATEGORY_COUNT];  // Per-category levels (0 = disabled)
+    int timestamp_enabled;                 // Include timestamps in output
+    int function_name_enabled;             // Include function names
+    int file_line_enabled;                 // Include file:line info
+    const char* output_file;               // NULL = stdout, otherwise file path
+    
+    // Dual output support
+    FILE* file_output;                     // File handle for log file (NULL if not open)
+    int console_enabled;                   // Enable console output
+    int thread_marker;                     // Thread identification (0=none, e.g. 2 for uasync)
 } debug_config_t;
-
-/* Global debug configuration */
-extern debug_config_t g_debug_config;
-
-/* Initialize debug system with default settings */
-void debug_config_init(void);
-
+
+/* Global debug configuration */
+extern debug_config_t g_debug_config;
+
+/* Initialize debug system with default settings */
+void debug_config_init(void);
+
 /* Set debug level */
+// итоговый level = max (global level - здесь задается, category level)
 void debug_set_level(debug_level_t level);

-/* Enable/disable specific categories */
-void debug_enable_category(debug_category_t category);
-void debug_disable_category(debug_category_t category);
-void debug_set_categories(uint32_t categories);
+/* Set debug level for specific category (0 = disabled, otherwise uses that level) */
+void debug_set_category_level(debug_category_t category, debug_level_t level);

+/* Enable/disable specific categories */
+void debug_enable_category(debug_category_t category);
+void debug_disable_category(debug_category_t category);
+void debug_set_categories(debug_category_t categories);
+
+/* Set masks directly */
+void debug_set_masks(debug_category_t categories, debug_level_t level);
+
 /* Configure output options */
 void debug_enable_timestamp(int enable);
 void debug_enable_function_name(int enable);
 void debug_enable_file_line(int enable);
-void debug_enable_color(int enable);
-void debug_set_rate_limit(size_t max_per_second);
 void debug_set_output_file(const char* file_path);

-/* Parse debug configuration from string (e.g., "uasync:debug,ll_queue:info") */
+/* Dual output configuration */
+void debug_enable_file_output(const char* file_path, int truncate);
+void debug_disable_file_output(void);
+int debug_reopen_log(void);
+void debug_enable_console(int enable);
+
+
+// IP address to string (static buffer, single-threaded)
+typedef struct {
+    char str[54];  // INET6_ADDRSTRLEN(45) + 6chars (:port) + \0
+} ip_str_t;
+
+ip_str_t ip_to_str(const void *addr, int family);// big endian addr
+ip_str_t sockaddr_storage_to_str(const struct sockaddr_storage *addr);// автоопределение v4 или v6
+
+// hex dump в лог
+void log_dump(int level, int category, const char* prefix, const uint8_t* data, size_t len);
+
+/* Check if debug output should be shown for given level and category */
+int debug_should_output(debug_level_t level, debug_category_t category_idx);
+
+/* Get current debug level */
+debug_level_t debug_get_level(void);
+
+/* Get category name by index */
+const char* debug_get_category_name(debug_category_t category_idx);
+
+/* Get category by name string */
+debug_category_t get_category_by_name(const char* name);
+
+/* Get level by name string with error reporting */
+debug_level_t debug_level_from_name(const char* name);
+
+/* Set category level using text names (main API) */
+void debug_set_category_level_by_name(const char* category_name, const char* level_name);
+
+/* Apply full category config with error reporting */
+int debug_apply_category_config(const char* category_name, const char* level_name);
+
+/* Apply global debug level from text name */
+void debug_apply_global_level(const char* level_name);
+
+/* Format and output debug message (internal use by macros) */
+void debug_output(debug_level_t level, debug_category_t category_idx, 
+                 const char* function, const char* file, int line,
+                 const char* format, ...);
+
+/* Log hook — if set, called with every debug message (for JNI/bridge integration) */
+typedef void (*debug_log_hook_fn)(int level, const char* category, const char* message);
+void debug_set_log_hook(debug_log_hook_fn hook);
+
+/* Parse debug configuration from string (e.g. "etcp=trace,config=info") */
 int debug_parse_config(const char* config_string);
-
-/* Parse debug configuration from file */
-int debug_parse_config_file(const char* file_path);
-
-/* Enable/disable automatic config file reloading */
-int debug_enable_config_reload(const char* file_path, int interval_seconds);
-
-#include <stdio.h>
-extern FILE* debug_output_file;
-
-/* Check if debug output should be shown for given level and category */
-int debug_should_output(debug_level_t level, debug_category_t category);
-
-/* Get current debug level for a category */
-debug_level_t debug_get_effective_level(debug_category_t category);
-
-/* Format and output debug message (internal use by macros) */
-void debug_output(debug_level_t level, debug_category_t category, 
-                 const char* function, const char* file, int line,
-                 const char* format, ...);
-
-/* Parse debug configuration from file */
-int debug_parse_config_file(const char* file_path);
-
-/* Enable/disable automatic config file reloading */
-int debug_enable_config_reload(const char* file_path, int interval_seconds);
-/* Format and output debug message (internal use by macros) */
-void debug_output(debug_level_t level, debug_category_t category, 
-                 const char* function, const char* file, int line,
-                 const char* format, ...);
-
-/* Convenience macros for debug output */
-#define DEBUG_ERROR(category, fmt, ...) \
-    do { if (debug_should_output(DEBUG_LEVEL_ERROR, category)) { \
-        debug_output(DEBUG_LEVEL_ERROR, category, __FUNCTION__, __FILE__, __LINE__, fmt, ##__VA_ARGS__); \
-    } } while(0)
-
-#define DEBUG_WARN(category, fmt, ...) \
-    do { if (debug_should_output(DEBUG_LEVEL_WARN, category)) { \
-        debug_output(DEBUG_LEVEL_WARN, category, __FUNCTION__, __FILE__, __LINE__, fmt, ##__VA_ARGS__); \
-    } } while(0)
-
-#define DEBUG_INFO(category, fmt, ...) \
-    do { if (debug_should_output(DEBUG_LEVEL_INFO, category)) { \
-        debug_output(DEBUG_LEVEL_INFO, category, __FUNCTION__, __FILE__, __LINE__, fmt, ##__VA_ARGS__); \
-    } } while(0)
-
-#define DEBUG_DEBUG(category, fmt, ...) \
-    do { if (debug_should_output(DEBUG_LEVEL_DEBUG, category)) { \
-        debug_output(DEBUG_LEVEL_DEBUG, category, __FUNCTION__, __FILE__, __LINE__, fmt, ##__VA_ARGS__); \
-    } } while(0)
-
-#define DEBUG_TRACE(category, fmt, ...) \
-    do { if (debug_should_output(DEBUG_LEVEL_TRACE, category)) { \
-        debug_output(DEBUG_LEVEL_TRACE, category, __FUNCTION__, __FILE__, __LINE__, fmt, ##__VA_ARGS__); \
-    } } while(0)
-
-/* Backward compatibility - default to ERROR level if not specified */
-#define DEBUG_OUTPUT(fmt, ...) DEBUG_ERROR(DEBUG_CATEGORY_ALL, fmt, ##__VA_ARGS__)
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif // DEBUG_CONFIG_H
+
+/* Convenience macros for debug output */
+#define DEBUG_ERROR(category, fmt, ...) \
+    do { if (debug_should_output(DEBUG_LEVEL_ERROR, category)) { \
+        debug_output(DEBUG_LEVEL_ERROR, category, __FUNCTION__, __FILE__, __LINE__, fmt, ##__VA_ARGS__); \
+    } } while(0)
+
+#define DEBUG_WARN(category, fmt, ...) \
+    do { if (debug_should_output(DEBUG_LEVEL_WARN, category)) { \
+        debug_output(DEBUG_LEVEL_WARN, category, __FUNCTION__, __FILE__, __LINE__, fmt, ##__VA_ARGS__); \
+    } } while(0)
+
+#define DEBUG_INFO(category, fmt, ...) \
+    do { if (debug_should_output(DEBUG_LEVEL_INFO, category)) { \
+        debug_output(DEBUG_LEVEL_INFO, category, __FUNCTION__, __FILE__, __LINE__, fmt, ##__VA_ARGS__); \
+    } } while(0)
+
+#define DEBUG_DEBUG(category, fmt, ...) \
+    do { if (debug_should_output(DEBUG_LEVEL_DEBUG, category)) { \
+        debug_output(DEBUG_LEVEL_DEBUG, category, __FUNCTION__, __FILE__, __LINE__, fmt, ##__VA_ARGS__); \
+    } } while(0)
+
+#define DEBUG_TRACE(category, fmt, ...) \
+    do { if (debug_should_output(DEBUG_LEVEL_TRACE, category)) { \
+        debug_output(DEBUG_LEVEL_TRACE, category, __FUNCTION__, __FILE__, __LINE__, fmt, ##__VA_ARGS__); \
+    } } while(0)
+
+/* Backward compatibility - default to ERROR level if not specified */
+#define DEBUG_OUTPUT(fmt, ...) DEBUG_ERROR(DEBUG_CATEGORY_ALL, fmt, ##__VA_ARGS__)
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // DEBUG_CONFIG_H
@@ -0,0 +1,112 @@
+# debug_config — Runtime-система отладочного логирования
+
+## 1. Назначение
+
+Модуль обеспечивает гибкое управление отладочным выводом без перекомпиляции. Позволяет:
+- Задавать **глобальный уровень** логирования (error/warn/info/debug/trace).
+- **Покатегорийно** включать/выключать или переопределять уровень (26 категорий: etcp, crypto, tun, routing, bgp, bbr, …).
+- Вести **двойной вывод**: в консоль (stdout) и/или в файл.
+- Настраивать формат сообщений (временные метки с микросекундами, имя функции, файл:строка).
+- Парсить конфигурационную строку вида `"etcp=trace,config=info"` из конфиг-файла.
+
+Логика вывода: итоговый уровень = **max(глобальный уровень, уровень категории)**. Сообщение печатается, если его уровень ≤ итогового.
+
+## 2. Как пользоваться
+
+### 2.1. Инициализация
+
+```c
+#include "debug_config.h"
+
+debug_config_init();                     // уровень по умолчанию: ERROR, консоль включена
+debug_set_level(DEBUG_LEVEL_INFO);       // поднять глобальный уровень до INFO
+debug_enable_file_output("/tmp/utun.log", 1);  // писать в файл (truncate=1)
+debug_apply_category_config("etcp", "trace");  // для ETCP-категории — всё
+```
+
+### 2.2. Макросы логирования
+
+```c
+DEBUG_ERROR(DEBUG_CATEGORY_CRYPTO, "Decrypt failed: len=%d", len);
+DEBUG_WARN(DEBUG_CATEGORY_ETCP, "Retransmit timeout, seq=%u", seq);
+DEBUG_INFO(DEBUG_CATEGORY_CONNECTION, "Socket created on port %d", port);
+DEBUG_DEBUG(DEBUG_CATEGORY_ROUTING, "Route added: %s -> %s", dst, gw);
+DEBUG_TRACE(DEBUG_CATEGORY_TUN, "Packet recv: %zu bytes", n);
+```
+
+Макросы делают проверку `debug_should_output()` **перед** вызовом `debug_output()`, поэтому дорогой `vsnprintf` не вызывается, если вывод не нужен.
+
+### 2.3. Конфигурационная строка
+
+Формат: `"категория=уровень,категория=уровень,..."`. Парсится вызовом `debug_parse_config()`. Пример из конфиг-файла:
+
+```ini
+debug = etcp=trace,config=info,crypto=error
+```
+
+Категории: `none, uasync, ll_queue, connection, etcp, crypto, memory, timing, config, tun, routing, timers, normalizer, bgp, socket, control, dump, traffic, debug, general, nat, keepalive, etcp_route, bbr, etcp_dump, connectivity, all`.
+
+Уровни: `disabled, none, error, warn, info, debug, trace`.
+
+**Важно:** старый формат `ll_queue:debug` (двоеточие) тоже работает через `debug_parse_config`, но в конфиге рекомендуется `=`.
+
+### 2.4. Двойной вывод (консоль + файл)
+
+- По умолчанию вывод в **stdout**.
+- `debug_enable_file_output(path, truncate)` — перенаправляет вывод в файл, консоль отключается.
+- `debug_disable_file_output()` — закрывает файл.
+- `debug_reopen_log()` — переоткрывает лог-файл (используется по SIGHUP для ротации).
+- `debug_enable_console(1/0)` — ручное управление консольным выводом.
+
+### 2.5. Вспомогательные утилиты
+
+```c
+log_dump(DEBUG_LEVEL_TRACE, DEBUG_CATEGORY_DUMP, "payload", data, len); // hex-дамп (до 128 байт)
+
+ip_str_t s = sockaddr_storage_to_str(&addr);   // "192.168.1.1:8080" или "[::1]:443"
+ip_str_t s = ip_to_str(&addr, AF_INET);        // "192.168.1.1" (без порта)
+```
+
+### 2.6. Нюансы
+
+- **Потокобезопасность:** модуль не потокобезопасен. Несколько потоков, одновременно вызывающих макросы, могут перемешать вывод (но не упадут). Файловый вывод использует `fflush()` после каждой строки.
+- **Буфер:** размер строки лога ограничен 4096 байт (`BUFFER_SIZE`), длинные сообщения обрезаются.
+- **`debug_set_output_file`** против `debug_enable_file_output`: первая вызывается один раз (кто первый — того и тапки), вторая позволяет переоткрыть файл.
+- **Флаг `-f` (foreground):** в foreground-режиме вывод идёт в stdout, в daemon-режиме — в файл.
+
+## 3. API
+
+| Функция/макрос | Назначение |
+|---|---|
+| `debug_config_init()` | Инициализация: глобальный уровень ERROR, консоль включена, метки времени/функций/файлов — да |
+| `debug_set_level(level)` | Задать глобальный уровень (ERROR..TRACE) |
+| `debug_set_category_level(cat, level)` | Задать уровень конкретной категории (0 = использовать глобальный) |
+| `debug_set_category_level_by_name("etcp", "trace")` | То же, но именами строк |
+| `debug_apply_category_config("etcp", "trace")` | Установить уровень категории с логированием результата |
+| `debug_apply_global_level("info")` | Установить глобальный уровень по имени строки |
+| `debug_parse_config("etcp=trace,config=info")` | Разобрать конфигурационную строку |
+| `debug_should_output(level, cat)` | Проверить, нужно ли выводить сообщение данного уровня/категории |
+| `debug_output(level, cat, func, file, line, fmt, ...)` | Форматировать и вывести сообщение (вызывается макросами) |
+| `debug_enable_file_output(path, truncate)` | Включить вывод в файл (консоль отключается) |
+| `debug_disable_file_output()` | Закрыть файл вывода |
+| `debug_reopen_log()` | Переоткрыть лог-файл (для SIGHUP/ротации) |
+| `debug_enable_console(1/0)` | Включить/выключить консольный вывод |
+| `debug_get_level()` | Получить текущий глобальный уровень |
+| `get_category_by_name("etcp")` | Получить ID категории по имени строки |
+| `debug_level_from_name("trace")` | Получить уровень по имени строки |
+| `debug_get_category_name(cat)` | Получить имя категории по ID |
+| `log_dump(level, cat, prefix, data, len)` | Hex-дамп данных (первые 128 байт) в лог |
+| `ip_to_str(addr, family)` | IP-адрес → строка (без порта). Статический буфер |
+| `sockaddr_storage_to_str(addr)` | sockaddr_storage → "ip:port" (IPv6 в скобках). Статический буфер |
+| `DEBUG_ERROR/WARN/INFO/DEBUG/TRACE(cat, fmt, ...)` | Макросы логирования с проверкой `debug_should_output()` |
+| `DEBUG_OUTPUT(fmt, ...)` | Устаревший макрос совместимости (ERROR, категория ALL) |
+
+**Глобальная переменная:** `g_debug_config` (тип `debug_config_t`) — хранит всё состояние системы логирования.
+
+**Структура `debug_config_t`:**
+- `level` — глобальный уровень (по умолчанию ERROR)
+- `category_levels[26]` — уровни по категориям (NONE = использовать глобальный, DISABLED = никогда не выводить)
+- `timestamp_enabled` / `function_name_enabled` / `file_line_enabled` — формат вывода
+- `file_output` — FILE* файла (NULL если вывод в консоль)
+- `console_enabled` — вывод в stdout
+- `thread_marker` — числовой маркер потока (0 = нет)
@@ -0,0 +1,102 @@
+/**
+ * getmyip.c - Определение локального IP-адреса для исходящих соединений
+ *
+ * Использует временный UDP-сокет с connect() для определения
+ * локального IP, который ОС выберет для заданного маршрута.
+ */
+
+#include "getmyip.h"
+#include "socket_compat.h"
+#include "debug_config.h"
+
+#ifdef _WIN32
+    #include <winsock2.h>
+    #include <ws2tcpip.h>
+#else
+    #include <unistd.h>
+    #include <arpa/inet.h>
+    #include <errno.h>
+#endif
+
+int get_outgoing_local_ip(const struct sockaddr_storage *local_addr,
+                          const struct sockaddr_storage *remote_addr,
+                          struct sockaddr_storage *result)
+{
+    if (!local_addr || !remote_addr || !result) {
+        DEBUG_ERROR(DEBUG_CATEGORY_SOCKET, "get_outgoing_local_ip: NULL argument");
+        return -1;
+    }
+
+    int family = local_addr->ss_family;
+    if (family != AF_INET && family != AF_INET6) {
+        DEBUG_ERROR(DEBUG_CATEGORY_SOCKET, "get_outgoing_local_ip: unsupported family %d", family);
+        return -1;
+    }
+
+    if (remote_addr->ss_family != family) {
+        DEBUG_ERROR(DEBUG_CATEGORY_SOCKET, "get_outgoing_local_ip: family mismatch");
+        return -1;
+    }
+
+    socket_t sock = socket_create_udp(family);
+    if (sock == SOCKET_INVALID) {
+        DEBUG_ERROR(DEBUG_CATEGORY_SOCKET, "get_outgoing_local_ip: socket_create_udp failed");
+        return -1;
+    }
+
+    // Bind на local_addr, но порт ставим 0 чтобы не конфликтовать с основным сокетом
+    struct sockaddr_storage bind_addr;
+    memcpy(&bind_addr, local_addr, sizeof(bind_addr));
+    if (family == AF_INET) {
+        ((struct sockaddr_in *)&bind_addr)->sin_port = 0;
+    } else {
+        ((struct sockaddr_in6 *)&bind_addr)->sin6_port = 0;
+    }
+
+    socklen_t bind_len = (family == AF_INET) ? sizeof(struct sockaddr_in) : sizeof(struct sockaddr_in6);
+    if (bind(sock, (struct sockaddr *)&bind_addr, bind_len) != 0) {
+        int err = socket_get_error();
+        DEBUG_ERROR(DEBUG_CATEGORY_SOCKET, "get_outgoing_local_ip: bind failed: %s", socket_strerror(err));
+        socket_close_wrapper(sock);
+        return -1;
+    }
+
+    // Connect к remote_addr — ядро вычислит маршрут и выберет source IP
+    socklen_t remote_len = (family == AF_INET) ? sizeof(struct sockaddr_in) : sizeof(struct sockaddr_in6);
+    if (connect(sock, (struct sockaddr *)remote_addr, remote_len) != 0) {
+        int err = socket_get_error();
+        DEBUG_ERROR(DEBUG_CATEGORY_SOCKET, "get_outgoing_local_ip: connect failed: %s", socket_strerror(err));
+        socket_close_wrapper(sock);
+        return -1;
+    }
+
+    // Получаем выбранный локальный адрес
+    struct sockaddr_storage local;
+    socklen_t local_len = sizeof(local);
+    if (getsockname(sock, (struct sockaddr *)&local, &local_len) != 0) {
+        int err = socket_get_error();
+        DEBUG_ERROR(DEBUG_CATEGORY_SOCKET, "get_outgoing_local_ip: getsockname failed: %s", socket_strerror(err));
+        socket_close_wrapper(sock);
+        return -1;
+    }
+
+    socket_close_wrapper(sock);
+
+    // Копируем только IP (без порта)
+    memset(result, 0, sizeof(*result));
+    if (family == AF_INET) {
+        struct sockaddr_in *sin = (struct sockaddr_in *)result;
+        struct sockaddr_in *src = (struct sockaddr_in *)&local;
+        sin->sin_family = AF_INET;
+        sin->sin_addr = src->sin_addr;
+        sin->sin_port = 0;
+    } else {
+        struct sockaddr_in6 *sin6 = (struct sockaddr_in6 *)result;
+        struct sockaddr_in6 *src6 = (struct sockaddr_in6 *)&local;
+        sin6->sin6_family = AF_INET6;
+        sin6->sin6_addr = src6->sin6_addr;
+        sin6->sin6_port = 0;
+    }
+
+    return 0;
+}
@@ -0,0 +1,45 @@
+/**
+ * getmyip.h - Определение локального IP-адреса для исходящих соединений
+ *
+ * Определяет локальный IP, который ОС выберет для отправки
+ * на заданный удаленный адрес через заданный локальный адрес.
+ */
+
+#ifndef GETMYIP_H
+#define GETMYIP_H
+
+#include <stdint.h>
+
+#ifdef _WIN32
+    #include <winsock2.h>
+    #include <ws2tcpip.h>
+#else
+    #include <sys/socket.h>
+    #include <netinet/in.h>
+#endif
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * Определяет локальный IP-адрес, который ОС выберет для отправки
+ * на заданный удаленный адрес через заданный локальный адрес.
+ *
+ * Создает временный UDP-сокет, выполняет bind на local_addr,
+ * connect к remote_addr и получает выбранный локальный IP через getsockname.
+ *
+ * @param local_addr  Локальный адрес (0.0.0.0 / :: для автоопределения)
+ * @param remote_addr Удаленный адрес (для определения маршрута)
+ * @param result      Заполняемый локальный IP (порт = 0)
+ * @return 0 при успехе, -1 при ошибке
+ */
+int get_outgoing_local_ip(const struct sockaddr_storage *local_addr,
+                          const struct sockaddr_storage *remote_addr,
+                          struct sockaddr_storage *result);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif
@@ -0,0 +1,34 @@
+# Get My IP (getmyip.h)
+
+## 1. Назначение
+Определение локального IP-адреса, который ОС выберет для исходящего UDP-соединения на заданный удалённый хост. Используется в `etcp_connections.c` при установке соединения: зная remote-адрес, модуль узнаёт, какой source IP ядро назначит пакетам (нужно для проверки NAT и привязки сокета к правильному интерфейсу).
+
+## 2. Как пользоваться
+Передать локальный адрес-подсказку (или `0.0.0.0` для автоопределения) и удалённый адрес. Функция создаст временный UDP-сокет, сделает bind+connect, считает выбранный IP через `getsockname` и вернёт его в `result` (порт = 0, только IP).
+
+```c
+struct sockaddr_storage local_hint;  // AF_INET6, sin6_addr = in6addr_any
+struct sockaddr_storage remote;      // AF_INET6, адрес сервера
+struct sockaddr_storage chosen_ip;
+
+// ... заполнить local_hint и remote ...
+
+if (get_outgoing_local_ip(&local_hint, &remote, &chosen_ip) == 0) {
+    // chosen_ip.ss_family == AF_INET6, sin6_addr содержит выбранный source IP
+    // chosen_ip.sin6_port == 0
+}
+```
+
+**Нюансы:**
+- Функция временно создаёт и закрывает UDP-сокет — нельзя вызывать в hot path
+- `local_addr` и `remote_addr` должны быть одного семейства (оба AF_INET или оба AF_INET6)
+- Порт в `local_addr` заменяется на 0 (чтобы не конфликтовать с основными сокетами)
+- Порт в `result` всегда 0 — только IP
+
+## 3. API
+
+### Функция
+- **`get_outgoing_local_ip(local_addr, remote_addr, result)`** — создаёт временный UDP-сокет, привязывает к `local_addr` (с портом 0), делает `connect` к `remote_addr` для вычисления маршрута ядром, получает выбранный source IP через `getsockname`. Возвращает 0 при успехе, -1 при ошибке (NULL-аргументы, несовпадение семейств, ошибки сокета).
+
+### Зависимости
+- `socket_compat.h` — кроссплатформенные обёртки: `socket_create_udp`, `SOCKET_INVALID`, `socket_close_wrapper`, `socket_get_error`, `socket_strerror`
@@ -0,0 +1,87 @@
+#include "json_flat.h"
+#include <string.h>
+
+#define SKIP_WS(p, end) while ((p) < (end) && (*(p) == ' ' || *(p) == '\t' || *(p) == '\n' || *(p) == '\r')) (p)++
+#define CHECK(p, end)   if ((p) >= (end)) return -1
+
+static int json_read_string(const char** pp, const char* end, char* out, size_t out_sz) {
+    const char* p = *pp;
+    CHECK(p, end);
+    if (*p != '"') return -1; p++;
+    size_t n = 0;
+    while (p < end && *p != '"') {
+        char ch = *p;
+        if (*p == '\\') { p++; CHECK(p, end);
+            switch (*p) {
+                case '"': ch = '"'; break;
+                case '\\': ch = '\\'; break;
+                case '/': ch = '/'; break;
+                case 'n': ch = '\n'; break;
+                case 'r': ch = '\r'; break;
+                case 't': ch = '\t'; break;
+                default: return -1;
+            }
+        }
+        if (out && n < out_sz - 1) out[n++] = ch;
+        p++;
+    }
+    CHECK(p, end); /* closing quote */
+    p++;
+    if (out && n < out_sz) out[n] = '\0';
+    else if (out && out_sz > 0) out[out_sz - 1] = '\0';
+    *pp = p;
+    return 0;
+}
+
+static int json_parse_pair(const char** pp, const char* end,
+                            json_flat_cb cb, void* arg) {
+    const char* p = *pp;
+    SKIP_WS(p, end); CHECK(p, end);
+    if (*p == '}') { *pp = p; return 0; }
+
+    char key[128], val[256];
+    if (json_read_string(&p, end, key, sizeof(key)) != 0) return -1;
+    SKIP_WS(p, end); CHECK(p, end);
+    if (*p != ':') return -1; p++;
+    SKIP_WS(p, end); CHECK(p, end);
+    if (json_read_string(&p, end, val, sizeof(val)) != 0) return -1;
+
+    if (cb && cb(key, val, arg) != 0) { *pp = p; return 1; }
+
+    SKIP_WS(p, end); CHECK(p, end);
+    if (*p == ',') p++;
+
+    *pp = p;
+    return 0;
+}
+
+int json_flat_parse(const char* json, json_flat_cb cb, void* arg) {
+    if (!json) return -1;
+    const char* p = json, *end = json + strlen(json);
+    SKIP_WS(p, end); CHECK(p, end);
+    if (*p != '{') return -1; p++;
+
+    for (;;) {
+        int rc = json_parse_pair(&p, end, cb, arg);
+        if (rc < 0) return -1;
+        if (rc > 0) return 0; /* callback stopped */
+        SKIP_WS(p, end); CHECK(p, end);
+        if (*p == '}') return 0;
+    }
+}
+
+struct get_ctx { const char* key; char* out; size_t sz; int found; };
+
+static int get_cb(const char* k, const char* v, void* arg) {
+    struct get_ctx* g = (struct get_ctx*)arg;
+    if (strcmp(k, g->key) == 0) { if (g->out) { size_t vl = strlen(v);
+        size_t cp = vl < g->sz - 1 ? vl : g->sz - 1; memcpy(g->out, v, cp); g->out[cp] = '\0'; }
+        g->found = 1; return 1; }
+    return 0;
+}
+
+int json_flat_get(const char* json, const char* key, char* value_out, size_t value_sz) {
+    struct get_ctx g = { key, value_out, value_sz, 0 };
+    if (json_flat_parse(json, get_cb, &g) != 0) return -1;
+    return g.found ? 0 : -1;
+}
@@ -0,0 +1,25 @@
+/**
+ * @file json_flat.h
+ * @brief Парсер плоского JSON без вложенности: {"key":"value",...}
+ *
+ * Только строковые значения. Без malloc, без зависимостей.
+ */
+
+#ifndef JSON_FLAT_H
+#define JSON_FLAT_H
+
+#include <stddef.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+typedef int (*json_flat_cb)(const char* key, const char* value, void* arg);
+
+int json_flat_parse(const char* json, json_flat_cb cb, void* arg);
+int json_flat_get(const char* json, const char* key, char* value_out, size_t value_sz);
+
+#ifdef __cplusplus
+}
+#endif
+#endif
@@ -0,0 +1,23 @@
+mtest
+mtest[23456]
+testdb
+mdb_copy
+mdb_stat
+mdb_dump
+mdb_load
+*.lo
+*.[ao]
+*.so
+*.exe
+*[~#]
+*.bak
+*.orig
+*.rej
+*.gcov
+*.gcda
+*.gcno
+core
+core.*
+valgrind.*
+man/
+html/
@@ -0,0 +1,317 @@
+LMDB 0.9 Change Log
+
+LMDB 0.9.36 Engineering
+	ITS#7772 - limit sub-page growth when re-adding existing data
+	ITS#8335 - more input validation for put(MDB_MULTIPLE)
+	ITS#8386 - be a bit more precise that mdb_get retrieves data in intro.doc
+	ITS#8590 - suppress SIGPIPE on Mac OSX for mdb_copy/compact
+	ITS#8739 - don't use fdatasync on FreeBSD 11.0 and older
+	ITS#8824 - mdb_dump: cleanup check for MDB_SUCCESS
+	ITS#9388 - fix mdb_stat page counts for dupsort DBs
+	ITS#10054 - fix write of 2GB values
+	ITS#10108 - mdb_dump: fix comment
+	ITS#10454 - fix metapage sync on Mac OSX
+	ITS#10504 - silence linker waarning on Mac OSX
+	ITS#10522 - reject 0-length values in DUPSORT DBs
+
+LMDB 0.9.35 Release (2026/01/27)
+    ITS#10434 - Fix typo affecting Mac OSX
+
+LMDB 0.9.34 Release (2026/01/26)
+	ITS#9564 - fix race condition freeing spilled pages at end of transaction
+	ITS#10222 - Update mdb_dump(1) and mdb_load(1) man pages for append (-a) option
+	ITS#10275 - mdb_load: add -Q option to use NOSYNC
+	ITS#10296 - fix fdatasync on MacOS
+	ITS#10342 - fix memleak in mdb_txn_begin for nested txns
+	ITS#10346 - fix mdb_env_copy2 with values > (2GB-16)
+	ITS#10355 - fix mplay build on musl
+	ITS#10396 - fix mdb_cursor_del0 with multiple DUPSORT cursors
+	ITS#10419 - add support for NetBSD
+	ITS#10420 - add support for Haiku
+	ITS#10421 - mdb_load: check for malicious input
+
+LMDB 0.9.33 Release (2024/05/21)
+	ITS#9037 mdb_page_search: fix error code when DBI record is missing
+	ITS#10198 For win32, stop passing ignored parameter
+	ITS#10212 Fix meta page usage by read only tools
+
+LMDB 0.9.32 Release (2024/01/29)
+	ITS#9378 - Add ability to replay log and replay log tool
+	ITS#10095 - partial revert of ITS#9278. The patch was incorrect and introduced numerous race conditions.
+	ITS#10125 - mdb_load: fix cursor reinit in Append mode
+	ITS#10137 - Allow users to define MDB_IDL_LOGN
+
+LMDB 0.9.31 Release (2023/07/10)
+	ITS#8447 - Fix cursor_put(MDB_CURRENT) on DUPSORT DB with different sized data
+
+LMDB 0.9.30 Release (2023/02/08)
+	ITS#9806 - LMDB page_split: key threshold depends on page size
+	ITS#9916 - avoid gcc optimization bug on sparc64 linux
+	ITS#9919 - Mark infrequently used functions as cold
+	ITS#9723 - clear C_EOF on cursor with MDB_FIRST_DUP
+	ITS#9030 - Use sys/cachectl.h rather than asm/cachectl.h on mips
+
+LMDB 0.9.29 Release (2021/03/16)
+	ITS#9461 refix ITS#9376
+	ITS#9500 fix regression from ITS#8662
+
+LMDB 0.9.28 Release (2021/02/04)
+	ITS#8662 add -a append option to mdb_load
+
+LMDB 0.9.27 Release (2020/10/26)
+	ITS#9376 fix repeated DUPSORT cursor deletes
+
+LMDB 0.9.26 Release (2020/08/11)
+	ITS#9278 fix robust mutex cleanup for FreeBSD
+
+LMDB 0.9.25 Release (2020/01/30)
+	ITS#9068 fix mdb_dump/load backslashes in printable content
+	ITS#9118 add MAP_NOSYNC for FreeBSD
+	ITS#9155 free mt_spill_pgs in non-nested txn on end
+
+LMDB 0.9.24 Release (2019/07/24)
+	ITS#8969 Tweak mdb_page_split
+	ITS#8975 WIN32 fix writemap set_mapsize crash
+	ITS#9007 Fix loose pages in WRITEMAP
+
+LMDB 0.9.23 Release (2018/12/19)
+	ITS#8756 Fix loose pages in dirty list
+	ITS#8831 Fix mdb_load flag init
+	ITS#8844 Fix mdb_env_close in forked process
+	Documentation
+		ITS#8857 mdb_cursor_del doesn't invalidate cursor
+		ITS#8908 GET_MULTIPLE etc don't change passed in key
+
+LMDB 0.9.22 Release (2018/03/22)
+	Fix MDB_DUPSORT alignment bug (ITS#8819)
+	Fix regression with new db from 0.9.19 (ITS#8760)
+	Fix liblmdb to build on Solaris (ITS#8612)
+	Fix delete behavior with DUPSORT DB (ITS#8622)
+	Fix mdb_cursor_get/mdb_cursor_del behavior (ITS#8722)
+
+LMDB 0.9.21 Release (2017/06/01)
+	Fix xcursor after cursor_del (ITS#8622)
+
+LMDB 0.9.20 (Withdrawn)
+	Fix mdb_load with escaped plaintext (ITS#8558)
+	Fix mdb_cursor_last / mdb_put interaction (ITS#8557)
+
+LMDB 0.9.19 Release (2016/12/28)
+	Fix mdb_env_cwalk cursor init (ITS#8424)
+	Fix robust mutexes on Solaris 10/11 (ITS#8339)
+	Tweak Win32 error message buffer
+	Fix MDB_GET_BOTH on non-dup record (ITS#8393)
+	Optimize mdb_drop
+	Fix xcursors after mdb_cursor_del (ITS#8406)
+	Fix MDB_NEXT_DUP after mdb_cursor_del (ITS#8412)
+	Fix mdb_cursor_put resetting C_EOF (ITS#8489)
+	Fix mdb_env_copyfd2 to return EPIPE on SIGPIPE (ITS#8504)
+	Fix mdb_env_copy with empty DB (ITS#8209)
+	Fix behaviors with fork (ITS#8505)
+	Fix mdb_dbi_open with mainDB cursors (ITS#8542)
+	Fix robust mutexes on kFreeBSD (ITS#8554)
+	Fix utf8_to_utf16 error checks (ITS#7992)
+	Fix F_NOCACHE on MacOS, error is non-fatal (ITS#7682)
+	Build
+		Make shared lib suffix overridable (ITS#8481)
+	Documentation
+		Cleanup doxygen nits
+		Note reserved vs actual mem/disk usage
+
+
+LMDB 0.9.18 Release (2016/02/05)
+	Fix robust mutex detection on glibc 2.10-11 (ITS#8330)
+	Fix page_search_root assert on FreeDB (ITS#8336)
+	Fix MDB_APPENDDUP vs. rewrite(single item) (ITS#8334)
+	Fix mdb_copy of large files on Windows
+	Fix subcursor move after delete (ITS#8355)
+	Fix mdb_midl_shirnk off-by-one (ITS#8363)
+	Check for utf8_to_utf16 failures (ITS#7992)
+	Catch strdup failure in mdb_dbi_open
+	Build
+		Additional makefile var tweaks (ITS#8169)
+	Documentation
+		Add Getting Started page
+		Update WRITEMAP description
+	
+
+LMDB 0.9.17 Release (2015/11/30)
+	Fix ITS#7377 catch calloc failure
+	Fix ITS#8237 regression from ITS#7589
+	Fix ITS#8238 page_split for DUPFIXED pages
+	Fix ITS#8221 MDB_PAGE_FULL on delete/rebalance
+	Fix ITS#8258 rebalance/split assert
+	Fix ITS#8263 cursor_put cursor tracking
+	Fix ITS#8264 cursor_del cursor tracking
+	Fix ITS#8310 cursor_del cursor tracking
+	Fix ITS#8299 mdb_del cursor tracking
+	Fix ITS#8300 mdb_del cursor tracking
+	Fix ITS#8304 mdb_del cursor tracking
+	Fix ITS#7771 fakepage cursor tracking
+	Fix ITS#7789 ensure mapsize >= pages in use
+	Fix ITS#7971 mdb_txn_renew0() new reader slots
+	Fix ITS#7969 use __sync_synchronize on non-x86
+	Fix ITS#8311 page_split from update_key
+	Fix ITS#8312 loose pages in nested txn
+	Fix ITS#8313 mdb_rebalance dummy cursor
+	Fix ITS#8315 dirty_room in nested txn
+	Fix ITS#8323 dirty_list in nested txn
+	Fix ITS#8316 page_merge cursor tracking
+	Fix ITS#8321 cursor tracking
+	Fix ITS#8319 mdb_load error messages
+	Fix ITS#8320 mdb_load plaintext input
+	Added mdb_txn_id() (ITS#7994)
+	Added robust mutex support
+	Miscellaneous cleanup/simplification
+	Build
+		Create install dirs if needed (ITS#8256)
+		Fix ThreadProc decl on Win32/MSVC (ITS#8270)
+		Added ssize_t typedef for MSVC (ITS#8067)
+		Use ANSI apis on Windows (ITS#8069)
+		Use O_SYNC if O_DSYNC,MDB_DSYNC are not defined (ITS#7209)
+		Allow passing AR to make (ITS#8168)
+		Allow passing mandir to make install (ITS#8169)
+
+LMDB 0.9.16 Release (2015/08/14)
+	Fix cursor EOF bug (ITS#8190)
+	Fix handling of subDB records (ITS#8181)
+	Fix mdb_midl_shrink() usage (ITS#8200)
+
+LMDB 0.9.15 Release (2015/06/19)
+	Fix txn init (ITS#7961,#7987)
+	Fix MDB_PREV_DUP (ITS#7955,#7671)
+	Fix compact of empty env (ITS#7956)
+	Fix mdb_copy file mode
+	Fix mdb_env_close() after failed mdb_env_open()
+	Fix mdb_rebalance collapsing root (ITS#8062)
+	Fix mdb_load with large values (ITS#8066)
+	Fix to retry writes on EINTR (ITS#8106)
+	Fix mdb_cursor_del on empty DB (ITS#8109)
+	Fix MDB_INTEGERDUP key compare (ITS#8117)
+	Fix error handling (ITS#7959,#8157,etc.)
+	Fix race conditions (ITS#7969,7970)
+	Added workaround for fdatasync bug in ext3fs
+	Build
+		Don't use -fPIC for static lib
+		Update .gitignore (ITS#7952,#7953)
+		Cleanup for "make test" (ITS#7841), "make clean", mtest*.c
+		Misc. Android/Windows cleanup
+	Documentation
+		Fix MDB_APPEND doc
+		Fix MDB_MAXKEYSIZE doc (ITS#8156)
+		Fix mdb_cursor_put,mdb_cursor_del EACCES description
+		Fix mdb_env_sync(MDB_RDONLY env) doc (ITS#8021)
+		Clarify MDB_WRITEMAP doc (ITS#8021)
+		Clarify mdb_env_open doc
+		Clarify mdb_dbi_open doc
+
+LMDB 0.9.14 Release (2014/09/20)
+	Fix to support 64K page size (ITS#7713)
+	Fix to persist decreased as well as increased mapsizes (ITS#7789)
+	Fix cursor bug when deleting last node of a DUPSORT key
+	Fix mdb_env_info to return FIXEDMAP address
+	Fix ambiguous error code from writing to closed DBI (ITS#7825)
+	Fix mdb_copy copying past end of file (ITS#7886)
+	Fix cursor bugs from page_merge/rebalance
+	Fix to dirty fewer pages in deletes (mdb_page_loose())
+	Fix mdb_dbi_open creating subDBs (ITS#7917)
+	Fix mdb_cursor_get(_DUP) with single value (ITS#7913)
+	Fix Windows compat issues in mtests (ITS#7879)
+	Add compacting variant of mdb_copy
+	Add BigEndian integer key compare code
+	Add mdb_dump/mdb_load utilities
+
+LMDB 0.9.13 Release (2014/06/18)
+	Fix mdb_page_alloc unlimited overflow page search
+	Documentation
+		Re-fix MDB_CURRENT doc (ITS#7793)
+		Fix MDB_GET_MULTIPLE/MDB_NEXT_MULTIPLE doc
+
+LMDB 0.9.12 Release (2014/06/13)
+	Fix MDB_GET_BOTH regression (ITS#7875,#7681)
+	Fix MDB_MULTIPLE writing multiple keys (ITS#7834)
+	Fix mdb_rebalance (ITS#7829)
+	Fix mdb_page_split (ITS#7815)
+	Fix md_entries count (ITS#7861,#7828,#7793)
+	Fix MDB_CURRENT (ITS#7793)
+	Fix possible crash on Windows DLL detach
+	Misc code cleanup
+	Documentation
+		mdb_cursor_put: cursor moves on error (ITS#7771)
+
+
+LMDB 0.9.11 Release (2014/01/15)
+	Add mdb_env_set_assert() (ITS#7775)
+	Fix: invalidate txn on page allocation errors (ITS#7377)
+	Fix xcursor tracking in mdb_cursor_del0() (ITS#7771)
+	Fix corruption from deletes (ITS#7756)
+	Fix Windows/MSVC build issues
+	Raise safe limit of max MDB_MAXKEYSIZE
+	Misc code cleanup
+	Documentation
+		Remove spurious note about non-overlapping flags (ITS#7665)
+
+LMDB 0.9.10 Release (2013/11/12)
+	Add MDB_NOMEMINIT option
+	Fix mdb_page_split() again (ITS#7589)
+	Fix MDB_NORDAHEAD definition (ITS#7734)
+	Fix mdb_cursor_del() positioning (ITS#7733)
+	Partial fix for larger page sizes (ITS#7713)
+	Fix Windows64/MSVC build issues
+
+LMDB 0.9.9 Release (2013/10/24)
+	Add mdb_env_get_fd()
+	Add MDB_NORDAHEAD option
+	Add MDB_NOLOCK option
+	Avoid wasting space in mdb_page_split() (ITS#7589)
+	Fix mdb_page_merge() cursor fixup (ITS#7722)
+	Fix mdb_cursor_del() on last delete (ITS#7718)
+	Fix adding WRITEMAP on existing env (ITS#7715)
+	Fix nested txns (ITS#7515)
+	Fix mdb_env_copy() O_DIRECT bug (ITS#7682)
+	Fix mdb_cursor_set(SET_RANGE) return code (ITS#7681)
+	Fix mdb_rebalance() cursor fixup (ITS#7701)
+	Misc code cleanup
+	Documentation
+		Note that by default, readers need write access
+
+
+LMDB 0.9.8 Release (2013/09/09)
+	Allow mdb_env_set_mapsize() on an open environment
+	Fix mdb_dbi_flags() (ITS#7672)
+	Fix mdb_page_unspill() in nested txns
+	Fix mdb_cursor_get(CURRENT|NEXT) after a delete
+	Fix mdb_cursor_get(DUP) to always return key (ITS#7671)
+	Fix mdb_cursor_del() to always advance to next item (ITS#7670)
+	Fix mdb_cursor_set(SET_RANGE) for tree with single page (ITS#7681)
+	Fix mdb_env_copy() retry open if O_DIRECT fails (ITS#7682)
+	Tweak mdb_page_spill() to be less aggressive
+	Documentation
+		Update caveats since mdb_reader_check() added in 0.9.7
+
+LMDB 0.9.7 Release (2013/08/17)
+	Don't leave stale lockfile on failed RDONLY open (ITS#7664)
+	Fix mdb_page_split() ref beyond cursor depth
+	Fix read txn data race (ITS#7635)
+	Fix mdb_rebalance (ITS#7536, #7538)
+	Fix mdb_drop() (ITS#7561)
+	Misc DEBUG macro fixes
+	Add MDB_NOTLS envflag
+	Add mdb_env_copyfd()
+	Add mdb_txn_env() (ITS#7660)
+	Add mdb_dbi_flags() (ITS#7661)
+	Add mdb_env_get_maxkeysize()
+	Add mdb_env_reader_list()/mdb_env_reader_check()
+	Add mdb_page_spill/unspill, remove hard txn size limit
+	Use shorter names for semaphores (ITS#7615)
+	Build
+		Fix install target (ITS#7656)
+	Documentation
+		Misc updates for cursors, DB handles, data lifetime
+
+LMDB 0.9.6 Release (2013/02/25)
+	Many fixes/enhancements
+
+LMDB 0.9.5 Release (2012/11/30)
+	Renamed from libmdb to liblmdb
+	Many fixes/enhancements
@@ -0,0 +1,20 @@
+Copyright 2011-2021 Howard Chu, Symas Corp.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted only as authorized by the OpenLDAP
+Public License.
+
+A copy of this license is available in the file LICENSE in the
+top-level directory of the distribution or, alternatively, at
+<http://www.OpenLDAP.org/license.html>.
+
+OpenLDAP is a registered trademark of the OpenLDAP Foundation.
+
+Individual files and/or contributed packages may be copyright by
+other parties and/or subject to additional restrictions.
+
+This work also contains materials derived from public sources.
+
+Additional information about OpenLDAP can be obtained at
+<http://www.openldap.org/>.
@@ -0,0 +1,47 @@
+The OpenLDAP Public License
+  Version 2.8, 17 August 2003
+
+Redistribution and use of this software and associated documentation
+("Software"), with or without modification, are permitted provided
+that the following conditions are met:
+
+1. Redistributions in source form must retain copyright statements
+   and notices,
+
+2. Redistributions in binary form must reproduce applicable copyright
+   statements and notices, this list of conditions, and the following
+   disclaimer in the documentation and/or other materials provided
+   with the distribution, and
+
+3. Redistributions must contain a verbatim copy of this document.
+
+The OpenLDAP Foundation may revise this license from time to time.
+Each revision is distinguished by a version number.  You may use
+this Software under terms of this license revision or under the
+terms of any subsequent revision of the license.
+
+THIS SOFTWARE IS PROVIDED BY THE OPENLDAP FOUNDATION AND ITS
+CONTRIBUTORS ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
+INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT
+SHALL THE OPENLDAP FOUNDATION, ITS CONTRIBUTORS, OR THE AUTHOR(S)
+OR OWNER(S) OF THE SOFTWARE BE LIABLE FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
+
+The names of the authors and copyright holders must not be used in
+advertising or otherwise to promote the sale, use or other dealing
+in this Software without specific, written prior permission.  Title
+to copyright in this Software shall at all times remain with copyright
+holders.
+
+OpenLDAP is a registered trademark of the OpenLDAP Foundation.
+
+Copyright 1999-2003 The OpenLDAP Foundation, Redwood City,
+California, USA.  All Rights Reserved.  Permission to copy and
+distribute verbatim copies of this document is granted.
@@ -0,0 +1,192 @@
+/*
+ * Copyright 2015-2021 Howard Chu, Symas Corp.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * <http://www.OpenLDAP.org/license.html>.
+ */
+/** @page starting Getting Started
+
+LMDB is compact, fast, powerful, and robust and implements a simplified
+variant of the BerkeleyDB (BDB) API. (BDB is also very powerful, and verbosely
+documented in its own right.) After reading this page, the main
+\ref mdb documentation should make sense. Thanks to Bert Hubert
+for creating the
+<a href="https://github.com/ahupowerdns/ahutils/blob/master/lmdb-semantics.md">
+initial version</a> of this writeup.
+
+Everything starts with an environment, created by #mdb_env_create().
+Once created, this environment must also be opened with #mdb_env_open().
+
+#mdb_env_open() gets passed a name which is interpreted as a directory
+path. Note that this directory must exist already, it is not created
+for you. Within that directory, a lock file and a storage file will be
+generated. If you don't want to use a directory, you can pass the
+#MDB_NOSUBDIR option, in which case the path you provided is used
+directly as the data file, and another file with a "-lock" suffix
+added will be used for the lock file.
+
+Once the environment is open, a transaction can be created within it
+using #mdb_txn_begin(). Transactions may be read-write or read-only,
+and read-write transactions may be nested. A transaction must only
+be used by one thread at a time. Transactions are always required,
+even for read-only access. The transaction provides a consistent
+view of the data.
+
+Once a transaction has been created, a database can be opened within it
+using #mdb_dbi_open(). If only one database will ever be used in the
+environment, a NULL can be passed as the database name. For named
+databases, the #MDB_CREATE flag must be used to create the database
+if it doesn't already exist. Also, #mdb_env_set_maxdbs() must be
+called after #mdb_env_create() and before #mdb_env_open() to set the
+maximum number of named databases you want to support.
+
+Note: a single transaction can open multiple databases. Generally
+databases should only be opened once, by the first transaction in
+the process. After the first transaction completes, the database
+handles can freely be used by all subsequent transactions.
+
+Within a transaction, #mdb_get() can retrieve and #mdb_put() can store single
+key/value pairs if that is all you need to do (but see \ref Cursors
+below if you want to do more).
+
+A key/value pair is expressed as two #MDB_val structures. This struct
+has two fields, \c mv_size and \c mv_data. The data is a \c void pointer to
+an array of \c mv_size bytes.
+
+Because LMDB is very efficient (and usually zero-copy), the data returned
+in an #MDB_val structure may be memory-mapped straight from disk. In
+other words <b>look but do not touch</b> (or free() for that matter).
+Once a transaction is closed, the values can no longer be used, so
+make a copy if you need to keep them after that.
+
+@section Cursors Cursors
+
+To do more powerful things, we must use a cursor.
+
+Within the transaction, a cursor can be created with #mdb_cursor_open().
+With this cursor we can store/retrieve/delete (multiple) values using
+#mdb_cursor_get(), #mdb_cursor_put(), and #mdb_cursor_del().
+
+#mdb_cursor_get() positions itself depending on the cursor operation
+requested, and for some operations, on the supplied key. For example,
+to list all key/value pairs in a database, use operation #MDB_FIRST for
+the first call to #mdb_cursor_get(), and #MDB_NEXT on subsequent calls,
+until the end is hit.
+
+To retrieve all keys starting from a specified key value, use #MDB_SET.
+For more cursor operations, see the \ref mdb docs.
+
+When using #mdb_cursor_put(), either the function will position the
+cursor for you based on the \b key, or you can use operation
+#MDB_CURRENT to use the current position of the cursor. Note that
+\b key must then match the current position's key.
+
+@subsection summary Summarizing the Opening
+
+So we have a cursor in a transaction which opened a database in an
+environment which is opened from a filesystem after it was
+separately created.
+
+Or, we create an environment, open it from a filesystem, create a
+transaction within it, open a database within that transaction,
+and create a cursor within all of the above.
+
+Got it?
+
+@section thrproc Threads and Processes
+
+LMDB uses POSIX locks on files, and these locks have issues if one
+process opens a file multiple times. Because of this, do not
+#mdb_env_open() a file multiple times from a single process. Instead,
+share the LMDB environment that has opened the file across all threads.
+Otherwise, if a single process opens the same environment multiple times,
+closing it once will remove all the locks held on it, and the other
+instances will be vulnerable to corruption from other processes.
+
+Also note that a transaction is tied to one thread by default using
+Thread Local Storage. If you want to pass read-only transactions across
+threads, you can use the #MDB_NOTLS option on the environment.
+
+@section txns Transactions, Rollbacks, etc.
+
+To actually get anything done, a transaction must be committed using
+#mdb_txn_commit(). Alternatively, all of a transaction's operations
+can be discarded using #mdb_txn_abort(). In a read-only transaction,
+any cursors will \b not automatically be freed. In a read-write
+transaction, all cursors will be freed and must not be used again.
+
+For read-only transactions, obviously there is nothing to commit to
+storage. The transaction still must eventually be aborted to close
+any database handle(s) opened in it, or committed to keep the
+database handles around for reuse in new transactions.
+
+In addition, as long as a transaction is open, a consistent view of
+the database is kept alive, which requires storage. A read-only
+transaction that no longer requires this consistent view should
+be terminated (committed or aborted) when the view is no longer
+needed (but see below for an optimization).
+
+There can be multiple simultaneously active read-only transactions
+but only one that can write. Once a single read-write transaction
+is opened, all further attempts to begin one will block until the
+first one is committed or aborted. This has no effect on read-only
+transactions, however, and they may continue to be opened at any time.
+
+@section dupkeys Duplicate Keys
+
+#mdb_get() and #mdb_put() respectively have no and only some support
+for multiple key/value pairs with identical keys. If there are multiple
+values for a key, #mdb_get() will only return the first value.
+
+When multiple values for one key are required, pass the #MDB_DUPSORT
+flag to #mdb_dbi_open(). In an #MDB_DUPSORT database, by default
+#mdb_put() will not replace the value for a key if the key existed
+already. Instead it will add the new value to the key. In addition,
+#mdb_del() will pay attention to the value field too, allowing for
+specific values of a key to be deleted.
+
+Finally, additional cursor operations become available for
+traversing through and retrieving duplicate values.
+
+@section optim Some Optimization
+
+If you frequently begin and abort read-only transactions, as an
+optimization, it is possible to only reset and renew a transaction.
+
+#mdb_txn_reset() releases any old copies of data kept around for
+a read-only transaction. To reuse this reset transaction, call
+#mdb_txn_renew() on it. Any cursors in this transaction must also
+be renewed using #mdb_cursor_renew().
+
+Note that #mdb_txn_reset() is similar to #mdb_txn_abort() and will
+close any databases you opened within the transaction.
+
+To permanently free a transaction, reset or not, use #mdb_txn_abort().
+
+@section cleanup Cleaning Up
+
+For read-only transactions, any cursors created within it must
+be closed using #mdb_cursor_close().
+
+It is very rarely necessary to close a database handle, and in
+general they should just be left open.
+
+@section onward The Full API
+
+The full \ref mdb documentation lists further details, like how to:
+
+  \li size a database (the default limits are intentionally small)
+  \li drop and clean a database
+  \li detect and report errors
+  \li optimize (bulk) loading speed
+  \li (temporarily) reduce robustness to gain even more speed
+  \li gather statistics about the database
+  \li define custom sort orders
+
+*/
@@ -0,0 +1,55 @@
+.TH MDB_COPY 1 "2014/07/01" "LMDB 0.9.14"
+.\" Copyright 2012-2021 Howard Chu, Symas Corp. All Rights Reserved.
+.\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
+.SH NAME
+mdb_copy \- LMDB environment copy tool
+.SH SYNOPSIS
+.B mdb_copy
+[\c
+.BR \-V ]
+[\c
+.BR \-c ]
+[\c
+.BR \-n ]
+.B srcpath
+[\c
+.BR dstpath ]
+.SH DESCRIPTION
+The
+.B mdb_copy
+utility copies an LMDB environment. The environment can
+be copied regardless of whether it is currently in use.
+No lockfile is created, since it gets recreated at need.
+
+If
+.I dstpath
+is specified it must be the path of an empty directory
+for storing the backup. Otherwise, the backup will be
+written to stdout.
+
+.SH OPTIONS
+.TP
+.BR \-V
+Write the library version number to the standard output, and exit.
+.TP
+.BR \-c
+Compact while copying. Only current data pages will be copied; freed
+or unused pages will be omitted from the copy. This option will
+slow down the backup process as it is more CPU-intensive.
+Currently it fails if the environment has suffered a page leak.
+.TP
+.BR \-n
+Open LDMB environment(s) which do not use subdirectories.
+
+.SH DIAGNOSTICS
+Exit status is zero if no errors occur.
+Errors result in a non-zero exit status and
+a diagnostic message being written to standard error.
+.SH CAVEATS
+This utility can trigger significant file size growth if run
+in parallel with write transactions, because pages which they
+free during copying cannot be reused until the copy is done.
+.SH "SEE ALSO"
+.BR mdb_stat (1)
+.SH AUTHOR
+Howard Chu of Symas Corporation <http://www.symas.com>
@@ -0,0 +1,82 @@
+/* mdb_copy.c - memory-mapped database backup tool */
+/*
+ * Copyright 2012-2021 Howard Chu, Symas Corp.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * <http://www.OpenLDAP.org/license.html>.
+ */
+#ifdef _WIN32
+#include <windows.h>
+#define	MDB_STDOUT	GetStdHandle(STD_OUTPUT_HANDLE)
+#else
+#define	MDB_STDOUT	1
+#endif
+#include <stdio.h>
+#include <stdlib.h>
+#include <signal.h>
+#include "lmdb.h"
+
+static void
+sighandle(int sig)
+{
+}
+
+int main(int argc,char * argv[])
+{
+	int rc;
+	MDB_env *env;
+	const char *progname = argv[0], *act;
+	unsigned flags = MDB_RDONLY;
+	unsigned cpflags = 0;
+
+	for (; argc > 1 && argv[1][0] == '-'; argc--, argv++) {
+		if (argv[1][1] == 'n' && argv[1][2] == '\0')
+			flags |= MDB_NOSUBDIR;
+		else if (argv[1][1] == 'c' && argv[1][2] == '\0')
+			cpflags |= MDB_CP_COMPACT;
+		else if (argv[1][1] == 'V' && argv[1][2] == '\0') {
+			printf("%s\n", MDB_VERSION_STRING);
+			exit(0);
+		} else
+			argc = 0;
+	}
+
+	if (argc<2 || argc>3) {
+		fprintf(stderr, "usage: %s [-V] [-c] [-n] srcpath [dstpath]\n", progname);
+		exit(EXIT_FAILURE);
+	}
+
+#ifdef SIGPIPE
+	signal(SIGPIPE, sighandle);
+#endif
+#ifdef SIGHUP
+	signal(SIGHUP, sighandle);
+#endif
+	signal(SIGINT, sighandle);
+	signal(SIGTERM, sighandle);
+
+	act = "opening environment";
+	rc = mdb_env_create(&env);
+	if (rc == MDB_SUCCESS) {
+		rc = mdb_env_open(env, argv[1], flags, 0600);
+	}
+	if (rc == MDB_SUCCESS) {
+		act = "copying";
+		if (argc == 2)
+			rc = mdb_env_copyfd2(env, MDB_STDOUT, cpflags);
+		else
+			rc = mdb_env_copy2(env, argv[2], cpflags);
+	}
+	if (rc)
+		fprintf(stderr, "%s: %s failed, error %d (%s)\n",
+			progname, act, rc, mdb_strerror(rc));
+	mdb_env_close(env);
+
+	return rc ? EXIT_FAILURE : EXIT_SUCCESS;
+}
@@ -0,0 +1,75 @@
+.TH MDB_DUMP 1 "2015/09/30" "LMDB 0.9.17"
+.\" Copyright 2014-2021 Howard Chu, Symas Corp. All Rights Reserved.
+.\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
+.SH NAME
+mdb_dump \- LMDB environment export tool
+.SH SYNOPSIS
+.B mdb_dump
+[\c
+.BR \-V ]
+[\c
+.BI \-f \ file\fR]
+[\c
+.BR \-l ]
+[\c
+.BR \-n ]
+[\c
+.BR \-p ]
+[\c
+.BR \-a \ |
+.BI \-s \ subdb\fR]
+.BR \ envpath
+.SH DESCRIPTION
+The
+.B mdb_dump
+utility reads a database and writes its contents to the
+standard output using a portable flat-text format
+understood by the
+.BR mdb_load (1)
+utility.
+.SH OPTIONS
+.TP
+.BR \-V
+Write the library version number to the standard output, and exit.
+.TP
+.BR \-f \ file
+Write to the specified file instead of to the standard output.
+.TP
+.BR \-l
+List the databases stored in the environment. Just the
+names will be listed, no data will be output.
+.TP
+.BR \-n
+Dump an LMDB database which does not use subdirectories.
+.TP
+.BR \-p
+If characters in either the key or data items are printing characters (as
+defined by isprint(3)), output them directly. This option permits users to
+use standard text editors and tools to modify the contents of databases.
+
+Note: different systems may have different notions about what characters
+are considered printing characters, and databases dumped in this manner may
+be less portable to external systems. 
+.TP
+.BR \-a
+Dump all of the subdatabases in the environment.
+.TP
+.BR \-s \ subdb
+Dump a specific subdatabase. If no database is specified, only the main database is dumped.
+.SH DIAGNOSTICS
+Exit status is zero if no errors occur.
+Errors result in a non-zero exit status and
+a diagnostic message being written to standard error.
+
+Dumping databases that use user-defined comparison functions will output
+records with the ordering imposed by those comparison functions. If
+.B mdb_load
+is invoked without including the
+.B -a
+option when reloading those records, the new databases will likely be
+damaged beyond repair, permitting neither record storage nor retrieval.
+
+.SH "SEE ALSO"
+.BR mdb_load (1)
+.SH AUTHOR
+Howard Chu of Symas Corporation <http://www.symas.com>
@@ -0,0 +1,319 @@
+/* mdb_dump.c - memory-mapped database dump tool */
+/*
+ * Copyright 2011-2021 Howard Chu, Symas Corp.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * <http://www.OpenLDAP.org/license.html>.
+ */
+#include <stdio.h>
+#include <errno.h>
+#include <stdlib.h>
+#include <string.h>
+#include <ctype.h>
+#include <unistd.h>
+#include <signal.h>
+#include "lmdb.h"
+
+#ifdef _WIN32
+#define Z	"I"
+#else
+#define Z	"z"
+#endif
+
+#define PRINT	1
+static int mode;
+
+typedef struct flagbit {
+	int bit;
+	char *name;
+} flagbit;
+
+flagbit dbflags[] = {
+	{ MDB_REVERSEKEY, "reversekey" },
+	{ MDB_DUPSORT, "dupsort" },
+	{ MDB_INTEGERKEY, "integerkey" },
+	{ MDB_DUPFIXED, "dupfixed" },
+	{ MDB_INTEGERDUP, "integerdup" },
+	{ MDB_REVERSEDUP, "reversedup" },
+	{ 0, NULL }
+};
+
+static volatile sig_atomic_t gotsig;
+
+static void dumpsig( int sig )
+{
+	gotsig=1;
+}
+
+static const char hexc[] = "0123456789abcdef";
+
+static void hex(unsigned char c)
+{
+	putchar(hexc[c >> 4]);
+	putchar(hexc[c & 0xf]);
+}
+
+static void text(MDB_val *v)
+{
+	unsigned char *c, *end;
+
+	putchar(' ');
+	c = v->mv_data;
+	end = c + v->mv_size;
+	while (c < end) {
+		if (isprint(*c)) {
+			if (*c == '\\')
+				putchar('\\');
+			putchar(*c);
+		} else {
+			putchar('\\');
+			hex(*c);
+		}
+		c++;
+	}
+	putchar('\n');
+}
+
+static void byte(MDB_val *v)
+{
+	unsigned char *c, *end;
+
+	putchar(' ');
+	c = v->mv_data;
+	end = c + v->mv_size;
+	while (c < end) {
+		hex(*c++);
+	}
+	putchar('\n');
+}
+
+/* Dump in BDB-compatible format */
+static int dumpit(MDB_txn *txn, MDB_dbi dbi, char *name)
+{
+	MDB_cursor *mc;
+	MDB_stat ms;
+	MDB_val key, data;
+	MDB_envinfo info;
+	unsigned int flags;
+	int rc, i;
+
+	rc = mdb_dbi_flags(txn, dbi, &flags);
+	if (rc) return rc;
+
+	rc = mdb_stat(txn, dbi, &ms);
+	if (rc) return rc;
+
+	rc = mdb_env_info(mdb_txn_env(txn), &info);
+	if (rc) return rc;
+
+	printf("VERSION=3\n");
+	printf("format=%s\n", mode & PRINT ? "print" : "bytevalue");
+	if (name)
+		printf("database=%s\n", name);
+	printf("type=btree\n");
+	printf("mapsize=%" Z "u\n", info.me_mapsize);
+	if (info.me_mapaddr)
+		printf("mapaddr=%p\n", info.me_mapaddr);
+	printf("maxreaders=%u\n", info.me_maxreaders);
+
+	if (flags & MDB_DUPSORT)
+		printf("duplicates=1\n");
+
+	for (i=0; dbflags[i].bit; i++)
+		if (flags & dbflags[i].bit)
+			printf("%s=1\n", dbflags[i].name);
+
+	printf("db_pagesize=%d\n", ms.ms_psize);
+	printf("HEADER=END\n");
+
+	rc = mdb_cursor_open(txn, dbi, &mc);
+	if (rc) return rc;
+
+	while ((rc = mdb_cursor_get(mc, &key, &data, MDB_NEXT)) == MDB_SUCCESS) {
+		if (gotsig) {
+			rc = EINTR;
+			break;
+		}
+		if (mode & PRINT) {
+			text(&key);
+			text(&data);
+		} else {
+			byte(&key);
+			byte(&data);
+		}
+	}
+	printf("DATA=END\n");
+	if (rc == MDB_NOTFOUND)
+		rc = MDB_SUCCESS;
+
+	return rc;
+}
+
+static void usage(char *prog)
+{
+	fprintf(stderr, "usage: %s [-V] [-f output] [-l] [-n] [-p] [-a|-s subdb] dbpath\n", prog);
+	exit(EXIT_FAILURE);
+}
+
+int main(int argc, char *argv[])
+{
+	int i, rc;
+	MDB_env *env;
+	MDB_txn *txn;
+	MDB_dbi dbi;
+	char *prog = argv[0];
+	char *envname;
+	char *subname = NULL;
+	int alldbs = 0, envflags = 0, list = 0;
+
+	if (argc < 2) {
+		usage(prog);
+	}
+
+	/* -a: dump all subDBs
+	 * -s: dump only the named subDB
+	 * -n: use NOSUBDIR flag on env_open
+	 * -p: use printable characters
+	 * -f: write to file instead of stdout
+	 * -V: print version and exit
+	 * (default) dump only the main DB
+	 */
+	while ((i = getopt(argc, argv, "af:lnps:V")) != EOF) {
+		switch(i) {
+		case 'V':
+			printf("%s\n", MDB_VERSION_STRING);
+			exit(0);
+			break;
+		case 'l':
+			list = 1;
+			/*FALLTHROUGH*/
+		case 'a':
+			if (subname)
+				usage(prog);
+			alldbs++;
+			break;
+		case 'f':
+			if (freopen(optarg, "w", stdout) == NULL) {
+				fprintf(stderr, "%s: %s: reopen: %s\n",
+					prog, optarg, strerror(errno));
+				exit(EXIT_FAILURE);
+			}
+			break;
+		case 'n':
+			envflags |= MDB_NOSUBDIR;
+			break;
+		case 'p':
+			mode |= PRINT;
+			break;
+		case 's':
+			if (alldbs)
+				usage(prog);
+			subname = optarg;
+			break;
+		default:
+			usage(prog);
+		}
+	}
+
+	if (optind != argc - 1)
+		usage(prog);
+
+#ifdef SIGPIPE
+	signal(SIGPIPE, dumpsig);
+#endif
+#ifdef SIGHUP
+	signal(SIGHUP, dumpsig);
+#endif
+	signal(SIGINT, dumpsig);
+	signal(SIGTERM, dumpsig);
+
+	envname = argv[optind];
+	rc = mdb_env_create(&env);
+	if (rc) {
+		fprintf(stderr, "mdb_env_create failed, error %d %s\n", rc, mdb_strerror(rc));
+		return EXIT_FAILURE;
+	}
+
+	if (alldbs || subname) {
+		mdb_env_set_maxdbs(env, 2);
+	}
+
+	rc = mdb_env_open(env, envname, envflags | MDB_RDONLY, 0664);
+	if (rc) {
+		fprintf(stderr, "mdb_env_open failed, error %d %s\n", rc, mdb_strerror(rc));
+		goto env_close;
+	}
+
+	rc = mdb_txn_begin(env, NULL, MDB_RDONLY, &txn);
+	if (rc) {
+		fprintf(stderr, "mdb_txn_begin failed, error %d %s\n", rc, mdb_strerror(rc));
+		goto env_close;
+	}
+
+	rc = mdb_open(txn, subname, 0, &dbi);
+	if (rc) {
+		fprintf(stderr, "mdb_open failed, error %d %s\n", rc, mdb_strerror(rc));
+		goto txn_abort;
+	}
+
+	if (alldbs) {
+		MDB_cursor *cursor;
+		MDB_val key;
+		int count = 0;
+
+		rc = mdb_cursor_open(txn, dbi, &cursor);
+		if (rc) {
+			fprintf(stderr, "mdb_cursor_open failed, error %d %s\n", rc, mdb_strerror(rc));
+			goto txn_abort;
+		}
+		while ((rc = mdb_cursor_get(cursor, &key, NULL, MDB_NEXT_NODUP)) == 0) {
+			char *str;
+			MDB_dbi db2;
+			if (memchr(key.mv_data, '\0', key.mv_size))
+				continue;
+			count++;
+			str = malloc(key.mv_size+1);
+			memcpy(str, key.mv_data, key.mv_size);
+			str[key.mv_size] = '\0';
+			rc = mdb_open(txn, str, 0, &db2);
+			if (rc == MDB_SUCCESS) {
+				if (list) {
+					printf("%s\n", str);
+					list++;
+				} else {
+					rc = dumpit(txn, db2, str);
+					if (rc)
+						break;
+				}
+				mdb_close(env, db2);
+			}
+			free(str);
+			if (rc) continue;
+		}
+		mdb_cursor_close(cursor);
+		if (!count) {
+			fprintf(stderr, "%s: %s does not contain multiple databases\n", prog, envname);
+			rc = MDB_NOTFOUND;
+		} else if (rc == MDB_NOTFOUND) {
+			rc = MDB_SUCCESS;
+		}
+	} else {
+		rc = dumpit(txn, dbi, subname);
+	}
+	if (rc && rc != MDB_NOTFOUND)
+		fprintf(stderr, "%s: %s: %s\n", prog, envname, mdb_strerror(rc));
+
+	mdb_close(env, dbi);
+txn_abort:
+	mdb_txn_abort(txn);
+env_close:
+	mdb_env_close(env);
+
+	return rc ? EXIT_FAILURE : EXIT_SUCCESS;
+}
@@ -0,0 +1,91 @@
+.TH MDB_LOAD 1 "2015/09/30" "LMDB 0.9.17"
+.\" Copyright 2014-2021 Howard Chu, Symas Corp. All Rights Reserved.
+.\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
+.SH NAME
+mdb_load \- LMDB environment import tool
+.SH SYNOPSIS
+.B mdb_load
+[\c
+.BR \-V ]
+[\c
+.BR \-a ]
+[\c
+.BI \-f \ file\fR]
+[\c
+.BR \-n ]
+[\c
+.BI \-s \ subdb\fR]
+[\c
+.BR \-N ]
+[\c
+.BR \-Q ]
+[\c
+.BR \-T ]
+.BR \ envpath
+.SH DESCRIPTION
+The
+.B mdb_load
+utility reads from the standard input and loads it into the
+LMDB environment
+.BR envpath .
+
+The input to
+.B mdb_load
+must be in the output format specified by the
+.BR mdb_dump (1)
+utility or as specified by the
+.B -T
+option below.
+.SH OPTIONS
+.TP
+.BR \-V
+Write the library version number to the standard output, and exit.
+.TP
+.BR \-a
+Append all records in the order they appear in the input. The input is assumed to already be
+in correctly sorted order and no sorting or checking for redundant values will be performed.
+This option must be used to reload data that was produced by running
+.B mdb_dump
+on a database that uses custom compare functions.
+.TP
+.BR \-f \ file
+Read from the specified file instead of from the standard input.
+.TP
+.BR \-n
+Load an LMDB database which does not use subdirectories.
+.TP
+.BR \-s \ subdb
+Load a specific subdatabase. If no database is specified, data is loaded into the main database.
+.TP
+.BR \-N
+Don't overwrite existing records when loading into an already existing database; just skip them.
+.TP
+.BR \-Q
+Quick mode, uses MDB_NOSYNC for faster loading.  Forces sync with mdb_env_sync() before exiting.
+.TP
+.BR \-T
+Load data from simple text files. The input must be paired lines of text, where the first
+line of the pair is the key item, and the second line of the pair is its corresponding
+data item.
+
+A simple escape mechanism, where newline and backslash (\\) characters are special, is
+applied to the text input. Newline characters are interpreted as record separators.
+Backslash characters in the text will be interpreted in one of two ways: If the backslash
+character precedes another backslash character, the pair will be interpreted as a literal
+backslash. If the backslash character precedes any other character, the two characters
+following the backslash will be interpreted as a hexadecimal specification of a single
+character; for example, \\0a is a newline character in the ASCII character set.
+
+For this reason, any backslash or newline characters that naturally occur in the text
+input must be escaped to avoid misinterpretation by
+.BR mdb_load . 
+
+.SH DIAGNOSTICS
+Exit status is zero if no errors occur.
+Errors result in a non-zero exit status and
+a diagnostic message being written to standard error.
+
+.SH "SEE ALSO"
+.BR mdb_dump (1)
+.SH AUTHOR
+Howard Chu of Symas Corporation <http://www.symas.com>
@@ -0,0 +1,515 @@
+/* mdb_load.c - memory-mapped database load tool */
+/*
+ * Copyright 2011-2021 Howard Chu, Symas Corp.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * <http://www.OpenLDAP.org/license.html>.
+ */
+#include <stdio.h>
+#include <stdlib.h>
+#include <errno.h>
+#include <string.h>
+#include <ctype.h>
+#include <unistd.h>
+#include "lmdb.h"
+
+#define PRINT	1
+#define NOHDR	2
+static int mode;
+
+static char *subname = NULL;
+
+static size_t lineno;
+static int version;
+
+static int flags;
+
+static char *prog;
+
+static int Eof;
+
+static MDB_envinfo info;
+
+static MDB_val kbuf, dbuf;
+static MDB_val k0buf;
+
+#ifdef _WIN32
+#define Z	"I"
+#else
+#define Z	"z"
+#endif
+
+#define STRLENOF(s)	(sizeof(s)-1)
+
+typedef struct flagbit {
+	int bit;
+	char *name;
+	int len;
+} flagbit;
+
+#define S(s)	s, STRLENOF(s)
+
+flagbit dbflags[] = {
+	{ MDB_REVERSEKEY, S("reversekey") },
+	{ MDB_DUPSORT, S("dupsort") },
+	{ MDB_INTEGERKEY, S("integerkey") },
+	{ MDB_DUPFIXED, S("dupfixed") },
+	{ MDB_INTEGERDUP, S("integerdup") },
+	{ MDB_REVERSEDUP, S("reversedup") },
+	{ 0, NULL, 0 }
+};
+
+static void readhdr(void)
+{
+	char *ptr;
+
+	flags = 0;
+	while (fgets(dbuf.mv_data, dbuf.mv_size, stdin) != NULL) {
+		lineno++;
+		if (!strncmp(dbuf.mv_data, "VERSION=", STRLENOF("VERSION="))) {
+			version=atoi((char *)dbuf.mv_data+STRLENOF("VERSION="));
+			if (version > 3) {
+				fprintf(stderr, "%s: line %" Z "d: unsupported VERSION %d\n",
+					prog, lineno, version);
+				exit(EXIT_FAILURE);
+			}
+		} else if (!strncmp(dbuf.mv_data, "HEADER=END", STRLENOF("HEADER=END"))) {
+			break;
+		} else if (!strncmp(dbuf.mv_data, "format=", STRLENOF("format="))) {
+			if (!strncmp((char *)dbuf.mv_data+STRLENOF("FORMAT="), "print", STRLENOF("print")))
+				mode |= PRINT;
+			else if (strncmp((char *)dbuf.mv_data+STRLENOF("FORMAT="), "bytevalue", STRLENOF("bytevalue"))) {
+				fprintf(stderr, "%s: line %" Z "d: unsupported FORMAT %s\n",
+					prog, lineno, (char *)dbuf.mv_data+STRLENOF("FORMAT="));
+				exit(EXIT_FAILURE);
+			}
+		} else if (!strncmp(dbuf.mv_data, "database=", STRLENOF("database="))) {
+			ptr = memchr(dbuf.mv_data, '\n', dbuf.mv_size);
+			if (ptr) *ptr = '\0';
+			if (subname) free(subname);
+			subname = strdup((char *)dbuf.mv_data+STRLENOF("database="));
+		} else if (!strncmp(dbuf.mv_data, "type=", STRLENOF("type="))) {
+			if (strncmp((char *)dbuf.mv_data+STRLENOF("type="), "btree", STRLENOF("btree")))  {
+				fprintf(stderr, "%s: line %" Z "d: unsupported type %s\n",
+					prog, lineno, (char *)dbuf.mv_data+STRLENOF("type="));
+				exit(EXIT_FAILURE);
+			}
+		} else if (!strncmp(dbuf.mv_data, "mapaddr=", STRLENOF("mapaddr="))) {
+			int i;
+			ptr = memchr(dbuf.mv_data, '\n', dbuf.mv_size);
+			if (ptr) *ptr = '\0';
+			i = sscanf((char *)dbuf.mv_data+STRLENOF("mapaddr="), "%p", &info.me_mapaddr);
+			if (i != 1) {
+				fprintf(stderr, "%s: line %" Z "d: invalid mapaddr %s\n",
+					prog, lineno, (char *)dbuf.mv_data+STRLENOF("mapaddr="));
+				exit(EXIT_FAILURE);
+			}
+		} else if (!strncmp(dbuf.mv_data, "mapsize=", STRLENOF("mapsize="))) {
+			int i;
+			ptr = memchr(dbuf.mv_data, '\n', dbuf.mv_size);
+			if (ptr) *ptr = '\0';
+			i = sscanf((char *)dbuf.mv_data+STRLENOF("mapsize="), "%" Z "u", &info.me_mapsize);
+			if (i != 1) {
+				fprintf(stderr, "%s: line %" Z "d: invalid mapsize %s\n",
+					prog, lineno, (char *)dbuf.mv_data+STRLENOF("mapsize="));
+				exit(EXIT_FAILURE);
+			}
+		} else if (!strncmp(dbuf.mv_data, "maxreaders=", STRLENOF("maxreaders="))) {
+			int i;
+			ptr = memchr(dbuf.mv_data, '\n', dbuf.mv_size);
+			if (ptr) *ptr = '\0';
+			i = sscanf((char *)dbuf.mv_data+STRLENOF("maxreaders="), "%u", &info.me_maxreaders);
+			if (i != 1) {
+				fprintf(stderr, "%s: line %" Z "d: invalid maxreaders %s\n",
+					prog, lineno, (char *)dbuf.mv_data+STRLENOF("maxreaders="));
+				exit(EXIT_FAILURE);
+			}
+		} else {
+			int i;
+			for (i=0; dbflags[i].bit; i++) {
+				if (!strncmp(dbuf.mv_data, dbflags[i].name, dbflags[i].len) &&
+					((char *)dbuf.mv_data)[dbflags[i].len] == '=') {
+					flags |= dbflags[i].bit;
+					break;
+				}
+			}
+			if (!dbflags[i].bit) {
+				ptr = memchr(dbuf.mv_data, '=', dbuf.mv_size);
+				if (!ptr) {
+					fprintf(stderr, "%s: line %" Z "d: unexpected format\n",
+						prog, lineno);
+					exit(EXIT_FAILURE);
+				} else {
+					*ptr = '\0';
+					fprintf(stderr, "%s: line %" Z "d: unrecognized keyword ignored: %s\n",
+						prog, lineno, (char *)dbuf.mv_data);
+				}
+			}
+		}
+	}
+}
+
+static void badend(void)
+{
+	fprintf(stderr, "%s: line %" Z "d: unexpected end of input\n",
+		prog, lineno);
+}
+
+static int unhex(unsigned char *c2)
+{
+	int x, c;
+	x = *c2++ & 0x4f;
+	if (x & 0x40)
+		x -= 55;
+	c = x << 4;
+	x = *c2 & 0x4f;
+	if (x & 0x40)
+		x -= 55;
+	c |= x;
+	return c;
+}
+
+static int readline(MDB_val *out, MDB_val *buf)
+{
+	unsigned char *c1, *c2, *end;
+	size_t len, l2;
+	int c;
+
+	if (!(mode & NOHDR)) {
+		c = fgetc(stdin);
+		if (c == EOF) {
+			Eof = 1;
+			return EOF;
+		}
+		if (c != ' ') {
+			lineno++;
+			if (fgets(buf->mv_data, buf->mv_size, stdin) == NULL) {
+badend:
+				Eof = 1;
+				badend();
+				return EOF;
+			}
+			if (c == 'D' && !strncmp(buf->mv_data, "ATA=END", STRLENOF("ATA=END")))
+				return EOF;
+			goto badend;
+		}
+	}
+	if (fgets(buf->mv_data, buf->mv_size, stdin) == NULL) {
+		Eof = 1;
+		return EOF;
+	}
+	lineno++;
+
+	c1 = buf->mv_data;
+	len = strlen((char *)c1);
+	if (!len) {
+		/* This can only happen with an intentionally invalid input
+		 * with a NUL byte after the leading SPACE
+		 */
+		goto badend;
+	}
+	l2 = len;
+
+	/* Is buffer too short? */
+	while (c1[len-1] != '\n') {
+		buf->mv_data = realloc(buf->mv_data, buf->mv_size*2);
+		if (!buf->mv_data) {
+			Eof = 1;
+			fprintf(stderr, "%s: line %" Z "d: out of memory, line too long\n",
+				prog, lineno);
+			return EOF;
+		}
+		c1 = buf->mv_data;
+		c1 += l2;
+		if (fgets((char *)c1, buf->mv_size+1, stdin) == NULL) {
+			Eof = 1;
+			badend();
+			return EOF;
+		}
+		buf->mv_size *= 2;
+		len = strlen((char *)c1);
+		l2 += len;
+	}
+	c1 = c2 = buf->mv_data;
+	len = l2;
+	c1[--len] = '\0';
+	end = c1 + len;
+
+	if (mode & PRINT) {
+		while (c2 < end) {
+			if (*c2 == '\\') {
+				if (c2[1] == '\\') {
+					*c1++ = *c2;
+				} else {
+					if (c2+3 > end || !isxdigit(c2[1]) || !isxdigit(c2[2])) {
+						Eof = 1;
+						badend();
+						return EOF;
+					}
+					*c1++ = unhex(++c2);
+				}
+				c2 += 2;
+			} else {
+				/* copies are redundant when no escapes were used */
+				*c1++ = *c2++;
+			}
+		}
+	} else {
+		/* odd length not allowed */
+		if (len & 1) {
+			Eof = 1;
+			badend();
+			return EOF;
+		}
+		while (c2 < end) {
+			if (!isxdigit(*c2) || !isxdigit(c2[1])) {
+				Eof = 1;
+				badend();
+				return EOF;
+			}
+			*c1++ = unhex(c2);
+			c2 += 2;
+		}
+	}
+	c2 = out->mv_data = buf->mv_data;
+	out->mv_size = c1 - c2;
+
+	return 0;
+}
+
+static void usage(void)
+{
+	fprintf(stderr, "usage: %s [-V] [-a] [-f input] [-n] [-s name] [-N] [-T] dbpath\n", prog);
+	exit(EXIT_FAILURE);
+}
+
+static int greater(const MDB_val *a, const MDB_val *b)
+{
+	return 1;
+}
+
+int main(int argc, char *argv[])
+{
+	int i, rc;
+	MDB_env *env;
+	MDB_txn *txn;
+	MDB_cursor *mc;
+	MDB_dbi dbi;
+	char *envname;
+	int envflags = MDB_NOSYNC, putflags = 0;
+	int dohdr = 0, append = 0;
+	MDB_val prevk;
+
+	prog = argv[0];
+
+	if (argc < 2) {
+		usage();
+	}
+
+	/* -a: append records in input order
+	 * -f: load file instead of stdin
+	 * -n: use NOSUBDIR flag on env_open
+	 * -s: load into named subDB
+	 * -N: use NOOVERWRITE on puts
+	 * -Q: quick mode using NOSYNC
+	 * -T: read plaintext
+	 * -V: print version and exit
+	 */
+	while ((i = getopt(argc, argv, "af:ns:NQTV")) != EOF) {
+		switch(i) {
+		case 'V':
+			printf("%s\n", MDB_VERSION_STRING);
+			exit(0);
+			break;
+		case 'a':
+			append = 1;
+			break;
+		case 'f':
+			if (freopen(optarg, "r", stdin) == NULL) {
+				fprintf(stderr, "%s: %s: reopen: %s\n",
+					prog, optarg, strerror(errno));
+				exit(EXIT_FAILURE);
+			}
+			break;
+		case 'n':
+			envflags |= MDB_NOSUBDIR;
+			break;
+		case 's':
+			subname = strdup(optarg);
+			break;
+		case 'N':
+			putflags = MDB_NOOVERWRITE|MDB_NODUPDATA;
+			break;
+		case 'Q':
+			envflags |= MDB_NOSYNC;
+			break;
+		case 'T':
+			mode |= NOHDR | PRINT;
+			break;
+		default:
+			usage();
+		}
+	}
+
+	if (optind != argc - 1)
+		usage();
+
+	dbuf.mv_size = 4096;
+	dbuf.mv_data = malloc(dbuf.mv_size);
+
+	if (!(mode & NOHDR))
+		readhdr();
+
+	envname = argv[optind];
+	rc = mdb_env_create(&env);
+	if (rc) {
+		fprintf(stderr, "mdb_env_create failed, error %d %s\n", rc, mdb_strerror(rc));
+		return EXIT_FAILURE;
+	}
+
+	mdb_env_set_maxdbs(env, 2);
+
+	if (info.me_maxreaders)
+		mdb_env_set_maxreaders(env, info.me_maxreaders);
+
+	if (info.me_mapsize)
+		mdb_env_set_mapsize(env, info.me_mapsize);
+
+	if (info.me_mapaddr)
+		envflags |= MDB_FIXEDMAP;
+
+	rc = mdb_env_open(env, envname, envflags, 0664);
+	if (rc) {
+		fprintf(stderr, "mdb_env_open failed, error %d %s\n", rc, mdb_strerror(rc));
+		goto env_close;
+	}
+
+	kbuf.mv_size = mdb_env_get_maxkeysize(env) * 2 + 2;
+	kbuf.mv_data = malloc(kbuf.mv_size * 2);
+	k0buf.mv_size = kbuf.mv_size;
+	k0buf.mv_data = (char *)kbuf.mv_data + kbuf.mv_size;
+	prevk.mv_data = k0buf.mv_data;
+
+	while(!Eof) {
+		MDB_val key, data;
+		int batch = 0;
+		flags = 0;
+		int appflag;
+
+		if (!dohdr) {
+			dohdr = 1;
+		} else if (!(mode & NOHDR))
+			readhdr();
+		
+		rc = mdb_txn_begin(env, NULL, 0, &txn);
+		if (rc) {
+			fprintf(stderr, "mdb_txn_begin failed, error %d %s\n", rc, mdb_strerror(rc));
+			goto env_close;
+		}
+
+		rc = mdb_dbi_open(txn, subname, flags|MDB_CREATE, &dbi);
+		if (rc) {
+			fprintf(stderr, "mdb_dbi_open failed, error %d %s\n", rc, mdb_strerror(rc));
+			goto txn_abort;
+		}
+		prevk.mv_size = 0;
+		if (append) {
+			mdb_set_compare(txn, dbi, greater);
+			if (flags & MDB_DUPSORT)
+				mdb_set_dupsort(txn, dbi, greater);
+		}
+
+		rc = mdb_cursor_open(txn, dbi, &mc);
+		if (rc) {
+			fprintf(stderr, "mdb_cursor_open failed, error %d %s\n", rc, mdb_strerror(rc));
+			goto txn_abort;
+		}
+
+		while(1) {
+			rc = readline(&key, &kbuf);
+			if (rc)  /* rc == EOF */
+				break;
+
+			rc = readline(&data, &dbuf);
+			if (rc) {
+				fprintf(stderr, "%s: line %" Z "d: failed to read key value\n", prog, lineno);
+				goto txn_abort;
+			}
+
+			if (append) {
+				appflag = MDB_APPEND;
+				if (flags & MDB_DUPSORT) {
+					if (prevk.mv_size == key.mv_size && !memcmp(prevk.mv_data, key.mv_data, key.mv_size))
+						appflag = MDB_CURRENT|MDB_APPENDDUP;
+					else {
+						memcpy(prevk.mv_data, key.mv_data, key.mv_size);
+						prevk.mv_size = key.mv_size;
+					}
+				}
+			} else {
+				appflag = 0;
+			}
+			rc = mdb_cursor_put(mc, &key, &data, putflags|appflag);
+			if (rc == MDB_KEYEXIST && putflags)
+				continue;
+			if (rc) {
+				fprintf(stderr, "%s: line %" Z "d: mdb_cursor_put failed, error %d %s\n", prog, lineno, rc, mdb_strerror(rc));
+				goto txn_abort;
+			}
+			batch++;
+			if (batch == 100) {
+				rc = mdb_txn_commit(txn);
+				if (rc) {
+					fprintf(stderr, "%s: line %" Z "d: txn_commit: %s\n",
+						prog, lineno, mdb_strerror(rc));
+					goto env_close;
+				}
+				rc = mdb_txn_begin(env, NULL, 0, &txn);
+				if (rc) {
+					fprintf(stderr, "mdb_txn_begin failed, error %d %s\n", rc, mdb_strerror(rc));
+					goto env_close;
+				}
+				rc = mdb_cursor_open(txn, dbi, &mc);
+				if (rc) {
+					fprintf(stderr, "mdb_cursor_open failed, error %d %s\n", rc, mdb_strerror(rc));
+					goto txn_abort;
+				}
+				if (append) {
+					MDB_val k, d;
+					mdb_cursor_get(mc, &k, &d, MDB_LAST);
+					memcpy(prevk.mv_data, k.mv_data, k.mv_size);
+					prevk.mv_size = k.mv_size;
+				}
+				batch = 0;
+			}
+		}
+		rc = mdb_txn_commit(txn);
+		txn = NULL;
+		if (rc) {
+			fprintf(stderr, "%s: line %" Z "d: txn_commit: %s\n",
+				prog, lineno, mdb_strerror(rc));
+			goto env_close;
+		}
+		if (envflags & MDB_NOSYNC) {
+			rc = mdb_env_sync(env, 1);
+			if (rc) {
+				fprintf(stderr, "mdb_env_sync failed, error %d %s\n", rc, mdb_strerror(rc));
+				goto env_close;
+			}
+		}
+		mdb_dbi_close(env, dbi);
+	}
+
+txn_abort:
+	mdb_txn_abort(txn);
+env_close:
+	mdb_env_close(env);
+
+	return rc ? EXIT_FAILURE : EXIT_SUCCESS;
+}
@@ -0,0 +1,64 @@
+.TH MDB_STAT 1 "2015/09/30" "LMDB 0.9.17"
+.\" Copyright 2012-2021 Howard Chu, Symas Corp. All Rights Reserved.
+.\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
+.SH NAME
+mdb_stat \- LMDB environment status tool
+.SH SYNOPSIS
+.B mdb_stat
+[\c
+.BR \-V ]
+[\c
+.BR \-e ]
+[\c
+.BR \-f [ f [ f ]]]
+[\c
+.BR \-n ]
+[\c
+.BR \-r [ r ]]
+[\c
+.BR \-a \ |
+.BI \-s \ subdb\fR]
+.BR \ envpath
+.SH DESCRIPTION
+The
+.B mdb_stat
+utility displays the status of an LMDB environment.
+.SH OPTIONS
+.TP
+.BR \-V
+Write the library version number to the standard output, and exit.
+.TP
+.BR \-e
+Display information about the database environment.
+.TP
+.BR \-f
+Display information about the environment freelist.
+If \fB\-ff\fP is given, summarize each freelist entry.
+If \fB\-fff\fP is given, display the full list of page IDs in the freelist.
+.TP
+.BR \-n
+Display the status of an LMDB database which does not use subdirectories.
+.TP
+.BR \-r
+Display information about the environment reader table.
+Shows the process ID, thread ID, and transaction ID for each active
+reader slot. The process ID and transaction ID are in decimal, the
+thread ID is in hexadecimal. The transaction ID is displayed as "-"
+if the reader does not currently have a read transaction open.
+If \fB\-rr\fP is given, check for stale entries in the reader
+table and clear them. The reader table will be printed again
+after the check is performed.
+.TP
+.BR \-a
+Display the status of all of the subdatabases in the environment.
+.TP
+.BR \-s \ subdb
+Display the status of a specific subdatabase.
+.SH DIAGNOSTICS
+Exit status is zero if no errors occur.
+Errors result in a non-zero exit status and
+a diagnostic message being written to standard error.
+.SH "SEE ALSO"
+.BR mdb_copy (1)
+.SH AUTHOR
+Howard Chu of Symas Corporation <http://www.symas.com>
@@ -0,0 +1,263 @@
+/* mdb_stat.c - memory-mapped database status tool */
+/*
+ * Copyright 2011-2021 Howard Chu, Symas Corp.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * <http://www.OpenLDAP.org/license.html>.
+ */
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <unistd.h>
+#include "lmdb.h"
+
+#ifdef	_WIN32
+#define	Z	"I"
+#else
+#define	Z	"z"
+#endif
+
+static void prstat(MDB_stat *ms)
+{
+#if 0
+	printf("  Page size: %u\n", ms->ms_psize);
+#endif
+	printf("  Tree depth: %u\n", ms->ms_depth);
+	printf("  Branch pages: %"Z"u\n", ms->ms_branch_pages);
+	printf("  Leaf pages: %"Z"u\n", ms->ms_leaf_pages);
+	printf("  Overflow pages: %"Z"u\n", ms->ms_overflow_pages);
+	printf("  Entries: %"Z"u\n", ms->ms_entries);
+}
+
+static void usage(char *prog)
+{
+	fprintf(stderr, "usage: %s [-V] [-n] [-e] [-r[r]] [-f[f[f]]] [-a|-s subdb] dbpath\n", prog);
+	exit(EXIT_FAILURE);
+}
+
+int main(int argc, char *argv[])
+{
+	int i, rc;
+	MDB_env *env;
+	MDB_txn *txn;
+	MDB_dbi dbi;
+	MDB_stat mst;
+	MDB_envinfo mei;
+	char *prog = argv[0];
+	char *envname;
+	char *subname = NULL;
+	int alldbs = 0, envinfo = 0, envflags = 0, freinfo = 0, rdrinfo = 0;
+
+	if (argc < 2) {
+		usage(prog);
+	}
+
+	/* -a: print stat of main DB and all subDBs
+	 * -s: print stat of only the named subDB
+	 * -e: print env info
+	 * -f: print freelist info
+	 * -r: print reader info
+	 * -n: use NOSUBDIR flag on env_open
+	 * -V: print version and exit
+	 * (default) print stat of only the main DB
+	 */
+	while ((i = getopt(argc, argv, "Vaefnrs:")) != EOF) {
+		switch(i) {
+		case 'V':
+			printf("%s\n", MDB_VERSION_STRING);
+			exit(0);
+			break;
+		case 'a':
+			if (subname)
+				usage(prog);
+			alldbs++;
+			break;
+		case 'e':
+			envinfo++;
+			break;
+		case 'f':
+			freinfo++;
+			break;
+		case 'n':
+			envflags |= MDB_NOSUBDIR;
+			break;
+		case 'r':
+			rdrinfo++;
+			break;
+		case 's':
+			if (alldbs)
+				usage(prog);
+			subname = optarg;
+			break;
+		default:
+			usage(prog);
+		}
+	}
+
+	if (optind != argc - 1)
+		usage(prog);
+
+	envname = argv[optind];
+	rc = mdb_env_create(&env);
+	if (rc) {
+		fprintf(stderr, "mdb_env_create failed, error %d %s\n", rc, mdb_strerror(rc));
+		return EXIT_FAILURE;
+	}
+
+	if (alldbs || subname) {
+		mdb_env_set_maxdbs(env, 4);
+	}
+
+	rc = mdb_env_open(env, envname, envflags | MDB_RDONLY, 0664);
+	if (rc) {
+		fprintf(stderr, "mdb_env_open failed, error %d %s\n", rc, mdb_strerror(rc));
+		goto env_close;
+	}
+
+	if (envinfo) {
+		(void)mdb_env_stat(env, &mst);
+		(void)mdb_env_info(env, &mei);
+		printf("Environment Info\n");
+		printf("  Map address: %p\n", mei.me_mapaddr);
+		printf("  Map size: %"Z"u\n", mei.me_mapsize);
+		printf("  Page size: %u\n", mst.ms_psize);
+		printf("  Max pages: %"Z"u\n", mei.me_mapsize / mst.ms_psize);
+		printf("  Number of pages used: %"Z"u\n", mei.me_last_pgno+1);
+		printf("  Last transaction ID: %"Z"u\n", mei.me_last_txnid);
+		printf("  Max readers: %u\n", mei.me_maxreaders);
+		printf("  Number of readers used: %u\n", mei.me_numreaders);
+	}
+
+	if (rdrinfo) {
+		printf("Reader Table Status\n");
+		rc = mdb_reader_list(env, (MDB_msg_func *)fputs, stdout);
+		if (rdrinfo > 1) {
+			int dead;
+			mdb_reader_check(env, &dead);
+			printf("  %d stale readers cleared.\n", dead);
+			rc = mdb_reader_list(env, (MDB_msg_func *)fputs, stdout);
+		}
+		if (!(subname || alldbs || freinfo))
+			goto env_close;
+	}
+
+	rc = mdb_txn_begin(env, NULL, MDB_RDONLY, &txn);
+	if (rc) {
+		fprintf(stderr, "mdb_txn_begin failed, error %d %s\n", rc, mdb_strerror(rc));
+		goto env_close;
+	}
+
+	if (freinfo) {
+		MDB_cursor *cursor;
+		MDB_val key, data;
+		size_t pages = 0, *iptr;
+
+		printf("Freelist Status\n");
+		dbi = 0;
+		rc = mdb_cursor_open(txn, dbi, &cursor);
+		if (rc) {
+			fprintf(stderr, "mdb_cursor_open failed, error %d %s\n", rc, mdb_strerror(rc));
+			goto txn_abort;
+		}
+		rc = mdb_stat(txn, dbi, &mst);
+		if (rc) {
+			fprintf(stderr, "mdb_stat failed, error %d %s\n", rc, mdb_strerror(rc));
+			goto txn_abort;
+		}
+		prstat(&mst);
+		while ((rc = mdb_cursor_get(cursor, &key, &data, MDB_NEXT)) == 0) {
+			iptr = data.mv_data;
+			pages += *iptr;
+			if (freinfo > 1) {
+				char *bad = "";
+				size_t pg, prev;
+				ssize_t i, j, span = 0;
+				j = *iptr++;
+				for (i = j, prev = 1; --i >= 0; ) {
+					pg = iptr[i];
+					if (pg <= prev)
+						bad = " [bad sequence]";
+					prev = pg;
+					pg += span;
+					for (; i >= span && iptr[i-span] == pg; span++, pg++) ;
+				}
+				printf("    Transaction %"Z"u, %"Z"d pages, maxspan %"Z"d%s\n",
+					*(size_t *)key.mv_data, j, span, bad);
+				if (freinfo > 2) {
+					for (--j; j >= 0; ) {
+						pg = iptr[j];
+						for (span=1; --j >= 0 && iptr[j] == pg+span; span++) ;
+						printf(span>1 ? "     %9"Z"u[%"Z"d]\n" : "     %9"Z"u\n",
+							pg, span);
+					}
+				}
+			}
+		}
+		mdb_cursor_close(cursor);
+		printf("  Free pages: %"Z"u\n", pages);
+	}
+
+	rc = mdb_open(txn, subname, 0, &dbi);
+	if (rc) {
+		fprintf(stderr, "mdb_open failed, error %d %s\n", rc, mdb_strerror(rc));
+		goto txn_abort;
+	}
+
+	rc = mdb_stat(txn, dbi, &mst);
+	if (rc) {
+		fprintf(stderr, "mdb_stat failed, error %d %s\n", rc, mdb_strerror(rc));
+		goto txn_abort;
+	}
+	printf("Status of %s\n", subname ? subname : "Main DB");
+	prstat(&mst);
+
+	if (alldbs) {
+		MDB_cursor *cursor;
+		MDB_val key;
+
+		rc = mdb_cursor_open(txn, dbi, &cursor);
+		if (rc) {
+			fprintf(stderr, "mdb_cursor_open failed, error %d %s\n", rc, mdb_strerror(rc));
+			goto txn_abort;
+		}
+		while ((rc = mdb_cursor_get(cursor, &key, NULL, MDB_NEXT_NODUP)) == 0) {
+			char *str;
+			MDB_dbi db2;
+			if (memchr(key.mv_data, '\0', key.mv_size))
+				continue;
+			str = malloc(key.mv_size+1);
+			memcpy(str, key.mv_data, key.mv_size);
+			str[key.mv_size] = '\0';
+			rc = mdb_open(txn, str, 0, &db2);
+			if (rc == MDB_SUCCESS)
+				printf("Status of %s\n", str);
+			free(str);
+			if (rc) continue;
+			rc = mdb_stat(txn, db2, &mst);
+			if (rc) {
+				fprintf(stderr, "mdb_stat failed, error %d %s\n", rc, mdb_strerror(rc));
+				goto txn_abort;
+			}
+			prstat(&mst);
+			mdb_close(env, db2);
+		}
+		mdb_cursor_close(cursor);
+	}
+
+	if (rc == MDB_NOTFOUND)
+		rc = MDB_SUCCESS;
+
+	mdb_close(env, dbi);
+txn_abort:
+	mdb_txn_abort(txn);
+env_close:
+	mdb_env_close(env);
+
+	return rc ? EXIT_FAILURE : EXIT_SUCCESS;
+}
@@ -0,0 +1,359 @@
+/**	@file midl.c
+ *	@brief ldap bdb back-end ID List functions */
+/* $OpenLDAP$ */
+/* This work is part of OpenLDAP Software <http://www.openldap.org/>.
+ *
+ * Copyright 2000-2021 The OpenLDAP Foundation.
+ * Portions Copyright 2001-2021 Howard Chu, Symas Corp.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * <http://www.OpenLDAP.org/license.html>.
+ */
+
+#include <limits.h>
+#include <string.h>
+#include <stdlib.h>
+#include <errno.h>
+#include <sys/types.h>
+#include "midl.h"
+
+/** @defgroup internal	LMDB Internals
+ *	@{
+ */
+/** @defgroup idls	ID List Management
+ *	@{
+ */
+#define CMP(x,y)	 ( (x) < (y) ? -1 : (x) > (y) )
+
+unsigned mdb_midl_search( MDB_IDL ids, MDB_ID id )
+{
+	/*
+	 * binary search of id in ids
+	 * if found, returns position of id
+	 * if not found, returns first position greater than id
+	 */
+	unsigned base = 0;
+	unsigned cursor = 1;
+	int val = 0;
+	unsigned n = ids[0];
+
+	while( 0 < n ) {
+		unsigned pivot = n >> 1;
+		cursor = base + pivot + 1;
+		val = CMP( ids[cursor], id );
+
+		if( val < 0 ) {
+			n = pivot;
+
+		} else if ( val > 0 ) {
+			base = cursor;
+			n -= pivot + 1;
+
+		} else {
+			return cursor;
+		}
+	}
+
+	if( val > 0 ) {
+		++cursor;
+	}
+	return cursor;
+}
+
+#if 0	/* superseded by append/sort */
+int mdb_midl_insert( MDB_IDL ids, MDB_ID id )
+{
+	unsigned x, i;
+
+	x = mdb_midl_search( ids, id );
+	assert( x > 0 );
+
+	if( x < 1 ) {
+		/* internal error */
+		return -2;
+	}
+
+	if ( x <= ids[0] && ids[x] == id ) {
+		/* duplicate */
+		assert(0);
+		return -1;
+	}
+
+	if ( ++ids[0] >= MDB_IDL_DB_MAX ) {
+		/* no room */
+		--ids[0];
+		return -2;
+
+	} else {
+		/* insert id */
+		for (i=ids[0]; i>x; i--)
+			ids[i] = ids[i-1];
+		ids[x] = id;
+	}
+
+	return 0;
+}
+#endif
+
+MDB_IDL mdb_midl_alloc(int num)
+{
+	MDB_IDL ids = malloc((num+2) * sizeof(MDB_ID));
+	if (ids) {
+		*ids++ = num;
+		*ids = 0;
+	}
+	return ids;
+}
+
+void mdb_midl_free(MDB_IDL ids)
+{
+	if (ids)
+		free(ids-1);
+}
+
+void mdb_midl_shrink( MDB_IDL *idp )
+{
+	MDB_IDL ids = *idp;
+	if (*(--ids) > MDB_IDL_UM_MAX &&
+		(ids = realloc(ids, (MDB_IDL_UM_MAX+2) * sizeof(MDB_ID))))
+	{
+		*ids++ = MDB_IDL_UM_MAX;
+		*idp = ids;
+	}
+}
+
+static int mdb_midl_grow( MDB_IDL *idp, int num )
+{
+	MDB_IDL idn = *idp-1;
+	/* grow it */
+	idn = realloc(idn, (*idn + num + 2) * sizeof(MDB_ID));
+	if (!idn)
+		return ENOMEM;
+	*idn++ += num;
+	*idp = idn;
+	return 0;
+}
+
+int mdb_midl_need( MDB_IDL *idp, unsigned num )
+{
+	MDB_IDL ids = *idp;
+	num += ids[0];
+	if (num > ids[-1]) {
+		num = (num + num/4 + (256 + 2)) & -256;
+		if (!(ids = realloc(ids-1, num * sizeof(MDB_ID))))
+			return ENOMEM;
+		*ids++ = num - 2;
+		*idp = ids;
+	}
+	return 0;
+}
+
+int mdb_midl_append( MDB_IDL *idp, MDB_ID id )
+{
+	MDB_IDL ids = *idp;
+	/* Too big? */
+	if (ids[0] >= ids[-1]) {
+		if (mdb_midl_grow(idp, MDB_IDL_UM_MAX))
+			return ENOMEM;
+		ids = *idp;
+	}
+	ids[0]++;
+	ids[ids[0]] = id;
+	return 0;
+}
+
+int mdb_midl_append_list( MDB_IDL *idp, MDB_IDL app )
+{
+	MDB_IDL ids = *idp;
+	/* Too big? */
+	if (ids[0] + app[0] >= ids[-1]) {
+		if (mdb_midl_grow(idp, app[0]))
+			return ENOMEM;
+		ids = *idp;
+	}
+	memcpy(&ids[ids[0]+1], &app[1], app[0] * sizeof(MDB_ID));
+	ids[0] += app[0];
+	return 0;
+}
+
+int mdb_midl_append_range( MDB_IDL *idp, MDB_ID id, unsigned n )
+{
+	MDB_ID *ids = *idp, len = ids[0];
+	/* Too big? */
+	if (len + n > ids[-1]) {
+		if (mdb_midl_grow(idp, n | MDB_IDL_UM_MAX))
+			return ENOMEM;
+		ids = *idp;
+	}
+	ids[0] = len + n;
+	ids += len;
+	while (n)
+		ids[n--] = id++;
+	return 0;
+}
+
+void mdb_midl_xmerge( MDB_IDL idl, MDB_IDL merge )
+{
+	MDB_ID old_id, merge_id, i = merge[0], j = idl[0], k = i+j, total = k;
+	idl[0] = (MDB_ID)-1;		/* delimiter for idl scan below */
+	old_id = idl[j];
+	while (i) {
+		merge_id = merge[i--];
+		for (; old_id < merge_id; old_id = idl[--j])
+			idl[k--] = old_id;
+		idl[k--] = merge_id;
+	}
+	idl[0] = total;
+}
+
+/* Quicksort + Insertion sort for small arrays */
+
+#define SMALL	8
+#define	MIDL_SWAP(a,b)	{ itmp=(a); (a)=(b); (b)=itmp; }
+
+void
+mdb_midl_sort( MDB_IDL ids )
+{
+	/* Max possible depth of int-indexed tree * 2 items/level */
+	int istack[sizeof(int)*CHAR_BIT * 2];
+	int i,j,k,l,ir,jstack;
+	MDB_ID a, itmp;
+
+	ir = (int)ids[0];
+	l = 1;
+	jstack = 0;
+	for(;;) {
+		if (ir - l < SMALL) {	/* Insertion sort */
+			for (j=l+1;j<=ir;j++) {
+				a = ids[j];
+				for (i=j-1;i>=1;i--) {
+					if (ids[i] >= a) break;
+					ids[i+1] = ids[i];
+				}
+				ids[i+1] = a;
+			}
+			if (jstack == 0) break;
+			ir = istack[jstack--];
+			l = istack[jstack--];
+		} else {
+			k = (l + ir) >> 1;	/* Choose median of left, center, right */
+			MIDL_SWAP(ids[k], ids[l+1]);
+			if (ids[l] < ids[ir]) {
+				MIDL_SWAP(ids[l], ids[ir]);
+			}
+			if (ids[l+1] < ids[ir]) {
+				MIDL_SWAP(ids[l+1], ids[ir]);
+			}
+			if (ids[l] < ids[l+1]) {
+				MIDL_SWAP(ids[l], ids[l+1]);
+			}
+			i = l+1;
+			j = ir;
+			a = ids[l+1];
+			for(;;) {
+				do i++; while(ids[i] > a);
+				do j--; while(ids[j] < a);
+				if (j < i) break;
+				MIDL_SWAP(ids[i],ids[j]);
+			}
+			ids[l+1] = ids[j];
+			ids[j] = a;
+			jstack += 2;
+			if (ir-i+1 >= j-l) {
+				istack[jstack] = ir;
+				istack[jstack-1] = i;
+				ir = j-1;
+			} else {
+				istack[jstack] = j-1;
+				istack[jstack-1] = l;
+				l = i;
+			}
+		}
+	}
+}
+
+unsigned mdb_mid2l_search( MDB_ID2L ids, MDB_ID id )
+{
+	/*
+	 * binary search of id in ids
+	 * if found, returns position of id
+	 * if not found, returns first position greater than id
+	 */
+	unsigned base = 0;
+	unsigned cursor = 1;
+	int val = 0;
+	unsigned n = (unsigned)ids[0].mid;
+
+	while( 0 < n ) {
+		unsigned pivot = n >> 1;
+		cursor = base + pivot + 1;
+		val = CMP( id, ids[cursor].mid );
+
+		if( val < 0 ) {
+			n = pivot;
+
+		} else if ( val > 0 ) {
+			base = cursor;
+			n -= pivot + 1;
+
+		} else {
+			return cursor;
+		}
+	}
+
+	if( val > 0 ) {
+		++cursor;
+	}
+	return cursor;
+}
+
+int mdb_mid2l_insert( MDB_ID2L ids, MDB_ID2 *id )
+{
+	unsigned x, i;
+
+	x = mdb_mid2l_search( ids, id->mid );
+
+	if( x < 1 ) {
+		/* internal error */
+		return -2;
+	}
+
+	if ( x <= ids[0].mid && ids[x].mid == id->mid ) {
+		/* duplicate */
+		return -1;
+	}
+
+	if ( ids[0].mid >= MDB_IDL_UM_MAX ) {
+		/* too big */
+		return -2;
+
+	} else {
+		/* insert id */
+		ids[0].mid++;
+		for (i=(unsigned)ids[0].mid; i>x; i--)
+			ids[i] = ids[i-1];
+		ids[x] = *id;
+	}
+
+	return 0;
+}
+
+int mdb_mid2l_append( MDB_ID2L ids, MDB_ID2 *id )
+{
+	/* Too big? */
+	if (ids[0].mid >= MDB_IDL_UM_MAX) {
+		return -2;
+	}
+	ids[0].mid++;
+	ids[ids[0].mid] = *id;
+	return 0;
+}
+
+/** @} */
+/** @} */
@@ -0,0 +1,188 @@
+/**	@file midl.h
+ *	@brief LMDB ID List header file.
+ *
+ *	This file was originally part of back-bdb but has been
+ *	modified for use in libmdb. Most of the macros defined
+ *	in this file are unused, just left over from the original.
+ *
+ *	This file is only used internally in libmdb and its definitions
+ *	are not exposed publicly.
+ */
+/* $OpenLDAP$ */
+/* This work is part of OpenLDAP Software <http://www.openldap.org/>.
+ *
+ * Copyright 2000-2021 The OpenLDAP Foundation.
+ * Portions Copyright 2001-2021 Howard Chu, Symas Corp.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * <http://www.OpenLDAP.org/license.html>.
+ */
+
+#ifndef _MDB_MIDL_H_
+#define _MDB_MIDL_H_
+
+#include <stddef.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/** @defgroup internal	LMDB Internals
+ *	@{
+ */
+
+/** @defgroup idls	ID List Management
+ *	@{
+ */
+	/** A generic unsigned ID number. These were entryIDs in back-bdb.
+	 *	Preferably it should have the same size as a pointer.
+	 */
+typedef size_t MDB_ID;
+
+	/** An IDL is an ID List, a sorted array of IDs. The first
+	 * element of the array is a counter for how many actual
+	 * IDs are in the list. In the original back-bdb code, IDLs are
+	 * sorted in ascending order. For libmdb IDLs are sorted in
+	 * descending order.
+	 */
+typedef MDB_ID *MDB_IDL;
+
+/* IDL sizes - likely should be even bigger
+ *   limiting factors: sizeof(ID), thread stack size
+ */
+#ifndef MDB_IDL_LOGN
+#define	MDB_IDL_LOGN	16	/* DB_SIZE is 2^16, UM_SIZE is 2^17 */
+#endif
+#define MDB_IDL_DB_SIZE		(1<<MDB_IDL_LOGN)
+#define MDB_IDL_UM_SIZE		(1<<(MDB_IDL_LOGN+1))
+
+#define MDB_IDL_DB_MAX		(MDB_IDL_DB_SIZE-1)
+#define MDB_IDL_UM_MAX		(MDB_IDL_UM_SIZE-1)
+
+#define MDB_IDL_SIZEOF(ids)		(((ids)[0]+1) * sizeof(MDB_ID))
+#define MDB_IDL_IS_ZERO(ids) ( (ids)[0] == 0 )
+#define MDB_IDL_CPY( dst, src ) (memcpy( dst, src, MDB_IDL_SIZEOF( src ) ))
+#define MDB_IDL_FIRST( ids )	( (ids)[1] )
+#define MDB_IDL_LAST( ids )		( (ids)[(ids)[0]] )
+
+	/** Current max length of an #mdb_midl_alloc()ed IDL */
+#define MDB_IDL_ALLOCLEN( ids )	( (ids)[-1] )
+
+	/** Append ID to IDL. The IDL must be big enough. */
+#define mdb_midl_xappend(idl, id) do { \
+		MDB_ID *xidl = (idl), xlen = ++(xidl[0]); \
+		xidl[xlen] = (id); \
+	} while (0)
+
+	/** Search for an ID in an IDL.
+	 * @param[in] ids	The IDL to search.
+	 * @param[in] id	The ID to search for.
+	 * @return	The index of the first ID greater than or equal to \b id.
+	 */
+unsigned mdb_midl_search( MDB_IDL ids, MDB_ID id );
+
+	/** Allocate an IDL.
+	 * Allocates memory for an IDL of the given size.
+	 * @return	IDL on success, NULL on failure.
+	 */
+MDB_IDL mdb_midl_alloc(int num);
+
+	/** Free an IDL.
+	 * @param[in] ids	The IDL to free.
+	 */
+void mdb_midl_free(MDB_IDL ids);
+
+	/** Shrink an IDL.
+	 * Return the IDL to the default size if it has grown larger.
+	 * @param[in,out] idp	Address of the IDL to shrink.
+	 */
+void mdb_midl_shrink(MDB_IDL *idp);
+
+	/** Make room for num additional elements in an IDL.
+	 * @param[in,out] idp	Address of the IDL.
+	 * @param[in] num	Number of elements to make room for.
+	 * @return	0 on success, ENOMEM on failure.
+	 */
+int mdb_midl_need(MDB_IDL *idp, unsigned num);
+
+	/** Append an ID onto an IDL.
+	 * @param[in,out] idp	Address of the IDL to append to.
+	 * @param[in] id	The ID to append.
+	 * @return	0 on success, ENOMEM if the IDL is too large.
+	 */
+int mdb_midl_append( MDB_IDL *idp, MDB_ID id );
+
+	/** Append an IDL onto an IDL.
+	 * @param[in,out] idp	Address of the IDL to append to.
+	 * @param[in] app	The IDL to append.
+	 * @return	0 on success, ENOMEM if the IDL is too large.
+	 */
+int mdb_midl_append_list( MDB_IDL *idp, MDB_IDL app );
+
+	/** Append an ID range onto an IDL.
+	 * @param[in,out] idp	Address of the IDL to append to.
+	 * @param[in] id	The lowest ID to append.
+	 * @param[in] n		Number of IDs to append.
+	 * @return	0 on success, ENOMEM if the IDL is too large.
+	 */
+int mdb_midl_append_range( MDB_IDL *idp, MDB_ID id, unsigned n );
+
+	/** Merge an IDL onto an IDL. The destination IDL must be big enough.
+	 * @param[in] idl	The IDL to merge into.
+	 * @param[in] merge	The IDL to merge.
+	 */
+void mdb_midl_xmerge( MDB_IDL idl, MDB_IDL merge );
+
+	/** Sort an IDL.
+	 * @param[in,out] ids	The IDL to sort.
+	 */
+void mdb_midl_sort( MDB_IDL ids );
+
+	/** An ID2 is an ID/pointer pair.
+	 */
+typedef struct MDB_ID2 {
+	MDB_ID mid;		/**< The ID */
+	void *mptr;		/**< The pointer */
+} MDB_ID2;
+
+	/** An ID2L is an ID2 List, a sorted array of ID2s.
+	 * The first element's \b mid member is a count of how many actual
+	 * elements are in the array. The \b mptr member of the first element is unused.
+	 * The array is sorted in ascending order by \b mid.
+	 */
+typedef MDB_ID2 *MDB_ID2L;
+
+	/** Search for an ID in an ID2L.
+	 * @param[in] ids	The ID2L to search.
+	 * @param[in] id	The ID to search for.
+	 * @return	The index of the first ID2 whose \b mid member is greater than or equal to \b id.
+	 */
+unsigned mdb_mid2l_search( MDB_ID2L ids, MDB_ID id );
+
+
+	/** Insert an ID2 into a ID2L.
+	 * @param[in,out] ids	The ID2L to insert into.
+	 * @param[in] id	The ID2 to insert.
+	 * @return	0 on success, -1 if the ID was already present in the ID2L.
+	 */
+int mdb_mid2l_insert( MDB_ID2L ids, MDB_ID2 *id );
+
+	/** Append an ID2 into a ID2L.
+	 * @param[in,out] ids	The ID2L to append into.
+	 * @param[in] id	The ID2 to append.
+	 * @return	0 on success, -2 if the ID2L is too big.
+	 */
+int mdb_mid2l_append( MDB_ID2L ids, MDB_ID2 *id );
+
+/** @} */
+/** @} */
+#ifdef __cplusplus
+}
+#endif
+#endif	/* _MDB_MIDL_H_ */
@@ -0,0 +1,580 @@
+/* mplay.c - memory-mapped database log replay */
+/*
+ * Copyright 2011-2023 Howard Chu, Symas Corp.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * <http://www.OpenLDAP.org/license.html>.
+ */
+#include <stdio.h>
+#include <stdlib.h>
+#include <unistd.h>
+#include <time.h>
+#include <string.h>
+#include <ctype.h>
+#include <assert.h>
+#include <sys/types.h>
+#include <sys/wait.h>
+
+#include "lmdb.h"
+
+#define E(expr) CHECK((rc = (expr)) == MDB_SUCCESS, #expr)
+#define RES(err, expr) ((rc = expr) == (err) || (CHECK(!rc, #expr), 0))
+#define CHECK(test, msg) ((test) ? (void)0 : ((void)fprintf(stderr, \
+	"%s:%d: %s: %s\n", __FILE__, __LINE__, msg, mdb_strerror(rc)), abort()))
+
+#define MDB_SCNy(t)	"z" #t
+
+#define SCMP(s)	s, (sizeof(s)-1)
+char inbuf[8192];
+char *dbuf, *kbuf;
+size_t dbufsize;
+int maxkey;
+
+#define SOFF(s)	(sizeof(s)+1)
+
+#define MAXENVS	16
+#define MAXTXNS	16
+#define MAXCRSS	16
+
+#define MAXPIDS	16
+
+typedef struct crspair {
+	void *tcrs;	/* scanned text pointer */
+	MDB_cursor *rcrs;
+} crspair;
+
+typedef struct txnpair {
+	void *ttxn;	/* scanned text pointer */
+	MDB_txn *rtxn;
+	crspair cursors[MAXCRSS];
+	int ncursors;
+} txnpair;
+
+typedef struct envpair {
+	void *tenv;
+	MDB_env *renv;
+	txnpair txns[MAXTXNS];
+	int ntxns;
+} envpair;
+
+envpair envs[MAXENVS];
+int nenvs;
+
+envpair *lastenv;
+txnpair *lasttxn;
+crspair *lastcrs;
+
+typedef struct pidpair {
+	int tpid;
+	pid_t rpid;
+	int fdout, fdin;
+} pidpair;
+
+pidpair *lastpid;
+
+pidpair pids[MAXPIDS];
+int npids;
+
+unsigned long lcount;
+
+static int unhex(unsigned char *c2)
+{
+	int x, c;
+	x = *c2++ & 0x4f;
+	if (x & 0x40)
+		x -= 55;
+	c = x << 4;
+	x = *c2 & 0x4f;
+	if (x & 0x40)
+		x -= 55;
+	c |= x;
+	return c;
+}
+
+int inhex(char *in, char *out)
+{
+	char *c2 = out;
+	while (isxdigit(*in)) {
+		*c2++ = unhex((unsigned char *)in);
+		in += 2;
+	}
+	return c2 - out;
+}
+
+static void addenv(void *tenv, MDB_env *renv)
+{
+	assert(nenvs < MAXENVS);
+	envs[nenvs].tenv = tenv;
+	envs[nenvs].renv = renv;
+	envs[nenvs].ntxns = 0;
+	lastenv = envs+nenvs;
+	nenvs++;
+}
+
+static envpair *findenv(void *tenv)
+{
+	int i;
+	if (!lastenv || lastenv->tenv != tenv) {
+		for (i=0; i<nenvs; i++)
+			if (envs[i].tenv == tenv)
+				break;
+		assert(i < nenvs);
+		lastenv = &envs[i];
+	}
+	return lastenv;
+}
+
+static void delenv(envpair *ep)
+{
+	int i = ep - envs;
+	for (; i<nenvs-1; i++)
+		envs[i] = envs[i+1];
+	nenvs--;
+	lastenv = NULL;
+}
+
+static void addtxn(void *tenv, void *ttxn, MDB_txn *rtxn)
+{
+	envpair *ep;
+	txnpair *tp;
+
+	ep = findenv(tenv);
+	assert(ep->ntxns < MAXTXNS);
+	tp = ep->txns+ep->ntxns;
+	tp->ttxn = ttxn;
+	tp->rtxn = rtxn;
+	tp->ncursors = 0;
+	ep->ntxns++;
+	lasttxn = tp;
+}
+
+static txnpair *findtxn(void *ttxn)
+{
+	int i, j;
+	if (lasttxn && lasttxn->ttxn == ttxn)
+		return lasttxn;
+	if (lastenv) {
+		for (i=0; i<lastenv->ntxns; i++) {
+			if (lastenv->txns[i].ttxn == ttxn) {
+				lasttxn = lastenv->txns+i;
+				return lasttxn;
+			}
+		}
+	}
+	for (i=0; i<nenvs; i++) {
+		if (envs+i == lastenv) continue;
+		for (j=0; j<envs[i].ntxns; j++) {
+			if (envs[i].txns[j].ttxn == ttxn) {
+				lastenv = envs+i;
+				lasttxn = envs[i].txns+j;
+				return lasttxn;
+			}
+		}
+	}
+	assert(0);	/* should have found it */
+}
+
+static void deltxn(txnpair *tp)
+{
+	int i = tp - lastenv->txns;
+	for (; i<lastenv->ntxns-1; i++)
+		lastenv->txns[i] = lastenv->txns[i+1];
+	lastenv->ntxns--;
+	lasttxn = NULL;
+}
+
+static void addcrs(txnpair *tp, void *tcrs, MDB_cursor *rcrs)
+{
+	int j = tp->ncursors;
+	assert(tp->ncursors < MAXCRSS);
+
+	tp->cursors[j].tcrs = tcrs;
+	tp->cursors[j].rcrs = rcrs;
+	tp->ncursors++;
+	lastcrs = tp->cursors+j;
+}
+
+static crspair *findcrs(void *tcrs)
+{
+	int i, j, k;
+	envpair *ep;
+	txnpair *tp;
+	crspair *cp;
+	if (lastcrs && lastcrs->tcrs == tcrs)
+		return lastcrs;
+	if (lasttxn) {
+		for (k=0, cp=lasttxn->cursors; k<lasttxn->ncursors; k++, cp++) {
+			if (cp->tcrs == tcrs) {
+				lastcrs = cp;
+				return lastcrs;
+			}
+		}
+	}
+	if (lastenv) {
+		for (j=0, tp=lastenv->txns; j<lastenv->ntxns; j++, tp++){
+			if (tp == lasttxn)
+				continue;
+			for (k=0, cp = tp->cursors; k<tp->ncursors; k++, cp++) {
+				if (cp->tcrs == tcrs) {
+					lastcrs = cp;
+					lasttxn = tp;
+					return lastcrs;
+				}
+			}
+		}
+	}
+	for (i=0, ep=envs; i<nenvs; i++, ep++) {
+		for (j=0, tp=ep->txns; j<ep->ntxns; j++, tp++) {
+			if (tp == lasttxn)
+				continue;
+			for (k=0, cp = tp->cursors; k<tp->ncursors; k++, cp++) {
+				if (cp->tcrs == tcrs) {
+					lastcrs = cp;
+					lasttxn = tp;
+					lastenv = ep;
+					return lastcrs;
+				}
+			}
+		}
+	}
+	assert(0);	/* should have found it already */
+}
+
+static void delcrs(void *tcrs)
+{
+	int i;
+	crspair *cp = findcrs(tcrs);
+	mdb_cursor_close(cp->rcrs);
+	for (i = cp - lasttxn->cursors; i<lasttxn->ncursors-1; i++)
+		lasttxn->cursors[i] = lasttxn->cursors[i+1];
+	lasttxn->ncursors--;
+	lastcrs = NULL;
+}
+
+void child()
+{
+	int rc;
+	MDB_val key, data;
+	char *ptr;
+
+	while (fgets(inbuf, sizeof(inbuf), stdin)) {
+		ptr = inbuf;
+		if (!strncmp(ptr, SCMP("exit")))
+			break;
+
+		if (!strncmp(ptr, SCMP("mdb_env_create"))) {
+			void *tenv;
+			MDB_env *renv;
+			sscanf(ptr+SOFF("mdb_env_create"), "%p", &tenv);
+			E(mdb_env_create(&renv));
+			addenv(tenv, renv);
+		} else if (!strncmp(ptr, SCMP("mdb_env_set_maxdbs"))) {
+			void *tenv;
+			envpair *ep;
+			unsigned int maxdbs;
+			sscanf(ptr+SOFF("mdb_env_set_maxdbs"), "%p, %u", &tenv, &maxdbs);
+			ep = findenv(tenv);
+			E(mdb_env_set_maxdbs(ep->renv, maxdbs));
+		} else if (!strncmp(ptr, SCMP("mdb_env_set_mapsize"))) {
+			void *tenv;
+			envpair *ep;
+			size_t mapsize;
+			sscanf(ptr+SOFF("mdb_env_set_mapsize"), "%p, %"MDB_SCNy(u), &tenv, &mapsize);
+			ep = findenv(tenv);
+			E(mdb_env_set_mapsize(ep->renv, mapsize));
+		} else if (!strncmp(ptr, SCMP("mdb_env_open"))) {
+			void *tenv;
+			envpair *ep;
+			char *path;
+			int len;
+			unsigned int flags, mode;
+			sscanf(ptr+SOFF("mdb_env_open"), "%p, %n", &tenv, &len);
+			path = ptr+SOFF("mdb_env_open")+len;
+			ptr = strchr(path, ',');
+			*ptr++ = '\0';
+			sscanf(ptr, "%u, %o", &flags, &mode);
+			ep = findenv(tenv);
+			E(mdb_env_open(ep->renv, path, flags, mode));
+			if (!maxkey) {
+				maxkey = mdb_env_get_maxkeysize(ep->renv);
+				kbuf = malloc(maxkey+2);
+				dbuf = malloc(maxkey+2);
+				dbufsize = maxkey;
+			}
+		} else if (!strncmp(ptr, SCMP("mdb_env_close"))) {
+			void *tenv;
+			envpair *ep;
+			sscanf(ptr+SOFF("mdb_env_close"), "%p", &tenv);
+			ep = findenv(tenv);
+			mdb_env_close(ep->renv);
+			delenv(ep);
+			if (!nenvs)	/* if no other envs left, this process is done */
+				break;
+		} else if (!strncmp(ptr, SCMP("mdb_txn_begin"))) {
+			unsigned int flags;
+			void *tenv, *ttxn;
+			envpair *ep;
+			MDB_txn *rtxn;
+			sscanf(ptr+SOFF("mdb_txn_begin"), "%p, %*p, %u = %p", &tenv, &flags, &ttxn);
+			ep = findenv(tenv);
+			E(mdb_txn_begin(ep->renv, NULL, flags, &rtxn));
+			addtxn(tenv, ttxn, rtxn);
+		} else if (!strncmp(ptr, SCMP("mdb_txn_commit"))) {
+			void *ttxn;
+			txnpair *tp;
+			sscanf(ptr+SOFF("mdb_txn_commit"), "%p", &ttxn);
+			tp = findtxn(ttxn);
+			E(mdb_txn_commit(tp->rtxn));
+			deltxn(tp);
+		} else if (!strncmp(ptr, SCMP("mdb_txn_abort"))) {
+			void *ttxn;
+			txnpair *tp;
+			sscanf(ptr+SOFF("mdb_txn_abort"), "%p", &ttxn);
+			tp = findtxn(ttxn);
+			mdb_txn_abort(tp->rtxn);
+			deltxn(tp);
+		} else if (!strncmp(ptr, SCMP("mdb_dbi_open"))) {
+			void *ttxn;
+			txnpair *tp;
+			char *dbname;
+			unsigned int flags;
+			unsigned int tdbi;
+			MDB_dbi dbi;
+			sscanf(ptr+SOFF("mdb_dbi_open"), "%p, ", &ttxn);
+			dbname = strchr(ptr+SOFF("mdb_dbi_open"), ',');
+			dbname += 2;
+			ptr = strchr(dbname, ',');
+			*ptr++ = '\0';
+			if (!strcmp(dbname, "(null)"))
+				dbname = NULL;
+			sscanf(ptr, "%u = %u", &flags, &tdbi);
+			tp = findtxn(ttxn);
+			E(mdb_dbi_open(tp->rtxn, dbname, flags, &dbi));
+		} else if (!strncmp(ptr, SCMP("mdb_dbi_close"))) {
+			void *tenv;
+			envpair *ep;
+			unsigned int tdbi;
+			sscanf(ptr+SOFF("mdb_dbi_close"), "%p, %u", &tenv, &tdbi);
+			ep = findenv(tenv);
+			mdb_dbi_close(ep->renv, tdbi);
+		} else if (!strncmp(ptr, SCMP("mdb_cursor_open"))) {
+			void *ttxn, *tcrs;
+			txnpair *tp;
+			MDB_cursor *rcrs;
+			unsigned int tdbi;
+			sscanf(ptr+SOFF("mdb_cursor_open"), "%p, %u = %p", &ttxn, &tdbi, &tcrs);
+			tp = findtxn(ttxn);
+			E(mdb_cursor_open(tp->rtxn, tdbi, &rcrs));
+			addcrs(tp, tcrs, rcrs);
+		} else if (!strncmp(ptr, SCMP("mdb_cursor_close"))) {
+			void *tcrs;
+			sscanf(ptr+SOFF("mdb_cursor_close"), "%p", &tcrs);
+			delcrs(tcrs);
+		} else if (!strncmp(ptr, SCMP("mdb_cursor_put"))) {
+			void *tcrs;
+			crspair *cp;
+			unsigned int flags;
+			int len;
+			sscanf(ptr+SOFF("mdb_cursor_put"), "%p, ", &tcrs);
+			cp = findcrs(tcrs);
+			ptr = strchr(ptr+SOFF("mdb_cursor_put"), ',');
+			sscanf(ptr+1, "%"MDB_SCNy(u)",", &key.mv_size);
+			if (key.mv_size) {
+				ptr = strchr(ptr, '[');
+				inhex(ptr+1, kbuf);
+				key.mv_data = kbuf;
+				ptr += key.mv_size * 2 + 2;
+			}
+			ptr = strchr(ptr+1, ',');
+			sscanf(ptr+1, "%"MDB_SCNy(u)"%n", &data.mv_size, &len);
+			if (data.mv_size > dbufsize) {
+				dbuf = realloc(dbuf, data.mv_size+2);
+				assert(dbuf != NULL);
+				dbufsize = data.mv_size;
+			}
+			ptr += len+1;
+			if (*ptr == '[') {
+				inhex(ptr+1, dbuf);
+				data.mv_data = dbuf;
+				ptr += data.mv_size * 2 + 2;
+			} else {
+				sprintf(dbuf, "%09ld", (long)mdb_txn_id(lasttxn->rtxn));
+			}
+			sscanf(ptr+1, "%u", &flags);
+			E(mdb_cursor_put(cp->rcrs, &key, &data, flags));
+		} else if (!strncmp(ptr, SCMP("mdb_cursor_del"))) {
+			void *tcrs;
+			crspair *cp;
+			unsigned int flags;
+			sscanf(ptr+SOFF("mdb_cursor_del"), "%p, %u", &tcrs, &flags);
+			cp = findcrs(tcrs);
+			E(mdb_cursor_del(cp->rcrs, flags));
+		} else if (!strncmp(ptr, SCMP("mdb_put"))) {
+			void *ttxn;
+			txnpair *tp;
+			unsigned int tdbi, flags;
+			int len;
+			sscanf(ptr+SOFF("mdb_put"),"%p, %u, %"MDB_SCNy(u), &ttxn, &tdbi, &key.mv_size);
+			tp = findtxn(ttxn);
+			ptr = strchr(ptr+SOFF("mdb_put"), '[');
+			inhex(ptr+1, kbuf);
+			key.mv_data = kbuf;
+			ptr += key.mv_size * 2 + 2;
+			sscanf(ptr+1, "%"MDB_SCNy(u)"%n", &data.mv_size, &len);
+			if (data.mv_size > dbufsize) {
+				dbuf = realloc(dbuf, data.mv_size+2);
+				assert(dbuf != NULL);
+				dbufsize = data.mv_size;
+			}
+			ptr += len+1;
+			if (*ptr == '[') {
+				inhex(ptr+1, dbuf);
+				ptr += data.mv_size * 2 + 2;
+			} else {
+				sprintf(dbuf, "%09ld", (long)mdb_txn_id(tp->rtxn));
+			}
+			data.mv_data = dbuf;
+			sscanf(ptr+1, "%u", &flags);
+			RES(MDB_KEYEXIST,mdb_put(tp->rtxn, tdbi, &key, &data, flags));
+		} else if (!strncmp(ptr, SCMP("mdb_del"))) {
+			void *ttxn;
+			txnpair *tp;
+			unsigned int tdbi;
+			int len;
+			sscanf(ptr+SOFF("mdb_del"),"%p, %u, %"MDB_SCNy(u), &ttxn, &tdbi, &key.mv_size);
+			tp = findtxn(ttxn);
+			ptr = strchr(ptr+SOFF("mdb_del"), '[');
+			inhex(ptr+1, kbuf);
+			key.mv_data = kbuf;
+			ptr += key.mv_size * 2 + 2;
+			sscanf(ptr+1, "%"MDB_SCNy(u)"%n", &data.mv_size, &len);
+			if (data.mv_size > dbufsize) {
+				dbuf = realloc(dbuf, data.mv_size+2);
+				assert(dbuf != NULL);
+				dbufsize = data.mv_size;
+			}
+			ptr += len+1;
+			if (*ptr == '[') {
+				inhex(ptr+1, dbuf);
+			} else {
+				sprintf(dbuf, "%09ld", (long)mdb_txn_id(tp->rtxn));
+			}
+			data.mv_data = dbuf;
+			RES(MDB_NOTFOUND,mdb_del(tp->rtxn, tdbi, &key, &data));
+		}
+		write(1, "\n", 1);
+	}
+	exit(0);
+}
+
+static pidpair *addpid(int tpid)
+{
+	int fdout[2], fdin[2];
+	pid_t pid;
+	assert(npids < MAXPIDS);
+	pids[npids].tpid = tpid;
+	pipe(fdout);
+	pipe(fdin);
+	if ((pid = fork()) == 0) {
+		/* child */
+		fflush(stdin);
+		fflush(stdout);
+		dup2(fdout[0], 0);
+		dup2(fdin[1], 1);
+		child();
+		return 0;	/* NOTREACHED */
+	} else {
+		pids[npids].rpid = pid;
+		pids[npids].fdout = fdout[1];
+		pids[npids].fdin = fdin[0];
+		lastpid = pids+npids;
+		npids++;
+		return lastpid;
+	}
+}
+
+static pidpair *findpid(int tpid)
+{
+	int i;
+	if (!lastpid || lastpid->tpid != tpid) {
+		for (i=0; i<npids; i++)
+			if (pids[i].tpid == tpid)
+				break;
+		if (i == npids)
+			return NULL;
+		lastpid = &pids[i];
+	}
+	return lastpid;
+}
+
+volatile pid_t killpid;
+
+static void delpid(int tpid)
+{
+	pidpair *pp = findpid(tpid);
+	if (pp) {
+		pid_t kpid = pp->rpid;
+		killpid = kpid;
+		write(pp->fdout, "exit\n", sizeof("exit"));
+		while (killpid == kpid)
+			usleep(10000);
+	}
+}
+
+static void reaper(int sig)
+{
+	int status, i;
+	pid_t pid = waitpid(-1, &status, 0);
+	if (pid > 0) {
+		fprintf(stderr, "# %s %d\n", WIFEXITED(status) ? "exited" : "killed", pid);
+		for (i=0; i<npids; i++)
+			if (pids[i].rpid == pid)
+				break;
+		assert(i < npids);
+		close(pids[i].fdout);
+		close(pids[i].fdin);
+		for (;i<npids-1; i++)
+			pids[i] = pids[i+1];
+		npids--;
+		killpid = 0;
+	}
+}
+
+int main(int argc,char * argv[])
+{
+	signal(SIGCHLD, reaper);
+
+	while (fgets(inbuf, sizeof(inbuf), stdin)) {
+		pidpair *pp;
+		int tpid, len;
+		char c, *ptr;
+		lcount++;
+
+		if (inbuf[0] == '#' && !strncmp(inbuf+1, SCMP(" killed"))) {
+			sscanf(inbuf+SOFF("killed"),"%d", &tpid);
+			delpid(tpid);
+			continue;
+		}
+
+		if (inbuf[0] != '>')
+			continue;
+		ptr = inbuf+1;
+		sscanf(ptr, "%d:%n", &tpid, &len);
+		pp = findpid(tpid);
+		if (!pp)
+			pp = addpid(tpid);	/* new process */
+
+		ptr = inbuf+len+1;
+		len = strlen(ptr);
+		write(pp->fdout, ptr, len);	/* send command and wait for ack */
+		read(pp->fdin, &c, 1);
+	}
+	while (npids)
+		delpid(pids[0].tpid);
+}
@@ -0,0 +1,177 @@
+/* mtest.c - memory-mapped database tester/toy */
+/*
+ * Copyright 2011-2021 Howard Chu, Symas Corp.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * <http://www.OpenLDAP.org/license.html>.
+ */
+#include <stdio.h>
+#include <stdlib.h>
+#include <time.h>
+#include "lmdb.h"
+
+#define E(expr) CHECK((rc = (expr)) == MDB_SUCCESS, #expr)
+#define RES(err, expr) ((rc = expr) == (err) || (CHECK(!rc, #expr), 0))
+#define CHECK(test, msg) ((test) ? (void)0 : ((void)fprintf(stderr, \
+	"%s:%d: %s: %s\n", __FILE__, __LINE__, msg, mdb_strerror(rc)), abort()))
+
+int main(int argc,char * argv[])
+{
+	int i = 0, j = 0, rc;
+	MDB_env *env;
+	MDB_dbi dbi;
+	MDB_val key, data;
+	MDB_txn *txn;
+	MDB_stat mst;
+	MDB_cursor *cursor, *cur2;
+	MDB_cursor_op op;
+	int count;
+	int *values;
+	char sval[32] = "";
+
+	srand(time(NULL));
+
+	    count = (rand()%384) + 64;
+	    values = (int *)malloc(count*sizeof(int));
+
+	    for(i = 0;i<count;i++) {
+			values[i] = rand()%1024;
+	    }
+    
+		E(mdb_env_create(&env));
+		E(mdb_env_set_maxreaders(env, 1));
+		E(mdb_env_set_mapsize(env, 10485760));
+		E(mdb_env_open(env, "./testdb", MDB_FIXEDMAP /*|MDB_NOSYNC*/, 0664));
+
+		E(mdb_txn_begin(env, NULL, 0, &txn));
+		E(mdb_dbi_open(txn, NULL, 0, &dbi));
+   
+		key.mv_size = sizeof(int);
+		key.mv_data = sval;
+
+		printf("Adding %d values\n", count);
+	    for (i=0;i<count;i++) {	
+			sprintf(sval, "%03x %d foo bar", values[i], values[i]);
+			/* Set <data> in each iteration, since MDB_NOOVERWRITE may modify it */
+			data.mv_size = sizeof(sval);
+			data.mv_data = sval;
+			if (RES(MDB_KEYEXIST, mdb_put(txn, dbi, &key, &data, MDB_NOOVERWRITE))) {
+				j++;
+				data.mv_size = sizeof(sval);
+				data.mv_data = sval;
+			}
+	    }
+		if (j) printf("%d duplicates skipped\n", j);
+		E(mdb_txn_commit(txn));
+		E(mdb_env_stat(env, &mst));
+
+		E(mdb_txn_begin(env, NULL, MDB_RDONLY, &txn));
+		E(mdb_cursor_open(txn, dbi, &cursor));
+		while ((rc = mdb_cursor_get(cursor, &key, &data, MDB_NEXT)) == 0) {
+			printf("key: %p %.*s, data: %p %.*s\n",
+				key.mv_data,  (int) key.mv_size,  (char *) key.mv_data,
+				data.mv_data, (int) data.mv_size, (char *) data.mv_data);
+		}
+		CHECK(rc == MDB_NOTFOUND, "mdb_cursor_get");
+		mdb_cursor_close(cursor);
+		mdb_txn_abort(txn);
+
+		j=0;
+		key.mv_data = sval;
+	    for (i= count - 1; i > -1; i-= (rand()%5)) {
+			j++;
+			txn=NULL;
+			E(mdb_txn_begin(env, NULL, 0, &txn));
+			sprintf(sval, "%03x ", values[i]);
+			if (RES(MDB_NOTFOUND, mdb_del(txn, dbi, &key, NULL))) {
+				j--;
+				mdb_txn_abort(txn);
+			} else {
+				E(mdb_txn_commit(txn));
+			}
+	    }
+	    free(values);
+		printf("Deleted %d values\n", j);
+
+		E(mdb_env_stat(env, &mst));
+		E(mdb_txn_begin(env, NULL, MDB_RDONLY, &txn));
+		E(mdb_cursor_open(txn, dbi, &cursor));
+		printf("Cursor next\n");
+		while ((rc = mdb_cursor_get(cursor, &key, &data, MDB_NEXT)) == 0) {
+			printf("key: %.*s, data: %.*s\n",
+				(int) key.mv_size,  (char *) key.mv_data,
+				(int) data.mv_size, (char *) data.mv_data);
+		}
+		CHECK(rc == MDB_NOTFOUND, "mdb_cursor_get");
+		printf("Cursor last\n");
+		E(mdb_cursor_get(cursor, &key, &data, MDB_LAST));
+		printf("key: %.*s, data: %.*s\n",
+			(int) key.mv_size,  (char *) key.mv_data,
+			(int) data.mv_size, (char *) data.mv_data);
+		printf("Cursor prev\n");
+		while ((rc = mdb_cursor_get(cursor, &key, &data, MDB_PREV)) == 0) {
+			printf("key: %.*s, data: %.*s\n",
+				(int) key.mv_size,  (char *) key.mv_data,
+				(int) data.mv_size, (char *) data.mv_data);
+		}
+		CHECK(rc == MDB_NOTFOUND, "mdb_cursor_get");
+		printf("Cursor last/prev\n");
+		E(mdb_cursor_get(cursor, &key, &data, MDB_LAST));
+			printf("key: %.*s, data: %.*s\n",
+				(int) key.mv_size,  (char *) key.mv_data,
+				(int) data.mv_size, (char *) data.mv_data);
+		E(mdb_cursor_get(cursor, &key, &data, MDB_PREV));
+			printf("key: %.*s, data: %.*s\n",
+				(int) key.mv_size,  (char *) key.mv_data,
+				(int) data.mv_size, (char *) data.mv_data);
+
+		mdb_cursor_close(cursor);
+		mdb_txn_abort(txn);
+
+		printf("Deleting with cursor\n");
+		E(mdb_txn_begin(env, NULL, 0, &txn));
+		E(mdb_cursor_open(txn, dbi, &cur2));
+		for (i=0; i<50; i++) {
+			if (RES(MDB_NOTFOUND, mdb_cursor_get(cur2, &key, &data, MDB_NEXT)))
+				break;
+			printf("key: %p %.*s, data: %p %.*s\n",
+				key.mv_data,  (int) key.mv_size,  (char *) key.mv_data,
+				data.mv_data, (int) data.mv_size, (char *) data.mv_data);
+			E(mdb_del(txn, dbi, &key, NULL));
+		}
+
+		printf("Restarting cursor in txn\n");
+		for (op=MDB_FIRST, i=0; i<=32; op=MDB_NEXT, i++) {
+			if (RES(MDB_NOTFOUND, mdb_cursor_get(cur2, &key, &data, op)))
+				break;
+			printf("key: %p %.*s, data: %p %.*s\n",
+				key.mv_data,  (int) key.mv_size,  (char *) key.mv_data,
+				data.mv_data, (int) data.mv_size, (char *) data.mv_data);
+		}
+		mdb_cursor_close(cur2);
+		E(mdb_txn_commit(txn));
+
+		printf("Restarting cursor outside txn\n");
+		E(mdb_txn_begin(env, NULL, 0, &txn));
+		E(mdb_cursor_open(txn, dbi, &cursor));
+		for (op=MDB_FIRST, i=0; i<=32; op=MDB_NEXT, i++) {
+			if (RES(MDB_NOTFOUND, mdb_cursor_get(cursor, &key, &data, op)))
+				break;
+			printf("key: %p %.*s, data: %p %.*s\n",
+				key.mv_data,  (int) key.mv_size,  (char *) key.mv_data,
+				data.mv_data, (int) data.mv_size, (char *) data.mv_data);
+		}
+		mdb_cursor_close(cursor);
+		mdb_txn_abort(txn);
+
+		mdb_dbi_close(env, dbi);
+		mdb_env_close(env);
+
+	return 0;
+}
@@ -0,0 +1,124 @@
+/* mtest2.c - memory-mapped database tester/toy */
+/*
+ * Copyright 2011-2021 Howard Chu, Symas Corp.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * <http://www.OpenLDAP.org/license.html>.
+ */
+
+/* Just like mtest.c, but using a subDB instead of the main DB */
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <time.h>
+#include "lmdb.h"
+
+#define E(expr) CHECK((rc = (expr)) == MDB_SUCCESS, #expr)
+#define RES(err, expr) ((rc = expr) == (err) || (CHECK(!rc, #expr), 0))
+#define CHECK(test, msg) ((test) ? (void)0 : ((void)fprintf(stderr, \
+	"%s:%d: %s: %s\n", __FILE__, __LINE__, msg, mdb_strerror(rc)), abort()))
+
+int main(int argc,char * argv[])
+{
+	int i = 0, j = 0, rc;
+	MDB_env *env;
+	MDB_dbi dbi;
+	MDB_val key, data;
+	MDB_txn *txn;
+	MDB_stat mst;
+	MDB_cursor *cursor;
+	int count;
+	int *values;
+	char sval[32] = "";
+
+	srand(time(NULL));
+
+	count = (rand()%384) + 64;
+	values = (int *)malloc(count*sizeof(int));
+
+	for(i = 0;i<count;i++) {
+		values[i] = rand()%1024;
+	}
+
+	E(mdb_env_create(&env));
+	E(mdb_env_set_maxreaders(env, 1));
+	E(mdb_env_set_mapsize(env, 10485760));
+	E(mdb_env_set_maxdbs(env, 4));
+	E(mdb_env_open(env, "./testdb", MDB_FIXEDMAP|MDB_NOSYNC, 0664));
+
+	E(mdb_txn_begin(env, NULL, 0, &txn));
+	E(mdb_dbi_open(txn, "id1", MDB_CREATE, &dbi));
+   
+	key.mv_size = sizeof(int);
+	key.mv_data = sval;
+
+	printf("Adding %d values\n", count);
+	for (i=0;i<count;i++) {	
+		sprintf(sval, "%03x %d foo bar", values[i], values[i]);
+		data.mv_size = sizeof(sval);
+		data.mv_data = sval;
+		if (RES(MDB_KEYEXIST, mdb_put(txn, dbi, &key, &data, MDB_NOOVERWRITE)))
+			j++;
+	}
+	if (j) printf("%d duplicates skipped\n", j);
+	E(mdb_txn_commit(txn));
+	E(mdb_env_stat(env, &mst));
+
+	E(mdb_txn_begin(env, NULL, MDB_RDONLY, &txn));
+	E(mdb_cursor_open(txn, dbi, &cursor));
+	while ((rc = mdb_cursor_get(cursor, &key, &data, MDB_NEXT)) == 0) {
+		printf("key: %p %.*s, data: %p %.*s\n",
+			key.mv_data,  (int) key.mv_size,  (char *) key.mv_data,
+			data.mv_data, (int) data.mv_size, (char *) data.mv_data);
+	}
+	CHECK(rc == MDB_NOTFOUND, "mdb_cursor_get");
+	mdb_cursor_close(cursor);
+	mdb_txn_abort(txn);
+
+	j=0;
+	key.mv_data = sval;
+	for (i= count - 1; i > -1; i-= (rand()%5)) {
+		j++;
+		txn=NULL;
+		E(mdb_txn_begin(env, NULL, 0, &txn));
+		sprintf(sval, "%03x ", values[i]);
+		if (RES(MDB_NOTFOUND, mdb_del(txn, dbi, &key, NULL))) {
+			j--;
+			mdb_txn_abort(txn);
+		} else {
+			E(mdb_txn_commit(txn));
+		}
+	}
+	free(values);
+	printf("Deleted %d values\n", j);
+
+	E(mdb_env_stat(env, &mst));
+	E(mdb_txn_begin(env, NULL, MDB_RDONLY, &txn));
+	E(mdb_cursor_open(txn, dbi, &cursor));
+	printf("Cursor next\n");
+	while ((rc = mdb_cursor_get(cursor, &key, &data, MDB_NEXT)) == 0) {
+		printf("key: %.*s, data: %.*s\n",
+			(int) key.mv_size,  (char *) key.mv_data,
+			(int) data.mv_size, (char *) data.mv_data);
+	}
+	CHECK(rc == MDB_NOTFOUND, "mdb_cursor_get");
+	printf("Cursor prev\n");
+	while ((rc = mdb_cursor_get(cursor, &key, &data, MDB_PREV)) == 0) {
+		printf("key: %.*s, data: %.*s\n",
+			(int) key.mv_size,  (char *) key.mv_data,
+			(int) data.mv_size, (char *) data.mv_data);
+	}
+	CHECK(rc == MDB_NOTFOUND, "mdb_cursor_get");
+	mdb_cursor_close(cursor);
+	mdb_txn_abort(txn);
+
+	mdb_dbi_close(env, dbi);
+	mdb_env_close(env);
+	return 0;
+}
@@ -0,0 +1,133 @@
+/* mtest3.c - memory-mapped database tester/toy */
+/*
+ * Copyright 2011-2021 Howard Chu, Symas Corp.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * <http://www.OpenLDAP.org/license.html>.
+ */
+
+/* Tests for sorted duplicate DBs */
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <time.h>
+#include "lmdb.h"
+
+#define E(expr) CHECK((rc = (expr)) == MDB_SUCCESS, #expr)
+#define RES(err, expr) ((rc = expr) == (err) || (CHECK(!rc, #expr), 0))
+#define CHECK(test, msg) ((test) ? (void)0 : ((void)fprintf(stderr, \
+	"%s:%d: %s: %s\n", __FILE__, __LINE__, msg, mdb_strerror(rc)), abort()))
+
+int main(int argc,char * argv[])
+{
+	int i = 0, j = 0, rc;
+	MDB_env *env;
+	MDB_dbi dbi;
+	MDB_val key, data;
+	MDB_txn *txn;
+	MDB_stat mst;
+	MDB_cursor *cursor;
+	int count;
+	int *values;
+	char sval[32];
+	char kval[sizeof(int)];
+
+	srand(time(NULL));
+
+	memset(sval, 0, sizeof(sval));
+
+	count = (rand()%384) + 64;
+	values = (int *)malloc(count*sizeof(int));
+
+	for(i = 0;i<count;i++) {
+		values[i] = rand()%1024;
+	}
+
+	E(mdb_env_create(&env));
+	E(mdb_env_set_mapsize(env, 10485760));
+	E(mdb_env_set_maxdbs(env, 4));
+	E(mdb_env_open(env, "./testdb", MDB_FIXEDMAP|MDB_NOSYNC, 0664));
+
+	E(mdb_txn_begin(env, NULL, 0, &txn));
+	E(mdb_dbi_open(txn, "id2", MDB_CREATE|MDB_DUPSORT, &dbi));
+
+	key.mv_size = sizeof(int);
+	key.mv_data = kval;
+	data.mv_size = sizeof(sval);
+	data.mv_data = sval;
+
+	printf("Adding %d values\n", count);
+	for (i=0;i<count;i++) {
+		if (!(i & 0x0f))
+			sprintf(kval, "%03x", values[i]);
+		sprintf(sval, "%03x %d foo bar", values[i], values[i]);
+		if (RES(MDB_KEYEXIST, mdb_put(txn, dbi, &key, &data, MDB_NODUPDATA)))
+			j++;
+	}
+	if (j) printf("%d duplicates skipped\n", j);
+	E(mdb_txn_commit(txn));
+	E(mdb_env_stat(env, &mst));
+
+	E(mdb_txn_begin(env, NULL, MDB_RDONLY, &txn));
+	E(mdb_cursor_open(txn, dbi, &cursor));
+	while ((rc = mdb_cursor_get(cursor, &key, &data, MDB_NEXT)) == 0) {
+		printf("key: %p %.*s, data: %p %.*s\n",
+			key.mv_data,  (int) key.mv_size,  (char *) key.mv_data,
+			data.mv_data, (int) data.mv_size, (char *) data.mv_data);
+	}
+	CHECK(rc == MDB_NOTFOUND, "mdb_cursor_get");
+	mdb_cursor_close(cursor);
+	mdb_txn_abort(txn);
+
+	j=0;
+
+	for (i= count - 1; i > -1; i-= (rand()%5)) {
+		j++;
+		txn=NULL;
+		E(mdb_txn_begin(env, NULL, 0, &txn));
+		sprintf(kval, "%03x", values[i & ~0x0f]);
+		sprintf(sval, "%03x %d foo bar", values[i], values[i]);
+		key.mv_size = sizeof(int);
+		key.mv_data = kval;
+		data.mv_size = sizeof(sval);
+		data.mv_data = sval;
+		if (RES(MDB_NOTFOUND, mdb_del(txn, dbi, &key, &data))) {
+			j--;
+			mdb_txn_abort(txn);
+		} else {
+			E(mdb_txn_commit(txn));
+		}
+	}
+	free(values);
+	printf("Deleted %d values\n", j);
+
+	E(mdb_env_stat(env, &mst));
+	E(mdb_txn_begin(env, NULL, MDB_RDONLY, &txn));
+	E(mdb_cursor_open(txn, dbi, &cursor));
+	printf("Cursor next\n");
+	while ((rc = mdb_cursor_get(cursor, &key, &data, MDB_NEXT)) == 0) {
+		printf("key: %.*s, data: %.*s\n",
+			(int) key.mv_size,  (char *) key.mv_data,
+			(int) data.mv_size, (char *) data.mv_data);
+	}
+	CHECK(rc == MDB_NOTFOUND, "mdb_cursor_get");
+	printf("Cursor prev\n");
+	while ((rc = mdb_cursor_get(cursor, &key, &data, MDB_PREV)) == 0) {
+		printf("key: %.*s, data: %.*s\n",
+			(int) key.mv_size,  (char *) key.mv_data,
+			(int) data.mv_size, (char *) data.mv_data);
+	}
+	CHECK(rc == MDB_NOTFOUND, "mdb_cursor_get");
+	mdb_cursor_close(cursor);
+	mdb_txn_abort(txn);
+
+	mdb_dbi_close(env, dbi);
+	mdb_env_close(env);
+	return 0;
+}
@@ -0,0 +1,168 @@
+/* mtest4.c - memory-mapped database tester/toy */
+/*
+ * Copyright 2011-2021 Howard Chu, Symas Corp.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * <http://www.OpenLDAP.org/license.html>.
+ */
+
+/* Tests for sorted duplicate DBs with fixed-size keys */
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <time.h>
+#include "lmdb.h"
+
+#define E(expr) CHECK((rc = (expr)) == MDB_SUCCESS, #expr)
+#define RES(err, expr) ((rc = expr) == (err) || (CHECK(!rc, #expr), 0))
+#define CHECK(test, msg) ((test) ? (void)0 : ((void)fprintf(stderr, \
+	"%s:%d: %s: %s\n", __FILE__, __LINE__, msg, mdb_strerror(rc)), abort()))
+
+int main(int argc,char * argv[])
+{
+	int i = 0, j = 0, rc;
+	MDB_env *env;
+	MDB_dbi dbi;
+	MDB_val key, data;
+	MDB_txn *txn;
+	MDB_stat mst;
+	MDB_cursor *cursor;
+	int count;
+	int *values;
+	char sval[8];
+	char kval[sizeof(int)];
+
+	memset(sval, 0, sizeof(sval));
+
+	count = 510;
+	values = (int *)malloc(count*sizeof(int));
+
+	for(i = 0;i<count;i++) {
+		values[i] = i*5;
+	}
+
+	E(mdb_env_create(&env));
+	E(mdb_env_set_mapsize(env, 10485760));
+	E(mdb_env_set_maxdbs(env, 4));
+	E(mdb_env_open(env, "./testdb", MDB_FIXEDMAP|MDB_NOSYNC, 0664));
+
+	E(mdb_txn_begin(env, NULL, 0, &txn));
+	E(mdb_dbi_open(txn, "id4", MDB_CREATE|MDB_DUPSORT|MDB_DUPFIXED, &dbi));
+
+	key.mv_size = sizeof(int);
+	key.mv_data = kval;
+	data.mv_size = sizeof(sval);
+	data.mv_data = sval;
+
+	printf("Adding %d values\n", count);
+	strcpy(kval, "001");
+	for (i=0;i<count;i++) {
+		sprintf(sval, "%07x", values[i]);
+		if (RES(MDB_KEYEXIST, mdb_put(txn, dbi, &key, &data, MDB_NODUPDATA)))
+			j++;
+	}
+	if (j) printf("%d duplicates skipped\n", j);
+	E(mdb_txn_commit(txn));
+	E(mdb_env_stat(env, &mst));
+
+	/* there should be one full page of dups now.
+	 */
+	E(mdb_txn_begin(env, NULL, MDB_RDONLY, &txn));
+	E(mdb_cursor_open(txn, dbi, &cursor));
+	while ((rc = mdb_cursor_get(cursor, &key, &data, MDB_NEXT)) == 0) {
+		printf("key: %p %.*s, data: %p %.*s\n",
+			key.mv_data,  (int) key.mv_size,  (char *) key.mv_data,
+			data.mv_data, (int) data.mv_size, (char *) data.mv_data);
+	}
+	CHECK(rc == MDB_NOTFOUND, "mdb_cursor_get");
+	mdb_cursor_close(cursor);
+	mdb_txn_abort(txn);
+
+	/* test all 3 branches of split code:
+	 * 1: new key in lower half
+	 * 2: new key at split point
+	 * 3: new key in upper half
+	 */
+
+	key.mv_size = sizeof(int);
+	key.mv_data = kval;
+	data.mv_size = sizeof(sval);
+	data.mv_data = sval;
+
+	sprintf(sval, "%07x", values[3]+1);
+	E(mdb_txn_begin(env, NULL, 0, &txn));
+	(void)RES(MDB_KEYEXIST, mdb_put(txn, dbi, &key, &data, MDB_NODUPDATA));
+	mdb_txn_abort(txn);
+
+	sprintf(sval, "%07x", values[255]+1);
+	E(mdb_txn_begin(env, NULL, 0, &txn));
+	(void)RES(MDB_KEYEXIST, mdb_put(txn, dbi, &key, &data, MDB_NODUPDATA));
+	mdb_txn_abort(txn);
+
+	sprintf(sval, "%07x", values[500]+1);
+	E(mdb_txn_begin(env, NULL, 0, &txn));
+	(void)RES(MDB_KEYEXIST, mdb_put(txn, dbi, &key, &data, MDB_NODUPDATA));
+	E(mdb_txn_commit(txn));
+
+	/* Try MDB_NEXT_MULTIPLE */
+	E(mdb_txn_begin(env, NULL, 0, &txn));
+	E(mdb_cursor_open(txn, dbi, &cursor));
+	while ((rc = mdb_cursor_get(cursor, &key, &data, MDB_NEXT_MULTIPLE)) == 0) {
+		printf("key: %.*s, data: %.*s\n",
+			(int) key.mv_size,  (char *) key.mv_data,
+			(int) data.mv_size, (char *) data.mv_data);
+	}
+	CHECK(rc == MDB_NOTFOUND, "mdb_cursor_get");
+	mdb_cursor_close(cursor);
+	mdb_txn_abort(txn);
+	j=0;
+
+	for (i= count - 1; i > -1; i-= (rand()%3)) {
+		j++;
+		txn=NULL;
+		E(mdb_txn_begin(env, NULL, 0, &txn));
+		sprintf(sval, "%07x", values[i]);
+		key.mv_size = sizeof(int);
+		key.mv_data = kval;
+		data.mv_size = sizeof(sval);
+		data.mv_data = sval;
+		if (RES(MDB_NOTFOUND, mdb_del(txn, dbi, &key, &data))) {
+			j--;
+			mdb_txn_abort(txn);
+		} else {
+			E(mdb_txn_commit(txn));
+		}
+	}
+	free(values);
+	printf("Deleted %d values\n", j);
+
+	E(mdb_env_stat(env, &mst));
+	E(mdb_txn_begin(env, NULL, MDB_RDONLY, &txn));
+	E(mdb_cursor_open(txn, dbi, &cursor));
+	printf("Cursor next\n");
+	while ((rc = mdb_cursor_get(cursor, &key, &data, MDB_NEXT)) == 0) {
+		printf("key: %.*s, data: %.*s\n",
+			(int) key.mv_size,  (char *) key.mv_data,
+			(int) data.mv_size, (char *) data.mv_data);
+	}
+	CHECK(rc == MDB_NOTFOUND, "mdb_cursor_get");
+	printf("Cursor prev\n");
+	while ((rc = mdb_cursor_get(cursor, &key, &data, MDB_PREV)) == 0) {
+		printf("key: %.*s, data: %.*s\n",
+			(int) key.mv_size,  (char *) key.mv_data,
+			(int) data.mv_size, (char *) data.mv_data);
+	}
+	CHECK(rc == MDB_NOTFOUND, "mdb_cursor_get");
+	mdb_cursor_close(cursor);
+	mdb_txn_abort(txn);
+
+	mdb_dbi_close(env, dbi);
+	mdb_env_close(env);
+	return 0;
+}
@@ -0,0 +1,135 @@
+/* mtest5.c - memory-mapped database tester/toy */
+/*
+ * Copyright 2011-2021 Howard Chu, Symas Corp.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * <http://www.OpenLDAP.org/license.html>.
+ */
+
+/* Tests for sorted duplicate DBs using cursor_put */
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <time.h>
+#include "lmdb.h"
+
+#define E(expr) CHECK((rc = (expr)) == MDB_SUCCESS, #expr)
+#define RES(err, expr) ((rc = expr) == (err) || (CHECK(!rc, #expr), 0))
+#define CHECK(test, msg) ((test) ? (void)0 : ((void)fprintf(stderr, \
+	"%s:%d: %s: %s\n", __FILE__, __LINE__, msg, mdb_strerror(rc)), abort()))
+
+int main(int argc,char * argv[])
+{
+	int i = 0, j = 0, rc;
+	MDB_env *env;
+	MDB_dbi dbi;
+	MDB_val key, data;
+	MDB_txn *txn;
+	MDB_stat mst;
+	MDB_cursor *cursor;
+	int count;
+	int *values;
+	char sval[32];
+	char kval[sizeof(int)];
+
+	srand(time(NULL));
+
+	memset(sval, 0, sizeof(sval));
+
+	count = (rand()%384) + 64;
+	values = (int *)malloc(count*sizeof(int));
+
+	for(i = 0;i<count;i++) {
+		values[i] = rand()%1024;
+	}
+
+	E(mdb_env_create(&env));
+	E(mdb_env_set_mapsize(env, 10485760));
+	E(mdb_env_set_maxdbs(env, 4));
+	E(mdb_env_open(env, "./testdb", MDB_FIXEDMAP|MDB_NOSYNC, 0664));
+
+	E(mdb_txn_begin(env, NULL, 0, &txn));
+	E(mdb_dbi_open(txn, "id2", MDB_CREATE|MDB_DUPSORT, &dbi));
+	E(mdb_cursor_open(txn, dbi, &cursor));
+
+	key.mv_size = sizeof(int);
+	key.mv_data = kval;
+	data.mv_size = sizeof(sval);
+	data.mv_data = sval;
+
+	printf("Adding %d values\n", count);
+	for (i=0;i<count;i++) {
+		if (!(i & 0x0f))
+			sprintf(kval, "%03x", values[i]);
+		sprintf(sval, "%03x %d foo bar", values[i], values[i]);
+		if (RES(MDB_KEYEXIST, mdb_cursor_put(cursor, &key, &data, MDB_NODUPDATA)))
+			j++;
+	}
+	if (j) printf("%d duplicates skipped\n", j);
+	mdb_cursor_close(cursor);
+	E(mdb_txn_commit(txn));
+	E(mdb_env_stat(env, &mst));
+
+	E(mdb_txn_begin(env, NULL, MDB_RDONLY, &txn));
+	E(mdb_cursor_open(txn, dbi, &cursor));
+	while ((rc = mdb_cursor_get(cursor, &key, &data, MDB_NEXT)) == 0) {
+		printf("key: %p %.*s, data: %p %.*s\n",
+			key.mv_data,  (int) key.mv_size,  (char *) key.mv_data,
+			data.mv_data, (int) data.mv_size, (char *) data.mv_data);
+	}
+	CHECK(rc == MDB_NOTFOUND, "mdb_cursor_get");
+	mdb_cursor_close(cursor);
+	mdb_txn_abort(txn);
+
+	j=0;
+
+	for (i= count - 1; i > -1; i-= (rand()%5)) {
+		j++;
+		txn=NULL;
+		E(mdb_txn_begin(env, NULL, 0, &txn));
+		sprintf(kval, "%03x", values[i & ~0x0f]);
+		sprintf(sval, "%03x %d foo bar", values[i], values[i]);
+		key.mv_size = sizeof(int);
+		key.mv_data = kval;
+		data.mv_size = sizeof(sval);
+		data.mv_data = sval;
+		if (RES(MDB_NOTFOUND, mdb_del(txn, dbi, &key, &data))) {
+			j--;
+			mdb_txn_abort(txn);
+		} else {
+			E(mdb_txn_commit(txn));
+		}
+	}
+	free(values);
+	printf("Deleted %d values\n", j);
+
+	E(mdb_env_stat(env, &mst));
+	E(mdb_txn_begin(env, NULL, MDB_RDONLY, &txn));
+	E(mdb_cursor_open(txn, dbi, &cursor));
+	printf("Cursor next\n");
+	while ((rc = mdb_cursor_get(cursor, &key, &data, MDB_NEXT)) == 0) {
+		printf("key: %.*s, data: %.*s\n",
+			(int) key.mv_size,  (char *) key.mv_data,
+			(int) data.mv_size, (char *) data.mv_data);
+	}
+	CHECK(rc == MDB_NOTFOUND, "mdb_cursor_get");
+	printf("Cursor prev\n");
+	while ((rc = mdb_cursor_get(cursor, &key, &data, MDB_PREV)) == 0) {
+		printf("key: %.*s, data: %.*s\n",
+			(int) key.mv_size,  (char *) key.mv_data,
+			(int) data.mv_size, (char *) data.mv_data);
+	}
+	CHECK(rc == MDB_NOTFOUND, "mdb_cursor_get");
+	mdb_cursor_close(cursor);
+	mdb_txn_abort(txn);
+
+	mdb_dbi_close(env, dbi);
+	mdb_env_close(env);
+	return 0;
+}
@@ -0,0 +1,141 @@
+/* mtest6.c - memory-mapped database tester/toy */
+/*
+ * Copyright 2011-2021 Howard Chu, Symas Corp.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * <http://www.OpenLDAP.org/license.html>.
+ */
+
+/* Tests for DB splits and merges */
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <time.h>
+#include "lmdb.h"
+
+#define E(expr) CHECK((rc = (expr)) == MDB_SUCCESS, #expr)
+#define RES(err, expr) ((rc = expr) == (err) || (CHECK(!rc, #expr), 0))
+#define CHECK(test, msg) ((test) ? (void)0 : ((void)fprintf(stderr, \
+	"%s:%d: %s: %s\n", __FILE__, __LINE__, msg, mdb_strerror(rc)), abort()))
+
+char dkbuf[1024];
+
+int main(int argc,char * argv[])
+{
+	int i = 0, j = 0, rc;
+	MDB_env *env;
+	MDB_dbi dbi;
+	MDB_val key, data, sdata;
+	MDB_txn *txn;
+	MDB_stat mst;
+	MDB_cursor *cursor;
+	int count;
+	int *values;
+	long kval;
+	char *sval;
+
+	srand(time(NULL));
+
+	E(mdb_env_create(&env));
+	E(mdb_env_set_mapsize(env, 10485760));
+	E(mdb_env_set_maxdbs(env, 4));
+	E(mdb_env_open(env, "./testdb", MDB_FIXEDMAP|MDB_NOSYNC, 0664));
+
+	E(mdb_txn_begin(env, NULL, 0, &txn));
+	E(mdb_dbi_open(txn, "id6", MDB_CREATE|MDB_INTEGERKEY, &dbi));
+	E(mdb_cursor_open(txn, dbi, &cursor));
+	E(mdb_stat(txn, dbi, &mst));
+
+	sval = calloc(1, mst.ms_psize / 4);
+	key.mv_size = sizeof(long);
+	key.mv_data = &kval;
+	sdata.mv_size = mst.ms_psize / 4 - 30;
+	sdata.mv_data = sval;
+
+	printf("Adding 12 values, should yield 3 splits\n");
+	for (i=0;i<12;i++) {
+		kval = i*5;
+		sprintf(sval, "%08x", kval);
+		data = sdata;
+		(void)RES(MDB_KEYEXIST, mdb_cursor_put(cursor, &key, &data, MDB_NOOVERWRITE));
+	}
+	printf("Adding 12 more values, should yield 3 splits\n");
+	for (i=0;i<12;i++) {
+		kval = i*5+4;
+		sprintf(sval, "%08x", kval);
+		data = sdata;
+		(void)RES(MDB_KEYEXIST, mdb_cursor_put(cursor, &key, &data, MDB_NOOVERWRITE));
+	}
+	printf("Adding 12 more values, should yield 3 splits\n");
+	for (i=0;i<12;i++) {
+		kval = i*5+1;
+		sprintf(sval, "%08x", kval);
+		data = sdata;
+		(void)RES(MDB_KEYEXIST, mdb_cursor_put(cursor, &key, &data, MDB_NOOVERWRITE));
+	}
+	E(mdb_cursor_get(cursor, &key, &data, MDB_FIRST));
+
+	do {
+		printf("key: %p %s, data: %p %.*s\n",
+			key.mv_data,  mdb_dkey(&key, dkbuf),
+			data.mv_data, (int) data.mv_size, (char *) data.mv_data);
+	} while ((rc = mdb_cursor_get(cursor, &key, &data, MDB_NEXT)) == 0);
+	CHECK(rc == MDB_NOTFOUND, "mdb_cursor_get");
+	mdb_cursor_close(cursor);
+	mdb_txn_commit(txn);
+
+#if 0
+	j=0;
+
+	for (i= count - 1; i > -1; i-= (rand()%5)) {
+		j++;
+		txn=NULL;
+		E(mdb_txn_begin(env, NULL, 0, &txn));
+		sprintf(kval, "%03x", values[i & ~0x0f]);
+		sprintf(sval, "%03x %d foo bar", values[i], values[i]);
+		key.mv_size = sizeof(int);
+		key.mv_data = kval;
+		data.mv_size = sizeof(sval);
+		data.mv_data = sval;
+		if (RES(MDB_NOTFOUND, mdb_del(txn, dbi, &key, &data))) {
+			j--;
+			mdb_txn_abort(txn);
+		} else {
+			E(mdb_txn_commit(txn));
+		}
+	}
+	free(values);
+	printf("Deleted %d values\n", j);
+
+	E(mdb_env_stat(env, &mst));
+	E(mdb_txn_begin(env, NULL, MDB_RDONLY, &txn));
+	E(mdb_cursor_open(txn, dbi, &cursor));
+	printf("Cursor next\n");
+	while ((rc = mdb_cursor_get(cursor, &key, &data, MDB_NEXT)) == 0) {
+		printf("key: %.*s, data: %.*s\n",
+			(int) key.mv_size,  (char *) key.mv_data,
+			(int) data.mv_size, (char *) data.mv_data);
+	}
+	CHECK(rc == MDB_NOTFOUND, "mdb_cursor_get");
+	printf("Cursor prev\n");
+	while ((rc = mdb_cursor_get(cursor, &key, &data, MDB_PREV)) == 0) {
+		printf("key: %.*s, data: %.*s\n",
+			(int) key.mv_size,  (char *) key.mv_data,
+			(int) data.mv_size, (char *) data.mv_data);
+	}
+	CHECK(rc == MDB_NOTFOUND, "mdb_cursor_get");
+	mdb_cursor_close(cursor);
+	mdb_txn_abort(txn);
+
+	mdb_dbi_close(env, dbi);
+#endif
+	mdb_env_close(env);
+
+	return 0;
+}
@@ -0,0 +1,73 @@
+/* sample-bdb.txt - BerkeleyDB toy/sample
+ *
+ * Do a line-by-line comparison of this and sample-mdb.txt
+ */
+/*
+ * Copyright 2012-2021 Howard Chu, Symas Corp.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * <http://www.OpenLDAP.org/license.html>.
+ */
+#include <stdio.h>
+#include <string.h>
+#include <db.h>
+
+int main(int argc,char * argv[])
+{
+	int rc;
+	DB_ENV *env;
+	DB *dbi;
+	DBT key, data;
+	DB_TXN *txn;
+	DBC *cursor;
+	char sval[32], kval[32];
+
+	/* Note: Most error checking omitted for simplicity */
+
+#define FLAGS (DB_INIT_LOCK|DB_INIT_LOG|DB_INIT_TXN|DB_INIT_MPOOL|DB_CREATE|DB_THREAD)
+	rc = db_env_create(&env, 0);
+	rc = env->open(env, "./testdb", FLAGS, 0664);
+	rc = db_create(&dbi, env, 0);
+	rc = env->txn_begin(env, NULL, &txn, 0);
+	rc = dbi->open(dbi, txn, "test.bdb", NULL, DB_BTREE, DB_CREATE, 0664);
+
+	memset(&key, 0, sizeof(DBT));
+	memset(&data, 0, sizeof(DBT));
+	key.size = sizeof(int);
+	key.data = sval;
+	data.size = sizeof(sval);
+	data.data = sval;
+
+	sprintf(sval, "%03x %d foo bar", 32, 3141592);
+	rc = dbi->put(dbi, txn, &key, &data, 0);
+	rc = txn->commit(txn, 0);
+	if (rc) {
+		fprintf(stderr, "txn->commit: (%d) %s\n", rc, db_strerror(rc));
+		goto leave;
+	}
+	rc = env->txn_begin(env, NULL, &txn, 0);
+	rc = dbi->cursor(dbi, txn, &cursor, 0);
+	key.flags = DB_DBT_USERMEM;
+	key.data = kval;
+	key.ulen = sizeof(kval);
+	data.flags = DB_DBT_USERMEM;
+	data.data = sval;
+	data.ulen = sizeof(sval);
+	while ((rc = cursor->c_get(cursor, &key, &data, DB_NEXT)) == 0) {
+		printf("key: %p %.*s, data: %p %.*s\n",
+			key.data,  (int) key.size,  (char *) key.data,
+			data.data, (int) data.size, (char *) data.data);
+	}
+	rc = cursor->c_close(cursor);
+	rc = txn->abort(txn);
+leave:
+	rc = dbi->close(dbi, 0);
+	rc = env->close(env, 0);
+	return rc;
+}
@@ -0,0 +1,62 @@
+/* sample-mdb.txt - MDB toy/sample
+ *
+ * Do a line-by-line comparison of this and sample-bdb.txt
+ */
+/*
+ * Copyright 2012-2021 Howard Chu, Symas Corp.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted only as authorized by the OpenLDAP
+ * Public License.
+ *
+ * A copy of this license is available in the file LICENSE in the
+ * top-level directory of the distribution or, alternatively, at
+ * <http://www.OpenLDAP.org/license.html>.
+ */
+#include <stdio.h>
+#include "lmdb.h"
+
+int main(int argc,char * argv[])
+{
+	int rc;
+	MDB_env *env;
+	MDB_dbi dbi;
+	MDB_val key, data;
+	MDB_txn *txn;
+	MDB_cursor *cursor;
+	char sval[32];
+
+	/* Note: Most error checking omitted for simplicity */
+
+	rc = mdb_env_create(&env);
+	rc = mdb_env_open(env, "./testdb", 0, 0664);
+	rc = mdb_txn_begin(env, NULL, 0, &txn);
+	rc = mdb_dbi_open(txn, NULL, 0, &dbi);
+
+	key.mv_size = sizeof(int);
+	key.mv_data = sval;
+	data.mv_size = sizeof(sval);
+	data.mv_data = sval;
+
+	sprintf(sval, "%03x %d foo bar", 32, 3141592);
+	rc = mdb_put(txn, dbi, &key, &data, 0);
+	rc = mdb_txn_commit(txn);
+	if (rc) {
+		fprintf(stderr, "mdb_txn_commit: (%d) %s\n", rc, mdb_strerror(rc));
+		goto leave;
+	}
+	rc = mdb_txn_begin(env, NULL, MDB_RDONLY, &txn);
+	rc = mdb_cursor_open(txn, dbi, &cursor);
+	while ((rc = mdb_cursor_get(cursor, &key, &data, MDB_NEXT)) == 0) {
+		printf("key: %p %.*s, data: %p %.*s\n",
+			key.mv_data,  (int) key.mv_size,  (char *) key.mv_data,
+			data.mv_data, (int) data.mv_size, (char *) data.mv_data);
+	}
+	mdb_cursor_close(cursor);
+	mdb_txn_abort(txn);
+leave:
+	mdb_dbi_close(env, dbi);
+	mdb_env_close(env);
+	return 0;
+}
@@ -0,0 +1,22 @@
+<tagfile>
+  <compound kind="page">
+    <name>mdb_copy_1</name>
+	<title>mdb_copy - environment copy tool</title>
+	<filename>mdb_copy.1</filename>
+  </compound>
+  <compound kind="page">
+    <name>mdb_dump_1</name>
+	<title>mdb_dump - environment export tool</title>
+	<filename>mdb_dump.1</filename>
+  </compound>
+  <compound kind="page">
+    <name>mdb_load_1</name>
+	<title>mdb_load - environment import tool</title>
+	<filename>mdb_load.1</filename>
+  </compound>
+  <compound kind="page">
+    <name>mdb_stat_1</name>
+	<title>mdb_stat - environment status tool</title>
+	<filename>mdb_stat.1</filename>
+  </compound>
+</tagfile>
@@ -0,0 +1,156 @@
+noinst_LIBRARIES = libopus_internal.a
+
+# Override global CFLAGS to disable ASAN (makes .a incompatible with PIE linking)
+CFLAGS = -g -Og -fno-omit-frame-pointer -fno-pie -fPIC
+
+libopus_internal_a_SOURCES = \
+	celt/bands.c \
+	celt/celt.c \
+	celt/celt_encoder.c \
+	celt/celt_decoder.c \
+	celt/celt_lpc.c \
+	celt/cwrs.c \
+	celt/entcode.c \
+	celt/entdec.c \
+	celt/entenc.c \
+	celt/kiss_fft.c \
+	celt/laplace.c \
+	celt/mathops.c \
+	celt/mdct.c \
+	celt/modes.c \
+	celt/pitch.c \
+	celt/quant_bands.c \
+	celt/rate.c \
+	celt/vq.c \
+	silk/CNG.c \
+	silk/code_signs.c \
+	silk/init_decoder.c \
+	silk/decode_core.c \
+	silk/decode_frame.c \
+	silk/decode_parameters.c \
+	silk/decode_indices.c \
+	silk/decode_pulses.c \
+	silk/decoder_set_fs.c \
+	silk/dec_API.c \
+	silk/enc_API.c \
+	silk/encode_indices.c \
+	silk/encode_pulses.c \
+	silk/gain_quant.c \
+	silk/interpolate.c \
+	silk/LP_variable_cutoff.c \
+	silk/NLSF_decode.c \
+	silk/NSQ.c \
+	silk/NSQ_del_dec.c \
+	silk/PLC.c \
+	silk/shell_coder.c \
+	silk/tables_gain.c \
+	silk/tables_LTP.c \
+	silk/tables_NLSF_CB_NB_MB.c \
+	silk/tables_NLSF_CB_WB.c \
+	silk/tables_other.c \
+	silk/tables_pitch_lag.c \
+	silk/tables_pulses_per_block.c \
+	silk/VAD.c \
+	silk/control_audio_bandwidth.c \
+	silk/quant_LTP_gains.c \
+	silk/VQ_WMat_EC.c \
+	silk/HP_variable_cutoff.c \
+	silk/NLSF_encode.c \
+	silk/NLSF_VQ.c \
+	silk/NLSF_unpack.c \
+	silk/NLSF_del_dec_quant.c \
+	silk/process_NLSFs.c \
+	silk/stereo_LR_to_MS.c \
+	silk/stereo_MS_to_LR.c \
+	silk/check_control_input.c \
+	silk/control_SNR.c \
+	silk/init_encoder.c \
+	silk/control_codec.c \
+	silk/A2NLSF.c \
+	silk/ana_filt_bank_1.c \
+	silk/biquad_alt.c \
+	silk/bwexpander_32.c \
+	silk/bwexpander.c \
+	silk/debug.c \
+	silk/decode_pitch.c \
+	silk/inner_prod_aligned.c \
+	silk/lin2log.c \
+	silk/log2lin.c \
+	silk/LPC_analysis_filter.c \
+	silk/LPC_inv_pred_gain.c \
+	silk/table_LSF_cos.c \
+	silk/NLSF2A.c \
+	silk/NLSF_stabilize.c \
+	silk/NLSF_VQ_weights_laroia.c \
+	silk/pitch_est_tables.c \
+	silk/resampler.c \
+	silk/resampler_down2_3.c \
+	silk/resampler_down2.c \
+	silk/resampler_private_AR2.c \
+	silk/resampler_private_down_FIR.c \
+	silk/resampler_private_IIR_FIR.c \
+	silk/resampler_private_up2_HQ.c \
+	silk/resampler_rom.c \
+	silk/sigm_Q15.c \
+	silk/sort.c \
+	silk/sum_sqr_shift.c \
+	silk/stereo_decode_pred.c \
+	silk/stereo_encode_pred.c \
+	silk/stereo_find_predictor.c \
+	silk/stereo_quant_pred.c \
+	silk/LPC_fit.c \
+	silk/float/apply_sine_window_FLP.c \
+	silk/float/corrMatrix_FLP.c \
+	silk/float/encode_frame_FLP.c \
+	silk/float/find_LPC_FLP.c \
+	silk/float/find_LTP_FLP.c \
+	silk/float/find_pitch_lags_FLP.c \
+	silk/float/find_pred_coefs_FLP.c \
+	silk/float/LPC_analysis_filter_FLP.c \
+	silk/float/LTP_analysis_filter_FLP.c \
+	silk/float/LTP_scale_ctrl_FLP.c \
+	silk/float/noise_shape_analysis_FLP.c \
+	silk/float/process_gains_FLP.c \
+	silk/float/regularize_correlations_FLP.c \
+	silk/float/residual_energy_FLP.c \
+	silk/float/warped_autocorrelation_FLP.c \
+	silk/float/wrappers_FLP.c \
+	silk/float/autocorrelation_FLP.c \
+	silk/float/burg_modified_FLP.c \
+	silk/float/bwexpander_FLP.c \
+	silk/float/energy_FLP.c \
+	silk/float/inner_product_FLP.c \
+	silk/float/k2a_FLP.c \
+	silk/float/LPC_inv_pred_gain_FLP.c \
+	silk/float/pitch_analysis_core_FLP.c \
+	silk/float/scale_copy_vector_FLP.c \
+	silk/float/scale_vector_FLP.c \
+	silk/float/schur_FLP.c \
+	silk/float/sort_FLP.c \
+	src/opus.c \
+	src/opus_decoder.c \
+	src/opus_encoder.c \
+	src/extensions.c \
+	src/opus_multistream.c \
+	src/opus_multistream_encoder.c \
+	src/opus_multistream_decoder.c \
+	src/repacketizer.c \
+	src/opus_projection_encoder.c \
+	src/opus_projection_decoder.c \
+	src/mapping_matrix.c \
+	src/analysis.c \
+	src/mlp.c \
+	src/mlp_data.c
+
+libopus_internal_a_CFLAGS = \
+	-DOPUS_BUILD \
+	-DVAR_ARRAYS \
+	-DUSE_ALLOCA \
+	-g \
+	-I$(srcdir)/include \
+	-I$(srcdir)/celt \
+	-I$(srcdir)/silk \
+	-I$(srcdir)/silk/float \
+	-I$(srcdir)/silk/fixed \
+	-I$(srcdir)/src \
+	-I$(srcdir)
@@ -0,0 +1,188 @@
+/*Copyright (c) 2003-2004, Mark Borgerding
+
+  All rights reserved.
+
+  Redistribution and use in source and binary forms, with or without
+   modification, are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright notice,
+       this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright notice,
+       this list of conditions and the following disclaimer in the
+       documentation and/or other materials provided with the distribution.
+
+  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+  POSSIBILITY OF SUCH DAMAGE.*/
+
+#ifndef KISS_FFT_GUTS_H
+#define KISS_FFT_GUTS_H
+
+#define MIN(a,b) ((a)<(b) ? (a):(b))
+#define MAX(a,b) ((a)>(b) ? (a):(b))
+
+/* kiss_fft.h
+   defines kiss_fft_scalar as either short or a float type
+   and defines
+   typedef struct { kiss_fft_scalar r; kiss_fft_scalar i; }kiss_fft_cpx; */
+#include "kiss_fft.h"
+
+/*
+  Explanation of macros dealing with complex math:
+
+   C_MUL(m,a,b)         : m = a*b
+   C_FIXDIV( c , div )  : if a fixed point impl., c /= div. noop otherwise
+   C_SUB( res, a,b)     : res = a - b
+   C_SUBFROM( res , a)  : res -= a
+   C_ADDTO( res , a)    : res += a
+ * */
+#ifdef FIXED_POINT
+#include "arch.h"
+
+
+#define SAMP_MAX 2147483647
+#define TWID_MAX 32767
+#define TRIG_UPSCALE 1
+
+#define SAMP_MIN -SAMP_MAX
+
+#ifdef ENABLE_QEXT
+#   define S_MUL(a,b) MULT32_32_P31_ovflw(b, a)
+#   define S_MUL2(a,b) MULT32_32_P31_ovflw(b, a)
+#else
+#   define S_MUL(a,b) MULT16_32_Q15(b, a)
+#   define S_MUL2(a,b) MULT16_32_Q16(b, a)
+#endif
+
+#   define C_MUL(m,a,b) \
+      do{ (m).r = SUB32_ovflw(S_MUL((a).r,(b).r) , S_MUL((a).i,(b).i)); \
+          (m).i = ADD32_ovflw(S_MUL((a).r,(b).i) , S_MUL((a).i,(b).r)); }while(0)
+
+#   define C_MULC(m,a,b) \
+      do{ (m).r = ADD32_ovflw(S_MUL((a).r,(b).r) , S_MUL((a).i,(b).i)); \
+          (m).i = SUB32_ovflw(S_MUL((a).i,(b).r) , S_MUL((a).r,(b).i)); }while(0)
+
+#   define C_MULBYSCALAR( c, s ) \
+      do{ (c).r =  S_MUL( (c).r , s ) ;\
+          (c).i =  S_MUL( (c).i , s ) ; }while(0)
+
+#   define DIVSCALAR(x,k) \
+        (x) = S_MUL(  x, (TWID_MAX-((k)>>1))/(k)+1 )
+
+#   define C_FIXDIV(c,div) \
+        do {    DIVSCALAR( (c).r , div);  \
+                DIVSCALAR( (c).i  , div); }while (0)
+
+#define  C_ADD( res, a,b)\
+    do {(res).r=ADD32_ovflw((a).r,(b).r);  (res).i=ADD32_ovflw((a).i,(b).i); \
+    }while(0)
+#define  C_SUB( res, a,b)\
+    do {(res).r=SUB32_ovflw((a).r,(b).r);  (res).i=SUB32_ovflw((a).i,(b).i); \
+    }while(0)
+#define C_ADDTO( res , a)\
+    do {(res).r = ADD32_ovflw((res).r, (a).r);  (res).i = ADD32_ovflw((res).i,(a).i);\
+    }while(0)
+
+#define C_SUBFROM( res , a)\
+    do {(res).r = ADD32_ovflw((res).r,(a).r);  (res).i = SUB32_ovflw((res).i,(a).i); \
+    }while(0)
+
+#if defined(OPUS_ARM_INLINE_ASM)
+#include "arm/kiss_fft_armv4.h"
+#endif
+
+#if defined(OPUS_ARM_INLINE_EDSP)
+#include "arm/kiss_fft_armv5e.h"
+#endif
+#if defined(__mips)
+#include "mips/kiss_fft_mipsr1.h"
+#endif
+
+#else  /* not FIXED_POINT*/
+
+#   define S_MUL(a,b) ( (a)*(b) )
+#   define S_MUL2(a,b) ( (a)*(b) )
+#define C_MUL(m,a,b) \
+    do{ (m).r = (a).r*(b).r - (a).i*(b).i;\
+        (m).i = (a).r*(b).i + (a).i*(b).r; }while(0)
+#define C_MULC(m,a,b) \
+    do{ (m).r = (a).r*(b).r + (a).i*(b).i;\
+        (m).i = (a).i*(b).r - (a).r*(b).i; }while(0)
+
+#define C_MUL4(m,a,b) C_MUL(m,a,b)
+
+#   define C_FIXDIV(c,div) /* NOOP */
+#   define C_MULBYSCALAR( c, s ) \
+    do{ (c).r *= (s);\
+        (c).i *= (s); }while(0)
+#endif
+
+#ifndef CHECK_OVERFLOW_OP
+#  define CHECK_OVERFLOW_OP(a,op,b) /* noop */
+#endif
+
+#ifndef C_ADD
+#define  C_ADD( res, a,b)\
+    do { \
+            CHECK_OVERFLOW_OP((a).r,+,(b).r)\
+            CHECK_OVERFLOW_OP((a).i,+,(b).i)\
+            (res).r=(a).r+(b).r;  (res).i=(a).i+(b).i; \
+    }while(0)
+#define  C_SUB( res, a,b)\
+    do { \
+            CHECK_OVERFLOW_OP((a).r,-,(b).r)\
+            CHECK_OVERFLOW_OP((a).i,-,(b).i)\
+            (res).r=(a).r-(b).r;  (res).i=(a).i-(b).i; \
+    }while(0)
+#define C_ADDTO( res , a)\
+    do { \
+            CHECK_OVERFLOW_OP((res).r,+,(a).r)\
+            CHECK_OVERFLOW_OP((res).i,+,(a).i)\
+            (res).r += (a).r;  (res).i += (a).i;\
+    }while(0)
+
+#define C_SUBFROM( res , a)\
+    do {\
+            CHECK_OVERFLOW_OP((res).r,-,(a).r)\
+            CHECK_OVERFLOW_OP((res).i,-,(a).i)\
+            (res).r -= (a).r;  (res).i -= (a).i; \
+    }while(0)
+#endif /* C_ADD defined */
+
+#ifdef FIXED_POINT
+/*#  define KISS_FFT_COS(phase)  TRIG_UPSCALE*floor(MIN(32767,MAX(-32767,.5+32768 * cos (phase))))
+#  define KISS_FFT_SIN(phase)  TRIG_UPSCALE*floor(MIN(32767,MAX(-32767,.5+32768 * sin (phase))))*/
+#  define KISS_FFT_COS(phase)  floor(.5+TWID_MAX*cos (phase))
+#  define KISS_FFT_SIN(phase)  floor(.5+TWID_MAX*sin (phase))
+#  define HALF_OF(x) ((x)>>1)
+#elif defined(USE_SIMD)
+#  define KISS_FFT_COS(phase) _mm_set1_ps( cos(phase) )
+#  define KISS_FFT_SIN(phase) _mm_set1_ps( sin(phase) )
+#  define HALF_OF(x) ((x)*_mm_set1_ps(.5f))
+#else
+#  define KISS_FFT_COS(phase) (kiss_fft_scalar) cos(phase)
+#  define KISS_FFT_SIN(phase) (kiss_fft_scalar) sin(phase)
+#  define HALF_OF(x) ((x)*.5f)
+#endif
+
+#define  kf_cexp(x,phase) \
+        do{ \
+                (x)->r = KISS_FFT_COS(phase);\
+                (x)->i = KISS_FFT_SIN(phase);\
+        }while(0)
+
+#define  kf_cexp2(x,phase) \
+   do{ \
+      (x)->r = TRIG_UPSCALE*celt_cos_norm((phase));\
+      (x)->i = TRIG_UPSCALE*celt_cos_norm((phase)-32768);\
+}while(0)
+
+#endif /* KISS_FFT_GUTS_H */
@@ -0,0 +1,400 @@
+/* Copyright (c) 2003-2008 Jean-Marc Valin
+   Copyright (c) 2007-2008 CSIRO
+   Copyright (c) 2007-2009 Xiph.Org Foundation
+   Written by Jean-Marc Valin */
+/**
+   @file arch.h
+   @brief Various architecture definitions for CELT
+*/
+/*
+   Redistribution and use in source and binary forms, with or without
+   modification, are permitted provided that the following conditions
+   are met:
+
+   - Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+
+   - Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+
+   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+   ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+   A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
+   OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+   EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+   PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+   PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+   LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+   NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+   SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+*/
+
+#ifndef ARCH_H
+#define ARCH_H
+
+#include "opus_types.h"
+#include "opus_defines.h"
+
+# if !defined(__GNUC_PREREQ)
+#  if defined(__GNUC__)&&defined(__GNUC_MINOR__)
+#   define __GNUC_PREREQ(_maj,_min) \
+ ((__GNUC__<<16)+__GNUC_MINOR__>=((_maj)<<16)+(_min))
+#  else
+#   define __GNUC_PREREQ(_maj,_min) 0
+#  endif
+# endif
+
+#if OPUS_GNUC_PREREQ(3, 0)
+#define opus_likely(x)       (__builtin_expect(!!(x), 1))
+#define opus_unlikely(x)     (__builtin_expect(!!(x), 0))
+#else
+#define opus_likely(x)       (!!(x))
+#define opus_unlikely(x)     (!!(x))
+#endif
+
+#define CELT_SIG_SCALE 32768.f
+
+#define CELT_FATAL(str) celt_fatal(str, __FILE__, __LINE__)
+
+#if defined(ENABLE_ASSERTIONS) || defined(ENABLE_HARDENING)
+#ifdef __GNUC__
+__attribute__((noreturn))
+#endif
+void celt_fatal(const char *str, const char *file, int line);
+
+#if defined(CELT_C) && !defined(OVERRIDE_celt_fatal)
+#include <stdio.h>
+#include <stdlib.h>
+#ifdef __GNUC__
+__attribute__((noreturn))
+#endif
+void celt_fatal(const char *str, const char *file, int line)
+{
+   fprintf (stderr, "Fatal (internal) error in %s, line %d: %s\n", file, line, str);
+#if defined(_MSC_VER)
+   _set_abort_behavior( 0, _WRITE_ABORT_MSG);
+#endif
+   abort();
+}
+#endif
+
+#define celt_assert(cond) {if (!(cond)) {CELT_FATAL("assertion failed: " #cond);}}
+#define celt_assert2(cond, message) {if (!(cond)) {CELT_FATAL("assertion failed: " #cond "\n" message);}}
+#define MUST_SUCCEED(call) celt_assert((call) == OPUS_OK)
+#else
+#define celt_assert(cond) ((void)(cond))
+#define celt_assert2(cond, message) ((void)(cond))
+#define MUST_SUCCEED(call) do {if((call) != OPUS_OK) {RESTORE_STACK; return OPUS_INTERNAL_ERROR;} } while (0)
+#endif
+
+#if defined(ENABLE_ASSERTIONS)
+#define celt_sig_assert(cond) {if (!(cond)) {CELT_FATAL("signal assertion failed: " #cond);}}
+#else
+#define celt_sig_assert(cond) ((void)(cond))
+#endif
+
+#define IMUL32(a,b) ((a)*(b))
+
+#define MIN16(a,b) ((a) < (b) ? (a) : (b))   /**< Minimum 16-bit value.   */
+#define MAX16(a,b) ((a) > (b) ? (a) : (b))   /**< Maximum 16-bit value.   */
+#define MIN32(a,b) ((a) < (b) ? (a) : (b))   /**< Minimum 32-bit value.   */
+#define MAX32(a,b) ((a) > (b) ? (a) : (b))   /**< Maximum 32-bit value.   */
+#define IMIN(a,b) ((a) < (b) ? (a) : (b))   /**< Minimum int value.   */
+#define IMAX(a,b) ((a) > (b) ? (a) : (b))   /**< Maximum int value.   */
+#define FMIN(a,b) ((a) < (b) ? (a) : (b))   /**< Minimum float value.   */
+#define FMAX(a,b) ((a) > (b) ? (a) : (b))   /**< Maximum float value.   */
+#define UADD32(a,b) ((a)+(b))
+#define USUB32(a,b) ((a)-(b))
+#define MAXG(a,b) MAX32(a, b)
+#define MING(a,b) MIN32(a, b)
+
+/* Throughout the code, we use the following scaling for signals:
+   FLOAT: used for float API, normalized to +/-1.
+   INT16: used for 16-bit API, normalized to +/- 32768
+   RES: internal Opus resolution, defined as +/-1. in float builds, or either 16-bit or 24-bit int for fixed-point builds
+   SIG: internal CELT resolution: defined as +/- 32768. in float builds, or Q27 in fixed-point builds (int16 shifted by 12)
+*/
+
+
+/* Set this if opus_int64 is a native type of the CPU. */
+/* Assume that all LP64 architectures have fast 64-bit types; also x86_64
+   (which can be ILP32 for x32) and Win64 (which is LLP64). */
+#if defined(__x86_64__) || defined(__LP64__) || defined(_WIN64) || defined (__mips)
+#define OPUS_FAST_INT64 1
+#else
+#define OPUS_FAST_INT64 0
+#endif
+
+#ifdef FIXED_POINT
+#define ARG_FIXED(arg) , arg
+#else
+#define ARG_FIXED(arg)
+#endif
+
+#define PRINT_MIPS(file)
+
+#ifdef FIXED_POINT
+
+typedef opus_int16 opus_val16;
+typedef opus_int32 opus_val32;
+typedef opus_int64 opus_val64;
+
+typedef opus_val32 celt_sig;
+typedef opus_val32 celt_norm;
+typedef opus_val32 celt_ener;
+typedef opus_val32 celt_glog;
+
+#ifdef ENABLE_RES24
+typedef opus_val32 opus_res;
+#define RES_SHIFT 8
+#define SIG2RES(a)      PSHR32(a, SIG_SHIFT-RES_SHIFT)
+#define RES2INT16(a)    SAT16(PSHR32(a, RES_SHIFT))
+#define RES2INT24(a)    (a)
+#define RES2FLOAT(a)    ((1.f/32768.f/256.f)*(a))
+#define INT16TORES(a)   SHL32(EXTEND32(a), RES_SHIFT)
+#define INT24TORES(a)   (a)
+#define ADD_RES(a, b)   ADD32(a, b)
+#define FLOAT2RES(a)    FLOAT2INT24(a)
+#define RES2SIG(a)      SHL32((a), SIG_SHIFT-RES_SHIFT)
+#define MULT16_RES_Q15(a,b) MULT16_32_Q15(a,b)
+#define MAX_ENCODING_DEPTH 24
+#else
+typedef opus_val16 opus_res;
+#define RES_SHIFT 0
+#define SIG2RES(a)      SIG2WORD16(a)
+#define RES2INT16(a)    (a)
+#define RES2INT24(a)    SHL32(EXTEND32(a), 8)
+#define RES2FLOAT(a)    ((1.f/32768.f)*(a))
+#define INT16TORES(a)   (a)
+#define INT24TORES(a)   SAT16(PSHR32(a, 8))
+#define ADD_RES(a, b)   SAT16(ADD32((a), (b)));
+#define FLOAT2RES(a)    FLOAT2INT16(a)
+#define RES2SIG(a)      SHL32(EXTEND32(a), SIG_SHIFT)
+#define MULT16_RES_Q15(a,b) MULT16_16_Q15(a,b)
+#define MAX_ENCODING_DEPTH 16
+#endif
+
+#define RES2VAL16(a)    RES2INT16(a)
+#define INT16TOSIG(a)   SHL32(EXTEND32(a), SIG_SHIFT)
+#define INT24TOSIG(a)   SHL32(a, SIG_SHIFT-8)
+
+#define NORM_SHIFT 24
+#ifdef ENABLE_QEXT
+typedef opus_val32 celt_coef;
+#define COEF_ONE Q31ONE
+#define MULT_COEF_32(a, b) MULT32_32_P31(a,b)
+#define MAC_COEF_32_ARM(c, a, b) ADD32((c), MULT32_32_Q32(a,b))
+#define MULT_COEF(a, b) MULT32_32_Q31(a,b)
+#define MULT_COEF_TAPS(a, b) SHL32(MULT16_16(a,b), 1)
+#define COEF2VAL16(x) EXTRACT16(SHR32(x, 16))
+#else
+typedef opus_val16 celt_coef;
+#define COEF_ONE Q15ONE
+#define MULT_COEF_32(a, b) MULT16_32_Q15(a,b)
+#define MAC_COEF_32_ARM(a, b, c) MAC16_32_Q16(a,b,c)
+#define MULT_COEF(a, b) MULT16_16_Q15(a,b)
+#define MULT_COEF_TAPS(a, b) MULT16_16_P15(a,b)
+#define COEF2VAL16(x) (x)
+#endif
+
+#define celt_isnan(x) 0
+
+#define Q15ONE 32767
+#define Q31ONE 2147483647
+
+#define SIG_SHIFT 12
+/* Safe saturation value for 32-bit signals. We need to make sure that we can
+   add two sig values and that the first stages of the MDCT don't cause an overflow.
+   The most constraining is the ARM_ASM comb filter where we shift left by one
+   and then add two values. Because of that, we use 2^29-1. SIG_SAT must be large
+   enough to fit a full-scale high-freq tone through the prefilter and comb filter,
+   meaning 1.85*1.75*2^(15+SIG_SHIFT) =  434529895.
+   so the limit should be about 2^31*sqrt(.5). */
+#define SIG_SAT (536870911)
+
+#define NORM_SCALING (1<<NORM_SHIFT)
+
+#define DB_SHIFT 24
+
+#define EPSILON 1
+#define VERY_SMALL 0
+#define VERY_LARGE16 ((opus_val16)32767)
+#define Q15_ONE ((opus_val16)32767)
+
+
+#define ABS16(x) ((x) < 0 ? (-(x)) : (x))
+#define ABS32(x) ((x) < 0 ? (-(x)) : (x))
+
+static OPUS_INLINE opus_int16 SAT16(opus_int32 x) {
+   return x > 32767 ? 32767 : x < -32768 ? -32768 : (opus_int16)x;
+}
+
+#ifdef FIXED_DEBUG
+#include "fixed_debug.h"
+#else
+
+#include "fixed_generic.h"
+
+#ifdef OPUS_ARM_PRESUME_AARCH64_NEON_INTR
+#include "arm/fixed_arm64.h"
+#elif defined (OPUS_ARM_INLINE_EDSP)
+#include "arm/fixed_armv5e.h"
+#elif defined (OPUS_ARM_INLINE_ASM)
+#include "arm/fixed_armv4.h"
+#elif defined (BFIN_ASM)
+#include "fixed_bfin.h"
+#elif defined (TI_C5X_ASM)
+#include "fixed_c5x.h"
+#elif defined (TI_C6X_ASM)
+#include "fixed_c6x.h"
+#endif
+
+#endif
+
+#else /* FIXED_POINT */
+
+typedef float opus_val16;
+typedef float opus_val32;
+typedef float opus_val64;
+
+typedef float celt_sig;
+typedef float celt_norm;
+typedef float celt_ener;
+typedef float celt_glog;
+
+typedef float opus_res;
+typedef float celt_coef;
+
+#ifdef FLOAT_APPROX
+/* This code should reliably detect NaN/inf even when -ffast-math is used.
+   Assumes IEEE 754 format. */
+static OPUS_INLINE int celt_isnan(float x)
+{
+   union {float f; opus_uint32 i;} in;
+   in.f = x;
+   return ((in.i>>23)&0xFF)==0xFF && (in.i&0x007FFFFF)!=0;
+}
+#else
+#ifdef __FAST_MATH__
+#error Cannot build libopus with -ffast-math unless FLOAT_APPROX is defined. This could result in crashes on extreme (e.g. NaN) input
+#endif
+#define celt_isnan(x) ((x)!=(x))
+#endif
+
+#define Q15ONE 1.0f
+#define Q31ONE 1.0f
+#define COEF_ONE 1.0f
+#define COEF2VAL16(x) (x)
+
+#define NORM_SCALING 1.f
+
+#define EPSILON 1e-15f
+#define VERY_SMALL 1e-30f
+#define VERY_LARGE16 1e15f
+#define Q15_ONE ((opus_val16)1.f)
+
+/* This appears to be the same speed as C99's fabsf() but it's more portable. */
+#define ABS16(x) ((float)fabs(x))
+#define ABS32(x) ((float)fabs(x))
+
+#define QCONST16(x,bits) (x)
+#define QCONST32(x,bits) (x)
+#define GCONST(x) (x)
+
+#define NEG16(x) (-(x))
+#define NEG32(x) (-(x))
+#define NEG32_ovflw(x) (-(x))
+#define EXTRACT16(x) (x)
+#define EXTEND32(x) (x)
+#define SHR16(a,shift) (a)
+#define SHL16(a,shift) (a)
+#define SHR32(a,shift) (a)
+#define SHL32(a,shift) (a)
+#define PSHR32(a,shift) (a)
+#define VSHR32(a,shift) (a)
+
+#define SHR64(a,shift) (a)
+
+#define PSHR(a,shift)   (a)
+#define SHR(a,shift)    (a)
+#define SHL(a,shift)    (a)
+#define SATURATE(x,a)   (x)
+#define SATURATE16(x)   (x)
+
+#define ROUND16(a,shift)  (a)
+#define SROUND16(a,shift) (a)
+#define HALF16(x)       (.5f*(x))
+#define HALF32(x)       (.5f*(x))
+
+#define ADD16(a,b) ((a)+(b))
+#define SUB16(a,b) ((a)-(b))
+#define ADD32(a,b) ((a)+(b))
+#define SUB32(a,b) ((a)-(b))
+#define ADD32_ovflw(a,b) ((a)+(b))
+#define SUB32_ovflw(a,b) ((a)-(b))
+#define SHL32_ovflw(a,shift) (a)
+#define PSHR32_ovflw(a,shift) (a)
+
+#define MULT16_16_16(a,b)     ((a)*(b))
+#define MULT16_16(a,b)     ((opus_val32)(a)*(opus_val32)(b))
+#define MAC16_16(c,a,b)     ((c)+(opus_val32)(a)*(opus_val32)(b))
+
+#define MULT16_32_Q15(a,b)     ((a)*(b))
+#define MULT16_32_Q16(a,b)     ((a)*(b))
+
+#define MULT32_32_Q16(a,b)     ((a)*(b))
+#define MULT32_32_Q31(a,b)     ((a)*(b))
+#define MULT32_32_P31(a,b)     ((a)*(b))
+#define MULT32_32_P31_ovflw(a,b) ((a)*(b))
+
+#define MAC16_32_Q15(c,a,b)     ((c)+(a)*(b))
+#define MAC16_32_Q16(c,a,b)     ((c)+(a)*(b))
+#define MAC_COEF_32_ARM(c,a,b)     ((c)+(a)*(b))
+
+#define MULT16_16_Q11_32(a,b)     ((a)*(b))
+#define MULT16_16_Q11(a,b)     ((a)*(b))
+#define MULT16_16_Q13(a,b)     ((a)*(b))
+#define MULT16_16_Q14(a,b)     ((a)*(b))
+#define MULT16_16_Q15(a,b)     ((a)*(b))
+#define MULT16_16_P15(a,b)     ((a)*(b))
+#define MULT16_16_P13(a,b)     ((a)*(b))
+#define MULT16_16_P14(a,b)     ((a)*(b))
+#define MULT16_32_P16(a,b)     ((a)*(b))
+
+#define MULT_COEF_32(a, b)      ((a)*(b))
+#define MULT_COEF(a, b)   ((a)*(b))
+#define MULT_COEF_TAPS(a, b)   ((a)*(b))
+
+#define DIV32_16(a,b)     (((opus_val32)(a))/(opus_val16)(b))
+#define DIV32(a,b)     (((opus_val32)(a))/(opus_val32)(b))
+
+#define SIG2RES(a)      ((1/CELT_SIG_SCALE)*(a))
+#define RES2INT16(a)    FLOAT2INT16(a)
+#define RES2INT24(a)    float2int(32768.f*256.f*(a))
+#define RES2FLOAT(a)    (a)
+#define INT16TORES(a)   ((a)*(1/CELT_SIG_SCALE))
+#define INT24TORES(a)   ((1.f/32768.f/256.f)*(a))
+#define ADD_RES(a, b)   ADD32(a, b)
+#define FLOAT2RES(a)    (a)
+#define RES2SIG(a)      (CELT_SIG_SCALE*(a))
+#define MULT16_RES_Q15(a,b) MULT16_16_Q15(a,b)
+
+#define RES2VAL16(a)    (a)
+#define FLOAT2SIG(a)    ((a)*CELT_SIG_SCALE)
+#define INT16TOSIG(a)   ((float)(a))
+#define INT24TOSIG(a)   ((float)(a)*(1.f/256.f))
+#define MAX_ENCODING_DEPTH 24
+
+#endif /* !FIXED_POINT */
+
+#ifndef GLOBAL_STACK_SIZE
+#ifdef FIXED_POINT
+#define GLOBAL_STACK_SIZE 120000
+#else
+#define GLOBAL_STACK_SIZE 120000
+#endif
+#endif
+
+#endif /* ARCH_H */
@@ -0,0 +1,125 @@
+/* Copyright (c) 2007-2008 CSIRO
+   Copyright (c) 2007-2009 Xiph.Org Foundation
+   Copyright (c) 2008-2009 Gregory Maxwell
+   Written by Jean-Marc Valin and Gregory Maxwell */
+/*
+   Redistribution and use in source and binary forms, with or without
+   modification, are permitted provided that the following conditions
+   are met:
+
+   - Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+
+   - Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+
+   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+   ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+   A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
+   OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+   EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+   PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+   PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+   LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+   NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+   SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+*/
+
+#ifndef BANDS_H
+#define BANDS_H
+
+#include "arch.h"
+#include "modes.h"
+#include "entenc.h"
+#include "entdec.h"
+#include "rate.h"
+
+opus_int16 bitexact_cos(opus_int16 x);
+int bitexact_log2tan(int isin,int icos);
+
+/** Compute the amplitude (sqrt energy) in each of the bands
+ * @param m Mode data
+ * @param X Spectrum
+ * @param bandE Square root of the energy for each band (returned)
+ */
+void compute_band_energies(const CELTMode *m, const celt_sig *X, celt_ener *bandE, int end, int C, int LM, int arch);
+
+/*void compute_noise_energies(const CELTMode *m, const celt_sig *X, const opus_val16 *tonality, celt_ener *bandE);*/
+
+/** Normalise each band of X such that the energy in each band is
+    equal to 1
+ * @param m Mode data
+ * @param X Spectrum (returned normalised)
+ * @param bandE Square root of the energy for each band
+ */
+void normalise_bands(const CELTMode *m, const celt_sig * OPUS_RESTRICT freq, celt_norm * OPUS_RESTRICT X, const celt_ener *bandE, int end, int C, int M);
+
+/** Denormalise each band of X to restore full amplitude
+ * @param m Mode data
+ * @param X Spectrum (returned de-normalised)
+ * @param bandE Square root of the energy for each band
+ */
+void denormalise_bands(const CELTMode *m, const celt_norm * OPUS_RESTRICT X,
+      celt_sig * OPUS_RESTRICT freq, const celt_glog *bandE, int start,
+      int end, int M, int downsample, int silence);
+
+#define SPREAD_NONE       (0)
+#define SPREAD_LIGHT      (1)
+#define SPREAD_NORMAL     (2)
+#define SPREAD_AGGRESSIVE (3)
+
+int spreading_decision(const CELTMode *m, const celt_norm *X, int *average,
+      int last_decision, int *hf_average, int *tapset_decision, int update_hf,
+      int end, int C, int M, const int *spread_weight);
+
+#ifdef MEASURE_NORM_MSE
+void measure_norm_mse(const CELTMode *m, float *X, float *X0, float *bandE, float *bandE0, int M, int N, int C);
+#endif
+
+void haar1(celt_norm *X, int N0, int stride);
+
+/** Quantisation/encoding of the residual spectrum
+ * @param encode flag that indicates whether we're encoding (1) or decoding (0)
+ * @param m Mode data
+ * @param start First band to process
+ * @param end Last band to process + 1
+ * @param X Residual (normalised)
+ * @param Y Residual (normalised) for second channel (or NULL for mono)
+ * @param collapse_masks Anti-collapse tracking mask
+ * @param bandE Square root of the energy for each band
+ * @param pulses Bit allocation (per band) for PVQ
+ * @param shortBlocks Zero for long blocks, non-zero for short blocks
+ * @param spread Amount of spreading to use
+ * @param dual_stereo Zero for MS stereo, non-zero for dual stereo
+ * @param intensity First band to use intensity stereo
+ * @param tf_res Time-frequency resolution change
+ * @param total_bits Total number of bits that can be used for the frame (including the ones already spent)
+ * @param balance Number of unallocated bits
+ * @param en Entropy coder state
+ * @param LM log2() of the number of 2.5 subframes in the frame
+ * @param codedBands Last band to receive bits + 1
+ * @param seed Random generator seed
+ * @param arch Run-time architecture (see opus_select_arch())
+ */
+void quant_all_bands(int encode, const CELTMode *m, int start, int end,
+      celt_norm * X, celt_norm * Y, unsigned char *collapse_masks,
+      const celt_ener *bandE, int *pulses, int shortBlocks, int spread,
+      int dual_stereo, int intensity, int *tf_res, opus_int32 total_bits,
+      opus_int32 balance, ec_ctx *ec, int M, int codedBands, opus_uint32 *seed,
+      int complexity, int arch, int disable_inv
+      ARG_QEXT(ec_ctx *ext_ec) ARG_QEXT(int *extra_pulses)
+      ARG_QEXT(opus_int32 total_ext_bits) ARG_QEXT(const int *cap));
+
+void anti_collapse(const CELTMode *m, celt_norm *X_,
+      unsigned char *collapse_masks, int LM, int C, int size, int start,
+      int end, const celt_glog *logE, const celt_glog *prev1logE,
+      const celt_glog *prev2logE, const int *pulses, opus_uint32 seed,
+      int encode, int arch);
+
+opus_uint32 celt_lcg_rand(opus_uint32 seed);
+
+int hysteresis_decision(opus_val16 val, const opus_val16 *thresholds, const opus_val16 *hysteresis, int N, int prev);
+
+#endif /* BANDS_H */
@@ -0,0 +1,373 @@
+/* Copyright (c) 2007-2008 CSIRO
+   Copyright (c) 2007-2010 Xiph.Org Foundation
+   Copyright (c) 2008 Gregory Maxwell
+   Written by Jean-Marc Valin and Gregory Maxwell */
+/*
+   Redistribution and use in source and binary forms, with or without
+   modification, are permitted provided that the following conditions
+   are met:
+
+   - Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+
+   - Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+
+   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+   ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+   A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
+   OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+   EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+   PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+   PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+   LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+   NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+   SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+*/
+
+#ifdef HAVE_CONFIG_H
+#include "config.h"
+#endif
+
+#define CELT_C
+
+#include "os_support.h"
+#include "mdct.h"
+#include <math.h>
+#include "celt.h"
+#include "pitch.h"
+#include "bands.h"
+#include "modes.h"
+#include "entcode.h"
+#include "quant_bands.h"
+#include "rate.h"
+#include "stack_alloc.h"
+#include "mathops.h"
+#include "float_cast.h"
+#include <stdarg.h>
+#include "celt_lpc.h"
+#include "vq.h"
+
+#ifndef PACKAGE_VERSION
+#define PACKAGE_VERSION "unknown"
+#endif
+
+#if defined(FIXED_POINT) && defined(__mips)
+#include "mips/celt_mipsr1.h"
+#endif
+
+
+int resampling_factor(opus_int32 rate)
+{
+   int ret;
+   switch (rate)
+   {
+#ifdef ENABLE_QEXT
+   case 96000:
+#endif
+   case 48000:
+      ret = 1;
+      break;
+   case 24000:
+      ret = 2;
+      break;
+   case 16000:
+      ret = 3;
+      break;
+   case 12000:
+      ret = 4;
+      break;
+   case 8000:
+      ret = 6;
+      break;
+   default:
+#ifndef CUSTOM_MODES
+      celt_assert(0);
+#endif
+      ret = 0;
+      break;
+   }
+   return ret;
+}
+
+
+#if !defined(OVERRIDE_COMB_FILTER_CONST) || defined(NON_STATIC_COMB_FILTER_CONST_C)
+/* This version should be faster on ARM */
+#ifdef OPUS_ARM_ASM
+#ifndef NON_STATIC_COMB_FILTER_CONST_C
+static
+#endif
+void comb_filter_const_c(opus_val32 *y, opus_val32 *x, int T, int N,
+      celt_coef g10, celt_coef g11, celt_coef g12)
+{
+   opus_val32 x0, x1, x2, x3, x4;
+   int i;
+   x4 = SHL32(x[-T-2], 1);
+   x3 = SHL32(x[-T-1], 1);
+   x2 = SHL32(x[-T], 1);
+   x1 = SHL32(x[-T+1], 1);
+   for (i=0;i<N-4;i+=5)
+   {
+      opus_val32 t;
+      x0=SHL32(x[i-T+2],1);
+      t = MAC_COEF_32_ARM(x[i], g10, x2);
+      t = MAC_COEF_32_ARM(t, g11, ADD32(x1,x3));
+      t = MAC_COEF_32_ARM(t, g12, ADD32(x0,x4));
+      t = SATURATE(t, SIG_SAT);
+      y[i] = t;
+      x4=SHL32(x[i-T+3],1);
+      t = MAC_COEF_32_ARM(x[i+1], g10, x1);
+      t = MAC_COEF_32_ARM(t, g11, ADD32(x0,x2));
+      t = MAC_COEF_32_ARM(t, g12, ADD32(x4,x3));
+      t = SATURATE(t, SIG_SAT);
+      y[i+1] = t;
+      x3=SHL32(x[i-T+4],1);
+      t = MAC_COEF_32_ARM(x[i+2], g10, x0);
+      t = MAC_COEF_32_ARM(t, g11, ADD32(x4,x1));
+      t = MAC_COEF_32_ARM(t, g12, ADD32(x3,x2));
+      t = SATURATE(t, SIG_SAT);
+      y[i+2] = t;
+      x2=SHL32(x[i-T+5],1);
+      t = MAC_COEF_32_ARM(x[i+3], g10, x4);
+      t = MAC_COEF_32_ARM(t, g11, ADD32(x3,x0));
+      t = MAC_COEF_32_ARM(t, g12, ADD32(x2,x1));
+      t = SATURATE(t, SIG_SAT);
+      y[i+3] = t;
+      x1=SHL32(x[i-T+6],1);
+      t = MAC_COEF_32_ARM(x[i+4], g10, x3);
+      t = MAC_COEF_32_ARM(t, g11, ADD32(x2,x4));
+      t = MAC_COEF_32_ARM(t, g12, ADD32(x1,x0));
+      t = SATURATE(t, SIG_SAT);
+      y[i+4] = t;
+   }
+#ifdef CUSTOM_MODES
+   for (;i<N;i++)
+   {
+      opus_val32 t;
+      x0=SHL32(x[i-T+2],1);
+      t = MAC_COEF_32_ARM(x[i], g10, x2);
+      t = MAC_COEF_32_ARM(t, g11, ADD32(x1,x3));
+      t = MAC_COEF_32_ARM(t, g12, ADD32(x0,x4));
+      t = SATURATE(t, SIG_SAT);
+      y[i] = t;
+      x4=x3;
+      x3=x2;
+      x2=x1;
+      x1=x0;
+   }
+#endif
+}
+#else
+#ifndef NON_STATIC_COMB_FILTER_CONST_C
+static
+#endif
+void comb_filter_const_c(opus_val32 *y, opus_val32 *x, int T, int N,
+      celt_coef g10, celt_coef g11, celt_coef g12)
+{
+   opus_val32 x0, x1, x2, x3, x4;
+   int i;
+   x4 = x[-T-2];
+   x3 = x[-T-1];
+   x2 = x[-T];
+   x1 = x[-T+1];
+   for (i=0;i<N;i++)
+   {
+      x0=x[i-T+2];
+      y[i] = x[i]
+               + MULT_COEF_32(g10,x2)
+               + MULT_COEF_32(g11,ADD32(x1,x3))
+               + MULT_COEF_32(g12,ADD32(x0,x4));
+#ifdef FIXED_POINT
+      /* A bit of bias seems to help here. */
+      y[i] = SUB32(y[i], 1);
+#endif
+      y[i] = SATURATE(y[i], SIG_SAT);
+      x4=x3;
+      x3=x2;
+      x2=x1;
+      x1=x0;
+   }
+
+}
+#endif
+#endif
+
+#ifdef ENABLE_QEXT
+void comb_filter_qext(opus_val32 *y, opus_val32 *x, int T0, int T1, int N,
+      opus_val16 g0, opus_val16 g1, int tapset0, int tapset1,
+      const celt_coef *window, int overlap, int arch)
+{
+   VARDECL(opus_val32, mem_buf);
+   VARDECL(opus_val32, buf);
+   celt_coef new_window[120];
+   int s;
+   int i;
+   int N2;
+   int overlap2;
+   SAVE_STACK;
+   /* Using ALLOC() instead of a regular stack allocation to minimize real stack use when using the pseudostack.
+      This is useful on some embedded systems. */
+   ALLOC(mem_buf, COMBFILTER_MAXPERIOD+960, opus_val32);
+   ALLOC(buf, COMBFILTER_MAXPERIOD+960, opus_val32);
+   N2 = N/2;
+   overlap2=overlap/2;
+   /* At 96 kHz, we double the period and the spacing between taps, which is equivalent
+      to creating a mirror image of the filter around 24 kHz. It also means we can process
+      the even and odd samples completely independently. */
+   for (s=0;s<2;s++) {
+      opus_val32 *yptr;
+      for (i=0;i<overlap2;i++) new_window[i] = window[2*i+s];
+      for (i=0;i<COMBFILTER_MAXPERIOD+N2;i++) mem_buf[i] = x[2*i+s-2*COMBFILTER_MAXPERIOD];
+      if (x==y) {
+         yptr = mem_buf+COMBFILTER_MAXPERIOD;
+      } else {
+         for (i=0;i<N2;i++) buf[i] = y[2*i+s];
+         yptr = buf;
+      }
+      comb_filter(yptr, mem_buf+COMBFILTER_MAXPERIOD, T0, T1, N2, g0, g1, tapset0, tapset1, new_window, overlap2, arch);
+      for (i=0;i<N2;i++) y[2*i+s] = yptr[i];
+   }
+   RESTORE_STACK;
+   return;
+}
+#endif
+
+#ifndef OVERRIDE_comb_filter
+void comb_filter(opus_val32 *y, opus_val32 *x, int T0, int T1, int N,
+      opus_val16 g0, opus_val16 g1, int tapset0, int tapset1,
+      const celt_coef *window, int overlap, int arch)
+{
+   int i;
+   /* printf ("%d %d %f %f\n", T0, T1, g0, g1); */
+   celt_coef g00, g01, g02, g10, g11, g12;
+   opus_val32 x0, x1, x2, x3, x4;
+   static const opus_val16 gains[3][3] = {
+         {QCONST16(0.3066406250f, 15), QCONST16(0.2170410156f, 15), QCONST16(0.1296386719f, 15)},
+         {QCONST16(0.4638671875f, 15), QCONST16(0.2680664062f, 15), QCONST16(0.f, 15)},
+         {QCONST16(0.7998046875f, 15), QCONST16(0.1000976562f, 15), QCONST16(0.f, 15)}};
+#ifdef ENABLE_QEXT
+   if (overlap==240) {
+      comb_filter_qext(y, x, T0, T1, N, g0, g1, tapset0, tapset1, window, overlap, arch);
+      return;
+   }
+#endif
+   if (g0==0 && g1==0)
+   {
+      /* OPT: Happens to work without the OPUS_MOVE(), but only because the current encoder already copies x to y */
+      if (x!=y)
+         OPUS_MOVE(y, x, N);
+      return;
+   }
+   /* When the gain is zero, T0 and/or T1 is set to zero. We need
+      to have then be at least 2 to avoid processing garbage data. */
+   T0 = IMAX(T0, COMBFILTER_MINPERIOD);
+   T1 = IMAX(T1, COMBFILTER_MINPERIOD);
+   g00 = MULT_COEF_TAPS(g0, gains[tapset0][0]);
+   g01 = MULT_COEF_TAPS(g0, gains[tapset0][1]);
+   g02 = MULT_COEF_TAPS(g0, gains[tapset0][2]);
+   g10 = MULT_COEF_TAPS(g1, gains[tapset1][0]);
+   g11 = MULT_COEF_TAPS(g1, gains[tapset1][1]);
+   g12 = MULT_COEF_TAPS(g1, gains[tapset1][2]);
+   x1 = x[-T1+1];
+   x2 = x[-T1  ];
+   x3 = x[-T1-1];
+   x4 = x[-T1-2];
+   /* If the filter didn't change, we don't need the overlap */
+   if (g0==g1 && T0==T1 && tapset0==tapset1)
+      overlap=0;
+   for (i=0;i<overlap;i++)
+   {
+      celt_coef f;
+      x0=x[i-T1+2];
+      f = MULT_COEF(window[i],window[i]);
+      y[i] = x[i]
+               + MULT_COEF_32(MULT_COEF((COEF_ONE-f),g00),x[i-T0])
+               + MULT_COEF_32(MULT_COEF((COEF_ONE-f),g01),ADD32(x[i-T0+1],x[i-T0-1]))
+               + MULT_COEF_32(MULT_COEF((COEF_ONE-f),g02),ADD32(x[i-T0+2],x[i-T0-2]))
+               + MULT_COEF_32(MULT_COEF(f,g10),x2)
+               + MULT_COEF_32(MULT_COEF(f,g11),ADD32(x1,x3))
+               + MULT_COEF_32(MULT_COEF(f,g12),ADD32(x0,x4));
+#ifdef FIXED_POINT
+      /* A bit of bias seems to help here. */
+      y[i] = SUB32(y[i], 3);
+#endif
+      y[i] = SATURATE(y[i], SIG_SAT);
+      x4=x3;
+      x3=x2;
+      x2=x1;
+      x1=x0;
+
+   }
+   if (g1==0)
+   {
+      /* OPT: Happens to work without the OPUS_MOVE(), but only because the current encoder already copies x to y */
+      if (x!=y)
+         OPUS_MOVE(y+overlap, x+overlap, N-overlap);
+      return;
+   }
+
+   /* Compute the part with the constant filter. */
+   comb_filter_const(y+i, x+i, T1, N-i, g10, g11, g12, arch);
+}
+#endif /* OVERRIDE_comb_filter */
+
+/* TF change table. Positive values mean better frequency resolution (longer
+   effective window), whereas negative values mean better time resolution
+   (shorter effective window). The second index is computed as:
+   4*isTransient + 2*tf_select + per_band_flag */
+const signed char tf_select_table[4][8] = {
+    /*isTransient=0     isTransient=1 */
+      {0, -1, 0, -1,    0,-1, 0,-1}, /* 2.5 ms */
+      {0, -1, 0, -2,    1, 0, 1,-1}, /* 5 ms */
+      {0, -2, 0, -3,    2, 0, 1,-1}, /* 10 ms */
+      {0, -2, 0, -3,    3, 0, 1,-1}, /* 20 ms */
+};
+
+
+void init_caps(const CELTMode *m,int *cap,int LM,int C)
+{
+   int i;
+   for (i=0;i<m->nbEBands;i++)
+   {
+      int N;
+      N=(m->eBands[i+1]-m->eBands[i])<<LM;
+      cap[i] = (m->cache.caps[m->nbEBands*(2*LM+C-1)+i]+64)*C*N>>2;
+   }
+}
+
+
+
+const char *opus_strerror(int error)
+{
+   static const char * const error_strings[8] = {
+      "success",
+      "invalid argument",
+      "buffer too small",
+      "internal error",
+      "corrupted stream",
+      "request not implemented",
+      "invalid state",
+      "memory allocation failed"
+   };
+   if (error > 0 || error < -7)
+      return "unknown error";
+   else
+      return error_strings[-error];
+}
+
+const char *opus_get_version_string(void)
+{
+    return "libopus " PACKAGE_VERSION
+    /* Applications may rely on the presence of this substring in the version
+       string to determine if they have a fixed-point or floating-point build
+       at runtime. */
+#ifdef FIXED_POINT
+          "-fixed"
+#endif
+#ifdef FUZZING
+          "-fuzzing"
+#endif
+          ;
+}
@@ -0,0 +1,274 @@
+/* Copyright (c) 2007-2008 CSIRO
+   Copyright (c) 2007-2009 Xiph.Org Foundation
+   Copyright (c) 2008 Gregory Maxwell
+   Written by Jean-Marc Valin and Gregory Maxwell */
+/**
+  @file celt.h
+  @brief Contains all the functions for encoding and decoding audio
+ */
+
+/*
+   Redistribution and use in source and binary forms, with or without
+   modification, are permitted provided that the following conditions
+   are met:
+
+   - Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+
+   - Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+
+   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+   ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+   A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
+   OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+   EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+   PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+   PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+   LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+   NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+   SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+*/
+
+#ifndef CELT_H
+#define CELT_H
+
+#include "opus_types.h"
+#include "opus_defines.h"
+#include "opus_custom.h"
+#include "entenc.h"
+#include "entdec.h"
+#include "arch.h"
+#include "kiss_fft.h"
+
+#ifdef ENABLE_QEXT
+#define ARG_QEXT(arg) , arg
+#else
+#define ARG_QEXT(arg)
+#endif
+
+
+#ifdef ENABLE_DEEP_PLC
+#include "lpcnet.h"
+#endif
+
+#define CELTEncoder OpusCustomEncoder
+#define CELTDecoder OpusCustomDecoder
+#define CELTMode OpusCustomMode
+
+#define QEXT_EXTENSION_ID 124
+
+#define LEAK_BANDS 19
+
+typedef struct {
+   int valid;
+   float tonality;
+   float tonality_slope;
+   float noisiness;
+   float activity;
+   float music_prob;
+   float music_prob_min;
+   float music_prob_max;
+   int   bandwidth;
+   float activity_probability;
+   float max_pitch_ratio;
+   /* Store as Q6 char to save space. */
+   unsigned char leak_boost[LEAK_BANDS];
+} AnalysisInfo;
+
+typedef struct {
+   int signalType;
+   int offset;
+} SILKInfo;
+
+#define celt_check_mode_ptr_ptr(ptr) ((ptr) + ((ptr) - (const CELTMode**)(ptr)))
+
+#define celt_check_analysis_ptr(ptr) ((ptr) + ((ptr) - (const AnalysisInfo*)(ptr)))
+
+#define celt_check_silkinfo_ptr(ptr) ((ptr) + ((ptr) - (const SILKInfo*)(ptr)))
+
+#define celt_check_glog_ptr(ptr) ((ptr) + ((ptr) - (celt_glog*)(ptr)))
+
+/* Encoder/decoder Requests */
+
+
+#define CELT_SET_PREDICTION_REQUEST    10002
+/** Controls the use of interframe prediction.
+    0=Independent frames
+    1=Short term interframe prediction allowed
+    2=Long term prediction allowed
+ */
+#define CELT_SET_PREDICTION(x) CELT_SET_PREDICTION_REQUEST, opus_check_int(x)
+
+#define CELT_SET_INPUT_CLIPPING_REQUEST    10004
+#define CELT_SET_INPUT_CLIPPING(x) CELT_SET_INPUT_CLIPPING_REQUEST, opus_check_int(x)
+
+#define CELT_GET_AND_CLEAR_ERROR_REQUEST   10007
+#define CELT_GET_AND_CLEAR_ERROR(x) CELT_GET_AND_CLEAR_ERROR_REQUEST, opus_check_int_ptr(x)
+
+#define CELT_SET_CHANNELS_REQUEST    10008
+#define CELT_SET_CHANNELS(x) CELT_SET_CHANNELS_REQUEST, opus_check_int(x)
+
+
+/* Internal */
+#define CELT_SET_START_BAND_REQUEST    10010
+#define CELT_SET_START_BAND(x) CELT_SET_START_BAND_REQUEST, opus_check_int(x)
+
+#define CELT_SET_END_BAND_REQUEST    10012
+#define CELT_SET_END_BAND(x) CELT_SET_END_BAND_REQUEST, opus_check_int(x)
+
+#define CELT_GET_MODE_REQUEST    10015
+/** Get the CELTMode used by an encoder or decoder */
+#define CELT_GET_MODE(x) CELT_GET_MODE_REQUEST, celt_check_mode_ptr_ptr(x)
+
+#define CELT_SET_SIGNALLING_REQUEST    10016
+#define CELT_SET_SIGNALLING(x) CELT_SET_SIGNALLING_REQUEST, opus_check_int(x)
+
+#define CELT_SET_TONALITY_REQUEST    10018
+#define CELT_SET_TONALITY(x) CELT_SET_TONALITY_REQUEST, opus_check_int(x)
+#define CELT_SET_TONALITY_SLOPE_REQUEST    10020
+#define CELT_SET_TONALITY_SLOPE(x) CELT_SET_TONALITY_SLOPE_REQUEST, opus_check_int(x)
+
+#define CELT_SET_ANALYSIS_REQUEST    10022
+#define CELT_SET_ANALYSIS(x) CELT_SET_ANALYSIS_REQUEST, celt_check_analysis_ptr(x)
+
+#define OPUS_SET_LFE_REQUEST    10024
+#define OPUS_SET_LFE(x) OPUS_SET_LFE_REQUEST, opus_check_int(x)
+
+#define OPUS_SET_ENERGY_MASK_REQUEST    10026
+#define OPUS_SET_ENERGY_MASK(x) OPUS_SET_ENERGY_MASK_REQUEST, celt_check_glog_ptr(x)
+
+#define CELT_SET_SILK_INFO_REQUEST    10028
+#define CELT_SET_SILK_INFO(x) CELT_SET_SILK_INFO_REQUEST, celt_check_silkinfo_ptr(x)
+
+
+static OPUS_INLINE opus_int32 bits_to_bitrate(opus_int32 bits, opus_int32 Fs, opus_int32 frame_size) {
+   return bits*(6*Fs/frame_size)/6;
+}
+
+static OPUS_INLINE opus_int32 bitrate_to_bits(opus_int32 bitrate, opus_int32 Fs, opus_int32 frame_size) {
+   return bitrate*6/(6*Fs/frame_size);
+}
+
+/* Encoder stuff */
+
+int celt_encoder_get_size(int channels);
+
+int celt_encode_with_ec(OpusCustomEncoder * OPUS_RESTRICT st, const opus_res * pcm, int frame_size, unsigned char *compressed, int nbCompressedBytes, ec_enc *enc);
+
+int celt_encoder_init(CELTEncoder *st, opus_int32 sampling_rate, int channels,
+                      int arch);
+
+
+
+/* Decoder stuff */
+
+int celt_decoder_get_size(int channels);
+
+
+int celt_decoder_init(CELTDecoder *st, opus_int32 sampling_rate, int channels);
+
+int celt_decode_with_ec_dred(CELTDecoder * OPUS_RESTRICT st, const unsigned char *data,
+      int len, opus_res * OPUS_RESTRICT pcm, int frame_size, ec_dec *dec, int accum
+#ifdef ENABLE_DEEP_PLC
+      ,LPCNetPLCState *lpcnet
+#endif
+      ARG_QEXT(const unsigned char *qext_payload) ARG_QEXT(int qext_payload_len)
+      );
+
+int celt_decode_with_ec(OpusCustomDecoder * OPUS_RESTRICT st, const unsigned char *data,
+      int len, opus_res * OPUS_RESTRICT pcm, int frame_size, ec_dec *dec, int accum);
+
+#define celt_encoder_ctl opus_custom_encoder_ctl
+#define celt_decoder_ctl opus_custom_decoder_ctl
+
+
+#if defined(CUSTOM_MODES) || defined(ENABLE_OPUS_CUSTOM_API)
+#define OPUS_CUSTOM_NOSTATIC
+#else
+#define OPUS_CUSTOM_NOSTATIC static OPUS_INLINE
+#endif
+
+static const unsigned char trim_icdf[11] = {126, 124, 119, 109, 87, 41, 19, 9, 4, 2, 0};
+/* Probs: NONE: 21.875%, LIGHT: 6.25%, NORMAL: 65.625%, AGGRESSIVE: 6.25% */
+static const unsigned char spread_icdf[4] = {25, 23, 2, 0};
+
+static const unsigned char tapset_icdf[3]={2,1,0};
+
+#if defined(CUSTOM_MODES) || defined(ENABLE_OPUS_CUSTOM_API)
+static const unsigned char toOpusTable[20] = {
+      0xE0, 0xE8, 0xF0, 0xF8,
+      0xC0, 0xC8, 0xD0, 0xD8,
+      0xA0, 0xA8, 0xB0, 0xB8,
+      0x00, 0x00, 0x00, 0x00,
+      0x80, 0x88, 0x90, 0x98,
+};
+
+static const unsigned char fromOpusTable[16] = {
+      0x80, 0x88, 0x90, 0x98,
+      0x40, 0x48, 0x50, 0x58,
+      0x20, 0x28, 0x30, 0x38,
+      0x00, 0x08, 0x10, 0x18
+};
+
+static OPUS_INLINE int toOpus(unsigned char c)
+{
+   int ret=0;
+   if (c<0xA0)
+      ret = toOpusTable[c>>3];
+   if (ret == 0)
+      return -1;
+   else
+      return ret|(c&0x7);
+}
+
+static OPUS_INLINE int fromOpus(unsigned char c)
+{
+   if (c<0x80)
+      return -1;
+   else
+      return fromOpusTable[(c>>3)-16] | (c&0x7);
+}
+#endif /* CUSTOM_MODES */
+
+#define COMBFILTER_MAXPERIOD 1024
+#define COMBFILTER_MINPERIOD 15
+
+extern const signed char tf_select_table[4][8];
+
+#if defined(ENABLE_HARDENING) || defined(ENABLE_ASSERTIONS)
+void validate_celt_decoder(CELTDecoder *st);
+#define VALIDATE_CELT_DECODER(st) validate_celt_decoder(st)
+#else
+#define VALIDATE_CELT_DECODER(st)
+#endif
+
+int resampling_factor(opus_int32 rate);
+
+void celt_preemphasis(const opus_res * OPUS_RESTRICT pcmp, celt_sig * OPUS_RESTRICT inp,
+                        int N, int CC, int upsample, const opus_val16 *coef, celt_sig *mem, int clip);
+
+void comb_filter(opus_val32 *y, opus_val32 *x, int T0, int T1, int N,
+      opus_val16 g0, opus_val16 g1, int tapset0, int tapset1,
+      const celt_coef *window, int overlap, int arch);
+
+void init_caps(const CELTMode *m,int *cap,int LM,int C);
+
+#ifdef RESYNTH
+void deemphasis(celt_sig *in[], opus_res *pcm, int N, int C, int downsample, const opus_val16 *coef, celt_sig *mem, int accum);
+void celt_synthesis(const CELTMode *mode, celt_norm *X, celt_sig * out_syn[],
+      celt_glog *oldBandE, int start, int effEnd, int C, int CC, int isTransient,
+      int LM, int downsample, int silence, int arch ARG_QEXT(const CELTMode *qext_mode) ARG_QEXT(const celt_glog *qext_bandLogE) ARG_QEXT(int qext_end));
+#endif
+
+#ifdef ENABLE_QEXT
+#define QEXT_SCALE(x) ((qext_scale)*(x))
+#define QEXT_SCALE2(x, qext_scale) ((qext_scale)*(x))
+#else
+#define QEXT_SCALE(x) (x)
+#define QEXT_SCALE2(x, qext_scale) (x)
+#endif
+
+#endif /* CELT_H */
@@ -0,0 +1,374 @@
+/* Copyright (c) 2009-2010 Xiph.Org Foundation
+   Written by Jean-Marc Valin */
+/*
+   Redistribution and use in source and binary forms, with or without
+   modification, are permitted provided that the following conditions
+   are met:
+
+   - Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+
+   - Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+
+   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+   ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+   A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
+   OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+   EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+   PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+   PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+   LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+   NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+   SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+*/
+
+#ifdef HAVE_CONFIG_H
+#include "config.h"
+#endif
+
+#include "celt_lpc.h"
+#include "stack_alloc.h"
+#include "mathops.h"
+#include "pitch.h"
+
+void _celt_lpc(
+      opus_val16       *_lpc, /* out: [0...p-1] LPC coefficients      */
+const opus_val32 *ac,  /* in:  [0...p] autocorrelation values  */
+int          p
+)
+{
+   int i, j;
+   opus_val32 r;
+   opus_val32 error = ac[0];
+#ifdef FIXED_POINT
+   opus_val32 lpc[CELT_LPC_ORDER];
+#else
+   float *lpc = _lpc;
+#endif
+
+   OPUS_CLEAR(lpc, p);
+#ifdef FIXED_POINT
+   if (ac[0] != 0)
+#else
+   if (ac[0] > 1e-10f)
+#endif
+   {
+      for (i = 0; i < p; i++) {
+         /* Sum up this iteration's reflection coefficient */
+         opus_val32 rr = 0;
+#if defined (FIXED_POINT) && OPUS_FAST_INT64
+         opus_int64 acc = 0;
+         for (j = 0; j < i; j++)
+            acc += (opus_int64)(lpc[j]) * (opus_int64)(ac[i - j]);
+         rr = (opus_val32)SHR64(acc, 31);
+#else
+         for (j = 0; j < i; j++)
+            rr += MULT32_32_Q31(lpc[j],ac[i - j]);
+#endif
+         rr += SHR32(ac[i + 1],6);
+         r = -frac_div32(SHL32(rr,6), error);
+         /*  Update LPC coefficients and total error */
+         lpc[i] = SHR32(r,6);
+         for (j = 0; j < (i+1)>>1; j++)
+         {
+            opus_val32 tmp1, tmp2;
+            tmp1 = lpc[j];
+            tmp2 = lpc[i-1-j];
+            lpc[j]     = tmp1 + MULT32_32_Q31(r,tmp2);
+            lpc[i-1-j] = tmp2 + MULT32_32_Q31(r,tmp1);
+         }
+
+         error = error - MULT32_32_Q31(MULT32_32_Q31(r,r),error);
+         /* Bail out once we get 30 dB gain */
+#ifdef FIXED_POINT
+         if (error<=SHR32(ac[0],10))
+            break;
+#else
+         if (error<=.001f*ac[0])
+            break;
+#endif
+      }
+   }
+#ifdef FIXED_POINT
+   {
+      /* Convert the int32 lpcs to int16 and ensure there are no wrap-arounds.
+         This reuses the logic in silk_LPC_fit() and silk_bwexpander_32(). Any bug
+         fixes should also be applied there. */
+      int iter, idx = 0;
+      opus_val32 maxabs, absval, chirp_Q16, chirp_minus_one_Q16;
+
+      for (iter = 0; iter < 10; iter++) {
+         maxabs = 0;
+         for (i = 0; i < p; i++) {
+            absval = ABS32(lpc[i]);
+            if (absval > maxabs) {
+               maxabs = absval;
+               idx = i;
+            }
+         }
+         maxabs = PSHR32(maxabs, 13);  /* Q25->Q12 */
+
+         if (maxabs > 32767) {
+            maxabs = MIN32(maxabs, 163838);
+            chirp_Q16 = QCONST32(0.999, 16) - DIV32(SHL32(maxabs - 32767, 14),
+                                                    SHR32(MULT32_32_32(maxabs, idx + 1), 2));
+            chirp_minus_one_Q16 = chirp_Q16 - 65536;
+
+            /* Apply bandwidth expansion. */
+            for (i = 0; i < p - 1; i++) {
+               lpc[i] = MULT32_32_Q16(chirp_Q16, lpc[i]);
+               chirp_Q16 += PSHR32(MULT32_32_32(chirp_Q16, chirp_minus_one_Q16), 16);
+            }
+            lpc[p - 1] = MULT32_32_Q16(chirp_Q16, lpc[p - 1]);
+         } else {
+            break;
+         }
+      }
+
+      if (iter == 10) {
+         /* If the coeffs still do not fit into the 16 bit range after 10 iterations,
+            fall back to the A(z)=1 filter. */
+         OPUS_CLEAR(lpc, p);
+         _lpc[0] = 4096;  /* Q12 */
+      } else {
+         for (i = 0; i < p; i++) {
+            _lpc[i] = EXTRACT16(PSHR32(lpc[i], 13));  /* Q25->Q12 */
+         }
+      }
+   }
+#endif
+}
+
+
+void celt_fir_c(
+         const opus_val16 *x,
+         const opus_val16 *num,
+         opus_val16 *y,
+         int N,
+         int ord,
+         int arch)
+{
+   int i,j;
+   VARDECL(opus_val16, rnum);
+   SAVE_STACK;
+   celt_assert(x != y);
+   ALLOC(rnum, ord, opus_val16);
+   for(i=0;i<ord;i++)
+      rnum[i] = num[ord-i-1];
+   for (i=0;i<N-3;i+=4)
+   {
+      opus_val32 sum[4];
+      sum[0] = SHL32(EXTEND32(x[i  ]), SIG_SHIFT);
+      sum[1] = SHL32(EXTEND32(x[i+1]), SIG_SHIFT);
+      sum[2] = SHL32(EXTEND32(x[i+2]), SIG_SHIFT);
+      sum[3] = SHL32(EXTEND32(x[i+3]), SIG_SHIFT);
+#if defined(OPUS_CHECK_ASM) && defined(FIXED_POINT)
+      {
+         opus_val32 sum_c[4];
+         memcpy(sum_c, sum, sizeof(sum_c));
+         xcorr_kernel_c(rnum, x+i-ord, sum_c, ord);
+#endif
+         xcorr_kernel(rnum, x+i-ord, sum, ord, arch);
+#if defined(OPUS_CHECK_ASM) && defined(FIXED_POINT)
+         celt_assert(memcmp(sum, sum_c, sizeof(sum)) == 0);
+      }
+#endif
+      y[i  ] = SROUND16(sum[0], SIG_SHIFT);
+      y[i+1] = SROUND16(sum[1], SIG_SHIFT);
+      y[i+2] = SROUND16(sum[2], SIG_SHIFT);
+      y[i+3] = SROUND16(sum[3], SIG_SHIFT);
+   }
+   for (;i<N;i++)
+   {
+      opus_val32 sum = SHL32(EXTEND32(x[i]), SIG_SHIFT);
+      for (j=0;j<ord;j++)
+         sum = MAC16_16(sum,rnum[j],x[i+j-ord]);
+      y[i] = SROUND16(sum, SIG_SHIFT);
+   }
+   RESTORE_STACK;
+}
+
+void celt_iir(const opus_val32 *_x,
+         const opus_val16 *den,
+         opus_val32 *_y,
+         int N,
+         int ord,
+         opus_val16 *mem,
+         int arch)
+{
+#ifdef SMALL_FOOTPRINT
+   int i,j;
+   (void)arch;
+   for (i=0;i<N;i++)
+   {
+      opus_val32 sum = _x[i];
+      for (j=0;j<ord;j++)
+      {
+         sum -= MULT16_16(den[j],mem[j]);
+      }
+      for (j=ord-1;j>=1;j--)
+      {
+         mem[j]=mem[j-1];
+      }
+      mem[0] = SROUND16(sum, SIG_SHIFT);
+      _y[i] = sum;
+   }
+#else
+   int i,j;
+   VARDECL(opus_val16, rden);
+   VARDECL(opus_val16, y);
+   SAVE_STACK;
+
+   celt_assert((ord&3)==0);
+   ALLOC(rden, ord, opus_val16);
+   ALLOC(y, N+ord, opus_val16);
+   for(i=0;i<ord;i++)
+      rden[i] = den[ord-i-1];
+   for(i=0;i<ord;i++)
+      y[i] = -mem[ord-i-1];
+   for(;i<N+ord;i++)
+      y[i]=0;
+   for (i=0;i<N-3;i+=4)
+   {
+      /* Unroll by 4 as if it were an FIR filter */
+      opus_val32 sum[4];
+      sum[0]=_x[i];
+      sum[1]=_x[i+1];
+      sum[2]=_x[i+2];
+      sum[3]=_x[i+3];
+#if defined(OPUS_CHECK_ASM) && defined(FIXED_POINT)
+      {
+         opus_val32 sum_c[4];
+         memcpy(sum_c, sum, sizeof(sum_c));
+         xcorr_kernel_c(rden, y+i, sum_c, ord);
+#endif
+         xcorr_kernel(rden, y+i, sum, ord, arch);
+#if defined(OPUS_CHECK_ASM) && defined(FIXED_POINT)
+         celt_assert(memcmp(sum, sum_c, sizeof(sum)) == 0);
+      }
+#endif
+      /* Patch up the result to compensate for the fact that this is an IIR */
+      y[i+ord  ] = -SROUND16(sum[0],SIG_SHIFT);
+      _y[i  ] = sum[0];
+      sum[1] = MAC16_16(sum[1], y[i+ord  ], den[0]);
+      y[i+ord+1] = -SROUND16(sum[1],SIG_SHIFT);
+      _y[i+1] = sum[1];
+      sum[2] = MAC16_16(sum[2], y[i+ord+1], den[0]);
+      sum[2] = MAC16_16(sum[2], y[i+ord  ], den[1]);
+      y[i+ord+2] = -SROUND16(sum[2],SIG_SHIFT);
+      _y[i+2] = sum[2];
+
+      sum[3] = MAC16_16(sum[3], y[i+ord+2], den[0]);
+      sum[3] = MAC16_16(sum[3], y[i+ord+1], den[1]);
+      sum[3] = MAC16_16(sum[3], y[i+ord  ], den[2]);
+      y[i+ord+3] = -SROUND16(sum[3],SIG_SHIFT);
+      _y[i+3] = sum[3];
+   }
+   for (;i<N;i++)
+   {
+      opus_val32 sum = _x[i];
+      for (j=0;j<ord;j++)
+         sum -= MULT16_16(rden[j],y[i+j]);
+      y[i+ord] = SROUND16(sum,SIG_SHIFT);
+      _y[i] = sum;
+   }
+   for(i=0;i<ord;i++)
+      mem[i] = _y[N-i-1];
+   RESTORE_STACK;
+#endif
+}
+
+int _celt_autocorr(
+                   const opus_val16 *x,   /*  in: [0...n-1] samples x   */
+                   opus_val32       *ac,  /* out: [0...lag-1] ac values */
+                   const celt_coef  *window,
+                   int          overlap,
+                   int          lag,
+                   int          n,
+                   int          arch
+                  )
+{
+   opus_val32 d;
+   int i, k;
+   int fastN=n-lag;
+   int shift;
+   const opus_val16 *xptr;
+   VARDECL(opus_val16, xx);
+   SAVE_STACK;
+   ALLOC(xx, n, opus_val16);
+   celt_assert(n>0);
+   celt_assert(overlap>=0);
+   if (overlap == 0)
+   {
+      xptr = x;
+   } else {
+      for (i=0;i<n;i++)
+         xx[i] = x[i];
+      for (i=0;i<overlap;i++)
+      {
+         opus_val16 w = COEF2VAL16(window[i]);
+         xx[i] = MULT16_16_Q15(x[i],w);
+         xx[n-i-1] = MULT16_16_Q15(x[n-i-1],w);
+      }
+      xptr = xx;
+   }
+   shift=0;
+#ifdef FIXED_POINT
+   {
+      opus_val32 ac0;
+      int ac0_shift = celt_ilog2(n + (n>>4));
+      ac0 = 1+(n<<7);
+      if (n&1) ac0 += SHR32(MULT16_16(xptr[0],xptr[0]),ac0_shift);
+      for(i=(n&1);i<n;i+=2)
+      {
+         ac0 += SHR32(MULT16_16(xptr[i],xptr[i]),ac0_shift);
+         ac0 += SHR32(MULT16_16(xptr[i+1],xptr[i+1]),ac0_shift);
+      }
+      /* Consider the effect of rounding-to-nearest when scaling the signal. */
+      ac0 += SHR32(ac0,7);
+
+      shift = celt_ilog2(ac0)-30+ac0_shift+1;
+      shift = (shift)/2;
+      if (shift>0)
+      {
+         for(i=0;i<n;i++)
+            xx[i] = PSHR32(xptr[i], shift);
+         xptr = xx;
+      } else
+         shift = 0;
+   }
+#endif
+   celt_pitch_xcorr(xptr, xptr, ac, fastN, lag+1, arch);
+   for (k=0;k<=lag;k++)
+   {
+      for (i = k+fastN, d = 0; i < n; i++)
+         d = MAC16_16(d, xptr[i], xptr[i-k]);
+      ac[k] += d;
+   }
+#ifdef FIXED_POINT
+   shift = 2*shift;
+   if (shift<=0)
+      ac[0] += SHL32((opus_int32)1, -shift);
+   if (ac[0] < 268435456)
+   {
+      int shift2 = 29 - EC_ILOG(ac[0]);
+      for (i=0;i<=lag;i++)
+         ac[i] = SHL32(ac[i], shift2);
+      shift -= shift2;
+   } else if (ac[0] >= 536870912)
+   {
+      int shift2=1;
+      if (ac[0] >= 1073741824)
+         shift2++;
+      for (i=0;i<=lag;i++)
+         ac[i] = SHR32(ac[i], shift2);
+      shift += shift2;
+   }
+#endif
+
+   RESTORE_STACK;
+   return shift;
+}
@@ -0,0 +1,66 @@
+/* Copyright (c) 2009-2010 Xiph.Org Foundation
+   Written by Jean-Marc Valin */
+/*
+   Redistribution and use in source and binary forms, with or without
+   modification, are permitted provided that the following conditions
+   are met:
+
+   - Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+
+   - Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+
+   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+   ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+   A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
+   OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+   EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+   PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+   PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+   LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+   NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+   SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+*/
+
+#ifndef CELT_LPC_H
+#define CELT_LPC_H
+
+#include "arch.h"
+#include "cpu_support.h"
+
+#if defined(OPUS_X86_MAY_HAVE_SSE4_1)
+#include "x86/celt_lpc_sse.h"
+#endif
+
+#define CELT_LPC_ORDER 24
+
+void _celt_lpc(opus_val16 *_lpc, const opus_val32 *ac, int p);
+
+void celt_fir_c(
+         const opus_val16 *x,
+         const opus_val16 *num,
+         opus_val16 *y,
+         int N,
+         int ord,
+         int arch);
+
+#if !defined(OVERRIDE_CELT_FIR)
+#define celt_fir(x, num, y, N, ord, arch) \
+    (celt_fir_c(x, num, y, N, ord, arch))
+#endif
+
+void celt_iir(const opus_val32 *x,
+         const opus_val16 *den,
+         opus_val32 *y,
+         int N,
+         int ord,
+         opus_val16 *mem,
+         int arch);
+
+int _celt_autocorr(const opus_val16 *x, opus_val32 *ac,
+         const celt_coef *window, int overlap, int lag, int n, int arch);
+
+#endif /* CELT_LPC_H */
@@ -0,0 +1,72 @@
+/* Copyright (c) 2010 Xiph.Org Foundation
+ * Copyright (c) 2013 Parrot */
+/*
+   Redistribution and use in source and binary forms, with or without
+   modification, are permitted provided that the following conditions
+   are met:
+
+   - Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+
+   - Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+
+   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+   ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+   A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
+   OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+   EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+   PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+   PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+   LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+   NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+   SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+*/
+
+#ifndef CPU_SUPPORT_H
+#define CPU_SUPPORT_H
+
+#include "opus_types.h"
+#include "opus_defines.h"
+
+#if defined(OPUS_HAVE_RTCD) && \
+  (defined(OPUS_ARM_ASM) || defined(OPUS_ARM_MAY_HAVE_NEON_INTR))
+#include "arm/armcpu.h"
+
+/* We currently support 5 ARM variants:
+ * arch[0] -> ARMv4
+ * arch[1] -> ARMv5E
+ * arch[2] -> ARMv6
+ * arch[3] -> NEON
+ * arch[4] -> NEON+DOTPROD
+ */
+#define OPUS_ARCHMASK 7
+
+#elif defined(OPUS_HAVE_RTCD) && \
+  ((defined(OPUS_X86_MAY_HAVE_SSE) && !defined(OPUS_X86_PRESUME_SSE)) || \
+  (defined(OPUS_X86_MAY_HAVE_SSE2) && !defined(OPUS_X86_PRESUME_SSE2)) || \
+  (defined(OPUS_X86_MAY_HAVE_SSE4_1) && !defined(OPUS_X86_PRESUME_SSE4_1)) || \
+  (defined(OPUS_X86_MAY_HAVE_AVX2) && !defined(OPUS_X86_PRESUME_AVX2)))
+
+#include "x86/x86cpu.h"
+/* We currently support 5 x86 variants:
+ * arch[0] -> non-sse
+ * arch[1] -> sse
+ * arch[2] -> sse2
+ * arch[3] -> sse4.1
+ * arch[4] -> avx
+ */
+#define OPUS_ARCHMASK 7
+int opus_select_arch(void);
+
+#else
+#define OPUS_ARCHMASK 0
+
+static OPUS_INLINE int opus_select_arch(void)
+{
+  return 0;
+}
+#endif
+#endif
@@ -0,0 +1,719 @@
+/* Copyright (c) 2007-2008 CSIRO
+   Copyright (c) 2007-2009 Xiph.Org Foundation
+   Copyright (c) 2007-2009 Timothy B. Terriberry
+   Written by Timothy B. Terriberry and Jean-Marc Valin */
+/*
+   Redistribution and use in source and binary forms, with or without
+   modification, are permitted provided that the following conditions
+   are met:
+
+   - Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+
+   - Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+
+   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+   ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+   A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
+   OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+   EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+   PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+   PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+   LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+   NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+   SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+*/
+
+#ifdef HAVE_CONFIG_H
+#include "config.h"
+#endif
+
+#include "os_support.h"
+#include "cwrs.h"
+#include "mathops.h"
+#include "arch.h"
+
+#if defined(CUSTOM_MODES) || defined(ENABLE_QEXT)
+#define CWRS_EXTRA_ROWS
+#endif
+
+#if defined(CUSTOM_MODES)
+
+/*Guaranteed to return a conservatively large estimate of the binary logarithm
+   with frac bits of fractional precision.
+  Tested for all possible 32-bit inputs with frac=4, where the maximum
+   overestimation is 0.06254243 bits.*/
+int log2_frac(opus_uint32 val, int frac)
+{
+  int l;
+  l=EC_ILOG(val);
+  if(val&(val-1)){
+    /*This is (val>>l-16), but guaranteed to round up, even if adding a bias
+       before the shift would cause overflow (e.g., for 0xFFFFxxxx).
+       Doesn't work for val=0, but that case fails the test above.*/
+    if(l>16)val=((val-1)>>(l-16))+1;
+    else val<<=16-l;
+    l=(l-1)<<frac;
+    /*Note that we always need one iteration, since the rounding up above means
+       that we might need to adjust the integer part of the logarithm.*/
+    do{
+      int b;
+      b=(int)(val>>16);
+      l+=b<<frac;
+      val=(val+b)>>b;
+      val=(val*val+0x7FFF)>>15;
+    }
+    while(frac-->0);
+    /*If val is not exactly 0x8000, then we have to round up the remainder.*/
+    return l+(val>0x8000);
+  }
+  /*Exact powers of two require no rounding.*/
+  else return (l-1)<<frac;
+}
+#endif
+
+/*Although derived separately, the pulse vector coding scheme is equivalent to
+   a Pyramid Vector Quantizer \cite{Fis86}.
+  Some additional notes about an early version appear at
+   https://people.xiph.org/~tterribe/notes/cwrs.html, but the codebook ordering
+   and the definitions of some terms have evolved since that was written.
+
+  The conversion from a pulse vector to an integer index (encoding) and back
+   (decoding) is governed by two related functions, V(N,K) and U(N,K).
+
+  V(N,K) = the number of combinations, with replacement, of N items, taken K
+   at a time, when a sign bit is added to each item taken at least once (i.e.,
+   the number of N-dimensional unit pulse vectors with K pulses).
+  One way to compute this is via
+    V(N,K) = K>0 ? sum(k=1...K,2**k*choose(N,k)*choose(K-1,k-1)) : 1,
+   where choose() is the binomial function.
+  A table of values for N<10 and K<10 looks like:
+  V[10][10] = {
+    {1,  0,   0,    0,    0,     0,     0,      0,      0,       0},
+    {1,  2,   2,    2,    2,     2,     2,      2,      2,       2},
+    {1,  4,   8,   12,   16,    20,    24,     28,     32,      36},
+    {1,  6,  18,   38,   66,   102,   146,    198,    258,     326},
+    {1,  8,  32,   88,  192,   360,   608,    952,   1408,    1992},
+    {1, 10,  50,  170,  450,  1002,  1970,   3530,   5890,    9290},
+    {1, 12,  72,  292,  912,  2364,  5336,  10836,  20256,   35436},
+    {1, 14,  98,  462, 1666,  4942, 12642,  28814,  59906,  115598},
+    {1, 16, 128,  688, 2816,  9424, 27008,  68464, 157184,  332688},
+    {1, 18, 162,  978, 4482, 16722, 53154, 148626, 374274,  864146}
+  };
+
+  U(N,K) = the number of such combinations wherein N-1 objects are taken at
+   most K-1 at a time.
+  This is given by
+    U(N,K) = sum(k=0...K-1,V(N-1,k))
+           = K>0 ? (V(N-1,K-1) + V(N,K-1))/2 : 0.
+  The latter expression also makes clear that U(N,K) is half the number of such
+   combinations wherein the first object is taken at least once.
+  Although it may not be clear from either of these definitions, U(N,K) is the
+   natural function to work with when enumerating the pulse vector codebooks,
+   not V(N,K).
+  U(N,K) is not well-defined for N=0, but with the extension
+    U(0,K) = K>0 ? 0 : 1,
+   the function becomes symmetric: U(N,K) = U(K,N), with a similar table:
+  U[10][10] = {
+    {1, 0,  0,   0,    0,    0,     0,     0,      0,      0},
+    {0, 1,  1,   1,    1,    1,     1,     1,      1,      1},
+    {0, 1,  3,   5,    7,    9,    11,    13,     15,     17},
+    {0, 1,  5,  13,   25,   41,    61,    85,    113,    145},
+    {0, 1,  7,  25,   63,  129,   231,   377,    575,    833},
+    {0, 1,  9,  41,  129,  321,   681,  1289,   2241,   3649},
+    {0, 1, 11,  61,  231,  681,  1683,  3653,   7183,  13073},
+    {0, 1, 13,  85,  377, 1289,  3653,  8989,  19825,  40081},
+    {0, 1, 15, 113,  575, 2241,  7183, 19825,  48639, 108545},
+    {0, 1, 17, 145,  833, 3649, 13073, 40081, 108545, 265729}
+  };
+
+  With this extension, V(N,K) may be written in terms of U(N,K):
+    V(N,K) = U(N,K) + U(N,K+1)
+   for all N>=0, K>=0.
+  Thus U(N,K+1) represents the number of combinations where the first element
+   is positive or zero, and U(N,K) represents the number of combinations where
+   it is negative.
+  With a large enough table of U(N,K) values, we could write O(N) encoding
+   and O(min(N*log(K),N+K)) decoding routines, but such a table would be
+   prohibitively large for small embedded devices (K may be as large as 32767
+   for small N, and N may be as large as 200).
+
+  Both functions obey the same recurrence relation:
+    V(N,K) = V(N-1,K) + V(N,K-1) + V(N-1,K-1),
+    U(N,K) = U(N-1,K) + U(N,K-1) + U(N-1,K-1),
+   for all N>0, K>0, with different initial conditions at N=0 or K=0.
+  This allows us to construct a row of one of the tables above given the
+   previous row or the next row.
+  Thus we can derive O(NK) encoding and decoding routines with O(K) memory
+   using only addition and subtraction.
+
+  When encoding, we build up from the U(2,K) row and work our way forwards.
+  When decoding, we need to start at the U(N,K) row and work our way backwards,
+   which requires a means of computing U(N,K).
+  U(N,K) may be computed from two previous values with the same N:
+    U(N,K) = ((2*N-1)*U(N,K-1) - U(N,K-2))/(K-1) + U(N,K-2)
+   for all N>1, and since U(N,K) is symmetric, a similar relation holds for two
+   previous values with the same K:
+    U(N,K>1) = ((2*K-1)*U(N-1,K) - U(N-2,K))/(N-1) + U(N-2,K)
+   for all K>1.
+  This allows us to construct an arbitrary row of the U(N,K) table by starting
+   with the first two values, which are constants.
+  This saves roughly 2/3 the work in our O(NK) decoding routine, but costs O(K)
+   multiplications.
+  Similar relations can be derived for V(N,K), but are not used here.
+
+  For N>0 and K>0, U(N,K) and V(N,K) take on the form of an (N-1)-degree
+   polynomial for fixed N.
+  The first few are
+    U(1,K) = 1,
+    U(2,K) = 2*K-1,
+    U(3,K) = (2*K-2)*K+1,
+    U(4,K) = (((4*K-6)*K+8)*K-3)/3,
+    U(5,K) = ((((2*K-4)*K+10)*K-8)*K+3)/3,
+   and
+    V(1,K) = 2,
+    V(2,K) = 4*K,
+    V(3,K) = 4*K*K+2,
+    V(4,K) = 8*(K*K+2)*K/3,
+    V(5,K) = ((4*K*K+20)*K*K+6)/3,
+   for all K>0.
+  This allows us to derive O(N) encoding and O(N*log(K)) decoding routines for
+   small N (and indeed decoding is also O(N) for N<3).
+
+  @ARTICLE{Fis86,
+    author="Thomas R. Fischer",
+    title="A Pyramid Vector Quantizer",
+    journal="IEEE Transactions on Information Theory",
+    volume="IT-32",
+    number=4,
+    pages="568--583",
+    month=Jul,
+    year=1986
+  }*/
+
+#if !defined(SMALL_FOOTPRINT)
+
+/*U(N,K) = U(K,N) := N>0?K>0?U(N-1,K)+U(N,K-1)+U(N-1,K-1):0:K>0?1:0*/
+# define CELT_PVQ_U(_n,_k) (CELT_PVQ_U_ROW[IMIN(_n,_k)][IMAX(_n,_k)])
+/*V(N,K) := U(N,K)+U(N,K+1) = the number of PVQ codewords for a band of size N
+   with K pulses allocated to it.*/
+# define CELT_PVQ_V(_n,_k) (CELT_PVQ_U(_n,_k)+CELT_PVQ_U(_n,(_k)+1))
+
+/*For each V(N,K) supported, we will access element U(min(N,K+1),max(N,K+1)).
+  Thus, the number of entries in row I is the larger of the maximum number of
+   pulses we will ever allocate for a given N=I (K=128, or however many fit in
+   32 bits, whichever is smaller), plus one, and the maximum N for which
+   K=I-1 pulses fit in 32 bits.
+  The largest band size in an Opus Custom mode is 208.
+  Otherwise, we can limit things to the set of N which can be achieved by
+   splitting a band from a standard Opus mode: 176, 144, 96, 88, 72, 64, 48,
+   44, 36, 32, 24, 22, 18, 16, 8, 4, 2).*/
+#if defined(CWRS_EXTRA_ROWS)
+static const opus_uint32 CELT_PVQ_U_DATA[1488]={
+#else
+static const opus_uint32 CELT_PVQ_U_DATA[1272]={
+#endif
+  /*N=0, K=0...176:*/
+  1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
+  0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
+  0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
+  0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
+  0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
+  0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
+  0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
+#if defined(CWRS_EXTRA_ROWS)
+  /*...208:*/
+  0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
+  0, 0, 0, 0, 0, 0,
+#endif
+  /*N=1, K=1...176:*/
+  1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+  1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+  1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+  1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+  1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+  1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+  1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+#if defined(CWRS_EXTRA_ROWS)
+  /*...208:*/
+  1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+  1, 1, 1, 1, 1, 1,
+#endif
+  /*N=2, K=2...176:*/
+  3, 5, 7, 9, 11, 13, 15, 17, 19, 21, 23, 25, 27, 29, 31, 33, 35, 37, 39, 41,
+  43, 45, 47, 49, 51, 53, 55, 57, 59, 61, 63, 65, 67, 69, 71, 73, 75, 77, 79,
+  81, 83, 85, 87, 89, 91, 93, 95, 97, 99, 101, 103, 105, 107, 109, 111, 113,
+  115, 117, 119, 121, 123, 125, 127, 129, 131, 133, 135, 137, 139, 141, 143,
+  145, 147, 149, 151, 153, 155, 157, 159, 161, 163, 165, 167, 169, 171, 173,
+  175, 177, 179, 181, 183, 185, 187, 189, 191, 193, 195, 197, 199, 201, 203,
+  205, 207, 209, 211, 213, 215, 217, 219, 221, 223, 225, 227, 229, 231, 233,
+  235, 237, 239, 241, 243, 245, 247, 249, 251, 253, 255, 257, 259, 261, 263,
+  265, 267, 269, 271, 273, 275, 277, 279, 281, 283, 285, 287, 289, 291, 293,
+  295, 297, 299, 301, 303, 305, 307, 309, 311, 313, 315, 317, 319, 321, 323,
+  325, 327, 329, 331, 333, 335, 337, 339, 341, 343, 345, 347, 349, 351,
+#if defined(CWRS_EXTRA_ROWS)
+  /*...208:*/
+  353, 355, 357, 359, 361, 363, 365, 367, 369, 371, 373, 375, 377, 379, 381,
+  383, 385, 387, 389, 391, 393, 395, 397, 399, 401, 403, 405, 407, 409, 411,
+  413, 415,
+#endif
+  /*N=3, K=3...176:*/
+  13, 25, 41, 61, 85, 113, 145, 181, 221, 265, 313, 365, 421, 481, 545, 613,
+  685, 761, 841, 925, 1013, 1105, 1201, 1301, 1405, 1513, 1625, 1741, 1861,
+  1985, 2113, 2245, 2381, 2521, 2665, 2813, 2965, 3121, 3281, 3445, 3613, 3785,
+  3961, 4141, 4325, 4513, 4705, 4901, 5101, 5305, 5513, 5725, 5941, 6161, 6385,
+  6613, 6845, 7081, 7321, 7565, 7813, 8065, 8321, 8581, 8845, 9113, 9385, 9661,
+  9941, 10225, 10513, 10805, 11101, 11401, 11705, 12013, 12325, 12641, 12961,
+  13285, 13613, 13945, 14281, 14621, 14965, 15313, 15665, 16021, 16381, 16745,
+  17113, 17485, 17861, 18241, 18625, 19013, 19405, 19801, 20201, 20605, 21013,
+  21425, 21841, 22261, 22685, 23113, 23545, 23981, 24421, 24865, 25313, 25765,
+  26221, 26681, 27145, 27613, 28085, 28561, 29041, 29525, 30013, 30505, 31001,
+  31501, 32005, 32513, 33025, 33541, 34061, 34585, 35113, 35645, 36181, 36721,
+  37265, 37813, 38365, 38921, 39481, 40045, 40613, 41185, 41761, 42341, 42925,
+  43513, 44105, 44701, 45301, 45905, 46513, 47125, 47741, 48361, 48985, 49613,
+  50245, 50881, 51521, 52165, 52813, 53465, 54121, 54781, 55445, 56113, 56785,
+  57461, 58141, 58825, 59513, 60205, 60901, 61601,
+#if defined(CWRS_EXTRA_ROWS)
+  /*...208:*/
+  62305, 63013, 63725, 64441, 65161, 65885, 66613, 67345, 68081, 68821, 69565,
+  70313, 71065, 71821, 72581, 73345, 74113, 74885, 75661, 76441, 77225, 78013,
+  78805, 79601, 80401, 81205, 82013, 82825, 83641, 84461, 85285, 86113,
+#endif
+  /*N=4, K=4...176:*/
+  63, 129, 231, 377, 575, 833, 1159, 1561, 2047, 2625, 3303, 4089, 4991, 6017,
+  7175, 8473, 9919, 11521, 13287, 15225, 17343, 19649, 22151, 24857, 27775,
+  30913, 34279, 37881, 41727, 45825, 50183, 54809, 59711, 64897, 70375, 76153,
+  82239, 88641, 95367, 102425, 109823, 117569, 125671, 134137, 142975, 152193,
+  161799, 171801, 182207, 193025, 204263, 215929, 228031, 240577, 253575,
+  267033, 280959, 295361, 310247, 325625, 341503, 357889, 374791, 392217,
+  410175, 428673, 447719, 467321, 487487, 508225, 529543, 551449, 573951,
+  597057, 620775, 645113, 670079, 695681, 721927, 748825, 776383, 804609,
+  833511, 863097, 893375, 924353, 956039, 988441, 1021567, 1055425, 1090023,
+  1125369, 1161471, 1198337, 1235975, 1274393, 1313599, 1353601, 1394407,
+  1436025, 1478463, 1521729, 1565831, 1610777, 1656575, 1703233, 1750759,
+  1799161, 1848447, 1898625, 1949703, 2001689, 2054591, 2108417, 2163175,
+  2218873, 2275519, 2333121, 2391687, 2451225, 2511743, 2573249, 2635751,
+  2699257, 2763775, 2829313, 2895879, 2963481, 3032127, 3101825, 3172583,
+  3244409, 3317311, 3391297, 3466375, 3542553, 3619839, 3698241, 3777767,
+  3858425, 3940223, 4023169, 4107271, 4192537, 4278975, 4366593, 4455399,
+  4545401, 4636607, 4729025, 4822663, 4917529, 5013631, 5110977, 5209575,
+  5309433, 5410559, 5512961, 5616647, 5721625, 5827903, 5935489, 6044391,
+  6154617, 6266175, 6379073, 6493319, 6608921, 6725887, 6844225, 6963943,
+  7085049, 7207551,
+#if defined(CWRS_EXTRA_ROWS)
+  /*...208:*/
+  7331457, 7456775, 7583513, 7711679, 7841281, 7972327, 8104825, 8238783,
+  8374209, 8511111, 8649497, 8789375, 8930753, 9073639, 9218041, 9363967,
+  9511425, 9660423, 9810969, 9963071, 10116737, 10271975, 10428793, 10587199,
+  10747201, 10908807, 11072025, 11236863, 11403329, 11571431, 11741177,
+  11912575,
+#endif
+  /*N=5, K=5...176:*/
+  321, 681, 1289, 2241, 3649, 5641, 8361, 11969, 16641, 22569, 29961, 39041,
+  50049, 63241, 78889, 97281, 118721, 143529, 172041, 204609, 241601, 283401,
+  330409, 383041, 441729, 506921, 579081, 658689, 746241, 842249, 947241,
+  1061761, 1186369, 1321641, 1468169, 1626561, 1797441, 1981449, 2179241,
+  2391489, 2618881, 2862121, 3121929, 3399041, 3694209, 4008201, 4341801,
+  4695809, 5071041, 5468329, 5888521, 6332481, 6801089, 7295241, 7815849,
+  8363841, 8940161, 9545769, 10181641, 10848769, 11548161, 12280841, 13047849,
+  13850241, 14689089, 15565481, 16480521, 17435329, 18431041, 19468809,
+  20549801, 21675201, 22846209, 24064041, 25329929, 26645121, 28010881,
+  29428489, 30899241, 32424449, 34005441, 35643561, 37340169, 39096641,
+  40914369, 42794761, 44739241, 46749249, 48826241, 50971689, 53187081,
+  55473921, 57833729, 60268041, 62778409, 65366401, 68033601, 70781609,
+  73612041, 76526529, 79526721, 82614281, 85790889, 89058241, 92418049,
+  95872041, 99421961, 103069569, 106816641, 110664969, 114616361, 118672641,
+  122835649, 127107241, 131489289, 135983681, 140592321, 145317129, 150160041,
+  155123009, 160208001, 165417001, 170752009, 176215041, 181808129, 187533321,
+  193392681, 199388289, 205522241, 211796649, 218213641, 224775361, 231483969,
+  238341641, 245350569, 252512961, 259831041, 267307049, 274943241, 282741889,
+  290705281, 298835721, 307135529, 315607041, 324252609, 333074601, 342075401,
+  351257409, 360623041, 370174729, 379914921, 389846081, 399970689, 410291241,
+  420810249, 431530241, 442453761, 453583369, 464921641, 476471169, 488234561,
+  500214441, 512413449, 524834241, 537479489, 550351881, 563454121, 576788929,
+  590359041, 604167209, 618216201, 632508801,
+#if defined(CWRS_EXTRA_ROWS)
+  /*...208:*/
+  647047809, 661836041, 676876329, 692171521, 707724481, 723538089, 739615241,
+  755958849, 772571841, 789457161, 806617769, 824056641, 841776769, 859781161,
+  878072841, 896654849, 915530241, 934702089, 954173481, 973947521, 994027329,
+  1014416041, 1035116809, 1056132801, 1077467201, 1099123209, 1121104041,
+  1143412929, 1166053121, 1189027881, 1212340489, 1235994241,
+#endif
+  /*N=6, K=6...96:*/
+  1683, 3653, 7183, 13073, 22363, 36365, 56695, 85305, 124515, 177045, 246047,
+  335137, 448427, 590557, 766727, 982729, 1244979, 1560549, 1937199, 2383409,
+  2908411, 3522221, 4235671, 5060441, 6009091, 7095093, 8332863, 9737793,
+  11326283, 13115773, 15124775, 17372905, 19880915, 22670725, 25765455,
+  29189457, 32968347, 37129037, 41699767, 46710137, 52191139, 58175189,
+  64696159, 71789409, 79491819, 87841821, 96879431, 106646281, 117185651,
+  128542501, 140763503, 153897073, 167993403, 183104493, 199284183, 216588185,
+  235074115, 254801525, 275831935, 298228865, 322057867, 347386557, 374284647,
+  402823977, 433078547, 465124549, 499040399, 534906769, 572806619, 612825229,
+  655050231, 699571641, 746481891, 795875861, 847850911, 902506913, 959946283,
+  1020274013, 1083597703, 1150027593, 1219676595, 1292660325, 1369097135,
+  1449108145, 1532817275, 1620351277, 1711839767, 1807415257, 1907213187,
+  2011371957, 2120032959,
+#if defined(CWRS_EXTRA_ROWS)
+  /*...109:*/
+  2233340609U, 2351442379U, 2474488829U, 2602633639U, 2736033641U, 2874848851U,
+  3019242501U, 3169381071U, 3325434321U, 3487575323U, 3655980493U, 3830829623U,
+  4012305913U,
+#endif
+  /*N=7, K=7...54*/
+  8989, 19825, 40081, 75517, 134245, 227305, 369305, 579125, 880685, 1303777,
+  1884961, 2668525, 3707509, 5064793, 6814249, 9041957, 11847485, 15345233,
+  19665841, 24957661, 31388293, 39146185, 48442297, 59511829, 72616013,
+  88043969, 106114625, 127178701, 151620757, 179861305, 212358985, 249612805,
+  292164445, 340600625, 395555537, 457713341, 527810725, 606639529, 695049433,
+  793950709, 904317037, 1027188385, 1163673953, 1314955181, 1482288821,
+  1667010073, 1870535785, 2094367717,
+#if defined(CWRS_EXTRA_ROWS)
+  /*...60:*/
+  2340095869U, 2609401873U, 2904062449U, 3225952925U, 3577050821U, 3959439497U,
+#endif
+  /*N=8, K=8...37*/
+  48639, 108545, 224143, 433905, 795455, 1392065, 2340495, 3800305, 5984767,
+  9173505, 13726991, 20103025, 28875327, 40754369, 56610575, 77500017,
+  104692735, 139703809, 184327311, 240673265, 311207743, 398796225, 506750351,
+  638878193, 799538175, 993696769, 1226990095, 1505789553, 1837271615,
+  2229491905U,
+#if defined(CWRS_EXTRA_ROWS)
+  /*...40:*/
+  2691463695U, 3233240945U, 3866006015U,
+#endif
+  /*N=9, K=9...28:*/
+  265729, 598417, 1256465, 2485825, 4673345, 8405905, 14546705, 24331777,
+  39490049, 62390545, 96220561, 145198913, 214828609, 312193553, 446304145,
+  628496897, 872893441, 1196924561, 1621925137, 2173806145U,
+#if defined(CWRS_EXTRA_ROWS)
+  /*...29:*/
+  2883810113U,
+#endif
+  /*N=10, K=10...24:*/
+  1462563, 3317445, 7059735, 14218905, 27298155, 50250765, 89129247, 152951073,
+  254831667, 413442773, 654862247, 1014889769, 1541911931, 2300409629U,
+  3375210671U,
+  /*N=11, K=11...19:*/
+  8097453, 18474633, 39753273, 81270333, 158819253, 298199265, 540279585,
+  948062325, 1616336765,
+#if defined(CWRS_EXTRA_ROWS)
+  /*...20:*/
+  2684641785U,
+#endif
+  /*N=12, K=12...18:*/
+  45046719, 103274625, 224298231, 464387817, 921406335, 1759885185,
+  3248227095U,
+  /*N=13, K=13...16:*/
+  251595969, 579168825, 1267854873, 2653649025U,
+  /*N=14, K=14:*/
+  1409933619
+};
+
+#if defined(CWRS_EXTRA_ROWS)
+static const opus_uint32 *const CELT_PVQ_U_ROW[15]={
+  CELT_PVQ_U_DATA+   0,CELT_PVQ_U_DATA+ 208,CELT_PVQ_U_DATA+ 415,
+  CELT_PVQ_U_DATA+ 621,CELT_PVQ_U_DATA+ 826,CELT_PVQ_U_DATA+1030,
+  CELT_PVQ_U_DATA+1233,CELT_PVQ_U_DATA+1336,CELT_PVQ_U_DATA+1389,
+  CELT_PVQ_U_DATA+1421,CELT_PVQ_U_DATA+1441,CELT_PVQ_U_DATA+1455,
+  CELT_PVQ_U_DATA+1464,CELT_PVQ_U_DATA+1470,CELT_PVQ_U_DATA+1473
+};
+#else
+static const opus_uint32 *const CELT_PVQ_U_ROW[15]={
+  CELT_PVQ_U_DATA+   0,CELT_PVQ_U_DATA+ 176,CELT_PVQ_U_DATA+ 351,
+  CELT_PVQ_U_DATA+ 525,CELT_PVQ_U_DATA+ 698,CELT_PVQ_U_DATA+ 870,
+  CELT_PVQ_U_DATA+1041,CELT_PVQ_U_DATA+1131,CELT_PVQ_U_DATA+1178,
+  CELT_PVQ_U_DATA+1207,CELT_PVQ_U_DATA+1226,CELT_PVQ_U_DATA+1240,
+  CELT_PVQ_U_DATA+1248,CELT_PVQ_U_DATA+1254,CELT_PVQ_U_DATA+1257
+};
+#endif
+
+#if defined(CUSTOM_MODES)
+void get_required_bits(opus_int16 *_bits,int _n,int _maxk,int _frac){
+  int k;
+  /*_maxk==0 => there's nothing to do.*/
+  celt_assert(_maxk>0);
+  _bits[0]=0;
+  for(k=1;k<=_maxk;k++)_bits[k]=log2_frac(CELT_PVQ_V(_n,k),_frac);
+}
+#endif
+
+static opus_uint32 icwrs(int _n,const int *_y){
+  opus_uint32 i;
+  int         j;
+  int         k;
+  celt_assert(_n>=2);
+  j=_n-1;
+  i=_y[j]<0;
+  k=abs(_y[j]);
+  do{
+    j--;
+    i+=CELT_PVQ_U(_n-j,k);
+    k+=abs(_y[j]);
+    if(_y[j]<0)i+=CELT_PVQ_U(_n-j,k+1);
+  }
+  while(j>0);
+  return i;
+}
+
+void encode_pulses(const int *_y,int _n,int _k,ec_enc *_enc){
+  celt_assert(_k>0);
+  ec_enc_uint(_enc,icwrs(_n,_y),CELT_PVQ_V(_n,_k));
+}
+
+static opus_val32 cwrsi(int _n,int _k,opus_uint32 _i,int *_y){
+  opus_uint32 p;
+  int         s;
+  int         k0;
+  opus_int16  val;
+  opus_val32  yy=0;
+  celt_assert(_k>0);
+  celt_assert(_n>1);
+  while(_n>2){
+    opus_uint32 q;
+    /*Lots of pulses case:*/
+    if(_k>=_n){
+      const opus_uint32 *row;
+      row=CELT_PVQ_U_ROW[_n];
+      /*Are the pulses in this dimension negative?*/
+      p=row[_k+1];
+      s=-(_i>=p);
+      _i-=p&s;
+      /*Count how many pulses were placed in this dimension.*/
+      k0=_k;
+      q=row[_n];
+      if(q>_i){
+        celt_sig_assert(p>q);
+        _k=_n;
+        do p=CELT_PVQ_U_ROW[--_k][_n];
+        while(p>_i);
+      }
+      else for(p=row[_k];p>_i;p=row[_k])_k--;
+      _i-=p;
+      val=(k0-_k+s)^s;
+      *_y++=val;
+      yy=MAC16_16(yy,val,val);
+    }
+    /*Lots of dimensions case:*/
+    else{
+      /*Are there any pulses in this dimension at all?*/
+      p=CELT_PVQ_U_ROW[_k][_n];
+      q=CELT_PVQ_U_ROW[_k+1][_n];
+      if(p<=_i&&_i<q){
+        _i-=p;
+        *_y++=0;
+      }
+      else{
+        /*Are the pulses in this dimension negative?*/
+        s=-(_i>=q);
+        _i-=q&s;
+        /*Count how many pulses were placed in this dimension.*/
+        k0=_k;
+        do p=CELT_PVQ_U_ROW[--_k][_n];
+        while(p>_i);
+        _i-=p;
+        val=(k0-_k+s)^s;
+        *_y++=val;
+        yy=MAC16_16(yy,val,val);
+      }
+    }
+    _n--;
+  }
+  /*_n==2*/
+  p=2*_k+1;
+  s=-(_i>=p);
+  _i-=p&s;
+  k0=_k;
+  _k=(_i+1)>>1;
+  if(_k)_i-=2*_k-1;
+  val=(k0-_k+s)^s;
+  *_y++=val;
+  yy=MAC16_16(yy,val,val);
+  /*_n==1*/
+  s=-(int)_i;
+  val=(_k+s)^s;
+  *_y=val;
+  yy=MAC16_16(yy,val,val);
+  return yy;
+}
+
+opus_val32 decode_pulses(int *_y,int _n,int _k,ec_dec *_dec){
+  return cwrsi(_n,_k,ec_dec_uint(_dec,CELT_PVQ_V(_n,_k)),_y);
+}
+
+#else /* SMALL_FOOTPRINT */
+
+/*Computes the next row/column of any recurrence that obeys the relation
+   u[i][j]=u[i-1][j]+u[i][j-1]+u[i-1][j-1].
+  _ui0 is the base case for the new row/column.*/
+static OPUS_INLINE void unext(opus_uint32 *_ui,unsigned _len,opus_uint32 _ui0){
+  opus_uint32 ui1;
+  unsigned      j;
+  /*This do-while will overrun the array if we don't have storage for at least
+     2 values.*/
+  j=1; do {
+    ui1=UADD32(UADD32(_ui[j],_ui[j-1]),_ui0);
+    _ui[j-1]=_ui0;
+    _ui0=ui1;
+  } while (++j<_len);
+  _ui[j-1]=_ui0;
+}
+
+/*Computes the previous row/column of any recurrence that obeys the relation
+   u[i-1][j]=u[i][j]-u[i][j-1]-u[i-1][j-1].
+  _ui0 is the base case for the new row/column.*/
+static OPUS_INLINE void uprev(opus_uint32 *_ui,unsigned _n,opus_uint32 _ui0){
+  opus_uint32 ui1;
+  unsigned      j;
+  /*This do-while will overrun the array if we don't have storage for at least
+     2 values.*/
+  j=1; do {
+    ui1=USUB32(USUB32(_ui[j],_ui[j-1]),_ui0);
+    _ui[j-1]=_ui0;
+    _ui0=ui1;
+  } while (++j<_n);
+  _ui[j-1]=_ui0;
+}
+
+/*Compute V(_n,_k), as well as U(_n,0..._k+1).
+  _u: On exit, _u[i] contains U(_n,i) for i in [0..._k+1].*/
+static opus_uint32 ncwrs_urow(unsigned _n,unsigned _k,opus_uint32 *_u){
+  opus_uint32 um2;
+  unsigned      len;
+  unsigned      k;
+  len=_k+2;
+  /*We require storage at least 3 values (e.g., _k>0).*/
+  celt_assert(len>=3);
+  _u[0]=0;
+  _u[1]=um2=1;
+  /*If _n==0, _u[0] should be 1 and the rest should be 0.*/
+  /*If _n==1, _u[i] should be 1 for i>1.*/
+  celt_assert(_n>=2);
+  /*If _k==0, the following do-while loop will overflow the buffer.*/
+  celt_assert(_k>0);
+  k=2;
+  do _u[k]=(k<<1)-1;
+  while(++k<len);
+  for(k=2;k<_n;k++)unext(_u+1,_k+1,1);
+  return _u[_k]+_u[_k+1];
+}
+
+/*Returns the _i'th combination of _k elements chosen from a set of size _n
+   with associated sign bits.
+  _y: Returns the vector of pulses.
+  _u: Must contain entries [0..._k+1] of row _n of U() on input.
+      Its contents will be destructively modified.*/
+static opus_val32 cwrsi(int _n,int _k,opus_uint32 _i,int *_y,opus_uint32 *_u){
+  int j;
+  opus_int16 val;
+  opus_val32 yy=0;
+  celt_assert(_n>0);
+  j=0;
+  do{
+    opus_uint32 p;
+    int           s;
+    int           yj;
+    p=_u[_k+1];
+    s=-(_i>=p);
+    _i-=p&s;
+    yj=_k;
+    p=_u[_k];
+    while(p>_i)p=_u[--_k];
+    _i-=p;
+    yj-=_k;
+    val=(yj+s)^s;
+    _y[j]=val;
+    yy=MAC16_16(yy,val,val);
+    uprev(_u,_k+2,0);
+  }
+  while(++j<_n);
+  return yy;
+}
+
+/*Returns the index of the given combination of K elements chosen from a set
+   of size 1 with associated sign bits.
+  _y: The vector of pulses, whose sum of absolute values is K.
+  _k: Returns K.*/
+static OPUS_INLINE opus_uint32 icwrs1(const int *_y,int *_k){
+  *_k=abs(_y[0]);
+  return _y[0]<0;
+}
+
+/*Returns the index of the given combination of K elements chosen from a set
+   of size _n with associated sign bits.
+  _y:  The vector of pulses, whose sum of absolute values must be _k.
+  _nc: Returns V(_n,_k).*/
+static OPUS_INLINE opus_uint32 icwrs(int _n,int _k,opus_uint32 *_nc,const int *_y,
+ opus_uint32 *_u){
+  opus_uint32 i;
+  int         j;
+  int         k;
+  /*We can't unroll the first two iterations of the loop unless _n>=2.*/
+  celt_assert(_n>=2);
+  _u[0]=0;
+  for(k=1;k<=_k+1;k++)_u[k]=(k<<1)-1;
+  i=icwrs1(_y+_n-1,&k);
+  j=_n-2;
+  i+=_u[k];
+  k+=abs(_y[j]);
+  if(_y[j]<0)i+=_u[k+1];
+  while(j-->0){
+    unext(_u,_k+2,0);
+    i+=_u[k];
+    k+=abs(_y[j]);
+    if(_y[j]<0)i+=_u[k+1];
+  }
+  *_nc=_u[k]+_u[k+1];
+  return i;
+}
+
+#if defined(CUSTOM_MODES)
+void get_required_bits(opus_int16 *_bits,int _n,int _maxk,int _frac){
+  int k;
+  /*_maxk==0 => there's nothing to do.*/
+  celt_assert(_maxk>0);
+  _bits[0]=0;
+  if (_n==1)
+  {
+    for (k=1;k<=_maxk;k++)
+      _bits[k] = 1<<_frac;
+  }
+  else {
+    VARDECL(opus_uint32,u);
+    SAVE_STACK;
+    ALLOC(u,_maxk+2U,opus_uint32);
+    ncwrs_urow(_n,_maxk,u);
+    for(k=1;k<=_maxk;k++)
+      _bits[k]=log2_frac(u[k]+u[k+1],_frac);
+    RESTORE_STACK;
+  }
+}
+#endif /* CUSTOM_MODES */
+
+void encode_pulses(const int *_y,int _n,int _k,ec_enc *_enc){
+  opus_uint32 i;
+  VARDECL(opus_uint32,u);
+  opus_uint32 nc;
+  SAVE_STACK;
+  celt_assert(_k>0);
+  ALLOC(u,_k+2U,opus_uint32);
+  i=icwrs(_n,_k,&nc,_y,u);
+  ec_enc_uint(_enc,i,nc);
+  RESTORE_STACK;
+}
+
+opus_val32 decode_pulses(int *_y,int _n,int _k,ec_dec *_dec){
+  VARDECL(opus_uint32,u);
+  int ret;
+  SAVE_STACK;
+  celt_assert(_k>0);
+  ALLOC(u,_k+2U,opus_uint32);
+  ret = cwrsi(_n,_k,ec_dec_uint(_dec,ncwrs_urow(_n,_k,u)),_y,u);
+  RESTORE_STACK;
+  return ret;
+}
+
+#endif /* SMALL_FOOTPRINT */