rubydns 0.6.0 → 2.0.0

data/{test/examples → examples}/fortune-dns.rb

@@ -2,17 +2,17 @@
 # encoding: utf-8
 
 # Copyright, 2009, 2012, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
+#
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
 # in the Software without restriction, including without limitation the rights
 # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 # copies of the Software, and to permit persons to whom the Software is
 # furnished to do so, subject to the following conditions:
-# 
+#
 # The above copyright notice and this permission notice shall be included in
 # all copies or substantial portions of the Software.
-# 
+#
 # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
@@ -21,90 +21,86 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 # THE SOFTWARE.
 
-require 'rubygems'
-
-require 'rexec'
-require 'rexec/daemon'
-
-require 'rubygems'
+require 'process/daemon'
+require 'process/daemon/privileges'
 
 require 'rubydns'
 require 'rubydns/extensions/string'
 
 require 'digest/md5'
 
-# You might need to change the user name "daemon". This can be a user name or a user id.
-RUN_AS = "daemon"
+# You might need to change the user name "daemon". This can be a user name
+# or a user id.
+RUN_AS = 'daemon'
 
-if RExec.current_user != "root"
-	$stderr.puts "Sorry, this command needs to be run as root!"
+if Process::Daemon::Privileges.current_user != 'root'
+	$stderr.puts 'Sorry, this command needs to be run as root!'
 	exit 1
 end
 
-# To use, start the daemon and try:
-# dig @localhost fortune CNAME
-class FortuneDNS < RExec::Daemon::Base
-	@@base_directory = File.dirname(__FILE__)
-
+# A DNS server that allows a client to generate fortunes and fetch them with
+# subsequent requests.  The server 'remembers' the fortunes it generates,
+# and can serve them to future requests.
+class FortuneDNS < Process::Daemon
 	Name = Resolv::DNS::Name
 	IN = Resolv::DNS::Resource::IN
 
-	def self.run
-		# Don't buffer output (for debug purposes)
-		$stderr.sync = true
-		
+	def startup
 		cache = {}
-		stats = {:requested => 0}
-		
+		stats = { requested: 0 }
+
 		# Start the RubyDNS server
-		RubyDNS::run_server do
+		RubyDNS.run_server do
 			on(:start) do
-				RExec.change_user(RUN_AS)
-				if ARGV.include?("--debug")
+				Process::Daemon::Privileges.change_user(RUN_AS)
+
+				if ARGV.include?('--debug')
 					@logger.level = Logger::DEBUG
+					$stderr.sync = true
 				else
 					@logger.level = Logger::WARN
 				end
 			end
-			
+
+			match(/short\.fortune/, IN::TXT) do |transaction|
+				fortune = `fortune -s`.gsub(/\s+/, ' ').strip
+
+				transaction.respond!(*fortune.chunked, ttl: 0)
+			end
+
 			match(/stats\.fortune/, IN::TXT) do |transaction|
 				$stderr.puts "Sending stats: #{stats.inspect}"
 				transaction.respond!(stats.inspect)
 			end
-			
-			match(/(.+)\.fortune/, IN::TXT) do |transaction|
+
+			match(/([a-f0-9]*)\.fortune/, IN::TXT) do |transaction, match|
 				fortune = cache[match[1]]
 				stats[:requested] += 1
-				
+
 				if fortune
 					transaction.respond!(*fortune.chunked)
 				else
-					transaction.failure!(:NXDomain)
+					transaction.fail!(:NXDomain)
 				end
 			end
-			
+
 			match(/fortune/, [IN::CNAME, IN::TXT]) do |transaction|
-				fortune = `fortune`.gsub(/\s+/, " ").strip
+				fortune = `fortune`.gsub(/\s+/, ' ').strip
 				checksum = Digest::MD5.hexdigest(fortune)
 				cache[checksum] = fortune
-				
-				transaction.respond!("Text Size: #{fortune.size} Byte Size: #{fortune.bytesize}", :resource_class => IN::TXT, :ttl => 0)
-				transaction.respond!(Name.create(checksum + ".fortune"), :resource_class => IN::CNAME, :ttl => 0)
-			end
-			
-			match(/short.fortune/, IN::TXT) do |match, transation|
-				fortune = `fortune -s`.gsub(/\s+/, " ").strip
-				
-				transaction.respond!(*fortune.chunked, :ttl => 0)
+
+				answer_txt = "Text Size: #{fortune.size} Byte Size: #{fortune.bytesize}"
+				transaction.respond!(answer_txt, resource_class: IN::TXT, ttl: 0)
+				answer_cname = Name.create(checksum + '.fortune')
+				transaction.respond!(answer_cname, resource_class: IN::CNAME, ttl: 0)
 			end
