gnet-tcp.html

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

></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1349"
></A
><H3
><A
NAME="GNET-TCP-SOCKET-REF"
></A
>gnet_tcp_socket_ref ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnet_tcp_socket_ref             (<A
HREF="gnet-tcp.html#GTCPSOCKET"
>GTcpSocket</A
> *s);</PRE
></TD
></TR
></TABLE
><P
>Increment the reference counter of the GTcpSocket.</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="AEN1357"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>s</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="AEN1362"
></A
><H3
><A
NAME="GNET-TCP-SOCKET-UNREF"
></A
>gnet_tcp_socket_unref ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnet_tcp_socket_unref           (<A
HREF="gnet-tcp.html#GTCPSOCKET"
>GTcpSocket</A
> *s);</PRE
></TD
></TR
></TABLE
><P
>Remove a reference from the <A
HREF="gnet-tcp.html#GTCPSOCKET"
>GTcpSocket</A
>.  When reference count
 reaches 0, the socket 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="AEN1371"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>s</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="AEN1376"
></A
><H3
><A
NAME="GNET-TCP-SOCKET-GET-IOCHANNEL"
></A
>gnet_tcp_socket_get_iochannel ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GIOCHANNEL"
>GIOChannel</GTKDOCLINK
>* gnet_tcp_socket_get_iochannel   (<A
HREF="gnet-tcp.html#GTCPSOCKET"
>GTcpSocket</A
> *socket);</PRE
></TD
></TR
></TABLE
><P
>Get the <GTKDOCLINK
HREF="GIOCHANNEL"
>GIOChannel</GTKDOCLINK
> for the <A
HREF="gnet-tcp.html#GTCPSOCKET"
>GTcpSocket</A
>.</P
><P
> For a client socket, the <GTKDOCLINK
HREF="GIOCHANNEL"
>GIOChannel</GTKDOCLINK
> represents the data stream.
 Use it like you would any other <GTKDOCLINK
HREF="GIOCHANNEL"
>GIOChannel</GTKDOCLINK
>.</P
><P
> For a server socket however, the <GTKDOCLINK
HREF="GIOCHANNEL"
>GIOChannel</GTKDOCLINK
> represents incoming
 connections.  If you can read from it, there's a connection
 waiting.</P
><P
> There is one channel for every socket.  This function refs the
 channel before returning it.  You should unref the channel when
 you are done with it.  However, you should not close the channel -
 this is done when you delete the socket.</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="AEN1393"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>socket</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="AEN1398"><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="AEN1403"
></A
><H3
><A
NAME="GNET-TCP-SOCKET-GET-INETADDR"
></A
>gnet_tcp_socket_get_inetaddr ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
>*  gnet_tcp_socket_get_inetaddr    (const <A
HREF="gnet-tcp.html#GTCPSOCKET"
>GTcpSocket</A
> *socket);</PRE
></TD
></TR
></TABLE
><P
>Get the address of the socket.  If the socket is client socket,
 the address is the address of the remote host it is connected to.
 If the socket is a server socket, the address is the address of
 the local host.  (Though you should use
 <A
HREF="gnet-inetaddr.html#GNET-INETADDR-GETHOSTADDR"
>gnet_inetaddr_gethostaddr</A
>() to get the <A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
> of the local
 host.)</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="AEN1414"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>socket</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="AEN1419"><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="AEN1424"
