GETRNAMEINFO(@LIB_NETWORK_EXT@)      LOCAL     GETRNAMEINFO(@LIB_NETWORK_EXT@)

NAME
     getnameinfo - address-to-name translation in protocol-independent manner

SYNOPSIS
     #include <sys/socket.h>
     #include <netdb.h>

     ___
     getnameinfo(_____ ______ ________ ___, _________ _____, ____ _____,
             ______ _______, ____ _____, ______ _______, ___ _____)

DESCRIPTION
     The getnameinfo() function is defined for protocol-independent address-
     to-nodename translation.  It performs functionality of gethostbyad-
     dr(@LIB_NETWORK_EXT@) and getservbyport(@LIB_NETWORK_EXT@) in more so-
     phisticated manner.

     The __ arguement is a pointer to a generic socket address structure of
     size _____. The arguements ____ and ____ are pointers to buffers to hold
     the return values.  Their sizes are specified by _______ and _______
     repectively.  Either ____ or ____ may be NULL if the hostname  or service
     name is not required.

     The _____ arguement modifies the behaviour of getnameinfo() as follows:

     If NI_NOFQDN is set only the unqualified hostname is returned for local
     fully qualified names.

     If NI_NUMERICHOST is set then the numeric form of the hostname is re-
     turned.

     If NI_NAMEREQD is set, then a error is returned if the hostname cannot be
     looked up.

     If NI_NUMERICSERV is set then the service is returned in numeric form.

     If NI_DGRAM is set then the service is UDP based rather than TCP based.

SEE ALSO
     getaddrinfo(@LIB_NETWORK_EXT@),  gethostbyaddr(@LIB_NETWORK_EXT@),
     getservbyport(@LIB_NETWORK_EXT@),  hosts(@FORMAT_EXT@),
     services(@FORMAT_EXT@),  hostname(@DESC_EXT@),  named(@SYS_OPS_EXT@)

     R. Gilligan, S.  Thomson, J. Bound, and W. Stevens, ``Basic Socket Inter-
     face Extensions for IPv6,'' RFC2133, April 1997.

STANDARDS
     The getaddrinfo() function is defined IEEE POSIX 1003.1g draft specifica-
     tion, and documented in ``Basic Socket Interface Extensions for IPv6''
     (RFC2133).

                               January 11, 1999                              1