getprotobyname() - 名前によるプロトコル・エントリーの取得

標準

標準/拡張機能 C/C++ 依存項目

XPG4.2
Single UNIX Specification、バージョン 3

両方  

形式

X/Open:
#define _XOPEN_SOURCE_EXTENDED 1
#include <netdb.h>

struct protoent *getprotobyname(const char *name);
バークレー・ソケット:
#define _OE_SOCKETS
#include <netdb.h>

struct protoent *getprotobyname(char name);

機能説明

getprotobyname() 呼び出しは、指定されたプロトコル名を /etc/protocol または tcpip.ETC.PROTO データ・セットで検索します。
パラメーター
説明
name
プロトコル名。

getprotobyname() 呼び出しは、呼び出しで指定されたネットワーク ・プロトコルの protoent 構造体へのポインターを戻します。getprotobyname()、getprotobynumber()、および getprotoent() は、いずれも同 じ静的領域を使用して protoent 構造体を戻します。この静的領域は、これらの次の関数が同じスレッドで呼び出されるまで有効です。

protoent 構造体は、netdb.h 組み込みファイルで定義され、以下のようなエレメントを持ちます。
エレメント
説明
p_aliases
プロトコルの代替名の、NULL ポインターで終了する配列。
p_name
プロトコルの公式名。
p_proto
プロトコル番号。

C++ の特殊な動作: C++ でこの関数を使用するには、_XOPEN_SOURCE_EXTENDED 1 フィーチャー・テスト・マクロを 使用する必要があります。

戻り値

正常に実行された場合、getprotobyname() は protoent 構造体へのポインターを戻します。戻り値は、同じデータ構造体を戻す、以降の呼び出しで上書きされるデータを 指します。

正常に終了しなかった場合は、getprotobyname() は NULL ポインターを戻し、エラーまたはファイル終わり (EOF)を示します。

関連情報