7.2 KiB

Raw Blame History

Config Parser (config_parser.c/h)

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

INI-style парсер конфигурационного файла uTun. Читает текстовый конфиг, разбирает его на структуры и возвращает заполненный struct utun_config — корневое представление всех настроек.

Поддерживает два режима входа:

parse_config(filename) — чтение из файла
parse_config_from_buf(buf, len, filename) — чтение из буфера (для chatgui/in-memory использования)

Формат: стандартные .ini-секции [section], строки key=value, комментарии #. Именованные секции через двоеточие: [server:main], [client:peer1], [network:mynet].

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

struct utun_config *cfg = parse_config("/etc/utun/config.ini");
if (!cfg) { /* ошибка — смотри логи DEBUG_CATEGORY_CONFIG */ }

// Работа с конфигом...
const char *tun_name = cfg->global.tun_ifname;
struct CFG_SERVER *srv = cfg->servers;
while (srv) {
    ip_str_t addr = sockaddr_storage_to_str(&srv->ip);
    srv = srv->next;
}

// Освобождение
free_config(cfg);

Нюансы:

parse_config возвращает NULL при ошибках открытия/парсинга — проверяй возврат.
Все строковые поля обрезаются по размерам буфера, переполнение логируется.
Ключи клиента link требуют, чтобы сервер ([server:имя]) был объявлен выше по файлу. Иначе ошибка.
tun_enabled по умолчанию 1; если задан tun_ifname или tun_ip — генерируется имя tun0 при отсутствии. Если нет ни одного TUN-параметра — считается выключенным (режим без root).
IPv6-адреса в [server:...] addr поддерживают префиксы temporary_ipv6: и permanent_ipv6:.

3. API

Структуры

Структура	Назначение
`struct utun_config`	Корневой контейнер: `global` + связные списки `servers`, `clients`, `route_subnets`, `my_subnets`, `networks`
`struct global_config`	Глобальные настройки (ключи, TUN, таймауты, firewall, NAT, SOCKS/HTTP-прокси, NTP, debug, allowed_keys...)
`struct CFG_SERVER`	Локальный серверный линк: `addr` (ip:port), `netif_index`, `so_mark`, `fib`, `type`, `transport` (udp/tcp), `mtu`, `only_local`
`struct CFG_CLIENT`	Удалённый пир: `peer_public_key_hex`, `keepalive`, связный список `links`
`struct CFG_CLIENT_LINK`	Привязка клиента к локальному серверу: `local_srv` (указатель на `CFG_SERVER`), `remote_addr`
`struct CFG_ROUTE_ENTRY`	Маршрут: `IP` + `netmask`
`struct CFG_NETWORK`	Именованная сеть: `id` (56-bit), `pubkey_hex`, `signing_key_hex`
`struct CFG_FIREWALL_RULE`	Правило фаервола: `ip` (host order), `port`, `bypass`
`struct CFG_ALLOWED_KEY`	Разрешённый публичный ключ (32 байта binary) для контрольного сервера
`struct CFG_CONTROL_ALLOW`	Разрешённая подсеть для control-сервера
`struct CFG_NTP_SERVER`	NTP-сервер: имя хоста

Секции конфига

Секция	Обработчик	Ключевые поля
`[global]`	`parse_global()`	`my_node_name`, `my_private_key`, `my_public_key`, `my_node_id`, `tun_ifname`, `tun_ip`, `mtu`, `keepalive_`, `bbr_max_cwnd`, `debug_level`, `log_file`, `db_path`, `db_sync_`, `enable_timestamp`, `enable_colors`, `tun_test_mode`
`[server:name]`	`parse_server()`	`addr`, `so_mark`, `fib`, `netif`, `type` (public/nat/private/local), `transport` (udp/tcp), `mtu`, `only_local`
`[client:name]`	`parse_client()`	`link` (формат: `server_name:ip:port`), `peer_public_key`, `keepalive`
`[network:name]`	`parse_network()`	`id` (hex), `pubkey`, `signing_key`
`[routing]`	inline	`route_subnet`, `my_subnet`
`[firewall]`	`parse_firewall_rule()`	`allow` (IP:port или `all` для bypass)
`[control]`	`parse_control()`	`ip`, `port`, `allow` (подсеть)
`[allowed_keys]`	inline	`allow_all`, `key` (64 hex)
`[nat]`	`parse_nat()`	`tun_ifname`, `tun_ip`, `nat_via`, `port_start`, `port_end`, `forward` (proto:ip:in_port:ext_port)
`[tcp_proxy_client]`	`parse_tcp_proxy_client()`	`enabled`, `tun_name`, `tun_ip`, `mtu`, `via_node`, `socks_`, `http_proxy_`, `forward` (port -> ip:port)
`[tcp_proxy_server]`	inline	`tcp_recv_buf`
`[ntp]`	inline	`enabled`, `server`, `interval`
`[gui]`	игнорируется	(зарезервировано)

Функции

Функция	Назначение
`parse_config(filename)`	Открывает файл, парсит через `parse_config_internal`, возвращает `utun_config*`. `NULL` при ошибке.
`parse_config_from_buf(buf, len, filename)`	Парсит конфиг из буфера (in-memory). `filename` используется только для сообщений об ошибках.
`free_config(config)`	Рекурсивно освобождает все связные списки и сам `utun_config`. Безопасен для `NULL`.
`print_config(config)`	Выводит всё содержимое конфига через `DEBUG_INFO(DEBUG_CATEGORY_CONFIG, ...)`. Полезно для проверки после парсинга.
`update_config_keys(filename, priv_key, pub_key)`	Устарела. Дописывает ключи в конец файла. Используй `config_ensure_keys_and_node_id()` из `config_updater.h`.

Внутренние хелперы (static)

Функция	Назначение
`trim(str)`	Обрезает пробелы слева и справа (in-place)
`parse_key_value(line, ...)`	Разбирает строку `key=value`, удаляет комментарии после `#`
`parse_ip_with_netmask(str, ip, netmask)`	Парсит `1.2.3.4/24` или `::1/64` в `struct IP`
`parse_sockaddr(addr, port, sockaddr)`	Преобразует адрес+порт в `sockaddr_storage` через `getaddrinfo`
`parse_address_and_port(str, sockaddr)`	Разбирает строку `ip:port` → вызов `parse_sockaddr`
`get_netif_index(ifname)`	Получает индекс сетевого интерфейса через `if_nametoindex`
`parse_firewall_rule(rule_str, global)`	Парсит `allow=IP[:port]` или `all`
`parse_control_allow(rule_str, global)`	Парсит `allow=IP[/CIDR]`
`hex_to_binary(hex_str, binary, len)`	Конвертит hex-строку в бинарный массив

7.2 KiB Raw Blame History