res_mkquery() - ドメイン・ネーム・サーバー用のリゾルバー照会の作成

標準

標準/拡張機能 C/C++ 依存項目

BSD 4.3

両方 OS/390 V2R8

形式

#define _XOPEN_SOURCE_EXTENDED 1
#include <sys/types.h>
#include <netinet/in.h>
#include <arpa/nameser.h>
#include <resolv.h>

int res_mkquery(int op, const char *dname, int class, int type, const u_char *data,
                int datalen, const u_char *newrr_in, u_char *buf, int buflen);

機能説明

このルーチンは、インターネット・ドメイン・ネーム・サーバー (DNS) で、照会および応答メッセージの作成、送信、および解釈に使用される幾つかの関数の 1 つです。

res_mkquery() 関数は、標準照会メッセージを構成し、buf に置きます。この関数は、照会のサイズを戻しますが、照会が buflen より大きい場合は、-1 を戻します。照会タイプ op は、通常は QUERY ですが、<arpa/nameser.h> に定義されている照会タイプならどれでも指定できます。照会のドメイン・ネームは、dname に指定されます。引数 newrr_in は、現在は使用されていませんが、更新メッセージの作成のために使用される予定です。

注: res_mkquery() 関数は、拡張 ASCII の拡張機能のレベルに依存します。詳細は、拡張 ASCII サポートを参照してください。

戻り値

正常に終了した場合、res_mkquery() は照会のサイズを戻します。

正常に実行されなかった場合、res_mkquery() は -1 を戻します。応答が buf バッファーに提供された場合、<arpa/nameser.h> に定義されたエラーは、buf.rcode に入れられます。

関連情報