Changes between Version 112 and Version 113 of FAQ

Timestamp:

Sep 29, 2011 9:30:22 AM (13 years ago)

Author:

bennylp

Comment:

--

FAQ

@@ -256 +256 @@
  1. integrate your impplementation into the build system, by following [wiki:External_Sound_Device this guideline].
 
+=== How can I disable multi-threading throughout the libraries? === #no-thread
+
+Below are some information about where threads are used in the libraries in most platforms except Symbian^1)^:
+ - the worker thread(s) for signaling (i.e. SIP and pjnath including STUN, TURN, ICE, etc.) created by PJSUA-LIB according to {{{pjsua_config.thread_cnt}}} setting (default is 1).
+ - the worker thread(s) for polling incoming RTP/RTCP packets, created by {{{pjsua_media_config.thread_cnt}}} setting (default is 1)
+ - sound device's worker thread(s) which drives the audio flow. Each sound device implementation has its own threading strategy, and usually it will create at least one thread.
+ - worker thread(s) to drive video flows (such as from capture device to encoder, and from decoder to renderer).
+
+Below are the strategies to disable multithreading:
+ 1. Use the following settings to disable PJSUA-LIB worker threads:
+ {{{
+  pjsua_config cfg;
+  pjsua_media_config med_cfg;
+
+  pjsua_config_default(&cfg);
+  cfg.thread_cnt = 0;
+
+  pjsua_media_config_default(&med_cfg);
+  med_cfg.thread_cnt = 0;
+  med_cfg.has_ioqueue = PJ_FALSE;
+
+  ..
+  pjsua_init(&cfg, .. &med_cfg);
+ }}}
+ Once PJSUA-LIB worker threads have been disabled as above, remember that you'd have to poll for events timely and periodically by calling {{{pjsua_handle_events()}}}. 
+ 2. Currently the only way to disable threading in the sound device is by using sound device implementation that doesn't use threading.
+ 3. And currently threading is needed for video, thus you need to disable video if you want to disable multithreading. Set {{{PJMEDIA_HAS_VIDEO}}} to 0 in {{{config_site.h}}}.
+ 4. Lastly, we can now disable threading altogether at compile time, by setting {{{PJ_HAS_THREADS}}} to 0  in {{{config_site.h}}}.
+
+Note:
+ ^1)^ multithreading is not used by pjsip in Symbian
 
 ----