REALHOSTNAME_SA(3) | FreeBSD Library Functions Manual | REALHOSTNAME_SA(3) |
名称
realhostname_sa — struct sockaddr を実際のホスト名に変換するライブラリ
System Utilities Library (libutil, -lutil)書式
#include < sys/types.h>#include < netinet/in.h>
#include < libutil.h>
int
realhostname_sa( char *host, size_t hsize, struct sockaddr *addr, int addrlen);
解説
関数 realhostname_sa() は、 addr を対応するホスト名に変換します。これは、 addr をホスト名へ還元 (解決) し、次にホスト名を addr に還元 (解決) を戻して保証することにより行なわれます。host は、少なくとも hsize バイトのバッファを指さなければなりません。そして、この関数によって常に書き込まれます。
名前解決の両方の方法が働かないか、ホスト名が hsize バイトより長い場合、指定された NI_NUMERICHOST での getnameinfo(3) は、 addr を ASCII 形式に変換するために使用されます。
host に書き込まれた文字列が hsize バイト長である場合、 host は、ヌル文字で終了しません。
戻り値
realhostname_sa() 関数は、 < libutil.h> に定義される次の定数のうちの 1 つを返します:-
HOSTNAME_FOUND
- 有効なホスト名が見つかりました。
-
HOSTNAME_INCORRECTNAME
- ホスト名が見つかりました。しかし、それは渡された ip を還元 (解決) を戻せませんでした。 host は、現在、 ip の数値の値を含んでいます。
-
HOSTNAME_INVALIDADDR
- ip を還元 (解決) することができません。 host は、現在、 ip の数値の値を含んでいます。
-
HOSTNAME_INVALIDNAME
- ホスト名が見つかりました。しかし、任意の ip 番号にそれを還元 (解決) することができません。 host は、現在、 ip の数値の値を含んでいます。
January 11, 2000 | FreeBSD |