Alteratorctl

alteratorctl — консольное приложение, предназначенное для вызова методов интерфейсов, разработанных в рамках Alterator на D-Bus.

Назначение

Программа alteratorctl предназначена для:

1. Системных администраторов.
2. Опытных пользователей.

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

Установка

Команды установки Alteratorctl

# apt-get update
# apt-get install alteratorctl

Описание модулей

Приложение имеет модульную структуру. Каждый модуль предназначен для работы с определенным интерфейсом объектов на D-Bus.

Запуск модуля:

$ alteratorctl <имя_модуля> <команда_модуля>

Отображение возможностей модуля:

$ alteratorctl <имя_модуля> --help

Отображение списка модулей:

$ alteratorctl -m

В настоящий момент реализовано 6 модулей:

1. manager

   Использует интерфейс org.altlinux.alterator.manager объекта /org/altlinux/alterator.

   Более подробную информацию о возможностях модуля можно найти на соответствующей странице: Модуль Alteratorctl — manager

2. editions

   Более подробную информацию о возможностях модуля можно найти на соответствующей странице: Модуль Alteratorctl — editions

3. components

   Более подробную информацию о возможностях модуля можно найти на соответствующей странице: Модуль Alteratorctl — components

4. diag

   Использует интерфейс org.altlinux.alterator.diag1 объектов установленных инструментов диагностики.

   Более подробную информацию о возможностях модуля можно найти на соответствующей странице: Модуль Alteratorctl — diag

5. packages

   Использует интерфейсы org.altlinux.alterator.rpm1, org.altlinux.alterator.apt1, org.altlinux.alterator.repo объектов org/altlinux/alterator/rpm, /org/altlinux/alterator/apt, /org/altlinux/alterator/repo соответственно.

   Более подробную информацию о возможностях модуля можно найти на соответствующей странице: Модуль Alteratorctl — packages

6. systeminfo

   Использует интерфейс org.altlinux.alterator.systeminfo1 объекта org/altlinux/alterator/systeminfo.

   Более подробную информацию о возможностях модуля можно найти на соответствующей странице: Модуль Alteratorctl — systemctl

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

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

Пример

Опишем типовой внутренний модуль alteratorctl и архитектуру модуля.

Внутренний клиентский модуль - объект класса, реализующего интерфейс AlteratorCtlModuleInterface по принципу, принятому в GLib для объектно-ориентированного программирования.

Интерфейс AlteratorCtlModuleInterface предполагает, что в модуле должны быть реализованы 3 метода:

• run_with_args - запуск модуля с параметрами командной строки;
• run - запуск модуля с контекстом;
• print_help - вывод справки об использовании модуля.

Регистрация модуля

Модуль в alteratorctl необходимо зарегистрировать перед его использованием. Регистрация модуля осуществляется вызовом метода alterator_ctl_register_module() у объекта app типа AlteratorCtlApp в функции main.

В функцию передается указатель на объект типа AlteratorCtlApp, где происходит регистрация, и на структуру типа alterator_ctl_module_t, в которой есть указатели на конструкторы, деструкторы и id модуля.

Id модуля

Id модуля представляет собой указатель на строку, содержащую имя модуля. Именно по имени модуля alteratorctl понимает, какой модуль запустить. Модуль указывается первым после общих ключей alteratorctl в командной строке.

Например,

$ alteratorctl -v manager help

где
* -v - общий для модулей параметр
* manager - имя (id) запускаемого модуля
* help - подкоманда для модуля manager.

Конструктор модуля

Конструктор модуля - функция, возвращающая указатель на AlteratorCtlComponentsModule. Конструктор модуля принимает в виде параметров:

• указатель на AlteratorCtlApp, в котором зарегистрирован модуль;
• указатель на структуру типа alteratorctl_arguments_t, которая содержит общие для всех модулей параметры.

Деструктор

Деструктор - функция в структуре alterator_ctl_module_t. Принимает указатель на экземпляр класса внутреннего модуля, ресурсы которого будут освобождены.

Создание контекста модуля

1. Метод run_with_args

   Этот метод запускает модуль, передавая ему параметры командной строки. Обычно в этом методе происходит парсинг аргументов командной строки, создается контекст модуля. И этот контекст передается в метод run.

2. Метод run

   Метод run принимает контекст модуля и непосредственно выполняет необходимые запросы на D-Bus. Модуль должен быть выполнен таким образом, чтобы его можно было вызвать из другого модуля при инициализации контекста модуля. После выполнения метода run, контекст необходимо освободить специализированной функцией.

3. Метод print _help

   Выводит в stdout описание команд и параметров командной строки модуля.