Alterator/module/debug: различия между версиями

Версия от 18:20, 7 ноября 2008

Отладка модулей

Работа с модулем без установки в систему

Все компоненты alterator используют особые переменные среды для определения местоположения основных рабочих каталогов:

Переменная	Значение по умолчанию	Описание
ALTERATOR_LIBDIR	/usr/lib/alterator	бэкенды и иные архитектурно-зависимые компоненты.
ALTERATOR_DATADIR	/usr/share/alterator	описания интерфейсов и иные архитектурно-независимые компоненты.
ALTERATOR_DEBUG		сигнализирует что система находится в режиме отладки

Для обоих переменных допустимо перечисление нескольких каталогов через двоеточие - в этом случае поиск производится последовательно в порядке указания имён. Например, если ALTERATOR_DATADIR="/a:/b", то файл ui.scm будет искаться сначала по адресу /a/ui.scm, а потом /b/ui.scm.

Для удобства использования у утилит командной строки alterator существует ключ '-l', который добавляет текущий каталог в начало списка в переменные ALTERATOR_LIBDIR и ALTERATOR_DATADIR.

Таким образом, находясь в модуле, можно отлаживать и запускать его не устанавливая в систему.

Интерфейс	Команда запуска
Командная строка	`alterator-cmdline -l <запрос>`
Графический интерфейс	`/usr/sbin/alterator-standalone -l <имя desktop-файла описания>`
Web-интерфейс	`/usr/sbin/configd -l`

В последнем варианте сервер configd не будет отцепляться от терминала и будет работать с локальными бэкендами и файлами шаблонов. Для старой системы шаблонов (template-*), дополнительно существует переменная ALTERATOR_HTMLDIR, которая модифицируется при использовании '-l' аналогично остальным переменным.

alterator-standalone следует запускать с указанием /usr/sbin, поскольку утилита consolehelper (/usr/bin/alterator-standalone ссылается на неё) изменяет состав переменных окружения.

Интерфейс командной строки

Утилита alterator-cmdline служит для выполнения запросов к бакендам из интерфейса командой строки и может с успехом использоваться для написания скриптов. Параметр -l позволяет работать с локальными бакендами, а параметр -k указывает выводить значения конкретного параметра.

Пример:

# alterator-cmdline /users/stas action read

gecos:Stanislav I. Ievlev
home:/home/stas
shell:/bin/bash
allow_su:#t

# alterator-cmdline /users/stas action read -k home
/home/stas

#alterator-cmdline /net-eth action list 

name:eth0
label:eth0

name:eth1
label:eth1
# alterator-cmdline /net-eth action list -k name
eth0
eth1

@@ Строка 7: / Строка 7: @@
 Все компоненты alterator используют особые переменные среды для определения местоположения основных рабочих каталогов:
 {| class="standard"
-!переменная
+!Переменная
-!значение по умолчанию
+!Значение по умолчанию
-!описание
+!Описание
 |-
 |ALTERATOR_LIBDIR
 |/usr/lib/alterator
-|бакенды и иные архитектурно-зависимые компоненты.
+|бэкенды и иные архитектурно-зависимые компоненты.
 |-
 |ALTERATOR_DATADIR
 |/usr/share/alterator
 |описания интерфейсов и иные архитектурно-независимые компоненты.
 |-
 |ALTERATOR_DEBUG
 |
 |сигнализирует что система находится в режиме отладки
 |}
@@ Строка 35: / Строка 30: @@
 Таким образом, находясь в модуле, можно отлаживать и запускать его не устанавливая в систему.
 {| class="standard"
-!интерфейс
+!Интерфейс
-!команда запуска
+!Команда запуска
 |-
+|Командная строка
-|командная строка
+|<tt>alterator-cmdline -l <запрос></tt>
-|alterator-cmdline -l &lt;запрос&gt;
 |-
+|Графический интерфейс
-|графический интерфейс
+|<tt>/usr/sbin/alterator-standalone -l <имя desktop-файла описания></tt>
-|/usr/sbin/alterator-standalone -l &lt;имя desktop-файла описания&gt;
 |-
 |Web-интерфейс
-|/usr/sbin/configd -l
+|<tt>/usr/sbin/configd -l</tt>
 |-
 |}
-Во последнем варианте сервер configd не будет отцепляться от терминала и будет работать с локальными бакендами и файлами шаблонов. Для старой системы шаблонов (template-*), дополнительно существует переменная '''ALTERATOR_HTMLDIR''', которая модифицируется при использовании '-l' аналогично остальным переменным.
+В последнем варианте сервер configd не будет отцепляться от терминала и будет работать с локальными бэкендами и файлами шаблонов. Для старой системы шаблонов (template-*), дополнительно существует переменная '''ALTERATOR_HTMLDIR''', которая модифицируется при использовании '-l' аналогично остальным переменным.
 alterator-standalone '''следует запускать''' с указанием /usr/sbin, поскольку утилита consolehelper (/usr/bin/alterator-standalone ссылается на неё) изменяет состав переменных окружения.