manページ  — RESOLVER

res_init() ルーチンは、設定ファイルを読み込み (設定ファイルが存在する場合。 resolver(5) 参照)、デフォルトドメイン名、検索リスト、ローカルネームサーバの インターネットアドレスを入手します。 サーバが設定されていない場合は、リゾルバを実行しているホストが試されます。 現在のドメイン名は、設定ファイルで指定されていない場合、 ホスト名で定義されますが、環境変数 LOCALDOMAIN で上書きすることもできます。 検索リストをプロセスごとに上書きする場合は、 ブランクで区切られた複数のトークンをこの環境変数に含めます。 これは、設定ファイルの search コマンドに似ています。 別の環境変数 " RES_OPTIONS" を設定すれば、特定の内部リゾルバオプションを上書きできます。 内部リゾルバオプションは、上書きされなければ、 _res 構造体のフィールドを変更することで設定されるか、設定ファイルの options コマンドから継承されます。 " RES_OPTIONS" 環境変数のシンタックスについては、 resolver(5) を参照してください。 通常の場合、初期化は以下のルーチンを初めて呼び出したときに実行されます。

res_query() 関数は、サーバ問い合わせメカニズムのインタフェースを提供するもので、 問い合わせの作成、作成された問い合わせのローカルサーバへの送信、応答の待機、 応答の予備チェックを行います。 問い合わせは、完全な形でのドメイン名 dname に対する、指定された type と class の情報を要求します。 応答メッセージは answer バッファに残され、呼び出し側が指定する anslen の長さになっています。

res_search() ルーチンは、 res_query() と同じように問い合わせの作成と応答の待機を行いますが、それに加えて RES_DEFNAMES と RES_DNSRCH オプションによって制御されるデフォルトと検索規則も実装しています。 このルーチンは最初に成功した応答を返します。

残りのルーチンは、 res_query() が使用する低レベルルーチンです。 res_mkquery() 関数は、標準問い合わせメッセージを作成して buf に配置し、問い合わせのサイズを返します。 問い合わせが buflen より長い場合は -1 を返します。 問い合わせタイプ op は、通常の場合 QUERY ですが、 < arpa/nameser.h> で定義されているどの問い合わせタイプにもできます。 問い合わせのドメイン名は dname で指定します。 newrr は現在使用されていませんが、更新メッセージを作成するためのものです。

res_send() ルーチンは、事前フォーマット済み問い合わせを送信し、応答を返します。 RES_INIT が設定されていない場合は res_init() を呼び出します。 ローカルネームサーバへの問い合わせの送信、およびタイムアウトと 再試行の処理も行います。 応答メッセージの長さを返しますが、エラーがあった場合は -1 を返します。

dn_comp() 関数は、ドメイン名 exp_dn を圧縮し、 comp_dn に保存します。 圧縮された名前のサイズを返しますが、エラーがあった場合は -1 を返します。 comp_dn が指す配列のサイズは length で指定します。 圧縮の際、現在のメッセージでそれまでに圧縮された名前を指すポインタ dnptrs の配列を使用します。 最初のポインタはメッセージの最初を指し、リストは NULL で終わります。配列の制限は lastdnptr で指定します。 dn_comp() の副作用は、名前が圧縮されたときにメッセージに挿入されるラベルのポインタの リストが更新されることです。 dnptr が NULL である場合、名前は圧縮されません。 lastdnptr が NULL である場合、ラベルのリストは更新されません。

dn_expand() エントリは、圧縮されたドメイン名 comp_dn を完全なドメイン名に展開します。 圧縮された名前は、問い合わせもしくは応答メッセージに含まれます。 msg は、メッセージの最初を指すポインタです。 展開された名前は、 exp_dn が示すサイズ length のバッファに配置されます。 圧縮された名前のサイズが返されますが、 エラーがあった場合は -1 が返されます。

RFC1032, RFC1033, RFC1034, RFC1035, RFC974

Name Server Operations Guide for BIND,