Browse code

- presence partialy modified for uuid-zed usrloc callback - modified documentation about XCAP server simulation - added RLS module parameter for better work with XCAP simulation

Vaclav Kubart authored on 22/11/2005 13:18:25
Showing 2 changed files
... ...
@@ -94,7 +94,7 @@ linkend="pres_draft_xcap_change"/> and <xref linkend="pres_draft_xcap_profiles"/
94 94
 </section>
95 95
 
96 96
 <section><title>Standard incompliances</title>
97
-<para>SER's resource lists support is not finished yet, there are some standard
97
+<para>SER's XCAP authorization support is not finished yet, there are some standard
98 98
 incompliances now:
99 99
 <itemizedlist>
100 100
 	<listitem><para>ignored sphere</para></listitem>
... ...
@@ -113,10 +113,10 @@ linkend="pres_draft_rls"/> describes that a Resource Lists Server operates with
113 113
 but tested client software doesn't store <quote>rls-services</quote> documents,
114 114
 only <quote>resource list documents</quote> (buddy lists).</para>
115 115
 
116
-<para>This problem is not solved yet, but it is possible, that the RLS module 
117
-will try both variants in the future. Now it scans and process only
118
-<quote>rls-services</quote> documents (there must be stored links onto user's
119
-buddy lists - as shown in <link linkend="xcap.examples">examples</link>).</para>
116
+<para>It is possible now to change mode of processing subscriptions (see <link
117
+linkend="rls.parameters">RLS module parameters</link> so it works directly with
118
+resource list documents published by client instead of rls-services document.
119
+</para>
120 120
 
121 121
 <section><title>RLS document URI</title>
122 122
 <para>The construction of rls-services document URI is described in <xref
... ...
@@ -141,6 +141,23 @@ which means the <literal>service</literal> element with
141 141
 <literal>smith-list@iptel.org</literal> stored in rls-services document named
142 142
 index.
143 143
 </para></example>
144
+
145
+<section><title>Disadvantages</title>
146
+<para>Working with URIs presented in this section have one big disadvantage - it
147
+needs full XCAP server which is able to work with partial documents and able to
148
+process XPointer expressions in XCAP queries.</para>
149
+
150
+<para>Due to unavailability of free XCAP servers is there a possibility to
151
+use SER's RLS server in mode of <emphasis>reduced XCAP server needs</emphasis> 
152
+(see <link linkend="rls.parameters">RLS module parameters</link>). If operating 
153
+in this mode, RLS requests full rls-service document from uri 
154
+<filename>&lt;xcap-root&gt;/rls-services/global/index</filename>, inspects it
155
+and finds requested resource list according to URI and AOR by itself.
156
+(Only if possible! There can't be links 
157
+to partial documents in rls-services document.)
158
+</para>
159
+</section> <!-- disadvantages -->
160
+
144 161
 </section>
145 162
 
146 163
 <section><title>Standard incompliances</title>
... ...
@@ -438,9 +455,10 @@ demonstration or testing purposes.
438 455
 these are read as standalone documents from directories of standalone users.
439 456
 </para>
440 457
 
441
-<para>For resource lists you have to install a full XCAP server. Only if you use
442
-<quote>simple</quote> mode of list subscription processing (see <link
443
-linkend="rls.parameters">RLS module parameters</link>) you do not need it.
458
+<para>For resource lists you have to set <link linkend="rls.parameters">RLS module 
459
+parameters</link> <varname>mode</varname> and/or
460
+<varname>reduce_xcap_needs</varname> 
461
+to work as much as possible with XCAP server simulation.
444 462
 </para>
445 463
 </section>
446 464
 
... ...
@@ -464,6 +482,9 @@ Alias /xcap-root /var/simulated-xcap-root
464 482
 </Directory>
465 483
 ...
466 484
 ]]></programlisting>
485
+<para>If apache is running on machine with SER, you can use as xcap-root
486
+<literal>http://localhost/xcap-root</literal>.
487
+</para>
467 488
 </example>
468 489
 
469 490
 <example><title>Simple (and dangerous) cgi-script for upload</title>
... ...
@@ -525,7 +525,7 @@ static service_t *find_service(rls_services_t *rls, const str_t *uri)
525 525
 	
526 526
 	srv = SEQUENCE_FIRST(rls->rls_services);
527 527
 	while (srv) {
528
-		TRACE_LOG("comparing %s to %.*s\n", srv->uri, FMT_STR(*uri));
528
+		/* TRACE_LOG("comparing %s to %.*s\n", srv->uri, FMT_STR(*uri)); */
529 529
 		if (str_strcmp(uri, srv->uri) == 0) return srv;
530 530
 		srv = SEQUENCE_NEXT(srv);
531 531
 	}