Changeset 2705 for pjproject/branches/projects/sipit24/pjnath/include/pjnath/ice_strans.h

Timestamp:

May 17, 2009 5:57:19 PM (15 years ago)

Author:

bennylp

Message:

Ticket #851: initial code to support regular nomination in ICE:

• Added option to change nomination strategy in ICE strans and session. Default is still aggressive.
• Added option to control nomination timer
• Renamed no_host_cand to max_host_cands in ICE config
• Updated icedemo
• Also added timer for controlled agent to wait for nomination from controlling agent

File:

• pjproject/branches/projects/sipit24/pjnath/include/pjnath/ice_strans.h (modified) (2 diffs)

pjproject/branches/projects/sipit24/pjnath/include/pjnath/ice_strans.h

@@ -210 +210 @@
 
         /**
-         * Disable host candidates. When this option is set, no
-         * host candidates will be added.
-         *
-         * Default: PJ_FALSE
-         */
-        pj_bool_t            no_host_cands;
+         * Maximum number of host candidates to be added. If the
+         * value is zero, no host candidates will be added.
+         *
+         * Default: 64
+         */
+        unsigned             max_host_cands;
 
         /**
@@ -384 +384 @@
  */
 PJ_DECL(void*) pj_ice_strans_get_user_data(pj_ice_strans *ice_st);
+
+
+/**
+ * Get the value of various options of the ICE stream transport.
+ *
+ * @param ice_st        The ICE stream transport.
+ * @param opt           The options to be initialized with the values
+ *                      from the ICE stream transport.
+ *
+ * @return              PJ_SUCCESS on success, or the appropriate error.
+ */
+PJ_DECL(pj_status_t) pj_ice_strans_get_options(pj_ice_strans *ice_st,
+                                               pj_ice_sess_options *opt);
+
+/**
+ * Specify various options for this ICE stream transport. Application 
+ * should call #pj_ice_strans_get_options() to initialize the options 
+ * with their default values.
+ *
+ * @param ice_st        The ICE stream transport.
+ * @param opt           Options to be applied to this ICE stream transport.
+ *
+ * @return              PJ_SUCCESS on success, or the appropriate error.
+ */
+PJ_DECL(pj_status_t) pj_ice_strans_set_options(pj_ice_strans *ice_st,
+                                               const pj_ice_sess_options *opt);