gnet-udp.html

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

VALIGN="TOP"
WIDTH="80%"
><P
></P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN2299"><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="AEN2304"
></A
><H3
><A
NAME="GNET-UDP-SOCKET-GET-MCAST-TTL"
></A
>gnet_udp_socket_get_mcast_ttl ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
>        gnet_udp_socket_get_mcast_ttl   (const <A
HREF="gnet-udp.html#GUDPSOCKET"
>GUdpSocket</A
> *us);</PRE
></TD
></TR
></TABLE
><P
>Get the TTL for outgoing multicast packests.  TTL is the Time To
 Live - the number of hops outgoing packets will travel.  The
 default TTL is usually 1, which mean outgoing packets will only
 travel as far as the local subnet.</P
><P
> This reason this function is in the UDP module is that UdpSocket's
 (as well as McastSocket's) can be used to sent to multicast
 groups.</P
><P
> Here's a handy table.  Note that the "meaning" really doesn't mean
 anything.  The mcast people basically just gave them these names
 because they sounded cool.</P
><P
> &lt;table&gt;
   &lt;title&gt;TTL and "meaning"&lt;/title&gt;
   &lt;tgroup cols=2 align=left&gt;
   &lt;thead&gt;
     &lt;row&gt;
       &lt;entry&gt;TTL&lt;/entry&gt;
       &lt;entry&gt;meaning&lt;/entry&gt;
     &lt;/row&gt;
   &lt;/thead&gt;
   &lt;tbody&gt;
     &lt;row&gt;
       &lt;entry&gt;0&lt;/entry&gt;
       &lt;entry&gt;node local&lt;/entry&gt;
     &lt;/row&gt;
     &lt;row&gt;
       &lt;entry&gt;1&lt;/entry&gt;
       &lt;entry&gt;link local&lt;/entry&gt;
     &lt;/row&gt;
     &lt;row&gt;
       &lt;entry&gt;2-32&lt;/entry&gt;
       &lt;entry&gt;site local&lt;/entry&gt;
     &lt;/row&gt;
     &lt;row&gt;
       &lt;entry&gt;33-64&lt;/entry&gt;
       &lt;entry&gt;region local&lt;/entry&gt;
     &lt;/row&gt;
     &lt;row&gt;
       &lt;entry&gt;65-128&lt;/entry&gt;
       &lt;entry&gt;continent local&lt;/entry&gt;
     &lt;/row&gt;
     &lt;row&gt;
       &lt;entry&gt;129-255&lt;/entry&gt;
       &lt;entry&gt;unrestricted (global)&lt;/entry&gt;
     &lt;/row&gt;
   &lt;/tbody&gt;
 &lt;/table&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="AEN2316"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>us</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="AEN2321"><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="AEN2326"
></A
><H3
><A
NAME="GNET-UDP-SOCKET-SET-MCAST-TTL"
></A
>gnet_udp_socket_set_mcast_ttl ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
>        gnet_udp_socket_set_mcast_ttl   (<A
HREF="gnet-udp.html#GUDPSOCKET"
>GUdpSocket</A
> *us,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> val);</PRE
></TD
></TR
></TABLE
><P
>Set the TTL for outgoing multicast packets.</P
><P
> This reason this function is in the UDP module is that UdpSocket's
 (as well as McastSocket's) can be used to sent to multicast
 groups.</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="AEN2337"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>us</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="AEN2342"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>val</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="AEN2347"><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="AEN2352"
></A
><H3
><A
NAME="GNET-UDP-PACKET-RECEIVE-NEW"
></A
>gnet_udp_packet_receive_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnet-udp.html#GUDPPACKET"
>GUdpPacket</A
>* gnet_udp_packet_receive_new     (<GTKDOCLINK
HREF="GUINT8"
>guint8</GTKDOCLINK
> *data,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> length);</PRE
></TD
></TR
></TABLE
><P
>Create a packet for receiving.  <TT
CLASS="PARAMETER"
><I
>data</I
></TT
> is a shallow copy and must
 be deallocated by the caller if necessary when appropriate.</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="AEN2363"><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="AEN2368"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>length</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="AEN2373"><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="AEN2378"
></A
><H3
><A
NAME="GNET-UDP-PACKET-SEND-NEW"
></A
>gnet_udp_packet_send_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnet-udp.html#GUDPPACKET"
>GUdpPacket</A
>* gnet_udp_packet_send_new        (<GTKDOCLINK
HREF="GUINT8"
>guint8</GTKDOCLINK
> *data,
                                             <GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> length,
                                             <A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
> *addr);</PRE
></TD
></TR
></TABLE
><P
>Create a packet for sending.  The fields of the new packet are
 public.  <TT
CLASS="PARAMETER"
><I
>data</I
></TT
> and <TT
CLASS="PARAMETER"
><I
>addr</I
></TT
> are shallow copies and must be
 deallocated by the caller if necessary when appropriate.</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="AEN2391"><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="AEN2396"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>length</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="AEN2401"><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="AEN2406"><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="AEN2411"
></A
><H3
><A
NAME="GNET-UDP-PACKET-DELETE"
></A
>gnet_udp_packet_delete ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnet_udp_packet_delete          (<A
HREF="gnet-udp.html#GUDPPACKET"
>GUdpPacket</A
> *packet);</PRE
></TD
></TR
></TABLE
><P
>Delete a UDP packet.  The fields "data" and "addr" are not deleted
 and should be deallocated by the programmer if necessary when
 appropriate.</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="AEN2419"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>packet</I
></TT
>&nbsp;:</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-socks.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-mcast.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
>socks</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>mcast</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
>