3 /* transport - low level communication */
5 /* Authors: Martin Quinson */
6 /* Copyright (C) 2004 Martin Quinson. */
8 /* This program is free software; you can redistribute it and/or modify it
9 under the terms of the license (GNU LGPL) which comes with this package. */
11 #include "gras/Transport/transport_private.h"
13 GRAS_LOG_NEW_DEFAULT_SUBCATEGORY(transport,gras,"Conveying bytes over the network");
15 static gras_dict_t *_gras_trp_plugins; /* All registered plugins */
16 static void gras_trp_plugin_free(void *p); /* free one of the plugins */
18 static void gras_trp_socket_free(void *s); /* free one socket */
21 gras_trp_plugin_new(const char *name, gras_trp_setup_t setup);
24 gras_trp_plugin_new(const char *name, gras_trp_setup_t setup) {
27 gras_trp_plugin_t *plug = gras_new0(gras_trp_plugin_t, 1);
29 DEBUG1("Create plugin %s",name);
34 plug->name=(char*)strdup(name);
38 errcode = setup(plug);
41 /* SG plugin return mismatch when in RL mode (and vice versa) */
42 gras_free(plug->name);
47 TRY(gras_dict_set(_gras_trp_plugins,
48 name, plug, gras_trp_plugin_free));
62 /* make room for all plugins */
63 TRY(gras_dict_new(&_gras_trp_plugins));
66 TRY(gras_trp_plugin_new("tcp", gras_trp_tcp_setup));
67 TRY(gras_trp_plugin_new("file",gras_trp_file_setup));
68 TRY(gras_trp_plugin_new("sg",gras_trp_sg_setup));
70 /* buf is composed, so it must come after the others */
71 TRY(gras_trp_plugin_new("buf", gras_trp_buf_setup));
78 gras_dict_free(&_gras_trp_plugins);
82 void gras_trp_plugin_free(void *p) {
83 gras_trp_plugin_t *plug = p;
88 } else if (plug->data) {
89 DEBUG1("Plugin %s lacks exit(). Free data anyway.",plug->name);
90 gras_free(plug->data);
93 gras_free(plug->name);
100 * gras_trp_socket_new:
102 * Malloc a new socket, and initialize it with defaults
104 gras_error_t gras_trp_socket_new(int incoming,
105 gras_socket_t **dst) {
109 if (! (sock=gras_new(gras_socket_t,1)) )
111 DEBUG1("Create a new socket (%p)", (void*)sock);
117 sock->incoming = incoming ? 1:0;
118 sock->outgoing = incoming ? 0:1;
119 sock->accepting = incoming ? 1:0;
122 sock->peer_port = -1;
123 sock->peer_name = NULL;
128 return gras_dynar_push(gras_socketset_get(),dst);
133 * gras_socket_server:
135 * Opens a server socket and make it ready to be listened to.
136 * In real life, you'll get a TCP socket.
139 gras_socket_server(unsigned short port,
140 /* OUT */ gras_socket_t **dst) {
142 gras_error_t errcode;
143 gras_trp_plugin_t *trp;
148 DEBUG1("Create a server socket from plugin %s",gras_if_RL() ? "tcp" : "sg");
149 TRY(gras_trp_plugin_get_by_name("buf",&trp));
151 /* defaults settings */
152 TRY(gras_trp_socket_new(1,&sock));
156 /* Call plugin socket creation function */
157 errcode = trp->socket_server(trp, port, sock);
158 DEBUG3("in=%c out=%c accept=%c",
159 sock->incoming?'y':'n',
160 sock->outgoing?'y':'n',
161 sock->accepting?'y':'n');
163 if (errcode != no_error) {
174 * gras_socket_client:
176 * Opens a client socket to a remote host.
177 * In real life, you'll get a TCP socket.
180 gras_socket_client(const char *host,
182 /* OUT */ gras_socket_t **dst) {
184 gras_error_t errcode;
185 gras_trp_plugin_t *trp;
190 TRY(gras_trp_plugin_get_by_name("buf",&trp));
192 DEBUG1("Create a client socket from plugin %s",gras_if_RL() ? "tcp" : "sg");
193 /* defaults settings */
194 TRY(gras_trp_socket_new(0,&sock));
196 sock->peer_port = port;
197 sock->peer_name = (char*)strdup(host?host:"localhost");
199 /* plugin-specific */
200 errcode= (*trp->socket_client)(trp,
201 host ? host : "localhost", port,
203 DEBUG3("in=%c out=%c accept=%c",
204 sock->incoming?'y':'n',
205 sock->outgoing?'y':'n',
206 sock->accepting?'y':'n');
208 if (errcode != no_error) {
218 void gras_socket_close(gras_socket_t *sock) {
219 gras_dynar_t *sockets = gras_socketset_get();
220 gras_socket_t *sock_iter;
223 /* FIXME: Issue an event when the socket is closed */
225 gras_dynar_foreach(sockets,cursor,sock_iter) {
226 if (sock == sock_iter) {
227 gras_dynar_cursor_rm(sockets,&cursor);
228 if ( sock->plugin->socket_close)
229 (* sock->plugin->socket_close)(sock);
231 /* free the memory */
233 gras_free(sock->peer_name);
238 WARN0("Ignoring request to free an unknown socket");
243 * gras_trp_chunk_send:
245 * Send a bunch of bytes from on socket
248 gras_trp_chunk_send(gras_socket_t *sd,
251 gras_assert1(sd->outgoing,
252 "Socket not suited for data send (outgoing=%c)",
253 sd->outgoing?'y':'n');
254 gras_assert1(sd->plugin->chunk_send,
255 "No function chunk_send on transport plugin %s",
257 return (*sd->plugin->chunk_send)(sd,data,size);
260 * gras_trp_chunk_recv:
262 * Receive a bunch of bytes from a socket
265 gras_trp_chunk_recv(gras_socket_t *sd,
268 gras_assert0(sd->incoming,
269 "Socket not suited for data receive");
270 gras_assert1(sd->plugin->chunk_recv,
271 "No function chunk_recv on transport plugin %s",
273 return (sd->plugin->chunk_recv)(sd,data,size);
279 * Make sure all pending communications are done
282 gras_trp_flush(gras_socket_t *sd) {
283 return (sd->plugin->flush)(sd);
287 gras_trp_plugin_get_by_name(const char *name,
288 gras_trp_plugin_t **dst){
290 return gras_dict_get(_gras_trp_plugins,name,(void**)dst);
293 int gras_socket_my_port (gras_socket_t *sock) {
296 int gras_socket_peer_port(gras_socket_t *sock) {
297 return sock->peer_port;
299 char *gras_socket_peer_name(gras_socket_t *sock) {
300 return sock->peer_name;