Asterisk
/
asterisk
mirror of https://github.com/asterisk/asterisk
1
0
Fork 0
Code Issues Releases Wiki Activity

res: Fix for Doxygen.

Browse Source 
These are the remaining issues found in /res.

ASTERISK-29761

Change-Id: I572e6019c422780dde5ce8448b6c85c77af6046d
16.24
Alexander Traud 4 years ago committed by Friendly Automation
parent 3162f6dfdd
commit 14736ae6d4
32 changed files with 104 additions and 147 deletions
Show Stats Download Patch File Download Diff File

3
include/asterisk/calendar.h
Unescape View File

@ -152,9 +152,6 @@ int ast_calendar_register(struct ast_calendar_tech *tech);
/*! \brief Unregister a new calendar technology /*! \brief Unregister a new calendar technology
* *
* \param tech calendar technology to unregister * \param tech calendar technology to unregister
*
* \retval 0 success
* \retval -1 failure
*/ */
void ast_calendar_unregister(struct ast_calendar_tech *tech); void ast_calendar_unregister(struct ast_calendar_tech *tech);

41
include/asterisk/http_websocket.h
Unescape View File

@ -127,10 +127,10 @@ struct ast_websocket_protocol {
}; };
/*! /*!
* \brief Creates a \ref websocket_server * \brief Creates a \ref ast_websocket_server
* *
* \retval New \ref websocket_server instance * \return New \ref ast_websocket_server instance
* \retval \c NULL on error * \retval NULL on error
* \since 12 * \since 12
*/ */
AST_OPTIONAL_API(struct ast_websocket_server *, ast_websocket_server_create, (void), { return NULL; }); AST_OPTIONAL_API(struct ast_websocket_server *, ast_websocket_server_create, (void), { return NULL; });
@ -146,7 +146,7 @@ AST_OPTIONAL_API(int, ast_websocket_uri_cb, (struct ast_tcptls_session_instance
/*! /*!
* \brief Allocate a websocket sub-protocol instance * \brief Allocate a websocket sub-protocol instance
* *
* \retval An instance of \ref ast_websocket_protocol on success * \return An instance of \ref ast_websocket_protocol on success
* \retval NULL on error * \retval NULL on error
* \since 13.5.0 * \since 13.5.0
*/ */
@ -169,7 +169,7 @@ AST_OPTIONAL_API(int, ast_websocket_add_protocol, (const char *name, ast_websock
* \param protocol The sub-protocol to register. Note that this must * \param protocol The sub-protocol to register. Note that this must
* be allocated using /ref ast_websocket_sub_protocol_alloc. * be allocated using /ref ast_websocket_sub_protocol_alloc.
* *
* \note This method is reference stealing. It will steal the reference to \ref protocol * \note This method is reference stealing. It will steal the reference to \p protocol
* on success. * on success.
* *
* \retval 0 success * \retval 0 success
@ -192,6 +192,7 @@ AST_OPTIONAL_API(int, ast_websocket_remove_protocol, (const char *name, ast_webs
/*! /*!
* \brief Add a sub-protocol handler to the given server. * \brief Add a sub-protocol handler to the given server.
* *
* \param server The server to add the sub-protocol to
* \param name Name of the sub-protocol to register * \param name Name of the sub-protocol to register
* \param callback Callback called when a new connection requesting the sub-protocol is established * \param callback Callback called when a new connection requesting the sub-protocol is established
* *
@ -208,7 +209,7 @@ AST_OPTIONAL_API(int, ast_websocket_server_add_protocol, (struct ast_websocket_s
* \param protocol The sub-protocol to register. Note that this must * \param protocol The sub-protocol to register. Note that this must
* be allocated using /ref ast_websocket_sub_protocol_alloc. * be allocated using /ref ast_websocket_sub_protocol_alloc.
* *
* \note This method is reference stealing. It will steal the reference to \ref protocol * \note This method is reference stealing. It will steal the reference to \p protocol
* on success. * on success.
* *
* \retval 0 success * \retval 0 success
@ -220,6 +221,7 @@ AST_OPTIONAL_API(int, ast_websocket_server_add_protocol2, (struct ast_websocket_
/*! /*!
* \brief Remove a sub-protocol handler from the given server. * \brief Remove a sub-protocol handler from the given server.
* *
* \param server The server to unregister the sub-protocol from
* \param name Name of the sub-protocol to unregister * \param name Name of the sub-protocol to unregister
* \param callback Callback that was previously registered with the sub-protocol * \param callback Callback that was previously registered with the sub-protocol
* *
@ -253,7 +255,7 @@ AST_OPTIONAL_API(int, ast_websocket_read, (struct ast_websocket *session, char *
* \param ws pointer to the websocket * \param ws pointer to the websocket
* \param buf string buffer to populate with data read from socket * \param buf string buffer to populate with data read from socket
* \retval -1 on error * \retval -1 on error
* \retval number of bytes read on success * \return number of bytes read on success
* *
* \note Once an AST_WEBSOCKET_OPCODE_CLOSE opcode is received the socket will be closed * \note Once an AST_WEBSOCKET_OPCODE_CLOSE opcode is received the socket will be closed
*/ */
@ -332,7 +334,7 @@ AST_OPTIONAL_API(void, ast_websocket_unref, (struct ast_websocket *session), {re
/*! /*!
* \brief Get the file descriptor for a WebSocket session. * \brief Get the file descriptor for a WebSocket session.
* *
* \retval file descriptor * \return file descriptor
* *
* \note You must *not* directly read from or write to this file descriptor. It should only be used for polling. * \note You must *not* directly read from or write to this file descriptor. It should only be used for polling.
*/ */
@ -355,14 +357,14 @@ AST_OPTIONAL_API(int, ast_websocket_wait_for_input, (struct ast_websocket *sessi
/*! /*!
* \brief Get the remote address for a WebSocket connected session. * \brief Get the remote address for a WebSocket connected session.
* *
* \retval ast_sockaddr Remote address * \return Remote address
*/ */
AST_OPTIONAL_API(struct ast_sockaddr *, ast_websocket_remote_address, (struct ast_websocket *session), {return NULL;}); AST_OPTIONAL_API(struct ast_sockaddr *, ast_websocket_remote_address, (struct ast_websocket *session), {return NULL;});
/*! /*!
* \brief Get the local address for a WebSocket connection session. * \brief Get the local address for a WebSocket connection session.
* *
* \retval ast_sockaddr Local address * \return Local address
* *
* \since 13.19.0 * \since 13.19.0
*/ */
@ -387,7 +389,7 @@ AST_OPTIONAL_API(int, ast_websocket_set_nonblock, (struct ast_websocket *session
/*! /*!
* \brief Get the session ID for a WebSocket session. * \brief Get the session ID for a WebSocket session.
* *
* \retval session id * \return session id
*/ */
AST_OPTIONAL_API(const char *, ast_websocket_session_id, (struct ast_websocket *session), { errno = ENOSYS; return NULL;}); AST_OPTIONAL_API(const char *, ast_websocket_session_id, (struct ast_websocket *session), { errno = ENOSYS; return NULL;});
@ -414,21 +416,22 @@ enum ast_websocket_result {
/*! /*!
* \brief Create, and connect, a websocket client. * \brief Create, and connect, a websocket client.
* *
* \detail If the client websocket successfully connects, then the accepted protocol * If the client websocket successfully connects, then the accepted protocol can be
* can be checked via a call to ast_websocket_client_accept_protocol. * checked via a call to ast_websocket_client_accept_protocol.
* *
* \note While connecting this *will* block until a response is * \note While connecting this *will* block until a response is
* received from the remote host. * received from the remote host.
* \note Expected uri form: ws[s]://<address>[:port][/<path>] The address (can be a * \note Expected uri form:
* host name) and port are parsed out and used to connect to the remote server. * \verbatim ws[s]://<address>[:port][/<path>] \endverbatim
* If multiple IPs are returned during address resolution then the first one is * The address (can be a host name) and port are parsed out and used to connect
* chosen. * to the remote server. If multiple IPs are returned during address
* resolution then the first one is chosen.
* *
* \param uri uri to connect to * \param uri uri to connect to
* \param protocols a comma separated string of supported protocols * \param protocols a comma separated string of supported protocols
* \param tls_cfg secure websocket credentials * \param tls_cfg secure websocket credentials
* \param result result code set on client failure * \param result result code set on client failure
* \retval a client websocket. * \return a client websocket.
* \retval NULL if object could not be created or connected * \retval NULL if object could not be created or connected
* \since 13 * \since 13
*/ */
@ -441,7 +444,7 @@ AST_OPTIONAL_API(struct ast_websocket *, ast_websocket_client_create,
* \brief Retrieve the server accepted sub-protocol on the client. * \brief Retrieve the server accepted sub-protocol on the client.
* *
* \param ws the websocket client * \param ws the websocket client
* \retval the accepted client sub-protocol. * \return the accepted client sub-protocol.
* \since 13 * \since 13
*/ */
AST_OPTIONAL_API(const char *, ast_websocket_client_accept_protocol, AST_OPTIONAL_API(const char *, ast_websocket_client_accept_protocol,

2
include/asterisk/phoneprov.h
Unescape View File

@ -95,7 +95,7 @@ void ast_phoneprov_provider_unregister(char *provider_name);
/*! /*!
* \brief Adds an extension * \brief Adds an extension
* \param provider_name The name of the provider * \param provider_name The name of the provider
* \param defaults An ast_vat_t linked list of the extension's variables. * \param vars An ast_vat_t linked list of the extension's variables.
* The list is automatically cloned and it must contain at least MACADDRESS * The list is automatically cloned and it must contain at least MACADDRESS
* and USERNAME entries. * and USERNAME entries.
* *

8
include/asterisk/res_hep.h
Unescape View File

@ -87,9 +87,9 @@ struct hepv3_capture_info {
* reclaimed. * reclaimed.
* *
* \param payload The payload to send to the HEP capture node * \param payload The payload to send to the HEP capture node
* \param len Length of \ref payload * \param len Length of \p payload
* *
* \retval A \ref hepv3_capture_info ref counted object on success * \return A \ref hepv3_capture_info ref counted object on success
* \retval NULL on error * \retval NULL on error
*/ */
struct hepv3_capture_info *hepv3_create_capture_info(const void *payload, size_t len); struct hepv3_capture_info *hepv3_create_capture_info(const void *payload, size_t len);
@ -102,7 +102,7 @@ struct hepv3_capture_info *hepv3_create_capture_info(const void *payload, size_t
* \ref hepv3_create_capture_info. * \ref hepv3_create_capture_info.
* *
* Once this function is called, it assumes ownership of the * Once this function is called, it assumes ownership of the
* \ref capture_info object and steals the reference of the * \p capture_info object and steals the reference of the
* object. Regardless of success or failure, the calling function * object. Regardless of success or failure, the calling function
* should assumed that this function will own the object. * should assumed that this function will own the object.
* *
@ -116,7 +116,7 @@ int hepv3_send_packet(struct hepv3_capture_info *capture_info);
* *
* \since 13.10.0 * \since 13.10.0
* *
* \retval The type of UUID the packet should use * \return The type of UUID the packet should use
*/ */
enum hep_uuid_type hepv3_get_uuid_type(void); enum hep_uuid_type hepv3_get_uuid_type(void);

14
include/asterisk/res_mwi_external.h
Unescape View File

@ -47,7 +47,7 @@ struct ast_mwi_mailbox_object;
* *
* \param mailbox_id Name of mailbox. * \param mailbox_id Name of mailbox.
* *
* \retval object on success. The object is an ao2 object. * \return object on success. The object is an ao2 object.
* \retval NULL on error. * \retval NULL on error.
*/ */
struct ast_mwi_mailbox_object *ast_mwi_mailbox_alloc(const char *mailbox_id); struct ast_mwi_mailbox_object *ast_mwi_mailbox_alloc(const char *mailbox_id);
@ -90,7 +90,7 @@ unsigned int ast_mwi_mailbox_get_msgs_old(const struct ast_mwi_mailbox_object *m
* *
* \param mailbox What to copy. * \param mailbox What to copy.
* *
* \retval copy on success. The object is an ao2 object. * \return copy on success. The object is an ao2 object.
* \retval NULL on error. * \retval NULL on error.
*/ */
struct ast_mwi_mailbox_object *ast_mwi_mailbox_copy(const struct ast_mwi_mailbox_object *mailbox); struct ast_mwi_mailbox_object *ast_mwi_mailbox_copy(const struct ast_mwi_mailbox_object *mailbox);
@ -101,8 +101,6 @@ struct ast_mwi_mailbox_object *ast_mwi_mailbox_copy(const struct ast_mwi_mailbox
* *
* \param mailbox Object to set number of new messages. * \param mailbox Object to set number of new messages.
* \param num_msgs Number of messages to set. * \param num_msgs Number of messages to set.
*
* \return Nothing
*/ */
void ast_mwi_mailbox_set_msgs_new(struct ast_mwi_mailbox_object *mailbox, unsigned int num_msgs); void ast_mwi_mailbox_set_msgs_new(struct ast_mwi_mailbox_object *mailbox, unsigned int num_msgs);
@ -112,8 +110,6 @@ void ast_mwi_mailbox_set_msgs_new(struct ast_mwi_mailbox_object *mailbox, unsign
* *
* \param mailbox Object to set number of old messages. * \param mailbox Object to set number of old messages.
* \param num_msgs Number of messages to set. * \param num_msgs Number of messages to set.
*
* \return Nothing
*/ */
void ast_mwi_mailbox_set_msgs_old(struct ast_mwi_mailbox_object *mailbox, unsigned int num_msgs); void ast_mwi_mailbox_set_msgs_old(struct ast_mwi_mailbox_object *mailbox, unsigned int num_msgs);
@ -167,7 +163,7 @@ int ast_mwi_mailbox_delete_all(void);
* *
* \param mailbox_id Name of mailbox to retrieve. * \param mailbox_id Name of mailbox to retrieve.
* *
* \retval requested mailbox on success. The object is an ao2 object. * \return requested mailbox on success. The object is an ao2 object.
* \retval NULL on error or no mailbox. * \retval NULL on error or no mailbox.
* *
* \note The object must be treated as read-only. * \note The object must be treated as read-only.
@ -182,7 +178,7 @@ const struct ast_mwi_mailbox_object *ast_mwi_mailbox_get(const char *mailbox_id)
* *
* \note The provided regex is treated as extended case sensitive. * \note The provided regex is treated as extended case sensitive.
* *
* \retval container of struct ast_mwi_mailbox_object on success. * \return container of struct ast_mwi_mailbox_object on success.
* \retval NULL on error. * \retval NULL on error.
* *
* \note The objects in the container must be treated as read-only. * \note The objects in the container must be treated as read-only.
@ -193,7 +189,7 @@ struct ao2_container *ast_mwi_mailbox_get_by_regex(const char *regex);
* \brief Get all external MWI objects. * \brief Get all external MWI objects.
* \since 12.1.0 * \since 12.1.0
* *
* \retval container of struct ast_mwi_mailbox_object on success. * \return container of struct ast_mwi_mailbox_object on success.
* \retval NULL on error. * \retval NULL on error.
* *
* \note The objects in the container must be treated as read-only. * \note The objects in the container must be treated as read-only.

8
include/asterisk/res_pjproject.h
Unescape View File

@ -59,8 +59,6 @@ int ast_pjproject_get_buildopt(char *option, char *format_string, ...) __attribu
* \note ast_pjproject_log_intercept_begin() and * \note ast_pjproject_log_intercept_begin() and
* ast_pjproject_log_intercept_end() must always be called * ast_pjproject_log_intercept_end() must always be called
* in pairs. * in pairs.
*
* \return Nothing
*/ */
void ast_pjproject_log_intercept_begin(int fd); void ast_pjproject_log_intercept_begin(int fd);
@ -71,8 +69,6 @@ void ast_pjproject_log_intercept_begin(int fd);
* \note ast_pjproject_log_intercept_begin() and * \note ast_pjproject_log_intercept_begin() and
* ast_pjproject_log_intercept_end() must always be called * ast_pjproject_log_intercept_end() must always be called
* in pairs. * in pairs.
*
* \return Nothing
*/ */
void ast_pjproject_log_intercept_end(void); void ast_pjproject_log_intercept_end(void);
@ -83,8 +79,6 @@ void ast_pjproject_log_intercept_end(void);
* \param cp Caching pool factory to initialize * \param cp Caching pool factory to initialize
* \param policy Pool factory policy * \param policy Pool factory policy
* \param max_capacity Total capacity to be retained in the cache. Zero disables caching. * \param max_capacity Total capacity to be retained in the cache. Zero disables caching.
*
* \return Nothing
*/ */
void ast_pjproject_caching_pool_init(pj_caching_pool *cp, void ast_pjproject_caching_pool_init(pj_caching_pool *cp,
const pj_pool_factory_policy *policy, pj_size_t max_capacity); const pj_pool_factory_policy *policy, pj_size_t max_capacity);
@ -94,8 +88,6 @@ void ast_pjproject_caching_pool_init(pj_caching_pool *cp,
* \since 13.21.0 * \since 13.21.0
* *
* \param cp Caching pool factory to destroy * \param cp Caching pool factory to destroy
*
* \return Nothing
*/ */
void ast_pjproject_caching_pool_destroy(pj_caching_pool *cp); void ast_pjproject_caching_pool_destroy(pj_caching_pool *cp);

6
include/asterisk/res_pjsip.h
Unescape View File

@ -2405,9 +2405,9 @@ void ast_copy_pj_str(char *dest, const pj_str_t *src, size_t size);
* *
* \note Caller is responsible for freeing the allocated memory. * \note Caller is responsible for freeing the allocated memory.
* *
* \param dest [out] The destination buffer * \param[out] dest The destination buffer
* \param src The pj_str_t to copy * \param src The pj_str_t to copy
* \retval Number of characters copied or negative value on error * \return Number of characters copied or negative value on error
*/ */
int ast_copy_pj_str2(char **dest, const pj_str_t *src); int ast_copy_pj_str2(char **dest, const pj_str_t *src);
@ -3388,8 +3388,6 @@ enum ast_transport_monitor_reg ast_sip_transport_monitor_register_replace(pjsip_
* *
* \note The data object passed into the original register will have its reference count * \note The data object passed into the original register will have its reference count
* automatically decremented. * automatically decremented.
*
* \return Nothing
*/ */
void ast_sip_transport_monitor_unregister(pjsip_transport *transport, void ast_sip_transport_monitor_unregister(pjsip_transport *transport,
ast_transport_monitor_shutdown_cb cb, void *data, ast_transport_monitor_data_matcher matches); ast_transport_monitor_shutdown_cb cb, void *data, ast_transport_monitor_data_matcher matches);

4
include/asterisk/res_pjsip_cli.h
Unescape View File

@ -28,7 +28,7 @@
#define CLI_MAX_TITLE_NAME 8 #define CLI_MAX_TITLE_NAME 8
#define CLI_INDENT_TO_SPACES(x) ((x * 2) + 1 + CLI_MAX_TITLE_NAME) #define CLI_INDENT_TO_SPACES(x) ((x * 2) + 1 + CLI_MAX_TITLE_NAME)
/* /*!
* \brief CLI Formatter Context passed to all formatters. * \brief CLI Formatter Context passed to all formatters.
*/ */
struct ast_sip_cli_context { struct ast_sip_cli_context {
@ -46,7 +46,7 @@ struct ast_sip_cli_context {
unsigned show_details_only_level_0 : 1; unsigned show_details_only_level_0 : 1;
}; };
/* /*!
* \brief CLI Formatter Registry Entry * \brief CLI Formatter Registry Entry
*/ */
struct ast_sip_cli_formatter_entry { struct ast_sip_cli_formatter_entry {

4
include/asterisk/statsd.h
Unescape View File

@ -56,7 +56,7 @@
* updating a current value rather than resetting it. * updating a current value rather than resetting it.
* *
* \param metric_name String (UTF-8) name of the metric. * \param metric_name String (UTF-8) name of the metric.
* \param type_str Type of metric to send. * \param metric_type Type of metric to send.
* \param value Value to send. * \param value Value to send.
* \param sample_rate Percentage of samples to send. * \param sample_rate Percentage of samples to send.
* \since 13 * \since 13
@ -94,7 +94,7 @@ AST_OPTIONAL_API_ATTR(void, format(printf, 1, 5), ast_statsd_log_string_va,
* ast_statsd_log_sample() for a slightly more convenient interface. * ast_statsd_log_sample() for a slightly more convenient interface.
* *
* \param metric_name String (UTF-8) name of the metric. * \param metric_name String (UTF-8) name of the metric.
* \param type_str Type of metric to send. * \param metric_type Type of metric to send.
* \param value Value to send. * \param value Value to send.
* \param sample_rate Percentage of samples to send. * \param sample_rate Percentage of samples to send.
* \since 12 * \since 12

2
res/ael/ael_lex.c
Unescape View File

@ -2990,7 +2990,7 @@ void ael_yyset_lineno (int line_number , yyscan_t yyscanner)
} }
/** Set the current column. /** Set the current column.
* @param line_number * @param column_no
* @param yyscanner The scanner object. * @param yyscanner The scanner object.
*/ */
void ael_yyset_column (int column_no , yyscan_t yyscanner) void ael_yyset_column (int column_no , yyscan_t yyscanner)

9
res/res_chan_stats.c
Unescape View File

@ -49,9 +49,6 @@ static struct stasis_message_router *router;
* \brief Subscription callback for all channel messages. * \brief Subscription callback for all channel messages.
* \param data Data pointer given when creating the subscription. * \param data Data pointer given when creating the subscription.
* \param sub This subscription. * \param sub This subscription.
* \param topic The topic the message was posted to. This is not necessarily the
* topic you subscribed to, since messages may be forwarded between
* topics.
* \param message The message itself. * \param message The message itself.
*/ */
static void statsmaker(void *data, struct stasis_subscription *sub, static void statsmaker(void *data, struct stasis_subscription *sub,
@ -81,9 +78,6 @@ static void statsmaker(void *data, struct stasis_subscription *sub,
* \brief Router callback for \ref stasis_cache_update messages. * \brief Router callback for \ref stasis_cache_update messages.
* \param data Data pointer given when added to router. * \param data Data pointer given when added to router.
* \param sub This subscription. * \param sub This subscription.
* \param topic The topic the message was posted to. This is not necessarily the
* topic you subscribed to, since messages may be forwarded between
* topics.
* \param message The message itself. * \param message The message itself.
*/ */
static void updates(void *data, struct stasis_subscription *sub, static void updates(void *data, struct stasis_subscription *sub,
@ -131,9 +125,6 @@ static void updates(void *data, struct stasis_subscription *sub,
* \brief Router callback for any message that doesn't otherwise have a route. * \brief Router callback for any message that doesn't otherwise have a route.
* \param data Data pointer given when added to router. * \param data Data pointer given when added to router.
* \param sub This subscription. * \param sub This subscription.
* \param topic The topic the message was posted to. This is not necessarily the
* topic you subscribed to, since messages may be forwarded between
* topics.
* \param message The message itself. * \param message The message itself.
*/ */
static void default_route(void *data, struct stasis_subscription *sub, static void default_route(void *data, struct stasis_subscription *sub,

14
res/res_config_ldap.c
Unescape View File

@ -98,7 +98,7 @@ struct ldap_table_config {
struct ast_variable *attributes; /*!< attribute names conversion */ struct ast_variable *attributes; /*!< attribute names conversion */
struct ast_variable *delimiters; /*!< the current delimiter is semicolon, so we are not using this variable */ struct ast_variable *delimiters; /*!< the current delimiter is semicolon, so we are not using this variable */
AST_LIST_ENTRY(ldap_table_config) entry; AST_LIST_ENTRY(ldap_table_config) entry;
/* TODO: Make proxies work */ /*! \todo: Make proxies work */
}; };
/*! \brief Should be locked before using it /*! \brief Should be locked before using it
@ -160,7 +160,8 @@ static struct ast_variable *variable_named(struct ast_variable *var, const char
return var; return var;
} }
/*! \brief Count semicolons in string /*!
* \brief Count semicolons in string
* \param somestr - pointer to a string * \param somestr - pointer to a string
* *
* \return number of occurances of the delimiter(semicolon) * \return number of occurances of the delimiter(semicolon)
@ -177,7 +178,8 @@ static int semicolon_count_str(const char *somestr)
return count; return count;
} }
/* \brief Count semicolons in variables /*!
* \brief Count semicolons in variables
* *
* takes a linked list of \a ast_variable variables, finds the one with the name variable_value * takes a linked list of \a ast_variable variables, finds the one with the name variable_value
* and returns the number of semicolons in the value for that \a ast_variable * and returns the number of semicolons in the value for that \a ast_variable
@ -405,7 +407,7 @@ static struct ast_variable **realtime_ldap_result_to_vars(struct ldap_table_conf
int delim_tot_count = 0; int delim_tot_count = 0;
int delim_count = 0; int delim_count = 0;
/* \brief First find the total count /*! \brief First find the total count
*/ */
ldap_entry = ldap_first_entry(ldapConn, ldap_result_msg); ldap_entry = ldap_first_entry(ldapConn, ldap_result_msg);
@ -432,7 +434,7 @@ static struct ast_variable **realtime_ldap_result_to_vars(struct ldap_table_conf
i = 0; i = 0;
/* \brief For each static realtime variable we may create several entries in the \a vars array if it's delimited /*! \brief For each static realtime variable we may create several entries in the \a vars array if it's delimited
*/ */
for (entry_index = 0; ldap_entry; ) { for (entry_index = 0; ldap_entry; ) {
int pos = 0; int pos = 0;
@ -891,7 +893,7 @@ static struct ast_variable **realtime_ldap_base_ap(unsigned int *entries_count_p
ldap_msgfree(ldap_result_msg); ldap_msgfree(ldap_result_msg);
/*! \TODO get the default variables from the accountBaseDN, not implemented with delimited values /*! \todo get the default variables from the accountBaseDN, not implemented with delimited values
*/ */
if (vars) { if (vars) {
struct ast_variable **p = vars; struct ast_variable **p = vars;

2
res/res_config_sqlite3.c
Unescape View File

@ -565,7 +565,7 @@ struct row_counter_args {
* of rows returned from a SELECT statement and still process each row * of rows returned from a SELECT statement and still process each row
* independently. * independently.
* *
* \param data user data pointer passed in via sqlite3_exec() * \param arg user data pointer passed in via sqlite3_exec()
* \param num_columns number of columns in the result * \param num_columns number of columns in the result
* \param values array of pointers to column values * \param values array of pointers to column values
* \param columns array of pointers of to column names * \param columns array of pointers of to column names

7
res/res_crypto.c
Unescape View File

@ -161,7 +161,7 @@ struct ast_key * AST_OPTIONAL_API_NAME(ast_key_get)(const char *kname, int ktype
* \param ifd incoming file descriptor * \param ifd incoming file descriptor
* \param ofd outgoing file descriptor * \param ofd outgoing file descriptor
* \param not2 * \param not2
* \retval key on success. * \return key on success.
* \retval NULL on failure. * \retval NULL on failure.
*/ */
static struct ast_key *try_load_key(const char *dir, const char *fname, int ifd, int ofd, int *not2) static struct ast_key *try_load_key(const char *dir, const char *fname, int ifd, int ofd, int *not2)
@ -487,7 +487,6 @@ void AST_OPTIONAL_API_NAME(ast_aes_decrypt)(const unsigned char *in, unsigned ch
* \brief refresh RSA keys from file * \brief refresh RSA keys from file
* \param ifd file descriptor * \param ifd file descriptor
* \param ofd file descriptor * \param ofd file descriptor
* \return void
*/ */
static void crypto_load(int ifd, int ofd) static void crypto_load(int ifd, int ofd)
{ {
@ -546,7 +545,7 @@ static void md52sum(char *sum, unsigned char *md5)
* \param e CLI command * \param e CLI command
* \param cmd * \param cmd
* \param a list of CLI arguments * \param a list of CLI arguments
* \return CLI_SUCCESS * \retval CLI_SUCCESS
*/ */
static char *handle_cli_keys_show(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a) static char *handle_cli_keys_show(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
{ {
@ -592,7 +591,7 @@ static char *handle_cli_keys_show(struct ast_cli_entry *e, int cmd, struct ast_c
* \param e CLI command * \param e CLI command
* \param cmd * \param cmd
* \param a list of CLI arguments * \param a list of CLI arguments
* \return CLI_SUCCESS * \retval CLI_SUCCESS
*/ */
static char *handle_cli_keys_init(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a) static char *handle_cli_keys_init(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
{ {

2
res/res_hep.c
Unescape View File

@ -144,7 +144,7 @@ enum hepv3_chunk_types {
/*! A KEEP ALIVE TIMER */ /*! A KEEP ALIVE TIMER */
CHUNK_TYPE_KEEP_ALIVE_TIMER = 0X000D, CHUNK_TYPE_KEEP_ALIVE_TIMER = 0X000D,
/*! THE \REF CAPTURE_PASSWORD IF DEFINED */ /*! THE CAPTURE_PASSWORD IF DEFINED */
CHUNK_TYPE_AUTH_KEY = 0X000E, CHUNK_TYPE_AUTH_KEY = 0X000E,
/*! THE ONE AND ONLY PAYLOAD */ /*! THE ONE AND ONLY PAYLOAD */

3
res/res_http_websocket.c
Unescape View File

@ -1085,7 +1085,8 @@ int AST_OPTIONAL_API_NAME(ast_websocket_remove_protocol)(const char *name, ast_w
/*! \brief Parse the given uri into a path and remote address. /*! \brief Parse the given uri into a path and remote address.
* *
* Expected uri form: [ws[s]]://<host>[:port][/<path>] * Expected uri form:
* \verbatim [ws[s]]://<host>[:port][/<path>] \endverbatim
* *
* The returned host will contain the address and optional port while * The returned host will contain the address and optional port while
* path will contain everything after the address/port if included. * path will contain everything after the address/port if included.

3
res/res_monitor.c
Unescape View File

@ -299,6 +299,7 @@ static int ast_monitor_set_state(struct ast_channel *chan, int state)
* \param fname_base filename base to record to * \param fname_base filename base to record to
* \param need_lock whether to lock the channel mutex * \param need_lock whether to lock the channel mutex
* \param stream_action whether to record the input and/or output streams. X_REC_IN | X_REC_OUT is most often used * \param stream_action whether to record the input and/or output streams. X_REC_IN | X_REC_OUT is most often used
* \param beep_id
* Creates the file to record, if no format is specified it assumes WAV * Creates the file to record, if no format is specified it assumes WAV
* It also sets channel variable __MONITORED=yes * It also sets channel variable __MONITORED=yes
* \retval 0 on success * \retval 0 on success
@ -458,7 +459,7 @@ static const char *get_soxmix_format(const char *format)
* \param chan * \param chan
* \param need_lock * \param need_lock
* Stop the recording, close any open streams, mix in/out channels if required * Stop the recording, close any open streams, mix in/out channels if required
* \return Always 0 * \retval 0 Always
*/ */
int AST_OPTIONAL_API_NAME(ast_monitor_stop)(struct ast_channel *chan, int need_lock) int AST_OPTIONAL_API_NAME(ast_monitor_stop)(struct ast_channel *chan, int need_lock)
{ {

14
res/res_mwi_external.c
Unescape View File

@ -86,8 +86,6 @@ static struct ast_sorcery *mwi_sorcery;
* \internal * \internal
* \brief Post an update event to the MWI counts. * \brief Post an update event to the MWI counts.
* \since 12.1.0 * \since 12.1.0
*
* \return Nothing
*/ */
static void mwi_post_event(const struct ast_mwi_mailbox_object *mailbox) static void mwi_post_event(const struct ast_mwi_mailbox_object *mailbox)
{ {
@ -104,8 +102,6 @@ static void mwi_observe_update(const void *obj)
* \internal * \internal
* \brief Post a count clearing event to the MWI counts. * \brief Post a count clearing event to the MWI counts.
* \since 12.1.0 * \since 12.1.0
*
* \return Nothing
*/ */
static void mwi_observe_delete(const void *obj) static void mwi_observe_delete(const void *obj)
{ {
@ -254,8 +250,6 @@ int ast_mwi_mailbox_update(struct ast_mwi_mailbox_object *mailbox)
* \since 12.1.0 * \since 12.1.0
* *
* \param mailbox Mailbox object to delete from sorcery. * \param mailbox Mailbox object to delete from sorcery.
*
* \return Nothing
*/ */
static void mwi_mailbox_delete(struct ast_mwi_mailbox_object *mailbox) static void mwi_mailbox_delete(struct ast_mwi_mailbox_object *mailbox)
{ {
@ -268,8 +262,6 @@ static void mwi_mailbox_delete(struct ast_mwi_mailbox_object *mailbox)
* \since 12.1.0 * \since 12.1.0
* *
* \param mailboxes Mailbox objects to delete from sorcery. * \param mailboxes Mailbox objects to delete from sorcery.
*
* \return Nothing
*/ */
static void mwi_mailbox_delete_all(struct ao2_container *mailboxes) static void mwi_mailbox_delete_all(struct ao2_container *mailboxes)
{ {
@ -658,8 +650,6 @@ static char *handle_mwi_delete_mailbox(struct ast_cli_entry *e, int cmd, struct
* *
* \param cli_fd File descriptor for CLI output. * \param cli_fd File descriptor for CLI output.
* \param mailbox What to list. * \param mailbox What to list.
*
* \return Nothing
*/ */
static void mwi_cli_print_mailbox(int cli_fd, const struct ast_mwi_mailbox_object *mailbox) static void mwi_cli_print_mailbox(int cli_fd, const struct ast_mwi_mailbox_object *mailbox)
{ {
@ -676,8 +666,6 @@ static void mwi_cli_print_mailbox(int cli_fd, const struct ast_mwi_mailbox_objec
* *
* \param cli_fd File descriptor for CLI output. * \param cli_fd File descriptor for CLI output.
* \param mailboxes What to list. * \param mailboxes What to list.
*
* \return Nothing
*/ */
static void mwi_cli_list_mailboxes(int cli_fd, struct ao2_container *mailboxes) static void mwi_cli_list_mailboxes(int cli_fd, struct ao2_container *mailboxes)
{ {
@ -882,8 +870,6 @@ static struct ast_cli_entry mwi_cli[] = {
* \internal * \internal
* \brief Post initial MWI count events. * \brief Post initial MWI count events.
* \since 12.1.0 * \since 12.1.0
*
* \return Nothing
*/ */
static void mwi_initial_events(void) static void mwi_initial_events(void)
{ {

1
res/res_phoneprov.c
Unescape View File

@ -505,6 +505,7 @@ static void delete_routes(void)
/*! \brief Build a route structure and add it to the list of available http routes /*! \brief Build a route structure and add it to the list of available http routes
\param pp_file File to link to the route \param pp_file File to link to the route
\param profile
\param user User to link to the route (NULL means static route) \param user User to link to the route (NULL means static route)
\param uri URI of the route \param uri URI of the route
*/ */

8
res/res_pjsip/pjsip_resolver.c
Unescape View File

@ -92,8 +92,6 @@ static int sip_available_transports[] = {
* \brief Destroy resolution data * \brief Destroy resolution data
* *
* \param data The resolution data to destroy * \param data The resolution data to destroy
*
* \return Nothing
*/ */
static void sip_resolve_destroy(void *data) static void sip_resolve_destroy(void *data)
{ {
@ -185,7 +183,7 @@ static int sip_resolve_add(struct sip_resolve *resolve, const char *name, int rr
* *
* \param data The complete resolution * \param data The complete resolution
* *
* \return Nothing * \retval 0 Always
*/ */
static int sip_resolve_invoke_user_callback(void *data) static int sip_resolve_invoke_user_callback(void *data)
{ {
@ -262,8 +260,6 @@ static int sip_resolve_handle_naptr(struct sip_resolve *resolve, const struct as
* \brief Query set callback function, invoked when all queries have completed * \brief Query set callback function, invoked when all queries have completed
* *
* \param query_set The completed query set * \param query_set The completed query set
*
* \return Nothing
*/ */
static void sip_resolve_callback(const struct ast_dns_query_set *query_set) static void sip_resolve_callback(const struct ast_dns_query_set *query_set)
{ {
@ -630,8 +626,6 @@ static void sip_resolve(pjsip_resolver_t *resolver, pj_pool_t *pool, const pjsip
* \param pool A memory pool to allocate things from * \param pool A memory pool to allocate things from
* \param transport The type of transport to check * \param transport The type of transport to check
* \param name A friendly name to print in the verbose message * \param name A friendly name to print in the verbose message
*
* \return Nothing
*/ */
static void sip_check_transport(pj_pool_t *pool, pjsip_transport_type_e transport, const char *name) static void sip_check_transport(pj_pool_t *pool, pjsip_transport_type_e transport, const char *name)
{ {

16
res/res_pjsip_history.c
Unescape View File

@ -236,7 +236,7 @@ static int evaluate_not_equal(struct operator *op, enum aco_option_type type, vo
return !evaluate_equal(op, type, op_left, op_right); return !evaluate_equal(op, type, op_left, op_right);
} }
/* /*!
* \brief Operator callback for determining if one operand is less than another * \brief Operator callback for determining if one operand is less than another
*/ */
static int evaluate_less_than(struct operator *op, enum aco_option_type type, void *op_left, struct expression_token *op_right) static int evaluate_less_than(struct operator *op, enum aco_option_type type, void *op_left, struct expression_token *op_right)
@ -285,7 +285,7 @@ static int evaluate_less_than(struct operator *op, enum aco_option_type type, vo
return -1; return -1;
} }
/* /*!
* \brief Operator callback for determining if one operand is greater than another * \brief Operator callback for determining if one operand is greater than another
*/ */
static int evaluate_greater_than(struct operator *op, enum aco_option_type type, void *op_left, struct expression_token *op_right) static int evaluate_greater_than(struct operator *op, enum aco_option_type type, void *op_left, struct expression_token *op_right)
@ -334,7 +334,7 @@ static int evaluate_greater_than(struct operator *op, enum aco_option_type type,
return -1; return -1;
} }
/* /*!
* \brief Operator callback for determining if one operand is less than or equal to another * \brief Operator callback for determining if one operand is less than or equal to another
*/ */
static int evaluate_less_than_or_equal(struct operator *op, enum aco_option_type type, void *op_left, struct expression_token *op_right) static int evaluate_less_than_or_equal(struct operator *op, enum aco_option_type type, void *op_left, struct expression_token *op_right)
@ -342,7 +342,7 @@ static int evaluate_less_than_or_equal(struct operator *op, enum aco_option_type
return !evaluate_greater_than(op, type, op_left, op_right); return !evaluate_greater_than(op, type, op_left, op_right);
} }
/* /*!
* \brief Operator callback for determining if one operand is greater than or equal to another * \brief Operator callback for determining if one operand is greater than or equal to another
*/ */
static int evaluate_greater_than_or_equal(struct operator *op, enum aco_option_type type, void *op_left, struct expression_token *op_right) static int evaluate_greater_than_or_equal(struct operator *op, enum aco_option_type type, void *op_left, struct expression_token *op_right)
@ -350,7 +350,7 @@ static int evaluate_greater_than_or_equal(struct operator *op, enum aco_option_t
return !evaluate_less_than(op, type, op_left, op_right); return !evaluate_less_than(op, type, op_left, op_right);
} }
/* /*!
* \brief Operator callback for determining logical NOT * \brief Operator callback for determining logical NOT
*/ */
static int evaluate_not(struct operator *op, enum aco_option_type type, void *operand) static int evaluate_not(struct operator *op, enum aco_option_type type, void *operand)
@ -368,7 +368,7 @@ static int evaluate_not(struct operator *op, enum aco_option_type type, void *op
return -1; return -1;
} }
/* /*!
* \brief Operator callback for determining logical AND * \brief Operator callback for determining logical AND
*/ */
static int evaluate_and(struct operator *op, enum aco_option_type type, void *op_left, struct expression_token *op_right) static int evaluate_and(struct operator *op, enum aco_option_type type, void *op_left, struct expression_token *op_right)
@ -386,7 +386,7 @@ static int evaluate_and(struct operator *op, enum aco_option_type type, void *op
return -1; return -1;
} }
/* /*!
* \brief Operator callback for determining logical OR * \brief Operator callback for determining logical OR
*/ */
static int evaluate_or(struct operator *op, enum aco_option_type type, void *op_left, struct expression_token *op_right) static int evaluate_or(struct operator *op, enum aco_option_type type, void *op_left, struct expression_token *op_right)
@ -404,7 +404,7 @@ static int evaluate_or(struct operator *op, enum aco_option_type type, void *op_
return -1; return -1;
} }
/* /*!
* \brief Operator callback for regex 'like' * \brief Operator callback for regex 'like'
*/ */
static int evaluate_like(struct operator *op, enum aco_option_type type, void *op_left, struct expression_token *op_right) static int evaluate_like(struct operator *op, enum aco_option_type type, void *op_left, struct expression_token *op_right)

4
res/res_pjsip_mwi.c
Unescape View File

@ -679,8 +679,8 @@ static int add_mwi_datastore(struct mwi_subscription *sub)
* \param container The ao2_container to search * \param container The ao2_container to search
* \param endpoint The endpoint to find * \param endpoint The endpoint to find
* \param mailbox The mailbox potentially subscribed * \param mailbox The mailbox potentially subscribed
* \param mwi_sub [out] May contain the located mwi_subscription * \param[out] mwi_sub May contain the located mwi_subscription
* \param mwi_stasis [out] May contain the located mwi_stasis_subscription * \param[out] mwi_stasis May contain the located mwi_stasis_subscription
* *
* \retval 1 if a subscription was located, 0 otherwise * \retval 1 if a subscription was located, 0 otherwise
*/ */

6
res/res_pjsip_notify.c
Unescape View File

@ -671,8 +671,8 @@ static int notify_contact(void *obj, void *arg, int flags)
* \internal * \internal
* \brief Send a NOTIFY request to the endpoint. * \brief Send a NOTIFY request to the endpoint.
* *
* \detail Iterates over an endpoint's AORs sending a NOTIFY request * \details Iterates over an endpoint's AORs sending a NOTIFY request
* with the appropriate payload information to each contact. * with the appropriate payload information to each contact.
*/ */
static int notify_endpoint(void *obj) static int notify_endpoint(void *obj)
{ {
@ -1072,7 +1072,7 @@ static struct ast_cli_entry cli_options[] = {
}; };
/*! /*!
* \interanl * \internal
* \brief Completes SIPNotify AMI command in Endpoint mode. * \brief Completes SIPNotify AMI command in Endpoint mode.
*/ */
static void manager_notify_endpoint(struct mansession *s, static void manager_notify_endpoint(struct mansession *s,

18
res/res_pjsip_session.c
Unescape View File

@ -3722,9 +3722,9 @@ static enum sip_get_destination_result get_destination(struct ast_sip_session *s
return SIP_GET_DEST_EXTEN_NOT_FOUND; return SIP_GET_DEST_EXTEN_NOT_FOUND;
} }
/* /*!
* /internal * \internal
* /brief Process initial answer for an incoming invite * \brief Process initial answer for an incoming invite
* *
* This function should only be called during the setup, and handling of a * This function should only be called during the setup, and handling of a
* new incoming invite. Most, if not all of the time, this will be called * new incoming invite. Most, if not all of the time, this will be called
@ -3772,10 +3772,10 @@ static int new_invite_initial_answer(pjsip_inv_session *inv_session, pjsip_rx_da
return res; return res;
} }
/* /*!
* /internal * \internal
* /brief Create and initialize a pjsip invite session * \brief Create and initialize a pjsip invite session
*
* pjsip_inv_session adds, and maintains a reference to the dialog upon a successful * pjsip_inv_session adds, and maintains a reference to the dialog upon a successful
* invite session creation until the session is destroyed. However, we'll wait to * invite session creation until the session is destroyed. However, we'll wait to
* remove the reference that was added for the dialog when it gets created since we're * remove the reference that was added for the dialog when it gets created since we're
@ -3785,10 +3785,10 @@ static int new_invite_initial_answer(pjsip_inv_session *inv_session, pjsip_rx_da
* created, and associated dialog locked and with two references (i.e. dialog's * created, and associated dialog locked and with two references (i.e. dialog's
* reference count should be 2). * reference count should be 2).
* *
* \param endpoint A pointer to the endpoint
* \param rdata The request that is starting the dialog * \param rdata The request that is starting the dialog
* \param endpoint A pointer to the endpoint
* *
* \retval A pjsip invite session object * \return A pjsip invite session object
* \retval NULL on error * \retval NULL on error
*/ */
static pjsip_inv_session *pre_session_setup(pjsip_rx_data *rdata, const struct ast_sip_endpoint *endpoint) static pjsip_inv_session *pre_session_setup(pjsip_rx_data *rdata, const struct ast_sip_endpoint *endpoint)

4
res/res_rtp_asterisk.c
Unescape View File

@ -3462,8 +3462,6 @@ static int rtp_learning_rtp_seq_update(struct rtp_learning_info *info, uint16_t
* \brief Start the strictrtp learning mode. * \brief Start the strictrtp learning mode.
* *
* \param rtp RTP session description * \param rtp RTP session description
*
* \return Nothing
*/ */
static void rtp_learning_start(struct ast_rtp *rtp) static void rtp_learning_start(struct ast_rtp *rtp)
{ {
@ -3480,8 +3478,6 @@ static void acl_change_stasis_cb(void *data, struct stasis_subscription *sub, st
/*! /*!
* \internal * \internal
* \brief Resets and ACL to empty state. * \brief Resets and ACL to empty state.
*
* \return Nothing
*/ */
static void rtp_unload_acl(ast_rwlock_t *lock, struct ast_acl_list **acl) static void rtp_unload_acl(ast_rwlock_t *lock, struct ast_acl_list **acl)
{ {

10
res/res_stasis.c
Unescape View File

@ -1320,7 +1320,7 @@ static void remove_stasis_end_published(struct ast_channel *chan)
ast_channel_unlock(chan); ast_channel_unlock(chan);
} }
/*! /brief Stasis dialplan application callback */ /*! \brief Stasis dialplan application callback */
int stasis_app_exec(struct ast_channel *chan, const char *app_name, int argc, int stasis_app_exec(struct ast_channel *chan, const char *app_name, int argc,
char *argv[]) char *argv[])
{ {
@ -2223,7 +2223,7 @@ static int unload_module(void)
return 0; return 0;
} }
/* \brief Sanitization callback for channel snapshots */ /*! \brief Sanitization callback for channel snapshots */
static int channel_snapshot_sanitizer(const struct ast_channel_snapshot *snapshot) static int channel_snapshot_sanitizer(const struct ast_channel_snapshot *snapshot)
{ {
if (!snapshot || !(snapshot->tech_properties & AST_CHAN_TP_INTERNAL)) { if (!snapshot || !(snapshot->tech_properties & AST_CHAN_TP_INTERNAL)) {
@ -2232,7 +2232,7 @@ static int channel_snapshot_sanitizer(const struct ast_channel_snapshot *snapsho
return 1; return 1;
} }
/* \brief Sanitization callback for channels */ /*! \brief Sanitization callback for channels */
static int channel_sanitizer(const struct ast_channel *chan) static int channel_sanitizer(const struct ast_channel *chan)
{ {
if (!chan || !(ast_channel_tech(chan)->properties & AST_CHAN_TP_INTERNAL)) { if (!chan || !(ast_channel_tech(chan)->properties & AST_CHAN_TP_INTERNAL)) {
@ -2241,7 +2241,7 @@ static int channel_sanitizer(const struct ast_channel *chan)
return 1; return 1;
} }
/* \brief Sanitization callback for channel unique IDs */ /*! \brief Sanitization callback for channel unique IDs */
static int channel_id_sanitizer(const char *id) static int channel_id_sanitizer(const char *id)
{ {
struct ast_channel_snapshot *snapshot; struct ast_channel_snapshot *snapshot;
@ -2254,7 +2254,7 @@ static int channel_id_sanitizer(const char *id)
return ret; return ret;
} }
/* \brief Sanitization callbacks for communication to Stasis applications */ /*! \brief Sanitization callbacks for communication to Stasis applications */
struct stasis_message_sanitizer app_sanitizer = { struct stasis_message_sanitizer app_sanitizer = {
.channel_id = channel_id_sanitizer, .channel_id = channel_id_sanitizer,
.channel_snapshot = channel_snapshot_sanitizer, .channel_snapshot = channel_snapshot_sanitizer,

14
res/res_stir_shaken/certificate.h
Unescape View File

@ -27,10 +27,10 @@ struct stir_shaken_certificate;
/*! /*!
* \brief Get a STIR/SHAKEN certificate by caller ID number * \brief Get a STIR/SHAKEN certificate by caller ID number
* *
* \param callier_id_number The caller ID number * \param caller_id_number The caller ID number
* *
* \retval NULL if not found * \retval NULL if not found
* \retval The certificate on success * \return The certificate on success
*/ */
struct stir_shaken_certificate *stir_shaken_certificate_get_by_caller_id_number(const char *caller_id_number); struct stir_shaken_certificate *stir_shaken_certificate_get_by_caller_id_number(const char *caller_id_number);
@ -40,7 +40,7 @@ struct stir_shaken_certificate *stir_shaken_certificate_get_by_caller_id_number(
* \param cert The certificate to get the public key URL from * \param cert The certificate to get the public key URL from
* *
* \retval NULL on failure * \retval NULL on failure
* \retval The public key URL on success * \return The public key URL on success
*/ */
const char *stir_shaken_certificate_get_public_cert_url(struct stir_shaken_certificate *cert); const char *stir_shaken_certificate_get_public_cert_url(struct stir_shaken_certificate *cert);
@ -60,7 +60,7 @@ const char *stir_shaken_certificate_get_attestation(struct stir_shaken_certifica
* \param cert The certificate to get the private key from * \param cert The certificate to get the private key from
* *
* \retval NULL on failure * \retval NULL on failure
* \retval The private key on success * \return The private key on success
*/ */
EVP_PKEY *stir_shaken_certificate_get_private_key(struct stir_shaken_certificate *cert); EVP_PKEY *stir_shaken_certificate_get_private_key(struct stir_shaken_certificate *cert);
@ -94,14 +94,16 @@ int test_stir_shaken_create_cert(const char *caller_id_number, const char *file_
/*! /*!
* \brief Load time initialization for the stir/shaken 'certificate' configuration * \brief Load time initialization for the stir/shaken 'certificate' configuration
* *
* \retval 0 on success, -1 on error * \retval 0 on success
* \retval -1 on error
*/ */
int stir_shaken_certificate_load(void); int stir_shaken_certificate_load(void);
/*! /*!
* \brief Unload time cleanup for the stir/shaken 'certificate' configuration * \brief Unload time cleanup for the stir/shaken 'certificate' configuration
* *
* \retval 0 on success, -1 on error * \retval 0 on success
* \retval -1 on error
*/ */
int stir_shaken_certificate_unload(void); int stir_shaken_certificate_unload(void);

5
res/res_stir_shaken/curl.c
Unescape View File

@ -81,6 +81,7 @@ char *curl_cb_data_get_expires(const struct curl_cb_data *data)
/*! /*!
* \brief Called when a CURL request completes * \brief Called when a CURL request completes
* *
* \param buffer, size, nitems
* \param data The curl_cb_data structure to store expiration info * \param data The curl_cb_data structure to store expiration info
*/ */
static size_t curl_header_callback(char *buffer, size_t size, size_t nitems, void *data) static size_t curl_header_callback(char *buffer, size_t size, size_t nitems, void *data)
@ -123,7 +124,7 @@ static size_t curl_header_callback(char *buffer, size_t size, size_t nitems, voi
* \param data The CURL callback data * \param data The CURL callback data
* *
* \retval NULL on failure * \retval NULL on failure
* \retval CURL instance on success * \return CURL instance on success
*/ */
static CURL *get_curl_instance(struct curl_cb_data *data) static CURL *get_curl_instance(struct curl_cb_data *data)
{ {
@ -159,7 +160,7 @@ static CURL *get_curl_instance(struct curl_cb_data *data)
* \param filename Function allocates memory and stores full filename (including path) here * \param filename Function allocates memory and stores full filename (including path) here
* *
* \retval -1 on failure * \retval -1 on failure
* \retval file descriptor on success * \return file descriptor on success
*/ */
static int create_temp_file(const char *path, char **filename) static int create_temp_file(const char *path, char **filename)
{ {

7
res/res_stun_monitor.c
Unescape View File

@ -80,7 +80,7 @@ static void stun_close_sock(void)
} }
} }
/* \brief called by scheduler to send STUN request */ /*! \brief called by scheduler to send STUN request */
static int stun_monitor_request(const void *blarg) static int stun_monitor_request(const void *blarg)
{ {
int res; int res;
@ -202,8 +202,6 @@ monitor_request_cleanup:
* \brief Stops the STUN monitor thread. * \brief Stops the STUN monitor thread.
* *
* \note do not hold the args->lock while calling this * \note do not hold the args->lock while calling this
*
* \return Nothing
*/ */
static void stun_stop_monitor(void) static void stun_stop_monitor(void)
{ {
@ -226,8 +224,6 @@ static void stun_stop_monitor(void)
* \brief Starts the STUN monitor thread. * \brief Starts the STUN monitor thread.
* *
* \note The args->lock MUST be held when calling this function * \note The args->lock MUST be held when calling this function
*
* \return Nothing
*/ */
static int stun_start_monitor(void) static int stun_start_monitor(void)
{ {
@ -265,6 +261,7 @@ static int stun_start_monitor(void)
* \brief Parse and setup the stunaddr parameter. * \brief Parse and setup the stunaddr parameter.
* *
* \param value Configuration parameter variable value. * \param value Configuration parameter variable value.
* \param reload
* *
* \retval 0 on success. * \retval 0 on success.
* \retval -1 on error. * \retval -1 on error.

2
res/res_xmpp.c
Unescape View File

@ -4124,7 +4124,7 @@ static void xmpp_pubsub_request_nodes(struct ast_xmpp_client *client, const char
} }
/* /*!
* \brief Method to expose PubSub node list via CLI. * \brief Method to expose PubSub node list via CLI.
* \param e pointer to ast_cli_entry structure * \param e pointer to ast_cli_entry structure
* \param cmd * \param cmd

6
res/snmp/agent.h
Unescape View File

@ -17,15 +17,15 @@
/*! /*!
* \internal * \internal
* \brief Thread running the SNMP Agent or Subagent * \brief Thread running the SNMP Agent or Subagent
* \param Not used -- required by pthread_create * \param arg -- not used
* \return A pointer with return status -- not used * \return A pointer with return status -- not used
* *
* This represent the main thread of the SNMP [sub]agent, and * This represent the main thread of the SNMP [sub]agent, and
* will initialize SNMP and loop, processing requests until * will initialize SNMP and loop, processing requests until
* termination is requested by resetting the flag in * termination is requested by resetting the flag in
* \ref res_snmp_dontStop. * \ref res_snmp_dont_stop.
*/ */
void *agent_thread(void *); void *agent_thread(void *arg);
/*! /*!
* \internal * \internal

4
res/stasis/app.h
Unescape View File

@ -37,12 +37,12 @@
struct stasis_app; struct stasis_app;
enum stasis_app_subscription_model { enum stasis_app_subscription_model {
/* /*!
* \brief An application must manually subscribe to each * \brief An application must manually subscribe to each
* resource that it cares about. This is the default approach. * resource that it cares about. This is the default approach.
*/ */
STASIS_APP_SUBSCRIBE_MANUAL, STASIS_APP_SUBSCRIBE_MANUAL,
/* /*!
* \brief An application is automatically subscribed to all * \brief An application is automatically subscribed to all
* resources in Asterisk, even if it does not control them. * resources in Asterisk, even if it does not control them.
*/ */

Write Preview
Loading…
Cancel
Save