Manual Pages for UNIX Operating System command usage for man ne_iaddr_make

neon API reference                               NE_IADDR_MAKE(3)



NAME
     ne_iaddr_make, ne_iaddr_cmp, ne_iaddr_print,
     ne_iaddr_typeof, ne_iaddr_free - functions to manipulate and
     compare network addresses

SYNOPSIS
     #include 

     typedef enum {
         ne_iaddr_ipv4 = 0,
         ne_iaddr_ipv6
     } ne_iaddr_type;

     ne_inet_addr *ne_iaddr_make(ne_iaddr_type type,
                                 const unsigned char *raw);

     int ne_iaddr_cmp(const ne_inet_addr *ia1,
                      const ne_inet_addr *ia2);

     char *ne_iaddr_print(const ne_inet_addr *ia, char *buffer,
                          size_t bufsiz

     ne_iaddr_type ne_iaddr_typeof(const ne_inet_addr *ia);

     void ne_iaddr_free(const ne_inet_addr *ia);

DESCRIPTION
     ne_iaddr_make creates an ne_inet_addr object from a raw
     binary network address; for instance the four bytes 0x7f
     0x00 0x00 0x01 represent the IPv4 address 127.0.0.1. The
     object returned is suitable for passing to ne_sock_connect.
     A binary IPv4 address contains four bytes; a binary IPv6
     address contains sixteen bytes; addresses passed must be in
     network byte order.

     ne_iaddr_cmp can be used to compare two network addresses;
     returning zero only if they are identical. The addresses
     need not be of the same address type; if the addresses are
     not of the same type, the return value is guaranteed to be
     non-zero.

     ne_iaddr_print can be used to print the human-readable
     string representation of a network address into a buffer,
     for instance the string "127.0.0.1".

     ne_iaddr_typeof returns the type of the given network
     address.

     ne_iaddr_free releases the memory associated with a network
     address object.





neon 0.29.0      Last change: 13 September 2009                 1






neon API reference                               NE_IADDR_MAKE(3)



RETURN VALUE
     ne_iaddr_make returns NULL if the address type passed is not
     supported (for instance on a platform which does not support
     IPv6).

     ne_iaddr_print returns the buffer pointer, and never NULL.

EXAMPLES
     The following example connects a socket to port 80 at the
     address 127.0.0.1.

         unsigned char addr[] = "\0x7f\0x00\0x00\0x01";
         ne_inet_addr *ia;

         ia = ne_iaddr_make(ne_iaddr_ipv4, addr);
         if (ia != NULL) {
             ne_socket *sock = ne_sock_connect(ia, 80);
             ne_iaddr_free(ia);
             /* ... */
         } else {
             /* ... */
         }

SEE ALSO
     ne_addr_resolve

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