модульные файлы Linux

Определяют поведение модулей (units) - сущностей, которыми управляет менеджер systemd. В качестве модуля может быть служба, сокет, устройство, точка монтирования, точка автоматического монтирования, файл или раздел подкачки, цель запуска, просматриваемый файловый путь, таймер, управляемый systemd, часть ресурса управления, группа созданных извне процессов.

bad - проблема с модульным файлом.

disabled - модульный файл присутствует в системе, но не настроен для автономного запуска. Применяется только к модульным файлам, которые находятся в одном из системных каталогов systemd.

enabled - модульный файл инсталлирован и запущен. Стартует автономно. Применяется только к модульным файлам, которые находятся в одном из системных каталогов systemd.

indirect - модульный файл отключен, но имеет одинаковые значения в разделах Also, которые могут быть включены.

linked - модульный файл доступен через символическую ссылку. Создавался командой systemctl link. Такие модульные файлы могут обрабатываться командами или указываться в качестве зависимостей, но они не являются полноправными элементами системы и имеют некоторые заметные отклонения. Например, применение команды systemctl.

disable к модульному файлу в состоянии linked приводит к удалению связи и всех ссылок на него.

masked - нежелательный статус с логической точки зрения. Означает "заблокирован администратором". Менеджер systemd знает о модуле, но ему запрещено активировать его или действовать по любой из ero конфигурационных директив с помощью команды systemctl mask. В этом случае следует отключить модули, находящиеся в состоянии enabled или linked, с помощью команды systemctl disable и зарезервировать команду systemctl mask для модулей в состоянии static.

static - зависит от другого устройства. Не требует установки. Это состояние характерно для тех модулей, у которых нет процедуры инсталляции. Запускаются они вручную, либо указываются в качестве зависимостей от других активных модулей.

.automount - автоматически присоединяемое устройство.

.device - устройство, которое распознало ядро ОС.

.path - путь.

.scope- процесс, созданный извне.

.service - собственно сервис (служба).

.slice - группа иерархически организованных юнитов, управляющая системными процессами.

.snapshot – сохраненное состояние менеджера systemd.

.socket - сокет.

.swap – файл подкачки.

.target - цель запуска (она же - уровень). Предназначены для группировки вместе других юнитов systemd через цепочку зависимостей.

.timer - таймер systemd.

.mount - присоединяемое устройство.

After= # Указывает после запуска каких модулей (приоритетный модуль) должен запуститься данный модуль (зависимый). Возможно указание нескольких переменных After с приоритетными модулями.

  After=syslog.target # Данный модуль будет запущен после запуска syslog.target

  After=network.target remote-fs.target nss-lookup.target # Можно указать несколько модулей, разделяя их имена пробелами

Before=syslog.target

Conflicts=shutdown.target

Description=текстовое описание

DefaultDependencies = true # По умолчанию. Systemd делает некоторые предположения о нормальном поведении большинства видов модулей. systemd предполагает, что среднестатистическая служба является надстройкой, которая не должна запускаться на ранних этапах инициализации системы.

DefaultDependencies = false # отключает запуск модуля на раннем этапе инициализации ОС.

Documentation=

Wants= # Модули, которые должны быть активированы одновременно, если это возможно, но не обязательно.

Requires= # Строгие зависимости; отказ от каких-либо предварительных условий прекращает работу этой службы.

Requisite= # Аналогично Requires, но модуль должен быть активным.

BindsTo= # Аналогично Requires, но модуль должен быть связан еще более тесно.

PartOf= # Аналогично Requires, но влияет только на запуск и остановку.

Conflicts= # Отрицательные зависимости; не может взаимодействовать с этими единицами.

PathExists=

Enviroment= # Определяет переменные окружения.

EnviromentFile=

ExecStart= # Запуск модуля. Указывается полный путь файлу модуля.

ExecStop= # Остановка модуля. Указывается полный путь файлу модуля.

ExecReload= # Перезапуск модуля. Указывается полный путь файлу модуля.

Group=Zabbix # Группа пользователей, под которой будет запущен модуль.

KillMode=

OOMScoreAdjust=# вероятность (числовое значение 0-1000) отключения модуля, если не хватает памяти. 1000 - отключить модуль.

PIDFile=/run/program_name/program_name.pid # Путь к pid-файлу, который хранит идентификационный номер запускаемого модуля.

RemainAfterExit=Yes

Requires=service.service # для запуска данного модуля требуется чтобы была запущена служба service.

Restart= # при каких условиях перезапускается модуль. always - всегда, on-failure - при ошибке.

RestartSec=

SuccessExitStatus=

TimeoutSec= # время ожидания (секунды) выполнения команд ExecStart и ExecStop.

TimeoutStopSec= # время ожидания (секунды) за которое модуль должен завершить свою работу, прежде, чем systemd заставит его это сделать принудительно.

Type= # способ запуска модуля.
  Type=simple # немедленный запуск (по-умолчанию) [не рекомендуется, если другие службы зависят от очередности при запуске данной службы].

  Type=forking # запуск службы с разветвлением ее процессов и завершением родительского процесса. Команда запуска должна завершиться, даже если демон продолжает работать в фоновом режиме. Systemd не будет непосредственно запускать демона, тот записывает свой PID (идентификатор процесса) в указанном PIDFile, чтобы systemd мог определить, какой процесс является основным экземпляром демона.

  Type=notify

  Type=oneshot

User= # Пользователь, под которым будет запущен модуль.

Wants= # для запуска данного модуля рекомендуется другой модуль. Название модуля.

WorkingDirectory= # определяет рабочую папку модуля.

Alias=

WantedBy= # уровень запуска модуля (7 уровней). multi-user.target - многопользовательский уровень.

Для создания собственного модуля достаточно трех разделов - [Unit], [Service], [Install].

Ссылки: