====== Общее ======
Настройка инструмента осуществляется через стандартный файл ''rc.conf'' и может быть выполнена через утилиту ''sysrc''. Однако, при возможном использовании инструмента под запуск нескольких приложений рекомендуется использовать файл ''/etc/rc.conf.d/appdaemon''. Это позволит контролировать параметры приложения в одном месте.
====== Параметры ======
Инструмент поддерживает профили. Для их активации необходимо в соответствующем параметре, указанном ниже, перечислить через пробел имена профилей. Следует помнить, что эти имена будут использоваться далее в именах параметров, поэтому не следует делать их длинными, сложными, либо использовать недопустимые в именах переменных ''shell'' символы.
Если параметр ниже указан, как использующийся в профиле приложения, то он может быть записан в форме:
appdaemon_${profile}_${param_name}
Где:
* ''${profile}'' - имя профиля приложения
* ''${param_name}'' - имя параметра из таблицы ниже, без префикса ''appdaemon_''
Например, для профиля ''a'' и параметра ''appdaemon_app'' его форма в профиле будет выглядеть:
appdaemon_a_app
===== Список параметров =====
^ Имя ^ Тип ^ Можно использовать в профиле ^ Описание ^ Значение по умолчанию ^
| ''appdaemon_enable'' | ''bool'' | 🚫️ | Включение демона | ''NO'' |
| ''appdaemon_piddir'' | ''path'' | 🚫️ | Директория, в которую сохраняются pid-файлы, порождаемые инструментом для контроля демонизируемых приложения | ''/var/run/appdaemon'' |
| ''appdaemon_pidfile'' | ''path'' | ✅️ | Имя pid-файла контролирующего процесса | ''/var/run/appdaemon/${appName}.pid'' |
| ''appdaemon_app_pidfile'' | ''path'' | ✅️ | Имя pid-файла контролируемого процесса | ''/var/run/appdaemon/${appName}.app.pid'' |
| ''appdaemon_user'' | ''str'' | ✅️ | Имя пользователя или UID, от имени которого будет работать приложение | ''nobody'' |
| ''appdaemon_app'' | ''path'' | ✅️ | Исполнимый файл приложения. При использовании скрипта, в этом месте должен быть исполнимый файл интерпретатора данного скрипта. | Пустая строка |
| ''appdaemon_chdir'' | ''path'' | ✅️ | Перед запуском приложения, эта директория станет текущей | ''/tmp'' |
| ''appdaemon_app_flags'' | ''str'' | ✅️ | Флаги приложения, либо имя скрипта с параметрами, если к запуску предполагается скрипт. | Пустая строка |
| ''appdaemon_syslog_ident'' | ''srt'' | ✅️ | Тег, с которым будет отправляться в syslog стандартные потоки вывода и ошибок приложения. | Пустая строка |
| ''appdaemon_profiles'' | ''str'' | 🚫️ | Разделённые пробелами имена профилей приложения | Пустая строка |
^ Тонкая настройка демонизатора ^^^^^
| ''appdaemon_self'' | ''path'' | ✅️ | Имя процесса демонизатора | ''/usr/sbin/daemon'' |
| ''appdaemon_flags'' | ''srt'' | ✅️ | Параметры запуска демонизатора, если необходимы дополнительные параметры. Поиск параметров можно вести на странице документации в [[https://man.freebsd.org/cgi/man.cgi?query=daemon&sektion=0|man daemon]] | ''-fr'' |