Conn
TCP connection object
A #GConn represents a TCP connection. A #GConn is created directly by
calling gnet_conn_new() or gnet_conn_new_inetaddr(). To connect to
the host, call gnet_conn_connect() and to disconnect call
gnet_conn_disconnect(). #GConn's are also created by a #GServer when
a client connects. Call gnet_conn_set_callback() to set the #GConn
callback after it is created by the #GServer. To disconnect and
delete the GConn, call gnet_conn_delete().
The iochannel field and #GIOChannel functions can be used to read from
or write to the socket. #GIOChannel functions block. To make an
asynchronous read call gnet_conn_read() and to make an asynchronous
write call gnet_conn_write(). The callback is called whenever a read
or write completes.
Use gnet_conn_set_watch_error() to get an event if an error occurs.
Use gnet_conn_set_watch_readable() and gnet_conn_set_watch_writable()
to get events when the connection is readable or writable. These can
be used to implement custom I/O handling. For example, consider
writing from a mmap()'ed file. gnet_conn_write() will allocate memory
for a buffer and copy part of the file into the buffer. To avoid the
copy, use gnet_conn_set_watch_writable() to catch the writable event
and then write directly from memory to the socket.
gnet_conn_timeout() sets a timeout on the GConn. The
%GNET_CONN_TIMEOUT event occurs when the timer expires. For example,
the timer may be set before connecting to the host. If the connection
is made, the %GNET_CONN_CONNECT event occurs. The timer can then be
reset by setting the timeout to 0. Otherwise, the %GNET_CONN_TIMEOUT
event will eventually occur.
See also GServer and the echoclient-gconn example.
@hostname:
@port:
@iochannel:
@socket:
@inetaddr:
@ref_count:
@ref_count_internal:
@connect_id:
@new_id:
@write_queue:
@bytes_written:
@buffer:
@length:
@bytes_read:
@read_eof:
@read_queue:
@process_buffer_timeout:
@watch_readable:
@watch_writable:
@watch_flags:
@watch:
@timer:
@func:
@user_data:
@type:
@buffer:
@length:
@GNET_CONN_ERROR:
@GNET_CONN_CONNECT:
@GNET_CONN_CLOSE:
@GNET_CONN_TIMEOUT:
@GNET_CONN_READ:
@GNET_CONN_WRITE:
@GNET_CONN_READABLE:
@GNET_CONN_WRITABLE:
@conn:
@event:
@user_data:
@hostname:
@port:
@func:
@user_data:
@Returns:
@inetaddr:
@func:
@user_data:
@Returns:
@socket:
@func:
@user_data:
@Returns:
@conn:
@conn:
@conn:
@conn:
@func:
@user_data:
@conn:
@conn:
@conn:
@Returns:
@conn:
@conn:
@length:
@conn:
@conn:
@buffer:
@length:
@conn:
@enable:
@conn:
@enable:
@conn:
@enable:
@conn:
@timeout: