gnet-inetaddr.html

GNet是一个简单的网络库。它是目标定向的

VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN376"><SPAN
STYLE="white-space: nowrap"
><SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Returns</I
></SPAN
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
>&#13;</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN381"
></A
><H3
><A
NAME="GNET-INETADDR-NEW-ASYNC"
></A
>gnet_inetaddr_new_async ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnet-inetaddr.html#GINETADDRNEWASYNCID"
>GInetAddrNewAsyncID</A
> gnet_inetaddr_new_async (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *name,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> port,
                                             <A
HREF="gnet-inetaddr.html#GINETADDRNEWASYNCFUNC"
>GInetAddrNewAsyncFunc</A
> func,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data);</PRE
></TD
></TR
></TABLE
><P
>Create a GInetAddr from a name and port asynchronously.  The
 callback is called once the structure is created or an error
 occurs during lookup.  The callback will not be called during the
 call to <A
HREF="gnet-inetaddr.html#GNET-INETADDR-NEW-ASYNC"
>gnet_inetaddr_new_async</A
>().</P
><P
> The Unix version creates a pthread thread which does the lookup.
 If pthreads aren't available, it forks and does the lookup.
 Forking will be slow or even fail when using operating systems
 that copy the entire process when forking.  </P
><P
> If you need to lookup hundreds of addresses, we recommend calling
 g_main_iteration(FALSE) between calls.  This will help prevent an
 explosion of threads or processes.</P
><P
> If you need a more robust library for Unix, look at &lt;ulink
 url="http://www.gnu.org/software/adns/adns.html"&gt;GNU ADNS&lt;/ulink&gt;.
 GNU ADNS is under the GNU GPL.  This library does not use threads
 or processes.</P
><P
> The Windows version should work fine.  Windows has an asynchronous
 DNS lookup function.</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN398"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN403"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>port</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN408"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>func</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN413"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN418"><SPAN
STYLE="white-space: nowrap"
><SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Returns</I
></SPAN
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
>&#13;</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN423"
></A
><H3
><A
NAME="GNET-INETADDR-NEW-ASYNC-CANCEL"
></A
>gnet_inetaddr_new_async_cancel ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnet_inetaddr_new_async_cancel  (<A
HREF="gnet-inetaddr.html#GINETADDRNEWASYNCID"
>GInetAddrNewAsyncID</A
> async_id);</PRE
></TD
></TR
></TABLE
><P
>Cancel an asynchronous GInetAddr creation that was started with
 <A
HREF="gnet-inetaddr.html#GNET-INETADDR-NEW-ASYNC"
>gnet_inetaddr_new_async</A
>().</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN432"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>async_id</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
>&#13;</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN437"
></A
><H3
><A
NAME="GNET-INETADDR-NEW-NONBLOCK"
></A
>gnet_inetaddr_new_nonblock ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
>*  gnet_inetaddr_new_nonblock      (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *name,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> port);</PRE
></TD
></TR
></TABLE
><P
>Create an internet address from a name and port, but don't block
 and fail if it would require blocking.  This is, if the name is a
 canonical name or "localhost", it returns the address.  Otherwise,
 it returns NULL.</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN447"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN452"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>port</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN457"><SPAN
STYLE="white-space: nowrap"
><SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Returns</I
></SPAN
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
>&#13;</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN462"
></A
><H3
><A
NAME="GNET-INETADDR-CLONE"
></A
>gnet_inetaddr_clone ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
>*  gnet_inetaddr_clone             (const <A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
> *ia);</PRE
></TD
></TR
></TABLE
><P
>Create an internet address from another one.</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN471"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>ia</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN476"><SPAN
STYLE="white-space: nowrap"
><SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Returns</I
></SPAN
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
>&#13;</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN481"
></A
><H3
><A
NAME="GNET-INETADDR-DELETE"
></A
>gnet_inetaddr_delete ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnet_inetaddr_delete            (<A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
> *ia);</PRE
></TD
></TR
></TABLE
><P
>Delete a GInetAddr.</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN489"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>ia</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
>&#13;</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN494"
></A
><H3
><A
NAME="GNET-INETADDR-REF"
></A
>gnet_inetaddr_ref ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnet_inetaddr_ref               (<A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
> *ia);</PRE
></TD
></TR
></TABLE
><P
>Increment the reference counter of the GInetAddr.</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN502"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>ia</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
>&#13;</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN507"
></A
><H3
><A
NAME="GNET-INETADDR-UNREF"
></A
>gnet_inetaddr_unref ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnet_inetaddr_unref             (<A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
> *ia);</PRE
></TD
></TR
></TABLE
><P
>Remove a reference from the GInetAddr.  When reference count
 reaches 0, the address is deleted.</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN515"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>ia</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
>&#13;</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN520"
></A
><H3
><A
NAME="GNET-INETADDR-GET-NAME"
></A
>gnet_inetaddr_get_name ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
>*      gnet_inetaddr_get_name          (<A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
> *ia);</PRE
></TD
></TR
></TABLE
><P
>Get the nice name of the address (eg, "mofo.eecs.umich.edu").  The
 "nice name" is the domain name if it has one or the canonical name
 if it does not.  Be warned that this call may block since it may
 need to do a reverse DNS lookup.</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN529"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>ia</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN534"><SPAN
STYLE="white-space: nowrap"
><SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Returns</I
></SPAN
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
>&#13;</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN539"
></A
><H3
><A
NAME="GNET-INETADDR-GET-NAME-NONBLOCK"
></A
>gnet_inetaddr_get_name_nonblock ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
>*      gnet_inetaddr_get_name_nonblock (<A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
> *ia);</PRE
></TD
></TR
></TABLE
><P
>Get the nice name of the address, but don't block and fail if it
 would require blocking.</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN548"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>ia</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN553"><SPAN
STYLE="white-space: nowrap"
><SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Returns</I
></SPAN
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
>&#13;</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN558"
></A
><H3
><A
NAME="GNET-INETADDR-GET-NAME-ASYNC"
></A
>gnet_inetaddr_get_name_async ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnet-inetaddr.html#GINETADDRGETNAMEASYNCID"
>GInetAddrGetNameAsyncID</A
> gnet_inetaddr_get_name_async
                                            (<A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
> *ia,
                                             <A
HREF="gnet-inetaddr.html#GINETADDRGETNAMEASYNCFUNC"
>GInetAddrGetNameAsyncFunc</A
> func,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data);</PRE
></TD
></TR
></TABLE
><P
>Get the nice name of the address (eg, "mofo.eecs.umich.edu").
 This function will use the callback once it knows the nice name.
 The callback will not be called during the call to
 <A
HREF="gnet-inetaddr.html#GNET-INETADDR-NEW-ASYNC"
>gnet_inetaddr_new_async</A
>().</P
><P
> The Unix uses either pthreads or <GTKDOCLINK
HREF="FORK"
>fork</GTKDOCLINK
>().  See the notes for
 <A
HREF="gnet-inetaddr.html#GNET-INETADDR-NEW-ASYNC"
>gnet_inetaddr_new_async</A
>().</P
><P
> FIX: In the next big version, this should copy ia.</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN574"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>ia</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN579"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>func</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN584"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN589"><SPAN
STYLE="white-space: nowrap"
><SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Returns</I
></SPAN
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
>&#13;</P
></TD
></TR