Dnsruby 0.5.0 → 0.6.0

data/doc/classes/Dnsruby/Resolver.html

@@ -86,16 +86,16 @@
  The retry policy is a combination of the Net::DNS and dnsjava approach, and has the option of :
 </pre>
 <ul>
-<li>A total timeout for the <a href="Resolver.html#M000211">query</a> (defaults
+<li>A total timeout for the <a href="Resolver.html#M000212">query</a> (defaults
 to 0, meaning &quot;no total timeout&quot;)
 
 </li>
 <li>A retransmission system that targets the namervers concurrently once the
-first <a href="Resolver.html#M000211">query</a> round is complete, but in
-which the total time per <a href="Resolver.html#M000211">query</a> round is
+first <a href="Resolver.html#M000212">query</a> round is complete, but in
+which the total time per <a href="Resolver.html#M000212">query</a> round is
 split between the number of nameservers targetted for the first round. and
-total time for <a href="Resolver.html#M000211">query</a> round is doubled
-for each <a href="Resolver.html#M000211">query</a> round
+total time for <a href="Resolver.html#M000212">query</a> round is doubled
+for each <a href="Resolver.html#M000212">query</a> round
 
 <p>
 Note that, if a total timeout is specified, then that will apply regardless
@@ -114,10 +114,10 @@ These methods raise an exception or return a response message with
 rcode==NOERROR
 </p>
 <ul>
-<li><a href="Resolver.html#M000212">Dnsruby::Resolver#send_message(msg)</a>
+<li><a href="Resolver.html#M000213">Dnsruby::Resolver#send_message(msg)</a>
 
 </li>
-<li><a href="Resolver.html#M000211">Dnsruby::Resolver#query</a>(name [, type [,
+<li><a href="Resolver.html#M000212">Dnsruby::Resolver#query</a>(name [, type [,
 klass]])
 
 </li>
@@ -127,11 +127,27 @@ klass]])
 These methods use a response queue to return the response and the error
 </p>
 <ul>
-<li><a href="Resolver.html#M000213">Dnsruby::Resolver#send_async</a>(msg,
-query_id, response_queue)
+<li><a href="Resolver.html#M000214">Dnsruby::Resolver#send_async</a>(msg,
+response_queue, query_id)
 
 </li>
 </ul>
+<h2>Event Loop</h2>
+<p>
+<a href="../Dnsruby.html">Dnsruby</a> runs a pure Ruby event loop to handle
+I/O in a single thread. It is also possible to configure <a
+href="../Dnsruby.html">Dnsruby</a> to use EventMachine instead. See the
+Dnsruby::Resolver::use_eventmachine method for details.
+</p>
+<p>
+Note that, if using <a href="../Dnsruby.html">Dnsruby</a> from an
+EventMachine loop, you will need to tell <a
+href="../Dnsruby.html">Dnsruby</a> not to start the event loop itself :
+</p>
+<pre>
+   Dnsruby::Resolver::use_eventmachine(true)
+   Dnsruby::Resolver::start_eventmachine_loop(false)
+</pre>
 
     </div>
 
@@ -142,26 +158,30 @@ query_id, response_queue)
       <h3 class="section-bar">Methods</h3>
 
       <div class="name-list">
