http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug History/revisions of FreeSource/AltLinux/Sisyphus/Alterator/debug en-us http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug/show?time=2008-06-03+14%3A10%3A53 <div class="pageBefore"><img src="http://freesource.info/wiki/images/z.gif" width="1" height="1" border="0" alt="" style="display:block" align="top" /></div><div class="page"> <b>Сравнение версий <a name=".altlinux.sisyphus.alterator.debug" href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Sisyphus&nbsp;/&nbsp;Alterator&nbsp;/&nbsp;debug</a> за <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug?time=2008-06-03+14%3A10%3A53">2008-06-03 14:10:53</a> и <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug">2008-06-23 13:00:58</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions"><div class="action" style="float:right; width:250px"><div class="action-content">Эта&nbsp;страница была перенесена на&nbsp;<a href="http://altlinux.org/Alterator/debug" target="_blank" title="" class="outerlink">altlinux.org</a>. Текст на&nbsp;freesource.info заморожен.</div></div></div><br /> <b>Удалено:</b><br /> <div class="deletions"><a name="h5528-1"></a><h3>Работа с&nbsp;модулем без&nbsp;установки в&nbsp;систему</h3> Все&nbsp;компоненты alterator используют особые переменные среды для&nbsp;определения местоположения основных рабочих каталогов:<br /> <ul><li> <strong>ALTERATOR_LIBDIR</strong> &mdash; бакенды и&nbsp;иные архитектурно-зависимые компоненты. Значение по&nbsp;умолчанию &ndash; <em>/usr/lib/alterator</em> </li><li> <strong>ALTERATOR_DATADIR</strong> &mdash; описания интерфейсов и&nbsp;иные архитектурно-независимые компоненты. Значение по&nbsp;умолчанию &ndash; <em>/usr/share/alterator</em>.</li></ul> Для&nbsp;обоих переменных допустимо перечисление нескольких каталогов через двоеточие &ndash; в&nbsp;этом случае поиск производится последовательно в&nbsp;порядке указания имён. Например, если <strong>ALTERATOR_DATADIR="/a:/b"</strong>, то&nbsp;файл <em>ui.scm</em> будет искаться сначала по&nbsp;адресу <em>/a/ui.scm</em>, а&nbsp;потом <em>/b/ui.scm</em>.<br /> Для&nbsp;удобства использования у&nbsp;утилит командной строки alterator существует ключ '-l', который добавляет текущий каталог в&nbsp;начало списка каталогов в&nbsp;ALTERATOR_LIBDIR и&nbsp;ALTERATOR_DATADIR.<br /> Таким образом, находясь в&nbsp;модуле, можно отлаживать и&nbsp;запускать его&nbsp;не&nbsp;устанавливая в&nbsp;систему.<br /> <ul><li> <strong>командная строка</strong>: <em>alterator-cmdline -l &lt;запрос&gt;</em> </li><li> <strong>GUI интерфейс</strong>: <em>/usr/sbin/alterator-standalone -l &lt;имя&gt;.desktop</em> </li><li> <strong>HTML интерфейс</strong>: <em>/usr/sbin/configd -l</em></li></ul> Во&nbsp;третьем случае сервер configd не&nbsp;будет отцепляться от&nbsp;терминала и&nbsp;будет работать с&nbsp;локальными бакендами и&nbsp;файлами шаблонов. Для&nbsp;старой системы шаблонов (template-*), дополнительно существует переменная <strong>ALTERATOR_HTMLDIR</strong>, которая модифицируется при&nbsp;использовании '-l' аналогично остальным переменным.<br /> <span class="cite">Замечание: на&nbsp;данный момент поиск локальных desktop-файлов работает только при&nbsp;использовании standalone.layout. Во&nbsp;всех остальных случаях придётся установить desktop-файл в&nbsp;систему. Причина &ndash; пока не&nbsp;очень понятно как&nbsp;сделать алгоритм объединяющий все&nbsp;desktop-файлы максимально оптимальным при&nbsp;использовании нескольких каталогов.</span><br /> <em>Ещё: /usr/bin/alterator-standalone водится в&nbsp;пакете alterator-standalone-usermode, /usr/sbin/alterator-standalone &mdash; в&nbsp;alterator-standalone</em></div></div> http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug/show?time=2008-03-18+11%3A20%3A02 <div class="pageBefore"><img src="http://freesource.info/wiki/images/z.gif" width="1" height="1" border="0" alt="" style="display:block" align="top" /></div><div class="page"> <b>Сравнение версий <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Sisyphus&nbsp;/&nbsp;Alterator&nbsp;/&nbsp;debug</a> за <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug?time=2008-03-18+11%3A20%3A02">2008-03-18 11:20:02</a> и <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug?time=2008-06-03+14%3A10%3A53">2008-06-03 14:10:53</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions"><ul><li> <strong>командная строка</strong>: <em>alterator-cmdline -l &lt;запрос&gt;</em> </li><li> <strong>GUI интерфейс</strong>: <em>/usr/sbin/alterator-standalone -l &lt;имя&gt;.desktop</em> </li><li> <strong>HTML интерфейс</strong>: <em>/usr/sbin/configd -l</em></li></ul> Во&nbsp;третьем случае сервер configd не&nbsp;будет отцепляться от&nbsp;терминала и&nbsp;будет работать с&nbsp;локальными бакендами и&nbsp;файлами шаблонов. Для&nbsp;старой системы шаблонов (template-*), дополнительно существует переменная <strong>ALTERATOR_HTMLDIR</strong>, которая модифицируется при&nbsp;использовании '-l' аналогично остальным переменным.</div><br /> <b>Удалено:</b><br /> <div class="deletions"><ul><li> <strong>командная строка</strong>: <em>alterator-cmdline -l &lt;запрос&gt;</em> или&nbsp;<em>alterator -l -c cmdline.layout &lt;запрос&gt;</em> </li><li> <strong>GUI интерфейс</strong>: <em>/usr/sbin/alterator-standalone -l &lt;имя&gt;.desktop</em> или&nbsp;<em>alterator -l -c standalone.layout &lt;имя&gt;.desktop</em> </li><li> <strong>HTML интерфейс</strong>: <em>alterator -l -c configd.layout</em></li></ul> Во&nbsp;третьем случае (<em>alterator -l -c configd.layout</em>) демон configd не&nbsp;будет отцепляться от&nbsp;терминала и&nbsp;будет работать с&nbsp;локальными бакендами и&nbsp;файлами шаблонов. Для&nbsp;старой системы шаблонов (template-*), дополнительно существует переменная <strong>ALTERATOR_HTMLDIR</strong>, которая модифицируется при&nbsp;использовании '-l' аналогично остальным переменным.<a name="h5528-1"></a><h3>Просмотр сообщений на&nbsp;шине в&nbsp;configd </h3> Очень полезным бывает взглянуть на&nbsp;то что&nbsp;доходит и&nbsp;исходит от/из configd при&nbsp;работе с&nbsp;fbi интерфейсом, для&nbsp;этого достаточно добавить в&nbsp;configd.layouts (/usr/share/alterator/layouts/configd.layout) следующие строки:<br /> (telegraph<br /> ;;(std-in)<br /> (server-socket &laquo;/var/run/configd/.sock&raquo; &#8220;root&#8221; &#8220;_configd&#8221;)<br /> (logfile &laquo;/var/log/fbi1.log&raquo;)<br /> (menu &#8220;menu.html&#8221;)<br /> (logfile &laquo;/var/log/fbi2.log&raquo;)<br /> (configd)<br /> (logfile &laquo;/var/log/fbi3.log&raquo;)<br /> (ensign))</div></div> http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug/show?time=2008-03-17+17%3A16%3A03 <div class="pageBefore"><img src="http://freesource.info/wiki/images/z.gif" width="1" height="1" border="0" alt="" style="display:block" align="top" /></div><div class="page"> <b>Сравнение версий <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Sisyphus&nbsp;/&nbsp;Alterator&nbsp;/&nbsp;debug</a> за <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug?time=2008-03-17+17%3A16%3A03">2008-03-17 17:16:03</a> и <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug?time=2008-03-18+11%3A20%3A02">2008-03-18 11:20:02</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions"><em>Ещё: /usr/bin/alterator-standalone водится в&nbsp;пакете alterator-standalone-usermode, /usr/sbin/alterator-standalone &mdash; в&nbsp;alterator-standalone</em></div></div> http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug/show?time=2008-03-17+16%3A34%3A40 <div class="pageBefore"><img src="http://freesource.info/wiki/images/z.gif" width="1" height="1" border="0" alt="" style="display:block" align="top" /></div><div class="page"> <b>Сравнение версий <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Sisyphus&nbsp;/&nbsp;Alterator&nbsp;/&nbsp;debug</a> за <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug?time=2008-03-17+16%3A34%3A40">2008-03-17 16:34:40</a> и <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug?time=2008-03-17+17%3A16%3A03">2008-03-17 17:16:03</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions"><a name="h5528-1"></a><h3>Просмотр сообщений на&nbsp;шине в&nbsp;configd </h3></div><br /> <b>Удалено:</b><br /> <div class="deletions"><a name="h5528-1"></a><h3>Configd debug</h3></div></div> http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug/show?time=2008-03-17+16%3A34%3A04 <div class="pageBefore"><img src="http://freesource.info/wiki/images/z.gif" width="1" height="1" border="0" alt="" style="display:block" align="top" /></div><div class="page"> <b>Сравнение версий <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Sisyphus&nbsp;/&nbsp;Alterator&nbsp;/&nbsp;debug</a> за <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug?time=2008-03-17+16%3A34%3A04">2008-03-17 16:34:04</a> и <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug?time=2008-03-17+16%3A34%3A40">2008-03-17 16:34:40</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions"><!--notypo--><fieldset><legend><strong> Оглавление документа </strong></legend><div class="toc2"><a href="#h5528-2">Распространённые ошибки при&nbsp;работе с&nbsp;внешними бакендами.</a></div><div class="toc2"><a href="#h5528-3">Вставка отладочных сообщений</a></div><div class="toc2"><a href="#h5528-4">Интерпретация некоторых загадочных сообщений</a></div></fieldset><!--/notypo--><a name="h5528-1"></a><h3>Configd debug</h3></div><br /> <b>Удалено:</b><br /> <div class="deletions"><a name="h5528-1"></a><h2>Configd debug</h2></div></div> http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug/show?time=2008-03-17+16%3A26%3A21 <div class="pageBefore"><img src="http://freesource.info/wiki/images/z.gif" width="1" height="1" border="0" alt="" style="display:block" align="top" /></div><div class="page"> <b>Сравнение версий <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Sisyphus&nbsp;/&nbsp;Alterator&nbsp;/&nbsp;debug</a> за <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug?time=2008-03-17+16%3A26%3A21">2008-03-17 16:26:21</a> и <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug?time=2008-03-17+16%3A34%3A04">2008-03-17 16:34:04</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions"><a name="h5528-1"></a><h2>Configd debug</h2> Очень полезным бывает взглянуть на&nbsp;то что&nbsp;доходит и&nbsp;исходит от/из configd при&nbsp;работе с&nbsp;fbi интерфейсом, для&nbsp;этого достаточно добавить в&nbsp;configd.layouts (/usr/share/alterator/layouts/configd.layout) следующие строки:<br /> (telegraph<br /> ;;(std-in)<br /> (server-socket &laquo;/var/run/configd/.sock&raquo; &#8220;root&#8221; &#8220;_configd&#8221;)<br /> (logfile &laquo;/var/log/fbi1.log&raquo;)<br /> (menu &#8220;menu.html&#8221;)<br /> (logfile &laquo;/var/log/fbi2.log&raquo;)<br /> (configd)<br /> (logfile &laquo;/var/log/fbi3.log&raquo;)<br /> (ensign))</div></div> http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug/show?time=2008-03-17+16%3A19%3A21 <div class="pageBefore"><img src="http://freesource.info/wiki/images/z.gif" width="1" height="1" border="0" alt="" style="display:block" align="top" /></div><div class="page"> <b>Сравнение версий <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Sisyphus&nbsp;/&nbsp;Alterator&nbsp;/&nbsp;debug</a> за <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug?time=2008-03-17+16%3A19%3A21">2008-03-17 16:19:21</a> и <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug?time=2008-03-17+16%3A26%3A21">2008-03-17 16:26:21</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions">Во&nbsp;третьем случае (<em>alterator -l -c configd.layout</em>) демон configd не&nbsp;будет отцепляться от&nbsp;терминала и&nbsp;будет работать с&nbsp;локальными бакендами и&nbsp;файлами шаблонов. Для&nbsp;старой системы шаблонов (template-*), дополнительно существует переменная <strong>ALTERATOR_HTMLDIR</strong>, которая модифицируется при&nbsp;использовании '-l' аналогично остальным переменным.<br /> 1. <strong>Паразитный вывод от&nbsp;утилит</strong> &ndash; некоторые утилиты могут неожиданно для&nbsp;автора бакенда произвести печать чего-нибудь на&nbsp;stdout. В&nbsp;результате альтератор воспримет это&nbsp;как ответ. В&nbsp;результате может быть выдано сообщение об&nbsp;неподдерживаемой команде или, что&nbsp;ещё хуже, alterator просто зависнет. Последнее может происходить в&nbsp;случае, когда утилита выдала на&nbsp;stdout кавычку, двойную кавычку или&nbsp;скобку, и&nbsp;alterator начинает ожидать завершения строки.<br /> echo &laquo;имя_вашего_модуля= $(date +%H/%M/%S): action=$in_action and&nbsp;objects=$in__objects&raquo; &gt;&gt; /tmp/alterator-debug.txt 2&gt;&1<br /> <div class="indent">Теперь, если заглянуть в&nbsp;файл <strong>/tmp/alterator-debug.txt</strong> то&nbsp;можно видеть, какой последним был&nbsp;запрос, допустим это&nbsp;было</div></div><br /> <b>Удалено:</b><br /> <div class="deletions">Во&nbsp;втором случае демон configd не&nbsp;будет отцепляться от&nbsp;терминала и&nbsp;будет работать с&nbsp;локальными бакендами и&nbsp;файлами шаблонов. Для&nbsp;старой системы шаблонов (template-*), дополнительно существует переменная <strong>ALTERATOR_HTMLDIR</strong>, которая модифицируется при&nbsp;использовании '-l' аналогично остальным переменным.<br /> 1. <strong>Паразитный вывод от&nbsp;утилит</strong> &ndash; некоторые утилиты могут неожиданно для&nbsp;автора бакенда произвести печать чего-нибудь на&nbsp;stdout. В&nbsp;результате альтератор воспримет это&nbsp;как ответ. В&nbsp;результате может быть выдано сообщение об&nbsp;неподдерживаемой команде или, что&nbsp;ещё хуже, alterator просто зависнет. Последнее может происходить в&nbsp;случае, когда утилита выдала на&nbsp;stdout кавычку, и&nbsp;alterator начинает ожидать завершения строки.<br /> echo &laquo;имя_вашего_модуля= $(date +%H/%M/%S): action=$in_action and&nbsp;objects=$in__objects&raquo; &gt;&gt; /tmp/output.txt 2&gt;&1<br /> <div class="indent">Теперь, если заглянуть в&nbsp;файл <strong>/tmp/output.txt</strong> то&nbsp;можно видеть, какой последним был&nbsp;запрос, допустим это&nbsp;было</div></div></div> http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug/show?time=2008-03-17+16%3A13%3A53 <div class="pageBefore"><img src="http://freesource.info/wiki/images/z.gif" width="1" height="1" border="0" alt="" style="display:block" align="top" /></div><div class="page"> <b>Сравнение версий <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Sisyphus&nbsp;/&nbsp;Alterator&nbsp;/&nbsp;debug</a> за <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug?time=2008-03-17+16%3A13%3A53">2008-03-17 16:13:53</a> и <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug?time=2008-03-17+16%3A19%3A21">2008-03-17 16:19:21</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions">6. <strong>Несоответствие бакенда правилам workflow</strong> &ndash; в&nbsp;HTML интерфейсе автоматические workflow (такие как&nbsp;form и&nbsp;card-index) требуют определённого подхода к&nbsp;размещению параметров в&nbsp;&laquo;дереве&raquo; бакенда. В&nbsp;GUI вся&nbsp;динамика пока пишется вручную, поэтому там&nbsp;это не&nbsp;так критично.</div><br /> <b>Удалено:</b><br /> <div class="deletions">6. <strong>Несоответствие бакенда правилам workflow</strong> &ndash; в&nbsp;HTML интерфейсе автоматические workflow (таки как&nbsp;form и&nbsp;card-index) требуют определённого подхода к&nbsp;размещению параметров в&nbsp;&laquo;дереве&raquo; бакенда. В&nbsp;GUI вся&nbsp;динамика пока пишется вручную, поэтому там&nbsp;это не&nbsp;так критично.</div></div> http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug/show?time=2008-03-17+16%3A03%3A47 <div class="pageBefore"><img src="http://freesource.info/wiki/images/z.gif" width="1" height="1" border="0" alt="" style="display:block" align="top" /></div><div class="page"> <b>Сравнение версий <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug&" class="">/Alt&nbsp;Linux&nbsp;/&nbsp;Sisyphus&nbsp;/&nbsp;Alterator&nbsp;/&nbsp;debug</a> за <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug?time=2008-03-17+16%3A03%3A47">2008-03-17 16:03:47</a> и <a href="http://freesource.info/wiki/AltLinux/Sisyphus/Alterator/debug?time=2008-03-17+16%3A13%3A53">2008-03-17 16:13:53</a></b><br /> <br /> <b>Добавлено:</b><br /> <div class="additions">1. <strong>Паразитный вывод от&nbsp;утилит</strong> &ndash; некоторые утилиты могут неожиданно для&nbsp;автора бакенда произвести печать чего-нибудь на&nbsp;stdout. В&nbsp;результате альтератор воспримет это&nbsp;как ответ. В&nbsp;результате может быть выдано сообщение об&nbsp;неподдерживаемой команде или, что&nbsp;ещё хуже, alterator просто зависнет. Последнее может происходить в&nbsp;случае, когда утилита выдала на&nbsp;stdout кавычку, и&nbsp;alterator начинает ожидать завершения строки.<br /> 2. <strong>Отсутствие ответа</strong> &ndash; можно ошибиться и&nbsp;какая-нибудь из&nbsp;утилит (например grep), будет висеть и&nbsp;в месте с&nbsp;ней будет висеть и&nbsp;весь alterator.<br /> 3. <strong>Два ответа вместо одного</strong> &ndash; alterator не&nbsp;сбрасывает буфер чтения перед началом чтения очередного ответа от&nbsp;бакенда, поэтому если бакенд ответил два&nbsp;раза, ядро и&nbsp;бакенд начинают работать в&nbsp;&laquo;противофазе&raquo; выдавая неожиданные ответы в&nbsp;неожиданных местах. Внешне всё выглядит как&nbsp;будто модуль то&nbsp;работает, а&nbsp;то не&nbsp;работает.<br /> 4. <strong>Неверный формат вывода списка</strong> &ndash; давным давно alterator стал использовать для&nbsp;вывода списков странную систему, в&nbsp;которой в&nbsp;отличие от&nbsp;остальных случаев первым идёт строка с&nbsp;именем. Пользователи не&nbsp;читают документацию, поэтому часто вместо '(&laquo;a&raquo; param &#8220;pam-pam&#8221;) выводят '(name &#8220;a&#8221; param &#8220;pam-pam&#8221;) ... в&nbsp;результате бакенд не&nbsp;работает.<br /> 6. <strong>Несоответствие бакенда правилам workflow</strong> &ndash; в&nbsp;HTML интерфейсе автоматические workflow (таки как&nbsp;form и&nbsp;card-index) требуют определённого подхода к&nbsp;размещению параметров в&nbsp;&laquo;дереве&raquo; бакенда. В&nbsp;GUI вся&nbsp;динамика пока пишется вручную, поэтому там&nbsp;это не&nbsp;так критично.<a name="h5528-1"></a><h3>Вставка отладочных сообщений</h3> Во&nbsp;внешних бакендах остаётся свободным stderr, поэтому можно выводить отладочные сообщения именно туда. В&nbsp;нативных бакендах и&nbsp;во всём остальном alterator свободны и&nbsp;stdout и&nbsp;stderr. Для&nbsp;вывода в&nbsp;коде scheme рекомендуется использовать функцию format. Например:<br /> (format #t &laquo;debug-message:obj1=S,obj2=~S~%&quot; obj1 obj2) ; вывод на&nbsp;stdout<br /> (format (current-error-port) &laquo;debug-message%&quot;) ; вывод в&nbsp;stderr<br /> Очень полезно отладить бакенд сначала в&nbsp;интерфейсе командной строки, а&nbsp;потом уже&nbsp;проверять как&nbsp;он&nbsp;работает в&nbsp;других более сложных интерфейсах &ndash; так&nbsp;будет проще найти виноватого.<a name="h5528-2"></a><h3>Интерпретация некоторых загадочных сообщений</h3></div><br /> <b>Удалено:</b><br /> <div class="deletions">1. <strong>&laquo;Паразитный вывод от&nbsp;утилит&raquo;</strong> &ndash; некоторые утилиты могут неожиданно для&nbsp;автора бакенда произвести печать чего-нибудь на&nbsp;stdout. В&nbsp;результате альтератор воспримет это&nbsp;как ответ. В&nbsp;результате может быть выдано сообщение об&nbsp;неподдерживаемой команде или, что&nbsp;ещё хуже, alterator просто зависнет. Последнее может происходить в&nbsp;случае, когда утилита выдала на&nbsp;stdout кавычку, и&nbsp;alterator начинает ожидать завершения строки.<br /> 2. <strong>&laquo;Отсутствие ответа&raquo;</strong> &ndash; можно ошибиться и&nbsp;какая-нибудь из&nbsp;утилит (например grep), будет висеть и&nbsp;в месте с&nbsp;ней будет висеть и&nbsp;весь alterator.<br /> 3. <strong>&laquo;Два ответа вместо одного&raquo;</strong> &ndash; alterator не&nbsp;сбрасывает буфер чтения перед началом чтения очередного ответа от&nbsp;бакенда, поэтому если бакенд ответил два&nbsp;раза, ядро и&nbsp;бакенд начинают работать в&nbsp;&laquo;противофазе&raquo; выдавая неожиданные ответы в&nbsp;неожиданных местах. Внешне всё выглядит как&nbsp;будто модуль то&nbsp;работает, а&nbsp;то не&nbsp;работает.<br /> 4. <strong>&laquo;Неверный формат вывода списка&raquo;</strong> &ndash; давным давно alterator стал использовать для&nbsp;вывода списков странную систему, в&nbsp;которой в&nbsp;отличие от&nbsp;остальных случаев первым идёт строка с&nbsp;именем. Пользователи не&nbsp;читают документацию, поэтому часто вместо '(&laquo;a&raquo; param &#8220;pam-pam&#8221;) выводят '(name &#8220;a&#8221; param &#8220;pam-pam&#8221;) ... в&nbsp;результате бакенд не&nbsp;работает.<br /> <hr noshade="noshade" size="1" /> Отлаживать модули в&nbsp;alterator пока не&nbsp;так просто и&nbsp;удобно как&nbsp;хотелось бы.<br /> Следующие способы возможно облегчал жизнь:<br /> <ul><li> Запуск guile в&nbsp;отладочном режиме (в случае ошибки выдаётся очень backtrace, благодаря которому можно понять где&nbsp;возникла проблема):</li></ul> guile --debug -s /usr/bin/alterator -c standalone.layout &lt;профиль&gt;<br /> <ul><li> Вставка отладочных сообщений. Во&nbsp;всех компонентах alterator можно ставить отладочные сообщения с&nbsp;выводом в&nbsp;stderr, вывод в&nbsp;stdout можно делать также везде кроме бакендов. Для&nbsp;выдачи сообщений об&nbsp;ошибке можно пользоваться функциями write,display или&nbsp;format (рекомендуемый вариант).</li></ul> (format (current-error-port) &laquo;value=S~%&quot; value) ; вывод на&nbsp;stderr<br /> или<br /> (format #t &laquo;value=S~%&quot; value) ; вывод на&nbsp;stdout<br /> <!--notypo--><textarea class="code" rows="2" readonly="readonly">* Если подземные стуки раздаются в районе браузера интерфейса, то можно заменить в layout транспорт pipe-in, на std-in, и дав на вход команду &quot;(auth-request)&quot;, посмотреть на вывод. Ниже пример layout для использования транспорт std-in.</textarea><!--/notypo--><br /> <div class="indent">....<br /> (use-modules (alterator transport std-channel))<br /> <br /> (telegraph</div> ; (pipe-in &laquo;/usr/bin/qtbrowser&raquo;)<br /> <div class="indent">(std-in)<br /> (lookout)<br /> (ensign))</div> ...<br /> <div class="indent"><!--notypo--><textarea class="code" rows="4" readonly="readonly">* Если есть подозрение, что по шине ходят какие-то не такие команды, то можно вставить между интересующими модулями компонент по имени (bridge-book-recorder &quot;name.log&quot;) и потом изучать содержимое log-файла * Если есть подозрение, что бакенд не отрабатывает как следует, то помимо простых отладочных сообщений, возможны следующие варианты: * Если проблема в протоколе обмена, то можно попробовать &quot;пообщаться&quot; с бакендом вручную прямо в shell (протокол описан в соотв. разделе)</textarea><!--/notypo--><br /> <div class="indent"><div class="indent"><div class="indent">$ backend3/users </div></div></div></div> _message:begin<br /> _objects:root <br /> action:read<br /> _message:end<br /> (<br /> gecos &#8220;Root&#8221; home &laquo;/root&#8221; shell &laquo;/bin/bash&#8221;<br /> )<br /> <ul><li><ul><li> Если проблема в&nbsp;логике, то&nbsp;можно пообщаться с&nbsp;бакендом, используя cmdline интерфейс</li></ul></li></ul> %%<br /> $ alterator -l -c cmdline.layout /users/root action read<br /> gecos &#8220;Root&#8221; home &laquo;/root&#8221; shell &laquo;/bin/bash&#8221;<br /> <div class="indent"></div><a name="h5528-1"></a><h2>Сообщения об&nbsp;ошибке</h2></div></div>