gnet-inetaddr.html

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

></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN594"
></A
><H3
><A
NAME="GNET-INETADDR-GET-NAME-ASYNC-CANCEL"
></A
>gnet_inetaddr_get_name_async_cancel ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnet_inetaddr_get_name_async_cancel
                                            (<A
HREF="gnet-inetaddr.html#GINETADDRGETNAMEASYNCID"
>GInetAddrGetNameAsyncID</A
> async_id);</PRE
></TD
></TR
></TABLE
><P
>Cancel an asynchronous nice name lookup that was started with
 <A
HREF="gnet-inetaddr.html#GNET-INETADDR-GET-NAME-ASYNC"
>gnet_inetaddr_get_name_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="AEN603"><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="AEN608"
></A
><H3
><A
NAME="GNET-INETADDR-GET-CANONICAL-NAME"
></A
>gnet_inetaddr_get_canonical_name ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
>*      gnet_inetaddr_get_canonical_name
                                            (const <A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
> *ia);</PRE
></TD
></TR
></TABLE
><P
>Get the "canonical" name of an address (eg, for IP4 the dotted
 decimal name 141.213.8.59).</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="AEN617"><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="AEN622"><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="AEN627"
></A
><H3
><A
NAME="GNET-INETADDR-GET-PORT"
></A
>gnet_inetaddr_get_port ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
>        gnet_inetaddr_get_port          (const <A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
> *ia);</PRE
></TD
></TR
></TABLE
><P
>Get the port number.</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="AEN636"><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="AEN641"><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="AEN646"
></A
><H3
><A
NAME="GNET-INETADDR-SET-PORT"
></A
>gnet_inetaddr_set_port ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnet_inetaddr_set_port          (const <A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
> *ia,
                                             <GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
> port);</PRE
></TD
></TR
></TABLE
><P
>Set the port number.</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="AEN655"><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="AEN660"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>port</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="AEN665"
></A
><H3
><A
NAME="GNET-INETADDR-IS-CANONICAL"
></A
>gnet_inetaddr_is_canonical ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    gnet_inetaddr_is_canonical      (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *name);</PRE
></TD
></TR
></TABLE
><P
>Check if the domain name is canonical.  For IPv4, a canonical name
 is a dotted decimal name (eg, 141.213.8.59).</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="AEN674"><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="AEN679"><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="AEN684"
></A
><H3
><A
NAME="GNET-INETADDR-IS-INTERNET"
></A
>gnet_inetaddr_is_internet ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    gnet_inetaddr_is_internet       (const <A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
> *inetaddr);</PRE
></TD
></TR
></TABLE
><P
>Check if the address is a sensible internet address.  This mean it
 is not private, reserved, loopback, multicast, or broadcast.</P
><P
> Note that private and loopback address are often valid addresses,
 so this should only be used to check for general Internet
 connectivity.  That is, if the address passes, it is reachable on
 the Internet.</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="AEN694"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>inetaddr</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="AEN699"><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="AEN704"
></A
><H3
><A
NAME="GNET-INETADDR-IS-PRIVATE"
></A
>gnet_inetaddr_is_private ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    gnet_inetaddr_is_private        (const <A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
> *inetaddr);</PRE
></TD
></TR
></TABLE
><P
>Check if the address is an address reserved for private networks
 or something else.  This includes:</P
><P
>  10.0.0.0        -   10.255.255.255  (10/8 prefix)
  172.16.0.0      -   172.31.255.255  (172.16/12 prefix)
  192.168.0.0     -   192.168.255.255 (192.168/16 prefix)</P
><P
> (from RFC 1918.  See also draft-manning-dsua-02.txt)</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="AEN715"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>inetaddr</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="AEN720"><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="AEN725"
></A
><H3
><A
NAME="GNET-INETADDR-IS-RESERVED"
></A
>gnet_inetaddr_is_reserved ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    gnet_inetaddr_is_reserved       (const <A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
> *inetaddr);</PRE
></TD
></TR
></TABLE
><P
>Check if the address is reserved for 'something'.  This excludes
 address reserved for private networks.</P
><P
> We check for:
   0.0.0.0/16  (top 16 bits are 0's)
   Class E (top 5 bits are 11110)</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="AEN735"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>inetaddr</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="AEN740"><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="AEN745"
></A
><H3
><A
NAME="GNET-INETADDR-IS-LOOPBACK"
></A
>gnet_inetaddr_is_loopback ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    gnet_inetaddr_is_loopback       (const <A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
> *inetaddr);</PRE
></TD
></TR
></TABLE
><P
>Check if the address is a loopback address.  Loopback addresses
 have the prefix 127.0.0.1/16.</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="AEN754"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>inetaddr</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="AEN759"><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="AEN764"
></A
><H3
><A
NAME="GNET-INETADDR-IS-MULTICAST"
></A
>gnet_inetaddr_is_multicast ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    gnet_inetaddr_is_multicast      (const <A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
> *inetaddr);</PRE
></TD
></TR
></TABLE
><P
>Check if the address is a multicast address.  Multicast address
 are in the range 224.0.0.1 - 239.255.255.255 (ie, the top four
 bits are 1110).</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="AEN773"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>inetaddr</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="AEN778"><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="AEN783"
></A
><H3
><A
NAME="GNET-INETADDR-IS-BROADCAST"
></A
>gnet_inetaddr_is_broadcast ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
>    gnet_inetaddr_is_broadcast      (const <A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
> *inetaddr);</PRE
></TD
></TR
></TABLE
><P
>Check if the address is a broadcast address.  The broadcast
 address is 255.255.255.255.  (Network broadcast address are
 network dependent.)</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="AEN792"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>inetaddr</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="AEN797"><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="AEN802"
></A
><H3
><A
NAME="GNET-INETADDR-HASH"
></A
>gnet_inetaddr_hash ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GUINT"
>guint</GTKDOCLINK
>       gnet_inetaddr_hash              (<GTKDOCLINK
HREF="GCONSTPOINTER"
>gconstpointer</GTKDOCLINK
> p);</PRE
></TD
></TR