#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);
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 構造体のメンバーは以下の通り。
| Interface | Attribute | Value |
| getprotoent() | Thread safety |
MT-Unsafe race:protoent
race:protoentbuf locale |
| getprotobyname() | Thread safety |
MT-Unsafe race:protobyname
locale |
| getprotobynumber() | Thread safety |
MT-Unsafe race:protobynumber
locale |
|
setprotoent(),
endprotoent() | Thread safety |
MT-Unsafe race:protoent
locale |
In the above table, protoent in race:protoent signifies that if any of the functions setprotoent(), getprotoent(), or endprotoent() are used in parallel in different threads of a program, then data races could occur.