ADDR2ASCII

索引

名称

索引

ライブラリ

索引

書式

索引

解説

Fn addr2ascii 関数は、バイナリのネットワーク形式のアドレスを印字可能な形式に 変換するのに使用されます。 Fa af の他に、 3 つの引数を持ちます。 Fa addrp 引数は、変換するネットワークアドレスへのポインタです。 Fa len 引数は、アドレスの長さです。 Fa buf 引数は、結果を保持するために呼び出し元が割り振る バッファへのオプションのポインタです。 ヌルポインタが渡されると、 Fn addr2ascii は静的に割り振られたバッファを使用します。

Fn ascii2addr 関数は、 Fn addr2ascii と逆の操作を実行します。 Fa af に加えて、2 つのパラメータ Fa ascii と Fa result を使用します。 Fa ascii パラメータは、バイナリに変換される文字列へのポインタです。 Fa result パラメータは、指定されたファミリに適切なネットワークアドレス構造体への ポインタです。

指定されたファミリにおいて使用されるバイナリアドレスとして 適切な構造体は次のとおりです。

AF_INET

struct in_addr (in Aq Pa netinet/in.h )

AF_LINK

struct sockaddr_dl (in Aq Pa net/if_dl.h )

索引

戻り値

索引

例

#include <sys/types.h>
#include <sys/socket.h>
#Include <netinet/in.h>
#include <arpa/inet.h>

char *
inet_ntoa(struct in_addr addr)
{
        return addr2ascii(AF_INET, &addr, sizeof addr, 0);
}

int
inet_aton(const char *ascii, struct in_addr *addr)
{
        return (ascii2addr(AF_INET, ascii, addr)
            == sizeof(*addr));
}

実際には、これは実行できません。 Fn addr2ascii と Fn ascii2addr は、他の方法でなく、 inet(3) 関数で実装されているからです。  

索引

エラー

Bq Er ENAMETOOLONG

Fn addr2ascii ルーチンは、 Fa af によって渡されたアドレスファミリに不適切なパラメータ Fa len を渡されました。

Bq Er EPROTONOSUPPORT

いずれかのルーチンに、 AF_INET または AF_LINK ではない Fa af パラメータが渡されました。

Bq Er EINVAL

Fn ascii2addr に渡された文字列は、 アドレスファミリ Fa af について不適切にフォーマットされていました。

索引

関連項目

索引

歴史

索引

作者

索引

バグ

このインタフェースの一般性については、いくらか疑問があります。 本当に一般的なインタフェースであれば、バッファを動的に割り当てることが できるよう、使用されるバッファの長さを決定する手段を備えているでしょうし、 バイナリアドレスを保持するのには必ず ``struct sockaddr '' を要求するでしょう。 残念ながら、これは既存のやり方と互換性がありません。 この制限のため、任意のアドレスファミリからネットワークアドレスを 印字するルーチンは、必要な最大バッファ長や、 バイナリアドレスとして使用するアドレスの適切な部分といった 内部的な知識を依然として持っていなければなりません。

索引

Index

名称

ライブラリ

書式

解説

戻り値

例

エラー

関連項目

歴史

作者

バグ