core, lib, modules: restructured source code tree
[sip-router] / src / modules / app_perl / doc / app_perl_faq.xml
1 <?xml version="1.0" encoding='ISO-8859-1'?>
2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4
5 <!-- Include general documentation entities -->
6 <!ENTITY % docentities SYSTEM "../../../docbook/entities.xml">
7 %docentities;
8
9 ]>
10 <!-- Module FAQ -->
11
12 <chapter>
13     
14     <title>&faqguide;</title>
15     <qandaset defaultlabel="number">
16         <qandaentry>
17             <question>
18                 <para>Are there known bugs in the Perl module?</para>
19             </question>
20             <answer>
21                 <para>
22                     The Perl module does have a few shortcomings that may be regarded as bugs.
23                 </para>
24                 <itemizedlist>
25                     <listitem>
26                         <para>Missing module functions. Not all functions of other modules are
27                         available for Perl access. The reason for this is a design property of
28                         &kamailio;. Making available more functions is work in progress.</para>
29                     </listitem>
30                     <listitem>
31                         <para>Perl and threads. Perl itself is, when compiled with the correct
32                         parameters, thread safe; unfortunately, not all Perl modules are.
33                         The DBI modules, especially (but not restricted to) DBI::ODBC are known
34                         NOT to be thread safe.</para>
35                         <para>Using DBI::ODBC -- and possibly other non-thread-safe Perl
36                         extensions -- may result in erroneous behavior of &kamailio;, including
37                         (but not restricted to) server crashes and wrong routing.</para>
38                     </listitem>
39                 </itemizedlist>
40             </answer>
41         </qandaentry>
42         <qandaentry>
43             <question>
44                 <para>Where can I find more about &kamailio;?</para>
45             </question>
46             <answer>
47                 <para>
48                         Take a look at &kamailiohomelink;.
49                 </para>
50             </answer>
51         </qandaentry>
52         <qandaentry>
53             <question>
54                 <para>Where can I post a question about this module?</para>
55             </question>
56             <answer>
57                 <para>
58                         First at all check if your question was already answered on one of
59                         our mailing lists: 
60                 </para>
61                 <itemizedlist>
62                     <listitem>
63                         <para>User Mailing List - &kamailiouserslink;</para>
64                     </listitem>
65                     <listitem>
66                         <para>Developer Mailing List - &kamailiodevlink;</para>
67                     </listitem>
68                 </itemizedlist>
69                 <para>
70                         E-mails regarding any stable &kamailio; release should be sent to 
71                         &kamailiousersmail; and e-mails regarding development versions
72                         should be sent to &kamailiodevmail;.
73                 </para>
74                 <para>
75                         If you want to keep the mail private, send it to 
76                         &kamailiohelpmail;.
77                 </para>
78             </answer>
79         </qandaentry>
80         <qandaentry>
81             <question>
82                 <para>How can I report a bug?</para>
83             </question>
84             <answer>
85                 <para>
86                         Please follow the guidelines provided at:
87                         &kamailiobugslink;.
88                 </para>
89             </answer>
90         </qandaentry>
91     </qandaset>
92 </chapter>
93