conn: fixed doxygen comments
This commit is contained in:
17
src/conn.c
17
src/conn.c
@@ -608,6 +608,8 @@ void xmpp_disconnect(xmpp_conn_t * const conn)
|
|||||||
* @param conn a Strophe connection object
|
* @param conn a Strophe connection object
|
||||||
* @param fmt a printf-style format string followed by a variable list of
|
* @param fmt a printf-style format string followed by a variable list of
|
||||||
* arguments to format
|
* arguments to format
|
||||||
|
*
|
||||||
|
* @ingroup Connections
|
||||||
*/
|
*/
|
||||||
void xmpp_send_raw_string(xmpp_conn_t * const conn,
|
void xmpp_send_raw_string(xmpp_conn_t * const conn,
|
||||||
const char * const fmt, ...)
|
const char * const fmt, ...)
|
||||||
@@ -656,6 +658,8 @@ void xmpp_send_raw_string(xmpp_conn_t * const conn,
|
|||||||
* @param conn a Strophe connection object
|
* @param conn a Strophe connection object
|
||||||
* @param data a buffer of raw bytes
|
* @param data a buffer of raw bytes
|
||||||
* @param len the length of the data in the buffer
|
* @param len the length of the data in the buffer
|
||||||
|
*
|
||||||
|
* @ingroup Connections
|
||||||
*/
|
*/
|
||||||
void xmpp_send_raw(xmpp_conn_t * const conn,
|
void xmpp_send_raw(xmpp_conn_t * const conn,
|
||||||
const char * const data, const size_t len)
|
const char * const data, const size_t len)
|
||||||
@@ -773,6 +777,8 @@ int conn_tls_start(xmpp_conn_t * const conn)
|
|||||||
* @param conn a Strophe connection object
|
* @param conn a Strophe connection object
|
||||||
*
|
*
|
||||||
* @return ORed connection flags that are applied for the connection.
|
* @return ORed connection flags that are applied for the connection.
|
||||||
|
*
|
||||||
|
* @ingroup Connections
|
||||||
*/
|
*/
|
||||||
long xmpp_conn_get_flags(const xmpp_conn_t * const conn)
|
long xmpp_conn_get_flags(const xmpp_conn_t * const conn)
|
||||||
{
|
{
|
||||||
@@ -802,6 +808,8 @@ long xmpp_conn_get_flags(const xmpp_conn_t * const conn)
|
|||||||
* @param flags ORed connection flags
|
* @param flags ORed connection flags
|
||||||
*
|
*
|
||||||
* @return 0 on success or -1 if flags can't be applied.
|
* @return 0 on success or -1 if flags can't be applied.
|
||||||
|
*
|
||||||
|
* @ingroup Connections
|
||||||
*/
|
*/
|
||||||
int xmpp_conn_set_flags(xmpp_conn_t * const conn, long flags)
|
int xmpp_conn_set_flags(xmpp_conn_t * const conn, long flags)
|
||||||
{
|
{
|
||||||
@@ -831,6 +839,8 @@ int xmpp_conn_set_flags(xmpp_conn_t * const conn, long flags)
|
|||||||
*
|
*
|
||||||
* @note this function is deprecated
|
* @note this function is deprecated
|
||||||
* @see xmpp_conn_set_flags()
|
* @see xmpp_conn_set_flags()
|
||||||
|
*
|
||||||
|
* @ingroup Connections
|
||||||
*/
|
*/
|
||||||
void xmpp_conn_disable_tls(xmpp_conn_t * const conn)
|
void xmpp_conn_disable_tls(xmpp_conn_t * const conn)
|
||||||
{
|
{
|
||||||
@@ -840,7 +850,12 @@ void xmpp_conn_disable_tls(xmpp_conn_t * const conn)
|
|||||||
(void)xmpp_conn_set_flags(conn, flags);
|
(void)xmpp_conn_set_flags(conn, flags);
|
||||||
}
|
}
|
||||||
|
|
||||||
/** Returns whether TLS session is established or not. */
|
/** Return whether TLS session is established or not.
|
||||||
|
*
|
||||||
|
* @return TRUE if TLS session is established and FALSE otherwise
|
||||||
|
*
|
||||||
|
* @ingroup Connections
|
||||||
|
*/
|
||||||
int xmpp_conn_is_secured(xmpp_conn_t * const conn)
|
int xmpp_conn_is_secured(xmpp_conn_t * const conn)
|
||||||
{
|
{
|
||||||
return conn->secured && !conn->tls_failed && conn->tls != NULL ? 1 : 0;
|
return conn->secured && !conn->tls_failed && conn->tls != NULL ? 1 : 0;
|
||||||
|
|||||||
Reference in New Issue
Block a user