[Freeswitch-svn] [commit] r9515 - in freeswitch/trunk/libs/sofia-sip: . libsofia-sip-ua/soa

Freeswitch SVN mikej at freeswitch.org
Wed Sep 10 12:23:21 EDT 2008


Author: mikej
Date: Wed Sep 10 12:23:21 2008
New Revision: 9515

Modified:
   freeswitch/trunk/libs/sofia-sip/.update
   freeswitch/trunk/libs/sofia-sip/libsofia-sip-ua/soa/soa.c

Log:
Wed Sep 10 11:44:40 EDT 2008  Pekka Pessi <first.last at nokia.com>
  * soa.c: document what function table contains by default
  
  For easy TAGS usage.



Modified: freeswitch/trunk/libs/sofia-sip/.update
==============================================================================
--- freeswitch/trunk/libs/sofia-sip/.update	(original)
+++ freeswitch/trunk/libs/sofia-sip/.update	Wed Sep 10 12:23:21 2008
@@ -1 +1 @@
-Wed Sep 10 12:19:57 EDT 2008
+Wed Sep 10 12:23:16 EDT 2008

Modified: freeswitch/trunk/libs/sofia-sip/libsofia-sip-ua/soa/soa.c
==============================================================================
--- freeswitch/trunk/libs/sofia-sip/libsofia-sip-ua/soa/soa.c	(original)
+++ freeswitch/trunk/libs/sofia-sip/libsofia-sip-ua/soa/soa.c	Wed Sep 10 12:23:21 2008
@@ -255,7 +255,9 @@
     ss->ss_actions = actions;
     ss->ss_name = strcpy((char *)ss + actions->sizeof_soa_session, name);
 
+    /* Calls soa_static_init by default */
     if (ss->ss_actions->soa_init(name, ss, NULL) < 0)
+      /* Calls soa_static_deinit by default */
       ss->ss_actions->soa_deinit(ss), ss = NULL;
   }
 
@@ -287,7 +289,9 @@
     ss->ss_name = strcpy((char *)ss + ss->ss_actions->sizeof_soa_session,
 			 parent_ss->ss_name);
 
+    /* Calls soa_static_init by default */
     if (ss->ss_actions->soa_init(NULL, ss, parent_ss) < 0)
+      /* Calls soa_static_deinit by default */
       ss->ss_actions->soa_deinit(ss), ss = NULL;
   }
 
@@ -351,6 +355,7 @@
   if (ss) {
     ss->ss_active = 0;
     ss->ss_terminated++;
+    /* Calls soa_static_deinit() by default. */
     ss->ss_actions->soa_deinit(ss);
     su_home_unref(ss->ss_home);
   }
@@ -399,6 +404,7 @@
 
   ta_start(ta, tag, value);
 
+  /* Calls soa_static_set_params() by default. */
   n = ss->ss_actions->soa_set_params(ss, ta_args(ta));
 
   ta_end(ta);
@@ -609,6 +615,7 @@
 
   ta_start(ta, tag, value);
 
+  /* Calls soa_static_get_params() by default. */
   n = ss->ss_actions->soa_get_params(ss, ta_args(ta));
 
   ta_end(ta);
@@ -688,6 +695,7 @@
 
   if (ss) {
     ta_start(ta, tag, value);
+    /* Calls soa_static_get_paramlist() by default. */
     params = ss->ss_actions->soa_get_paramlist(ss, ta_tags(ta));
     ta_end(ta);
   }
@@ -1311,6 +1319,7 @@
 	      ss ? ss->ss_actions->soa_name : "", (void *)ss, live, (void *)home));
 
   if (ss)
+    /* Calls soa_base_media_features() by default. */
     return ss->ss_actions->soa_media_features(ss, live, home);
   else
     return (void)su_seterrno(EFAULT), NULL;
@@ -1327,6 +1336,7 @@
 	      ss ? ss->ss_actions->soa_name : "", (void *)ss));
 
   if (ss)
+    /* Calls soa_base_sip_require() by default */
     return ss->ss_actions->soa_sip_require(ss);
   else
     return (void)su_seterrno(EFAULT), NULL;