-      <a href="#M000216">add_config_nameservers</a>&nbsp;&nbsp;
-      <a href="#M000218">add_resolver</a>&nbsp;&nbsp;
-      <a href="#M000214">close</a>&nbsp;&nbsp;
-      <a href="#M000224">ignore_truncation=</a>&nbsp;&nbsp;
-      <a href="#M000219">nameserver=</a>&nbsp;&nbsp;
-      <a href="#M000215">new</a>&nbsp;&nbsp;
-      <a href="#M000220">packet_timeout=</a>&nbsp;&nbsp;
-      <a href="#M000227">persistent_tcp=</a>&nbsp;&nbsp;
-      <a href="#M000228">persistent_udp=</a>&nbsp;&nbsp;
-      <a href="#M000221">port=</a>&nbsp;&nbsp;
-      <a href="#M000211">query</a>&nbsp;&nbsp;
-      <a href="#M000229">recurse=</a>&nbsp;&nbsp;
-      <a href="#M000213">send_async</a>&nbsp;&nbsp;
-      <a href="#M000212">send_message</a>&nbsp;&nbsp;
-      <a href="#M000217">set_config_nameserver</a>&nbsp;&nbsp;
-      <a href="#M000225">src_address=</a>&nbsp;&nbsp;
-      <a href="#M000226">src_port=</a>&nbsp;&nbsp;
-      <a href="#M000223">tsig_key=</a>&nbsp;&nbsp;
-      <a href="#M000230">udp_size=</a>&nbsp;&nbsp;
-      <a href="#M000222">use_tcp=</a>&nbsp;&nbsp;
+      <a href="#M000217">add_config_nameservers</a>&nbsp;&nbsp;
+      <a href="#M000219">add_resolver</a>&nbsp;&nbsp;
+      <a href="#M000215">close</a>&nbsp;&nbsp;
+      <a href="#M000233">eventmachine?</a>&nbsp;&nbsp;
+      <a href="#M000225">ignore_truncation=</a>&nbsp;&nbsp;
+      <a href="#M000220">nameserver=</a>&nbsp;&nbsp;
+      <a href="#M000216">new</a>&nbsp;&nbsp;
+      <a href="#M000221">packet_timeout=</a>&nbsp;&nbsp;
+      <a href="#M000228">persistent_tcp=</a>&nbsp;&nbsp;
+      <a href="#M000229">persistent_udp=</a>&nbsp;&nbsp;
+      <a href="#M000222">port=</a>&nbsp;&nbsp;
+      <a href="#M000212">query</a>&nbsp;&nbsp;
+      <a href="#M000230">recurse=</a>&nbsp;&nbsp;
+      <a href="#M000214">send_async</a>&nbsp;&nbsp;
+      <a href="#M000213">send_message</a>&nbsp;&nbsp;
+      <a href="#M000218">set_config_nameserver</a>&nbsp;&nbsp;
+      <a href="#M000226">src_address=</a>&nbsp;&nbsp;
+      <a href="#M000227">src_port=</a>&nbsp;&nbsp;
+      <a href="#M000234">start_eventmachine_loop</a>&nbsp;&nbsp;
+      <a href="#M000235">start_eventmachine_loop?</a>&nbsp;&nbsp;
+      <a href="#M000224">tsig_key=</a>&nbsp;&nbsp;
+      <a href="#M000231">udp_size=</a>&nbsp;&nbsp;
+      <a href="#M000232">use_eventmachine</a>&nbsp;&nbsp;
+      <a href="#M000223">use_tcp=</a>&nbsp;&nbsp;
       </div>
     </div>
 
@@ -274,7 +294,7 @@ The port to send queries to on the resolver
           <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
           <td class="context-item-desc">
 Note that this timeout represents the total time a <a
-href="Resolver.html#M000211">query</a> may run for - multiple packets can
+href="Resolver.html#M000212">query</a> may run for - multiple packets can
 be sent to multiple nameservers in this time. This is distinct from the <a
 href="SingleResolver.html">SingleResolver</a> per-packet timeout The
 query_timeout is not required - it will default to 0, which means &quot;do
@@ -295,11 +315,11 @@ Should the Recursion Desired bit be set?
           <td class="context-item-name">retry_delay</td>
           <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
           <td class="context-item-desc">
-The <a href="Resolver.html#M000211">query</a> will be tried across
+The <a href="Resolver.html#M000212">query</a> will be tried across
 nameservers retry_times times, with a delay of retry_delay seconds between
 each retry. The first time round, retry_delay will be divided by the number
 of nameservers being targetted, and a <a
-href="Resolver.html#M000215">new</a> nameserver will be queried with the
+href="Resolver.html#M000216">new</a> nameserver will be queried with the
 resultant delay.
 
 </td>
