Class: Dnsruby::Config

Create a new Config with system default values

    # File lib/Dnsruby/Config.rb, line 84
84:     def initialize()
85:       @mutex = Mutex.new
86:       @configured = false
87:       #      parse_config

88:     end

reset()

Reset the config to default values

[Source]

    # File lib/Dnsruby/Config.rb, line 90
90:     def Config.reset
91:       c = Config.new
92:       @configured = false
93:       #      c.parse_config

94:     end

add_nameserver(ns)

Add a nameserver to the list of nameservers.

Can take either a single String or an array of Strings. The new nameservers are added at a higher priority.

[Source]

     # File lib/Dnsruby/Config.rb, line 217
217:     def add_nameserver(ns)
218:       @configured = true
219:       if (ns.kind_of?String) 
220:         ns=[ns]
221:       end
222:       check_ns(ns)
223:       ns.reverse_each do |n|
224:         if (!@nameserver.include?(n))
225:           self.nameserver=[n]+@nameserver
226:         end
227:       end
228:     end

domain()

Return the default domain

[Source]

     # File lib/Dnsruby/Config.rb, line 399
399:     def domain
400:       if (!@configured)
401:         parse_config
402:       end
403:       if (@domain==nil)
404:         return nil
405:       end
406:       return Name.create(@domain).to_s
407:     end

domain=(dom)

Set the default domain

[Source]

     # File lib/Dnsruby/Config.rb, line 141
141:     def domain=(dom)
142:       #      @configured = true

143:       if (dom)
144:         if !dom.kind_of?(String)
145:           raise ArgumentError.new("invalid domain config: #{@domain.inspect}")
146:         end
147:         @domain = Name::split(dom)
148:       else
149:         @domain=nil
150:       end
151:     end

get_ready()

[Source]

     # File lib/Dnsruby/Config.rb, line 417
417:     def get_ready
418:       if (!@configured)
419:         parse_config
420:       end
421:     end

nameserver()

The list of nameservers to query

[Source]

    # File lib/Dnsruby/Config.rb, line 49
49:     def nameserver
50:       if (!@configured)
51:         parse_config
52:       end
53:       return @nameserver
54:     end

nameserver=(ns)

Set the config to point to a single nameserver

[Source]

     # File lib/Dnsruby/Config.rb, line 231
231:     def nameserver=(ns)
232:       @configured = true
233:       check_ns(ns)
234:       #      @nameserver = ['0.0.0.0'] if (@nameserver.class != Array || @nameserver.empty?)

235:       # Now go through and ensure that all ns point to IP addresses, not domain names

236:       @nameserver=ns
237:       Dnsruby.log.debug{"Nameservers = #{@nameserver.join(", ")}"}
238:     end

ndots()

The minimum number of labels in the query name (if it is not absolute) before it is considered complete

[Source]

    # File lib/Dnsruby/Config.rb, line 60
60:     def ndots
61:       if (!@configured)
62:         parse_config
63:       end
64:       return @ndots
65:     end

ndots=(nd)

Set ndots

[Source]

     # File lib/Dnsruby/Config.rb, line 154
154:     def ndots=(nd)
155:       @configured = true
156:       @ndots=nd
157:       if !@ndots.kind_of?(Integer)
158:         raise ArgumentError.new("invalid ndots config: #{@ndots.inspect}")
159:       end
160:     end

search()

Return the search path

[Source]

     # File lib/Dnsruby/Config.rb, line 387
387:     def search
388:       if (!@configured)
389:         parse_config
390:       end
391:       search = []
392:       @search.each do |s|
393:         search.push(Name.new(s).to_s)
394:       end
395:       return search
396:     end

search=(s)

Set the default search path

[Source]

     # File lib/Dnsruby/Config.rb, line 163
163:     def search=(s)
164:       @configured = true
165:       @search=s
166:       if @search
167:         if @search.class == Array
168:           @search = @search.map {|arg| Name::split(arg) }
169:         else
170:           raise ArgumentError.new("invalid search config: search must be an array!")
171:         end
172:       else
173:         hostname = Socket.gethostname
174:         if /\./ =~ hostname
175:           @search = [Name.split($')]
176:         else
177:           @search = [[]]
178:         end
179:       end
180:       
181:       if !@search.kind_of?(Array) ||
182:           #              !@search.all? {|ls| ls.all? {|l| Label::Str === l } }

183:         !@search.all? {|ls| ls.all? {|l| Name::Label === l } }
184:         raise ArgumentError.new("invalid search config: #{@search.inspect}")
185:       end
186:     end

set_config_info(config_info)

Set the config. Parameter can be :

A String containing the name of the config file to load
```
     e.g. /etc/resolv.conf
```

A hash with the following elements :

     nameserver (String)
     domain (String)
     search (String)
     ndots (Fixnum)

This method should not normally be called by client code.

[Source]

    # File lib/Dnsruby/Config.rb, line 79
79:     def set_config_info(config_info)
80:       parse_config(config_info)
81:     end

to_s()

[Source]

     # File lib/Dnsruby/Config.rb, line 344
344:     def to_s
345:       if (!@configured)
346:         parse_config
347:       end
348:       ret = "Config - nameservers : "
349:       @nameserver.each {|n| ret += n.to_s + ", "}
350:       domain_string="empty"
351:       if (@domain!=nil)
352:         domain_string=@domain.to_s
353:       end
354:       ret += " domain : #{domain_string}, search : "
355:       search.each {|s| ret += s + ", " }
356:       ret += " ndots : #{@ndots}"
357:       return ret
358:     end

apply_domain	[RW]	Should the default domain be applied?
apply_search_list	[RW]	Should the search list be applied?

Description

Methods

Attributes

Public Class methods

Public Instance methods