Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
remove gras from the main documentation
[simgrid.git] / src / gras / Transport / transport_private.h
index bef632e..9f67861 100644 (file)
-/* $Id$ */
+/* transport - low level communication (send/receive bunches of bytes)      */
 
-/* trp (transport) - send/receive a bunch of bytes                          */
+/* module's private interface masked even to other parts of GRAS.           */
 
-/* This file implements the public interface of this module, exported to the*/
-/*  other modules of GRAS, but not to the end user.                         */
-
-/* Authors: Martin Quinson                                                  */
-/* Copyright (C) 2004 Martin Quinson.                                       */
+/* Copyright (c) 2004, 2005, 2006, 2007, 2009, 2010. The SimGrid Team.
+ * All rights reserved.                                                     */
 
 /* This program is free software; you can redistribute it and/or modify it
  under the terms of the license (GNU LGPL) which comes with this package. */
* under the terms of the license (GNU LGPL) which comes with this package. */
 
 #ifndef GRAS_TRP_PRIVATE_H
 #define GRAS_TRP_PRIVATE_H
 
-#include "gras_private.h"
-/* A low-level socket type (each plugin implements it the way it prefers */
-//typedef void gras_trp_sock_t;
-/* A plugin type */
-struct gras_trp_plugin_ {
-  const char *name;
-  gras_error_t (*init)(void);
-  void         (*exit)(gras_trp_plugin_t *);
-  gras_error_t (*socket_client_open)(const char *host,
-                                     unsigned short port,
-                                     int raw,
-                                     unsigned int bufSize,
-                                     /* OUT */ gras_trp_sock_t **dst);
-  gras_error_t (*socket_server_open)(unsigned short port,
-                                     int raw,
-                                     unsigned int bufSize,
-                                     /* OUT */ gras_trp_sock_t **dst);
-  void (*socket_close)(gras_trp_sock_t **sd);
-  gras_error_t (*select)(double timeOut,
-                         gras_trp_sock_t **sd);
-   
-  gras_error_t (*bloc_send)(gras_trp_sock_t *sd,
-                            void *data,
-                            size_t size,
-                            double timeOut);
-  gras_error_t (*bloc_recv)(gras_trp_sock_t *sd,
-                            void *data,
-                            size_t size,
-                            double timeOut);
-  gras_error_t (*flush)(gras_trp_sock_t *sd);
-  void *specific;
-};
+#include "xbt/sysdep.h"
+#include "xbt/log.h"
+#include "xbt/dynar.h"
+#include "xbt/dict.h"
 
-/**********************************************************************
- * Internal stuff to the module. Other modules shouldn't fool with it *
- **********************************************************************/
+#include "gras/emul.h"          /* gras_if_RL() */
 
-/* TCP driver */
-gras_error_t gras_trp_tcp_init(void);
-void         gras_trp_tcp_exit(gras_trp_plugin_t *plugin);
-gras_error_t gras_trp_tcp_socket_client(const char *host,
-                                       unsigned short port,
-                                       int raw, 
-                                       unsigned int bufSize, 
-                                       /* OUT */ gras_trp_sock_t **dst);
-gras_error_t gras_trp_tcp_socket_server(unsigned short port,
-                                       int raw, 
-                                       unsigned int bufSize, 
-                                       /* OUT */ gras_trp_sock_t **dst);
-void         gras_trp_tcp_socket_close(gras_trp_sock_t **sd);
-gras_error_t gras_trp_tcp_select(double timeOut,
-                                gras_trp_sock_t **sd);
-  
-gras_error_t gras_trp_tcp_bloc_send(gras_trp_sock_t *sd,
-                                   void *data,
-                                   size_t size,
-                                   double timeOut);
+#include "gras_modinter.h"      /* module init/exit */
+#include "gras/transport.h"     /* rest of module interface */
 
-gras_error_t gras_trp_tcp_bloc_recv(gras_trp_sock_t *sd,
-                                   void *data,
-                                   size_t size,
-                                   double timeOut);
-gras_error_t gras_trp_tcp_flush(gras_trp_sock_t *sd);
-
-/* SG driver */
-gras_error_t gras_trp_sg_init(void);
-void         gras_trp_sg_exit(gras_trp_plugin_t *plugin);
-gras_error_t gras_trp_sg_socket_client(const char *host,
-                                      unsigned short port,
-                                      int raw, 
-                                      unsigned int bufSize, 
-                                      /* OUT */ gras_trp_sock_t **dst);
-gras_error_t gras_trp_sg_socket_server(unsigned short port,
-                                      int raw, 
-                                      unsigned int bufSize, 
-                                      /* OUT */ gras_trp_sock_t **dst);
-void         gras_trp_sg_socket_close(gras_trp_sock_t **sd);
-gras_error_t gras_trp_sg_select(double timeOut,
-                               gras_trp_sock_t **sd);
-
-gras_error_t gras_trp_sg_bloc_send(gras_trp_sock_t *sd,
-                                  void *data,
-                                  size_t size,
-                                  double timeOut);
-
-gras_error_t gras_trp_sg_bloc_recv(gras_trp_sock_t *sd,
-                                  void *data,
-                                  size_t size,
-                                  double timeOut);
-gras_error_t gras_trp_sg_flush(gras_trp_sock_t *sd);
+#include "gras/Transport/transport_interface.h" /* semi-public API */
+#include "gras/Virtu/virtu_interface.h" /* libdata management */
 
+extern int gras_trp_libdata_id; /* our libdata identifier */
 
+/* The function that select returned the last time we asked. We need this
+   because the TCP read are greedy and try to get as much data in their 
+   buffer as possible (to avoid subsequent syscalls).
+   (measurement sockets are not buffered and thus not concerned).
+  
+   So, we can get more than one message in one shoot. And when this happens,
+   we have to handle the same socket again afterward without select()ing at
+   all. 
+   Then, this data is not a static of the TCP driver because we want to
+   zero it when it gets closed by the user. If not, we use an already freed 
+   pointer, which is bad.
+   It gets tricky since gras_socket_close is part of the common API, not 
+   only the RL one. */
+extern xbt_socket_t _gras_lastly_selected_socket;
 
-#endif /* GRAS_TRP_PRIVATE_H */
+#endif                          /* GRAS_TRP_PRIVATE_H */