Class: Resolv::IPv6

Relationships & Source Files
Inherits:	Object
Defined in:	lib/resolv.rb

Overview

A DNS IPv6 address.

Constant Summary

Regex =

A composite IPv6 address Regexp.

# File 'lib/resolv.rb', line 2426

/
(?:#{Regex_8Hex}) |
(?:#{Regex_CompressedHex}) |
(?:#{Regex_6Hex4Dec}) |
(?:#{Regex_CompressedHex4Dec})/x

Regex_6Hex4Dec =

IPv4 mapped IPv6 address format a:b:c:d:e:f:w.x.y.z

# File 'lib/resolv.rb', line 2409
```
/\A
((?:[0-9A-Fa-f]{1,4}:){6,6})
(\d)\.(\d)\.(\d)\.(\d)
\z/x
```
Regex_8Hex =

IPv6 address format a:b:c:d:e:f:g:h

# File 'lib/resolv.rb', line 2393
```
/\A
(?:[0-9A-Fa-f]{1,4}:){7}
   [0-9A-Fa-f]{1,4}
\z/x
```

Regex_CompressedHex =

Compressed IPv6 address format a::b

# File 'lib/resolv.rb', line 2401

/\A
((?:[0-9A-Fa-f]{1,4}(?::[0-9A-Fa-f]{1,4})*)?) ::
((?:[0-9A-Fa-f]{1,4}(?::[0-9A-Fa-f]{1,4})*)?)
\z/x

Regex_CompressedHex4Dec =

Compressed IPv4 mapped IPv6 address format a::b:w.x.y.z

# File 'lib/resolv.rb', line 2417
```
/\A
((?:[0-9A-Fa-f]{1,4}(?::[0-9A-Fa-f]{1,4})*)?) ::
((?:[0-9A-Fa-f]{1,4}:)*)
(\d)\.(\d)\.(\d)\.(\d)
\z/x
```

Class Method Summary

.create(arg)

Creates a new IPv6 address from arg which may be:

Instance Attribute Summary

#address readonly

The raw IPv6 address as a String.

Instance Method Summary

#to_name

Turns this IPv6 address into a DNS::Name.

Class Method Details

.create(arg)

Creates a new IPv6 address from arg which may be:

IPv6: returns arg.
String: arg must match one of the IPv6::Regex* constants

[ GitHub ]

# File 'lib/resolv.rb', line 2438


def self.create(arg)
  case arg
  when IPv6
    return arg
  when String
    address = ''
    if Regex_8Hex =~ arg
      arg.scan(/[0-9A-Fa-f]+/) {|hex| address << [hex.hex].pack('n')}
    elsif Regex_CompressedHex =~ arg
      prefix = $1
      suffix = $2
      a1 = ''
      a2 = ''
      prefix.scan(/[0-9A-Fa-f]+/) {|hex| a1 << [hex.hex].pack('n')}
      suffix.scan(/[0-9A-Fa-f]+/) {|hex| a2 << [hex.hex].pack('n')}
      omitlen = 16 - a1.length - a2.length
      address << a1 << "\0" * omitlen << a2
    elsif Regex_6Hex4Dec =~ arg
      prefix, a, b, c, d = $1, $2.to_i, $3.to_i, $4.to_i, $5.to_i
      if (0..255) === a && (0..255) === b && (0..255) === c && (0..255) === d
        prefix.scan(/[0-9A-Fa-f]+/) {|hex| address << [hex.hex].pack('n')}
        address << [a, b, c, d].pack('CCCC')
      else
        raise ArgumentError.new("not numeric IPv6 address: " + arg)
      end
    elsif Regex_CompressedHex4Dec =~ arg
      prefix, suffix, a, b, c, d = $1, $2, $3.to_i, $4.to_i, $5.to_i, $6.to_i
      if (0..255) === a && (0..255) === b && (0..255) === c && (0..255) === d
        a1 = ''
        a2 = ''
        prefix.scan(/[0-9A-Fa-f]+/) {|hex| a1 << [hex.hex].pack('n')}
        suffix.scan(/[0-9A-Fa-f]+/) {|hex| a2 << [hex.hex].pack('n')}
        omitlen = 12 - a1.length - a2.length
        address << a1 << "\0" * omitlen << a2 << [a, b, c, d].pack('CCCC')
      else
        raise ArgumentError.new("not numeric IPv6 address: " + arg)
      end
    else
      raise ArgumentError.new("not numeric IPv6 address: " + arg)
    end
    return IPv6.new(address)
  else
    raise ArgumentError.new("cannot interpret as IPv6 address: #{arg.inspect}")
  end
end

Instance Attribute Details

#address (readonly)

The raw IPv6 address as a String.

[ GitHub ]

# File 'lib/resolv.rb', line 2494


attr_reader :address

Instance Method Details

#to_name

Turns this IPv6 address into a DNS::Name.

[ GitHub ]

# File 'lib/resolv.rb', line 2513


def to_name
  return DNS::Name.new(
    @address.unpack("H32")[0].split(//).reverse + ['ip6', 'arpa'])
end