sipsess: doxygen comments

This commit is contained in:
Richard Aas 2012-05-21 06:19:38 +00:00
parent 021746b3d0
commit 2c1b4c94d9
10 changed files with 132 additions and 5 deletions

View file

@ -56,4 +56,4 @@ int sipsess_modify(struct sipsess *sess, struct mbuf *desc);
int sipsess_info(struct sipsess *sess, const char *ctype, struct mbuf *body,
sip_resp_h *resph, void *arg);
void sipsess_close_all(struct sipsess_sock *sock);
struct sip_dialog *sipsess_dialog(struct sipsess *sess);
struct sip_dialog *sipsess_dialog(const struct sipsess *sess);

View file

@ -92,7 +92,6 @@ EXCLUDE = test.c \
src/md5/md5.h src/md5/md5.c \
src/dns include/re_dns.h \
src/sip/ include/re_sip.h \
src/sipsess/ include/re_sipsess.h \
src/stun include/re_stun.h
EXCLUDE_SYMLINKS = NO

View file

@ -41,6 +41,7 @@ static void destructor(void *arg)
* @param name Format name
* @param srate Sampling rate
* @param ch Number of channels
* @param ench Optional format encode handler
* @param cmph Optional format comparison handler
* @param data Opaque data for handler
* @param ref True to mem_ref() data

View file

@ -1,5 +1,5 @@
/**
* @file listen.c SIP Event Listen
* @file sipevent/listen.c SIP Event Listen
*
* Copyright (C) 2010 Creytiv.com
*/

View file

