Class: Resolv::DNS::Resource::IN::SRV

Inherits:
Resolv::DNS::Resource show all
Defined in:
lib/rubysl/resolv/resolv.rb

Overview

SRV resource record defined in RFC 2782

These records identify the hostname and port that a service is available at.

Constant Summary collapse

TypeValue = 
33
ClassValue = 
IN::ClassValue

Constants inherited from Resolv::DNS::Resource

ClassHash, ClassInsensitiveTypes

Instance Attribute Summary collapse

Attributes inherited from Resolv::DNS::Resource

#ttl

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Resolv::DNS::Resource

#==, #eql?, get_class, #hash

Constructor Details

#initialize(priority, weight, port, target) ⇒ SRV

Create a SRV resource record.

See the documentation for #priority, #weight, #port and #target for priority, weight, +port and target respectively.



2248
2249
2250
2251
2252
2253
 
# File 'lib/rubysl/resolv/resolv.rb', line 2248

def initialize(priority, weight, port, target)
  @priority = priority.to_int
  @weight = weight.to_int
  @port = port.to_int
  @target = Name.create(target)
end

Instance Attribute Details

#port ⇒ Object (readonly)

The port on this target host of this service.

The range is 0-65535.



2281
2282
2283
 
# File 'lib/rubysl/resolv/resolv.rb', line 2281

def port
  @port
end

#priority ⇒ Object (readonly)

The priority of this target host.

A client MUST attempt to contact the target host with the lowest-numbered priority it can reach; target hosts with the same priority SHOULD be tried in an order defined by the weight field. The range is 0-65535. Note that it is not widely implemented and should be set to zero.



2263
2264
2265
 
# File 'lib/rubysl/resolv/resolv.rb', line 2263

def priority
  @priority
end

#target ⇒ Object (readonly)

The domain name of the target host.

A target of “.” means that the service is decidedly not available at this domain.



2288
2289
2290
 
# File 'lib/rubysl/resolv/resolv.rb', line 2288

def target
  @target
end

#weight ⇒ Object (readonly)

A server selection mechanism.

The weight field specifies a relative weight for entries with the same priority. Larger weights SHOULD be given a proportionately higher probability of being selected. The range of this number is 0-65535. Domain administrators SHOULD use Weight 0 when there isn’t any server selection to do, to make the RR easier to read for humans (less noisy). Note that it is not widely implemented and should be set to zero.



2275
2276
2277
 
# File 'lib/rubysl/resolv/resolv.rb', line 2275

def weight
  @weight
end

Class Method Details

.decode_rdata(msg) ⇒ Object

:nodoc:



2297
2298
2299
2300
2301
2302
2303
 
# File 'lib/rubysl/resolv/resolv.rb', line 2297

def self.decode_rdata(msg) # :nodoc:
  priority, = msg.get_unpack("n")
  weight,   = msg.get_unpack("n")
  port,     = msg.get_unpack("n")
  target    = msg.get_name
  return self.new(priority, weight, port, target)
end

Instance Method Details

#encode_rdata(msg) ⇒ Object

:nodoc:



2290
2291
2292
2293
2294
2295
 
# File 'lib/rubysl/resolv/resolv.rb', line 2290

def encode_rdata(msg) # :nodoc:
  msg.put_pack("n", @priority)
  msg.put_pack("n", @weight)
  msg.put_pack("n", @port)
  msg.put_name(@target)
end