getservent(3N)getservent(3N)NAMEgetservent(), getservbyport(), getservbyname(), setservent(), endser‐
vent() - get, set, or end service entry
SYNOPSISDESCRIPTION
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 indi‐
rectly 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 posi‐
tion 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.
FILESSEE ALSOypserv(1M), services(4), ypfiles(4), nsswitch.conf(4),
thread_safety(5).
STANDARDS CONFORMANCEgetservent(3N)