Dnsruby 0.5.0 → 0.6.0

data/doc/classes/Dnsruby/SingleResolver.html

@@ -124,13 +124,14 @@ query_id, response_queue [, use_tcp])
       <h3 class="section-bar">Methods</h3>
 
       <div class="name-list">
+      <a href="#M000129">check_response</a>&nbsp;&nbsp;
       <a href="#M000125">close</a>&nbsp;&nbsp;
       <a href="#M000124">new</a>&nbsp;&nbsp;
       <a href="#M000126">query</a>&nbsp;&nbsp;
       <a href="#M000128">send_async</a>&nbsp;&nbsp;
       <a href="#M000127">send_message</a>&nbsp;&nbsp;
       <a href="#M000123">server=</a>&nbsp;&nbsp;
-      <a href="#M000129">udp_packet_size</a>&nbsp;&nbsp;
+      <a href="#M000130">udp_packet_size</a>&nbsp;&nbsp;
       <a href="#M000122">udp_size=</a>&nbsp;&nbsp;
       </div>
     </div>
@@ -335,6 +336,20 @@ Can take a hash with the following optional keys :
 
       <h3 class="section-bar">Public Instance methods</h3>
 
+      <div id="method-M000129" class="method-detail">
+        <a name="M000129"></a>
+
+        <div class="method-heading">
+          <a href="SingleResolver.src/M000129.html" target="Code" class="method-signature"
+            onclick="popupCode('SingleResolver.src/M000129.html');return false;">
+          <span class="method-name">check_response</span><span class="method-args">(response, query, client_queue, client_query_id, tcp)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+        </div>
+      </div>
+
       <div id="method-M000125" class="method-detail">
         <a name="M000125"></a>
 
@@ -373,42 +388,49 @@ the given name. The type will default to A, and the class to IN.
         <div class="method-heading">
           <a href="SingleResolver.src/M000128.html" target="Code" class="method-signature"
             onclick="popupCode('SingleResolver.src/M000128.html');return false;">
-          <span class="method-name">send_async</span><span class="method-args">(msg, client_query_id, client_queue, use_tcp=@use_tcp)</span>
+          <span class="method-name">send_async</span><span class="method-args">(*args)</span>
           </a>
         </div>
       
         <div class="method-description">
-          <p>
-Asynchronously send a <a href="Message.html">Message</a> to the server. A
-client_queue is supplied by the client, along with a client_query_id to
-identify the response. When the response is known, the tuple (query_id,
-response_message, response_exception) is put in the queue for the client to
-process.
-</p>
-<p>
-The <a href="SingleResolver.html#M000126">query</a> is sent synchronously
-in the caller&#8216;s thread. The select thread is then used to listen for
-and process the response (up to pushing it to the client_queue). The client
-thread is then used to retrieve the response and deal with it.
-</p>
-<p>
-Takes :
-</p>
-<ul>
-<li>msg - the message to send
+          <pre>
+ Asynchronously send a Message to the server. The send can be done using just
+ Dnsruby, or using EventMachine.
+</pre>
+<h1>If the pure Ruby event loop supplied weith <a href="../Dnsruby.html">Dnsruby</a> is being used, then :</h1>
+<pre>
+ A client_queue is supplied by the client,
+ along with a client_query_id to identify the response. When the response is known, the tuple
+ (query_id, response_message, response_exception) is put in the queue for the client to process.
 
-</li>
-<li>client_query_id - an ID to identify the <a
-href="SingleResolver.html#M000126">query</a> to the client
+ The query is sent synchronously in the caller's thread. The select thread is then used to
+ listen for and process the response (up to pushing it to the client_queue). The client thread
+ is then used to retrieve the response and deal with it.
 
-</li>
-<li>client_queue - a Queue to push the response to, when it arrives
+ Takes :
 
-</li>
-<li>use_tcp - whether to use TCP (defaults to SingleResolver.use_tcp)
+ * msg - the message to send
+ * client_queue - a Queue to push the response to, when it arrives
+ * client_query_id - an ID to identify the query to the client
+ * use_tcp - whether to use TCP (defaults to SingleResolver.use_tcp)
 