@@ -308,11 +328,11 @@ resultant delay.
           <td class="context-item-name">retry_times</td>
           <td class="context-item-value">&nbsp;[RW]&nbsp;</td>
           <td class="context-item-desc">
-The <a href="Resolver.html#M000211">query</a> will be tried across
+The <a href="Resolver.html#M000212">query</a> will be tried across
 nameservers retry_times times, with a delay of retry_delay seconds between
 each retry. The first time round, retry_delay will be divided by the number
 of nameservers being targetted, and a <a
-href="Resolver.html#M000215">new</a> nameserver will be queried with the
+href="Resolver.html#M000216">new</a> nameserver will be queried with the
 resultant delay.
 
 </td>
@@ -322,7 +342,7 @@ resultant delay.
           <td class="context-item-value">&nbsp;[R]&nbsp;</td>
           <td class="context-item-desc">
 The array of SingleResolvers used for sending <a
-href="Resolver.html#M000211">query</a> messages
+href="Resolver.html#M000212">query</a> messages
 
 </td>
         </tr>
@@ -373,19 +393,37 @@ Should TCP be used as a transport rather than UDP?
     <div id="methods">
       <h3 class="section-bar">Public Class methods</h3>
 
-      <div id="method-M000215" class="method-detail">
-        <a name="M000215"></a>
+      <div id="method-M000233" class="method-detail">
+        <a name="M000233"></a>
 
         <div class="method-heading">
-          <a href="Resolver.src/M000215.html" target="Code" class="method-signature"
-            onclick="popupCode('Resolver.src/M000215.html');return false;">
+          <a href="Resolver.src/M000233.html" target="Code" class="method-signature"
+            onclick="popupCode('Resolver.src/M000233.html');return false;">
+          <span class="method-name">eventmachine?</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Check whether EventMachine will be used by <a
+href="../Dnsruby.html">Dnsruby</a>
+</p>
+        </div>
+      </div>
+
+      <div id="method-M000216" class="method-detail">
+        <a name="M000216"></a>
+
+        <div class="method-heading">
+          <a href="Resolver.src/M000216.html" target="Code" class="method-signature"
+            onclick="popupCode('Resolver.src/M000216.html');return false;">
           <span class="method-name">new</span><span class="method-args">(*args)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-Create a <a href="Resolver.html#M000215">new</a> <a
+Create a <a href="Resolver.html#M000216">new</a> <a
 href="Resolver.html">Resolver</a> object. If no parameters are passed in,
 then the default system configuration will be used. Otherwise, a Hash may
 be passed in with the following optional elements :
@@ -443,67 +481,89 @@ be passed in with the following optional elements :
         </div>
       </div>
 
-      <h3 class="section-bar">Public Instance methods</h3>
-
-      <div id="method-M000216" class="method-detail">
-        <a name="M000216"></a>
+      <div id="method-M000234" class="method-detail">
+        <a name="M000234"></a>
 
         <div class="method-heading">
-          <a href="Resolver.src/M000216.html" target="Code" class="method-signature"
-            onclick="popupCode('Resolver.src/M000216.html');return false;">
-          <span class="method-name">add_config_nameservers</span><span class="method-args">()</span>
+          <a href="Resolver.src/M000234.html" target="Code" class="method-signature"
+            onclick="popupCode('Resolver.src/M000234.html');return false;">
+          <span class="method-name">start_eventmachine_loop</span><span class="method-args">(on=true)</span>
           </a>
         </div>
       
         <div class="method-description">
+          <p>
+If EventMachine is being used, then this method tells <a
+href="../Dnsruby.html">Dnsruby</a> whether or not to start the EventMachine
+loop. If you want to use <a href="../Dnsruby.html">Dnsruby</a> client code
+as is, but using EventMachine for I/O, then <a
+href="../Dnsruby.html">Dnsruby</a> must start the EventMachine loop for
+you. This is the default behaviour. If you want to use EventMachine-style
+code, where everything is wrapped up in an EventMachine::run{} call, then
+this method should be called with false as the parameter.
+</p>
+<p>
+Takes a bool argument to say whether or not to start the event loop when
+required.
+</p>
         </div>
       </div>
 