@ -33,6 +33,31 @@ static void cancel_handler(void *arg)
}
/**
* Accept an incoming SIP Session connection
*
* @param sessp Pointer to allocated SIP Session
* @param sock SIP Session socket
* @param msg Incoming SIP message
* @param scode Response status code
* @param reason Response reason phrase
* @param cuser Contact username
* @param ctype Session content-type
* @param desc Content description (e.g. SDP)
* @param authh SIP Authentication handler
* @param aarg Authentication handler argument
* @param aref True to mem_ref() aarg
* @param offerh Session offer handler
* @param answerh Session answer handler
* @param estabh Session established handler
* @param infoh Session info handler
* @param referh Session refer handler
* @param closeh Session close handler
* @param arg Handler argument
* @param fmt Formatted strings with extra SIP Headers
*
* @return 0 if success, otherwise errorcode
*/
int sipsess_accept(struct sipsess **sessp, struct sipsess_sock *sock,
const struct sip_msg *msg, uint16_t scode,
const char *reason, const char *cuser, const char *ctype,
@ -111,6 +136,17 @@ int sipsess_accept(struct sipsess **sessp, struct sipsess_sock *sock,
}
/**
* Send progress response
*
* @param sess SIP Session
* @param scode Response status code
* @param reason Response reason phrase
* @param desc Content description (e.g. SDP)
* @param fmt Formatted strings with extra SIP Headers
*
* @return 0 if success, otherwise errorcode
*/
int sipsess_progress(struct sipsess *sess, uint16_t scode, const char *reason,
struct mbuf *desc, const char *fmt, ...)
{
@ -146,6 +182,17 @@ int sipsess_progress(struct sipsess *sess, uint16_t scode, const char *reason,
}
/**
* Answer an incoming SIP Session connection
*
* @param sess SIP Session
* @param scode Response status code
* @param reason Response reason phrase
* @param desc Content description (e.g. SDP)
* @param fmt Formatted strings with extra SIP Headers
*
* @return 0 if success, otherwise errorcode
*/
int sipsess_answer(struct sipsess *sess, uint16_t scode, const char *reason,
struct mbuf *desc, const char *fmt, ...)
{
@ -164,6 +211,16 @@ int sipsess_answer(struct sipsess *sess, uint16_t scode, const char *reason,
}
/**
* Reject an incoming SIP Session connection
*
* @param sess SIP Session
* @param scode Response status code
* @param reason Response reason phrase
* @param fmt Formatted strings with extra SIP Headers
*
* @return 0 if success, otherwise errorcode
*/
int sipsess_reject(struct sipsess *sess, uint16_t scode, const char *reason,
const char *fmt, ...)
{

View file

@ -147,6 +147,34 @@ static int invite(struct sipsess *sess)
}
/**
* Connect to a remote SIP useragent
*
* @param sessp Pointer to allocated SIP Session
* @param sock SIP Session socket
* @param to_uri To SIP uri
* @param from_name From display name
* @param from_uri From SIP uri
* @param cuser Contact username
* @param routev Outbound route vector
* @param routec Outbound route vector count
* @param ctype Session content-type
* @param desc Content description (e.g. SDP)
* @param authh SIP Authentication handler
* @param aarg Authentication handler argument
* @param aref True to mem_ref() aarg
* @param offerh Session offer handler
* @param answerh Session answer handler
* @param progrh Session progress handler
* @param estabh Session established handler
* @param infoh Session info handler
* @param referh Session refer handler
* @param closeh Session close handler
* @param arg Handler argument
* @param fmt Formatted strings with extra SIP Headers
*
* @return 0 if success, otherwise errorcode
*/
int sipsess_connect(struct sipsess **sessp, struct sipsess_sock *sock,
const char *to_uri, const char *from_name,
const char *from_uri, const char *cuser,

View file

@ -87,6 +87,17 @@ static int info_request(struct sipsess_request *req)
}
/**
* Send a SIP INFO request in the SIP Session
*
* @param sess SIP Session
* @param ctype Content-type
* @param body Content description (e.g. SDP)
* @param resph Response handler
* @param arg Handler argument
*
* @return 0 if success, otherwise errorcode
*/
int sipsess_info(struct sipsess *sess, const char *ctype, struct mbuf *body,
sip_resp_h *resph, void *arg)
{

View file

@ -1,5 +1,5 @@
/**
* @file listen.c SIP Session Listen
* @file sipsess/listen.c SIP Session Listen
*
* Copyright (C) 2010 Creytiv.com
*/
@ -294,6 +294,17 @@ static bool response_handler(const struct sip_msg *msg, void *arg)
}
/**
* Listen to a SIP Session socket for incoming connections
*
* @param sockp Pointer to allocated SIP Session socket
* @param sip SIP Stack instance
* @param htsize Hashtable size
* @param connh Connection handler
* @param arg Handler argument
*
* @return 0 if success, otherwise errorcode
*/
int sipsess_listen(struct sipsess_sock **sockp, struct sip *sip,
int htsize, sipsess_conn_h *connh, void *arg)
{
@ -337,6 +348,11 @@ int sipsess_listen(struct sipsess_sock **sockp, struct sip *sip,
}
/**
* Close all SIP Sessions
*
* @param sock SIP Session socket
*/
void sipsess_close_all(struct sipsess_sock *sock)
{
if (!sock)

View file

@ -143,6 +143,14 @@ int sipsess_reinvite(struct sipsess *sess, bool reset_ls)
}
/**
* Modify an established SIP Session sending Re-INVITE or UPDATE
*
* @param sess SIP Session
* @param desc Content description (e.g. SDP)
*
* @return 0 if success, otherwise errorcode
*/
int sipsess_modify(struct sipsess *sess, struct mbuf *desc)
{
if (!sess || sess->st || sess->terminated)

View file

@ -220,7 +220,14 @@ void sipsess_terminate(struct sipsess *sess, int err,
}
struct sip_dialog *sipsess_dialog(struct sipsess *sess)
/**
* Get the SIP dialog from a SIP Session
*
* @param sess SIP Session
*
* @return SIP Dialog object
*/
struct sip_dialog *sipsess_dialog(const struct sipsess *sess)
{
return sess ? sess->dlg : NULL;
}