Changeset 1034 for pjproject/trunk/pjlib-util/include/pjlib-util/stun_session.h

Timestamp:

Mar 2, 2007 7:06:05 PM (17 years ago)

Author:

bennylp

Message:

Finishing up client-side STUN authentication, a simple STUN client, and simple STUN server

File:

• pjproject/trunk/pjlib-util/include/pjlib-util/stun_session.h (modified) (7 diffs)

pjproject/trunk/pjlib-util/include/pjlib-util/stun_session.h

@@ -24 +24 @@
 #include <pjlib-util/stun_transaction.h>
 #include <pj/list.h>
+#include <pj/timer.h>
 
 PJ_BEGIN_DECL
@@ -140 +141 @@
 
     pj_stun_client_tsx  *client_tsx;    /**< Client STUN transaction.       */
-    pj_uint8_t           client_key[12];/**< Client transaction key.        */
+    pj_uint32_t          msg_magic;     /**< Message magic.                 */
+    pj_uint8_t           msg_key[12];   /**< Message/transaction key.       */
 
     void                *pkt;           /**< The STUN packet.               */
@@ -146 +148 @@
     unsigned             pkt_size;      /**< The actual length of STUN pkt. */
 
+    unsigned             options;       /**< Options specified when sending */
     unsigned             addr_len;      /**< Length of destination address. */
     const pj_sockaddr_t *dst_addr;      /**< Destination address.           */
+
+    pj_timer_entry       res_timer;     /**< Response cache timer.          */
 };
 
@@ -155 +160 @@
  * messages. These options may be specified as bitmask.
  */
-enum pj_stun_session_option
+enum pj_stun_session_send_option
 {
     /**
@@ -172 +177 @@
      * Add STUN fingerprint to the message.
      */
-    PJ_STUN_USE_FINGERPRINT     = 4
+    PJ_STUN_USE_FINGERPRINT     = 4,
+
+    /**
+     * Instruct the session to cache outgoing response. This can only be 
+     * used when sending outgoing response message, and when it's specified,
+     * the session will use \a res_cache_msec settings in pj_stun_endpoint
+     * as the duration of the cache.
+     */
+    PJ_STUN_CACHE_RESPONSE      = 8
 };
 
@@ -258 +271 @@
                                           const pj_str_t *user,
                                           const pj_str_t *passwd);
+
 
 /**
@@ -396 +410 @@
  *
  * @param sess      The STUN session instance.
- * @param options   Optional flags, from pj_stun_session_option.
+ * @param options   Optional flags, from pj_stun_session_send_option.
  * @param dst_addr  The destination socket address.
  * @param addr_len  Length of destination address.