-      <div id="method-M000218" class="method-detail">
-        <a name="M000218"></a>
+      <div id="method-M000235" class="method-detail">
+        <a name="M000235"></a>
 
         <div class="method-heading">
-          <a href="Resolver.src/M000218.html" target="Code" class="method-signature"
-            onclick="popupCode('Resolver.src/M000218.html');return false;">
-          <span class="method-name">add_resolver</span><span class="method-args">(single)</span>
+          <a href="Resolver.src/M000235.html" target="Code" class="method-signature"
+            onclick="popupCode('Resolver.src/M000235.html');return false;">
+          <span class="method-name">start_eventmachine_loop?</span><span class="method-args">()</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-Add a <a href="Resolver.html#M000215">new</a> <a
-href="SingleResolver.html">SingleResolver</a> to the list of resolvers this
-<a href="Resolver.html">Resolver</a> object will <a
-href="Resolver.html#M000211">query</a>.
+Checks whether <a href="../Dnsruby.html">Dnsruby</a> will start the
+EventMachine loop when required.
 </p>
         </div>
       </div>
 
-      <div id="method-M000214" class="method-detail">
-        <a name="M000214"></a>
+      <div id="method-M000232" class="method-detail">
+        <a name="M000232"></a>
 
         <div class="method-heading">
-          <a href="Resolver.src/M000214.html" target="Code" class="method-signature"
-            onclick="popupCode('Resolver.src/M000214.html');return false;">
-          <span class="method-name">close</span><span class="method-args">()</span>
+          <a href="Resolver.src/M000232.html" target="Code" class="method-signature"
+            onclick="popupCode('Resolver.src/M000232.html');return false;">
+          <span class="method-name">use_eventmachine</span><span class="method-args">(on=true)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-Close the <a href="Resolver.html">Resolver</a>. Unfinished queries are
-terminated with OtherResolError.
+Tell <a href="../Dnsruby.html">Dnsruby</a> to use EventMachine for I/O.
+</p>
+<p>
+If EventMachine is not used, then the pure Ruby event loop in <a
+href="../Dnsruby.html">Dnsruby</a> will be used instead.
+</p>
+<p>
+If EventMachine is not available on the platform, then a RuntimeError will
+be raised.
+</p>
+<p>
+Takes a bool to say whether or not to use EventMachine.
 </p>
         </div>
       </div>
 
-      <div id="method-M000224" class="method-detail">
-        <a name="M000224"></a>
+      <h3 class="section-bar">Public Instance methods</h3>
+
+      <div id="method-M000217" class="method-detail">
+        <a name="M000217"></a>
 
         <div class="method-heading">
-          <a href="Resolver.src/M000224.html" target="Code" class="method-signature"
-            onclick="popupCode('Resolver.src/M000224.html');return false;">
-          <span class="method-name">ignore_truncation=</span><span class="method-args">(on)</span>
+          <a href="Resolver.src/M000217.html" target="Code" class="method-signature"
+            onclick="popupCode('Resolver.src/M000217.html');return false;">
+          <span class="method-name">add_config_nameservers</span><span class="method-args">()</span>
           </a>
         </div>
       
@@ -517,7 +577,45 @@ terminated with OtherResolError.
         <div class="method-heading">
           <a href="Resolver.src/M000219.html" target="Code" class="method-signature"
             onclick="popupCode('Resolver.src/M000219.html');return false;">
