From ef9be94b35ad2cc8be221cc922b2a6740be60c6e Mon Sep 17 00:00:00 2001 From: "Kevin P. Fleming" Date: Mon, 21 Dec 2009 18:51:17 +0000 Subject: Change all refererences to 1.6.3 to be 1.8, since that will be the next feature release git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@235904 65c4cc65-6c06-0410-ace0-fbb531ad65f3 --- channels/chan_dahdi.c | 20 ++--- channels/chan_misdn.c | 2 +- channels/sig_analog.c | 2 +- channels/sig_pri.c | 52 ++++++------- contrib/upstart/asterisk.upstart-0.3.9 | 2 +- contrib/upstart/asterisk.user.conf | 2 +- include/asterisk/app.h | 2 +- include/asterisk/callerid.h | 12 +-- include/asterisk/cel.h | 20 ++--- include/asterisk/channel.h | 96 ++++++++++++------------ include/asterisk/doxyref.h | 2 +- include/asterisk/event.h | 4 +- include/asterisk/http.h | 10 +-- include/asterisk/logger.h | 6 +- include/asterisk/manager.h | 2 +- include/asterisk/rtp_engine.h | 130 ++++++++++++++++----------------- include/asterisk/security_events.h | 8 +- include/asterisk/stringfields.h | 2 +- include/asterisk/syslog.h | 10 +-- main/say.c | 2 +- 20 files changed, 193 insertions(+), 193 deletions(-) diff --git a/channels/chan_dahdi.c b/channels/chan_dahdi.c index ac592e9d4..a6829f1c9 100644 --- a/channels/chan_dahdi.c +++ b/channels/chan_dahdi.c @@ -1461,7 +1461,7 @@ static const struct ast_channel_tech dahdi_tech = { /*! * \internal * \brief Determine if sig_pri handles the signaling. - * \since 1.6.3 + * \since 1.8 * * \param signaling Signaling to determine if is for sig_pri. * @@ -2716,7 +2716,7 @@ static int my_pri_play_tone(void *pvt, enum sig_pri_tone tone) /*! * \internal * \brief Set the caller id information. - * \since 1.6.3 + * \since 1.8 * * \param pvt DAHDI private structure * \param caller Caller-id information to set. @@ -2744,7 +2744,7 @@ static void my_pri_set_callerid(void *pvt, const struct ast_party_caller *caller /*! * \internal * \brief Set the Dialed Number Identifier. - * \since 1.6.3 + * \since 1.8 * * \param pvt DAHDI private structure * \param dnid Dialed Number Identifier string. @@ -2761,7 +2761,7 @@ static void my_pri_set_dnid(void *pvt, const char *dnid) /*! * \internal * \brief Set the Redirecting Directory Number Information Service (RDNIS). - * \since 1.6.3 + * \since 1.8 * * \param pvt DAHDI private structure * \param rdnis Redirecting Directory Number Information Service (RDNIS) string. @@ -4829,7 +4829,7 @@ static int dahdi_call(struct ast_channel *ast, char *rdest, int timeout) /*! * \internal * \brief Insert the given chan_dahdi interface structure into the interface list. - * \since 1.6.3 + * \since 1.8 * * \param pvt chan_dahdi private interface structure to insert. * @@ -4881,7 +4881,7 @@ static void dahdi_iflist_insert(struct dahdi_pvt *pvt) /*! * \internal * \brief Extract the given chan_dahdi interface structure from the interface list. - * \since 1.6.3 + * \since 1.8 * * \param pvt chan_dahdi private interface structure to extract. * @@ -4919,7 +4919,7 @@ static void dahdi_iflist_extract(struct dahdi_pvt *pvt) /*! * \internal * \brief Insert the given chan_dahdi interface structure into the no B channel list. - * \since 1.6.3 + * \since 1.8 * * \param pri sig_pri span control structure holding no B channel list. * \param pvt chan_dahdi private interface structure to insert. @@ -4974,7 +4974,7 @@ static void dahdi_nobch_insert(struct sig_pri_pri *pri, struct dahdi_pvt *pvt) /*! * \internal * \brief Extract the given chan_dahdi interface structure from the no B channel list. - * \since 1.6.3 + * \since 1.8 * * \param pri sig_pri span control structure holding no B channel list. * \param pvt chan_dahdi private interface structure to extract. @@ -5014,7 +5014,7 @@ static void dahdi_nobch_extract(struct sig_pri_pri *pri, struct dahdi_pvt *pvt) /*! * \internal * \brief Unlink the channel interface from the PRI private pointer array. - * \since 1.6.3 + * \since 1.8 * * \param pvt chan_dahdi private interface structure to unlink. * @@ -11864,7 +11864,7 @@ static inline int available(struct dahdi_pvt *p, int channelmatch, ast_group_t g /*! * \internal * \brief Create a no B channel interface. - * \since 1.6.3 + * \since 1.8 * * \param pri sig_pri span controller to add interface. * diff --git a/channels/chan_misdn.c b/channels/chan_misdn.c index 39b096078..a7d74e2da 100644 --- a/channels/chan_misdn.c +++ b/channels/chan_misdn.c @@ -9404,7 +9404,7 @@ static void misdn_facility_ie_handler(enum event_e event, struct misdn_bchannel /*! * \internal * \brief Determine if the given dialed party matches our MSN. - * \since 1.6.3 + * \since 1.8 * * \param port ISDN port * \param dialed Dialed party information of incoming call. diff --git a/channels/sig_analog.c b/channels/sig_analog.c index e31e656bc..1fe2d5312 100644 --- a/channels/sig_analog.c +++ b/channels/sig_analog.c @@ -3512,7 +3512,7 @@ struct analog_pvt *analog_new(enum analog_sigtype signallingtype, struct analog_ /*! * \brief Delete the analog private structure. - * \since 1.6.3 + * \since 1.8 * * \param doomed Analog private structure to delete. * diff --git a/channels/sig_pri.c b/channels/sig_pri.c index 0a285e2e3..02ff0a198 100644 --- a/channels/sig_pri.c +++ b/channels/sig_pri.c @@ -123,7 +123,7 @@ static void sig_pri_set_digital(struct sig_pri_chan *p, int flag) /*! * \internal * \brief Set the caller id information in the parent module. - * \since 1.6.3 + * \since 1.8 * * \param p sig_pri channel structure. * @@ -154,7 +154,7 @@ static void sig_pri_set_caller_id(struct sig_pri_chan *p) /*! * \internal * \brief Set the Dialed Number Identifier. - * \since 1.6.3 + * \since 1.8 * * \param p sig_pri channel structure. * \param dnid Dialed Number Identifier string. @@ -171,7 +171,7 @@ static void sig_pri_set_dnid(struct sig_pri_chan *p, const char *dnid) /*! * \internal * \brief Set the Redirecting Directory Number Information Service (RDNIS). - * \since 1.6.3 + * \since 1.8 * * \param p sig_pri channel structure. * \param rdnis Redirecting Directory Number Information Service (RDNIS) string. @@ -215,7 +215,7 @@ static inline int pri_grab(struct sig_pri_chan *p, struct sig_pri_pri *pri) /*! * \internal * \brief Convert PRI redirecting reason to asterisk version. - * \since 1.6.3 + * \since 1.8 * * \param pri_reason PRI redirecting reason. * @@ -250,7 +250,7 @@ static enum AST_REDIRECTING_REASON pri_to_ast_reason(int pri_reason) /*! * \internal * \brief Convert asterisk redirecting reason to PRI version. - * \since 1.6.3 + * \since 1.8 * * \param ast_reason Asterisk redirecting reason. * @@ -285,7 +285,7 @@ static int ast_to_pri_reason(enum AST_REDIRECTING_REASON ast_reason) /*! * \internal * \brief Convert PRI number presentation to asterisk version. - * \since 1.6.3 + * \since 1.8 * * \param pri_presentation PRI number presentation. * @@ -334,7 +334,7 @@ static int pri_to_ast_presentation(int pri_presentation) /*! * \internal * \brief Convert asterisk number presentation to PRI version. - * \since 1.6.3 + * \since 1.8 * * \param ast_presentation Asterisk number presentation. * @@ -383,7 +383,7 @@ static int ast_to_pri_presentation(int ast_presentation) /*! * \internal * \brief Determine the overall presentation value for the given party. - * \since 1.6.3 + * \since 1.8 * * \param id Party to determine the overall presentation value. * @@ -458,7 +458,7 @@ static int overall_ast_presentation(const struct pri_party_id *id) /*! * \internal * \brief Fill in the asterisk party subaddress from the given PRI party subaddress. - * \since 1.6.3 + * \since 1.8 * * \param ast_subaddress Asterisk party subaddress structure. * \param pri_subaddress PRI party subaddress structure. @@ -539,7 +539,7 @@ static unsigned char ast_pri_pack_hex_char(char c) * \internal * \brief Convert a null terminated hexadecimal string to a packed hex byte array. * \details left justified, with 0 padding if odd length. - * \since 1.6.3 + * \since 1.8 * * \param dst pointer to packed byte array. * \param src pointer to null terminated hexadecimal string. @@ -579,7 +579,7 @@ static int ast_pri_pack_hex_string(unsigned char *dst, char *src, int maxlen) /*! * \internal * \brief Fill in the PRI party subaddress from the given asterisk party subaddress. - * \since 1.6.3 + * \since 1.8 * * \param pri_subaddress PRI party subaddress structure. * \param ast_subaddress Asterisk party subaddress structure. @@ -619,7 +619,7 @@ static void sig_pri_party_subaddress_from_ast(struct pri_party_subaddress *pri_s /*! * \internal * \brief Fill in the PRI party id from the given asterisk party id. - * \since 1.6.3 + * \since 1.8 * * \param pri_id PRI party id structure. * \param ast_id Asterisk party id structure. @@ -653,7 +653,7 @@ static void sig_pri_party_id_from_ast(struct pri_party_id *pri_id, const struct /*! * \internal * \brief Update the PRI redirecting information for the current call. - * \since 1.6.3 + * \since 1.8 * * \param pvt sig_pri private channel structure. * \param ast Asterisk channel @@ -685,7 +685,7 @@ static void sig_pri_redirecting_update(struct sig_pri_chan *pvt, struct ast_chan /*! * \internal * \brief Reset DTMF detector. - * \since 1.6.3 + * \since 1.8 * * \param p sig_pri channel structure. * @@ -1130,7 +1130,7 @@ static int pri_find_empty_chan(struct sig_pri_pri *pri, int backwards) /*! * \internal * \brief Find or create an empty no-B-channel interface to use. - * \since 1.6.3 + * \since 1.8 * * \param pri sig_pri span controller to find interface. * @@ -1167,7 +1167,7 @@ static int pri_find_empty_nobch(struct sig_pri_pri *pri) /*! * \internal * \brief Find the channel associated with the libpri call. - * \since 1.6.3 + * \since 1.8 * * \param pri sig_pri span controller to find interface. * \param call LibPRI opaque call pointer to find. @@ -1348,7 +1348,7 @@ void pri_event_noalarm(struct sig_pri_pri *pri, int index, int before_start_pri) /*! * \internal * \brief Convert libpri party id into asterisk party id. - * \since 1.6.3 + * \since 1.8 * * \param ast_id Asterisk party id structure to fill. Must already be set initialized. * \param pri_id libpri party id structure containing source information. @@ -1386,7 +1386,7 @@ static void sig_pri_party_id_convert(struct ast_party_id *ast_id, /*! * \internal * \brief Convert libpri redirecting information into asterisk redirecting information. - * \since 1.6.3 + * \since 1.8 * * \param ast_redirecting Asterisk redirecting structure to fill. * \param pri_redirecting libpri redirecting structure containing source information. @@ -1414,7 +1414,7 @@ static void sig_pri_redirecting_convert(struct ast_party_redirecting *ast_redire /*! * \internal * \brief Determine if the given extension matches one of the MSNs in the pattern list. - * \since 1.6.3 + * \since 1.8 * * \param msn_patterns Comma separated list of MSN patterns to match. * \param exten Extension to match in the MSN list. @@ -1447,7 +1447,7 @@ static int sig_pri_msn_match(const char *msn_patterns, const char *exten) /*! * \internal * \brief Obtain the sig_pri owner channel lock if the owner exists. - * \since 1.6.3 + * \since 1.8 * * \param pri sig_pri PRI control structure. * \param chanpos Channel position in the span. @@ -1478,7 +1478,7 @@ static void sig_pri_lock_owner(struct sig_pri_pri *pri, int chanpos) /*! * \internal * \brief Handle the call associated PRI subcommand events. - * \since 1.6.3 + * \since 1.8 * * \param pri sig_pri PRI control structure. * \param chanpos Channel position in the span. @@ -1660,7 +1660,7 @@ static void sig_pri_handle_subcmds(struct sig_pri_pri *pri, int chanpos, int eve /*! * \internal * \brief Attempt to transfer the active call to the held call. - * \since 1.6.3 + * \since 1.8 * * \param pri sig_pri PRI control structure. * \param active_call Active call to transfer. @@ -1732,7 +1732,7 @@ static int sig_pri_attempt_transfer(struct sig_pri_pri *pri, q931_call *active_c /*! * \internal * \brief Handle the hold event from libpri. - * \since 1.6.3 + * \since 1.8 * * \param pri sig_pri PRI control structure. * \param ev Hold event received. @@ -1808,7 +1808,7 @@ done_with_private:; /*! * \internal * \brief Handle the retrieve event from libpri. - * \since 1.6.3 + * \since 1.8 * * \param pri sig_pri PRI control structure. * \param ev Retrieve event received. @@ -3264,7 +3264,7 @@ exit: /*! * \brief Extract the called number and subaddress from the dial string. - * \since 1.6.3 + * \since 1.8 * * \param p sig_pri channel structure. * \param rdest Dial string buffer to extract called number and subaddress. @@ -4041,7 +4041,7 @@ struct sig_pri_chan *sig_pri_chan_new(void *pvt_data, struct sig_pri_callback *c /*! * \brief Delete the sig_pri private channel structure. - * \since 1.6.3 + * \since 1.8 * * \param doomed sig_pri private channel structure to delete. * diff --git a/contrib/upstart/asterisk.upstart-0.3.9 b/contrib/upstart/asterisk.upstart-0.3.9 index 25d88758a..385fd6102 100644 --- a/contrib/upstart/asterisk.upstart-0.3.9 +++ b/contrib/upstart/asterisk.upstart-0.3.9 @@ -11,7 +11,7 @@ # sudo stop asterisk description "Asterisk PBX" -version "1.6.3" +version "1.8" start on runlevel 2 start on runlevel 3 diff --git a/contrib/upstart/asterisk.user.conf b/contrib/upstart/asterisk.user.conf index c09c9c0c8..0161d2ee0 100644 --- a/contrib/upstart/asterisk.user.conf +++ b/contrib/upstart/asterisk.user.conf @@ -21,7 +21,7 @@ # description "Asterisk PBX" -#version "1.6.3" +#version "1.8" start on runlevel [2345] stop on runlevel [!2345] diff --git a/include/asterisk/app.h b/include/asterisk/app.h index a7c0730e9..0cb11ceca 100644 --- a/include/asterisk/app.h +++ b/include/asterisk/app.h @@ -115,7 +115,7 @@ int ast_app_getdata(struct ast_channel *c, const char *prompt, char *s, int maxl int ast_app_getdata_full(struct ast_channel *c, const char *prompt, char *s, int maxlen, int timeout, int audiofd, int ctrlfd); /*! - * \since 1.6.3 + * \since 1.8 * \brief Run a macro on a channel, placing a second channel into autoservice. * * This is a shorthand method that makes it very easy to run a macro on any given diff --git a/include/asterisk/callerid.h b/include/asterisk/callerid.h index c5e24a30a..49b14c2d1 100644 --- a/include/asterisk/callerid.h +++ b/include/asterisk/callerid.h @@ -398,7 +398,7 @@ enum AST_REDIRECTING_REASON { }; /*! - * \since 1.6.3 + * \since 1.8 * \brief Convert redirecting reason text code to value (used in config file parsing) * * \param data text string from config file @@ -409,7 +409,7 @@ enum AST_REDIRECTING_REASON { int ast_redirecting_reason_parse(const char *data); /*! - * \since 1.6.3 + * \since 1.8 * \brief Convert redirecting reason value to explanatory string * * \param data Q931_REDIRECTING_REASON from callerid.h @@ -419,7 +419,7 @@ int ast_redirecting_reason_parse(const char *data); const char *ast_redirecting_reason_describe(int data); /*! - * \since 1.6.3 + * \since 1.8 * \brief Convert redirecting reason value to text code * * \param data Q931_REDIRECTING_REASON from callerid.h @@ -445,7 +445,7 @@ enum AST_CONNECTED_LINE_UPDATE_SOURCE { }; /*! - * \since 1.6.3 + * \since 1.8 * \brief Convert connected line update source text code to value (used in config file parsing) * * \param data text string from config file @@ -456,7 +456,7 @@ enum AST_CONNECTED_LINE_UPDATE_SOURCE { int ast_connected_line_source_parse(const char *data); /*! - * \since 1.6.3 + * \since 1.8 * \brief Convert connected line update source value to explanatory string * * \param data AST_CONNECTED_LINE_UPDATE_SOURCE from callerid.h @@ -466,7 +466,7 @@ int ast_connected_line_source_parse(const char *data); const char *ast_connected_line_source_describe(int data); /*! - * \since 1.6.3 + * \since 1.8 * \brief Convert connected line update source value to text code * * \param data AST_CONNECTED_LINE_UPDATE_SOURCE from callerid.h diff --git a/include/asterisk/cel.h b/include/asterisk/cel.h index 14f886db2..f221dd643 100644 --- a/include/asterisk/cel.h +++ b/include/asterisk/cel.h @@ -96,7 +96,7 @@ enum ast_cel_event_type { /*! * \brief Check to see if CEL is enabled * - * \since 1.6.3 + * \since 1.8 * * \retval zero not enabled * \retval non-zero enabled @@ -106,7 +106,7 @@ unsigned int ast_cel_check_enabled(void); /*! * \brief Allocate a CEL record * - * \since 1.6.3 + * \since 1.8 * * \note The CEL record must be destroyed with ast_cel_destroy(). * @@ -120,7 +120,7 @@ struct ast_cel *ast_cel_alloc(void); * * \param cel the record to destroy * - * \since 1.6.3 + * \since 1.8 * * \return nothing. */ @@ -131,7 +131,7 @@ void ast_cel_destroy(struct ast_cel *cel); * * \param type the type to get the name of * - * \since 1.6.3 + * \since 1.8 * * \return the string representation of the type */ @@ -142,7 +142,7 @@ const char *ast_cel_get_type_name(enum ast_cel_event_type type); * * \param name the event type name as a string * - * \since 1.6.3 + * \since 1.8 * * \return the ast_cel_event_type given by the string */ @@ -153,7 +153,7 @@ enum ast_cel_event_type ast_cel_str_to_event_type(const char *name); * * \param[in] flag the flag to convert to a string * - * \since 1.6.3 + * \since 1.8 * * \return the string representation of the flag */ @@ -164,7 +164,7 @@ const char *ast_cel_get_ama_flag_name(enum ast_cel_ama_flag flag); * * \param chan channel that is being destroyed or its linkedid is changing * - * \since 1.6.3 + * \since 1.8 * * If at least one CEL backend is looking for CEL_LINKEDID_END * events, this function will check if the given channel is the last @@ -183,7 +183,7 @@ void ast_cel_check_retire_linkedid(struct ast_channel *chan); * * \param event the CEL event * - * \since 1.6.3 + * \since 1.8 * * \return a channel with the data filled in, or NULL on error * @@ -208,7 +208,7 @@ struct ast_channel *ast_cel_fabricate_channel_from_event(const struct ast_event * of peer2 will go into the "peer name" field. If neither are available, the * peer name field will be blank. * - * \since 1.6.3 + * \since 1.8 * * \pre chan and peer2 are both unlocked * @@ -262,7 +262,7 @@ struct ast_cel_event_record { * \param[in] event the CEL event * \param[out] r the ast_cel_event_record to fill in * - * \since 1.6.3 + * \since 1.8 * * \retval 0 success * \retval non-zero failure diff --git a/include/asterisk/channel.h b/include/asterisk/channel.h index b29939fb6..6619e705b 100644 --- a/include/asterisk/channel.h +++ b/include/asterisk/channel.h @@ -185,7 +185,7 @@ struct ast_generator { }; /*! - * \since 1.6.3 + * \since 1.8 * \brief Information needed to specify a subaddress in a call. * \note All string fields here are malloc'ed, so they need to be * freed when the structure is deleted. @@ -304,7 +304,7 @@ struct ast_callerid { }; /*! - * \since 1.6.3 + * \since 1.8 * \brief Information needed to identify an endpoint in a call. * \note All string fields here are malloc'ed, so they need to be * freed when the structure is deleted. @@ -328,7 +328,7 @@ struct ast_party_id { }; /*! - * \since 1.6.3 + * \since 1.8 * \brief Caller Party information. * \note All string fields here are malloc'ed, so they need to be * freed when the structure is deleted. @@ -345,7 +345,7 @@ struct ast_party_caller { }; /*! - * \since 1.6.3 + * \since 1.8 * \brief Connected Line/Party information. * \note All string fields here are malloc'ed, so they need to be * freed when the structure is deleted. @@ -377,7 +377,7 @@ struct ast_party_connected_line { }; /*! - * \since 1.6.3 + * \since 1.8 * \brief Redirecting Line information. * RDNIS (Redirecting Directory Number Information Service) * Where a call diversion or transfer was invoked. @@ -971,7 +971,7 @@ int ast_setstate(struct ast_channel *chan, enum ast_channel_state); /*! * \brief Create a channel structure - * \since 1.6.3 + * \since 1.8 * * \retval NULL failure * \retval non-NULL successfully allocated channel @@ -1120,7 +1120,7 @@ void ast_change_name(struct ast_channel *chan, const char *newname); * * \return NULL, convenient for clearing invalid pointers * - * \since 1.6.3 + * \since 1.8 */ struct ast_channel *ast_channel_release(struct ast_channel *chan); @@ -1283,7 +1283,7 @@ int ast_softhangup_nolock(struct ast_channel *chan, int reason); * \param chan channel to set the field on * \param source a string describing the source of the hangup for this channel * - * \since 1.6.3 + * \since 1.8 * * Hangupsource is generally the channel name that caused the bridge to be * hung up, but it can also be other things such as "dialplan/agi" @@ -2212,7 +2212,7 @@ struct ast_group_info { * * \retval c always * - * \since 1.6.3 + * \since 1.8 */ #define ast_channel_ref(c) ({ ao2_ref(c, +1); (c); }) @@ -2223,7 +2223,7 @@ struct ast_group_info { * * \retval NULL always * - * \since 1.6.3 + * \since 1.8 */ #define ast_channel_unref(c) ({ ao2_ref(c, -1); (struct ast_channel *) (NULL); }) @@ -2247,7 +2247,7 @@ struct ast_channel_iterator; * \return NULL, for convenience to clear out the pointer to the iterator that * was just destroyed. * - * \since 1.6.3 + * \since 1.8 */ struct ast_channel_iterator *ast_channel_iterator_destroy(struct ast_channel_iterator *i); @@ -2264,7 +2264,7 @@ struct ast_channel_iterator *ast_channel_iterator_destroy(struct ast_channel_ite * \retval NULL on failure * \retval a new channel iterator based on the specified parameters * - * \since 1.6.3 + * \since 1.8 */ struct ast_channel_iterator *ast_channel_iterator_by_exten_new(const char *exten, const char *context); @@ -2283,7 +2283,7 @@ struct ast_channel_iterator *ast_channel_iterator_by_exten_new(const char *exten * \retval NULL on failure * \retval a new channel iterator based on the specified parameters * - * \since 1.6.3 + * \since 1.8 */ struct ast_channel_iterator *ast_channel_iterator_by_name_new(const char *name, size_t name_len); @@ -2296,7 +2296,7 @@ struct ast_channel_iterator *ast_channel_iterator_by_name_new(const char *name, * \retval NULL on failure * \retval a new channel iterator * - * \since 1.6.3 + * \since 1.8 */ struct ast_channel_iterator *ast_channel_iterator_all_new(void); @@ -2313,7 +2313,7 @@ struct ast_channel_iterator *ast_channel_iterator_all_new(void); * was created. * \retval NULL, if no more channels match the iterator parameters. * - * \since 1.6.3 + * \since 1.8 */ struct ast_channel *ast_channel_iterator_next(struct ast_channel_iterator *i); @@ -2325,7 +2325,7 @@ struct ast_channel *ast_channel_iterator_next(struct ast_channel_iterator *i); * This function executes a callback one time for each active channel on the * system. The channel is provided as an argument to the function. * - * \since 1.6.3 + * \since 1.8 */ struct ast_channel *ast_channel_callback(ao2_callback_data_fn *cb_fn, void *arg, void *data, int ao2_flags); @@ -2342,7 +2342,7 @@ struct ast_channel *ast_channel_callback(ao2_callback_data_fn *cb_fn, void *arg, * \retval a channel with the name specified by the argument * \retval NULL if no channel was found * - * \since 1.6.3 + * \since 1.8 */ struct ast_channel *ast_channel_get_by_name(const char *name); @@ -2357,7 +2357,7 @@ struct ast_channel *ast_channel_get_by_name(const char *name); * \retval a channel with the name prefix specified by the arguments * \retval NULL if no channel was found * - * \since 1.6.3 + * \since 1.8 */ struct ast_channel *ast_channel_get_by_name_prefix(const char *name, size_t name_len); @@ -2372,7 +2372,7 @@ struct ast_channel *ast_channel_get_by_name_prefix(const char *name, size_t name * \retval a channel that is at the specified extension and context * \retval NULL if no channel was found * - * \since 1.6.3 + * \since 1.8 */ struct ast_channel *ast_channel_get_by_exten(const char *exten, const char *context); @@ -2385,7 +2385,7 @@ void ast_channel_set_linkgroup(struct ast_channel *chan, struct ast_channel *pee /*! - * \since 1.6.3 + * \since 1.8 * \brief Initialize the given subaddress structure. * * \param init Subaddress structure to initialize. @@ -2395,7 +2395,7 @@ void ast_channel_set_linkgroup(struct ast_channel *chan, struct ast_channel *pee void ast_party_subaddress_init(struct ast_party_subaddress *init); /*! - * \since 1.6.3 + * \since 1.8 * \brief Copy the source party subaddress information to the destination party subaddress. * * \param dest Destination party subaddress @@ -2406,7 +2406,7 @@ void ast_party_subaddress_init(struct ast_party_subaddress *init); void ast_party_subaddress_copy(struct ast_party_subaddress *dest, const struct ast_party_subaddress *src); /*! - * \since 1.6.3 + * \since 1.8 * \brief Initialize the given party subadress structure using the given guide * for a set update operation. * @@ -2425,7 +2425,7 @@ void ast_party_subaddress_copy(struct ast_party_subaddress *dest, const struct a void ast_party_subaddress_set_init(struct ast_party_subaddress *init, const struct ast_party_subaddress *guide); /*! - * \since 1.6.3 + * \since 1.8 * \brief Set the source party subaddress information into the destination party subaddress. * * \param dest Destination party subaddress @@ -2436,7 +2436,7 @@ void ast_party_subaddress_set_init(struct ast_party_subaddress *init, const stru void ast_party_subaddress_set(struct ast_party_subaddress *dest, const struct ast_party_subaddress *src); /*! - * \since 1.6.3 + * \since 1.8 * \brief Destroy the party subaddress contents * * \param doomed The party subaddress to destroy. @@ -2446,7 +2446,7 @@ void ast_party_subaddress_set(struct ast_party_subaddress *dest, const struct as void ast_party_subaddress_free(struct ast_party_subaddress *doomed); /*! - * \since 1.6.3 + * \since 1.8 * \brief Initialize the given caller structure. * * \param init Caller structure to initialize. @@ -2456,7 +2456,7 @@ void ast_party_subaddress_free(struct ast_party_subaddress *doomed); void ast_party_caller_init(struct ast_party_caller *init); /*! - * \since 1.6.3 + * \since 1.8 * \brief Copy the source caller information to the destination caller. * * \param dest Destination caller @@ -2467,7 +2467,7 @@ void ast_party_caller_init(struct ast_party_caller *init); void ast_party_caller_copy(struct ast_callerid *dest, const struct ast_callerid *src); /*! - * \since 1.6.3 + * \since 1.8 * \brief Initialize the given connected line structure. * * \param init Connected line structure to initialize. @@ -2477,7 +2477,7 @@ void ast_party_caller_copy(struct ast_callerid *dest, const struct ast_callerid void ast_party_connected_line_init(struct ast_party_connected_line *init); /*! - * \since 1.6.3 + * \since 1.8 * \brief Copy the source connected line information to the destination connected line. * * \param dest Destination connected line @@ -2488,7 +2488,7 @@ void ast_party_connected_line_init(struct ast_party_connected_line *init); void ast_party_connected_line_copy(struct ast_party_connected_line *dest, const struct ast_party_connected_line *src); /*! - * \since 1.6.3 + * \since 1.8 * \brief Initialize the given connected line structure using the given * guide for a set update operation. * @@ -2507,7 +2507,7 @@ void ast_party_connected_line_copy(struct ast_party_connected_line *dest, const void ast_party_connected_line_set_init(struct ast_party_connected_line *init, const struct ast_party_connected_line *guide); /*! - * \since 1.6.3 + * \since 1.8 * \brief Set the connected line information based on another connected line source * * This is similar to ast_party_connected_line_copy, except that NULL values for @@ -2521,7 +2521,7 @@ void ast_party_connected_line_set_init(struct ast_party_connected_line *init, co void ast_party_connected_line_set(struct ast_party_connected_line *dest, const struct ast_party_connected_line *src); /*! - * \since 1.6.3 + * \since 1.8 * \brief Collect the caller party information into a connected line structure. * * \param connected Collected caller information for the connected line @@ -2536,7 +2536,7 @@ void ast_party_connected_line_set(struct ast_party_connected_line *dest, const s void ast_party_connected_line_collect_caller(struct ast_party_connected_line *connected, struct ast_callerid *cid); /*! - * \since 1.6.3 + * \since 1.8 * \brief Destroy the connected line information contents * * \param doomed The connected line information to destroy. @@ -2546,7 +2546,7 @@ void ast_party_connected_line_collect_caller(struct ast_party_connected_line *co void ast_party_connected_line_free(struct ast_party_connected_line *doomed); /*! - * \since 1.6.3 + * \since 1.8 * \brief Copy the source redirecting information to the destination redirecting. * * \param dest Destination redirecting @@ -2557,7 +2557,7 @@ void ast_party_connected_line_free(struct ast_party_connected_line *doomed); void ast_party_redirecting_copy(struct ast_party_redirecting *dest, const struct ast_party_redirecting *src); /*! - * \since 1.6.3 + * \since 1.8 * \brief Initialize the given redirecting id structure using the given guide * for a set update operation. * @@ -2576,7 +2576,7 @@ void ast_party_redirecting_copy(struct ast_party_redirecting *dest, const struct void ast_party_redirecting_set_init(struct ast_party_redirecting *init, const struct ast_party_redirecting *guide); /*! - * \since 1.6.3 + * \since 1.8 * \brief Destroy the redirecting information contents * * \param doomed The redirecting information to destroy. @@ -2586,7 +2586,7 @@ void ast_party_redirecting_set_init(struct ast_party_redirecting *init, const st void ast_party_redirecting_free(struct ast_party_redirecting *doomed); /*! - * \since 1.6.3 + * \since 1.8 * \brief Copy the caller information to the connected line information. * * \param dest Destination connected line information @@ -2599,7 +2599,7 @@ void ast_party_redirecting_free(struct ast_party_redirecting *doomed); void ast_connected_line_copy_from_caller(struct ast_party_connected_line *dest, const struct ast_callerid *src); /*! - * \since 1.6.3 + * \since 1.8 * \brief Copy the connected line information to the caller information. * * \param dest Destination caller information @@ -2612,7 +2612,7 @@ void ast_connected_line_copy_from_caller(struct ast_party_connected_line *dest, void ast_connected_line_copy_to_caller(struct ast_callerid *dest, const struct ast_party_connected_line *src); /*! - * \since 1.6.3 + * \since 1.8 * \brief Set the connected line information in the Asterisk channel * * \param chan Asterisk channel to set connected line information @@ -2625,7 +2625,7 @@ void ast_connected_line_copy_to_caller(struct ast_callerid *dest, const struct a void ast_channel_set_connected_line(struct ast_channel *chan, const struct ast_party_connected_line *connected); /*! - * \since 1.6.3 + * \since 1.8 * \brief Build the connected line information data frame. * * \param data Buffer to fill with the frame data @@ -2638,7 +2638,7 @@ void ast_channel_set_connected_line(struct ast_channel *chan, const struct ast_p int ast_connected_line_build_data(unsigned char *data, size_t datalen, const struct ast_party_connected_line *connected); /*! - * \since 1.6.3 + * \since 1.8 * \brief Parse connected line indication frame data * * \param data Buffer with the frame data to parse @@ -2657,7 +2657,7 @@ int ast_connected_line_build_data(unsigned char *data, size_t datalen, const str int ast_connected_line_parse_data(const unsigned char *data, size_t datalen, struct ast_party_connected_line *connected); /*! - * \since 1.6.3 + * \since 1.8 * \brief Indicate that the connected line information has changed * * \param chan Asterisk channel to indicate connected line information @@ -2668,7 +2668,7 @@ int ast_connected_line_parse_data(const unsigned char *data, size_t datalen, str void ast_channel_update_connected_line(struct ast_channel *chan, const struct ast_party_connected_line *connected); /*! - * \since 1.6.3 + * \since 1.8 * \brief Queue a connected line update frame on a channel * * \param chan Asterisk channel to indicate connected line information @@ -2679,7 +2679,7 @@ void ast_channel_update_connected_line(struct ast_channel *chan, const struct as void ast_channel_queue_connected_line_update(struct ast_channel *chan, const struct ast_party_connected_line *connected); /*! - * \since 1.6.3 + * \since 1.8 * \brief Set the redirecting id information in the Asterisk channel * * \param chan Asterisk channel to set redirecting id information @@ -2692,7 +2692,7 @@ void ast_channel_queue_connected_line_update(struct ast_channel *chan, const str void ast_channel_set_redirecting(struct ast_channel *chan, const struct ast_party_redirecting *redirecting); /*! - * \since 1.6.3 + * \since 1.8 * \brief Build the redirecting id data frame. * * \param data Buffer to fill with the frame data @@ -2705,7 +2705,7 @@ void ast_channel_set_redirecting(struct ast_channel *chan, const struct ast_part int ast_redirecting_build_data(unsigned char *data, size_t datalen, const struct ast_party_redirecting *redirecting); /*! - * \since 1.6.3 + * \since 1.8 * \brief Parse redirecting indication frame data * * \param data Buffer with the frame data to parse @@ -2723,7 +2723,7 @@ int ast_redirecting_build_data(unsigned char *data, size_t datalen, const struct int ast_redirecting_parse_data(const unsigned char *data, size_t datalen, struct ast_party_redirecting *redirecting); /*! - * \since 1.6.3 + * \since 1.8 * \brief Indicate that the redirecting id has changed * * \param chan Asterisk channel to indicate redirecting id information @@ -2734,7 +2734,7 @@ int ast_redirecting_parse_data(const unsigned char *data, size_t datalen, struct void ast_channel_update_redirecting(struct ast_channel *chan, const struct ast_party_redirecting *redirecting); /*! - * \since 1.6.3 + * \since 1.8 * \brief Queue a redirecting update frame on a channel * * \param chan Asterisk channel to indicate redirecting id information @@ -2745,7 +2745,7 @@ void ast_channel_update_redirecting(struct ast_channel *chan, const struct ast_p void ast_channel_queue_redirecting_update(struct ast_channel *chan, const struct ast_party_redirecting *redirecting); /*! - * \since 1.6.3 + * \since 1.8 * \brief Run a connected line interception macro and update a channel's connected line * information * diff --git a/include/asterisk/doxyref.h b/include/asterisk/doxyref.h index a9c0d190e..5e24274a5 100644 --- a/include/asterisk/doxyref.h +++ b/include/asterisk/doxyref.h @@ -127,7 +127,7 @@ * * \section Changes162 Version 1.6.2 * - * \section Changes163 Version 1.6.3 + * \section Changes18 Version 1.8 * \li ast_channel_alloc() */ diff --git a/include/asterisk/event.h b/include/asterisk/event.h index d0b912c2a..5ffef1f35 100644 --- a/include/asterisk/event.h +++ b/include/asterisk/event.h @@ -168,7 +168,7 @@ int ast_event_sub_append_ie_uint(struct ast_event_sub *sub, * * \retval 0 success * \retval non-zero failure - * \since 1.6.3 + * \since 1.8 */ int ast_event_sub_append_ie_bitflags(struct ast_event_sub *sub, enum ast_event_ie_type ie_type, uint32_t flags); @@ -481,7 +481,7 @@ int ast_event_append_ie_uint(struct ast_event **event, enum ast_event_ie_type ie * * \retval 0 success * \retval -1 failure - * \since 1.6.3 + * \since 1.8 * * The pointer to the event will get updated with the new location for the event * that now contains the appended information element. If the re-allocation of diff --git a/include/asterisk/http.h b/include/asterisk/http.h index 688febfeb..4b13000a4 100644 --- a/include/asterisk/http.h +++ b/include/asterisk/http.h @@ -117,21 +117,21 @@ void ast_http_uri_unlink(struct ast_http_uri *urihandler); void ast_http_uri_unlink_all_with_key(const char *key); /*!\brief Return http method name string - * \since 1.6.3 + * \since 1.8 */ const char *ast_get_http_method(enum ast_http_method method) attribute_pure; /*!\brief Return mime type based on extension * \param ftype filename extension * \return String containing associated MIME type - * \since 1.6.3 + * \since 1.8 */ const char *ast_http_ftype2mtype(const char *ftype) attribute_pure; /*!\brief Return manager id, if exist, from request headers * \param headers List of HTTP headers * \return 32-bit associated manager session identifier - * \since 1.6.3 + * \since 1.8 */ uint32_t ast_http_manid_from_vars(struct ast_variable *headers) attribute_pure; @@ -159,7 +159,7 @@ uint32_t ast_http_manid_from_vars(struct ast_variable *headers) attribute_pure; * Both the http_header and out arguments will be freed by this function; * however, if FD is open, it will remain open. * - * \since 1.6.3 + * \since 1.8 */ void ast_http_send(struct ast_tcptls_session_instance *ser, enum ast_http_method method, int status_code, const char *status_title, struct ast_str *http_header, struct ast_str *out, const int fd, unsigned int static_content); @@ -183,7 +183,7 @@ void ast_http_prefix(char *buf, int len); * \param headers List of HTTP headers * \return List of variables within the POST body * \note Since returned list is malloc'd, list should be free'd by the calling function - * \since 1.6.3 + * \since 1.8 */ struct ast_variable *ast_http_get_post_vars(struct ast_tcptls_session_instance *ser, struct ast_variable *headers); diff --git a/include/asterisk/logger.h b/include/asterisk/logger.h index 4f6dfc4e9..75d07d6fe 100644 --- a/include/asterisk/logger.h +++ b/include/asterisk/logger.h @@ -199,7 +199,7 @@ unsigned int ast_verbose_get_by_file(const char *file); * \param name The name of the level to be registered * \retval -1 if an error occurs * \retval non-zero level to be used with ast_log for sending messages to this level - * \since 1.6.3 + * \since 1.8 */ int ast_logger_register_level(const char *name); @@ -207,7 +207,7 @@ int ast_logger_register_level(const char *name); * \brief Unregister a previously registered logger level * \param name The name of the level to be unregistered * \return nothing - * \since 1.6.3 + * \since 1.8 */ void ast_logger_unregister_level(const char *name); @@ -220,7 +220,7 @@ void ast_logger_unregister_level(const char *name); * the log message. * * \return nothing - * \since 1.6.3 + * \since 1.8 */ #define ast_log_dynamic_level(level, ...) ast_log(level, __FILE__, __LINE__, __PRETTY_FUNCTION__, __VA_ARGS__) diff --git a/include/asterisk/manager.h b/include/asterisk/manager.h index ddfbd3d31..f67b678a8 100644 --- a/include/asterisk/manager.h +++ b/include/asterisk/manager.h @@ -212,7 +212,7 @@ int astman_verify_session_writepermissions(uint32_t ident, int perm); * \param category Event category, matches manager authorization * \param event Event name * \param contents Format string describing event - * \since 1.6.3 + * \since 1.8 */ int __ast_manager_event_multichan(int category, const char *event, int chancount, struct ast_channel **chans, const char *file, int line, const char *func, diff --git a/include/asterisk/rtp_engine.h b/include/asterisk/rtp_engine.h index 4aeea3478..651ff8048 100644 --- a/include/asterisk/rtp_engine.h +++ b/include/asterisk/rtp_engine.h @@ -429,7 +429,7 @@ struct ast_rtp_glue { * \note It is recommended that you use the ast_rtp_engine_register macro so that the module is * associated with the RTP engine and use counting is performed. * - * \since 1.6.3 + * \since 1.8 */ int ast_rtp_engine_register2(struct ast_rtp_engine *engine, struct ast_module *module); @@ -450,7 +450,7 @@ int ast_rtp_engine_register2(struct ast_rtp_engine *engine, struct ast_module *m * This unregisters the RTP engine declared as example_rtp_engine from the RTP engine core. If a module * reference was provided when it was registered then this will only be called once the RTP engine is no longer in use. * - * \since 1.6.3 + * \since 1.8 */ int ast_rtp_engine_unregister(struct ast_rtp_engine *engine); @@ -477,7 +477,7 @@ int ast_rtp_engine_unregister(struct ast_rtp_engine *engine); * \note It is recommended that you use the ast_rtp_glue_register macro so that the module is * associated with the RTP glue and use counting is performed. * - * \since 1.6.3 + * \since 1.8 */ int ast_rtp_glue_register2(struct ast_rtp_glue *glue, struct ast_module *module); @@ -498,7 +498,7 @@ int ast_rtp_glue_register2(struct ast_rtp_glue *glue, struct ast_module *module) * This unregisters the RTP glue declared as example_rtp_gkue from the RTP engine core. If a module * reference was provided when it was registered then this will only be called once the RTP engine is no longer in use. * - * \since 1.6.3 + * \since 1.8 */ int ast_rtp_glue_unregister(struct ast_rtp_glue *glue); @@ -526,7 +526,7 @@ int ast_rtp_glue_unregister(struct ast_rtp_glue *glue); * \note The RTP engine does not have to use the address provided when creating an RTP instance. It may choose to use * another depending on it's own configuration. * - * \since 1.6.3 + * \since 1.8 */ struct ast_rtp_instance *ast_rtp_instance_new(const char *engine_name, struct sched_context *sched, struct sockaddr_in *sin, void *data); @@ -547,7 +547,7 @@ struct ast_rtp_instance *ast_rtp_instance_new(const char *engine_name, struct sc * This destroys the RTP instance pointed to by instance. Once this function returns instance no longer points to valid * memory and may not be used again. * - * \since 1.6.3 + * \since 1.8 */ int ast_rtp_instance_destroy(struct ast_rtp_instance *instance); @@ -566,7 +566,7 @@ int ast_rtp_instance_destroy(struct ast_rtp_instance *instance); * This sets the data pointer on the RTP instance pointed to by 'instance' to * blob. * - * \since 1.6.3 + * \since 1.8 */ void ast_rtp_instance_set_data(struct ast_rtp_instance *instance, void *data); @@ -583,7 +583,7 @@ void ast_rtp_instance_set_data(struct ast_rtp_instance *instance, void *data); * * This gets the data pointer on the RTP instance pointed to by 'instance'. * - * \since 1.6.3 + * \since 1.8 */ void *ast_rtp_instance_get_data(struct ast_rtp_instance *instance); @@ -604,7 +604,7 @@ void *ast_rtp_instance_get_data(struct ast_rtp_instance *instance); * This gives the frame pointed to by frame to the RTP engine being used for the instance * and asks that it be transmitted to the current remote address set on the RTP instance. * - * \since 1.6.3 + * \since 1.8 */ int ast_rtp_instance_write(struct ast_rtp_instance *instance, struct ast_frame *frame); @@ -626,7 +626,7 @@ int ast_rtp_instance_write(struct ast_rtp_instance *instance, struct ast_frame * * * This asks the RTP engine to read in RTP from the instance and return it as an Asterisk frame. * - * \since 1.6.3 + * \since 1.8 */ struct ast_frame *ast_rtp_instance_read(struct ast_rtp_instance *instance, int rtcp); @@ -648,7 +648,7 @@ struct ast_frame *ast_rtp_instance_read(struct ast_rtp_instance *instance, int r * This changes the remote address that RTP will be sent to on instance to the address given in the sin * structure. * - * \since 1.6.3 + * \since 1.8 */ int ast_rtp_instance_set_remote_address(struct ast_rtp_instance *instance, struct sockaddr_in *address); @@ -670,7 +670,7 @@ int ast_rtp_instance_set_remote_address(struct ast_rtp_instance *instance, struc * This changes the alternate remote address that RTP will be sent to on instance to the address given in the sin * structure. * - * \since 1.6.3 + * \since 1.8 */ int ast_rtp_instance_set_alt_remote_address(struct ast_rtp_instance *instance, struct sockaddr_in *address); @@ -692,7 +692,7 @@ int ast_rtp_instance_set_alt_remote_address(struct ast_rtp_instance *instance, s * This changes the local address that RTP is expected on to the address given in the sin * structure. * - * \since 1.6.3 + * \since 1.8 */ int ast_rtp_instance_set_local_address(struct ast_rtp_instance *instance, struct sockaddr_in *address); @@ -714,7 +714,7 @@ int ast_rtp_instance_set_local_address(struct ast_rtp_instance *instance, struct * * This gets the local address that we are expecting RTP on and stores it in the 'sin' structure. * - * \since 1.6.3 + * \since 1.8 */ int ast_rtp_instance_get_local_address(struct ast_rtp_instance *instance, struct sockaddr_in *address); @@ -737,7 +737,7 @@ int ast_rtp_instance_get_local_address(struct ast_rtp_instance *instance, struct * This retrieves the current remote address set on the instance pointed to by instance and puts the value * into the sin structure. * - * \since 1.6.3 + * \since 1.8 */ int ast_rtp_instance_get_remote_address(struct ast_rtp_instance *instance, struct sockaddr_in *address); @@ -748,7 +748,7 @@ int ast_rtp_instance_get_remote_address(struct ast_rtp_instance *instance, struc * \param property The extended property to set * \param value The value to set the extended property to * - * \since 1.6.3 + * \since 1.8 */ void ast_rtp_instance_set_extended_prop(struct ast_rtp_instance *instance, int property, void *value); @@ -758,7 +758,7 @@ void ast_rtp_instance_set_extended_prop(struct ast_rtp_instance *instance, int p * \param instance The RTP instance to get the extended property on * \param property The extended property to get * - * \since 1.6.3 + * \since 1.8 */ void *ast_rtp_instance_get_extended_prop(struct ast_rtp_instance *instance, int property); @@ -777,7 +777,7 @@ void *ast_rtp_instance_get_extended_prop(struct ast_rtp_instance *instance, int * * This enables the AST_RTP_PROPERTY_NAT property on the instance pointed to by instance. * - * \since 1.6.3 + * \since 1.8 */ void ast_rtp_instance_set_prop(struct ast_rtp_instance *instance, enum ast_rtp_property property, int value); @@ -797,7 +797,7 @@ void ast_rtp_instance_set_prop(struct ast_rtp_instance *instance, enum ast_rtp_p * * This returns the current value of the NAT property on the instance pointed to by instance. * - * \since 1.6.3 + * \since 1.8 */ int ast_rtp_instance_get_prop(struct ast_rtp_instance *instance, enum ast_rtp_property property); @@ -814,7 +814,7 @@ int ast_rtp_instance_get_prop(struct ast_rtp_instance *instance, enum ast_rtp_pr * * This gets the codecs structure on the RTP instance pointed to by 'instance'. * - * \since 1.6.3 + * \since 1.8 */ struct ast_rtp_codecs *ast_rtp_instance_get_codecs(struct ast_rtp_instance *instance); @@ -833,7 +833,7 @@ struct ast_rtp_codecs *ast_rtp_instance_get_codecs(struct ast_rtp_instance *inst * * This clears the codecs structure and puts it into a pristine state. * - * \since 1.6.3 + * \since 1.8 */ void ast_rtp_codecs_payloads_clear(struct ast_rtp_codecs *codecs, struct ast_rtp_instance *instance); @@ -852,7 +852,7 @@ void ast_rtp_codecs_payloads_clear(struct ast_rtp_codecs *codecs, struct ast_rtp * * This sets the default payloads on the codecs structure. * - * \since 1.6.3 + * \since 1.8 */ void ast_rtp_codecs_payloads_default(struct ast_rtp_codecs *codecs, struct ast_rtp_instance *instance); @@ -871,7 +871,7 @@ void ast_rtp_codecs_payloads_default(struct ast_rtp_codecs *codecs, struct ast_r * * This copies the payloads from the codecs0 structure to the codecs1 structure, overwriting any current values. * - * \since 1.6.3 + * \since 1.8 */ void ast_rtp_codecs_payloads_copy(struct ast_rtp_codecs *src, struct ast_rtp_codecs *dest, struct ast_rtp_instance *instance); @@ -890,7 +890,7 @@ void ast_rtp_codecs_payloads_copy(struct ast_rtp_codecs *src, struct ast_rtp_cod * * This records that the numerical payload '0' was seen in the codecs structure. * - * \since 1.6.3 + * \since 1.8 */ void ast_rtp_codecs_payloads_set_m_type(struct ast_rtp_codecs *codecs, struct ast_rtp_instance *instance, int payload); @@ -915,7 +915,7 @@ void ast_rtp_codecs_payloads_set_m_type(struct ast_rtp_codecs *codecs, struct as * * This records that the numerical payload '0' was seen with mime type 'audio' and sub mime type 'PCMU' in the codecs structure. * - * \since 1.6.3 + * \since 1.8 */ int ast_rtp_codecs_payloads_set_rtpmap_type(struct ast_rtp_codecs *codecs, struct ast_rtp_instance *instance, int payload, char *mimetype, char *mimesubtype, enum ast_rtp_options options); @@ -937,7 +937,7 @@ int ast_rtp_codecs_payloads_set_rtpmap_type(struct ast_rtp_codecs *codecs, struc * \retval -1 if the payload type is out of range * \retval -2 if the mimeType/mimeSubtype combination was not found * - * \since 1.6.3 + * \since 1.8 */ int ast_rtp_codecs_payloads_set_rtpmap_type_rate(struct ast_rtp_codecs *codecs, struct ast_rtp_instance *instance, int pt, char *mimetype, char *mimesubtype, @@ -959,7 +959,7 @@ int ast_rtp_codecs_payloads_set_rtpmap_type_rate(struct ast_rtp_codecs *codecs, * * This clears the payload '0' from the codecs structure. It will be as if it was never set. * - * \since 1.6.3 + * \since 1.8 */ void ast_rtp_codecs_payloads_unset(struct ast_rtp_codecs *codecs, struct ast_rtp_instance *instance, int payload); @@ -980,7 +980,7 @@ void ast_rtp_codecs_payloads_unset(struct ast_rtp_codecs *codecs, struct ast_rtp * * This looks up the information for payload '0' from the codecs structure. * - * \since 1.6.3 + * \since 1.8 */ struct ast_rtp_payload_type ast_rtp_codecs_payload_lookup(struct ast_rtp_codecs *codecs, int payload); @@ -992,7 +992,7 @@ struct ast_rtp_payload_type ast_rtp_codecs_payload_lookup(struct ast_rtp_codecs * * \return the sample rate if the format was found, zero if it was not found * - * \since 1.6.3 + * \since 1.8 */ unsigned int ast_rtp_lookup_sample_rate2(int asterisk_format, format_t code); @@ -1013,7 +1013,7 @@ unsigned int ast_rtp_lookup_sample_rate2(int asterisk_format, format_t code); * This retrieves all the formats known about in the codecs structure and puts the Asterisk ones in the integer * pointed to by astformats and the non-Asterisk ones in the integer pointed to by nonastformats. * - * \since 1.6.3 + * \since 1.8 */ void ast_rtp_codecs_payload_formats(struct ast_rtp_codecs *codecs, format_t *astformats, int *nonastformats); @@ -1034,7 +1034,7 @@ void ast_rtp_codecs_payload_formats(struct ast_rtp_codecs *codecs, format_t *ast * * This looks for the numerical payload for ULAW in the codecs structure. * - * \since 1.6.3 + * \since 1.8 */ int ast_rtp_codecs_payload_code(struct ast_rtp_codecs *codecs, const int asterisk_format, const format_t code); @@ -1056,7 +1056,7 @@ int ast_rtp_codecs_payload_code(struct ast_rtp_codecs *codecs, const int asteris * * This looks up the mime subtype for the ULAW format. * - * \since 1.6.3 + * \since 1.8 */ const char *ast_rtp_lookup_mime_subtype2(const int asterisk_format, const format_t code, enum ast_rtp_options options); @@ -1080,7 +1080,7 @@ const char *ast_rtp_lookup_mime_subtype2(const int asterisk_format, const format * * This returns the mime values for ULAW and ALAW in the buffer pointed to by buf. * - * \since 1.6.3 + * \since 1.8 */ char *ast_rtp_lookup_mime_multiple2(struct ast_str *buf, const format_t capability, const int asterisk_format, enum ast_rtp_options options); @@ -1099,7 +1099,7 @@ char *ast_rtp_lookup_mime_multiple2(struct ast_str *buf, const format_t capabili * * This sets the packetization preferences pointed to by prefs on the codecs structure pointed to by codecs. * - * \since 1.6.3 + * \since 1.8 */ void ast_rtp_codecs_packetization_set(struct ast_rtp_codecs *codecs, struct ast_rtp_instance *instance, struct ast_codec_pref *prefs); @@ -1121,7 +1121,7 @@ void ast_rtp_codecs_packetization_set(struct ast_rtp_codecs *codecs, struct ast_ * This starts sending the DTMF '1' on the RTP instance pointed to by instance. It will * continue being sent until it is ended. * - * \since 1.6.3 + * \since 1.8 */ int ast_rtp_instance_dtmf_begin(struct ast_rtp_instance *instance, char digit); @@ -1142,7 +1142,7 @@ int ast_rtp_instance_dtmf_begin(struct ast_rtp_instance *instance, char digit); * * This stops sending the DTMF '1' on the RTP instance pointed to by instance. * - * \since 1.6.3 + * \since 1.8 */ int ast_rtp_instance_dtmf_end(struct ast_rtp_instance *instance, char digit); @@ -1163,7 +1163,7 @@ int ast_rtp_instance_dtmf_end(struct ast_rtp_instance *instance, char digit); * * This sets the RTP instance to use RFC2833 for DTMF transmission and receiving. * - * \since 1.6.3 + * \since 1.8 */ int ast_rtp_instance_dtmf_mode_set(struct ast_rtp_instance *instance, enum ast_rtp_dtmf_mode dtmf_mode); @@ -1182,7 +1182,7 @@ int ast_rtp_instance_dtmf_mode_set(struct ast_rtp_instance *instance, enum ast_r * * This gets the DTMF mode set on the RTP instance pointed to by 'instance'. * - * \since 1.6.3 + * \since 1.8 */ enum ast_rtp_dtmf_mode ast_rtp_instance_dtmf_mode_get(struct ast_rtp_instance *instance); @@ -1200,7 +1200,7 @@ enum ast_rtp_dtmf_mode ast_rtp_instance_dtmf_mode_get(struct ast_rtp_instance *i * This indicates that a new source of media is feeding the instance pointed to by * instance. * - * \since 1.6.3 + * \since 1.8 */ void ast_rtp_instance_new_source(struct ast_rtp_instance *instance); @@ -1223,7 +1223,7 @@ void ast_rtp_instance_new_source(struct ast_rtp_instance *instance); * * This sets the TOS and COS values to 0 on the instance pointed to by instance. * - * \since 1.6.3 + * \since 1.8 */ int ast_rtp_instance_set_qos(struct ast_rtp_instance *instance, int tos, int cos, const char *desc); @@ -1241,7 +1241,7 @@ int ast_rtp_instance_set_qos(struct ast_rtp_instance *instance, int tos, int cos * This tells the RTP engine being used for the instance pointed to by instance * that media is no longer going to it at this time, but may in the future. * - * \since 1.6.3 + * \since 1.8 */ void ast_rtp_instance_stop(struct ast_rtp_instance *instance); @@ -1263,7 +1263,7 @@ void ast_rtp_instance_stop(struct ast_rtp_instance *instance); * This retrieves the file descriptor for the socket carrying media on the instance * pointed to by instance. * - * \since 1.6.3 + * \since 1.8 */ int ast_rtp_instance_fd(struct ast_rtp_instance *instance, int rtcp); @@ -1283,7 +1283,7 @@ int ast_rtp_instance_fd(struct ast_rtp_instance *instance, int rtcp); * * This retrieves the RTP glue that has the name 'Example'. * - * \since 1.6.3 + * \since 1.8 */ struct ast_rtp_glue *ast_rtp_instance_get_glue(const char *type); @@ -1301,7 +1301,7 @@ struct ast_rtp_glue *ast_rtp_instance_get_glue(const char *type); * * \note This should only be used by channel drivers in their technology declaration. * - * \since 1.6.3 + * \since 1.8 */ enum ast_bridge_result ast_rtp_instance_bridge(struct ast_channel *c0, struct ast_channel *c1, int flags, struct ast_frame **fo, struct ast_channel **rc, int timeoutms); @@ -1321,7 +1321,7 @@ enum ast_bridge_result ast_rtp_instance_bridge(struct ast_channel *c0, struct as * * This gets the RTP instance that instance0 is bridged to. * - * \since 1.6.3 + * \since 1.8 */ struct ast_rtp_instance *ast_rtp_instance_get_bridged(struct ast_rtp_instance *instance); @@ -1331,7 +1331,7 @@ struct ast_rtp_instance *ast_rtp_instance_get_bridged(struct ast_rtp_instance *i * \param c0 First channel part of the bridge * \param c1 Second channel part of the bridge * - * \since 1.6.3 + * \since 1.8 */ void ast_rtp_instance_early_bridge_make_compatible(struct ast_channel *c0, struct ast_channel *c1); @@ -1346,7 +1346,7 @@ void ast_rtp_instance_early_bridge_make_compatible(struct ast_channel *c0, struc * * \note This should only be used by channel drivers in their technology declaration. * - * \since 1.6.3 + * \since 1.8 */ int ast_rtp_instance_early_bridge(struct ast_channel *c0, struct ast_channel *c1); @@ -1361,7 +1361,7 @@ int ast_rtp_instance_early_bridge(struct ast_channel *c0, struct ast_channel *c1 * \retval 0 success * \retval -1 failure * - * \since 1.6.3 + * \since 1.8 */ int ast_rtp_red_init(struct ast_rtp_instance *instance, int buffer_time, int *payloads, int generations); @@ -1374,7 +1374,7 @@ int ast_rtp_red_init(struct ast_rtp_instance *instance, int buffer_time, int *pa * \retval 0 success * \retval -1 failure * - * \since 1.6.3 + * \since 1.8 */ int ast_rtp_red_buffer(struct ast_rtp_instance *instance, struct ast_frame *frame); @@ -1398,7 +1398,7 @@ int ast_rtp_red_buffer(struct ast_rtp_instance *instance, struct ast_frame *fram * This retrieves all statistics the underlying RTP engine supports and puts the values into the * stats structure. * - * \since 1.6.3 + * \since 1.8 */ int ast_rtp_instance_get_stats(struct ast_rtp_instance *instance, struct ast_rtp_instance_stats *stats, enum ast_rtp_instance_stat stat); @@ -1417,7 +1417,7 @@ int ast_rtp_instance_get_stats(struct ast_rtp_instance *instance, struct ast_rtp * This retrieves standard statistics from the RTP instance rtp and sets it on the channel pointed to * by chan. * - * \since 1.6.3 + * \since 1.8 */ void ast_rtp_instance_set_stats_vars(struct ast_channel *chan, struct ast_rtp_instance *instance); @@ -1441,7 +1441,7 @@ void ast_rtp_instance_set_stats_vars(struct ast_channel *chan, struct ast_rtp_in * * This retrieves general quality statistics and places a text representation into the buf pointed to by buf. * - * \since 1.6.3 + * \since 1.8 */ char *ast_rtp_instance_get_quality(struct ast_rtp_instance *instance, enum ast_rtp_instance_stat_field field, char *buf, size_t size); @@ -1462,7 +1462,7 @@ char *ast_rtp_instance_get_quality(struct ast_rtp_instance *instance, enum ast_r * * This requests that the RTP engine provide audio frames in the ULAW format. * - * \since 1.6.3 + * \since 1.8 */ int ast_rtp_instance_set_read_format(struct ast_rtp_instance *instance, format_t format); @@ -1483,7 +1483,7 @@ int ast_rtp_instance_set_read_format(struct ast_rtp_instance *instance, format_t * * This tells the underlying RTP engine that audio frames will be provided to it in ULAW format. * - * \since 1.6.3 + * \since 1.8 */ int ast_rtp_instance_set_write_format(struct ast_rtp_instance *instance, format_t format); @@ -1505,7 +1505,7 @@ int ast_rtp_instance_set_write_format(struct ast_rtp_instance *instance, format_ * * This makes the RTP instance for 'peer' compatible with 'instance' and vice versa. * - * \since 1.6.3 + * \since 1.8 */ int ast_rtp_instance_make_compatible(struct ast_channel *chan, struct ast_rtp_instance *instance, struct ast_channel *peer); @@ -1525,7 +1525,7 @@ int ast_rtp_instance_make_compatible(struct ast_channel *chan, struct ast_rtp_in * * This sees if it is possible to have ulaw communicated to the endpoint but signed linear received into Asterisk. * - * \since 1.6.3 + * \since 1.8 */ format_t ast_rtp_instance_available_formats(struct ast_rtp_instance *instance, format_t to_endpoint, format_t to_asterisk); @@ -1545,7 +1545,7 @@ format_t ast_rtp_instance_available_formats(struct ast_rtp_instance *instance, f * * This tells the underlying RTP engine of instance that packets will now flow. * - * \since 1.6.3 + * \since 1.8 */ int ast_rtp_instance_activate(struct ast_rtp_instance *instance); @@ -1565,7 +1565,7 @@ int ast_rtp_instance_activate(struct ast_rtp_instance *instance); * This requests that the RTP engine send a STUN BIND request on the session pointed to by * 'instance'. * - * \since 1.6.3 + * \since 1.8 */ void ast_rtp_instance_stun_request(struct ast_rtp_instance *instance, struct sockaddr_in *suggestion, const char *username); @@ -1583,7 +1583,7 @@ void ast_rtp_instance_stun_request(struct ast_rtp_instance *instance, struct soc * * This sets the RTP timeout value on 'instance' to be 5000. * - * \since 1.6.3 + * \since 1.8 */ void ast_rtp_instance_set_timeout(struct ast_rtp_instance *instance, int timeout); @@ -1601,7 +1601,7 @@ void ast_rtp_instance_set_timeout(struct ast_rtp_instance *instance, int timeout * * This sets the RTP hold timeout value on 'instance' to be 5000. * - * \since 1.6.3 + * \since 1.8 */ void ast_rtp_instance_set_hold_timeout(struct ast_rtp_instance *instance, int timeout); @@ -1620,7 +1620,7 @@ void ast_rtp_instance_set_hold_timeout(struct ast_rtp_instance *instance, int ti * * This gets the RTP timeout value for the RTP instance pointed to by 'instance'. * - * \since 1.6.3 + * \since 1.8 */ int ast_rtp_instance_get_timeout(struct ast_rtp_instance *instance); @@ -1639,7 +1639,7 @@ int ast_rtp_instance_get_timeout(struct ast_rtp_instance *instance); * * This gets the RTP hold timeout value for the RTP instance pointed to by 'instance'. * - * \since 1.6.3 + * \since 1.8 */ int ast_rtp_instance_get_hold_timeout(struct ast_rtp_instance *instance); @@ -1658,7 +1658,7 @@ int ast_rtp_instance_get_hold_timeout(struct ast_rtp_instance *instance); * * This gets the RTP engine currently in use on the RTP instance pointed to by 'instance'. * - * \since 1.6.3 + * \since 1.8 */ struct ast_rtp_engine *ast_rtp_instance_get_engine(struct ast_rtp_instance *instance); @@ -1677,7 +1677,7 @@ struct ast_rtp_engine *ast_rtp_instance_get_engine(struct ast_rtp_instance *inst * * This gets the RTP glue currently in use on the RTP instance pointed to by 'instance'. * - * \since 1.6.3 + * \since 1.8 */ struct ast_rtp_glue *ast_rtp_instance_get_active_glue(struct ast_rtp_instance *instance); @@ -1698,7 +1698,7 @@ struct ast_rtp_glue *ast_rtp_instance_get_active_glue(struct ast_rtp_instance *i * * \note This will only return a channel while in a local or remote bridge. * - * \since 1.6.3 + * \since 1.8 */ struct ast_channel *ast_rtp_instance_get_chan(struct ast_rtp_instance *instance); diff --git a/include/asterisk/security_events.h b/include/asterisk/security_events.h index c15d04f0e..461b671a4 100644 --- a/include/asterisk/security_events.h +++ b/include/asterisk/security_events.h @@ -64,7 +64,7 @@ struct ast_security_event_ie_type { * \retval NULL invalid event_type * \retval non-NULL An array terminated with the value AST_EVENT_IE_END * - * \since 1.6.3 + * \since 1.8 */ const struct ast_security_event_ie_type *ast_security_event_get_required_ies( const enum ast_security_event_type event_type); @@ -77,7 +77,7 @@ const struct ast_security_event_ie_type *ast_security_event_get_required_ies( * \retval NULL invalid event_type * \retval non-NULL An array terminated with the value AST_EVENT_IE_END * - * \since 1.6.3 + * \since 1.8 */ const struct ast_security_event_ie_type *ast_security_event_get_optional_ies( const enum ast_security_event_type event_type); @@ -90,7 +90,7 @@ const struct ast_security_event_ie_type *ast_security_event_get_optional_ies( * \retval NULL if event_type is invalid * \retval non-NULL the name of the security event type * - * \since 1.6.3 + * \since 1.8 */ const char *ast_security_event_get_name(const enum ast_security_event_type event_type); @@ -102,7 +102,7 @@ const char *ast_security_event_get_name(const enum ast_security_event_type event * \retval NULL if severity is invalid * \retval non-NULL the name of the security event severity * - * \since 1.6.3 + * \since 1.8 */ const char *ast_security_event_severity_get_name( const enum ast_security_event_severity severity); diff --git a/include/asterisk/stringfields.h b/include/asterisk/stringfields.h index 38b7ef6c0..e95b20fc2 100644 --- a/include/asterisk/stringfields.h +++ b/include/asterisk/stringfields.h @@ -264,7 +264,7 @@ int __ast_string_field_init(struct ast_string_field_mgr *mgr, struct ast_string_ * also allocate space for the stringfields and initialize the stringfield management * structure embedded in the outer structure. * - * \since 1.6.3 + * \since 1.8 */ #define ast_calloc_with_stringfields(n, type, size) \ __ast_calloc_with_stringfields(n, sizeof(type), offsetof(type, __field_mgr), offsetof(type, __field_mgr_pool), \ diff --git a/include/asterisk/syslog.h b/include/asterisk/syslog.h index 26d4e2573..a0dc9e9cf 100644 --- a/include/asterisk/syslog.h +++ b/include/asterisk/syslog.h @@ -29,7 +29,7 @@ extern "C" { #endif /*! - * \since 1.6.3 + * \since 1.8 * \brief Maps a syslog facility name from a string to a syslog facility * constant. * @@ -41,7 +41,7 @@ extern "C" { int ast_syslog_facility(const char *facility); /*! - * \since 1.6.3 + * \since 1.8 * \brief Maps a syslog facility constant to a string. * * \param facility syslog facility constant to map (i.e. LOG_DAEMON) @@ -52,7 +52,7 @@ int ast_syslog_facility(const char *facility); const char *ast_syslog_facility_name(int facility); /*! - * \since 1.6.3 + * \since 1.8 * \brief Maps a syslog priority name from a string to a syslog priority * constant. * @@ -64,7 +64,7 @@ const char *ast_syslog_facility_name(int facility); int ast_syslog_priority(const char *priority); /*! - * \since 1.6.3 + * \since 1.8 * \brief Maps a syslog priority constant to a string. * * \param priority syslog priority constant to map (i.e. LOG_NOTICE) @@ -75,7 +75,7 @@ int ast_syslog_priority(const char *priority); const char *ast_syslog_priority_name(int priority); /*! - * \since 1.6.3 + * \since 1.8 * \brief Maps an Asterisk log level (i.e. LOG_ERROR) to a syslog priority * constant. * diff --git a/main/say.c b/main/say.c index 7f7927308..c3ca18565 100644 --- a/main/say.c +++ b/main/say.c @@ -2378,7 +2378,7 @@ static int ast_say_number_full_zh(struct ast_channel *chan, int num, const char /*!\internal * \brief Counting in Urdu, the national language of Pakistan - * \since 1.6.3 + * \since 1.8 */ static int ast_say_number_full_ur(struct ast_channel *chan, int num, const char *ints, const char *language, const char *options, int audiofd, int ctrlfd) { -- cgit v1.2.3