Прочёл очередную книгу, от индусского издательства packt publishing – Asterisk Gateway Interface 1.4 and 1.6 Programming. Книга небольшая – около 200 страниц. До середины книги, я был крайне разочарован уровнем материала. Удручало большое количество текста скопированного из справки Asterisk. Я так делал в институте, на курсовых и лабораторных – что бы добить отчёт до требуемого размера, вставлял в него общедоступные тексты. Но тут ведь совсем другое! Одно дело халтурить самому, и совсем другое покупать халтуру за свои деньги! :) Кроме обширных заимствований из справки, в первой половине книги присутствует гигантское количество опечаток и ошибок, такое впечатление, что в издательстве packt publishing должность корректора и редактора – упразднили из-за кризиса. Вот лишь пара ошибок: CALLERID(all) называется переменной на странице 37 и далее, на странице 43 блоксхема нарисована неверно (стрелка не в ту сторону), на странице 39 дан некорректный пример:

exten => s,n,Set(SOMEVAR=${12127773456:-3) ; SOMEVAR = 654

Эти, и многие другие ошибки, могут смутить начинающего администратора Asterisk.

Вторая половина книги разительно отличается от первой. Материал изложен бодро и понятно, ошибок я не нашёл и минимум заимствований из открытых источников (см справка Asterisk). Такое впечатление, что первую половину книги писал чернорабочий из packt publiching, а вторую, сам автор – Nir Simionovich. Особенно приятно то, что автор не останавливается на детальном разборе готовых AGI классов (phpagi и Asterisk-AGI), а объясняет как писать эффективные AGI приложения. Подробно рассматривается механика AGI – особенности взаимодействия Aterisk и внешних программ с помощью пайпов и сокетов.

В конце книги приводятся подсказки по созданию типовых AGI приложений – сервиса Click-2-Call и шлюза записи разговоров. В целом, книга понравилась, не смотря на крайне слабую первую часть. Кстати про первую часть, во втором издании, её можно было бы заменить другим, более полезным материалом. Например уделив внимание ещё популярному языку для AGI – Perl или Python. Так же, можно увеличить количество примеров приведенных в конце книги и глубину их проработки. Рекомендую книгу всем кто собирается писать AGI скрипты. Да и тем кто уже пишет тоже – для систематизации мыслей.

Кстати, у автора есть интересный блог – http://www.simionovich.com/

    -- Executing [*99@7:1] AGI("SIP/1007-09d78670", "smartoffice,xxx")
                                                     in new stack
    -- Launched AGI Script /var/lib/Asterisk/agi-bin/smartoffice
AGI Tx >> agi_request: smartoffice
AGI Tx >> agi_channel: SIP/1007-09d78670
AGI Tx >> agi_language: ru
AGI Tx >> agi_type: SIP
AGI Tx >> agi_uniqueid: 1256325972.1
AGI Tx >> agi_version: SVN-branch-1.6.0-r225583M
AGI Tx >> agi_callerid: 1007
AGI Tx >> agi_calleridname: unknown
AGI Tx >> agi_callingpres: 0
AGI Tx >> agi_callingani2: 0
AGI Tx >> agi_callington: 0
AGI Tx >> agi_callingtns: 0
AGI Tx >> agi_dnid: *99
AGI Tx >> agi_rdnis: unknown
AGI Tx >> agi_context: 7
AGI Tx >> agi_extension: *99
AGI Tx >> agi_priority: 1
AGI Tx >> agi_enhanced: 0.0
AGI Tx >> agi_accountcode:
AGI Tx >> agi_threadid: 146017168
AGI Tx >> agi_arg_1: xxx
AGI Tx >>
AGI Rx << verbose "Failed to execute
    '/var/lib/Asterisk/agi-bin/smartoffice': Permission denied" 2
  == smartoffice,xxx: Failed to execute
'/var/lib/Asterisk/agi-bin/smartoffice': Permission denied
<SIP/1007-09d78670>AGI Tx >> 200 result=1
[Oct 23 23:26:12] WARNING[4681]: res_agi.c:2801 run_agi: unable to send
              SIGHUP to AGI process 4682: No such process

С этой проблемой я столкнулся после очередного обновления Asterisk. А точнее после ревизии 172503 (5 января 2009 года). Изменения в этой ревизии манипулируют способностями форкнутых процессов с помощью libcap. На операционной системе Centos 5.x данное изменение не вызвало никаких неприятностей. А вот на другой системе, где установлена Fedora 8, AGI скрипты не работали с января. Проблема кроется в файле res/res_agi.c:

681
682
683
684
685
686
687
688
689

#ifdef HAVE_CAP
                cap_t cap = cap_from_text("cap_net_admin-eip");
 
                if (cap_set_proc(cap)) {
                        /* Careful with order! Logging cannot happen after we close FDs */
                        ast_log(LOG_WARNING, "Unable to remove capabilities.\n");
                }
                cap_free(cap);
#endif

Скорее всего, суть проблемы заключается в специфической обработке способностей «cap_net_admin-eip» в старых дистрибутивах. Самое простое решение – закомментировать данный кусок кода.