Changeset 2855 for pjproject/trunk/pjsip/include/pjsip/sip_util.h

Timestamp:

Aug 5, 2009 6:41:23 PM (15 years ago)

Author:

nanang

Message:

Ticket #930:

• Updated semantic of contact param in functions pjsip_dlg_create_uac(), pjsip_dlg_create_uas(), pjsip_endpt_create_request() and also variable pjsua_acc.contact to be Contact header value (was Contact URI).
• Updated docs related to above modifications.
• Fixed pjsua_im_send() in generating contact header, it should use pjsua_acc.contact instead, if it is set.

File:

• pjproject/trunk/pjsip/include/pjsip/sip_util.h (modified) (2 diffs)

pjproject/trunk/pjsip/include/pjsip/sip_util.h

@@ -244 +244 @@
  * @param from      URL to put in From header.
  * @param to        URL to put in To header.
- * @param contact   URL to put in Contact header.
+ * @param contact   Contact to be put as Contact header value, hence
+ *                  the format must follow RFC 3261 Section 20.10:
+ *                  When the header field value contains a display 
+ *                  name, the URI including all URI parameters is 
+ *                  enclosed in "<" and ">".  If no "<" and ">" are 
+ *                  present, all parameters after the URI are header
+ *                  parameters, not URI parameters.  The display name 
+ *                  can be tokens, or a quoted string, if a larger 
+ *                  character set is desired.
  * @param call_id   Optional Call-ID (put NULL to generate unique Call-ID).
  * @param cseq      Optional CSeq (put -1 to generate random CSeq).
@@ -281 +289 @@
  * @param method    SIP Method.
  * @param target    Target URI.
- * @param from      URL to put in From header.
- * @param to        URL to put in To header.
- * @param contact   URL to put in Contact header.
+ * @param from      From header.
+ * @param to        To header.
+ * @param contact   Contact header.
  * @param call_id   Optional Call-ID (put NULL to generate unique Call-ID).
  * @param cseq      Optional CSeq (put -1 to generate random CSeq).