名前

       getnetent, getnetbyname, getnetbyaddr, setnetent, endnetent - ネットワークエントリーを取得
       する

書式

       #include <netdb.h>

       struct netent *getnetent(void);

       struct netent *getnetbyname(const char *name);

       struct netent *getnetbyaddr(uint32_t net, int type);

       void setnetent(int stayopen);

       void endnetent(void);

説明

       getnetent()  関数はネットワークデータベースから次のエントリーを読み込み、 そのエントリーを
       netent  構造体の要素別のフィールドに格納し、 その構造体を返す。 必要であれば、データベース
       への接続がオープンされる。

       getnetbyname()  関数は、ネットワーク名  name  にマッチするエントリーを  データベースから探
       し、そのエントリーを収めた netent 構造体を返す。

       getnetbyaddr()   関数は、type 型のネットワーク番号 net にマッチするエントリーを データベー
       スから探し、そのエントリーを収めた netent 構造体を返す。 net  引き数はホストバイトオーダで
       なければならない。

       setnetent()  関数はデータベースへの接続をオープンし、 次の読み込みエントリーを先頭のエント
       リーに設定する。 stayopen が 0 でない場合、 一つ一つの getnet*()  関数の呼び出し間でデータ
       ベースへの接続をクローズしない。

       endnetent()  関数はデータベースへの接続をクローズする。

       netent 構造体は <netdb.h> で以下のように定義されている。

           struct netent {
               char      *n_name;     /* official network name */
               char     **n_aliases;  /* alias list */
               int        n_addrtype; /* net address type */
               uint32_t   n_net;      /* network number */
           }

       netent 構造体のメンバは以下の通り。

       n_name ネットワークの正式名 (official name)。

       n_aliases
              ネットワークの別名からなるリスト。 リストはヌルで終端される。

       n_addrtype
              ネットワーク番号の形式。現在は AF_INET のみ。

       n_net  ホストバイトオーダ形式のネットワーク番号。

返り値

       getnetent(),  getnetbyname(), getnetbyaddr()  関数は、静的に割り当てられた netent 構造体へ
       のポインターを返す。    エラーが起こったり、ファイルの末尾に達した場合はヌルポインターを返
       す。

ファイル

       /etc/networks
              ネットワークデータベースファイル

準拠

       4.3BSD, POSIX.1-2001.

注意

       バージョン 2.2 より前の glibc では、 getnetbyaddr()  の引き数 net は long 型だった。

関連項目

       getnetent_r(3), getprotoent(3), getservent(3)
       RFC 1101

この文書について

       この  man ページは Linux man-pages プロジェクトのリリース 3.79 の一部 である。プロジェクト
       の説明とバグ報告に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。