src/gras/Transport/transport_private.h

   1 /* transport - low level communication (send/receive bunches of bytes)      */
   2
   3 /* module's private interface masked even to other parts of GRAS.           */
   4
   5 /* Copyright (c) 2004 Martin Quinson. All rights reserved.                  */
   6
   7 /* This program is free software; you can redistribute it and/or modify it
   8  * under the terms of the license (GNU LGPL) which comes with this package. */
   9
  10 #ifndef GRAS_TRP_PRIVATE_H
  11 #define GRAS_TRP_PRIVATE_H
  12
  13 #include "xbt/sysdep.h"
  14 #include "xbt/log.h"
  15 #include "xbt/dynar.h"
  16 #include "xbt/dict.h"
  17
  18 #include "gras/emul.h"          /* gras_if_RL() */
  19
  20 #include "gras_modinter.h"      /* module init/exit */
  21 #include "gras/transport.h"     /* rest of module interface */
  22
  23 #include "gras/Transport/transport_interface.h" /* semi-public API */
  24 #include "gras/Virtu/virtu_interface.h" /* libdata management */
  25
  26 extern int gras_trp_libdata_id; /* our libdata identifier */
  27
  28 /* The function that select returned the last time we asked. We need this
  29    because the TCP read are greedy and try to get as much data in their
  30    buffer as possible (to avoid subsequent syscalls).
  31    (measurement sockets are not buffered and thus not concerned).
  32
  33    So, we can get more than one message in one shoot. And when this happens,
  34    we have to handle the same socket again afterward without select()ing at
  35    all.
  36
  37    Then, this data is not a static of the TCP driver because we want to
  38    zero it when it gets closed by the user. If not, we use an already freed
  39    pointer, which is bad.
  40
  41    It gets tricky since gras_socket_close is part of the common API, not
  42    only the RL one. */
  43 extern gras_socket_t _gras_lastly_selected_socket;
  44
  45 /**
  46  * s_gras_socket:
  47  *
  48  * Description of a socket.
  49  */
  50 typedef struct gras_trp_bufdata_ gras_trp_bufdata_t;
  51
  52 typedef struct s_gras_socket {
  53   gras_trp_plugin_t plugin;
  54
  55   int incoming:1;               /* true if we can read from this sock */
  56   int outgoing:1;               /* true if we can write on this sock */
  57   int accepting:1;              /* true if master incoming sock in tcp */
  58   int meas:1;                   /* true if this is an experiment socket instead of messaging */
  59   int valid:1;                  /* false if a select returned that the peer quitted, forcing us to "close" the socket */
  60   int moredata:1;               /* TCP socket use a buffer and read operation get as much
  61                                    data as possible. It is possible that several messages
  62                                    are received in one shoot, and select won't catch them
  63                                    afterward again.
  64                                    This boolean indicates that this is the case, so that we
  65                                    don't call select in that case.  Note that measurement
  66                                    sockets are not concerned since they use the TCP
  67                                    interface directly, with no buffer. */
  68
  69   int recvd:1;                  /* true if the recvd_val field contains one byte of the stream (that we peek'ed to check the socket validity) */
  70   char recvd_val;               /* what we peeked from the socket, if any */
  71
  72   unsigned long int buf_size;   /* what to say to the OS.
  73                                    Field here to remember it when accepting */
  74
  75   int sd;
  76   int port;                     /* port on this side */
  77   int peer_port;                /* port on the other side */
  78   char *peer_name;              /* hostname of the other side */
  79   char *peer_proc;              /* process on the other side */
  80
  81   void *data;                   /* plugin specific data */
  82
  83   /* buffer plugin specific data. Yeah, C is not OO, so I got to trick */
  84   gras_trp_bufdata_t *bufdata;
  85 } s_gras_socket_t;
  86
  87 void gras_trp_socket_new(int incomming, gras_socket_t * dst);
  88
  89 /* The drivers */
  90 typedef void (*gras_trp_setup_t) (gras_trp_plugin_t dst);
  91
  92 void gras_trp_tcp_setup(gras_trp_plugin_t plug);
  93 void gras_trp_iov_setup(gras_trp_plugin_t plug);
  94 void gras_trp_file_setup(gras_trp_plugin_t plug);
  95 void gras_trp_sg_setup(gras_trp_plugin_t plug);
  96
  97 /* FIXME: this should be solved by SIMIX
  98
  99   I'm tired of that shit. the select in SG has to create a socket to expeditor
 100   manually do deal with the weirdness of the hostdata, themselves here to deal
 101   with the weird channel concept of SG and convert them back to ports.
 102
 103   When introducing buffered transport (which I want to get used in SG to debug
 104   the buffering itself), we should not make the rest of the code aware of the
 105   change and not specify code for this. This is bad design.
 106
 107   But there is bad design all over the place, so fuck off for now, when we can
 108   get rid of MSG and rely directly on SG, this crude hack can go away. But in
 109   the meanwhile, I want to sleep this night (FIXME).
 110
 111   Hu! You evil problem! Taste my axe!
 112
 113 */
 114
 115 gras_socket_t gras_trp_buf_init_sock(gras_socket_t sock);
 116
 117 #endif /* GRAS_TRP_PRIVATE_H */