名称

realhostname — IP 番号を実際のホスト名に変換する

ライブラリ

System Utilities Library (libutil, -lutil)

書式

#include < libutil.h>

int
realhostname( char *host, size_t hsize, const struct in_addr *ip);

解説

関数 realhostname() は、 ip を対応するホスト名に変換します。これは、 ip をホスト名へ還元 (解決) し、次にホスト名を ip に還元 (解決) を戻して保証することにより行なわれます。

host は、少なくとも hsize バイトのバッファを指さなければなりません。そして、この関数によって常に書き込まれます。

名前解決の両方の方法が働かないか、ホスト名が hsize バイトより長い場合、 inet_ntoa(3) は、 ip を ASCII 形式に変換するために使用されます。

host に書き込まれた文字列が hsize バイト長である場合、 host は、ヌル文字で終了しません。

戻り値

realhostname() 関数は、 < libutil.h> に定義される次の定数のうちの 1 つを返します:

HOSTNAME_FOUND

有効なホスト名が見つかりました。

HOSTNAME_INCORRECTNAME

ホスト名が見つかりました。しかし、それは渡された ip を還元 (解決) を戻せませんでした。 host は、現在、 ip の数値の値を含んでいます。

HOSTNAME_INVALIDADDR

ip を還元 (解決) することができません。 host は、現在、 ip の数値の値を含んでいます。

HOSTNAME_INVALIDNAME

ホスト名が見つかりました。しかし、任意の ip 番号にそれを還元 (解決) することができません。 host は、現在、 ip の数値の値を含んでいます。

関連項目

gethostbyaddr(3), gethostbyname(3), inet_ntoa(3), realhostname_sa(3)