summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJonathan Rose <jrose@digium.com>2014-10-24 15:17:59 +0000
committerJonathan Rose <jrose@digium.com>2014-10-24 15:17:59 +0000
commite979d0d5c11634616205caad75398049d51bebd9 (patch)
tree74e587132cee3996ea768b4103a30165d99072b6
parent14db1236adf91e82753b4feed584a3cf23b42728 (diff)
Documentation: Improve documentation for ExtensionStatus AMI events
Review: https://reviewboard.asterisk.org/r/4085/ git-svn-id: https://origsvn.digium.com/svn/asterisk/branches/13@426120 65c4cc65-6c06-0410-ace0-fbb531ad65f3
-rw-r--r--main/manager.c75
1 files changed, 70 insertions, 5 deletions
diff --git a/main/manager.c b/main/manager.c
index 3e0f0f8e1..0defe304e 100644
--- a/main/manager.c
+++ b/main/manager.c
@@ -1191,11 +1191,76 @@ ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
<managerEventInstance class="EVENT_FLAG_CALL">
<synopsis>Raised when a hint changes due to a device state change.</synopsis>
<syntax>
- <parameter name="Exten" />
- <parameter name="Context" />
- <parameter name="Hint" />
- <parameter name="Status" />
- <parameter name="StatusText" />
+ <parameter name="Exten">
+ <para>Name of the extension.</para>
+ </parameter>
+ <parameter name="Context">
+ <para>Context that owns the extension.</para>
+ </parameter>
+ <parameter name="Hint">
+ <para>Hint set for the extension</para>
+ </parameter>
+ <parameter name="Status">
+ <para>Numerical value of the extension status. Extension
+ status is determined by the combined device state of all items
+ contained in the hint.</para>
+ <enumlist>
+ <enum name="-2">
+ <para>The extension was removed from the dialplan.</para>
+ </enum>
+ <enum name="-1">
+ <para>The extension's hint was removed from the dialplan.</para>
+ </enum>
+ <enum name="0">
+ <para><literal>Idle</literal> - Related device(s) are in an idle
+ state.</para>
+ </enum>
+ <enum name="1">
+ <para><literal>InUse</literal> - Related device(s) are in active
+ calls but may take more calls.</para>
+ </enum>
+ <enum name="2">
+ <para><literal>Busy</literal> - Related device(s) are in active
+ calls and may not take any more calls.</para>
+ </enum>
+ <enum name="4">
+ <para><literal>Unavailable</literal> - Related device(s) are
+ not reachable.</para>
+ </enum>
+ <enum name="8">
+ <para><literal>Ringing</literal> - Related device(s) are
+ currently ringing.</para>
+ </enum>
+ <enum name="9">
+ <para><literal>InUse&amp;Ringing</literal> - Related device(s)
+ are currently ringing and in active calls.</para>
+ </enum>
+ <enum name="16">
+ <para><literal>Hold</literal> - Related device(s) are
+ currently on hold.</para>
+ </enum>
+ <enum name="17">
+ <para><literal>InUse&amp;Hold</literal> - Related device(s)
+ are currently on hold and in active calls.</para>
+ </enum>
+ </enumlist>
+ </parameter>
+ <parameter name="StatusText">
+ <para>Text representation of <literal>Status</literal>.</para>
+ <enumlist>
+ <enum name="Idle" />
+ <enum name="InUse" />
+ <enum name="Busy" />
+ <enum name="Unavailable" />
+ <enum name="Ringing" />
+ <enum name="InUse&amp;Ringing" />
+ <enum name="Hold" />
+ <enum name="InUse&amp;Hold" />
+ <enum name="Unknown">
+ <para>Status does not match any of the above values.</para>
+ </enum>
+ </enumlist>
+ </parameter>
</syntax>
</managerEventInstance>
</managerEvent>