-			
+
 			# Default DNS handler
 			otherwise do |transaction|
-				transaction.failure!(:NXDomain)
+				transaction.fail!(:NXDomain)
 			end
 		end
 	end
 end
 
-# RExec daemon runner
 FortuneDNS.daemonize

data/examples/geoip-dns.rb

@@ -0,0 +1,115 @@
+#!/usr/bin/env ruby
+
+# Copyright, 2009, 2012, by Samuel G. D. Williams. <http://www.codeotaku.com>
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require 'geoip'
+
+require 'process/daemon'
+
+require 'rubydns'
+require 'rubydns/system'
+
+INTERFACES = [
+	[:udp, '0.0.0.0', 5300]
+]
+
+# Path to the GeoIP file downloaded from
+# http://geolite.maxmind.com/download/geoip/database/GeoLiteCountry/GeoIP.dat.gz
+# If you have renamed the ungzipped file, or have placed it somewhere other than
+# the repository root directory you will need to update this path.
+PATH_TO_GEOIP_DAT_FILE =
+	File.expand_path('../GeoIP.dat', File.dirname(__FILE__))
+
+# A sample DNS daemon that demonstrates how to use RubyDNS to build responses
+# that vary based on the geolocation of the requesting peer.  Clients of
+# this server who request A records will get an answer IP address based
+# on the continent of the client IP address.
+#
+# Please note that use of this example requires that the peer have a public
+# IP address.  IP addresses on private networks or the localhost IP (127.0.0.1)
+# cannot be resolved to a location, and so will always yield the unknown result.
+# This daemon requires the file downloaded from
+# http://geolite.maxmind.com/download/geoip/database/GeoLiteCountry/GeoIP.dat.gz
+# For more information, please see http://www.maxmind.com/en/geolite and
+# http://geoip.rubyforge.org
+class GeoIPDNS < Process::Daemon
+	GEO = GeoIP.new(PATH_TO_GEOIP_DAT_FILE)
+
+	Name = Resolv::DNS::Name
+	IN = Resolv::DNS::Resource::IN
+
+	def startup
+		RubyDNS.run_server(INTERFACES) do
+			fallback_resolver_supervisor = RubyDNS::Resolver.supervise(RubyDNS::System.nameservers)
+			
+			match(//, IN::A) do |transaction|
+				logger.debug 'In block'
+
+				# The IP Address of the peer is stored in the transaction options
+				# with the key :remote_address
+				ip_address = transaction.options[:remote_address].ip_address
+				logger.debug "Looking up geographic information for peer #{ip_address}"
+				location = GeoIPDNS.ip_to_location(ip_address)
+
+				if location
+					logger.debug "Found location #{location} for #{ip_address}"
+				else
+					logger.debug "Could not resolve location for #{ip_address}"
+				end
+
+				code = location ? location.continent_code : nil
+				answer = GeoIPDNS.answer_for_continent_code(code)
+				logger.debug "Answer is #{answer}"
+				transaction.respond!(answer)
+			end
+
+			# Default DNS handler
+			otherwise do |transaction|
+				logger.debug 'In otherwise'
+				transaction.passthrough!(fallback_resolver_supervisor.actors.first)
+			end
+		end
+	end
+
+	# Maps each continent code to a fixed IP address for the response.
+	# A simple mapper to demonstrate the behavior.
+	def self.answer_for_continent_code(code)
+		case code
+		when 'AF' then '1.1.1.1'
+		when 'AN' then '1.1.2.1'
+		when 'AS' then '1.1.3.1'
+		when 'EU' then '1.1.4.1'
+		when 'NA' then '1.1.5.1'
+		when 'OC' then '1.1.6.1'
+		when 'SA' then '1.1.7.1'
+		else '1.1.8.1'
+		end
+	end
+
+	# Finds the continent code for the specified IP address.
+	# Returns nil if the IP address cannot be mapped to a location.
+	def self.ip_to_location(ip_address)
+		return nil unless ip_address
+		GEO.country(ip_address)
+	end
+end
+
+GeoIPDNS.daemonize

data/examples/simple.rb

@@ -0,0 +1,25 @@
+#!/usr/bin/env ruby
+require 'rubydns'
+
+INTERFACES = [
+	[:udp, '0.0.0.0', 5300],
+	[:tcp, '0.0.0.0', 5300]
+]
+
+Name = Resolv::DNS::Name
+IN = Resolv::DNS::Resource::IN
+
+# Use upstream DNS for name resolution.
+UPSTREAM = RubyDNS::Resolver.new([[:udp, '8.8.8.8', 53], [:tcp, '8.8.8.8', 53]])
+
+# Start the RubyDNS server
+RubyDNS.run_server(INTERFACES) do
+	match(/test.mydomain.org/, IN::A) do |transaction|
+			transaction.respond!('10.0.0.80')
+	end
+
+	# Default DNS handler
+	otherwise do |transaction|
+			transaction.passthrough!(UPSTREAM)
+	 end
+end

data/{test/examples → examples}/soa-dns.rb

@@ -1,17 +1,17 @@
 #!/usr/bin/env ruby
 
 # Copyright, 2009, 2012, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
+#
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
 # in the Software without restriction, including without limitation the rights
 # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 # copies of the Software, and to permit persons to whom the Software is
 # furnished to do so, subject to the following conditions:
-# 
+#
 # The above copyright notice and this permission notice shall be included in
 # all copies or substantial portions of the Software.
-# 
+#
 # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
@@ -27,56 +27,56 @@ $R = Resolv::DNS.new
 Name = Resolv::DNS::Name
 IN = Resolv::DNS::Resource::IN
 
-RubyDNS::run_server(:listen => [[:udp, "0.0.0.0", 5400]]) do
+RubyDNS.run_server([[:udp, '0.0.0.0', 5400]]) do
 	# SOA Record
-	#   dig @localhost -p 5300 SOA mydomain.org
-	match("mydomain.org", IN::SOA) do |transaction|
+	#   dig @localhost -p 5400 SOA mydomain.org
+	match('mydomain.org', IN::SOA) do |transaction|
 		#
 		# For more details about these headers please see:
 		#   http://www.ripe.net/ripe/docs/ripe-203.html
 		#
 		
 		transaction.respond!(
-			Name.create("ns.mydomain.org."),    # Master Name
-			Name.create("admin.mydomain.org."), # Responsible Name
+			Name.create('ns.mydomain.org.'),    # Master Name
+			Name.create('admin.mydomain.org.'), # Responsible Name
 			File.mtime(__FILE__).to_i,          # Serial Number
 			1200,                               # Refresh Time
 			900,                                # Retry Time
-			3600000,                            # Maximum TTL / Expiry Time
-			172800                              # Minimum TTL
+			3_600_000,                          # Maximum TTL / Expiry Time
+			172_800                             # Minimum TTL
 		)
 		
-		transaction.append_query!(transaction.question, IN::NS, :section => :authority)
+		transaction.append!(transaction.question, IN::NS, section: :authority)
 	end
-	
+
 	# Default NS record
-	#   dig @localhost -p 5300 mydomain.org NS
-	match("mydomain.org", IN::NS) do |transaction|
-		transaction.respond!(Name.create("ns.mydomain.org."))
+	#   dig @localhost -p 5400 mydomain.org NS
+	match('mydomain.org', IN::NS) do |transaction|
+		transaction.respond!(Name.create('ns.mydomain.org.'))
 	end
 
 	# For this exact address record, return an IP address
-	#   dig @localhost -p 5300 CNAME bob.mydomain.org
+	#   dig @localhost -p 5400 CNAME bob.mydomain.org
 	match(/([^.]+).mydomain.org/, IN::CNAME) do |transaction|
-		transaction.respond!(Name.create("www.mydomain.org"))
-		transaction.append_query!("www.mydomain.org", IN::A)
+		transaction.respond!(Name.create('www.mydomain.org'))
+		transaction.append!('www.mydomain.org', IN::A)
 	end
 
-	match("80.0.0.10.in-addr.arpa", IN::PTR) do |transaction|
-		transaction.respond!(Name.create("www.mydomain.org."))
+	match('80.0.0.10.in-addr.arpa', IN::PTR) do |transaction|
+		transaction.respond!(Name.create('www.mydomain.org.'))
 	end
 
-	match("www.mydomain.org", IN::A) do |transaction|
-		transaction.respond!("10.0.0.80")
+	match('www.mydomain.org', IN::A) do |transaction|
+		transaction.respond!('10.0.0.80')
 	end
-	
-	match("ns.mydomain.org", IN::A) do |transaction|
-		transaction.respond!("10.0.0.10")
+
+	match('ns.mydomain.org', IN::A) do |transaction|
+		transaction.respond!('10.0.0.10')
 	end
-	
+
 	# Default DNS handler
 	otherwise do |transaction|
 		# Non-Existant Domain
-		transaction.failure!(:NXDomain)
+		transaction.fail!(:NXDomain)
 	end
 end

data/{test/examples → examples}/test-dns-1.rb

@@ -1,17 +1,17 @@
 #!/usr/bin/env ruby
 
 # Copyright, 2009, 2012, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
+#
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
 # in the Software without restriction, including without limitation the rights
 # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 # copies of the Software, and to permit persons to whom the Software is
 # furnished to do so, subject to the following conditions:
-# 
+#
 # The above copyright notice and this permission notice shall be included in
 # all copies or substantial portions of the Software.
-# 
+#
 # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
@@ -27,42 +27,48 @@ require 'rubydns/system'
 # You can specify other DNS servers easily
 # $R = Resolv::DNS.new(:nameserver => ["xx.xx.1.1", "xx.xx.2.2"])
 
-R = RubyDNS::Resolver.new(RubyDNS::System::nameservers)
+R = RubyDNS::Resolver.new(RubyDNS::System.nameservers)
 Name = Resolv::DNS::Name
 IN = Resolv::DNS::Resource::IN
+INTERFACES = [
+	[:udp, '0.0.0.0', 5300],
+	[:tcp, '0.0.0.0', 5300],
+	# [:udp, '::0', 5300],
+	# [:tcp, '::0', 5300],
+]
 
-RubyDNS::run_server do
+RubyDNS.run_server(INTERFACES) do
 	# % dig +nocmd +noall +answer @localhost ANY dev.mydomain.org
 	# dev.mydomain.org.	16000	IN	A	10.0.0.80
 	# dev.mydomain.org.	16000	IN	MX	10 mail.mydomain.org.
 	match(/dev.mydomain.org/, IN::ANY) do |transaction|
 		transaction.append_question!
-		
+
 		[IN::A, IN::CNAME, IN::MX].each do |resource_class|
 			logger.debug "Appending query for #{resource_class}..."
-			transaction.append_query!(transaction.name, resource_class)
+			transaction.append!(transaction.name, resource_class)
 		end
 	end
-	
+
 	# For this exact address record, return an IP address
-	match("dev.mydomain.org", IN::A) do |transaction|
-		transaction.respond!("10.0.0.80")
+	match('dev.mydomain.org', IN::A) do |transaction|
+		transaction.respond!('10.0.0.80')
 	end
 
-	match("80.0.0.10.in-addr.arpa", IN::PTR) do |transaction|
-		transaction.respond!(Name.create("dev.mydomain.org."))
+	match('80.0.0.10.in-addr.arpa', IN::PTR) do |transaction|
+		transaction.respond!(Name.create('dev.mydomain.org.'))
 	end
 
-	match("dev.mydomain.org", IN::MX) do |transaction|
-		transaction.respond!(10, Name.create("mail.mydomain.org."))
+	match('dev.mydomain.org', IN::MX) do |transaction|
+		transaction.respond!(10, Name.create('mail.mydomain.org.'))
 	end
-	
+
 	match(/^test([0-9]+).mydomain.org$/, IN::A) do |transaction, match_data|
 		offset = match_data[1].to_i
-		
+
 		if offset > 0 && offset < 10
-			logger.info "Responding with address #{"10.0.0." + (90 + offset).to_s}..."
-			transaction.respond!("10.0.0." + (90 + offset).to_s)
+			logger.info "Responding with address #{'10.0.0.' + (90 + offset).to_s}..."
+			transaction.respond!('10.0.0.' + (90 + offset).to_s)
 		else
 			logger.info "Address out of range: #{offset}!"
 			false
@@ -71,7 +77,7 @@ RubyDNS::run_server do
 
 	# Default DNS handler
 	otherwise do |transaction|
-		logger.info "Passing DNS request upstream..."
+		logger.info 'Passing DNS request upstream...'
 		transaction.passthrough!(R)
-	end
+	 end
 end

data/{test/examples → examples}/test-dns-2.rb

@@ -1,17 +1,17 @@
 #!/usr/bin/env ruby
 
 # Copyright, 2009, 2012, by Samuel G. D. Williams. <http://www.codeotaku.com>
-# 
+#
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
 # in the Software without restriction, including without limitation the rights
 # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 # copies of the Software, and to permit persons to whom the Software is
 # furnished to do so, subject to the following conditions:
-# 
+#
 # The above copyright notice and this permission notice shall be included in
 # all copies or substantial portions of the Software.
-# 
+#
 # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
@@ -20,10 +20,8 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 # THE SOFTWARE.
 
-require 'rubygems'
-require 'rexec'
-require 'rexec/daemon'
 require 'rubydns'
+require 'process-daemon'
 
 # To run this command, use the standard daemon syntax as root
 # ./daemon2.rb start
@@ -37,39 +35,39 @@ require 'rubydns'
 # dig +tcp @localhost test.mydomain.org
 
 # You might need to change the user name "daemon". This can be a user name or a user id.
-RUN_AS = "daemon"
+RUN_AS = 'daemon'
 
 INTERFACES = [
-	[:udp, "0.0.0.0", 53],
-	[:tcp, "0.0.0.0", 53]
+	[:udp, '0.0.0.0', 53],
+	[:tcp, '0.0.0.0', 53]
 ]
 
 # We need to be root in order to bind to privileged port
-if RExec.current_user != "root"
-	$stderr.puts "Sorry, this command needs to be run as root!"
-	exit 1
+if RExec.current_user != 'root'
+	 $stderr.puts 'Sorry, this command needs to be run as root!'
+	 exit 1
 end
 
 # The Daemon itself
-class Server < RExec::Daemon::Base
+class Server < Process::Daemon
 	Name = Resolv::DNS::Name
 	IN = Resolv::DNS::Resource::IN
 
 	# Use upstream DNS for name resolution.
-	UPSTREAM = RubyDNS::Resolver.new([[:udp, "8.8.8.8", 53], [:tcp, "8.8.8.8", 53]])
+	UPSTREAM = RubyDNS::Resolver.new([[:udp, '8.8.8.8', 53], [:tcp, '8.8.8.8', 53]])
 
-	def self.run
+	def startup
 		# Don't buffer output (for debug purposes)
 		$stderr.sync = true
-		
+
 		# Start the RubyDNS server
-		RubyDNS::run_server(:listen => INTERFACES) do
+		RubyDNS.run_server(INTERFACES) do
 			on(:start) do
 				RExec.change_user(RUN_AS)
 			end
 
-			match("test.mydomain.org", IN::A) do |transaction|
-				transaction.respond!("10.0.0.80")
+			match('test.mydomain.org', IN::A) do |transaction|
+				transaction.respond!('10.0.0.80')
 			end
 
 			# Default DNS handler

data/examples/wikipedia-dns.rb

@@ -0,0 +1,107 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+
+# Copyright, 2009, 2012, by Samuel G. D. Williams. <http://www.codeotaku.com>
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require 'rubydns'
+
+require 'process/daemon'
+require 'process/daemon/privileges'
+
+require 'cgi'
+require 'nokogiri'
+require 'json'
+
+require 'digest/md5'
+
+require 'http'
+
+# You might need to change the user name "daemon". This can be a user name
+# or a user id.
+RUN_AS = 'daemon'
+
+if Process::Daemon::Privileges.current_user != 'root'
+	$stderr.puts 'Sorry, this command needs to be run as root!'
+	exit 1
+end
+
+# Encapsulates the logic for fetching information from Wikipedia.
+module Wikipedia
+	def self.summary_url(title)
+		"http://en.wikipedia.org/w/api.php?action=parse&page=#{CGI.escape title}&prop=text&section=0&format=json"
+	end
+
+	def self.extract_summary(json_text)
+		document = JSON.parse(json_text)
+		return Nokogiri::HTML(document['parse']['text']['*']).css('p')[0].text
+	rescue
+		return 'Invalid Article.'
+	end
+end
+
+# A DNS server that queries Wikipedia and returns summaries for
+# specifically crafted queries.
+class WikipediaDNS < Process::Daemon
+	Name = Resolv::DNS::Name
+	IN = Resolv::DNS::Resource::IN
+
+	def startup
+		# Don't buffer output (for debug purposes)
+		$stderr.sync = true
+
+		stats = { requested: 0 }
+
+		# Start the RubyDNS server
+		RubyDNS.run_server do
+			on(:start) do
+				Process::Daemon::Privileges.change_user(RUN_AS)
+				if ARGV.include?('--debug')
+					@logger.level = Logger::DEBUG
+				else
+					@logger.level = Logger::WARN
+				end
+			end
+
+			match(/stats\.wikipedia/, IN::TXT) do |transaction|
+				transaction.respond!(*stats.inspect.chunked)
+			end
+
+			match(/(.+)\.wikipedia/, IN::TXT) do |transaction, match_data|
+				title = match_data[1]
+				stats[:requested] += 1
+
+				url = Wikipedia.summary_url(title)
+				response = HTTP.get(url) # socket_class: ... is not yet supported.
+
+				summary =
+					Wikipedia.extract_summary(response).force_encoding('ASCII-8BIT')
+				transaction.respond!(*summary.chunked)
+			end
+
+			# Default DNS handler
+			otherwise do |transaction|
+				transaction.fail!(:NXDomain)
+			end
+		end
+	end
+end
+
+WikipediaDNS.daemonize