getprotobyname_r サブルーチン

目的

プロトコル名によって /etc/protocols ファイルからプロトコル・エントリーを取得します。

ライブラリー

標準 C ライブラリー (libc.a)

構文

#include <netdb.h>

int  getprotobyname_r(Name, protoent, proto_data)
register const char *Name;
struct protoent *protoent;
struct protoent_data *proto_data;

説明

getprotobyname_r サブルーチンは、プロトコル名によって /etc/protocols ファイルからプロトコル情報を取得します。

アプリケーション・プログラムは、 getprotobyname_r サブルーチンを使用して、プロトコル名、別名、およびプロトコル番号にアクセスすることができます。

getprotobyname_r サブルーチンは、ファイルの先頭から一致するプロトコル名を見つけるまで、またはファイルの終わりに達するまで、プロトコル・ファイルを順次検索します。 サブルーチンは、 /etc/protocols ファイル内の情報行のフィールドが入っているプロトタイプ構造体を書き込みます。

netdb.h ファイルは、プロトタイプ構造体を定義します。

getprotobyname サブルーチンは、後続の呼び出しで戻される静的データを上書きします。 getprotobyname_r サブルーチンにはありません。

endprotoent_r サブルーチンを使用して、 /etc/protocols ファイルをクローズします。

パラメーター

戻り値

この関数は、成功すれば0を返し、失敗すれば-1を返す。