Changeset 1021 for pjproject/trunk/pjlib-util/include/pjlib-util/stun_msg.h

Timestamp:

Mar 1, 2007 12:08:27 AM (17 years ago)

Author:

bennylp

Message:

More work on STUN session framework

File:

• pjproject/trunk/pjlib-util/include/pjlib-util/stun_msg.h (modified) (6 diffs)

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

@@ -1175 +1175 @@
  * the FINGERPRINT CRC attribute for the message.
  *
- * @param msg           The STUN message to be printed.
+ * @param msg           The STUN message to be printed. Upon return,
+ *                      some fields in the header (such as message
+ *                      length) will be updated.
  * @param pkt_buf       The buffer to be filled with the packet.
  * @param buf_size      Size of the buffer.
@@ -1187 +1189 @@
  * @return              PJ_SUCCESS on success or the appropriate error code.
  */
-PJ_DECL(pj_status_t) pj_stun_msg_encode(const pj_stun_msg *msg,
+PJ_DECL(pj_status_t) pj_stun_msg_encode(pj_stun_msg *msg,
                                         pj_uint8_t *pkt_buf,
                                         unsigned buf_size,
@@ -1423 +1425 @@
  * @param xor_ed        If non-zero, the port and address will be XOR-ed
  *                      with magic, to make the XOR-MAPPED-ADDRESS attribute.
+ * @param addr          A pj_sockaddr_in or pj_sockaddr_in6 structure.
  * @param addr_len      Length of \a addr parameter.
- * @param addr          A pj_sockaddr_in or pj_sockaddr_in6 structure.
  * @param p_attr        Pointer to receive the attribute.
  *
@@ -1433 +1435 @@
                                     int attr_type, 
                                     pj_bool_t xor_ed,
+                                    const pj_sockaddr_t *addr,
                                     unsigned addr_len,
-                                    const pj_sockaddr_t *addr,
                                     pj_stun_generic_ip_addr_attr **p_attr);
 
@@ -1448 +1450 @@
  * @param xor_ed        If non-zero, the port and address will be XOR-ed
  *                      with magic, to make the XOR-MAPPED-ADDRESS attribute.
+ * @param addr          A pj_sockaddr_in or pj_sockaddr_in6 structure.
  * @param addr_len      Length of \a addr parameter.
- * @param addr          A pj_sockaddr_in or pj_sockaddr_in6 structure.
  *
  * @return              PJ_SUCCESS on success or the appropriate error code.
@@ -1458 +1460 @@
                                      int attr_type, 
                                      pj_bool_t xor_ed,
-                                     unsigned addr_len,
-                                     const pj_sockaddr_t *addr);
+                                     const pj_sockaddr_t *addr,
+                                     unsigned addr_len);
 
 /**