-</li>
-</ul>
+ If the native Dsnruby networking layer is being used, then this method returns the client_query_id
+
+    id = res.send_async(msg, queue)
+    NOT SUPPORTED : id = res.send_async(msg, queue, use_tcp)
+    id = res.send_async(msg, queue, id)
+    id = res.send_async(msg, queue, id, use_tcp)
+</pre>
+<h1>If EventMachine is being used :</h1>
+<pre>
+ If EventMachine is being used (see Dnsruby::Resolver::use_eventmachine, then this method returns
+ an EM::Deferrable object. If a queue (and ID) is passed in, then the response will also be
+ pushed to the Queue (as well as the deferrable completing).
+
+    deferrable = res.send_async(msg)
+    deferrable = res.send_async(msg, use_tcp)
+    deferrable = res.send_async(msg, q, id, use_tcp)
+</pre>
         </div>
       </div>
 
@@ -450,12 +472,12 @@ to SingleResolver.use_tcp
         </div>
       </div>
 
-      <div id="method-M000129" class="method-detail">
-        <a name="M000129"></a>
+      <div id="method-M000130" class="method-detail">
+        <a name="M000130"></a>
 
         <div class="method-heading">
-          <a href="SingleResolver.src/M000129.html" target="Code" class="method-signature"
-            onclick="popupCode('SingleResolver.src/M000129.html');return false;">
+          <a href="SingleResolver.src/M000130.html" target="Code" class="method-signature"
+            onclick="popupCode('SingleResolver.src/M000130.html');return false;">
           <span class="method-name">udp_packet_size</span><span class="method-args">()</span>
           </a>
         </div>

data/doc/classes/Dnsruby/SingleResolver.src/M000128.html

@@ -10,9 +10,12 @@
   <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
 </head>
 <body class="standalone-code">
-  <pre><span class="ruby-comment cmt"># File lib/Dnsruby/SingleResolver.rb, line 193</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">send_async</span>(<span class="ruby-identifier">msg</span>, <span class="ruby-identifier">client_query_id</span>, <span class="ruby-identifier">client_queue</span>, <span class="ruby-identifier">use_tcp</span>=<span class="ruby-ivar">@use_tcp</span>)
-      <span class="ruby-identifier">st</span> = <span class="ruby-constant">SelectThread</span>.<span class="ruby-identifier">instance</span>
+  <pre><span class="ruby-comment cmt"># File lib/Dnsruby/SingleResolver.rb, line 215</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">send_async</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>) <span class="ruby-comment cmt"># msg, client_queue, client_query_id, use_tcp=@use_tcp)</span>
+      <span class="ruby-identifier">msg</span> = <span class="ruby-identifier">args</span>[<span class="ruby-value">0</span>]
+      <span class="ruby-identifier">client_query_id</span> = <span class="ruby-keyword kw">nil</span>
+      <span class="ruby-identifier">client_queue</span> = <span class="ruby-keyword kw">nil</span>
+      <span class="ruby-identifier">use_tcp</span> = <span class="ruby-ivar">@use_tcp</span>
       <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">msg</span>.<span class="ruby-identifier">kind_of?</span><span class="ruby-constant">String</span>)
         <span class="ruby-identifier">msg</span> = <span class="ruby-constant">Message</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">msg</span>)
       <span class="ruby-keyword kw">end</span>
@@ -20,59 +23,29 @@
       <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">udp_packet_size</span> <span class="ruby-operator">&lt;</span> <span class="ruby-identifier">query_packet</span>.<span class="ruby-identifier">length</span>)
         <span class="ruby-identifier">use_tcp</span> = <span class="ruby-keyword kw">true</span>
       <span class="ruby-keyword kw">end</span>
-      <span class="ruby-comment cmt"># First send the query (synchronously)</span>
-      <span class="ruby-comment cmt"># @TODO@ persisent sockets</span>
-      <span class="ruby-identifier">endtime</span> = <span class="ruby-constant">Time</span>.<span class="ruby-identifier">now</span> <span class="ruby-operator">+</span> <span class="ruby-ivar">@packet_timeout</span>
-      <span class="ruby-identifier">socket</span> = <span class="ruby-keyword kw">nil</span>
-      <span class="ruby-keyword kw">begin</span>
-        <span class="ruby-comment cmt">#@TODO@ Different OSes have different interpretations of &quot;random port&quot; here.</span>
-        <span class="ruby-comment cmt">#Apparently, Linux will just give you the same port as last time, unless it is still</span>
-        <span class="ruby-comment cmt">#open, in which case you get n+1.</span>
-        <span class="ruby-comment cmt">#We need to determine an actual (random) number here, then ask the OS for it, and</span>
-        <span class="ruby-comment cmt">#continue until we get one.</span>
-        <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">use_tcp</span>) 
-          <span class="ruby-identifier">print</span> <span class="ruby-node">&quot;Setting src_port to #{@src_port}&quot;</span>
-          <span class="ruby-identifier">socket</span> = <span class="ruby-constant">TCPSocket</span>.<span class="ruby-identifier">new</span>(<span class="ruby-ivar">@server</span>, <span class="ruby-ivar">@port</span>, <span class="ruby-ivar">@src_addr</span>, <span class="ruby-ivar">@src_port</span>)
-        <span class="ruby-keyword kw">else</span>
-          <span class="ruby-identifier">socket</span> = <span class="ruby-constant">UDPSocket</span>.<span class="ruby-identifier">new</span>()
-          <span class="ruby-identifier">socket</span>.<span class="ruby-identifier">bind</span>(<span class="ruby-ivar">@src_addr</span>, <span class="ruby-ivar">@src_port</span>)
-          <span class="ruby-identifier">socket</span>.<span class="ruby-identifier">connect</span>(<span class="ruby-ivar">@server</span>, <span class="ruby-ivar">@port</span>)
+      <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">args</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">1</span>)
+        <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">args</span>[<span class="ruby-value">1</span>].<span class="ruby-identifier">class</span><span class="ruby-operator">==</span><span class="ruby-constant">Queue</span>)
+          <span class="ruby-identifier">client_queue</span> = <span class="ruby-identifier">args</span>[<span class="ruby-value">1</span>]
+        <span class="ruby-keyword kw">elsif</span> (<span class="ruby-identifier">args</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">==</span> <span class="ruby-value">2</span>)
+          <span class="ruby-identifier">use_tcp</span> = <span class="ruby-identifier">args</span>[<span class="ruby-value">1</span>]
         <span class="ruby-keyword kw">end</span>
-      <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Exception</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">e</span>
-        <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">socket!</span>=<span class="ruby-keyword kw">nil</span>)
-          <span class="ruby-identifier">socket</span>.<span class="ruby-identifier">close</span>
+        <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">args</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">2</span>)
+          <span class="ruby-identifier">client_query_id</span> = <span class="ruby-identifier">args</span>[<span class="ruby-value">2</span>]
+          <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">args</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">3</span>)
+            <span class="ruby-identifier">use_tcp</span> = <span class="ruby-identifier">args</span>[<span class="ruby-value">3</span>]
+          <span class="ruby-keyword kw">end</span>
         <span class="ruby-keyword kw">end</span>
