getservent(3N)															    getservent(3N)

NAME

       getservent(), getservbyport(), getservbyname(), setservent(), endservent() - get, set, or end service entry

SYNOPSIS

DESCRIPTION

       The  and  functions each return a pointer to a structure of type servent containing the broken-out fields of a line in the network services
       data base,

       The members of this structure are:

	      The official name of the service.

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

	      The port number at which the service resides.

	      The name of the protocol to use when contacting the
			     service.

       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 services data base is not closed after each call to (either  directly
				       or indirectly through one of the other calls).

	      Closes the file.

	      Each sequentially searches from the beginning of the file
				       until  a matching service name (among either the official names or the aliases) or port number is found, or
				       until EOF is encountered.  If a non-NULL protocol name is also supplied (such  as  or  searches	must  also
				       match the protocol.
       If  the	system	is  running  the  Network  Information Service (NIS), gets the service 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 service database.

   Name Service Switch-Based Operation
       The  library  routines  and  their reentrant counterparts, internally call the name service switch to access the "services" 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 service names and ports.

OBSOLESCENT INTERFACES

       The  above  reentrant interfaces have been  moved from to They are included to support existing applications and may be removed in a future
       release.  New multithreaded applications should use the regular APIs without the suffix.

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

       The reentrant routines return if the operation is unsuccessful, or, in the case of if the end of the services list has  been  reached.	is
       returned otherwise.

RETURN VALUE

       and return a null pointer(0) on EOF or when they are unable to open

EXAMPLES

       The following code excerpt counts the number of service entries:

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), services(4), ypfiles(4), nsswitch.conf(4), thread_safety(5).

STANDARDS CONFORMANCE

																    getservent(3N)