*** UNIX MANUAL PAGE BROWSER ***

getnetbyname(3) Library Functions Manual getnetbyname(3) NAME getnetbyname, getnetbyname_r - Get a network entry by name LIBRARY Standard C Library (libc.so, libc.a) SYNOPSIS #include <netdb.h> struct netent *getnetbyname( const char *name); [Digital] The following obsolete function is supported in order to maintain backward compatibility with previous versions of the operating system. You should not use it in new designs. int getnetbyname_r( const char *name, struct netent *net, struct netent_data *net_data); STANDARDS Interfaces documented on this reference page conform to industry stan- dards as follows: getnetbyname(): XPG4-UNIX Refer to the standards(5) reference page for more information about in- dustry standards and associated tags. PARAMETERS Specifies the official network name or alias. [Digital] For getnetby- name_r() only, this points to the netent structure. The netdb.h header file defines the netent structure. [Digital] For getnetbyname_r() only, this is data for the networks database. The netdb.h header file defines the netent_data structure. DESCRIPTION The getnetbyname() function returns a pointer to a structure of type netent. Its members specify data in fields from either the local /etc/networks file or the NIS distributed network database. To deter- mine which file or files to search, and in which order, the system uses the switches in the /etc/svc.conf file. The netdb.h header file de- fines the netent structure. The getnetbyname() function searches the networks file sequentially un- til a match with the name parameter occurs. When EOF (End-of-File) is reached without a match, an null pointer is returned by this function. Use the endnetent() function to close the networks file. NOTES The getnetbyname() function returns a pointer to thread-specific data. Subsequent calls to this or a related function from the same thread overwrite this data. [Digital] The getnetbyname_r() function is an obsolete reentrant ver- sion of the getnetbyname() function. It is supported in order to main- tain backward compatibility with previous versions of the operating system and should not be used in new designs. Note that you must set the net_fp field of the netent_data structure to NULL before its first access by either the setnetent_r() or getnetbyname_r() function. You must initialize the _net_stayopen flag of the netent_data structure if you are not using the setnetent() function. RETURN VALUES Upon successful completion, the getnetbyname() function returns a pointer to a netent structure. If it fails or reaches the end of the /etc/networks name file, it returns a null pointer. [Digital] Upon successful completion, the getnetbyname_r() function stores the netent structure in the location pointed to by net, and re- turns a value of 0 (zero). Upon failure, it returns a value of -1. ERRORS Current industry standards do not define error values for the getnetby- name() function. [Digital] If any of the following conditions occurs, the getnetby- name_r() function sets errno to the corresponding value: The net or net_data parameter is invalid. The search failed. FILES This file is the DARPA Internet network name database file. Each record in the file occupies a single line and has three fields: the official network name, the network number, and alias. RELATED INFORMATION Functions: endnetent(3), getnetent(3), getnetbyaddr(3), setnetent(3). Files: networks(4), svc.conf(4). Networks: nis_intro(7). Standards: standards(5). delim off getnetbyname(3)