<p>Kevin Harwell <strong>submitted</strong> this change.</p><p><a href="https://gerrit.asterisk.org/c/asterisk/+/18219">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
  Kevin Harwell: 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 7d7a459..ee77551 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>@@ -3569,4 +3590,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/+/18219">change 18219</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/+/18219"/><meta itemprop="name" content="View Change"/></div></div>

<div style="display:none"> Gerrit-Project: asterisk </div>
<div style="display:none"> Gerrit-Branch: 16 </div>
<div style="display:none"> Gerrit-Change-Id: Id22593f1f1f7ea86e5734cee49516ec50848e8c0 </div>
<div style="display:none"> Gerrit-Change-Number: 18219 </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-Reviewer: Kevin Harwell <kharwell@digium.com> </div>
<div style="display:none"> Gerrit-MessageType: merged </div>