getservent(3N-xs)             (X/OPEN SOCKETS)            getservent(3N-xs)

NAME
     getservent, getservbyport, getservbyname, setservent, endservent -
     network services database functions

SYNOPSIS
     cc [flag ...] file ... -lxnet [library ...]

     #include <netdb.h>

     void endservent(void);

     struct servent *getservbyname(const char *name, const char *proto);

     struct servent *getservbyport(int port, const char *proto);

     struct servent *getservent(void);

     void setservent(int stayopen);

DESCRIPTION
     The getservbyname, getservbyport and getservent functions each return
     a pointer to a servent structure, the members of which contain the
     fields of an entry in the network services database.

     The getservent function reads the next entry of the database, opening
     a connection to the database if necessary.

     The getservbyname function searches the database from the beginning
     and finds the first entry for which the service name specified by name
     matches the sname member and the protocol name specified by proto
     matches the sproto member, opening a connection to the database if
     necessary. If proto is a null pointer, any value of the sproto member
     will be matched.

     The getservbyport function searches the database from the beginning
     and finds the first entry for which the port specified by port matches
     the sport member and the protocol name specified by proto matches the
     sproto member, opening a connection to the database if necessary. If
     proto is a null pointer, any value of the sproto member will be
     matched. The port argument must be in network byte order.

     The setservent function opens a connection to the database, and sets
     the next entry to the first entry. If the stayopen argument is non-
     zero, the net database will not be closed after each call to the
     getservent function (either directly, or indirectly through one of the
     other getserv* functions).

     The endservent function closes the database.







Page 1                       Reliant UNIX 5.44                Printed 11/98

getservent(3N-xs)             (X/OPEN SOCKETS)            getservent(3N-xs)

RETURN VALUES
     On successful completion, getservbyname, getservbyport and getservent
     return a pointer to a servent structure if the requested entry was
     found, and a null pointer if the end of the database was reached or
     the requested entry was not found. Otherwise, a null pointer is
     returned.

ERRORS
     No errors are defined.

APPLICATION USAGE
     The port argument of getservbyport need not be compatible with the
     port values of all address families.

     The getservent, getservbyname and getservbyport functions may return
     pointers to static data, which may be overwritten by subsequent calls
     to any of these functions.

     These functions are generally used with the Internet address family.

SEE ALSO
     byteorder(3N-xs), gethostent(3N-xs), getprotoent(3N-xs), inet(3N-xs),
     netdb(5).































Page 2                       Reliant UNIX 5.44                Printed 11/98