-          <span class="method-name">nameserver=</span><span class="method-args">(n)</span>
+          <span class="method-name">add_resolver</span><span class="method-args">(single)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Add a <a href="Resolver.html#M000216">new</a> <a
+href="SingleResolver.html">SingleResolver</a> to the list of resolvers this
+<a href="Resolver.html">Resolver</a> object will <a
+href="Resolver.html#M000212">query</a>.
+</p>
+        </div>
+      </div>
+
+      <div id="method-M000215" class="method-detail">
+        <a name="M000215"></a>
+
+        <div class="method-heading">
+          <a href="Resolver.src/M000215.html" target="Code" class="method-signature"
+            onclick="popupCode('Resolver.src/M000215.html');return false;">
+          <span class="method-name">close</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Close the <a href="Resolver.html">Resolver</a>. Unfinished queries are
+terminated with <a href="OtherResolvError.html">OtherResolvError</a>.
+</p>
+        </div>
+      </div>
+
+      <div id="method-M000225" class="method-detail">
+        <a name="M000225"></a>
+
+        <div class="method-heading">
+          <a href="Resolver.src/M000225.html" target="Code" class="method-signature"
+            onclick="popupCode('Resolver.src/M000225.html');return false;">
+          <span class="method-name">ignore_truncation=</span><span class="method-args">(on)</span>
           </a>
         </div>
       
@@ -531,7 +629,7 @@ terminated with OtherResolError.
         <div class="method-heading">
           <a href="Resolver.src/M000220.html" target="Code" class="method-signature"
             onclick="popupCode('Resolver.src/M000220.html');return false;">
-          <span class="method-name">packet_timeout=</span><span class="method-args">(t)</span>
+          <span class="method-name">nameserver=</span><span class="method-args">(n)</span>
           </a>
         </div>
       
@@ -539,13 +637,13 @@ terminated with OtherResolError.
         </div>
       </div>
 
-      <div id="method-M000227" class="method-detail">
-        <a name="M000227"></a>
+      <div id="method-M000221" class="method-detail">
+        <a name="M000221"></a>
 
         <div class="method-heading">
-          <a href="Resolver.src/M000227.html" target="Code" class="method-signature"
-            onclick="popupCode('Resolver.src/M000227.html');return false;">
-          <span class="method-name">persistent_tcp=</span><span class="method-args">(on)</span>
+          <a href="Resolver.src/M000221.html" target="Code" class="method-signature"
+            onclick="popupCode('Resolver.src/M000221.html');return false;">
+          <span class="method-name">packet_timeout=</span><span class="method-args">(t)</span>
           </a>
         </div>
       
@@ -559,6 +657,20 @@ terminated with OtherResolError.
         <div class="method-heading">
           <a href="Resolver.src/M000228.html" target="Code" class="method-signature"
             onclick="popupCode('Resolver.src/M000228.html');return false;">
+          <span class="method-name">persistent_tcp=</span><span class="method-args">(on)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
+      <div id="method-M000229" class="method-detail">
+        <a name="M000229"></a>
+
+        <div class="method-heading">
+          <a href="Resolver.src/M000229.html" target="Code" class="method-signature"
+            onclick="popupCode('Resolver.src/M000229.html');return false;">
           <span class="method-name">persistent_udp=</span><span class="method-args">(on)</span>
           </a>
         </div>
@@ -567,12 +679,12 @@ terminated with OtherResolError.
         </div>
       </div>
 
-      <div id="method-M000221" class="method-detail">
-        <a name="M000221"></a>
+      <div id="method-M000222" class="method-detail">
+        <a name="M000222"></a>
 
         <div class="method-heading">
-          <a href="Resolver.src/M000221.html" target="Code" class="method-signature"
-            onclick="popupCode('Resolver.src/M000221.html');return false;">
+          <a href="Resolver.src/M000222.html" target="Code" class="method-signature"
+            onclick="popupCode('Resolver.src/M000222.html');return false;">
           <span class="method-name">port=</span><span class="method-args">(p)</span>
           </a>
         </div>
@@ -581,12 +693,12 @@ terminated with OtherResolError.
         </div>
       </div>
 
-      <div id="method-M000211" class="method-detail">
-        <a name="M000211"></a>
+      <div id="method-M000212" class="method-detail">
+        <a name="M000212"></a>
 
         <div class="method-heading">
