mirror of
https://github.com/asterisk/asterisk.git
synced 2025-10-11 23:28:59 +00:00
Make some notes about common usage of pbx_builtin_getvar_helper() that is not
thread-safe. git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@111909 65c4cc65-6c06-0410-ace0-fbb531ad65f3
This commit is contained in:
@@ -800,6 +800,20 @@ int pbx_builtin_serialize_variables(struct ast_channel *chan, struct ast_str **b
|
||||
|
||||
/*!
|
||||
* \note Will lock the channel.
|
||||
*
|
||||
* \note This function will return a pointer to the buffer inside the channel
|
||||
* variable. This value should only be accessed with the channel locked. If
|
||||
* the value needs to be kept around, it should be done by using the following
|
||||
* thread-safe code:
|
||||
* \code
|
||||
* const char *var;
|
||||
*
|
||||
* ast_channel_lock(chan);
|
||||
* if ((var = pbx_builtin_getvar_helper(chan, "MYVAR"))) {
|
||||
* var = ast_strdupa(var);
|
||||
* }
|
||||
* ast_channel_unlock(chan);
|
||||
* \endcode
|
||||
*/
|
||||
const char *pbx_builtin_getvar_helper(struct ast_channel *chan, const char *name);
|
||||
|
||||
|
Reference in New Issue
Block a user