要約
DNSによる名前解決を行うライブラリです。 Ruby で書かれているため thread-aware であり、並列に多くのホスト名を解決することができます。
DNS モジュールを使うことで、さまざまなリソースを直接ルックアップできます。
なお、単にホスト名から IP アドレスを得たいだけであれば、 socket ライブラリの IPSocket.getaddress などが使用できます。
例:
require "resolv"
Resolv.getaddress("www.ruby-lang.org")
Resolv.getname("210.251.121.214").to_s
Resolv::DNS.new.getresources("www.ruby-lang.org", Resolv::DNS::Resource::IN::A).collect {|r| r.address}
Resolv::DNS.new.getresources("ruby-lang.org", Resolv::DNS::Resource::IN::MX).collect {|r| [r.exchange.to_s, r.preference]}
Bugs
NIS はサポートされていません。
クラス
| Resolv | リゾルバを表すクラスです。このクラス自体は実際には名前解決をせず、 Resolv.new で与えられたリゾルバに順に問合せることしかしません。 |
| Resolv::DNS | このクラスは DNS を利用した名前解決をするリゾルバを表します。 |
| Resolv::DNS::Name | ドメイン名を表すクラスです。 |
| Resolv::DNS::Query | DNSクエリを表す抽象クラスです。 |
| Resolv::DNS::Resource | DNSリソースを表す抽象クラスです。 |
| Resolv::DNS::Resource::DomainName | DNSリソースのドメイン名を表す抽象クラスです。 |
| Resolv::DNS::Resource::CNAME | DNS リソースの CNAME レコードを表す抽象クラスです。 |
| Resolv::DNS::Resource::IN::CNAME | DNS リソースのクラス IN、タイプ CNAME に対応するクラスです。 |
| Resolv::DNS::Resource::NS | DNS リソースの NS (正式な(authoritative)ネームサーバ) レコードを表す抽象クラスです。 |
| Resolv::DNS::Resource::IN::NS | DNS リソースのクラス IN、タイプ NS に対応するクラスです。 |
| Resolv::DNS::Resource::PTR | DNS リソースの PTR レコードを表す抽象クラスです。 |
| Resolv::DNS::Resource::IN::PTR | DNS リソースのクラス IN、タイプ PTR に対応するクラスです。 |
| Resolv::DNS::Resource::Generic | 汎用DNSリソース抽象クラスです。 |
| Resolv::DNS::Resource::HINFO | DNS リソースの HINFO レコードを表す抽象クラスです。 |
| Resolv::DNS::Resource::IN::HINFO | DNS リソースのクラス IN、タイプ HINFO に対応するクラスです。 |
| Resolv::DNS::Resource::IN::A | DNS リソースのクラス IN、タイプ A に対応するクラスです。 |
| Resolv::DNS::Resource::IN::AAAA | DNS リソースのクラス IN、タイプ AAAA に対応するクラスです。 |
| Resolv::DNS::Resource::IN::SRV | DNS リソースのクラス IN、タイプ SRV に対応するクラスです。 |
| Resolv::DNS::Resource::IN::WKS | DNS リソースのクラス IN、タイプ WKS に対応するクラスです。 |
| Resolv::DNS::Resource::MINFO | DNS リソースの MINFO レコードを表す抽象クラスです。 |
| Resolv::DNS::Resource::IN::MINFO | DNS リソースのクラス IN、タイプ MINFO に対応するクラスです。 |
| Resolv::DNS::Resource::MX | DNS リソースの MX レコードを表す抽象クラスです。 |
| Resolv::DNS::Resource::IN::MX | DNS リソースのクラス IN、タイプ MX に対応するクラスです。 |
| Resolv::DNS::Resource::SOA | DNS リソースの SOA (Start Of Authority) レコードを表す抽象クラスです。 |
| Resolv::DNS::Resource::IN::SOA | DNS リソースのクラス IN、タイプ SOA に対応するクラスです。 |
| Resolv::DNS::Resource::TXT | DNS リソースの TXT レコードを表す抽象クラスです。 |
| Resolv::DNS::Resource::IN::TXT | DNS リソースのクラス IN、タイプ TXT に対応するクラスです。 |
| Resolv::DNS::Resource::ANY | DNS のすべてのクラスに対するクエリーを表わす抽象クラスです。 |
| Resolv::DNS::Resource::IN::ANY | DNS クエリーのクラス IN、タイプ ANY に対応するクラスです。 |
| Resolv::Hosts | /etc/hosts (Windows であれば %SystemRoot%\System32\drivers\etc\hosts など) を使用するホスト名リゾルバです。 |
| Resolv::IPv4 | IPv4のアドレスを表すクラスです。 |
| Resolv::IPv6 | IPv6 のアドレスを表すクラスです。 |
モジュール
| Resolv::DNS::Resource::IN | DNS のインターネットクラスリソースを表すモジュールです。 |
例外クラス
| Resolv::DNS::DecodeError | DNSメッセージのデコードに失敗したときに発生する例外のクラスです。 |
| Resolv::DNS::EncodeError | DNSメッセージのエンコードに失敗したときに発生する例外のクラスです。 |
| Resolv::DNS::Requester::RequestError | DNS サーバへのリクエストに失敗した場合に発生する例外のクラスです。 |
| Resolv::ResolvError | 名前解決に失敗したときに発生する例外のクラスです。 |
| Resolv::DNS::Config::OtherResolvError | DNS サーバからの応答がエラーであった場合に発生する例外です。 |