ne_addr_resolve man page on NetBSD

Man page or keyword search:  
man Server   9087 pages
apropos Keyword Search (all sections)
Output format
NetBSD logo
[printable version]

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_error, ne_addr_destroy - functions to resolve hostnames 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);

       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.

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 <neon@lists.manyfish.co.uk>
	   Author.

COPYRIGHT
neon 0.29.3			11 January 2010		    NE_ADDR_RESOLVE(3)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server NetBSD

List of man pages available for NetBSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net