eXosip2 SUBSCRIBE and outgoing subscriptions

Enumerations
enum	eXosip_ss { EXOSIP_SUBCRSTATE_UNKNOWN, EXOSIP_SUBCRSTATE_PENDING, EXOSIP_SUBCRSTATE_ACTIVE, EXOSIP_SUBCRSTATE_TERMINATED }
	Structure for subscription status. More...
enum	eXosip_ss_reason {   DEACTIVATED, PROBATION, REJECTED, TIMEOUT,   GIVEUP, NORESOURCE }
	Structure for subscription reason. More...
enum	eXosip_ss_status {   EXOSIP_NOTIFY_UNKNOWN, EXOSIP_NOTIFY_PENDING, EXOSIP_NOTIFY_ONLINE, EXOSIP_NOTIFY_BUSY,   EXOSIP_NOTIFY_BERIGHTBACK, EXOSIP_NOTIFY_AWAY, EXOSIP_NOTIFY_ONTHEPHONE, EXOSIP_NOTIFY_OUTTOLUNCH,   EXOSIP_NOTIFY_CLOSED }
	Structure for notification status. More...

Functions
int	eXosip_subscribe_build_initial_request (struct eXosip_t *excontext, osip_message_t **subscribe, const char *to, const char *from, const char *route, const char *event, int expires)
	Build a default initial SUBSCRIBE request. More...
int	eXosip_subscribe_send_initial_request (struct eXosip_t *excontext, osip_message_t *subscribe)
	Send an initial SUBSCRIBE request. More...
int	eXosip_subscribe_build_refresh_request (struct eXosip_t *excontext, int did, osip_message_t **sub)
	Build a default new SUBSCRIBE message. More...
int	eXosip_subscribe_send_refresh_request (struct eXosip_t *excontext, int did, osip_message_t *sub)
	Send a new SUBSCRIBE request. More...
int	eXosip_subscribe_remove (struct eXosip_t *excontext, int did)
	Remove outgoing subscription context. More...

Detailed Description

Enumeration Type Documentation

enum eXosip_ss

#include <eX_subscribe.h>

Structure for subscription status.

Enumerator
EXOSIP_SUBCRSTATE_UNKNOWN	unknown subscription-state
EXOSIP_SUBCRSTATE_PENDING	pending subscription-state
EXOSIP_SUBCRSTATE_ACTIVE	active subscription-state
EXOSIP_SUBCRSTATE_TERMINATED	terminated subscription-state

Definition at line 60 of file eX_subscribe.h.

enum eXosip_ss_reason

#include <eX_subscribe.h>

Structure for subscription reason.

Enumerator
DEACTIVATED	deactivated for subscription-state
PROBATION	probation for subscription-state
REJECTED	rejected for subscription-state
TIMEOUT	timeout for subscription-state
GIVEUP	giveup for subscription-state
NORESOURCE	noresource for subscription-state

Definition at line 71 of file eX_subscribe.h.

enum eXosip_ss_status

#include <eX_subscribe.h>

Structure for notification status.

Enumerator
EXOSIP_NOTIFY_UNKNOWN	unknown state for subscription
EXOSIP_NOTIFY_PENDING	subscription not yet accepted
EXOSIP_NOTIFY_ONLINE	online status
EXOSIP_NOTIFY_BUSY	busy status
EXOSIP_NOTIFY_BERIGHTBACK	be right back status
EXOSIP_NOTIFY_AWAY	away status
EXOSIP_NOTIFY_ONTHEPHONE	on the phone status
EXOSIP_NOTIFY_OUTTOLUNCH	out to lunch status
EXOSIP_NOTIFY_CLOSED	closed status

Definition at line 84 of file eX_subscribe.h.

Function Documentation

int eXosip_subscribe_build_initial_request	(	struct eXosip_t *	excontext,
		osip_message_t **	subscribe,
		const char *	to,
		const char *	from,
		const char *	route,
		const char *	event,
		int	expires
	)

#include <eX_subscribe.h>

Build a default initial SUBSCRIBE request.

Parameters

excontext	eXosip_t instance.
subscribe	Pointer for the SIP request to build.
to	SIP url for callee.
from	SIP url for caller.
route	Route header for SUBSCRIBE. (optional)
event	Event header for SUBSCRIBE.
expires	Expires header for SUBSCRIBE.

int eXosip_subscribe_build_refresh_request	(	struct eXosip_t *	excontext,
		int	did,
		osip_message_t **	sub
	)

#include <eX_subscribe.h>

Build a default new SUBSCRIBE message.

Parameters

excontext	eXosip_t instance.
did	identifier of the subscription.
sub	Pointer for the SIP request to build.

int eXosip_subscribe_remove	(	struct eXosip_t *	excontext,
		int	did
	)

#include <eX_subscribe.h>

Remove outgoing subscription context.

Parameters

excontext	eXosip_t instance.
did	identifier of the subscription.

int eXosip_subscribe_send_initial_request	(	struct eXosip_t *	excontext,
		osip_message_t *	subscribe
	)

#include <eX_subscribe.h>

Send an initial SUBSCRIBE request.

Parameters

excontext	eXosip_t instance.
subscribe	SIP SUBSCRIBE message to send.

int eXosip_subscribe_send_refresh_request	(	struct eXosip_t *	excontext,
		int	did,
		osip_message_t *	sub
	)

#include <eX_subscribe.h>

Send a new SUBSCRIBE request.

Parameters

excontext	eXosip_t instance.
did	identifier of the subscription.
sub	SIP SUBSCRIBE message to send.