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

res_pjsip: Fix for Doxygen.

Browse Source 
ASTERISK-29747

Change-Id: Ic7a1e9453f805a6264fe86c96b7d18b87b376084
16.23
Alexander Traud 3 years ago committed by George Joseph
parent ed8d5dfb27
commit 2dd2bfe146
23 changed files with 122 additions and 134 deletions
Show Stats Download Patch File Download Diff File

63
include/asterisk/res_pjsip.h
Unescape View File

@ -331,8 +331,7 @@ enum ast_sip_contact_status_type {
/*!
* \brief A contact's status.
*
* \detail Maintains a contact's current status and round trip time
* if available.
* Maintains a contact's current status and round trip time if available.
*/
struct ast_sip_contact_status {
AST_DECLARE_STRING_FIELDS(
@ -891,7 +890,7 @@ int ast_sip_auth_vector_init(struct ast_sip_auth_vector *vector, const char *aut
/*!
* \brief Free contents of an auth vector.
*
* \param array Vector whose contents are to be freed
* \param vector Vector whose contents are to be freed
*/
void ast_sip_auth_vector_destroy(struct ast_sip_auth_vector *vector);
@ -1046,7 +1045,7 @@ void ast_sip_unregister_authenticator(struct ast_sip_authenticator *auth);
* An outbound authenticator is responsible for creating responses to
* authentication challenges by remote endpoints.
*
* \param auth The authenticator to register
* \param outbound_auth The authenticator to register
* \retval 0 Success
* \retval -1 Failure
*/
@ -1816,7 +1815,7 @@ struct ast_sip_sched_task;
*
* \returns Pointer to \ref ast_sip_sched_task ao2 object which must be dereferenced when done.
*
* \paragraph Serialization
* \par Serialization
*
* Specifying a serializer guarantees serialized execution but NOT specifying a serializer
* may still result in tasks being effectively serialized if the thread pool is busy.
@ -1824,18 +1823,18 @@ struct ast_sip_sched_task;
* That happens automatically (see below). It's to prevent the task from running at the same
* time as other work using the same serializer, whether or not it's being run by the scheduler.
*
* \paragraph Interval
* \par Interval
*
* The interval is used to calculate the next time the task should run. There are two models.
*
* \ref AST_SIP_SCHED_TASK_PERIODIC specifies that the invocations of the task occur at the
* specific interval. That is, every \ref "interval" milliseconds, regardless of how long the task
* takes. If the task takes longer than \ref interval, it will be scheduled at the next available
* multiple of \ref interval. For example: If the task has an interval of 60 seconds and the task
* specific interval. That is, every \p interval milliseconds, regardless of how long the task
* takes. If the task takes longer than \p interval, it will be scheduled at the next available
* multiple of \p interval. For example: If the task has an interval of 60 seconds and the task
* takes 70 seconds, the next invocation will happen at 120 seconds.
*
* \ref AST_SIP_SCHED_TASK_DELAY specifies that the next invocation of the task should start
* at \ref interval milliseconds after the current invocation has finished.
* at \p interval milliseconds after the current invocation has finished.
*
*/
struct ast_sip_sched_task *ast_sip_schedule_task(struct ast_taskprocessor *serializer,
@ -1890,7 +1889,7 @@ int ast_sip_sched_task_get_times(struct ast_sip_sched_task *schtd,
* \param[out] last_end Pointer to a timeval structure to contain the time when last ended
* \param[out] interval Pointer to an int to contain the interval in ms
* \param[out] time_left Pointer to an int to contain the ms left to the next run
* \param[out] last_end Pointer to a timeval structure to contain the next run time
* \param[out] next_start Pointer to a timeval structure to contain the next run time
* \retval 0 Success
* \retval -1 Failure
* \note Any of the pointers can be NULL if you don't need them.
@ -1925,7 +1924,7 @@ int ast_sip_sched_task_get_times_by_name(const char *name,
* \param[out] last_end Pointer to a timeval structure to contain the time when last ended
* \param[out] interval Pointer to an int to contain the interval in ms
* \param[out] time_left Pointer to an int to contain the ms left to the next run
* \param[out] last_end Pointer to a timeval structure to contain the next run time
* \param[out] next_start Pointer to a timeval structure to contain the next run time
* \retval 0 Success
* \retval -1 Failure
* \note Any of the pointers can be NULL if you don't need them.
@ -1977,6 +1976,7 @@ int ast_sip_sched_is_task_running_by_name(const char *name);
* \since 13.9.0
*
* \param schtd The task structure pointer
* \param name, maxlen
* \retval 0 success
* \retval 1 failure
*/
@ -2070,7 +2070,7 @@ pjsip_dialog *ast_sip_create_dialog_uas_locked(const struct ast_sip_endpoint *en
* \brief General purpose method for creating an rdata structure using specific information
* \since 13.15.0
*
* \param rdata[out] The rdata structure that will be populated
* \param[out] rdata The rdata structure that will be populated
* \param packet A SIP message
* \param src_name The source IP address of the message
* \param src_port The source port of the message
@ -2089,7 +2089,7 @@ int ast_sip_create_rdata_with_contact(pjsip_rx_data *rdata, char *packet,
/*!
* \brief General purpose method for creating an rdata structure using specific information
*
* \param rdata[out] The rdata structure that will be populated
* \param[out] rdata The rdata structure that will be populated
* \param packet A SIP message
* \param src_name The source IP address of the message
* \param src_port The source port of the message
@ -2171,7 +2171,7 @@ int ast_sip_send_request(pjsip_tx_data *tdata, struct pjsip_dialog *dlg,
*
* \param tdata The request to send
* \param endpoint Optional. If specified, the out-of-dialog request is sent to the endpoint.
* \param timeout. If non-zero, after the timeout the transaction will be terminated
* \param timeout If non-zero, after the timeout the transaction will be terminated
* and the callback will be called with the PJSIP_EVENT_TIMER type.
* \param token Data to be passed to the callback upon receipt of out-of-dialog response.
* \param callback Callback to be called upon receipt of out-of-dialog response.
@ -2199,7 +2199,7 @@ int ast_sip_send_out_of_dialog_request(pjsip_tx_data *tdata,
* \param rdata The rdata from the incoming request.
* \param st_code The response code to transmit.
* \param contact The contact with which this request is associated.
* \param[out] tdata The newly-created response
* \param[out] p_tdata The newly-created response
*
* The provided contact is attached to tdata with its reference bumped, but will
* not survive for the entire lifetime of tdata since the contact is cleaned up
@ -2221,7 +2221,7 @@ int ast_sip_create_response(const pjsip_rx_data *rdata, int st_code,
*
* \param res_addr The response address for this response
* \param tdata The response to send
* \param endpoint The ast_sip_endpoint associated with this response
* \param sip_endpoint The ast_sip_endpoint associated with this response
*
* \retval 0 Success
* \retval -1 Failure
@ -2237,7 +2237,7 @@ int ast_sip_send_response(pjsip_response_addr *res_addr, pjsip_tx_data *tdata, s
*
* \param rdata The request that is being responded to
* \param tdata The response to send
* \param endpoint The ast_sip_endpoint associated with this response
* \param sip_endpoint The ast_sip_endpoint associated with this response
*
* \since 13.4.0
*
@ -2357,7 +2357,8 @@ int ast_sip_add_body(pjsip_tx_data *tdata, const struct ast_sip_body *body);
* add each part to the SIP message.
*
* \param tdata The message to add the body to
* \param bodies The parts of the body to add
* \param bodies The message bodies to add
* \param num_bodies The parts of the body to add
* \retval 0 Success
* \retval -1 Failure
*/
@ -2370,7 +2371,7 @@ int ast_sip_add_body_multipart(pjsip_tx_data *tdata, const struct ast_sip_body *
* a body if it currently exists, it appends data to an existing body.
*
* \param tdata The message to append the body to
* \param body The string to append to the end of the current body
* \param body_text The string to append to the end of the current body
* \retval 0 Success
* \retval -1 Failure
*/
@ -2470,6 +2471,7 @@ int ast_sip_retrieve_auths(const struct ast_sip_auth_vector *auths, struct ast_s
*/
void ast_sip_cleanup_auths(struct ast_sip_auth *auths[], size_t num_auths);
AST_VECTOR(ast_sip_auth_objects_vector, struct ast_sip_auth *);
/*!
* \brief Retrieve relevant SIP auth structures from sorcery as a vector
*
@ -2479,17 +2481,16 @@ void ast_sip_cleanup_auths(struct ast_sip_auth *auths[], size_t num_auths);
* \retval 0 Success
* \retval -1 Number of auth objects found is less than the number of names supplied.
*
* \WARNING The number of auth objects retrieved may be less than the
* \warning The number of auth objects retrieved may be less than the
* number of auth ids supplied if auth objects couldn't be found for
* some of them.
*
* \NOTE Since the ref count on all auth objects returned has been
* \note Since the ref count on all auth objects returned has been
* bumped, you must call ast_sip_cleanup_auth_objects_vector() to decrement
* the ref count on all of the auth objects in the vector,
* then call AST_VECTOR_FREE() on the vector itself.
*
*/
AST_VECTOR(ast_sip_auth_objects_vector, struct ast_sip_auth *);
int ast_sip_retrieve_auths_vector(const struct ast_sip_auth_vector *auth_ids,
struct ast_sip_auth_objects_vector *auth_objects);
@ -2756,7 +2757,7 @@ void ast_sip_unregister_endpoint_formatter(struct ast_sip_endpoint_formatter *ob
* \brief Converts a sorcery object to a string of object properties.
*
* \param obj the sorcery object to convert
* \param str the string buffer to write the object data
* \param buf the string buffer to write the object data
* \retval 0 Success, non-zero on failure
*/
int ast_sip_sorcery_object_to_ami(const void *obj, struct ast_str **buf);
@ -2765,7 +2766,7 @@ int ast_sip_sorcery_object_to_ami(const void *obj, struct ast_str **buf);
* \brief Formats the endpoint and sends over AMI.
*
* \param endpoint the endpoint to format and send
* \param endpoint ami AMI variable container
* \param ami AMI variable container
* \param count the number of formatters operated on
* \retval 0 Success, otherwise non-zero on error
*/
@ -2916,8 +2917,6 @@ struct ast_sip_supplement {
* Similarly, a module could reject an incoming request if desired.
*
* \param supplement The supplement to register
* \retval 0 Success
* \retval -1 Failure
*/
void ast_sip_register_supplement(struct ast_sip_supplement *supplement);
@ -3057,7 +3056,6 @@ char *ast_sip_get_default_voicemail_extension(void);
*
* \param[out] realm The default realm
* \param size The buffer size of realm
* \return nothing
*/
void ast_sip_get_default_realm(char *realm, size_t size);
@ -3070,7 +3068,6 @@ void ast_sip_get_default_realm(char *realm, size_t size);
*
* \param[out] from_user The default from user
* \param size The buffer size of from_user
* \return nothing
*/
void ast_sip_get_default_from_user(char *from_user, size_t size);
@ -3307,8 +3304,6 @@ int ast_sip_str_to_dtmf(const char *dtmf_mode);
* \param data User data to know what to do when transport shuts down.
*
* \note The callback does not need to care that data is an ao2 object.
*
* \return Nothing
*/
typedef void (*ast_transport_monitor_shutdown_cb)(void *data);
@ -3411,8 +3406,6 @@ void ast_sip_transport_monitor_unregister(pjsip_transport *transport,
*
* \note The data object passed into the original register will have its reference count
* automatically decremented.
*
* \return Nothing
*/
void ast_sip_transport_monitor_unregister_all(ast_transport_monitor_shutdown_cb cb,
void *data, ast_transport_monitor_data_matcher matches);
@ -3429,8 +3422,6 @@ struct ast_sip_tpmgr_state_callback {
* \since 13.18.0
*
* \param element What we are registering.
*
* \return Nothing
*/
void ast_sip_transport_state_register(struct ast_sip_tpmgr_state_callback *element);
@ -3439,8 +3430,6 @@ void ast_sip_transport_state_register(struct ast_sip_tpmgr_state_callback *eleme
* \since 13.18.0
*
* \param element What we are unregistering.
*
* \return Nothing
*/
void ast_sip_transport_state_unregister(struct ast_sip_tpmgr_state_callback *element);

6
include/asterisk/res_pjsip_cli.h
Unescape View File

@ -73,7 +73,6 @@ struct ast_sip_cli_formatter_entry {
/*!
* \brief Registers a CLI formatter.
*
* \param name The name of the formatter, usually the sorcery object type.
* \param formatter An ao2_callback_fn that outputs the formatted data.
* \retval 0 Success, non-zero on failure
*/
@ -82,7 +81,7 @@ int ast_sip_register_cli_formatter(struct ast_sip_cli_formatter_entry *formatter
/*!
* \brief Unregisters a CLI formatter.
*
* \param name The name of the formatter, usually the sorcery object type.
* \param formatter The name of the formatter, usually the sorcery object type.
* \retval 0 Success, non-zero on failure
*/
int ast_sip_unregister_cli_formatter(struct ast_sip_cli_formatter_entry *formatter);
@ -99,7 +98,8 @@ struct ast_sip_cli_formatter_entry *ast_sip_lookup_cli_formatter(const char *nam
* \brief Prints a sorcery object's ast_variable list
*
* \param obj The sorcery object
* \param arg The ast_sip_cli_context.
* \param arg The ast_sip_cli_context
* \param flags
* \retval 0 Success, non-zero on failure
*/
int ast_sip_cli_print_sorcery_objectset(void *obj, void *arg, int flags);

2
include/asterisk/res_pjsip_presence_xml.h
Unescape View File

@ -70,6 +70,7 @@ void ast_sip_sanitize_xml(const char *input, char *output, size_t len);
* \param[out] pidfstate
* \param[out] pidfnote
* \param[out] local_state
* \param notify_early_inuse_ringing
*/
void ast_sip_presence_exten_state_to_str(int state, char **statestring,
char **pidfstate, char **pidfnote, enum ast_sip_pidf_state *local_state,
@ -113,7 +114,6 @@ pj_xml_node *ast_sip_presence_xml_create_node(pj_pool_t *pool,
* \param attr_name Name of attribute to find
* \param[out] node Node that was found or created
* \param[out] attr Attribute that was found or created
* \return The found attribute
*/
void ast_sip_presence_xml_find_node_attr(pj_pool_t* pool,
pj_xml_node *parent, const char *node_name, const char *attr_name,

7
include/asterisk/res_pjsip_pubsub.h
Unescape View File

@ -346,7 +346,7 @@ struct ast_sip_subscription_handler {
* When a subscriber wishes to create a subscription, it may call this function
* to allocate resources and to send the initial SUBSCRIBE out.
*
* \param subscriber The subscriber that is making the request.
* \param handler The subscriber that is making the request.
* \param endpoint The endpoint to whome the SUBSCRIBE will be sent.
* \param resource The resource to place in the SUBSCRIBE's Request-URI.
*/
@ -742,7 +742,7 @@ void ast_sip_pubsub_unregister_body_generator(struct ast_sip_pubsub_body_generat
* for a given content type if a primary body supplement for that content type
* has already been registered.
*
* \param generator Body generator to register
* \param supplement Body generator to register
* \retval 0 Success
* \retval -1 Failure
*/
@ -752,7 +752,7 @@ int ast_sip_pubsub_register_body_supplement(struct ast_sip_pubsub_body_supplemen
* \since 13.0.0
* \brief Unregister a body generator with the pubsub core.
*
* \param generator Body generator to unregister
* \param supplement Body generator to unregister
*/
void ast_sip_pubsub_unregister_body_supplement(struct ast_sip_pubsub_body_supplement *supplement);
@ -773,7 +773,6 @@ const char *ast_sip_subscription_get_body_subtype(struct ast_sip_subscription *s
* \brief Alert the pubsub core that the subscription is ready for destruction
*
* \param sub The subscription that is complete
* \return Nothing
*/
void ast_sip_subscription_destroy(struct ast_sip_subscription *sub);

8
include/asterisk/res_pjsip_session.h
Unescape View File

@ -479,7 +479,7 @@ struct ast_sip_channel_pvt *ast_sip_channel_pvt_alloc(void *pvt, struct ast_sip_
*
* \param endpoint The endpoint that this session communicates with
* \param contact The contact associated with this session
* \param inv_session The PJSIP INVITE session data
* \param inv The PJSIP INVITE session data
* \param rdata INVITE request received (NULL if for outgoing allocation)
*/
struct ast_sip_session *ast_sip_session_alloc(struct ast_sip_endpoint *endpoint,
@ -492,8 +492,6 @@ struct ast_sip_session *ast_sip_session_alloc(struct ast_sip_endpoint *endpoint,
* \param session Which session to suspend the serializer.
*
* \note No channel locks can be held while calling without risk of deadlock.
*
* \return Nothing
*/
void ast_sip_session_suspend(struct ast_sip_session *session);
@ -502,8 +500,6 @@ void ast_sip_session_suspend(struct ast_sip_session *session);
* \since 12.7.0
*
* \param session Which session to unsuspend the serializer.
*
* \return Nothing
*/
void ast_sip_session_unsuspend(struct ast_sip_session *session);
@ -720,7 +716,6 @@ int ast_sip_session_refresh(struct ast_sip_session *session,
*
* \param session The session on which the answer will be updated
* \param on_sdp_creation Callback called when SDP is created
* \param generate_new_sdp Boolean to indicate if a new SDP should be created
* \retval 0 Successfully updated the SDP answer
* \retval -1 Failure to updated the SDP answer
*/
@ -845,6 +840,7 @@ struct ast_sip_session_media *ast_sip_session_media_state_add(struct ast_sip_ses
/*!
* \brief Save a media stats.
*
* \param sip_session Session on which to save active media state for
* \param media_state The media state to save
*/
void ast_sip_session_media_stats_save(struct ast_sip_session *sip_session, struct ast_sip_session_media_state *media_state);

2
res/res_pjsip/config_global.c
Unescape View File

@ -564,8 +564,6 @@ static int overload_trigger_to_str(const void *obj, const intptr_t *args, char *
* \param sorcery Instance being observed.
* \param object_type Name of object being observed.
* \param reloaded Non-zero if the object is being reloaded.
*
* \return Nothing
*/
static void global_loaded_observer(const char *name, const struct ast_sorcery *sorcery, const char *object_type, int reloaded)
{

2
res/res_pjsip/config_transport.c
Unescape View File

@ -1009,6 +1009,7 @@ static pj_ssl_cipher cipher_name_to_id(const char *name)
}
#endif
#if defined(PJ_HAS_SSL_SOCK) && PJ_HAS_SSL_SOCK != 0
/*!
* \internal
* \brief Add a new cipher to the transport's cipher list array.
@ -1019,7 +1020,6 @@ static pj_ssl_cipher cipher_name_to_id(const char *name)
* \retval 0 on success.
* \retval -1 on error.
*/
#if defined(PJ_HAS_SSL_SOCK) && PJ_HAS_SSL_SOCK != 0
static int transport_cipher_add(struct ast_sip_transport_state *state, const char *name)
{
pj_ssl_cipher cipher;

6
res/res_pjsip/include/res_pjsip_private.h
Unescape View File

@ -178,16 +178,12 @@ int ast_sip_destroy_sorcery_global(void);
/*!
* \internal
* \brief Initialize global headers support
*
* \return Nothing
*/
void ast_sip_initialize_global_headers(void);
/*!
* \internal
* \brief Destroy global headers support
*
* \return Nothing
*/
void ast_sip_destroy_global_headers(void);
@ -383,7 +379,7 @@ int ast_sip_will_uri_survive_restart(pjsip_sip_uri *uri, struct ast_sip_endpoint
* for that period of time, it also prevents issues if the transport
* disconnects while we're still trying to process a response.
* (Attack mitigation)
* 3. If enabled by global/keep_alive_interval, it sends '\r\n'
* 3. If enabled by global/keep_alive_interval, it sends '\\r\\n'
* keepalives on reliable transports at the interval specified.
*
* \retval -1 Failure

2
res/res_pjsip/pjsip_distributor.c
Unescape View File

@ -1219,8 +1219,6 @@ static struct ast_sorcery_observer global_observer = {
* \internal
* \brief Shutdown the serializers in the distributor pool.
* \since 13.10.0
*
* \return Nothing
*/
static void distributor_pool_shutdown(void)
{

2
res/res_pjsip/pjsip_transport_events.c
Unescape View File

@ -121,8 +121,6 @@ static void transport_monitor_dtor(void *vdoomed)
*
* \param transports Active transports container
* \param transport Which transport to do callbacks for.
*
* \return Nothing
*/
static void transport_state_do_reg_callbacks(struct ao2_container *transports, pjsip_transport *transport)
{

3
res/res_pjsip_authenticator_digest.c
Unescape View File

@ -199,7 +199,8 @@ static pj_status_t digest_lookup(pj_pool_t *pool, const pj_str_t *realm,
* is from the same source that the nonce was calculated for. Including the realm
* ensures that multiple challenges to the same request have different nonces.
*
* \param A UNIX timestamp expressed as a string
* \param nonce
* \param timestamp A UNIX timestamp expressed as a string
* \param rdata The incoming request
* \param realm The realm for which authentication should occur
*/

5
res/res_pjsip_caller_id.c
Unescape View File

@ -467,6 +467,7 @@ static void caller_id_incoming_response(struct ast_sip_session *session, pjsip_r
* \internal
* \brief Create an identity header for an outgoing message
* \param hdr_name The name of the header to create
* \param base
* \param tdata The message to place the header on
* \param id The identification information for the new header
* \return newly-created header
@ -543,6 +544,7 @@ static void add_privacy_header(pjsip_tx_data *tdata, const struct ast_party_id *
/*!
* \internal
* \brief Add a P-Asserted-Identity header to an outbound message
* \param session The session on which communication is happening
* \param tdata The message to add the header to
* \param id The identification information used to populate the header
*/
@ -679,6 +681,7 @@ static void add_privacy_params(pjsip_tx_data *tdata, pjsip_fromto_hdr *hdr, cons
/*!
* \internal
* \brief Add a Remote-Party-ID header to an outbound message
* \param session The session on which communication is happening
* \param tdata The message to add the header to
* \param id The identification information used to populate the header
*/
@ -737,7 +740,7 @@ static void add_rpid_header(const struct ast_sip_session *session, pjsip_tx_data
*
* \param session The session on which we will be sending the message
* \param tdata The outbound message
* \param The identity information to place on the message
* \param id The identity information to place on the message
*/
static void add_id_headers(const struct ast_sip_session *session, pjsip_tx_data *tdata, const struct ast_party_id *id)
{

14
res/res_pjsip_history.c
Unescape View File

@ -73,12 +73,9 @@ struct pjsip_history_entry {
pjsip_msg *msg;
};
/*! \brief Mutex that protects \ref vector_history */
/*! \brief Mutex that protects \c vector_history */
AST_MUTEX_DEFINE_STATIC(history_lock);
/*! \brief The one and only history that we've captured */
static AST_VECTOR(vector_history_t, struct pjsip_history_entry *) vector_history;
struct expression_token;
/*! \brief An operator that we understand in an expression */
@ -161,6 +158,9 @@ struct expression_token {
/*! \brief Log level for history output */
static int log_level = -1;
/*! \brief The one and only history that we've captured */
static AST_VECTOR(vector_history_t, struct pjsip_history_entry *) vector_history;
/*!
* \brief Operator callback for determining equality
*/
@ -542,7 +542,7 @@ static struct expression_token *expression_token_free(struct expression_token *t
* \param value The value/operator/result to pack into the token
*
* \retval NULL on failure
* \retval \c expression_token on success
* \retval expression_token on success
*/
static struct expression_token *expression_token_alloc(enum expression_token_type token_type, void *value)
{
@ -772,7 +772,7 @@ static void clear_history_entry_cb(struct pjsip_history_entry *entry)
}
/*!
* \brief Remove all entries from \ref vector_history
* \brief Remove all entries from \c vector_history
*
* This must be called from a registered PJSIP thread
*/
@ -794,7 +794,7 @@ static int clear_history_entries(void *obj)
* polish notation expression, which is a queue of tokens that can be easily
* parsed.
*
* \params a The CLI arguments provided by the User, containing the infix expression
* \param a The CLI arguments provided by the User, containing the infix expression
*
* \retval NULL error
* \retval expression_token A 'queue' of expression tokens in RPN

95
res/res_pjsip_messaging.c
Unescape View File

@ -278,10 +278,13 @@ static int insert_user_in_contact_uri(const char *to, const char *endpoint_name,
* \brief Get endpoint and URI when the destination is only a single token
*
* "to" could be one of the following:
* endpoint_name
* hostname
* \verbatim
endpoint_name
hostname
* \endverbatim
*
* \param to Destination specified in MessageSend
* \param destination
* \param uri Pointer to URI variable. Must be freed by caller
* \return endpoint
*/
@ -341,18 +344,21 @@ static struct ast_sip_endpoint *handle_single_token(const char *to, char *destin
* \brief Get endpoint and URI when the destination contained a '/'
*
* "to" could be one of the following:
* endpoint/aor
* endpoint/<sip[s]:host>
* endpoint/<sip[s]:user@host>
* endpoint/"Bob" <sip[s]:host>
* endpoint/"Bob" <sip[s]:user@host>
* endpoint/sip[s]:host
* endpoint/sip[s]:user@host
* endpoint/host
* endpoint/user@host
* \verbatim
endpoint/aor
endpoint/<sip[s]:host>
endpoint/<sip[s]:user@host>
endpoint/"Bob" <sip[s]:host>
endpoint/"Bob" <sip[s]:user@host>
endpoint/sip[s]:host
endpoint/sip[s]:user@host
endpoint/host
endpoint/user@host
* \endverbatim
*
* \param to Destination specified in MessageSend
* \param uri Pointer to URI variable. Must be freed by caller
* \param destination, slash, atsign, scheme
* \return endpoint
*/
static struct ast_sip_endpoint *handle_slash(const char *to, char *destination, char **uri,
@ -490,16 +496,19 @@ static struct ast_sip_endpoint *handle_slash(const char *to, char *destination,
/*!
* \internal
* \brief Get endpoint and URI when the destination contained a '@' but no '/' or scheme
* \brief Get endpoint and URI when the destination contained a '\@' but no '/' or scheme
*
* "to" could be one of the following:
* <sip[s]:user@host>
* "Bob" <sip[s]:user@host>
* sip[s]:user@host
* user@host
* \verbatim
<sip[s]:user@host>
"Bob" <sip[s]:user@host>
sip[s]:user@host
user@host
* \endverbatim
*
* \param to Destination specified in MessageSend
* \param uri Pointer to URI variable. Must be freed by caller
* \param destination, slash, atsign, scheme
* \return endpoint
*/
static struct ast_sip_endpoint *handle_atsign(const char *to, char *destination, char **uri,
@ -564,35 +573,45 @@ static struct ast_sip_endpoint *handle_atsign(const char *to, char *destination,
* Expects the given 'to' to be in one of the following formats:
* Why we allow so many is a mystery.
*
* Basic:
* endpoint - We'll get URI from the default aor/contact
* endpoint/aor - We'll get the URI from the specific aor/contact
* endpoint@domain - We toss the domain part and just use the endpoint
* Basic:
*
* endpoint : We'll get URI from the default aor/contact
* endpoint/aor : We'll get the URI from the specific aor/contact
* endpoint@domain : We toss the domain part and just use the endpoint
*
* These all use the endpoint and specified URI:
* endpoint/<sip[s]:host>
* endpoint/<sip[s]:user@host>
* endpoint/"Bob" <sip[s]:host>
* endpoint/"Bob" <sip[s]:user@host>
* endpoint/sip[s]:host
* endpoint/sip[s]:user@host
* endpoint/host
* endpoint/user@host
* \verbatim
endpoint/<sip[s]:host>
endpoint/<sip[s]:user@host>
endpoint/"Bob" <sip[s]:host>
endpoint/"Bob" <sip[s]:user@host>
endpoint/sip[s]:host
endpoint/sip[s]:user@host
endpoint/host
endpoint/user@host
\endverbatim
*
* These all use the default endpoint and specified URI:
* <sip[s]:host>
* <sip[s]:user@host>
* "Bob" <sip[s]:host>
* "Bob" <sip[s]:user@host>
* sip[s]:host
* sip[s]:user@host
* \verbatim
<sip[s]:host>
<sip[s]:user@host>
"Bob" <sip[s]:host>
"Bob" <sip[s]:user@host>
sip[s]:host
sip[s]:user@host
\endverbatim
*
* These use the default endpoint and specified host:
* host
* user@host
* \verbatim
host
user@host
\endverbatim
*
* This form is similar to a dialstring:
* PJSIP/user@endpoint
* \verbatim
PJSIP/user@endpoint
\endverbatim
*
* In this case, the user will be added to the endpoint contact's URI.
* If the contact URI already has a user, it will be replaced.
*
@ -1203,7 +1222,7 @@ static void update_content_type(pjsip_tx_data *tdata, struct ast_msg *msg, struc
* \internal
* \brief Send a MESSAGE
*
* \param mdata The outbound message data structure
* \param data The outbound message data structure
*
* \return 0: success, -1: failure
*

2
res/res_pjsip_outbound_authenticator_digest.c
Unescape View File

@ -118,7 +118,7 @@ static int is_digest_algorithm_supported(pjsip_www_authenticate_hdr *auth_hdr)
* In the end, we'll have accumulated a list of credentials we can pass to
* pjproject that it can use to add Authentication headers to a request.
*
* \NOTE: Neither we nor pjproject can currently handle digest algorithms
* \note: Neither we nor pjproject can currently handle digest algorithms
* other than MD5. We don't even have a place for it in the ast_sip_auth
* object. For this reason, we just skip processing any Authenticate
* header that's not MD5. When we support the others, we'll move the

4
res/res_pjsip_outbound_registration.c
Unescape View File

@ -880,8 +880,6 @@ static int reregister_immediately_cb(void *obj)
* \param obj What is needed to initiate a reregister attempt.
*
* \note Normally executed by the pjsip monitor thread.
*
* \return Nothing
*/
static void registration_transport_shutdown_cb(void *obj)
{
@ -2144,8 +2142,6 @@ static int check_state(void *obj, void *arg, int flags)
* \param sorcery Instance being observed.
* \param object_type Name of object being observed.
* \param reloaded Non-zero if the object is being reloaded.
*
* \return Nothing
*/
static void registration_loaded_observer(const char *name, const struct ast_sorcery *sorcery, const char *object_type, int reloaded)
{

4
res/res_pjsip_path.c
Unescape View File

@ -103,8 +103,8 @@ static struct ast_sip_aor *find_aor(struct ast_sip_endpoint *endpoint, pjsip_uri
/*!
* \brief Get the path string associated with this contact and tdata
*
* \param endpoint The endpoint from which to pull associated path data
* \param contact_uri The URI identifying the associated contact
* \param pool
* \param contact The URI identifying the associated contact
* \param path_str The place to store the retrieved path information
*
* \retval zero on success

6
res/res_pjsip_publish_asterisk.c
Unescape View File

@ -166,9 +166,8 @@ static const struct ast_datastore_info asterisk_mwi_publisher_state_datastore =
/*!
* \brief Callback function for device state events
* \param ast_event
* \param data void pointer to ast_client structure
* \return void
* \param sub, msg
*/
static void asterisk_publisher_devstate_cb(void *data, struct stasis_subscription *sub, struct stasis_message *msg)
{
@ -225,9 +224,8 @@ static void asterisk_publisher_devstate_cb(void *data, struct stasis_subscriptio
/*!
* \brief Callback function for mailbox state events
* \param ast_event
* \param data void pointer to ast_client structure
* \return void
* \param sub, msg
*/
static void asterisk_publisher_mwistate_cb(void *data, struct stasis_subscription *sub, struct stasis_message *msg)
{

8
res/res_pjsip_pubsub.c
Unescape View File

@ -597,8 +597,6 @@ static int sub_tree_subscription_terminate_cb(void *data)
* \param data What subscription needs to be terminated.
*
* \note Normally executed by the pjsip monitor thread.
*
* \return Nothing
*/
static void sub_tree_transport_cb(void *data)
{
@ -927,7 +925,7 @@ static struct resource_list *retrieve_resource_list(const char *resource, const
*
* \param resource The name of the resource for this tree node.
* \param visited The vector of resources that have been visited.
* \param if allocating a list, indicate whether full state is requested in notifications.
* \param full_state if allocating a list, indicate whether full state is requested in notifications.
* \retval NULL Allocation failure.
* \retval non-NULL The newly-allocated tree_node
*/
@ -1456,7 +1454,8 @@ static struct sip_subscription_tree *allocate_subscription_tree(struct ast_sip_e
* \param resource The requested resource in the SUBSCRIBE request
* \param generator The body generator to use in leaf subscriptions
* \param tree The resource tree on which the subscription tree is based
* \param dlg_status[out] The result of attempting to create a dialog.
* \param[out] dlg_status The result of attempting to create a dialog
* \param persistence
*
* \retval NULL Could not create the subscription tree
* \retval non-NULL The root of the created subscription tree
@ -2021,6 +2020,7 @@ static int sip_subscription_send_request(struct sip_subscription_tree *sub_tree,
* elements refer to later parts in the multipart body.
*
* \param pool PJLIB allocation pool
* \param rlmi
* \param cid Content-ID header of the resource
* \param resource_name Name of the resource
* \param resource_uri URI of the resource

5
res/res_pjsip_registrar.c
Unescape View File

@ -364,8 +364,6 @@ static int register_contact_transport_remove_cb(void *data)
* \param data What contact needs to be removed.
*
* \note Normally executed by the pjsip monitor thread.
*
* \return Nothing
*/
static void register_contact_transport_shutdown_cb(void *data)
{
@ -562,8 +560,7 @@ static int vec_contact_add(void *obj, void *arg, int flags)
*
* \param contacts Container of unmodified contacts that could remove.
* \param to_remove Maximum number of contacts to remove.
*
* \return Nothing
* \param response_contacts, remove_existing
*/
static void remove_excess_contacts(struct ao2_container *contacts, struct ao2_container *response_contacts,
unsigned int to_remove, unsigned int remove_existing)

2
res/res_pjsip_sdp_rtp.c
Unescape View File

@ -892,7 +892,7 @@ static enum ast_sip_session_media_encryption get_media_encryption_type(pj_str_t
* \brief Checks whether the encryption offered in SDP is compatible with the endpoint's configuration
* \internal
*
* \param endpoint_encryption Media encryption configured for the endpoint
* \param endpoint Media encryption configured for the endpoint
* \param stream pjmedia_sdp_media stream description
*
* \retval AST_SIP_MEDIA_TRANSPORT_INVALID on encryption mismatch

5
res/res_pjsip_session.c
Unescape View File

@ -1730,6 +1730,7 @@ static void set_from_header(struct ast_sip_session *session)
* \internal
* \brief Validate a media state
*
* \param session_name For log messages
* \param state Media state
*
* \retval 1 The media state is valid
@ -1815,7 +1816,7 @@ end:
* \param delayed_pending_state The pending media state at the time the resuest was queued
* \param delayed_active_state The active media state at the time the resuest was queued
* \param current_active_state The current active media state
* \param run_validation Whether to run validation on the resulting media state or not
* \param run_post_validation Whether to run validation on the resulting media state or not
*
* \returns New merged topology or NULL if there's an error
*
@ -3588,8 +3589,6 @@ int ast_sip_session_defer_termination(struct ast_sip_session *session)
* \since 13.5.0
*
* \param session Which session to stop the timer.
*
* \return Nothing
*/
static void sip_session_defer_termination_stop_timer(struct ast_sip_session *session)
{

3
res/res_pjsip_stir_shaken.c
Unescape View File

@ -64,7 +64,8 @@ static char *get_attestation_from_payload(const char *json_str)
/*!
* \brief Compare the caller ID from the INVITE with the one in the payload
*
* \param json_str The JSON string represntation of the payload
* \param caller_id
* \param json_str The JSON string representation of the payload
*
* \retval -1 on failure
* \retval 0 on success

Write Preview
Loading…
Cancel
Save