Changeset 685 for pjproject/trunk/pjsip/include/pjsip-simple/publish.h

Timestamp:

Aug 15, 2006 8:26:34 PM (18 years ago)

Author:

bennylp

Message:

Support for PUBLISH (RFC 3903):

• API BREAK: pjsua_pres_create_uac() API CHANGED!! Added options in the function, to allow creating SUBSCRIBE without ";id=" parameter in the Event header.
• the generic event publication in pjsip-simple/publish.[hc]
• split PIDF and X-PIDF body generation and parsing into pjsip-simple/presence_body.c.
• allow NULL in module parameter in pjsip_endpt_add_capability()
• added "--publish" option in PJSUA.
• by default, PJSUA-LIB will not add ";id=" parameter in Event header in the SUBSCRIBE request since lots of server and user agents don't support this correctly.
• Set version to 0.5.7.6.

File:

• pjproject/trunk/pjsip/include/pjsip-simple/publish.h (modified) (7 diffs)

pjproject/trunk/pjsip/include/pjsip-simple/publish.h

@@ -17 +17 @@
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA 
  */
-#ifndef __PJSIP_SIMPLE_PRESENCE_H__
-#define __PJSIP_SIMPLE_PRESENCE_H__
+#ifndef __PJSIP_SIMPLE_PUBLISH_H__
+#define __PJSIP_SIMPLE_PUBLISH_H__
 
 /**
@@ -24 +24 @@
  * @brief SIP Extension for Event State Publication (PUBLISH, RFC 3903)
  */
+
+#include <pjsip/sip_util.h>
 
 
@@ -38 +40 @@
  Extension for Event State Publication (PUBLISH) as defined by RFC 3856.
  */
+
+/**
+ * The SIP PUBLISH method constant.
+ */
+extern const pjsip_method pjsip_publish_method;
 
 
@@ -78 +85 @@
 
 
+/**
+ * Initialize client publication module.
+ *
+ * @param endpt     SIP endpoint.
+ *
+ * @return          PJ_SUCCESS on success.
+ */
+PJ_DECL(pj_status_t) pjsip_publishc_init_module(pjsip_endpoint *endpt);
+
+
 
 /**
@@ -83 +100 @@
  *
  * @param endpt     Endpoint, used to allocate pool from.
+ * @param options   Option flags.
  * @param token     Opaque data to be associated with the client publication.
  * @param cb        Pointer to callback function to receive publication status.
@@ -90 +108 @@
  */
 PJ_DECL(pj_status_t) pjsip_publishc_create( pjsip_endpoint *endpt, 
+                                            unsigned options,
                                             void *token,
                                             pjsip_publishc_cb *cb, 
@@ -249 +268 @@
 
 
-#endif  /* __PJSIP_SIMPLE_PRESENCE_H__ */
-
+#endif  /* __PJSIP_SIMPLE_PUBLISH_H__ */
+