-          <a href="Resolver.src/M000211.html" target="Code" class="method-signature"
-            onclick="popupCode('Resolver.src/M000211.html');return false;">
+          <a href="Resolver.src/M000212.html" target="Code" class="method-signature"
+            onclick="popupCode('Resolver.src/M000212.html');return false;">
           <span class="method-name">query</span><span class="method-args">(name, type=Types.A, klass=Classes.IN)</span>
           </a>
         </div>
@@ -609,12 +721,12 @@ href="ResolvTimeout.html">Dnsruby::ResolvTimeout</a>) is raised.
         </div>
       </div>
 
-      <div id="method-M000229" class="method-detail">
-        <a name="M000229"></a>
+      <div id="method-M000230" class="method-detail">
+        <a name="M000230"></a>
 
         <div class="method-heading">
-          <a href="Resolver.src/M000229.html" target="Code" class="method-signature"
-            onclick="popupCode('Resolver.src/M000229.html');return false;">
+          <a href="Resolver.src/M000230.html" target="Code" class="method-signature"
+            onclick="popupCode('Resolver.src/M000230.html');return false;">
           <span class="method-name">recurse=</span><span class="method-args">(a)</span>
           </a>
         </div>
@@ -623,13 +735,13 @@ href="ResolvTimeout.html">Dnsruby::ResolvTimeout</a>) is raised.
         </div>
       </div>
 
-      <div id="method-M000213" class="method-detail">
-        <a name="M000213"></a>
+      <div id="method-M000214" class="method-detail">
+        <a name="M000214"></a>
 
         <div class="method-heading">
-          <a href="Resolver.src/M000213.html" target="Code" class="method-signature"
-            onclick="popupCode('Resolver.src/M000213.html');return false;">
-          <span class="method-name">send_async</span><span class="method-args">(msg, client_query_id, client_queue)</span>
+          <a href="Resolver.src/M000214.html" target="Code" class="method-signature"
+            onclick="popupCode('Resolver.src/M000214.html');return false;">
+          <span class="method-name">send_async</span><span class="method-args">(*args)</span>
           </a>
         </div>
       
@@ -653,9 +765,9 @@ example :
   res = Dnsruby::Resolver.new
   query_id = 10 # can be any object you like
   query_queue = Queue.new
-  res.send_async(Message.new(&quot;example.com&quot;, Types.MX), query_id,  query_queue)
+  res.send_async(Message.new(&quot;example.com&quot;, Types.MX),  query_queue, query_id)
   query_id += 1
-  res.send_async(Message.new(&quot;example.com&quot;, Types.A), query_id,  query_queue)
+  res.send_async(Message.new(&quot;example.com&quot;, Types.A), query_queue, query_id)
   # ...do a load of other stuff here...
   2.times do
     response_id, response, exception = query_queue.pop
@@ -667,15 +779,18 @@ example :
     end
   end
 </pre>
+<p>
+@TODO@ Sort out RDoc arguments to send_async!
+</p>
         </div>
       </div>
 
-      <div id="method-M000212" class="method-detail">
-        <a name="M000212"></a>
+      <div id="method-M000213" class="method-detail">
+        <a name="M000213"></a>
 
         <div class="method-heading">
-          <a href="Resolver.src/M000212.html" target="Code" class="method-signature"
-            onclick="popupCode('Resolver.src/M000212.html');return false;">
+          <a href="Resolver.src/M000213.html" target="Code" class="method-signature"
+            onclick="popupCode('Resolver.src/M000213.html');return false;">
           <span class="method-name">send_message</span><span class="method-args">(message)</span>
           </a>
         </div>
@@ -689,7 +804,7 @@ href="ResolvError.html">Dnsruby::ResolvError</a> or <a
 href="ResolvTimeout.html">Dnsruby::ResolvTimeout</a>) is raised.
 </p>
 <p>
-<a href="Resolver.html#M000213">send_async</a> is called internally.
+<a href="Resolver.html#M000214">send_async</a> is called internally.
 </p>
 <p>
 example :
@@ -708,12 +823,12 @@ example :
         </div>
       </div>
 
