Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

ne_iaddr_free(3) [opensolaris man page]

NE_IADDR_MAKE(3)						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 <ne_socket.h> 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. 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[] = "x7fx00x00x01"; 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(3) AUTHOR
Joe Orton <neon@webdav.org>. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +--------------------+-----------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +--------------------+-----------------+ |Availability | SUNWneon | +--------------------+-----------------+ |Interface Stability | Volatile | +--------------------+-----------------+ NOTES
Source for Neon is available on http://opensolaris.org. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +--------------------+-----------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +--------------------+-----------------+ |Availability | SUNWneon | +--------------------+-----------------+ |Interface Stability | Volatile | +--------------------+-----------------+ NOTES
Source for Neon is available on http://opensolaris.org. neon 0.25.5 20 January 2006 NE_IADDR_MAKE(3)

Check Out this Related Man Page

NE_IADDR_MAKE(3)						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 <ne_socket.h> 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. 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[] = "x7fx00x00x01"; 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 <neon@lists.manyfish.co.uk> Author. COPYRIGHT
neon 0.28.4 25 February 2009 NE_IADDR_MAKE(3)
Man Page