summaryrefslogtreecommitdiff
path: root/main
diff options
context:
space:
mode:
authorJonathan Rose <jrose@digium.com>2014-10-24 15:32:35 +0000
committerJonathan Rose <jrose@digium.com>2014-10-24 15:32:35 +0000
commitc084728690277f417b951a671a55a80471e30534 (patch)
tree0ca1e34cc70bb9b103e0ee5da1f59a3118cb18e6 /main
parentc4d7e7e270a05e37fab43091d124406d3b50038a (diff)
Documentation: Improve documentation for ExtensionStatus AMI events
Review: https://reviewboard.asterisk.org/r/4085/ ........ Merged revisions 426120 from http://svn.asterisk.org/svn/asterisk/branches/13 git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@426121 65c4cc65-6c06-0410-ace0-fbb531ad65f3
Diffstat (limited to 'main')
-rw-r--r--main/manager.c75
1 files changed, 70 insertions, 5 deletions
diff --git a/main/manager.c b/main/manager.c
index f18099192..e23b78167 100644
--- a/main/manager.c
+++ b/main/manager.c
@@ -1199,11 +1199,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>