3.2 KiB

Raw Blame History

utun.c — Главная точка входа

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

Точка входа процесса uTun. Парсинг CLI, запуск в режиме демона, создание и жизненный цикл корневого инстанса UTUN_INSTANCE, главный цикл обработки событий mainloop(), обработка сигналов (graceful shutdown/reload).

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

utun -f -c myconfig.conf -p /var/run/utun.pid -l /var/log/utun.log -d "etcp=debug"

-f — foreground (без демонизации)
-c — путь к конфигу (по умолчанию utun.conf)
-p — PID-файл (по умолчанию /var/run/utun.pid, Windows — нет)
-l — лог-файл (по умолчанию utun.log)
-d — отладочная конфигурация (формат: категория=уровень,...)
-h — справка

Порядок запуска:

Парсинг аргументов → инициализация системы отладки
uasync_create() → utun_instance_create() → utun_instance_init()
Демонизация (fork+setsid) если не -f
Запись PID-файла
mainloop: uasync_poll(ua, 100) в цикле пока instance->running
По SIGTERM/SIGINT: g_shutdown=1 → выход из цикла → utun_instance_destroy() → uasync_destroy() → u_report_unfreed_blocks()
По SIGHUP: g_reload=1 → utun_instance_reload() (селективный или полный)

3. API

Функции

Функция	Описание
`parse_args(argc, argv, args)`	Разбор CLI-аргументов через `getopt_long`, заполняет `cmd_args_t`
`print_usage(progname)`	Вывод справки по использованию
`write_pidfile(pidfile)`	Запись PID текущего процесса в файл
`remove_pidfile(pidfile)`	Удаление PID-файла при завершении
`daemonize()`	Демонизация: `fork()`→родитель выходит, `setsid()`, перенаправление fd 0/1/2 в `/dev/null`
`open_logfile(logfile)`	Открытие лог-файла с line-buffering
`signal_handler(sig)`	Обработчик: `SIGINT`/`SIGTERM`→shutdown, `SIGHUP`→reload, вызов `uasync_wakeup()`
`main(argc, argv)`	Главная функция: инициализация, демонизация, mainloop, cleanup

Структуры

Структура	Описание
`cmd_args_t`	Аргументы командной строки: config_file, pid_file, log_file, debug_config, foreground, help

Глобальные переменные

Переменная	Описание
`g_shutdown` (sig_atomic_t)	Флаг завершения, выставляется из signal handler
`g_reload` (sig_atomic_t)	Флаг перезагрузки конфига по SIGHUP
`main_ua`	Указатель на главный UASYNC (для signal handler)

3.2 KiB Raw Blame History