名前

       getprotoent, getprotobyname, getprotobynumber, setprotoent, endprotoent - プロトコルのエントリを取得する

書式

       #include <netdb.h>

       struct protoent *getprotoent(void);

       struct protoent *getprotobyname(const char *name);

       struct protoent *getprotobynumber(int proto);

       void setprotoent(int stayopen);

       void endprotoent(void);

説明

       getprotoent()   関数は、プロトコルのデータベース (protocols(5)  参照) から次のエントリを読み込み、 そのエ
       ントリを protoent 構造体の要素別のフィールドに格納し、 その構造体を返す。  必要であれば、データベースへの
       接続がオープンされる。

       getprotobyname()  関数は、プロトコル名 name にマッチするエントリを データベースから探し、そのエントリを収
       めた protoent 構造体を返す。 必要であれば、データベースへの接続がオープンされる。

       getprotobynumber()  関数は、プロトコル番号 number にマッチするエントリを データベースから探し、そのエント
       リを収めた protoent 構造体を返す。 必要であれば、データベースへの接続がオープンされる。

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

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

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

           struct protoent {
               char  *p_name;       /* official protocol name */
               char **p_aliases;    /* alias list */
               int    p_proto;      /* protocol number */
           }

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

       p_name プロトコルの正式名 (official name)。

       p_aliases
              プロトコルの別名のリスト。 リストは NULL で終端される。

       p_proto
              プロトコルの番号

返り値

       getprotoent(), getprotobyname(), getprotobynumber()  関数は、静的に割り当てられた protoent 構造体へのポイ
       ンタを返す。 エラーが起こったり、ファイルの最後に達した場合は NULL ポインタを返す。

ファイル

       /etc/protocols
              プロトコルのデータベースファイル

準拠

       4.3BSD, POSIX.1-2001.

関連項目

       getnetent(3), getprotoent_r(3), getservent(3), protocols(5)

この文書について

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