@@ -1344,6 +1354,7 @@
 	      ss ? ss->ss_actions->soa_name : "", (void *)ss));
 
   if (ss)
+    /* Calls soa_base_sip_supported() by default */
     return ss->ss_actions->soa_sip_supported(ss);
   else
     return (void)su_seterrno(EFAULT), NULL;
@@ -1363,6 +1374,7 @@
 	      ss ? ss->ss_actions->soa_name : "", (void *)ss, (void *)supported, (void *)require));
 
   if (ss)
+    /* Calls soa_base_remote_sip_features() by default */
     return ss->ss_actions->soa_remote_sip_features(ss, supported, require);
   else
     return (void)su_seterrno(EFAULT), -1;
@@ -1435,7 +1447,9 @@
   /* We should avoid actual operation unless always is true */
   (void)always;  /* We always regenerate offer */
 
+  /* Calls soa_static_generate_offer() by default. */
   return ss->ss_actions->soa_generate_offer(ss, completed);
+
   /** @sa soa_init_offer_answer(), soa_set_user_sdp(), soa_get_local_sdp(),
    * soa_set_remote_sdp(), soa_process_answer(), soa_process_reject(),
    * soa_generate_answer(), soa_set_params(), soa_get_params(),
@@ -1511,6 +1525,7 @@
   if (!ss->ss_unprocessed_remote)
     return su_seterrno(EPROTO), -1;
 
+  /* Calls soa_static_generate_answer() by default. */
   return ss->ss_actions->soa_generate_answer(ss, completed);
 
   /**@sa soa_init_offer_answer(), soa_set_user_sdp(), soa_set_remote_sdp(),
@@ -1598,6 +1613,7 @@
    * SOATAG_REMOTE_SDP(), SOATAG_REMOTE_SDP_STR().
    */
 
+  /* Calls soa_static_process_answer() by default. */
   return ss->ss_actions->soa_process_answer(ss, completed);
 }
 
@@ -1674,6 +1690,7 @@
    * SOATAG_REMOTE_SDP(), SOATAG_REMOTE_SDP_STR().
    */
 
+  /* Calls soa_static_process_reject() by default. */
   return ss->ss_actions->soa_process_reject(ss, completed);
 }
 
@@ -1716,6 +1733,7 @@
 
   ss->ss_active = 1;
 
+  /* Calls soa_static_activate() by default. */
   return ss->ss_actions->soa_activate_session(ss, option);
 }
 
@@ -1746,6 +1764,7 @@
 
   ss->ss_active = 0;
 
+  /* Calls soa_static_deactivate() by default. */
   return ss->ss_actions->soa_deactivate_session(ss, option);
 }
 
@@ -1769,6 +1788,7 @@
   ss->ss_active = 0;
   ss->ss_terminated++;
 
+  /* Calls soa_static_terminate() by default. */
   ss->ss_actions->soa_terminate_session(ss, option);
 }
 
@@ -2016,9 +2036,10 @@
   if (!new_version) {
     if (what == soa_remote_sdp_kind) {
       *sdp = *ssd->ssd_sdp;
-      /* XXX - should check changes by soa_set_remote_sdp */
+      /* Calls soa_static_set_remote_sdp() by default */
       return ss->ss_actions->soa_set_remote_sdp(ss, new_version, 
 						sdp, sdp_str, str_len);
+      /* XXX - should check changes by soa_set_remote_sdp */
     }
     return 0;
   } 
@@ -2041,12 +2062,15 @@
  
   switch (what) {
   case soa_capability_sdp_kind:
+    /* Calls soa_static_set_capability_sdp() by default */
     retval = ss->ss_actions->soa_set_capability_sdp(ss, sdp, sdp_str, str_len);
     break;
   case soa_user_sdp_kind:
+    /* Calls soa_static_set_user_sdp() by default */
     retval =  ss->ss_actions->soa_set_user_sdp(ss, sdp, sdp_str, str_len);
     break;
   case soa_remote_sdp_kind:
+    /* Calls soa_static_set_remote_sdp() by default */
     retval = ss->ss_actions->soa_set_remote_sdp(ss, 1, sdp, sdp_str, str_len);
     break;
   default:



More information about the Freeswitch-svn mailing list