endprotoent, getprotobynumber, getprotobyname, getprotoent, setprotoent - network protocol database functions
#include <netdb.h>
void endprotoent(void);
struct protoent *getprotobyname(const char *name);
struct protoent *getprotobynumber(int proto);
struct protoent *getprotoent(void);
void setprotoent(int stayopen);
Thegetprotobyname() ,getprotobynumber() andgetprotoent() , functions each return a pointer to a protoent structure, the members of which contain the fields of an entry in the network protocol database.The
getprotoent() function reads the next entry of the database, opening a connection to the database if necessary.The
getprotobyname() function searches the database from the beginning and finds the first entry for which the protocol name specified by name matches the p_name member, opening a connection to the database if necessary.The
getprotobynumber() function searches the database from the beginning and finds the first entry for which the protocol number specified by number matches the p_proto member, opening a connection to the database if necessary.The
setprotoent() function opens a connection to the database, and sets the next entry to the first entry. If the stayopen argument is non-zero, the connection to the network protocol database will not be closed after each call togetprotoent() (either directly, or indirectly through one of the othergetproto*() functions).The
endprotoent() function closes the connection to the database.
On successful completion,getprotobyname() ,getprotobynumber() andgetprotoent() functions return a pointer to a protoent structure if the requested entry was found, and a null pointer if the end of the database was reached or the requested entry was not found. Otherwise, a null pointer is returned.
No errors are defined.
Thegetprotobyname() ,getprotobynumber() andgetprotoent() functions may return pointers to static data, which may be overwritten by subsequent calls to any of these functions.
<netdb.h> .
First released in Issue 4.
Contents | Next section | Index |