<!-- ##### SECTION Title ##### -->InetAddr<!-- ##### SECTION Short_Description ##### -->Internet Address<!-- ##### SECTION Long_Description ##### --><para>A #GInetAddr represents an internet address.  This module providesfunctions for making DNS and reverse DNS lookups (blocking andasynchronously) and for working with #GInetAddr's.</para><para>Create a #GInetAddr by calling gnet_inetaddr_new().  This functionwill perform a DNS lookup and creates a #GInetAddr representing theaddress.  This function blocks.  The functiongnet_inetaddr_new_async() performs the lookup asynchronously and callsa callback with the #GInetAddr when the lookup completes.  Anasynchronous lookup can be canceled by callinggnet_inetaddr_new_async_cancel().</para><para>Technically a DNS lookup can map a name to several addresses.  Usegnet_inetaddr_new_list() or gnet_inetaddr_new_list_async() to get thislist.  Use gnet_inetaddr_delete_list() to delete the list.</para><para>This module can also make reverse DNS lookups (i.e., map an address toa hostname).  Call gnet_inetaddr_get_name() to get the hostname froman address.  This function blocks.  Its asynchronous counterpart isgnet_inetadr_get_name_async().  To get the canonical name, or dotteddecimal address, call gnet_inetaddr_get_canonical_name().</para><para>To get the host's address, call gnet_inetaddr_gethostaddr().  Thiscreates a #GInetAddr by performing a DNS lookup on the host's name.To get the list of all the host's interfaces, callgnet_inetaddr_list_interfaces().  The functiongnet_inetaddr_autodetect_internet_interface() uses this function andheuristics to find an interface connected to the internet.  This canbe used to automatically configure peer-to-peer applications.</para><!-- ##### SECTION See_Also ##### --><para></para><!-- ##### STRUCT GInetAddr ##### --><para></para><!-- ##### FUNCTION gnet_inetaddr_new ##### --><para></para>@hostname: @port: @Returns: <!-- # Unused Parameters # -->@name: <!-- ##### TYPEDEF GInetAddrNewAsyncID ##### --><para></para><!-- ##### USER_FUNCTION GInetAddrNewAsyncFunc ##### --><para></para>@inetaddr: @data: <!-- ##### FUNCTION gnet_inetaddr_new_async ##### --><para></para>@hostname: @port: @func: @data: @Returns: <!-- # Unused Parameters # -->@name: <!-- ##### FUNCTION gnet_inetaddr_new_async_cancel ##### --><para></para>@id: <!-- # Unused Parameters # -->@async_id: <!-- ##### FUNCTION gnet_inetaddr_new_list ##### --><para></para>@hostname: @port: @Returns: <!-- # Unused Parameters # -->@name: <!-- ##### FUNCTION gnet_inetaddr_delete_list ##### --><para></para>@list: <!-- # Unused Parameters # -->@ia_list: <!-- ##### TYPEDEF GInetAddrNewListAsyncID ##### --><para></para><!-- ##### USER_FUNCTION GInetAddrNewListAsyncFunc ##### --><para></para>@list: @data: <!-- # Unused Parameters # -->@ialist: <!-- ##### FUNCTION gnet_inetaddr_new_list_async ##### --><para></para>@hostname: @port: @func: @data: @Returns: <!-- # Unused Parameters # -->@name: <!-- ##### FUNCTION gnet_inetaddr_new_list_async_cancel ##### --><para></para>@id: <!-- # Unused Parameters # -->@async_id: <!-- ##### FUNCTION gnet_inetaddr_new_nonblock ##### --><para></para>@hostname: @port: @Returns: <!-- # Unused Parameters # -->@name: <!-- ##### FUNCTION gnet_inetaddr_new_bytes ##### --><para></para>@bytes: @length: @Returns: <!-- # Unused Parameters # -->@addr: <!-- ##### FUNCTION gnet_inetaddr_clone ##### --><para></para>@inetaddr: @Returns: <!-- # Unused Parameters # -->@ia: <!-- ##### FUNCTION gnet_inetaddr_delete ##### --><para></para>@inetaddr: <!-- # Unused Parameters # -->@ia: <!-- ##### FUNCTION gnet_inetaddr_ref ##### --><para></para>@inetaddr: <!-- # Unused Parameters # -->@ia: <!-- ##### FUNCTION gnet_inetaddr_unref ##### --><para></para>@inetaddr: <!-- # Unused Parameters # -->@ia: <!-- ##### FUNCTION gnet_inetaddr_get_name ##### --><para></para>@inetaddr: @Returns: <!-- # Unused Parameters # -->@ia: <!-- ##### FUNCTION gnet_inetaddr_get_name_nonblock ##### --><para></para>@inetaddr: @Returns: <!-- # Unused Parameters # -->@ia: <!-- ##### TYPEDEF GInetAddrGetNameAsyncID ##### --><para></para><!-- ##### USER_FUNCTION GInetAddrGetNameAsyncFunc ##### --><para></para>@hostname: @data: <!-- # Unused Parameters # -->@name: <!-- ##### FUNCTION gnet_inetaddr_get_name_async ##### --><para></para>@inetaddr: @func: @data: @Returns: <!-- # Unused Parameters # -->@ia: <!-- ##### FUNCTION gnet_inetaddr_get_name_async_cancel ##### --><para></para>@id: <!-- # Unused Parameters # -->@async_id: <!-- ##### MACRO GNET_INETADDR_MAX_LEN ##### --><para></para><!-- ##### FUNCTION gnet_inetaddr_get_length ##### --><para></para>@inetaddr: @Returns: <!-- ##### FUNCTION gnet_inetaddr_get_bytes ##### --><para></para>@inetaddr: @buffer: <!-- ##### FUNCTION gnet_inetaddr_set_bytes ##### --><para></para>@inetaddr: @bytes: @length: <!-- ##### FUNCTION gnet_inetaddr_get_canonical_name ##### --><para></para>@inetaddr: @Returns: <!-- # Unused Parameters # -->@ia: <!-- ##### FUNCTION gnet_inetaddr_get_port ##### --><para></para>@inetaddr: @Returns: <!-- # Unused Parameters # -->@ia: <!-- ##### FUNCTION gnet_inetaddr_set_port ##### --><para></para>@inetaddr: @port: <!-- # Unused Parameters # -->@ia: <!-- ##### FUNCTION gnet_inetaddr_is_canonical ##### --><para></para>@hostname: @Returns: <!-- # Unused Parameters # -->@name: <!-- ##### FUNCTION gnet_inetaddr_is_internet ##### --><para></para>@inetaddr: @Returns: <!-- ##### FUNCTION gnet_inetaddr_is_private ##### --><para></para>@inetaddr: @Returns: <!-- ##### FUNCTION gnet_inetaddr_is_reserved ##### --><para></para>@inetaddr: @Returns: <!-- ##### FUNCTION gnet_inetaddr_is_loopback ##### --><para></para>@inetaddr: @Returns: <!-- ##### FUNCTION gnet_inetaddr_is_multicast ##### --><para></para>@inetaddr: @Returns: <!-- ##### FUNCTION gnet_inetaddr_is_broadcast ##### --><para></para>@inetaddr: @Returns: <!-- ##### FUNCTION gnet_inetaddr_is_ipv4 ##### --><para></para>@inetaddr: @Returns: <!-- ##### FUNCTION gnet_inetaddr_is_ipv6 ##### --><para></para>@inetaddr: @Returns: <!-- ##### FUNCTION gnet_inetaddr_hash ##### --><para></para>@p: @Returns: <!-- ##### FUNCTION gnet_inetaddr_equal ##### --><para></para>@p1: @p2: @Returns: <!-- ##### FUNCTION gnet_inetaddr_noport_equal ##### --><para></para>@p1: @p2: @Returns: <!-- ##### FUNCTION gnet_inetaddr_get_host_name ##### --><para></para>@Returns: <!-- ##### FUNCTION gnet_inetaddr_get_host_addr ##### --><para></para>@Returns: <!-- ##### FUNCTION gnet_inetaddr_autodetect_internet_interface ##### --><para></para>@Returns: <!-- ##### FUNCTION gnet_inetaddr_get_interface_to ##### --><para></para>@inetaddr: @Returns: <!-- # Unused Parameters # -->@addr: <!-- ##### FUNCTION gnet_inetaddr_get_internet_interface ##### --><para></para>@Returns: <!-- ##### FUNCTION gnet_inetaddr_is_internet_domainname ##### --><para></para>@name: @Returns: <!-- # Unused Parameters # -->@hostname: <!-- ##### FUNCTION gnet_inetaddr_list_interfaces ##### --><para></para>@Returns: