Manual Pages for UNIX Operating System command usage for man ne_addr_resolve

neon API reference                             NE_ADDR_RESOLVE(3)



NAME
     ne_addr_resolve, ne_addr_result, ne_addr_first,
     ne_addr_next, ne_addr_error, ne_addr_destroy - functions to
     resolve hostnames to addresses

SYNOPSIS
     #include 

     ne_sock_addr *ne_addr_resolve(const char *hostname,
                                   int flags);

     int ne_addr_result(const ne_sock_addr *addr);

     const ne_inet_addr *ne_addr_first(ne_sock_addr *addr);

     const ne_inet_addr *ne_addr_next(ne_sock_addr *addr);

     char *ne_addr_error(const ne_sock_addr *addr, char *buffer,
                         size_t bufsiz

     void ne_addr_destroy(ne_sock_addr *addr);

DESCRIPTION
     The ne_addr_resolve function resolves the given hostname,
     returning an ne_sock_addr object representing the address
     (or addresses) associated with the hostname. The flags
     parameter is currently unused, and must be passed as 0.

     The hostname passed to ne_addr_resolve can be a DNS hostname
     (e.g.  "www.example.com") or an IPv4 dotted quad (e.g.
     "192.0.34.72"); or, on systems which support IPv6, an IPv6
     hex address, which may be enclosed in brackets, e.g.
     "[::1]".

     To determine whether the hostname was successfully resolved,
     the ne_addr_result function is used, which returns non-zero
     if an error occurred. If an error did occur, the
     ne_addr_error function can be used, which will copy the
     error string into a given buffer (of size bufsiz).

     The functions ne_addr_first and ne_addr_next are used to
     retrieve the Internet addresses associated with an address
     object which has been successfully resolved.  ne_addr_first
     returns the first address; ne_addr_next returns the next
     address after the most recent call to ne_addr_next or
     ne_addr_first, or NULL if there are no more addresses. The
     ne_inet_addr pointer returned by these functions can be
     passed to ne_sock_connect to connect a socket.

     After the address object has been used, it should be
     destroyed using ne_addr_destroy.




neon 0.29.0      Last change: 13 September 2009                 1






neon API reference                             NE_ADDR_RESOLVE(3)



RETURN VALUE
     ne_addr_resolve returns a pointer to an address object, and
     never NULL.  ne_addr_error returns the buffer parameter .

EXAMPLES
     The code below prints out the set of addresses associated
     with the hostname www.google.com.

         ne_sock_addr *addr;
         char buf[256];

         addr = ne_addr_resolve("www.google.com", 0);
         if (ne_addr_result(addr)) {
             printf("Could not resolve www.google.com: %s\n",
                    ne_addr_error(addr, buf, sizeof buf));
         } else {
             const ne_inet_addr *ia;
             printf("www.google.com:");
             for (ia = ne_addr_first(addr); ia != NULL; ia = ne_addr_next(addr)) {
                 printf(" %s", ne_iaddr_print(ia, buf, sizeof buf));
             }
             putchar('\n');
         }
         ne_addr_destroy(addr);

SEE ALSO
     ne_iaddr_print

AUTHOR
     Joe Orton 
         Author.

COPYRIGHT
ATTRIBUTES
     See attributes(5) for descriptions of the following
     attributes:

     _______________________________________
    |   ATTRIBUTE TYPE   |  ATTRIBUTE VALUE|
    |____________________|__________________|_
    | Availability       |  library/neon   |
    |____________________|__________________|_
    | Interface Stability|  Volatile       |
    |____________________|_________________|

NOTES
     Source for Neon is available on http://opensolaris.org.








neon 0.29.0      Last change: 13 September 2009                 2