endprotoent(3xnet) [sunos man page]
endprotoent(3XNET) X/Open Networking Services Library Functions endprotoent(3XNET) NAME
endprotoent, getprotobynumber, getprotobyname, getprotoent, setprotoent - network protocol database functions SYNOPSIS
cc [ flag ... ] file ... -lxnet [ library ... ] #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); DESCRIPTION
The getprotobyname(), getprotobynumber() and getprotoent(), 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 to getprotoent() (either directly, or indi- rectly through one of the other getproto*() functions). The endprotoent() function closes the connection to the database. USAGE
The getprotobyname(), getprotobynumber() and getprotoent() functions may return pointers to static data, which may be overwritten by subse- quent calls to any of these functions. These functions are generally used with the Internet address family. RETURN VALUES
On successful completion, getprotobyname(), getprotobynumber() and getprotoent() 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. ERRORS
No errors are defined. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Standard | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+ SEE ALSO
attributes(5), standards(5) SunOS 5.10 10 Jun 2002 endprotoent(3XNET)
Check Out this Related Man Page
endprotoent(3XNET) X/Open Networking Services Library Functions endprotoent(3XNET) NAME
endprotoent, getprotobynumber, getprotobyname, getprotoent, setprotoent - network protocol database functions SYNOPSIS
cc [ flag ... ] file ... -lxnet [ library ... ] #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); DESCRIPTION
The getprotobyname(), getprotobynumber() and getprotoent(), 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 to getprotoent() (either directly, or indi- rectly through one of the other getproto*() functions). The endprotoent() function closes the connection to the database. USAGE
The getprotobyname(), getprotobynumber() and getprotoent() functions may return pointers to static data, which may be overwritten by subse- quent calls to any of these functions. These functions are generally used with the Internet address family. RETURN VALUES
On successful completion, getprotobyname(), getprotobynumber() and getprotoent() 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. ERRORS
No errors are defined. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Standard | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+ SEE ALSO
attributes(5), standards(5) SunOS 5.11 10 Jun 2002 endprotoent(3XNET)