<p>Friendly Automation <strong>submitted</strong> this change.</p><p><a href="https://gerrit.asterisk.org/c/asterisk/+/18220">View Change</a></p><div style="white-space:pre-wrap">Approvals:
Joshua Colp: Looks good to me, but someone else must approve
Benjamin Keith Ford: Looks good to me, approved
Friendly Automation: Approved for Submit
</div><pre style="font-family: monospace,monospace; white-space: pre-wrap;">app_dial: Document DIALSTATUS return values.<br><br>Adds documentation for all of the possible return values<br>for the DIALSTATUS variable in the Dial application.<br><br>ASTERISK-25716<br><br>Change-Id: Id22593f1f1f7ea86e5734cee49516ec50848e8c0<br>---<br>M apps/app_dial.c<br>1 file changed, 29 insertions(+), 8 deletions(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/apps/app_dial.c b/apps/app_dial.c</span><br><span>index 33a6931..8be6eff 100644</span><br><span>--- a/apps/app_dial.c</span><br><span>+++ b/apps/app_dial.c</span><br><span>@@ -613,12 +613,31 @@</span><br><span> </variable></span><br><span> <variable name="DIALSTATUS"></span><br><span> <para>This is the status of the call</para></span><br><span style="color: hsl(0, 100%, 40%);">- <value name="CHANUNAVAIL" /></span><br><span style="color: hsl(0, 100%, 40%);">- <value name="CONGESTION" /></span><br><span style="color: hsl(0, 100%, 40%);">- <value name="NOANSWER" /></span><br><span style="color: hsl(0, 100%, 40%);">- <value name="BUSY" /></span><br><span style="color: hsl(0, 100%, 40%);">- <value name="ANSWER" /></span><br><span style="color: hsl(0, 100%, 40%);">- <value name="CANCEL" /></span><br><span style="color: hsl(120, 100%, 40%);">+ <value name="CHANUNAVAIL"></span><br><span style="color: hsl(120, 100%, 40%);">+ Either the dialed peer exists but is not currently reachable, e.g.</span><br><span style="color: hsl(120, 100%, 40%);">+ endpoint is not registered, or an attempt was made to call a</span><br><span style="color: hsl(120, 100%, 40%);">+ nonexistent location, e.g. nonexistent DNS hostname.</span><br><span style="color: hsl(120, 100%, 40%);">+ </value></span><br><span style="color: hsl(120, 100%, 40%);">+ <value name="CONGESTION"></span><br><span style="color: hsl(120, 100%, 40%);">+ Channel or switching congestion occured when routing the call.</span><br><span style="color: hsl(120, 100%, 40%);">+ This can occur if there is a slow or no response from the remote end.</span><br><span style="color: hsl(120, 100%, 40%);">+ </value></span><br><span style="color: hsl(120, 100%, 40%);">+ <value name="NOANSWER"></span><br><span style="color: hsl(120, 100%, 40%);">+ Called party did not answer.</span><br><span style="color: hsl(120, 100%, 40%);">+ </value></span><br><span style="color: hsl(120, 100%, 40%);">+ <value name="BUSY"></span><br><span style="color: hsl(120, 100%, 40%);">+ The called party was busy or indicated a busy status.</span><br><span style="color: hsl(120, 100%, 40%);">+ Note that some SIP devices will respond with 486 Busy if their Do Not Disturb</span><br><span style="color: hsl(120, 100%, 40%);">+ modes are active. In this case, you can use DEVICE_STATUS to check if the</span><br><span style="color: hsl(120, 100%, 40%);">+ endpoint is actually in use, if needed.</span><br><span style="color: hsl(120, 100%, 40%);">+ </value></span><br><span style="color: hsl(120, 100%, 40%);">+ <value name="ANSWER"></span><br><span style="color: hsl(120, 100%, 40%);">+ The call was answered.</span><br><span style="color: hsl(120, 100%, 40%);">+ Any other result implicitly indicates the call was not answered.</span><br><span style="color: hsl(120, 100%, 40%);">+ </value></span><br><span style="color: hsl(120, 100%, 40%);">+ <value name="CANCEL"></span><br><span style="color: hsl(120, 100%, 40%);">+ Dial was cancelled before call was answered or reached some other terminating event.</span><br><span style="color: hsl(120, 100%, 40%);">+ </value></span><br><span> <value name="DONTCALL"></span><br><span> For the Privacy and Screening Modes.</span><br><span> Will be set if the called party chooses to send the calling party to the 'Go Away' script.</span><br><span>@@ -627,7 +646,9 @@</span><br><span> For the Privacy and Screening Modes.</span><br><span> Will be set if the called party chooses to send the calling party to the 'torture' script.</span><br><span> </value></span><br><span style="color: hsl(0, 100%, 40%);">- <value name="INVALIDARGS" /></span><br><span style="color: hsl(120, 100%, 40%);">+ <value name="INVALIDARGS"></span><br><span style="color: hsl(120, 100%, 40%);">+ Dial failed due to invalid syntax.</span><br><span style="color: hsl(120, 100%, 40%);">+ </value></span><br><span> </variable></span><br><span> </variablelist></span><br><span> </description></span><br><span>@@ -3602,4 +3623,4 @@</span><br><span> .load = load_module,</span><br><span> .unload = unload_module,</span><br><span> .requires = "ccss",</span><br><span style="color: hsl(0, 100%, 40%);">-);</span><br><span>\ No newline at end of file</span><br><span style="color: hsl(120, 100%, 40%);">+);</span><br><span></span><br></pre><div style="white-space:pre-wrap"></div><p>To view, visit <a href="https://gerrit.asterisk.org/c/asterisk/+/18220">change 18220</a>. To unsubscribe, or for help writing mail filters, visit <a href="https://gerrit.asterisk.org/settings">settings</a>.</p><div itemscope itemtype="http://schema.org/EmailMessage"><div itemscope itemprop="action" itemtype="http://schema.org/ViewAction"><link itemprop="url" href="https://gerrit.asterisk.org/c/asterisk/+/18220"/><meta itemprop="name" content="View Change"/></div></div>
<div style="display:none"> Gerrit-Project: asterisk </div>
<div style="display:none"> Gerrit-Branch: 18 </div>
<div style="display:none"> Gerrit-Change-Id: Id22593f1f1f7ea86e5734cee49516ec50848e8c0 </div>
<div style="display:none"> Gerrit-Change-Number: 18220 </div>
<div style="display:none"> Gerrit-PatchSet: 2 </div>
<div style="display:none"> Gerrit-Owner: N A <mail@interlinked.x10host.com> </div>
<div style="display:none"> Gerrit-Reviewer: Benjamin Keith Ford <bford@digium.com> </div>
<div style="display:none"> Gerrit-Reviewer: Friendly Automation </div>
<div style="display:none"> Gerrit-Reviewer: Joshua Colp <jcolp@sangoma.com> </div>
<div style="display:none"> Gerrit-MessageType: merged </div>