NE_ADDR_RESOLVE(3)						neon API reference						NE_ADDR_RESOLVE(3)

NAME

       ne_addr_resolve,  ne_addr_result,  ne_addr_first,  ne_addr_next, ne_addr_print, ne_addr_error, ne_addr_destroy - functions to resolve host-
       names to addresses

SYNOPSIS

       #include <ne_socket.h>

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

       int ne_addr_result (const ne_sock_addr *addr);

       ne_inet_addr *ne_addr_first (ne_sock_addr *addr);

       ne_inet_addr *ne_addr_next (ne_sock_addr *addr);

       char *ne_addr_print (const ne_inet_addr *iaddr, char *buffer, size_t bufsiz);

       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)  associ-
       ated with the hostname. The flags parameter is currently unused, and should 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 sys-
       tems 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  oc-
       curred.	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 buf-
       siz.

       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_ad-
       dr_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.

       To return the string representation of a particular network address, the ne_addr_print function can be used.

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

RETURN VALUE

       ne_addr_resolve returns a pointer to an address object, and never NULL. ne_addr_error and ne_addr_print both return 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
",
		  ne_addr_error(addr, buf, sizeof buf));
       } else {
	   ne_inet_addr *ia;
	   printf("www.google.com:");
	   for (ia = ne_addr_first(addr); ia != NULL; ia = ne_addr_next(addr)) {
	       printf(" %s", ne_addr_print(ia, buf, sizeof buf));
	   }
	   putchar('
');
       }
       ne_addr_destroy(addr);

AUTHOR

       Joe Orton <neon@webdav.org>.

neon 0.23.5							   8 October 2002						NE_ADDR_RESOLVE(3)