GETNAMEINFO

名前

書式

#include <sys/socket.h>
#include <netdb.h>

int getnameinfo(const struct sockaddr *sa, socklen_t salen,
                char *host, size_t hostlen,
                char *serv, size_t servlen, int flags);

説明

ホスト名が不要であることをこの関数に伝えるには、 host に NULL を指定するか、 hostlen に 0 を指定する。同様に、サービス名が不要な場合は、 serv に NULL を指定するか、 servlen に 0 を指定する。 しかし、ホスト名とサービス名の両方を不要だと指定することはできない (いずれか一方は要求すること)。

flags 引き数で getnameinfo(3) の動作を変えることができる。指定できる値は以下の通り:

NI_NOFQDN

指定すると、ローカルなホストには FQDN のホスト名の部分のみを返す。

NI_NUMERICHOST

指定すると、ホスト名の数値表式が返される。 (指定しなくても、ノードの名前が引けない場合はこのようになることはある)。

NI_NAMEREQD

指定すると、ホスト名が引けなかった場合にエラーを返す。

NI_NUMERICSERV

指定すると、サービス名が数値表式 (例えばポート番号) で返される。

NI_DGRAM

指定すると、ストリームベース (TCP) でなくデータグラムベース (UDP) のサービスを対象にする。数は少ないが、 UDP と TCP で違うサービスを提供しているポート (512-514) に対して必要となる。

国際化ドメイン名のための getnameinfo() の拡張

glibc 2.3.4 から、 getnameinfo() に拡張が行われ、ホスト名と 国際化ドメイン名 (Internationalized Domain Name; IDN) 形式との間で 透過的な変換ができるようになっている (IDN 形式については RFC 3490 の Internationalizing Domain Names in Applications (IDNA) を参照)。3つのフラグが新たに定義されている:

NI_IDN

このフラグを指定すると、必要であれば、検索処理で見つかった名前は IDN 形式からロケールに応じた符号化形式に変換される。 ASCII 文字だけの名前はこの変換では影響を受けない。このため、 既存のプログラムや環境でこのフラグを使うことができる。

NI_IDN_ALLOW_UNASSIGNED, NI_IDN_USE_STD3_ASCII_RULES

これらのフラグをセットすると、IDNA 処理で使用されるフラグ IDNA_ALLOW_UNASSIGNED (未割り当ての Unicode のコードポイントを許容) と IDNA_USE_STD3_ASCII_RULES (出力が STD3 準拠のホスト名かをチェックする) がそれぞれ有効になる。

返り値

EAI_AGAIN

指定された名前が現時点では解決できなかった。 後で再試行してみること。

EAI_BADFLAGS

flags 引き数に不正な値が与えられた。

EAI_FAIL

回復できないエラーが発生した。

EAI_FAMILY

指定したアドレスファミリーが認識できなかった。 あるいはアドレスの長さが指定されたファミリーに合うものでなかった。

EAI_MEMORY

メモリが足りない。

EAI_NONAME

与えられたパラメータでは名前が解決できない。 NI_NAMEREQD が設定されていたがホスト名が決定できなかったか、 ホスト名もサービス名も要求されなかった。

EAI_OVERFLOW

host または serv が指しているバッファが小さすぎた。

EAI_SYSTEM

システムエラーが起った。 エラーコードは errno に設定される。

gai_strerror(3) 関数を使うと、これらのエラー・コードを、エラー・レポートに適した 人間が読みやすい文字列に翻訳してくれる。  

ファイル

準拠

注意

# define NI_MAXHOST      1025
# define NI_MAXSERV      32

前者は、最近のバージョンの BIND のヘッダファイル <arpa/nameser.h> 中の定数 MAXDNAME と同じ値である。 後者は、割り当て済の数値について記した現在の RFC に 列挙されてサービスから推量した値である。  

例

struct sockaddr *sa;    /* input */
char hbuf[NI_MAXHOST], sbuf[NI_MAXSERV];

if (getnameinfo(sa, sa->sa_len, hbuf, sizeof(hbuf), sbuf,
            sizeof(sbuf), NI_NUMERICHOST | NI_NUMERICSERV) == 0)
    printf("host=%s, serv=%s\n", hbuf, sbuf);

以下ではソケットアドレスに 逆向きのアドレスマッピングが存在するかをチェックしている。

struct sockaddr *sa;    /* input */
char hbuf[NI_MAXHOST];

if (getnameinfo(sa, sa->sa_len, hbuf, sizeof(hbuf),
            NULL, 0, NI_NAMEREQD))
    printf("could not resolve hostname");
else
    printf("host=%s\n", hbuf);

getnameinfo() を使ったプログラム例が getaddrinfo(3) に記載されている。  

関連項目

R. Gilligan, S. Thomson, J. Bound and W. Stevens, Basic Socket Interface Extensions for IPv6, RFC 2553, March 1999.

Tatsuya Jinmei and Atsushi Onoe, An Extension of Format for IPv6 Scoped Addresses, internet draft, work in progress. ftp://ftp.ietf.org/internet-drafts/draft-ietf-ipngwg-scopedaddr-format-02.txt

Craig Metz, Protocol Independence Using the Sockets API, Proceedings of the freenix track: 2000 USENIX annual technical conference, June 2000. http://www.usenix.org/publications/library/proceedings/usenix2000/freenix/metzprotocol.html

Index

名前

書式

説明

国際化ドメイン名のための getnameinfo() の拡張

返り値

ファイル

準拠

注意

例

関連項目