Alterator-manager: различия между версиями

Версия от 10:40, 19 июня 2024

Данная страница находится в разработке.
Эта страница ещё не закончена. Информация, представленная здесь, может оказаться неполной или неверной.

Alterator-manager — это сервис для управления операционной системой через D-Bus. Его функционал реализуется в модулях, а интерфейс описывается в специальных конфигурационных файлах.

Является компонентом новой реализации проекта Альтератор, Alterator на D-Bus.

Запуск

Alterator-manager может быть запущен в двух режимах — обычном и пользовательском:

$ systemctl start alterator-manager.service

или

$ systemctl --user start alterator-manager.service

В первом случае сервис запускается с полномочиями суперпользователя (root) и регистрирует имя (ru.basealt.alterator) на системной шине D-Bus. Во втором случае сервис запускается от обычного пользователя и регистрирует имя на сессионной шине D-Bus. После запуска происходит считывание конфигурационных файлов из /usr/share/alterator/backends/ и загрузка модулей из /usr/libexec/alterator/. Конфигурационные файлы — это glibовские key-value файлы, они должны иметь расширение .backend для обычного режима работы и .user.backend для пользовательского. На их основе формируется интроспекция для D-Bus и правила polkit (только в обычном режиме).

Спецификация

Документация представлена на странице проекта.

Пример

Создадим example.backend

[Alterator Entry]
Type = Backend
Module = executor
Name = example
Interface = example
#Interface = ru.basealt.alterator.example //Интерфейс можно задать полным именем.
thread_limit = 5
action_id = org.freedesktop.test

[hexdump]
execute = hexdump -C {param}
stdout_strings = enabled
stdout_strings_limit = 7000000
thread_limit = 3

В этом примере мы получаем вывод (stdout) запускаемой команды массивом строк, но вывод мы можем получать и в виде массива байт.

Запустим наш сервис и посмотрим на дерево D-Bus:

Объект /ru/basealt/alterator/example
Интерфейс ru.basealt.alterator.example

Метод hexdump возвращает массив строк из stdout. Выполним метод hexdump.

Таким образом, можно сформировать backend для какого-либо приложения с API на D-Bus.

@@ Строка 1: / Строка 1: @@
+[[Category:Sisyphus]]
+{| style="border:1px solid #AAA; background:#F9F9F9; width:200px; margin: 0 0 1em 1em; padding:.2em; text-align:center; float: right;" class=noprint
+|-
+|[[Image:stub.png]]
+|-
+| '''Данная страница находится в [[:Категория:Неоконченные страницы|разработке]]'''.<br /><small style="line-height:1.1em;">Эта страница ещё не закончена. Информация, представленная здесь, может оказаться неполной или неверной.</small>
+|}
+<includeonly>[[Категория:Неоконченные страницы|{{PAGENAME}}]]</includeonly>
+<noinclude>[[Категория:Шаблоны|{{PAGENAME}}]]</noinclude>
 '''Alterator-manager''' — это сервис для управления операционной системой через D-Bus. Его функционал реализуется в модулях, а интерфейс описывается в специальных конфигурационных файлах.