Changes between Version 7 and Version 8 of IPv6

Timestamp:

May 13, 2016 8:22:23 AM (9 years ago)

Author:

nanang

Comment:

Add sample codes for enabling IPv6 in app

IPv6

@@ -1 +1 @@
 = IPv6 support =
+
+[[PageOutline(2-3,,inline)]]
 
 == Availability ==
 
 IPv6 support is available in the following platforms:
- - Windows XP, Windows Server 2003, and Windows Vista, using Microsoft Platform SDK for Windows Server 2003 SP1
+ - Windows families, e.g.: Windows 7/8/10, Windows XP, Windows Server 2003, and Windows Vista, using Microsoft Platform SDK for Windows Server 2003 SP1
+ - !Linux/Unix/MacOS X with GNU development systems, IPv6 features are detected by the {{{./configure}}} script.
+ - iOS
  - Symbian
- - On !Linux/Unix/MacOS X with GNU development systems, IPv6 features are detected by the {{{./configure}}} script.
 
 Note about Windows 2000:
@@ -88 +91 @@
 
 The work for adding IPv6 support in pjnath is documented by ticket #422.
+
+
+== Enabling IPv6 support in application using PJSUA ==
+
+Application needs to configure SIP transport and SIP account with IPv6 support.
+
+=== Creating SIP transport ===
+
+Here is sample code for IPv6 SIP transport initializations.
+
+ {{{
+        pjsua_transport_config tp_cfg;
+        pjsip_transport_type_e tp_type;
+        pjsua_transport_id     tp_id = -1;
+
+        pjsua_transport_config_default(&tp_cfg);
+        tp_cfg.port = 5060;
+
+        /* TCP */
+        tp_type = PJSIP_TRANSPORT_TCP6;
+        status = pjsua_transport_create(tp_type, &tp_cfg, &tp_id);
+        if (status != PJ_SUCCESS)
+            ...
+
+        /* UDP */
+        tp_type = PJSIP_TRANSPORT_UDP6;
+        status = pjsua_transport_create(tp_type, &tp_cfg, &tp_id);
+        if (status != PJ_SUCCESS)
+            ...
+
+        /* TLS */
+        tp_type = PJSIP_TRANSPORT_TLS6;
+        tp_cfg.port = 5061;
+        tp_cfg.tls_setting.ca_list_file = pj_str("<path to CA file>");
+        tp_cfg.tls_setting.cert_file    = ...;
+        tp_cfg.tls_setting.privkey_file = ...;
+        tp_cfg.tls_setting.password     = ...;
+        status = pjsua_transport_create(tp_type, &tp_cfg, &tp_id);
+        if (status != PJ_SUCCESS)
+            ...
+ }}}
+
+
+=== Adding SIP Account ===
+
+Here is sample code for setting up account using IPv6 SIP server.
+
+{{{
+        #define SIP_USER        "user"
+        #define SIP_SERVER      "example.com"
+        #define SIP_SERVER_IPv6 "1234::5678"
+        #define SIP_PASSWD      "pwd"
+
+        pjsua_acc_config acc_cfg;
+        pjsua_acc_config_default(&acc_cfg);
+
+        acc_cfg.id         = pj_str("sip:" SIP_USER "@" SIP_SERVER);
+        acc_cfg.reg_uri    = pj_str("sip:" SIP_SERVER);
+        acc_cfg.cred_count = 1;
+        acc_cfg.cred_info[0].realm     = pj_str("*");
+        acc_cfg.cred_info[0].scheme    = pj_str("digest");
+        acc_cfg.cred_info[0].username  = pj_str(SIP_USER);
+        acc_cfg.cred_info[0].data_type = PJSIP_CRED_DATA_PLAIN_PASSWD;
+        acc_cfg.cred_info[0].data      = pj_str(SIP_PASSWD);
+
+        /* As currently IPv6 DNS resolution is not supported yet, application should resolve it manually, e.g: using getaddrinfo(), and set the IPv6 address via proxy setting */
+        /* Note that application may add 'hide' param to hide the proxy setting from the message (this is PJSIP proprietary feature) */
+        acc_cfg.proxy_cnt = 1;
+        acc_cfg.proxy[0]  = pj_str("sip:" SIP_SERVER_IPv6 ";lr;hide");
+
+        /* Enable IPv6 in media transport */
+        acc_cfg.ipv6_media_use = PJSUA_IPV6_ENABLED;
+
+        /* Finally */
+        status = pjsua_acc_add(&acc_cfg, PJ_TRUE, NULL);
+        if (status != PJ_SUCCESS)
+            ...
+}}}