-        <span class="ruby-identifier">err</span>=<span class="ruby-constant">IOError</span>.<span class="ruby-identifier">new</span>(<span class="ruby-node">&quot;dnsruby can't connect to #{@server}:#{@port} from #{@src_addr}:#{@src_port}, use_tcp=#{use_tcp}, exception = #{e.class}, #{e}&quot;</span>)
-        <span class="ruby-constant">TheLog</span>.<span class="ruby-identifier">error</span>(<span class="ruby-node">&quot;#{err}&quot;</span>)
-        <span class="ruby-identifier">st</span>.<span class="ruby-identifier">push_exception_to_select</span>(<span class="ruby-identifier">client_query_id</span>, <span class="ruby-identifier">client_queue</span>, <span class="ruby-identifier">err</span>, <span class="ruby-keyword kw">nil</span>)
-        <span class="ruby-keyword kw">return</span>
       <span class="ruby-keyword kw">end</span>
-      <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">socket</span><span class="ruby-operator">==</span><span class="ruby-keyword kw">nil</span>)
-        <span class="ruby-identifier">err</span>=<span class="ruby-constant">IOError</span>.<span class="ruby-identifier">new</span>(<span class="ruby-node">&quot;dnsruby can't connect to #{@server}:#{port} from #{@src_addr}:#{@src_port}, use_tcp=#{use_tcp}&quot;</span>)
-        <span class="ruby-constant">TheLog</span>.<span class="ruby-identifier">error</span>(<span class="ruby-node">&quot;#{err}&quot;</span>)
-        <span class="ruby-identifier">st</span>.<span class="ruby-identifier">push_exception_to_select</span>(<span class="ruby-identifier">client_query_id</span>, <span class="ruby-identifier">client_queue</span>, <span class="ruby-identifier">err</span>, <span class="ruby-keyword kw">nil</span>)
-        <span class="ruby-keyword kw">return</span>
-      <span class="ruby-keyword kw">end</span>
-      <span class="ruby-constant">TheLog</span>.<span class="ruby-identifier">debug</span>(<span class="ruby-node">&quot;Sending packet to #{@server}:#{@port} from #{@src_addr}:#{@src_port}, use_tcp=#{use_tcp}&quot;</span>)
-      <span class="ruby-keyword kw">begin</span>
-        <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">use_tcp</span>)
-          <span class="ruby-identifier">lenmsg</span> = [<span class="ruby-identifier">query_packet</span>.<span class="ruby-identifier">length</span>].<span class="ruby-identifier">pack</span>(<span class="ruby-value str">'n'</span>)
-          <span class="ruby-identifier">socket</span>.<span class="ruby-identifier">send</span>(<span class="ruby-identifier">lenmsg</span>, <span class="ruby-value">0</span>)
+      <span class="ruby-comment cmt">#Are we using EventMachine or native Dnsruby?</span>
+      <span class="ruby-keyword kw">if</span> (<span class="ruby-constant">Resolver</span>.<span class="ruby-identifier">eventmachine?</span>)
+        <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">send_eventmachine</span>(<span class="ruby-identifier">query_packet</span>, <span class="ruby-identifier">msg</span>.<span class="ruby-identifier">header</span>.<span class="ruby-identifier">id</span>, <span class="ruby-identifier">client_query_id</span>, <span class="ruby-identifier">client_queue</span>, <span class="ruby-identifier">use_tcp</span>)
+      <span class="ruby-keyword kw">else</span>
+        <span class="ruby-keyword kw">if</span> (<span class="ruby-operator">!</span><span class="ruby-identifier">client_query_id</span>)
+          <span class="ruby-identifier">client_query_id</span> = <span class="ruby-identifier">msg</span>
         <span class="ruby-keyword kw">end</span>
-        <span class="ruby-identifier">socket</span>.<span class="ruby-identifier">send</span>(<span class="ruby-identifier">query_packet</span>, <span class="ruby-value">0</span>)
-      <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Exception</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">e</span>
-        <span class="ruby-identifier">socket</span>.<span class="ruby-identifier">close</span>
-        <span class="ruby-identifier">err</span>=<span class="ruby-constant">IOError</span>.<span class="ruby-identifier">new</span>(<span class="ruby-node">&quot;Send failed to #{@server}:#{@port} from #{@src_addr}:#{@src_port}, use_tcp=#{use_tcp}, exception : #{e}&quot;</span>)
-        <span class="ruby-constant">TheLog</span>.<span class="ruby-identifier">error</span>(<span class="ruby-node">&quot;#{err}&quot;</span>)
-        <span class="ruby-identifier">st</span>.<span class="ruby-identifier">push_exception_to_select</span>(<span class="ruby-identifier">client_query_id</span>, <span class="ruby-identifier">client_queue</span>, <span class="ruby-identifier">err</span>, <span class="ruby-keyword kw">nil</span>)
-        <span class="ruby-keyword kw">return</span>
+        <span class="ruby-identifier">send_dnsruby</span>(<span class="ruby-identifier">query_packet</span>, <span class="ruby-identifier">msg</span>.<span class="ruby-identifier">header</span>.<span class="ruby-identifier">id</span>, <span class="ruby-identifier">client_query_id</span>, <span class="ruby-identifier">client_queue</span>, <span class="ruby-identifier">use_tcp</span>)
+        <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">client_query_id</span>
       <span class="ruby-keyword kw">end</span>
-      
-      <span class="ruby-comment cmt"># Then listen for the response</span>
-      <span class="ruby-identifier">query_settings</span> = <span class="ruby-constant">SelectThread</span><span class="ruby-operator">::</span><span class="ruby-constant">QuerySettings</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">query_packet</span>, <span class="ruby-identifier">msg</span>.<span class="ruby-identifier">header</span>.<span class="ruby-identifier">id</span>, <span class="ruby-ivar">@tsig_key</span>, <span class="ruby-ivar">@ignore_truncation</span>, <span class="ruby-identifier">client_queue</span>, <span class="ruby-identifier">client_query_id</span>, <span class="ruby-identifier">socket</span>, <span class="ruby-ivar">@server</span>, <span class="ruby-ivar">@port</span>, <span class="ruby-identifier">endtime</span>)
-      <span class="ruby-comment cmt"># The select thread will now wait for the response and send that or a timeout</span>
-      <span class="ruby-comment cmt"># back to the client_queue</span>
-      <span class="ruby-identifier">st</span>.<span class="ruby-identifier">add_to_select</span>(<span class="ruby-identifier">query_settings</span>)
     <span class="ruby-keyword kw">end</span></pre>
 </body>
 </html>

data/doc/classes/Dnsruby/SingleResolver.src/M000129.html

@@ -5,16 +5,21 @@
 
 <html>
 <head>
-  <title>udp_packet_size (Dnsruby::SingleResolver)</title>
+  <title>check_response (Dnsruby::SingleResolver)</title>
   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
   <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
 </head>
 <body class="standalone-code">
-  <pre><span class="ruby-comment cmt"># File lib/Dnsruby/SingleResolver.rb, line 305</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">udp_packet_size</span>
-      <span class="ruby-comment cmt"># if @udp_size &gt; DefaultUDPSize then we use EDNS and </span>
-      <span class="ruby-comment cmt"># @udp_size should be taken as the maximum packet_data length</span>
-      <span class="ruby-identifier">ret</span> = (<span class="ruby-ivar">@udp_size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-constant">Resolver</span><span class="ruby-operator">::</span><span class="ruby-constant">DefaultUDPSize</span> <span class="ruby-value">? </span><span class="ruby-ivar">@udp_size</span> <span class="ruby-operator">:</span> <span class="ruby-constant">Resolver</span><span class="ruby-operator">::</span><span class="ruby-constant">DefaultUDPSize</span>) 
+  <pre><span class="ruby-comment cmt"># File lib/Dnsruby/SingleResolver.rb, line 340</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">check_response</span>(<span class="ruby-identifier">response</span>, <span class="ruby-identifier">query</span>, <span class="ruby-identifier">client_queue</span>, <span class="ruby-identifier">client_query_id</span>, <span class="ruby-identifier">tcp</span>)
+      <span class="ruby-comment cmt"># @TODO@ Check TSIG!</span>
+      <span class="ruby-identifier">ret</span> = <span class="ruby-keyword kw">true</span>
+      <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">response</span>.<span class="ruby-identifier">header</span>.<span class="ruby-identifier">tc</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-operator">!</span><span class="ruby-identifier">tcp</span>)
+        <span class="ruby-comment cmt"># Try to resend over tcp</span>
+        <span class="ruby-constant">TheLog</span>.<span class="ruby-identifier">debug</span>(<span class="ruby-value str">&quot;Truncated - resending over TCP&quot;</span>)
+        <span class="ruby-identifier">send_async</span>(<span class="ruby-constant">Message</span>.<span class="ruby-identifier">decode</span>(<span class="ruby-identifier">query</span>), <span class="ruby-identifier">client_queue</span>, <span class="ruby-identifier">client_query_id</span>, <span class="ruby-keyword kw">true</span>)
+        <span class="ruby-identifier">ret</span>=<span class="ruby-keyword kw">false</span>
+      <span class="ruby-keyword kw">end</span>
       <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">ret</span>
     <span class="ruby-keyword kw">end</span></pre>
 </body>

data/doc/classes/Dnsruby/SingleResolver.src/M000130.html

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html>
+<head>
+  <title>udp_packet_size (Dnsruby::SingleResolver)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/Dnsruby/SingleResolver.rb, line 400</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">udp_packet_size</span>
+      <span class="ruby-comment cmt"># if @udp_size &gt; DefaultUDPSize then we use EDNS and </span>
+      <span class="ruby-comment cmt"># @udp_size should be taken as the maximum packet_data length</span>
+      <span class="ruby-identifier">ret</span> = (<span class="ruby-ivar">@udp_size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-constant">Resolver</span><span class="ruby-operator">::</span><span class="ruby-constant">DefaultUDPSize</span> <span class="ruby-value">? </span><span class="ruby-ivar">@udp_size</span> <span class="ruby-operator">:</span> <span class="ruby-constant">Resolver</span><span class="ruby-operator">::</span><span class="ruby-constant">DefaultUDPSize</span>) 
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">ret</span>
+    <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/Dnsruby/SingleResolver.src/M000149.html

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html>
+<head>
+  <title>udp_size= (Dnsruby::SingleResolver)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/Dnsruby/SingleResolver.rb, line 89</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">udp_size=</span>(<span class="ruby-identifier">size</span>)
+      <span class="ruby-ivar">@udp_size</span> = <span class="ruby-identifier">size</span>
+    <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/Dnsruby/SingleResolver.src/M000150.html

@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html>
+<head>
+  <title>server= (Dnsruby::SingleResolver)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/Dnsruby/SingleResolver.rb, line 93</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">server=</span>(<span class="ruby-identifier">server</span>)
+      <span class="ruby-constant">TheLog</span>.<span class="ruby-identifier">debug</span>(<span class="ruby-node">&quot;SingleResolver setting server to #{server}&quot;</span>)
+      <span class="ruby-ivar">@server</span>=<span class="ruby-constant">Config</span>.<span class="ruby-identifier">resolve_server</span>(<span class="ruby-identifier">server</span>)
+    <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/Dnsruby/SingleResolver.src/M000151.html

@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html>
+<head>
+  <title>new (Dnsruby::SingleResolver)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/Dnsruby/SingleResolver.rb, line 112</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
+      <span class="ruby-identifier">arg</span>=<span class="ruby-identifier">args</span>[<span class="ruby-value">0</span>]
+      <span class="ruby-ivar">@packet_timeout</span> = <span class="ruby-constant">Resolver</span><span class="ruby-operator">::</span><span class="ruby-constant">DefaultPacketTimeout</span>
+      <span class="ruby-ivar">@port</span> = <span class="ruby-constant">Resolver</span><span class="ruby-operator">::</span><span class="ruby-constant">DefaultPort</span>
+      <span class="ruby-ivar">@udp_size</span> = <span class="ruby-constant">Resolver</span><span class="ruby-operator">::</span><span class="ruby-constant">DefaultUDPSize</span>
+      <span class="ruby-ivar">@use_tcp</span> = <span class="ruby-keyword kw">false</span>
+      <span class="ruby-ivar">@tsig_key</span> = <span class="ruby-keyword kw">nil</span>
+      <span class="ruby-ivar">@ignore_truncation</span> = <span class="ruby-keyword kw">false</span>
+      <span class="ruby-ivar">@src_addr</span>        = <span class="ruby-value str">'0.0.0.0'</span>
+      <span class="ruby-ivar">@src_port</span>        = <span class="ruby-value">0</span>
+      <span class="ruby-ivar">@recurse</span> = <span class="ruby-keyword kw">true</span>
+      <span class="ruby-ivar">@persistent_udp</span> = <span class="ruby-keyword kw">false</span>
+      <span class="ruby-ivar">@persistent_tcp</span> = <span class="ruby-keyword kw">false</span>
+      
+      <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">arg</span><span class="ruby-operator">==</span><span class="ruby-keyword kw">nil</span>)
+        <span class="ruby-comment cmt"># Get default config</span>
+        <span class="ruby-identifier">config</span> = <span class="ruby-constant">Config</span>.<span class="ruby-identifier">new</span>
+        <span class="ruby-ivar">@server</span> = <span class="ruby-identifier">config</span>.<span class="ruby-identifier">nameserver</span>[<span class="ruby-value">0</span>]
+      <span class="ruby-keyword kw">elsif</span> (<span class="ruby-identifier">arg</span>.<span class="ruby-identifier">kind_of?</span><span class="ruby-constant">String</span>)
+        <span class="ruby-ivar">@server</span>=<span class="ruby-identifier">arg</span>
+      <span class="ruby-keyword kw">elsif</span> (<span class="ruby-identifier">arg</span>.<span class="ruby-identifier">kind_of?</span><span class="ruby-constant">Hash</span>)
+        <span class="ruby-identifier">arg</span>.<span class="ruby-identifier">keys</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">attr</span><span class="ruby-operator">|</span>
+          <span class="ruby-keyword kw">begin</span>
+            <span class="ruby-identifier">send</span>(<span class="ruby-identifier">attr</span>.<span class="ruby-identifier">to_s</span><span class="ruby-operator">+</span><span class="ruby-value str">&quot;=&quot;</span>, <span class="ruby-identifier">arg</span>[<span class="ruby-identifier">attr</span>])
+          <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Exception</span>
+            <span class="ruby-constant">TheLog</span>.<span class="ruby-identifier">error</span>(<span class="ruby-node">&quot;Argument #{attr} not valid\n&quot;</span>)
+          <span class="ruby-keyword kw">end</span>
+          <span class="ruby-comment cmt">#        end</span>
+        <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">end</span>
+      <span class="ruby-comment cmt">#Check server is IP</span>
+      <span class="ruby-ivar">@server</span>=<span class="ruby-constant">Config</span>.<span class="ruby-identifier">resolve_server</span>(<span class="ruby-ivar">@server</span>)
+      
+    <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/Dnsruby/SingleResolver.src/M000152.html

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html>
+<head>
+  <title>close (Dnsruby::SingleResolver)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/Dnsruby/SingleResolver.rb, line 147</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">close</span>
+      <span class="ruby-comment cmt"># @TODO@ What about closing?</span>
+    <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/Dnsruby/SingleResolver.src/M000153.html

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html>
+<head>
+  <title>query (Dnsruby::SingleResolver)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/Dnsruby/SingleResolver.rb, line 153</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">query</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">type</span>=<span class="ruby-constant">Types</span>.<span class="ruby-constant">A</span>, <span class="ruby-identifier">klass</span>=<span class="ruby-constant">Classes</span>.<span class="ruby-constant">IN</span>)
+      <span class="ruby-identifier">msg</span> = <span class="ruby-constant">Message</span>.<span class="ruby-identifier">new</span>
+      <span class="ruby-identifier">msg</span>.<span class="ruby-identifier">header</span>.<span class="ruby-identifier">rd</span> = <span class="ruby-value">1</span>
+      <span class="ruby-identifier">msg</span>.<span class="ruby-identifier">add_question</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">type</span>, <span class="ruby-identifier">klass</span>)
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">send_message</span>(<span class="ruby-identifier">msg</span>)
+    <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/Dnsruby/SingleResolver.src/M000154.html

@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html>
+<head>
+  <title>send_message (Dnsruby::SingleResolver)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/Dnsruby/SingleResolver.rb, line 167</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">send_message</span>(<span class="ruby-identifier">msg</span>, <span class="ruby-identifier">use_tcp</span>=<span class="ruby-ivar">@use_tcp</span>)
+      <span class="ruby-identifier">q</span> = <span class="ruby-constant">Queue</span>.<span class="ruby-identifier">new</span>
+      <span class="ruby-identifier">send_async</span>(<span class="ruby-identifier">msg</span>, <span class="ruby-identifier">q</span>, <span class="ruby-identifier">q</span>, <span class="ruby-identifier">use_tcp</span>)
+      <span class="ruby-identifier">id</span>, <span class="ruby-identifier">msg</span>, <span class="ruby-identifier">error</span> = <span class="ruby-identifier">q</span>.<span class="ruby-identifier">pop</span>
+      <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">error</span> <span class="ruby-operator">!=</span> <span class="ruby-keyword kw">nil</span>)
+        <span class="ruby-identifier">raise</span> <span class="ruby-identifier">error</span>
+      <span class="ruby-keyword kw">else</span>
+        <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">msg</span>
+      <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/Dnsruby/SingleResolver.src/M000155.html

@@ -0,0 +1,51 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html>
+<head>
+  <title>send_async (Dnsruby::SingleResolver)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/Dnsruby/SingleResolver.rb, line 215</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">send_async</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>) <span class="ruby-comment cmt"># msg, client_queue, client_query_id, use_tcp=@use_tcp)</span>
+      <span class="ruby-identifier">msg</span> = <span class="ruby-identifier">args</span>[<span class="ruby-value">0</span>]
+      <span class="ruby-identifier">client_query_id</span> = <span class="ruby-keyword kw">nil</span>
+      <span class="ruby-identifier">client_queue</span> = <span class="ruby-keyword kw">nil</span>
+      <span class="ruby-identifier">use_tcp</span> = <span class="ruby-ivar">@use_tcp</span>
+      <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">msg</span>.<span class="ruby-identifier">kind_of?</span><span class="ruby-constant">String</span>)
+        <span class="ruby-identifier">msg</span> = <span class="ruby-constant">Message</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">msg</span>)
+      <span class="ruby-keyword kw">end</span>
+      <span class="ruby-identifier">query_packet</span> = <span class="ruby-identifier">make_query_packet</span>(<span class="ruby-identifier">msg</span>)
+      <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">udp_packet_size</span> <span class="ruby-operator">&lt;</span> <span class="ruby-identifier">query_packet</span>.<span class="ruby-identifier">length</span>)
+        <span class="ruby-identifier">use_tcp</span> = <span class="ruby-keyword kw">true</span>
+      <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">args</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">1</span>)
+        <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">args</span>[<span class="ruby-value">1</span>].<span class="ruby-identifier">class</span><span class="ruby-operator">==</span><span class="ruby-constant">Queue</span>)
+          <span class="ruby-identifier">client_queue</span> = <span class="ruby-identifier">args</span>[<span class="ruby-value">1</span>]
+        <span class="ruby-keyword kw">elsif</span> (<span class="ruby-identifier">args</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">==</span> <span class="ruby-value">2</span>)
+          <span class="ruby-identifier">use_tcp</span> = <span class="ruby-identifier">args</span>[<span class="ruby-value">1</span>]
+        <span class="ruby-keyword kw">end</span>
+        <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">args</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">2</span>)
+          <span class="ruby-identifier">client_query_id</span> = <span class="ruby-identifier">args</span>[<span class="ruby-value">2</span>]
+          <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">args</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">3</span>)
+            <span class="ruby-identifier">use_tcp</span> = <span class="ruby-identifier">args</span>[<span class="ruby-value">3</span>]
+          <span class="ruby-keyword kw">end</span>
+        <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">end</span>
+      <span class="ruby-comment cmt">#Are we using EventMachine or native Dnsruby?</span>
+      <span class="ruby-keyword kw">if</span> (<span class="ruby-constant">Resolver</span>.<span class="ruby-identifier">eventmachine?</span>)
+        <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">send_eventmachine</span>(<span class="ruby-identifier">query_packet</span>, <span class="ruby-identifier">msg</span>.<span class="ruby-identifier">header</span>.<span class="ruby-identifier">id</span>, <span class="ruby-identifier">client_query_id</span>, <span class="ruby-identifier">client_queue</span>, <span class="ruby-identifier">use_tcp</span>)
+      <span class="ruby-keyword kw">else</span>
+        <span class="ruby-keyword kw">if</span> (<span class="ruby-operator">!</span><span class="ruby-identifier">client_query_id</span>)
+          <span class="ruby-identifier">client_query_id</span> = <span class="ruby-identifier">msg</span>
+        <span class="ruby-keyword kw">end</span>
+        <span class="ruby-identifier">send_dnsruby</span>(<span class="ruby-identifier">query_packet</span>, <span class="ruby-identifier">msg</span>.<span class="ruby-identifier">header</span>.<span class="ruby-identifier">id</span>, <span class="ruby-identifier">client_query_id</span>, <span class="ruby-identifier">client_queue</span>, <span class="ruby-identifier">use_tcp</span>)
+        <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">client_query_id</span>
+      <span class="ruby-keyword kw">end</span>
+    <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/Dnsruby/SingleResolver.src/M000156.html

@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html>
+<head>
+  <title>check_response (Dnsruby::SingleResolver)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/Dnsruby/SingleResolver.rb, line 340</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">check_response</span>(<span class="ruby-identifier">response</span>, <span class="ruby-identifier">query</span>, <span class="ruby-identifier">client_queue</span>, <span class="ruby-identifier">client_query_id</span>, <span class="ruby-identifier">tcp</span>)
+      <span class="ruby-comment cmt"># @TODO@ Check TSIG!</span>
+      <span class="ruby-identifier">ret</span> = <span class="ruby-keyword kw">true</span>
+      <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">response</span>.<span class="ruby-identifier">header</span>.<span class="ruby-identifier">tc</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-operator">!</span><span class="ruby-identifier">tcp</span>)
+        <span class="ruby-comment cmt"># Try to resend over tcp</span>
+        <span class="ruby-constant">TheLog</span>.<span class="ruby-identifier">debug</span>(<span class="ruby-value str">&quot;Truncated - resending over TCP&quot;</span>)
+        <span class="ruby-identifier">send_async</span>(<span class="ruby-constant">Message</span>.<span class="ruby-identifier">decode</span>(<span class="ruby-identifier">query</span>), <span class="ruby-identifier">client_queue</span>, <span class="ruby-identifier">client_query_id</span>, <span class="ruby-keyword kw">true</span>)
+        <span class="ruby-identifier">ret</span>=<span class="ruby-keyword kw">false</span>
+      <span class="ruby-keyword kw">end</span>
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">ret</span>
+    <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

data/doc/classes/Dnsruby/SingleResolver.src/M000157.html

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html>
+<head>
+  <title>udp_packet_size (Dnsruby::SingleResolver)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre><span class="ruby-comment cmt"># File lib/Dnsruby/SingleResolver.rb, line 400</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">udp_packet_size</span>
+      <span class="ruby-comment cmt"># if @udp_size &gt; DefaultUDPSize then we use EDNS and </span>
+      <span class="ruby-comment cmt"># @udp_size should be taken as the maximum packet_data length</span>
+      <span class="ruby-identifier">ret</span> = (<span class="ruby-ivar">@udp_size</span> <span class="ruby-operator">&gt;</span> <span class="ruby-constant">Resolver</span><span class="ruby-operator">::</span><span class="ruby-constant">DefaultUDPSize</span> <span class="ruby-value">? </span><span class="ruby-ivar">@udp_size</span> <span class="ruby-operator">:</span> <span class="ruby-constant">Resolver</span><span class="ruby-operator">::</span><span class="ruby-constant">DefaultUDPSize</span>) 
+      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">ret</span>
+    <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>