res_pjsip: update qualify_timeout documentation with DNS note

The documentation on qualify_timeout does not explicitly state that the timeout
includes any time required to perform any needed DNS queries on the endpoint.

If the OPTIONS response is delayed due to the DNS query, it can still render an
endpoint as Unreachable if the net time is enough for qualify_timeout to expire.

Resolves: #352
(cherry picked from commit 7369de127abb3481c1139c374b651a97584f7ff9)

diff --git a/res/res_pjsip/pjsip_config.xml b/res/res_pjsip/pjsip_config.xml
index 5adf4f3a1b2025c66c34f7b1003173fa3be79015..6eaa399c32c7740489887d9d7d502fc38999633c 100644 (file)
--- a/res/res_pjsip/pjsip_config.xml
+++ b/res/res_pjsip/pjsip_config.xml
@@ -1840,7 +1840,8 @@
                                        <synopsis>Timeout for qualify</synopsis>
                                        <description><para>
                                                If the contact doesn't respond to the OPTIONS request before the timeout,
-                                               the contact is marked unavailable.
+                                               the contact is marked unavailable. This includes time spent performing
+                                               any required DNS lookup(s) prior to sending the OPTIONS.
                                                If <literal>0</literal> no timeout. Time in fractional seconds.
                                        </para></description>
                                </configOption>
@@ -2065,7 +2066,8 @@
                                        <synopsis>Timeout for qualify</synopsis>
                                        <description><para>
                                                If the contact doesn't respond to the OPTIONS request before the timeout,
-                                               the contact is marked unavailable.
+                                               the contact is marked unavailable. This includes time spent performing
+                                               any required DNS lookup(s) prior to sending the OPTIONS.
                                                If <literal>0</literal> no timeout. Time in fractional seconds.
                                        </para></description>
                                </configOption>