浏览代码

added incompatibility description into presence handbook and XCAP module documentation as requested by SER-283

Vaclav Kubart 18 年之前
父节点
当前提交
6bb4c4a67e
共有 2 个文件被更改,包括 17 次插入1 次删除
  1. 6 0
      doc/presence/install.xml
  2. 11 1
      doc/presence/trouble.xml

+ 6 - 0
doc/presence/install.xml

@@ -11,6 +11,12 @@ compilation procedure and running is a bit more difficult than usual. For detail
 description of libraries see their separate documentation (stored in
 <filename>lib/doc</filename> subdirectory of main SER directory).</para>
 
+<section><title>Incompatibility</title>
+<para>XCAP module needed for authorization is not working with TLS module. Fro
+more information see <xref linkend="pres.known_problems"/>.
+</para>
+</section>
+
 <section id="pres.dependencies"><title>Dependencies</title>
 <para>Presence module dependecies may be found in sections <link
 linkend="pa.dependencies">PA module dependencies</link> and <link

+ 11 - 1
doc/presence/trouble.xml

@@ -6,14 +6,16 @@
 <para>Sometimes it is needed to solve problems with presence related stuff...
 ;-)</para>
 
-<section><title>Known problems</title>
+<section id="pres.known_problems"><title>Known problems</title>
 <para>
 <itemizedlist>
+
 	<listitem><para>AVPs might not work properly with presence. If you create
 	AVPs they can disappear after call to handle_subscription or similar
 	function. The reason is that from such functions is created new transaction
 	(sent a NOTIFY request) and AVPs are not returned correctly to previous
 	one.</para></listitem>
+
 	<listitem><para>There are some standard
 	incompliances in presence modules, often caused by standard ambiguity
 	or contradiction or by partial implementation only. Please refer to specific
@@ -21,6 +23,14 @@
 	<listitem><para>SIP clients often use broken data, not corresponding with
 	data format specification. Look into specification in such cases (for
 	example <xref linkend="pres_rfc_pidf"/>).</para></listitem>
+
+	<listitem><para>XCAP module is incompatible with TLS module due to openssl
+	initialization!</para>
+	<para>XCAP module uses libcurl for HTTP comunication and libcurl is using
+	libopenssl internaly. But TLS module needs some extra openssl initialization which
+	is not working when libcurl initializes openssl by itself.</para>
+	<para>Thanks Samuel ([email protected]) for pointing this out.</para></listitem>
+
 </itemizedlist>
 </para>
 </section>