diff options
author | Benny Prijono <bennylp@teluu.com> | 2009-04-22 17:20:24 +0000 |
---|---|---|
committer | Benny Prijono <bennylp@teluu.com> | 2009-04-22 17:20:24 +0000 |
commit | 0b54cf857cd757da2571a62845894c67fb9e8ecf (patch) | |
tree | 50eb7b0b8d4a96314424c35b75f9b99770f8960a /pjnath/include/pjnath/stun_sock.h | |
parent | 114bf49a36bd6f5b956ab4fd45cbe97929c17e38 (diff) |
Part of ticket #780: enhance the PJNATH doxygen documentation
git-svn-id: http://svn.pjsip.org/repos/pjproject/trunk@2642 74dad513-b988-da41-8d7b-12977e46ad98
Diffstat (limited to 'pjnath/include/pjnath/stun_sock.h')
-rw-r--r-- | pjnath/include/pjnath/stun_sock.h | 34 |
1 files changed, 21 insertions, 13 deletions
diff --git a/pjnath/include/pjnath/stun_sock.h b/pjnath/include/pjnath/stun_sock.h index 5dcaad2b..b196b325 100644 --- a/pjnath/include/pjnath/stun_sock.h +++ b/pjnath/include/pjnath/stun_sock.h @@ -34,16 +34,24 @@ PJ_BEGIN_DECL /** - * @defgroup PJNATH_STUN_SOCK STUN aware socket transport - * @brief STUN aware socket transport - * @ingroup PJNATH_STUN + * @addtogroup PJNATH_STUN_SOCK * @{ * * The STUN transport provides asynchronous UDP like socket transport - * with the additional capability to query the publicly mapped transport - * address (using STUN resolution), to refresh the NAT binding, and to - * demultiplex internal STUN messages from application data (the - * application data may be a STUN message as well). + * with the additional STUN capability. It has the following features: + * + * - API to send and receive UDP packets + * + * - multiplex STUN and non-STUN incoming packets and distinguish between + * STUN responses that belong to internal requests with application data + * (the application data may be STUN packets as well) + * + * - DNS SRV resolution to the STUN server (if wanted), along with fallback + * to DNS A resolution if SRV record is not found. + * + * - STUN keep-alive maintenance, and handle changes to the mapped address + * (when the NAT binding changes) + * */ /** @@ -275,7 +283,7 @@ PJ_DECL(void) pj_stun_sock_cfg_default(pj_stun_sock_cfg *cfg); * this transport. * @param p_sock Pointer to receive the created transport instance. * - * @restun PJ_SUCCESS if the operation has been successful, + * @return PJ_SUCCESS if the operation has been successful, * or the appropriate error code on failure. */ PJ_DECL(pj_status_t) pj_stun_sock_create(pj_stun_config *stun_cfg, @@ -327,7 +335,7 @@ PJ_DECL(pj_status_t) pj_stun_sock_start(pj_stun_sock *stun_sock, * * @param sock The STUN transport socket. * - * @restun PJ_SUCCESS if the operation has been successful, + * @return PJ_SUCCESS if the operation has been successful, * or the appropriate error code on failure. */ PJ_DECL(pj_status_t) pj_stun_sock_destroy(pj_stun_sock *sock); @@ -340,7 +348,7 @@ PJ_DECL(pj_status_t) pj_stun_sock_destroy(pj_stun_sock *sock); * @param stun_sock The STUN transport instance. * @param user_data Arbitrary data. * - * @restun PJ_SUCCESS if the operation has been successful, + * @return PJ_SUCCESS if the operation has been successful, * or the appropriate error code on failure. */ PJ_DECL(pj_status_t) pj_stun_sock_set_user_data(pj_stun_sock *stun_sock, @@ -352,7 +360,7 @@ PJ_DECL(pj_status_t) pj_stun_sock_set_user_data(pj_stun_sock *stun_sock, * * @param stun_sock The STUN transport instance. * - * @restun The user/application data. + * @return The user/application data. */ PJ_DECL(void*) pj_stun_sock_get_user_data(pj_stun_sock *stun_sock); @@ -364,7 +372,7 @@ PJ_DECL(void*) pj_stun_sock_get_user_data(pj_stun_sock *stun_sock); * @param stun_sock The STUN transport instance. * @param info Pointer to be filled with STUN transport info. * - * @restun PJ_SUCCESS if the operation has been successful, + * @return PJ_SUCCESS if the operation has been successful, * or the appropriate error code on failure. */ PJ_DECL(pj_status_t) pj_stun_sock_get_info(pj_stun_sock *stun_sock, @@ -376,7 +384,7 @@ PJ_DECL(pj_status_t) pj_stun_sock_get_info(pj_stun_sock *stun_sock, * asynchronously and in this case \a on_data_sent() will be called. * * @param stun_sock The STUN transport instance. - * @param op_key Optional send key for sending the packet down to + * @param send_key Optional send key for sending the packet down to * the ioqueue. This value will be given back to * \a on_data_sent() callback * @param pkt The data/packet to be sent to peer. |