NAME

getprotoent, getprotobynumber, getprotobyname, setprotoent, endprotoent − get protocol entry

SYNOPSIS

#include <netdb.h>

struct protoent ∗getprotoent()

struct protoent ∗getprotobyname(name)
char ∗name;

struct protoent ∗getprotobynumber(proto)
int proto;

setprotoent(stayopen)
int stayopen

endprotoent()

DESCRIPTION

getprotoent, getprotobyname, and getprotobynumber each returns a pointer to an object with the following structure containing the broken-out fields of a line in the network protocol data base, /etc/protocols.

structprotoent {
char∗p_name;/∗ official name of protocol ∗/
char∗∗p_aliases;/∗ alias list ∗/
intp_proto;/∗ protocol number ∗/
};

The members of this structure are:

p_name The official name of the protocol. 

p_aliases A zero terminated list of alternate names for the protocol. 

p_proto The protocol number. 

getprotoent reads the next line of the file, opening the file if necessary. 

setprotoent opens and rewinds the file.  If the stayopen flag is non-zero, the net data base is not closed after each call to getprotobyname or getprotobynumber.

endprotoent closes the file. 

getprotobyname and getprotobynumber sequentially search from the beginning of the file until a matching protocol name or protocol number is found, or until EOF is encountered. 

FILES

/etc/protocols

SEE ALSO

protocols(4)

DIAGNOSTICS

Null pointer (0) returned on EOF or error. 

BUGS

All information is contained in a static area so it must be copied if it is to be saved.  Only the Internet protocols are currently understood. 

September 02, 1992