-      <div id="method-M000217" class="method-detail">
-        <a name="M000217"></a>
+      <div id="method-M000218" class="method-detail">
+        <a name="M000218"></a>
 
         <div class="method-heading">
-          <a href="Resolver.src/M000217.html" target="Code" class="method-signature"
-            onclick="popupCode('Resolver.src/M000217.html');return false;">
+          <a href="Resolver.src/M000218.html" target="Code" class="method-signature"
+            onclick="popupCode('Resolver.src/M000218.html');return false;">
           <span class="method-name">set_config_nameserver</span><span class="method-args">(n)</span>
           </a>
         </div>
@@ -722,12 +837,12 @@ example :
         </div>
       </div>
 
-      <div id="method-M000225" class="method-detail">
-        <a name="M000225"></a>
+      <div id="method-M000226" class="method-detail">
+        <a name="M000226"></a>
 
         <div class="method-heading">
-          <a href="Resolver.src/M000225.html" target="Code" class="method-signature"
-            onclick="popupCode('Resolver.src/M000225.html');return false;">
+          <a href="Resolver.src/M000226.html" target="Code" class="method-signature"
+            onclick="popupCode('Resolver.src/M000226.html');return false;">
           <span class="method-name">src_address=</span><span class="method-args">(a)</span>
           </a>
         </div>
@@ -736,12 +851,12 @@ example :
         </div>
       </div>
 
-      <div id="method-M000226" class="method-detail">
-        <a name="M000226"></a>
+      <div id="method-M000227" class="method-detail">
+        <a name="M000227"></a>
 
         <div class="method-heading">
-          <a href="Resolver.src/M000226.html" target="Code" class="method-signature"
-            onclick="popupCode('Resolver.src/M000226.html');return false;">
+          <a href="Resolver.src/M000227.html" target="Code" class="method-signature"
+            onclick="popupCode('Resolver.src/M000227.html');return false;">
           <span class="method-name">src_port=</span><span class="method-args">(a)</span>
           </a>
         </div>
@@ -750,12 +865,12 @@ example :
         </div>
       </div>
 
-      <div id="method-M000223" class="method-detail">
-        <a name="M000223"></a>
+      <div id="method-M000224" class="method-detail">
+        <a name="M000224"></a>
 
         <div class="method-heading">
-          <a href="Resolver.src/M000223.html" target="Code" class="method-signature"
-            onclick="popupCode('Resolver.src/M000223.html');return false;">
+          <a href="Resolver.src/M000224.html" target="Code" class="method-signature"
+            onclick="popupCode('Resolver.src/M000224.html');return false;">
           <span class="method-name">tsig_key=</span><span class="method-args">(t)</span>
           </a>
         </div>
@@ -764,12 +879,12 @@ example :
         </div>
       </div>
 
-      <div id="method-M000230" class="method-detail">
-        <a name="M000230"></a>
+      <div id="method-M000231" class="method-detail">
+        <a name="M000231"></a>
 
         <div class="method-heading">
-          <a href="Resolver.src/M000230.html" target="Code" class="method-signature"
-            onclick="popupCode('Resolver.src/M000230.html');return false;">
+          <a href="Resolver.src/M000231.html" target="Code" class="method-signature"
+            onclick="popupCode('Resolver.src/M000231.html');return false;">
           <span class="method-name">udp_size=</span><span class="method-args">(s)</span>
           </a>
         </div>
@@ -778,12 +893,12 @@ example :
         </div>
       </div>
 
-      <div id="method-M000222" class="method-detail">
-        <a name="M000222"></a>
+      <div id="method-M000223" class="method-detail">
+        <a name="M000223"></a>
 
         <div class="method-heading">
-          <a href="Resolver.src/M000222.html" target="Code" class="method-signature"
-            onclick="popupCode('Resolver.src/M000222.html');return false;">
+          <a href="Resolver.src/M000223.html" target="Code" class="method-signature"
+            onclick="popupCode('Resolver.src/M000223.html');return false;">
           <span class="method-name">use_tcp=</span><span class="method-args">(on)</span>
           </a>
         </div>