_________________________________________________________________
getservent, getservbyport, Network Library Routine
getservbyname, setservent, endservent
get service entry
_________________________________________________________________
SYNTAX
#include <netdb.h>
struct servent *getservent()
struct servent *getservbyname(name, proto)
char *name, *proto;
struct servent *getservbyport(port, proto)
int port; char *proto;
setservent(stayopen)
int stayopen
endservent()
DESCRIPTION
Getservent, getservbyname, and getservbyport each return a
pointer to an object. The object's structure contains the
broken-out fields of a line in the network services database,
/etc/services.
struct servent {
char *s_name; /* official name of service */
char **s_aliases; /* alias list */
long s_port; /* port service resides at */
char *s_proto; /* protocol to use */
};
The members of this structure are:
s_name The official name of the service.
s_aliases A zero-terminated list of alternate names for the
service.
s_port The port number at which the service resides. Port
numbers are returned in network byte order.
s_proto The name of the protocol to use when contacting the
service.
DG/UX 4.00 Page 1
Licensed material--property of copyright holder(s)
getservent(3n)
Getservent reads the next line of the file, opening the file if
necessary.
Setservent opens and rewinds the file. If the stayopen flag is
non-zero, the net data base will not be closed after each call to
getservent (either directly, or indirectly through one of the
other "getserv" calls).
Endservent closes the file.
Getservbyname and getservbyport sequentially search from the
beginning of the file until a matching protocol name or port
number is found, or until EOF is encountered. If a protocol name
is also supplied (non-NULL), searches must also match the
protocol.
If your system is using the Yellow Pages (YP), you may need to
see Chapter 2 "The Yellow Pages" in Using the Network File System
on Your DG/UX System for information on how to update the file
/etc/services.
FILES
/etc/services
SEE ALSO
getprotoent(3N), services(4)
DIAGNOSTICS
Null pointer (0) returned on EOF or error.
BUGS
All information is contained in a static area, so you have to
copy it if you want to save it.
DG/UX 4.00 Page 2
Licensed material--property of copyright holder(s)