Changeset 2966 for pjproject/trunk/pjnath/include/pjnath/ice_strans.h

Timestamp:

Oct 25, 2009 9:02:07 AM (15 years ago)

Author:

bennylp

Message:

Initial commit for ticket #950: QoS support:

• implementation:
  • PJLIB (sock_qos*.*)
• added QoS support in:
  • SIP UDP transport,
  • SIP TCP transport,
  • media UDP transport (done in pjsua-lib),
  • pjnath ICE stream transport,
  • pjnath STUN socket,
  • pjnath TURN client
• added QoS options in pjsua-lib:
  • QoS fields in pjsua_transport_config
• added "--set-qos" parameter in pjsua

Notes:

• QoS in TLS transport is not yet implemented, waiting for #957
• build ok on VS6, VS2005 (multiple targets), Carbide, and Mingw
• no run-time testing yet

File:

• pjproject/trunk/pjnath/include/pjnath/ice_strans.h (modified) (2 diffs)

pjproject/trunk/pjnath/include/pjnath/ice_strans.h

@@ -272 +272 @@
     struct {
         /**
+         * Optional TURN socket settings. The default values will be
+         * initialized by #pj_turn_sock_cfg_default(). This contains
+         * settings such as QoS.
+         */
+        pj_turn_sock_cfg     cfg;
+
+        /**
          * Specify the TURN server domain or hostname or IP address.
          * If DNS SRV resolution is required, application must fill
@@ -324 +331 @@
 
     } turn;
+
+    /**
+     * Component specific settings, which will override the settings in
+     * the STUN and TURN settings above. For example, setting the QoS
+     * parameters here allows the application to have different QoS
+     * traffic type for RTP and RTCP component.
+     */
+    struct {
+        /**
+         * QoS traffic type to be set on this transport. When application
+         * wants to apply QoS tagging to the transport, it's preferable to
+         * set this field rather than \a qos_param fields since this is 
+         * more portable.
+         *
+         * Default value is PJ_QOS_TYPE_BEST_EFFORT.
+         */
+        pj_qos_type qos_type;
+
+        /**
+         * Set the low level QoS parameters to the transport. This is a 
+         * lower level operation than setting the \a qos_type field and
+         * may not be supported on all platforms.
+         *
+         * By default all settings in this structure are disabled.
+         */
+        pj_qos_params qos_params;
+
+    } comp[PJ_ICE_MAX_COMP];
 
 } pj_ice_strans_cfg;