Changeset 720

Timestamp:

Sep 14, 2006 4:07:49 PM (18 years ago)

Author:

bennylp

Message:

Added pjsip_transport_register_type() API to register new transport type.

Location:

pjproject/trunk/pjsip

Files:

• include/pjsip/sip_transport.h (modified) (1 diff)
• include/pjsip/sip_types.h (modified) (1 diff)
• src/pjsip/sip_transport.c (modified) (3 diffs)

pjproject/trunk/pjsip/include/pjsip/sip_transport.h

@@ -79 +79 @@
 #define PJSIP_TRANSPORT_IS_SECURE(tp)       \
             ((tp)->flag & PJSIP_TRANSPORT_SECURE)
+
+/**
+ * Register new transport type to PJSIP. The PJSIP transport framework
+ * contains the info for some standard transports, as declared by
+ * #pjsip_transport_type_e. Application may use non-standard transport
+ * with PJSIP, but before it does so, it must register the information
+ * about the new transport type to PJSIP by calling this function.
+ *
+ * @param tp_flag   The flags describing characteristics of this
+ *                  transport type.
+ * @param tp_name   Transport type name.
+ * @param def_port  Default port to be used for the transport.
+ * @param p_tp_type On successful registration, it will be filled with
+ *                  the registered type. This argument is optional.
+ *
+ * @return          PJ_SUCCESS if registration is successful, or
+ *                  PJSIP_ETYPEEXISTS if the same transport type has
+ *                  already been registered.
+ */
+PJ_DECL(pj_status_t) pjsip_transport_register_type(unsigned tp_flag,
+                                                   const char *tp_name,
+                                                   int def_port,
+                                                   int *p_tp_type);
+
 
 /**

pjproject/trunk/pjsip/include/pjsip/sip_types.h

@@ -80 +80 @@
 
     /** Loopback (datagram, unreliable) */
-    PJSIP_TRANSPORT_LOOP_DGRAM
+    PJSIP_TRANSPORT_LOOP_DGRAM,
+
+    /** Start of user defined transport */
+    PJSIP_TRANSPORT_START_OTHER
 
 } pjsip_transport_type_e;

pjproject/trunk/pjsip/src/pjsip/sip_transport.c

@@ -98 +98 @@
  * Transport names.
  */
-const struct
+struct
 {
     pjsip_transport_type_e type;
@@ -104 +104 @@
     pj_str_t               name;
     unsigned               flag;
-} transport_names[] = 
+    char                   name_buf[16];
+} transport_names[16] = 
 {
     { PJSIP_TRANSPORT_UNSPECIFIED, 0, {"Unspecified", 11}, 0},
@@ -114 +115 @@
     { PJSIP_TRANSPORT_LOOP_DGRAM, 15060, {"LOOP-DGRAM", 10}, PJSIP_TRANSPORT_DATAGRAM},
 };
+
+
+/*
+ * Register new transport type to PJSIP.
+ */
+PJ_DECL(pj_status_t) pjsip_transport_register_type(unsigned tp_flag,
+                                                   const char *tp_name,
+                                                   int def_port,
+                                                   int *p_tp_type)
+{
+    unsigned i;
+
+    PJ_ASSERT_RETURN(tp_flag && tp_name && def_port, PJ_EINVAL);
+    PJ_ASSERT_RETURN(pj_ansi_strlen(tp_name) < 
+                        PJ_ARRAY_SIZE(transport_names[0].name_buf), 
+                     PJ_ENAMETOOLONG);
+
+    for (i=1; i<PJ_ARRAY_SIZE(transport_names); ++i) {
+        if (transport_names[i].type == 0)
+            break;
+    }
+
+    if (i == PJ_ARRAY_SIZE(transport_names))
+        return PJ_ETOOMANY;
+
+    transport_names[i].type = (pjsip_transport_type_e)i;
+    transport_names[i].port = (pj_uint16_t)def_port;
+    pj_ansi_strcpy(transport_names[i].name_buf, tp_name);
+    transport_names[i].name = pj_str(transport_names[i].name_buf);
+    transport_names[i].flag = tp_flag;
+
+    if (p_tp_type)
+        *p_tp_type = i;
+
+    return PJ_SUCCESS;
+}