From a47b8e2d4025cbf102c976fcd6df5aa3a51e5fc4 Mon Sep 17 00:00:00 2001 From: George Joseph Date: Mon, 20 Jan 2025 11:33:20 -0700 Subject: [PATCH] docs: Add version information to manager event instance XML elements * Do a git blame on the embedded XML managerEvent elements. * From the commit hash, grab the summary line. * Do a git log --grep to find the cherry-pick commits in all branches that match. * Do a git patch-id to ensure the commits are all related and didn't get a false match on the summary. * Do a git tag --contains to find the tags that contain each commit. * Weed out all tags not ..0. * Sort and discard any .0.0 and following tags where the commit appeared in an earlier branch. * The result is a single tag for each branch where the application or function was defined. The events defined in res/res_pjsip/pjsip_manager.xml were done by hand because the XML was extracted from the C source file relatively recently. Two bugs were fixed along the way... * The get_documentation awk script was exiting after it processed the first DOCUMENTATION block it found in a file. We have at least 1 source file with multiple DOCUMENTATION blocks so only the first one in them was being processed. The awk script was changed to continue searching rather than exiting after the first block. * Fixing the awk script revealed an issue in logger.c where the third DOCUMENTATION block contained a XML fragment that consisted only of a managerEventInstance element that wasn't wrapped in a managerEvent element. Since logger_doc.xml already existed, the remaining fragments in logger.c were moved to it and properly organized. --- apps/app_agent_pool.c | 2 ++ apps/app_confbridge.c | 2 ++ apps/app_meetme.c | 8 ++++++++ apps/app_minivm.c | 1 + apps/app_mixmonitor.c | 3 +++ apps/app_queue.c | 16 ++++++++++++++++ apps/app_stack.c | 1 + apps/app_voicemail.c | 1 + apps/confbridge/confbridge_manager.c | 9 +++++++++ build_tools/get_documentation | 2 +- cdr/cdr_manager.c | 1 + cel/cel_manager.c | 1 + channels/chan_dahdi.c | 6 ++++++ channels/sig_pri.c | 1 + funcs/func_global.c | 1 + main/aoc.c | 3 +++ main/asterisk.c | 2 ++ main/channel.c | 1 + main/core_local.c | 3 +++ main/devicestate.c | 1 + main/loader.c | 3 +++ main/lock.c | 1 + main/logger.c | 25 ------------------------- main/logger_doc.xml | 20 ++++++++++++++++++++ main/manager_bridges.c | 8 ++++++++ main/manager_channels.c | 28 ++++++++++++++++++++++++++++ main/manager_doc.xml | 8 ++++++++ main/manager_mwi.c | 1 + main/pbx.c | 1 + main/pickup.c | 1 + main/presencestate.c | 1 + main/rtp_engine.c | 2 ++ main/security_events.c | 15 +++++++++++++++ main/stasis.c | 1 + main/stasis_bridges.c | 2 ++ main/stasis_channels.c | 5 +++++ main/stasis_endpoints.c | 2 ++ main/stasis_system.c | 1 + res/parking/parking_manager.c | 5 +++++ res/res_agi.c | 5 +++++ res/res_fax.c | 4 ++++ res/res_manager_devicestate.c | 1 + res/res_manager_presencestate.c | 1 + res/res_mwi_external_ami.c | 2 ++ res/res_pjsip/pjsip_manager.xml | 15 +++++++++++++++ 45 files changed, 197 insertions(+), 26 deletions(-) diff --git a/apps/app_agent_pool.c b/apps/app_agent_pool.c index b3f78a23bc..a0fc25fd84 100644 --- a/apps/app_agent_pool.c +++ b/apps/app_agent_pool.c @@ -181,6 +181,7 @@ + 12.0.0 Response event in a series to the Agents AMI action containing information about a defined agent. @@ -226,6 +227,7 @@ + 12.0.0 Final response event in a series of events to the Agents AMI action. diff --git a/apps/app_confbridge.c b/apps/app_confbridge.c index be63e696c9..6e7d8076bc 100644 --- a/apps/app_confbridge.c +++ b/apps/app_confbridge.c @@ -322,6 +322,7 @@ + 13.20.015.3.0 Raised as part of the ConfbridgeList action response list. @@ -401,6 +402,7 @@ + 16.29.018.15.019.7.0 Raised as part of the ConfbridgeListRooms action response list. diff --git a/apps/app_meetme.c b/apps/app_meetme.c index 28fe3ad029..754eed5882 100644 --- a/apps/app_meetme.c +++ b/apps/app_meetme.c @@ -506,6 +506,7 @@ + 12.0.0 Raised when a user joins a MeetMe conference. @@ -524,6 +525,7 @@ + 12.0.0 Raised when a user leaves a MeetMe conference. @@ -539,6 +541,7 @@ + 12.0.0 Raised when a MeetMe conference ends. @@ -550,6 +553,7 @@ + 12.0.0 Raised when a MeetMe user has started talking. @@ -568,6 +572,7 @@ + 12.0.0 Raised when a MeetMe user begins or ends talking. @@ -578,6 +583,7 @@ + 12.0.0 Raised when a MeetMe user is muted or unmuted. @@ -588,6 +594,7 @@ + 16.29.018.15.019.7.0 Raised in response to a MeetmeList command. @@ -635,6 +642,7 @@ + 16.29.018.15.019.7.0 Raised in response to a MeetmeListRooms command. diff --git a/apps/app_minivm.c b/apps/app_minivm.c index 876285afdd..f285d259dc 100644 --- a/apps/app_minivm.c +++ b/apps/app_minivm.c @@ -503,6 +503,7 @@ + 12.0.0 Raised when a notification is sent out by a MiniVoiceMail application diff --git a/apps/app_mixmonitor.c b/apps/app_mixmonitor.c index d1c31e1b38..abf2b1d451 100644 --- a/apps/app_mixmonitor.c +++ b/apps/app_mixmonitor.c @@ -319,6 +319,7 @@ + 16.17.018.3.0 Raised when monitoring has started on a channel. @@ -332,6 +333,7 @@ + 16.17.018.3.0 Raised when monitoring has stopped on a channel. @@ -345,6 +347,7 @@ + 16.17.018.3.0 Raised when monitoring is muted or unmuted on a channel. diff --git a/apps/app_queue.c b/apps/app_queue.c index 3c93ee460f..0842b56568 100644 --- a/apps/app_queue.c +++ b/apps/app_queue.c @@ -1134,6 +1134,7 @@ + 16.24.018.10.019.2.0 Raised in response to the QueueStatus action. @@ -1172,6 +1173,7 @@ + 16.24.018.10.019.2.0 Raised in response to the QueueStatus action. @@ -1213,6 +1215,7 @@ + 12.0.0 Raised when a Queue member's status has changed. @@ -1293,6 +1296,7 @@ + 12.0.0 Raised when a member is added to the queue. @@ -1305,6 +1309,7 @@ + 12.0.0 Raised when a member is removed from the queue. @@ -1317,6 +1322,7 @@ + 12.2.0 Raised when a member is paused/unpaused in the queue. @@ -1329,6 +1335,7 @@ + 12.0.0 Raised when a member's penalty is changed. @@ -1340,6 +1347,7 @@ + 12.0.0 Raised when a member's ringinuse setting is changed. @@ -1351,6 +1359,7 @@ + 12.0.0 Raised when a caller joins a Queue. @@ -1370,6 +1379,7 @@ + 12.0.0 Raised when a caller leaves a Queue. @@ -1384,6 +1394,7 @@ + 12.0.0 Raised when a caller abandons the queue. @@ -1400,6 +1411,7 @@ + 12.0.0 Raised when an queue member is notified of a caller in the queue. @@ -1417,6 +1429,7 @@ + 12.0.0 Raised when a queue member is notified of a caller in the queue and fails to answer. @@ -1435,6 +1448,7 @@ + 12.0.0 Raised when a queue member has finished servicing a caller in the queue. @@ -1462,6 +1476,7 @@ + 12.0.0 Raised when a queue member hangs up on a caller in the queue. @@ -1478,6 +1493,7 @@ + 12.0.0 Raised when a queue member answers and is bridged to a caller in the queue. diff --git a/apps/app_stack.c b/apps/app_stack.c index 06cd3be051..c20b80f576 100644 --- a/apps/app_stack.c +++ b/apps/app_stack.c @@ -205,6 +205,7 @@ + 12.0.0 Raised when a variable local to the gosub stack frame is set due to a subroutine call. diff --git a/apps/app_voicemail.c b/apps/app_voicemail.c index 59ca10c9b1..e0a3ed837d 100644 --- a/apps/app_voicemail.c +++ b/apps/app_voicemail.c @@ -573,6 +573,7 @@ + 18.21.020.6.021.1.0 Raised in response to a mailbox password change. diff --git a/apps/confbridge/confbridge_manager.c b/apps/confbridge/confbridge_manager.c index 45a1beffc2..6e332b76e5 100644 --- a/apps/confbridge/confbridge_manager.c +++ b/apps/confbridge/confbridge_manager.c @@ -39,6 +39,7 @@ /*** DOCUMENTATION + 12.0.0 Raised when a conference starts. @@ -54,6 +55,7 @@ + 12.0.0 Raised when a conference ends. @@ -69,6 +71,7 @@ + 12.0.0 Raised when a channel joins a Confbridge conference. @@ -99,6 +102,7 @@ + 12.0.0 Raised when a channel leaves a Confbridge conference. @@ -122,6 +126,7 @@ + 12.0.0 Raised when a conference starts recording. @@ -137,6 +142,7 @@ + 12.0.0 Raised when a conference that was recording stops recording. @@ -152,6 +158,7 @@ + 12.0.0 Raised when a Confbridge participant mutes. @@ -175,6 +182,7 @@ + 12.0.0 Raised when a confbridge participant unmutes. @@ -198,6 +206,7 @@ + 12.0.0 Raised when a confbridge participant begins or ends talking. diff --git a/build_tools/get_documentation b/build_tools/get_documentation index 3c0e4980a7..a91309586f 100644 --- a/build_tools/get_documentation +++ b/build_tools/get_documentation @@ -1,3 +1,3 @@ /\/\*\*\* DOCUMENTATION/ {printit=1; next} -/\*\*\*\// {if (printit) exit} +/\*\*\*\// {if (printit) printit=0} {if (printit) print} diff --git a/cdr/cdr_manager.c b/cdr/cdr_manager.c index 74f37d207f..2475fd676d 100644 --- a/cdr/cdr_manager.c +++ b/cdr/cdr_manager.c @@ -41,6 +41,7 @@ /*** DOCUMENTATION + 13.2.0 Raised when a CDR is generated. diff --git a/cel/cel_manager.c b/cel/cel_manager.c index 12671bc4a3..057cb74a37 100644 --- a/cel/cel_manager.c +++ b/cel/cel_manager.c @@ -36,6 +36,7 @@ /*** DOCUMENTATION + 13.2.0 Raised when a Channel Event Log is generated for a channel. diff --git a/channels/chan_dahdi.c b/channels/chan_dahdi.c index e2a0117e3a..7f9025d404 100644 --- a/channels/chan_dahdi.c +++ b/channels/chan_dahdi.c @@ -556,6 +556,7 @@ + 12.0.0 Raised when an alarm is cleared on a DAHDI channel. @@ -567,6 +568,7 @@ + 12.0.0 Raised when an alarm is cleared on a DAHDI span. @@ -577,6 +579,7 @@ + 12.0.0 Raised when the Do Not Disturb state is changed on a DAHDI channel. @@ -594,6 +597,7 @@ + 12.0.0 Raised when an alarm is set on a DAHDI channel. @@ -608,6 +612,7 @@ + 12.0.0 Raised when an alarm is set on a DAHDI span. @@ -621,6 +626,7 @@ + 12.0.0 Raised when a DAHDI channel is created or an underlying technology is associated with a DAHDI channel. diff --git a/channels/sig_pri.c b/channels/sig_pri.c index 55bbe4793e..406b946e98 100644 --- a/channels/sig_pri.c +++ b/channels/sig_pri.c @@ -29,6 +29,7 @@ /*** DOCUMENTATION + 12.0.0 Published when a malicious call ID request arrives. diff --git a/funcs/func_global.c b/funcs/func_global.c index 74f58663b4..17043f4a57 100644 --- a/funcs/func_global.c +++ b/funcs/func_global.c @@ -117,6 +117,7 @@ + 12.0.0 Raised when a variable is shared between channels. diff --git a/main/aoc.c b/main/aoc.c index 33f1de96a9..cdbbcf99d3 100644 --- a/main/aoc.c +++ b/main/aoc.c @@ -41,6 +41,7 @@ /*** DOCUMENTATION + 12.0.0 Raised when an Advice of Charge message is sent at the beginning of a call. @@ -92,6 +93,7 @@ + 12.0.0 Raised when an Advice of Charge message is sent during a call. @@ -150,6 +152,7 @@ + 12.0.0 Raised when an Advice of Charge message is sent at the end of a call. diff --git a/main/asterisk.c b/main/asterisk.c index faf7566499..78466b4d7c 100644 --- a/main/asterisk.c +++ b/main/asterisk.c @@ -249,6 +249,7 @@ int daemon(int, int); /* defined in libresolv of all places */ /*** DOCUMENTATION + 12.0.0 Raised when all Asterisk initialization procedures have finished. @@ -265,6 +266,7 @@ int daemon(int, int); /* defined in libresolv of all places */ + 12.0.0 Raised when Asterisk is shutdown or restarted. diff --git a/main/channel.c b/main/channel.c index 95d02e4ae3..1dfd55c7fe 100644 --- a/main/channel.c +++ b/main/channel.c @@ -6763,6 +6763,7 @@ static void __ast_change_name_nolink(struct ast_channel *chan, const char *newna /*** DOCUMENTATION + 16.24.018.10.019.2.0 Raised when the name of a channel is changed. diff --git a/main/core_local.c b/main/core_local.c index c1dee23186..f44dce5c5e 100644 --- a/main/core_local.c +++ b/main/core_local.c @@ -73,6 +73,7 @@ + 12.0.0 Raised when two halves of a Local Channel form a bridge. @@ -94,6 +95,7 @@ + 12.0.0 Raised when two halves of a Local Channel begin to optimize themselves out of the media path. @@ -115,6 +117,7 @@ + 12.0.0 Raised when two halves of a Local Channel have finished optimizing themselves out of the media path. diff --git a/main/devicestate.c b/main/devicestate.c index a47d1df1c5..0733a73384 100644 --- a/main/devicestate.c +++ b/main/devicestate.c @@ -120,6 +120,7 @@ /*** DOCUMENTATION + 13.0.0 Raised when a device state changes diff --git a/main/loader.c b/main/loader.c index 4f5c0bdb38..92101beb56 100644 --- a/main/loader.c +++ b/main/loader.c @@ -58,6 +58,7 @@ /*** DOCUMENTATION + 12.0.0 Raised when a module has been reloaded in Asterisk. @@ -82,6 +83,7 @@ + 16.0.0 Raised when a module has been loaded in Asterisk. @@ -100,6 +102,7 @@ + 16.0.0 Raised when a module has been unloaded in Asterisk. diff --git a/main/lock.c b/main/lock.c index e5be2516db..8ec75bc421 100644 --- a/main/lock.c +++ b/main/lock.c @@ -322,6 +322,7 @@ int __ast_pthread_mutex_lock(const char *filename, int lineno, const char *func, /*** DOCUMENTATION + 16.29.018.15.019.7.0 Raised when a probable deadlock has started. Delivery of this event is attempted but not guaranteed, and could fail for example if the manager itself is deadlocked. diff --git a/main/logger.c b/main/logger.c index 7d0b3b7718..bdc2350043 100644 --- a/main/logger.c +++ b/main/logger.c @@ -71,9 +71,6 @@ #include "asterisk/backtrace.h" #include "asterisk/json.h" -/*** DOCUMENTATION - ***/ - static int logger_register_level(const char *name); static int logger_unregister_level(const char *name); static int logger_get_dynamic_level(const char *name); @@ -1239,18 +1236,6 @@ static int reload_logger(int rotate, const char *altconf) AST_RWLIST_TRAVERSE(&logchannels, f, list) { if (f->disabled) { f->disabled = 0; /* Re-enable logging at reload */ - /*** DOCUMENTATION - - - Raised when a logging channel is re-enabled after a reload operation. - - - The name of the logging channel. - - - - - ***/ manager_event(EVENT_FLAG_SYSTEM, "LogChannel", "Channel: %s\r\nEnabled: Yes\r\n", f->filename); } if (f->fileptr && (f->fileptr != stdout) && (f->fileptr != stderr)) { @@ -1983,16 +1968,6 @@ static void logger_print_normal(struct logmsg *logmsg) fprintf(stderr, "Logger Warning: Unable to write to log file '%s': %s (disabled)\n", chan->filename, strerror(errno)); } - /*** DOCUMENTATION - - Raised when a logging channel is disabled. - - - The name of the logging channel. - - - - ***/ manager_event(EVENT_FLAG_SYSTEM, "LogChannel", "Channel: %s\r\nEnabled: No\r\nReason: %d - %s\r\n", chan->filename, errno, strerror(errno)); chan->disabled = 1; } diff --git a/main/logger_doc.xml b/main/logger_doc.xml index fa4ddff4ba..250a1d7016 100644 --- a/main/logger_doc.xml +++ b/main/logger_doc.xml @@ -34,4 +34,24 @@ Log + + + 16.24.018.10.019.2.0 + Raised when a logging channel is re-enabled after a reload operation. + + + The name of the logging channel. + + + + + 16.24.018.10.019.2.0 + Raised when a logging channel is disabled. + + + The name of the logging channel. + + + + diff --git a/main/manager_bridges.c b/main/manager_bridges.c index a9a96d01be..b6e6290eac 100644 --- a/main/manager_bridges.c +++ b/main/manager_bridges.c @@ -36,6 +36,7 @@ static struct stasis_message_router *bridge_state_router; /*** DOCUMENTATION + 12.0.0 Raised when a bridge is created. @@ -49,6 +50,7 @@ static struct stasis_message_router *bridge_state_router; + 12.0.0 Raised when a bridge is destroyed. @@ -62,6 +64,7 @@ static struct stasis_message_router *bridge_state_router; + 12.0.0 Raised when a channel enters a bridge. @@ -79,6 +82,7 @@ static struct stasis_message_router *bridge_state_router; + 12.0.0 Raised when a channel leaves a bridge. @@ -93,6 +97,7 @@ static struct stasis_message_router *bridge_state_router; + 13.13.014.2.0 Raised when the channel that is the source of video in a bridge changes. @@ -155,6 +160,7 @@ static struct stasis_message_router *bridge_state_router; + 13.0.0 Information about a channel in a bridge. @@ -164,6 +170,7 @@ static struct stasis_message_router *bridge_state_router; + 13.0.0 Information about a bridge. @@ -390,6 +397,7 @@ static void bridge_merge_cb(void *data, struct stasis_subscription *sub, /*** DOCUMENTATION + 16.24.018.10.019.2.0 Raised when two bridges are merged. diff --git a/main/manager_channels.c b/main/manager_channels.c index 76fd3157bb..c608d8d33c 100644 --- a/main/manager_channels.c +++ b/main/manager_channels.c @@ -38,6 +38,7 @@ /*** DOCUMENTATION + 12.0.0 Raised when a new channel is created. @@ -50,6 +51,7 @@ + 12.0.0 Raised when a channel's state changes. @@ -62,6 +64,7 @@ + 12.0.0 Raised when a channel is hung up. @@ -82,6 +85,7 @@ + 12.0.0 Raised when a hangup is requested. @@ -95,6 +99,7 @@ + 12.0.0 Raised when a soft hangup is requested with a specific cause code. @@ -108,6 +113,7 @@ + 12.0.0 Raised when a channel enters a new context, extension, priority. @@ -127,6 +133,7 @@ + 12.0.0 Raised when a channel receives new Caller ID information. @@ -141,6 +148,7 @@ + 13.13.014.2.0 Raised when a channel's connected line information is changed. @@ -152,6 +160,7 @@ + 12.0.0 Raised when a Channel's AccountCode is changed. @@ -166,6 +175,7 @@ + 12.0.0 Raised when a dial action has started. @@ -184,6 +194,7 @@ + 14.0.0 Raised when dial status has changed. @@ -211,6 +222,7 @@ + 12.0.0 Raised when a dial action has completed. @@ -267,6 +279,7 @@ + 12.0.0 Raised when a channel goes on hold. @@ -281,6 +294,7 @@ + 12.0.0 Raised when a channel goes off hold. @@ -292,6 +306,7 @@ + 12.0.0 Raised when one channel begins spying on another channel. @@ -305,6 +320,7 @@ + 12.0.0 Raised when a channel has stopped spying. @@ -318,6 +334,7 @@ + 12.0.0 Raised when a hangup handler is about to be called. @@ -332,6 +349,7 @@ + 12.0.0 Raised when a hangup handler is removed from the handler stack by the CHANNEL() function. @@ -348,6 +366,7 @@ + 12.0.0 Raised when a hangup handler is added to the handler stack by the CHANNEL() function. @@ -364,6 +383,7 @@ + 12.0.0 Raised periodically during a fax transmission. @@ -386,6 +406,7 @@ + 12.0.0 Raised when a receive fax operation has completed. @@ -414,6 +435,7 @@ + 12.0.0 Raised when a send fax operation has completed. @@ -425,6 +447,7 @@ + 12.0.0 Raised when music on hold has started on a channel. @@ -441,6 +464,7 @@ + 12.0.0 Raised when music on hold has stopped on a channel. @@ -871,6 +895,7 @@ static void channel_dtmf_begin_cb(void *data, struct stasis_subscription *sub, /*** DOCUMENTATION + 16.24.018.10.019.2.0 Raised when a DTMF digit has started on a channel. @@ -919,6 +944,7 @@ static void channel_dtmf_end_cb(void *data, struct stasis_subscription *sub, /*** DOCUMENTATION + 16.24.018.10.019.2.0 Raised when a DTMF digit has ended on a channel. @@ -964,6 +990,7 @@ static void channel_flash_cb(void *data, struct stasis_subscription *sub, /*** DOCUMENTATION + 16.24.018.10.019.2.0 Raised when a hook flash occurs on a channel. @@ -992,6 +1019,7 @@ static void channel_wink_cb(void *data, struct stasis_subscription *sub, /*** DOCUMENTATION + 16.24.018.10.019.2.0 Raised when a wink occurs on a channel. diff --git a/main/manager_doc.xml b/main/manager_doc.xml index 895dd9b998..5b3e800038 100644 --- a/main/manager_doc.xml +++ b/main/manager_doc.xml @@ -192,6 +192,7 @@ + 18.26.020.11.021.6.022.1.0 Raised in response to a Status command. @@ -250,6 +251,7 @@ + 18.26.020.11.021.6.022.1.0 Raised in response to a Status command. @@ -702,6 +704,7 @@ + 18.26.020.11.021.6.022.1.0 Raised in response to an Originate command. @@ -1001,6 +1004,7 @@ + 18.26.020.11.021.6.022.1.0 Raised in response to a CoreShowChannels command. @@ -1026,6 +1030,7 @@ + 18.26.020.11.021.6.022.1.0 Raised at the end of the CoreShowChannel list produced by the CoreShowChannels command. @@ -1064,6 +1069,7 @@ + 18.26.020.11.021.6.022.1.0 Raised at the end of the CoreShowChannelMap list produced by the CoreShowChannelMap command. @@ -1576,6 +1582,7 @@ + 18.26.020.11.021.6.022.1.0 Raised when a hint changes due to a device state change. @@ -1656,6 +1663,7 @@ + 18.26.020.11.021.6.022.1.0 Raised when a hint changes due to a presence state change. diff --git a/main/manager_mwi.c b/main/manager_mwi.c index f39ac19b18..b4578f2592 100644 --- a/main/manager_mwi.c +++ b/main/manager_mwi.c @@ -105,6 +105,7 @@ static void mwi_update_cb(void *data, struct stasis_subscription *sub, /*** DOCUMENTATION + 16.24.018.10.019.2.0 Raised when the state of messages in a voicemail mailbox has changed or when a channel has finished interacting with a mailbox. diff --git a/main/pbx.c b/main/pbx.c index 0db36a6e9f..d6298109c3 100644 --- a/main/pbx.c +++ b/main/pbx.c @@ -199,6 +199,7 @@ + 13.0.0 Indicates the end of the list the current known extension states. diff --git a/main/pickup.c b/main/pickup.c index 02dbc8079d..683eb71953 100644 --- a/main/pickup.c +++ b/main/pickup.c @@ -36,6 +36,7 @@ /*** DOCUMENTATION + 12.0.0 Raised when a call pickup occurs. diff --git a/main/presencestate.c b/main/presencestate.c index 45433b1891..43b6bb4711 100644 --- a/main/presencestate.c +++ b/main/presencestate.c @@ -28,6 +28,7 @@ /*** DOCUMENTATION + 13.0.0 Raised when a presence state changes diff --git a/main/rtp_engine.c b/main/rtp_engine.c index 6b2d67bd31..16d8badae6 100644 --- a/main/rtp_engine.c +++ b/main/rtp_engine.c @@ -30,6 +30,7 @@ /*** DOCUMENTATION + 12.0.0 Raised when an RTCP packet is sent. @@ -109,6 +110,7 @@ + 12.0.0 Raised when an RTCP packet is received. diff --git a/main/security_events.c b/main/security_events.c index 0328eca359..649e62f2da 100644 --- a/main/security_events.c +++ b/main/security_events.c @@ -31,6 +31,7 @@ /*** DOCUMENTATION + 12.1.0 Raised when a request violates an ACL check. @@ -79,6 +80,7 @@ + 12.1.0 Raised when a request fails an authentication check due to an invalid account ID. @@ -96,6 +98,7 @@ + 12.1.0 Raised when a request fails due to exceeding the number of allowed concurrent sessions for that service. @@ -113,6 +116,7 @@ + 12.1.0 Raised when a request fails due to an internal memory allocation failure. @@ -130,6 +134,7 @@ + 12.1.0 Raised when a request fails because a configured load average limit has been reached. @@ -147,6 +152,7 @@ + 12.1.0 Raised when a request fails due to some aspect of the requested item not being supported by the service. @@ -167,6 +173,7 @@ + 12.1.0 Raised when a request is not allowed by the service. @@ -188,6 +195,7 @@ + 12.1.0 Raised when a request used an authentication method not allowed by the service. @@ -208,6 +216,7 @@ + 12.1.0 Raised when a request is received with bad formatting. @@ -230,6 +239,7 @@ + 12.1.0 Raised when a request successfully authenticates with a service. @@ -250,6 +260,7 @@ + 12.1.0 Raised when a request has a different source address then what is expected for a session already in progress with a service. @@ -270,6 +281,7 @@ + 12.1.0 Raised when a request's attempt to authenticate has been challenged, and the request failed the authentication challenge. @@ -296,6 +308,7 @@ + 12.1.0 Raised when a request provides an invalid password during an authentication attempt. @@ -322,6 +335,7 @@ + 12.1.0 Raised when an Asterisk service sends an authentication challenge to a request. @@ -340,6 +354,7 @@ + 12.1.0 Raised when a request attempts to use a transport not allowed by the Asterisk service. diff --git a/main/stasis.c b/main/stasis.c index 2e68cdf17b..3427e37d5d 100644 --- a/main/stasis.c +++ b/main/stasis.c @@ -46,6 +46,7 @@ /*** DOCUMENTATION + 12.3.0 A user defined event raised from the dialplan. diff --git a/main/stasis_bridges.c b/main/stasis_bridges.c index 4a4735a2b3..d7098104b1 100644 --- a/main/stasis_bridges.c +++ b/main/stasis_bridges.c @@ -46,6 +46,7 @@ /*** DOCUMENTATION + 12.0.0 Raised when a blind transfer is complete. @@ -84,6 +85,7 @@ + 12.0.0 Raised when an attended transfer is complete. diff --git a/main/stasis_channels.c b/main/stasis_channels.c index b311df0ff7..b0a40f803e 100644 --- a/main/stasis_channels.c +++ b/main/stasis_channels.c @@ -44,6 +44,7 @@ /*** DOCUMENTATION + 12.0.0 Raised when a variable is set to a particular value. @@ -58,6 +59,7 @@ + 12.0.0 Raised when an Agent has logged in. @@ -73,6 +75,7 @@ + 12.0.0 Raised when an Agent has logged off. @@ -87,6 +90,7 @@ + 12.4.0 Raised when talking is detected on a channel. @@ -99,6 +103,7 @@ + 12.4.0 Raised when talking is no longer detected on a channel. diff --git a/main/stasis_endpoints.c b/main/stasis_endpoints.c index 69399e652a..6421bbf6cf 100644 --- a/main/stasis_endpoints.c +++ b/main/stasis_endpoints.c @@ -36,6 +36,7 @@ /*** DOCUMENTATION + 12.0.0 Raised when the state of a peer changes. @@ -71,6 +72,7 @@ + 13.5.0 Raised when the state of a contact changes. diff --git a/main/stasis_system.c b/main/stasis_system.c index 4c84f57e6c..298a4f1200 100644 --- a/main/stasis_system.c +++ b/main/stasis_system.c @@ -36,6 +36,7 @@ /*** DOCUMENTATION + 12.0.0 Raised when an outbound registration completes. diff --git a/res/parking/parking_manager.c b/res/parking/parking_manager.c index 4ebe007509..cdd37d21a9 100644 --- a/res/parking/parking_manager.c +++ b/res/parking/parking_manager.c @@ -116,6 +116,7 @@ + 12.0.0 Raised when a channel is parked. @@ -139,6 +140,7 @@ + 12.0.0 Raised when a channel leaves a parking lot due to reaching the time limit of being parked. @@ -149,6 +151,7 @@ + 12.0.0 Raised when a channel leaves a parking lot because it hung up without being answered. @@ -159,6 +162,7 @@ + 12.0.0 Raised when a channel leaves a parking lot because it was retrieved from the parking lot and reconnected. @@ -170,6 +174,7 @@ + 13.5.0 Raised when a channel takes the place of a previously parked channel diff --git a/res/res_agi.c b/res/res_agi.c index f008139611..e742b7a283 100644 --- a/res/res_agi.c +++ b/res/res_agi.c @@ -1295,6 +1295,7 @@ + 12.0.0 Raised when a channel starts AsyncAGI command processing. @@ -1312,6 +1313,7 @@ + 12.0.0 Raised when a channel stops AsyncAGI command processing. @@ -1326,6 +1328,7 @@ + 12.0.0 Raised when AsyncAGI completes an AGI command. @@ -1346,6 +1349,7 @@ + 12.0.0 Raised when a received AGI command starts processing. @@ -1364,6 +1368,7 @@ + 12.0.0 Raised when a received AGI command completes processing. diff --git a/res/res_fax.c b/res/res_fax.c index 6e08e9afc3..1aab57f1a0 100644 --- a/res/res_fax.c +++ b/res/res_fax.c @@ -258,6 +258,7 @@ + 13.0.0 A single list item for the FAXSessions AMI command @@ -308,6 +309,7 @@ + 13.0.0 Raised when all FAXSession events are completed for a FAXSessions command @@ -339,6 +341,7 @@ + 13.0.0 Raised in response to FAXSession manager command @@ -407,6 +410,7 @@ + 13.0.0 Raised in response to FAXStats manager command diff --git a/res/res_manager_devicestate.c b/res/res_manager_devicestate.c index fb65433dbd..c71c5bac2f 100644 --- a/res/res_manager_devicestate.c +++ b/res/res_manager_devicestate.c @@ -47,6 +47,7 @@ + 13.0.0 Indicates the end of the list the current known extension states. diff --git a/res/res_manager_presencestate.c b/res/res_manager_presencestate.c index 6c4a3bc7c7..fdc3ce80f7 100644 --- a/res/res_manager_presencestate.c +++ b/res/res_manager_presencestate.c @@ -48,6 +48,7 @@ + 13.0.0 Indicates the end of the list the current known extension states. diff --git a/res/res_mwi_external_ami.c b/res/res_mwi_external_ami.c index aea8ebdc54..d1b69be25a 100644 --- a/res/res_mwi_external_ami.c +++ b/res/res_mwi_external_ami.c @@ -54,6 +54,7 @@ + 12.1.0 Raised in response to a MWIGet command. @@ -76,6 +77,7 @@ + 12.1.0 Raised in response to a MWIGet command. diff --git a/res/res_pjsip/pjsip_manager.xml b/res/res_pjsip/pjsip_manager.xml index 90940c5271..97df1e03be 100644 --- a/res/res_pjsip/pjsip_manager.xml +++ b/res/res_pjsip/pjsip_manager.xml @@ -21,6 +21,7 @@ + 13.20.015.3.0 Provide details about an identify section. @@ -49,6 +50,7 @@ + 13.12.014.1.0 Provide details about an Address of Record (AoR) section. @@ -104,6 +106,7 @@ + 12.0.0 Provide details about an authentication section. @@ -138,6 +141,7 @@ + 12.6.0 Provide details about an authentication section. @@ -217,6 +221,7 @@ + 12.0.0 Provide details about an endpoint section. @@ -518,6 +523,7 @@ + 16.0.0 Provide details about an Address of Record (AoR) section. @@ -564,6 +570,7 @@ + 16.0.0 Provide details about an Address of Record (Auth) section. @@ -595,6 +602,7 @@ + 16.0.0 Provide details about a contact section. @@ -666,6 +674,7 @@ + 13.0.0 Provide details about a contact's status. @@ -727,6 +736,7 @@ + 12.0.0 Provide details about a contact's status. @@ -777,6 +787,7 @@ + 12.0.0 Provide final information about an endpoint list. @@ -821,6 +832,7 @@ + 12.0.0 Provide final information about endpoint details. @@ -851,6 +863,7 @@ + 16.0.0 Provide final information about an aor list. @@ -880,6 +893,7 @@ + 16.0.0 Provide final information about an auth list. @@ -910,6 +924,7 @@ + 16.0.0 Provide final information about a contact list.