hpux man page for endnetent_r

getnetent(3N)															     getnetent(3N)

NAME
       getnetent(), getnetbyaddr(), getnetbyname(), setnetent(), endnetent() - get, set, or end network entry

SYNOPSIS
DESCRIPTION
       and each return a pointer to a structure of type netent containing the broken-out fields of a line in the network data base,

       The members of this structure are:

	      The official name of the network.

	      A null-terminated list of alternate names for the network.

	      The type of the network number returned; always

	      The network number.

       Functions behave as follows:

	      Reads the next line of the file, opening the file if necessary.

	      Opens and rewinds the file.
				    If	the  stayopen flag is non-zero, the network data base is not closed after each call to (either directly or
				    indirectly through one of the other calls).

	      Closes the file.

	      Sequentially searches from the beginning of the file until a network name
				    (among either the official names or the aliases) matching its parameter name is found, or until EOF is encoun-
				    tered.

	      Sequentially searches from the beginning of the file
				    until  a  network  number matching its parameter net is found, or until EOF is encountered.  The parameter net
				    must be in network order.  The parameter type must be the constant Network numbers are supplied in host  order
				    (see byteorder(3N)).

       If  the	system	is running Network Information Service (NFS), and obtain their network information from the NIS server (see ypserv(1M) and
       ypfiles(4)).

       In a multithreaded application, and use thread-specific storage that is re-used in each call.  The return value, should be unique for  each
       thread and should be saved, if desired, before the thread makes the next call.

       For  enumeration  in multithreaded applications, the position within the enumeration is a process-wide property shared by all threads.  may
       be used in a multithreaded application, but resets the enumeration position for all threads.  If multiple threads interleave calls  to  the
       threads will enumerate disjoint subsets of the network database.

   Name Service Switch-Based Operation
       The  library  routines  and  internally call the name service switch to access the "networks" database lookup policy configured in the file
       (see nsswitch.conf(4)).	The lookup policy defines the order and the criteria of the supported name services used to resolve network  names
       and addresses.

RETURN VALUE
       and return a null pointer(0) on EOF or when they are unable to open also returns a null pointer if its type parameter is invalid.

EXAMPLES
       The following code excerpt counts the number of network entries:

	      int count = 0;
	      (void) setnetent(0);
	      while (netbuf=getnetent() != NULL)
		  count++;
	      (void) endnetent();

OBSOLESCENT INTERFACES
       The  above reentrant interfaces have been moved from to They are included to support existing applications and may be removed in the future
       release.  New multithreaded applications should not use these APIs.

       The reentrant interfaces function the same as the regular interfaces (those without the suffix.)  However, and  expect  to  be  passed  the
       address	of  a  struct netent and will store the address of the result  at the supplied parameter.  An additional parameter, the address of
       struct netent_data, which is defined in the file cannot be a NULL pointer.

       and return a -1 if the operation is unsuccessful. A 0 is returned otherwise.

WARNINGS
       Programs that use the interfaces described in this manpage cannot be linked statically  because	the  implementations  of  these  functions
       employ dynamic loading and linking of shared objects at run time.

AUTHOR
       was developed by Sun Microsystems Inc.

FILES
SEE ALSO
       ypserv(1M), networks(4), ypfiles(4), nsswitch.conf(4), thread_safety(5).

STANDARDS CONFORMANCE
																     getnetent(3N)