></A
><H3
><A
NAME="GNET-TCP-SOCKET-GET-PORT"
></A
>gnet_tcp_socket_get_port ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
>        gnet_tcp_socket_get_port        (const <A
HREF="gnet-tcp.html#GTCPSOCKET"
>GTcpSocket</A
> *socket);</PRE
></TD
></TR
></TABLE
><P
>Get the port number the socket is bound to.</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="AEN1433"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>socket</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="AEN1438"><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="AEN1443"
></A
><H3
><A
NAME="GNETTOS"
></A
>enum GNetTOS</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef enum
{
  GNET_TOS_NONE,
  GNET_TOS_LOWDELAY,
  GNET_TOS_THROUGHPUT,
  GNET_TOS_RELIABILITY,
  GNET_TOS_LOWCOST

} GNetTOS;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN1448"
></A
><H3
><A
NAME="GNET-TCP-SOCKET-SET-TOS"
></A
>gnet_tcp_socket_set_tos ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnet_tcp_socket_set_tos         (<A
HREF="gnet-tcp.html#GTCPSOCKET"
>GTcpSocket</A
> *socket,
                                             <A
HREF="gnet-tcp.html#GNETTOS"
>GNetTOS</A
> tos);</PRE
></TD
></TR
></TABLE
><P
>Set the type-of-service of the socket.  Usually, routers don't
 honor this.  Some systems don't support this function.  If the
 operating system does not support it, the function does nothing.</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="AEN1457"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>socket</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="AEN1462"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>tos</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="AEN1467"
></A
><H3
><A
NAME="GNET-TCP-SOCKET-SERVER-NEW"
></A
>gnet_tcp_socket_server_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnet-tcp.html#GTCPSOCKET"
>GTcpSocket</A
>* gnet_tcp_socket_server_new      (<GTKDOCLINK
HREF="GINT"
>gint</GTKDOCLINK
> port);</PRE
></TD
></TR
></TABLE
><P
>Create and open a new <A
HREF="gnet-tcp.html#GTCPSOCKET"
>GTcpSocket</A
> with the specified port number.
 Use this sort of socket when you are a server and you know what
 the port number should be (or pass 0 if you don't care what the
 port is).  SOCKS is used if SOCKS is enabled.</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="AEN1477"><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="AEN1482"><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="AEN1487"
></A
><H3
><A
NAME="GNET-TCP-SOCKET-SERVER-NEW-INTERFACE"
></A
>gnet_tcp_socket_server_new_interface ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnet-tcp.html#GTCPSOCKET"
>GTcpSocket</A
>* gnet_tcp_socket_server_new_interface
                                            (const <A
HREF="gnet-inetaddr.html#GINETADDR"
>GInetAddr</A
> *iface);</PRE
></TD
></TR
></TABLE
><P
>Create and open a new <A
HREF="gnet-tcp.html#GTCPSOCKET"
>GTcpSocket</A
> bound to the specified
 interface.  Use this sort of socket when your are a server and
 have a specific address the server must be bound to.  If the port
 number of the interface address is 0, the OS will use the
 interface specified but choose the port itself.  If the interface
 address is NULL, the OS will choose both the interface and port.
 If the interface address was created by <A
HREF="gnet-inetaddr.html#GNET-INETADDR-NEW-ANY"
>gnet_inetaddr_new_any</A
>(),
 the OS will use all interfaces.  If the port number is also set,
 it will use that port number.  SOCKS is used if SOCKS is enabled
 and the interface is 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="AEN1498"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>iface</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="AEN1503"><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="AEN1508"
></A
><H3
><A
NAME="GNET-TCP-SOCKET-SERVER-ACCEPT"
></A
>gnet_tcp_socket_server_accept ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnet-tcp.html#GTCPSOCKET"
>GTcpSocket</A
>* gnet_tcp_socket_server_accept   (<A
HREF="gnet-tcp.html#GTCPSOCKET"
>GTcpSocket</A
> *socket);</PRE
></TD
></TR
></TABLE
><P
>Accept a connection from the socket.  The socket must have been
 created using <A
HREF="gnet-tcp.html#GNET-TCP-SOCKET-SERVER-NEW"
>gnet_tcp_socket_server_new</A
>().  This function will
 block (use <A
HREF="gnet-tcp.html#GNET-TCP-SOCKET-SERVER-ACCEPT-NONBLOCK"
>gnet_tcp_socket_server_accept_nonblock</A
>() if you don't
 want to block).  If the socket's <GTKDOCLINK
HREF="GIOCHANNEL"
>GIOChannel</GTKDOCLINK
> is readable, it DOES
 NOT mean that this function will not block.</P
><P
></P
><P