GETNETENT

Section: C Library Functions (3)
索引 jman

BSD mandoc

索引

名称

getnetent getnetbyaddr getnetbyname setnetent endnetent - ネットワークエントリの取得

索引

ライブラリ

Lb libc

索引

書式

In netdb.h Ft struct netent * Fn getnetent void Ft struct netent * Fn getnetbyname const char *name Ft struct netent * Fn getnetbyaddr unsigned long net int type Ft void Fn setnetent int stayopen Ft void Fn endnetent void

索引

解説

Fn getnetent , Fn getnetbyname , Fn getnetbyaddr 関数はそれぞれ、次に示す構造を持つオブジェクトへのポインタを返します。構造体には、ネットワークデータベース /etc/networks にある行の内訳フィールドが含まれます。

struct  netent {
        char            *n_name;        /* ネットワークの正式名 */
        char            **n_aliases;    /* 別名リスト */
        int             n_addrtype;     /* ネット番号のタイプ */
        unsigned long   n_net;          /* ネット番号 */
};

この構造体のメンバは次のとおりです。

Fa n_name: ネットワークの正式名。
Fa n_aliases: ネットワークの別名 (エイリアス) の 0 で終わるリスト。
Fa n_addrtype: 返されるネットワーク番号のタイプであり、現在は AF_INET だけです。
Fa n_net: ネットワーク番号。ネットワーク番号は、マシンバイトオーダで返されます。

Fn getnetent 関数はファイルの次の行を読み込みます。この際、必要ならば目的のファイルをオープンします。

Fn setnetent 関数は、目的のファイルをオープンしリワインドします。 Fa stayopen フラグが 0 でなければ、 Fn getnetbyname または Fn getnetbyaddr のそれぞれの呼び出しの後でも、ネットデータベースはクローズされません。

Fn endnetent 関数はファイルをクローズします。

Fn getnetbyname 関数および Fn getnetbyaddr は、適合するネット名またはネットアドレスおよびタイプが見つかるか、または EOF に達するまで、ファイルを最初から順次検索します。 Fa type は AF_INET でなければなりません。ネットワーク番号はホストオーダで返されます。

索引

診断

EOF またはエラーの場合は、ヌルポインタ (0) が返ります。

索引

歴史

Fn getnetent , Fn getnetbyaddr , Fn getnetbyname , Fn setnetent , Fn endnetent 関数は、 BSD 4.2 で登場しました。

索引

バグ

これらの関数で使用されるデータ空間は静的です。後でこのデータを使う必要がある場合は、以後のこれら関数の呼び出しでデータが上書きされる前に、コピーして保存する必要があります。データとして受け入れられるのは現在、インターネットネットワーク番号だけです。ネットワーク番号が 32 ビットを超えない範囲に収まっていると期待するのは、おそらく素朴過ぎます。

索引

jman

Time: 07:06:52 GMT, January 12, 2009

GETNETENT

名称

ライブラリ

書式

解説

関連ファイル

診断

関連項目

歴史

バグ

Index