GNetworkTcpServer

GNetworkTcpServer — The incoming connection handling object.

Synopsis




struct      GNetworkTcpServer;
struct      GNetworkTcpServerClass;
GNetworkTcpServer* gnetwork_tcp_server_new  (guint port,
                                             const gchar *address);
struct      GNetworkTcpServerCreationData;
GNetworkTcpServerCreationData* gnetwork_tcp_server_creation_data_dup
                                            (GNetworkTcpServerCreationData *src);
void        gnetwork_tcp_server_creation_data_free
                                            (GNetworkTcpServerCreationData *data);


Object Hierarchy


  GObject
   +----GNetworkTcpServer

Implemented Interfaces

GNetworkTcpServer implements GNetworkServer.

Properties


  "address"              gchararray           : Read / Write / Construct
  "port"                 guint                : Read / Write / Construct
  "reverse-lookups"      gboolean             : Read / Write / Construct

Description

The GNetworkTcpServer object and associated functions provides a flexible method for handling incoming connections to a specified port.

Details

struct GNetworkTcpServer

struct GNetworkTcpServer;

This structure contains no public data.


struct GNetworkTcpServerClass

struct GNetworkTcpServerClass {

};

The class structure for a GNetworkTcpServer object.


gnetwork_tcp_server_new ()

GNetworkTcpServer* gnetwork_tcp_server_new  (guint port,
                                             const gchar *address);

Creates a new, unopened server object for incoming connections on address:port. See gnetwork_tcp_server_set_address() for more information on how to use the address parameter.

port : the local port to allow connections through.
address : the local IP address to use, or NULL.
Returns : a new GNetworkTcpServer object.

Since 1.0


struct GNetworkTcpServerCreationData

struct GNetworkTcpServerCreationData {

  gchar *address;
  guint16 port;
  gint fd;
};

The data GNetworkTcpServer passes via a GValue's boxed field to the user-set "create func".

gchar *addressthe remote IP address of the connection.
guint16 portthe remote port of the connection.
gint fdthe socket file descriptor.

gnetwork_tcp_server_creation_data_dup ()

GNetworkTcpServerCreationData* gnetwork_tcp_server_creation_data_dup
                                            (GNetworkTcpServerCreationData *src);

Creates a copy of the creation data in src. The returned data should be freed with gnetwork_tcp_server_creation_data_free() when no longer needed.

src : the creation data to copy.
Returns : a newly allocated copy of src.

Since 1.0


gnetwork_tcp_server_creation_data_free ()

void        gnetwork_tcp_server_creation_data_free
                                            (GNetworkTcpServerCreationData *data);

Frees the memory used by data.

data : the creation data to delete.

Since 1.0

Properties

"address" (gchararray : Read / Write / Construct)

The hostname or IP address of the interface to use.

"port" (guint : Read / Write / Construct)

The port number to allow connections to.

"reverse-lookups" (gboolean : Read / Write / Construct)

Whether or not to perform reverse lookups on incoming connections.