Class | Dnsruby::ZoneTransfer |
In: |
lib/Dnsruby/zone_transfer.rb
|
Parent: | Object |
This class performs zone transfers as per RFC1034 (AXFR) and RFC1995 (IXFR).
klass | [RW] | The class - defaults to IN |
last_tsigstate | [R] | Returns the tsigstate of the last transfer (nil if no TSIG signed transfer has occurred) |
port | [RW] | The port to connect to - defaults to 53 |
serial | [RW] | If using IXFR, this is the SOA serial number to start the incrementals from |
server | [RW] | The nameserver to use for the zone transfer - defaults to system config |
transfer_type | [RW] | What type of transfer to do (IXFR or AXFR) - defaults to AXFR |
tsig | [R] | The TSIG record used to sign the transfer |
# File lib/Dnsruby/zone_transfer.rb, line 46 46: def initialize 47: @server=Config.new.nameserver[0] 48: @transfer_type = Types.AXFR 49: @klass=Classes.IN 50: @port=53 51: @serial=0 52: @tsig = nil 53: @axfr = nil 54: end
Perform a zone transfer (RFC1995) If an IXFR query is unsuccessful, then AXFR is tried (and @transfer_type is set to AXFR) TCP is used as the only transport
If AXFR is performed, then the zone will be returned as a set of records :
zt = Dnsruby::ZoneTransfer.new zt.transfer_type = Dnsruby::Types.AXFR zt.server = "ns0.validation-test-servers.nominet.org.uk" zone = zt.transfer("validation-test-servers.nominet.org.uk") soa = zone[0] rec1 = zone[1] print zone.to_s
If IXFR is performed, then the incrementals will be returned as a set of Deltas. Each Delta contains the start and end SOA serial number, as well as an array of adds and deletes that occurred between the start and end.
zt = Dnsruby::ZoneTransfer.new zt.transfer_type = Dnsruby::Types.IXFR zt.server = "ns0.validation-test-servers.nominet.org.uk" zt.serial = 2007090401 deltas = zt.transfer("validation-test-servers.nominet.org.uk") assert_equal("Should show up in transfer", deltas[0].adds[1].data)
# File lib/Dnsruby/zone_transfer.rb, line 82 82: def transfer(zone) 83: servers = @server 84: if (servers.class == String) 85: servers=[servers] 86: end 87: xfr = nil 88: exception = nil 89: servers.each do |server| 90: begin 91: server=Config.resolve_server(server) 92: xfr = do_transfer(zone, server) 93: break 94: rescue Exception => exception 95: end 96: end 97: if (xfr == nil && exception != nil) 98: raise exception 99: end 100: return xfr 101: end
Sets the TSIG to sign the zone transfer with. Pass in either a Dnsruby::RR::TSIG, or a key_name and key (or just a key) Pass in nil to stop tsig signing.
# File lib/Dnsruby/zone_transfer.rb, line 41 41: def tsig=(*args) 42: @tsig = SingleResolver.get_tsig(args) 43: end