inet_net_pton()

inet_net_pton() 関数は、 表記形式でインターネットネットワーク番号を格納した NULL 終端された文字列である pres をネットワーク形式に変換する。 ネットワークバイトオーダーの変換結果は netp が指すバッファーに格納される (netp 引き数は通常 in_addr 構造体を指している)。 nsize 引き数は netp で利用可能なバイト数を示す。

成功すると inet_net_pton() は netp に格納した結果のネットワーク番号フィールドのビット数を返す。 入力の表記形式と返り値に関する議論は「注意」の節を参照。

注意: netp が指すバッファーは inet_net_pton() の呼び出し前に 0 で埋めるべきである。 呼び出しではネットワーク番号で必要なバイトだけが書き込まれ、 そのバイト数は完全なネットワークアドレスのバイト数よりも少ないこともある。

inet_net_ntop()

inet_net_ntop() 関数は netp が指すバッファーのネットワーク番号を表記形式に変換する。 *netp はネットワークバイトオーダーでの値として解釈される。 bits 引き数は *netp のネットワーク番号のビット数を指定する。

NULL 終端された表記形式の文字列は pres が指すバッファーに格納される。 psize 引き数は pres で利用可能なバイト数を指定する。 表記形式は CIDR 形式、 つまり、 ネットワークアドレスを表すドット区切りの 10 進数に、 スラッシュとネットワーク番号のビットサイズが続く形式である。

inet_net_pton() の入力の表記形式

ネットワーク番号は、 16 進数値、またはドット区切りの 10 進数表記で指定できる。

先頭に "0x" か "0X" がある場合 16 進数値となる。 16 進数はネットワークバイトオーダーの左から右へ半オクテット (4 ビット) ずつ順番に埋められる。

ドット区切りの 10 進数表記では、 最大 4 つのオクテットをドット区切りの 10 進数で指定する。 したがって、 以下の形式を指定できる。

a.b.c.d
a.b.c
a.b
a

各部分は 0 から 255 の範囲の数字で、ネットワーク番号の各バイトに左から右にネットワークバイトオーダー (ビッグエンディアン) で順番に埋められる。 省略された部分があれば、 対応するネットワーク番号のバイトは 0 となる。

16 進数とドット区切りの 10 進数形式のどちらの場合も、 ネットワーク番号の後ろにスラッシュと 0 から 32 の範囲の数字をオプションで付けることができる。 この数字はネットワーク番号のビット単位のサイズを示すものである。

inet_net_pton() の返り値

inet_net_pton() の返り値はネットワーク番号フィールドのビット数である。 入力の表記形式の文字列がスラッシュとサイズの明示的な値で終わっている場合、 指定されたサイズが inet_net_pton() の返り値となる。 そうでない場合は、 返り値 bits が以下のようにして推測される。

• ネットワーク番号の最上位バイトが 240 以上の場合、 bits は 32 となる。
• それ以外で、 ネットワーク番号の最上位バイトが 224 以上の場合、 bits は 4 となる。
• それ以外で、 ネットワーク番号の最上位バイトが 192 以上の場合、 bits は 24 となる。
• それ以外で、 ネットワーク番号の最上位バイトが 128 以上の場合、 bits は 16 となる。
• それ以外の場合、 bits は 8 となる。

上記の手順から得られる bits の値が 8 以上だが、 ネットワーク番号で指定されたオクテット数が bits/8 より大きい場合、 bits には実際に指定されたオクテット数を 8 倍した値が設定される。

プログラムのソース

/* "-lresolv" でリンクする */
#include <arpa/inet.h>
#include <stdio.h>
#include <stdlib.h>
#define errExit(msg)    do { perror(msg); exit(EXIT_FAILURE); \


                        } while (0)
int
main(int argc, char *argv[])
{


    char buf[100];


    struct in_addr addr;


    int bits;


    if (argc < 2) {


        fprintf(stderr,


                "Usage: %s presentation-form [addr-init-value]\n",


                argv[0]);


        exit(EXIT_FAILURE);


    }


    /* argv[2] (数値) が指定されると、その数字を使って inet_net_pton()


       に渡す出力バッファーを初期化する。これにより inet_net_pton() が


       ネットワーク番号に必要なバイトだけを書き込むことを確認できるよう


       にする。 argv[2] が指定されなかった場合、バッファーは 0 で初期化


       する (これが推奨される方法である)。 */


    addr.s_addr = (argc > 2) ? strtod(argv[2], NULL) : 0;


    /* argv[1] の表記形式のネットワーク番号をバイナリー形式に変換する */


    bits = inet_net_pton(AF_INET, argv[1], &addr, sizeof(addr));


    if (bits == -1)


        errExit("inet_net_ntop");


    printf("inet_net_pton() returned: %d\n", bits);


    /* inet_net_pton() が返した 'bits' を使って、


       バイナリー形式を表記形式に変換する */


    if (inet_net_ntop(AF_INET, &addr, bits, buf, sizeof(buf)) == NULL)


        errExit("inet_net_ntop");


    printf("inet_net_ntop() yielded:  %s\n", buf);


    /* 'addr' を名前の形で (ネットワークバイトオーダーで) 表示する。


       これにより inet_net_ntop() が表示しないバイトを確認できる。


       これらのバイトの一部は inet_net_ntop() では変更されない場合があり、


       その場合 argv[2] で指定された初期値のままになる。 */


    printf("Raw address:              %x\n", htonl(addr.s_addr));


    exit(EXIT_SUCCESS);
}