Changeset 3028 for pjproject/trunk/pjnath/include/pjnath/turn_session.h

Timestamp:

Dec 8, 2009 1:11:25 PM (14 years ago)

Author:

bennylp

Message:

Fixed ticket #999:

Several bug fixes to the TURN client library and icedemo sample application:

1. ICE stream transport reports ICE initialization/candidate gathering stage as successful even when TURN client TCP connection has failed.
2. Bad ChannelData? framing when TCP is used. PJNATH did not properly add padding to the TURN ChannelData? packet if TCP is used and the data is not aligned to four bytes boundary. Similarly incoming ChannelData? with padding (over TCP) may not be handled correctly.
3. Incoming data over TCP may be delayed. PJNATH only processed one frame (be it request, indication, or ChannelData?) on an incoming stream, so if the stream contains more than one frames, the processing of subsequent frames will be delayed until more stream is received on the TCP transport.
4. The icedemo sample application overwrites the incoming packet buffer with NULL character ('\0') before printing the message to console. If there is another packet after current packet (as often happens when TCP is used), the subsequent packet will get corrupted.

The combinations of bugs above may cause PJNATH to return "Invalid STUN message length (PJNATH_EINSTUNMSGLEN)" error when processing incoming TURN ChannelData? message over TCP.

And a small enhancement:

1. Add logging to file option to icedemo sample.

Thanks Sarun Nandakumar for the report.

File:

• pjproject/trunk/pjnath/include/pjnath/turn_session.h (modified) (1 diff)

pjproject/trunk/pjnath/include/pjnath/turn_session.h

@@ -456 +456 @@
  *
  * @param sess          The TURN client session.
+ * @param last_err      Optional error code to be set to the session,
+ *                      which would be returned back in the \a info
+ *                      parameter of #pj_turn_session_get_info(). If
+ *                      this argument value is PJ_SUCCESS, the error
+ *                      code will not be set. If the session already
+ *                      has an error code set, this function will not
+ *                      overwrite that error code either.
  *
  * @return              PJ_SUCCESS if the operation has been successful,
  *                      or the appropriate error code on failure.
  */
-PJ_DECL(pj_status_t) pj_turn_session_destroy(pj_turn_session *sess);
+PJ_DECL(pj_status_t) pj_turn_session_destroy(pj_turn_session *sess,
+                                             pj_status_t last_err);