gnet-inetaddr.html

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

></TABLE
><P
>Hash the address.  This is useful for glib containers.</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="AEN811"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>p</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="AEN816"><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="AEN821"
></A
><H3
><A
NAME="GNET-INETADDR-EQUAL"
></A
>gnet_inetaddr_equal ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
>        gnet_inetaddr_equal             (<GTKDOCLINK
HREF="GCONSTPOINTER"
>gconstpointer</GTKDOCLINK
> p1,
                                             <GTKDOCLINK
HREF="GCONSTPOINTER"
>gconstpointer</GTKDOCLINK
> p2);</PRE
></TD
></TR
></TABLE
><P
>Compare two <A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
>'s.</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="AEN832"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>p1</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="AEN837"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>p2</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="AEN842"><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="AEN847"
></A
><H3
><A
NAME="GNET-INETADDR-NOPORT-EQUAL"
></A
>gnet_inetaddr_noport_equal ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
>        gnet_inetaddr_noport_equal      (<GTKDOCLINK
HREF="GCONSTPOINTER"
>gconstpointer</GTKDOCLINK
> p1,
                                             <GTKDOCLINK
HREF="GCONSTPOINTER"
>gconstpointer</GTKDOCLINK
> p2);</PRE
></TD
></TR
></TABLE
><P
>Compare two <A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
>'s, but does not compare the port numbers.</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="AEN858"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>p1</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="AEN863"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>p2</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="AEN868"><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="AEN873"
></A
><H3
><A
NAME="GNET-INETADDR-GETHOSTNAME"
></A
>gnet_inetaddr_gethostname ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
>*      gnet_inetaddr_gethostname       (void);</PRE
></TD
></TR
></TABLE
><P
>Get the primary host's name.</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="AEN881"><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="AEN886"
></A
><H3
><A
NAME="GNET-INETADDR-GETHOSTADDR"
></A
>gnet_inetaddr_gethostaddr ()</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_gethostaddr       (void);</PRE
></TD
></TR
></TABLE
><P
>Get the primary host's <A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</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="AEN895"><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="AEN900"
></A
><H3
><A
NAME="GNET-INETADDR-NEW-ANY"
></A
>gnet_inetaddr_new_any ()</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_any           (void);</PRE
></TD
></TR
></TABLE
><P
>Create a <A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
> with the address INADDR_ANY and port 0.  This
 is useful for creating default addresses for binding.  The
 address's name will be "&lt;INADDR_ANY&gt;".</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="AEN909"><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="AEN914"
></A
><H3
><A
NAME="GNET-INETADDR-AUTODETECT-INTERNET-INTERFACE"
></A
>gnet_inetaddr_autodetect_internet_interface ()</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_autodetect_internet_interface
                                            (void);</PRE
></TD
></TR
></TABLE
><P
>Find an Internet interface.  Usually, this interface routes
 packets to and from the Internet.  It can be used to automatically
 configure simple servers that must advertise their address.  This
 sometimes doesn't work correctly when the user is behind a NAT.</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="AEN922"><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="AEN927"
></A
><H3
><A
NAME="GNET-INETADDR-GET-INTERFACE-TO"
></A
>gnet_inetaddr_get_interface_to ()</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_get_interface_to  (const <A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
> *addr);</PRE
></TD
></TR
></TABLE
><P
>Figure out which local interface would be used to send a packet to
 <TT
CLASS="PARAMETER"
><I
>addr</I
></TT
>.  This works on some systems, but not others.  We recommend
 using <A
HREF="gnet-inetaddr.html#GNET-INETADDR-AUTODETECT-INTERNET-INTERFACE"
>gnet_inetaddr_autodetect_internet_interface</A
>() to find an
 Internet interface since it's more likely to work.</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="AEN938"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>addr</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="AEN943"><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="AEN948"
></A
><H3
><A
NAME="GNET-INETADDR-GET-INTERNET-INTERFACE"
></A
>gnet_inetaddr_get_internet_interface ()</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_get_internet_interface
                                            (void);</PRE
></TD
></TR
></TABLE
><P
>Find an Internet interface.  This just calls
 <A
HREF="gnet-inetaddr.html#GNET-INETADDR-LIST-INTERFACES"
>gnet_inetaddr_list_interfaces</A
>() and returns the first one that
 passes <A
HREF="gnet-inetaddr.html#GNET-INETADDR-IS-INTERNET"
>gnet_inetaddr_is_internet</A
>().  This works well on some
 systems, but not so well on others.  We recommend using
 <A
HREF="gnet-inetaddr.html#GNET-INETADDR-AUTODETECT-INTERNET-INTERFACE"
>gnet_inetaddr_autodetect_internet_interface</A
>() to find an Internet
 interface since it's more likely to work.</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="AEN959"><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="AEN964"
></A
><H3
><A
NAME="GNET-INETADDR-IS-INTERNET-DOMAINNAME"
></A
>gnet_inetaddr_is_internet_domainname ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    gnet_inetaddr_is_internet_domainname
                                            (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *name);</PRE
></TD
></TR
></TABLE
><P
>Check if the domain name is a sensible Internet domain name.  This
 function uses heuristics and does not use DNS (or even block).
 For example, "localhost" and "10.10.23.42" are not sensible
 Internet domain names.  (10.10.23.42 is a network address, but not
 accessible to the Internet at large.)</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="AEN973"><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="AEN978"><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="AEN983"
></A
><H3
><A
NAME="GNET-INETADDR-LIST-INTERFACES"
></A
>gnet_inetaddr_list_interfaces ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GLIST"
>GList</GTKDOCLINK
>*      gnet_inetaddr_list_interfaces   (void);</PRE
></TD
></TR
></TABLE
><P
>Get a list of <A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
> interfaces's on this host.  This list
 includes all "up" Internet interfaces and the loopback interface,
 if it exists.</P
><P
> Note that the Windows version supports a maximum of 10 interfaces.
 In Windows NT, Service Pack 4 (or higher) is required.</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="AEN993"><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
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnet-gnet.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>&#60;&#60;&#60; Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="book1.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="libgnet-reference.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnet-tcp.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
><TR
><TD
COLSPAN="2"
ALIGN="left"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnet</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>tcp</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
>