TODO

   1 ###
   2 ### Ongoing stuff
   3 ###
   4 /* FIXME: better place? */
   5 int vasprintf  (char **ptr, const char *fmt, va_list ap);
   6 char *bprintf(const char*fmt, ...) _XBT_GNUC_PRINTF(1,2);
   7
   8 Module renamings:
   9  - rename SWAG to RING?
  10  - Rename cursor to iterator
  11
  12 log.h still contains @name which break doxygen:
  13 xbt/log.h:/** \name DEBUG
  14 xbt/log.h:/** \name VERB
  15 xbt/log.h:/** \name INFO
  16 xbt/log.h:/** \name WARN
  17 xbt/log.h:/** \name ERROR
  18 xbt/log.h:/** \name CRITICAL
  19
  20
  21 ###
  22 ### Planned
  23 ###
  24
  25 *
  26 * Infrastructure
  27 ****************
  28
  29 [autoconf]
  30   * Check the gcc version on powerpc. We disabled -floop-optimize on powerpc,
  31     but versions above 3.4.0 should be ok.
  32   * check whether we have better than jmp_buf to implement exceptions, and
  33     use it (may need to generate a public .h, as glib does)
  34
  35 *
  36 * XBT
  37 *****
  38
  39 [doc]
  40   * graphic showing:
  41     (errors, logs ; dynars, dicts, hooks, pools; config, rrdb)
  42
  43 [portability layer]
  44   * Mallocators and/or memory pool so that we can cleanly kill an actor
  45
  46 [errors/exception]
  47   * Better split casual errors from programing errors.
  48     The first ones should be repported to the user, the second should kill
  49     the program (or, yet better, only the msg handler)
  50   * Allows the use of an error handler depending on the current module (ie,
  51     the same philosophy as log4c using GSL's error functions)
  52
  53 [logs]
  54   * Hijack message from a given category to another for a while (to mask
  55     initializations, and more)
  56   * Allow each actor to have its own setting
  57   * a init/exit mecanism for logging appender
  58   * Several appenders; fix the setting stuff to change the appender
  59   * more logging appenders (take those from Ralf in l2)
  60
  61 [dict]
  62   * speed up the cursors, for example using the contexts when available
  63
  64 [modules]
  65   * better formalisation of what modules are (amok deeply needs it)
  66     configuration + init() + exit() + dependencies
  67   * allow to load them at runtime
  68     check in erlang how they upgrade them without downtime
  69
  70 [other modules]
  71   * we may need a round-robin database module, and a statistical one
  72   * a hook module *may* help cleaning up some parts. Not sure yet.
  73   * Some of the datacontainer modules seem to overlap. Kill some of them?
  74     - replace fifo with dynars
  75     - replace set with SWAG
  76
  77 *
  78 * GRAS
  79 ******
  80
  81 [doc]
  82   * implement the P2P protocols that macedon does. They constitute great
  83     examples, too
  84
  85 [transport]
  86   * Spawn threads handling the communication
  87     - Data sending cannot be delegated if we want to be kept informed
  88       (*easily*) of errors here.
  89       - Actor execution flow shouldn't be interrupted
  90       - It should be allowed to access (both in read and write access)
  91         any data available (ie, referenced) from the actor without
  92         requesting to check for a condition before.
  93         (in other word, no mutex or assimilated)
  94       - I know that enforcing those rules prevent the implementation of
  95         really cleaver stuff. Keeping the stuff simple for the users is more
  96         important to me than allowing them to do cleaver tricks. Black magic
  97         should be done *within* gras to reach a good performance level.
  98
  99     - Data receiving can be delegated (and should)
 100       The first step here is a "simple" mailbox mecanism, with a fifo of
 101         messages protected by semaphore.
 102       The rest is rather straightforward too.
 103
 104   * use poll(2) instead of select(2) when available. (first need to check
 105     the advantage of doing so ;)
 106
 107     Another idea we spoke about was to simulate this feature with a bunch of
 108     threads blocked in a read(1) on each incomming socket. The latency is
 109     reduced by the cost of a syscall, but the more I think about it, the
 110     less I find the idea adapted to our context.
 111
 112   * timeout the send/recv too (hard to do in RL)
 113   * Adaptative timeout
 114   * multiplex on incoming SOAP over HTTP (once datadesc can deal with it)
 115
 116   * The module syntax/API is too complex.
 117     - Everybody opens a server socket (or almost), and nobody open two of
 118       them. This should be done automatically without user intervention.
 119     - I'd like to offer the possibility to speak to someone, not to speak on
 120       a socket. Users shouldn't care about such technical details.
 121     - the idea of host_cookie in NWS seem to match my needs, but we still
 122       need a proper name ;)
 123     - this would allow to exchange a "socket" between peer :)
 124     - the creation needs to identify the peer actor within the process
 125
 126   * when a send failed because the socket was closed on the other side,
 127     try to reopen it seamlessly. Needs exceptions or another way to
 128     differentiate between the several system_error.
 129   * cache accepted sockets and close the old ones after a while.
 130     Depends on the previous item; difficult to achieve with firewalls
 131
 132 [datadesc]
 133   * Implement gras_datadesc_cpy to speedup things in the simulator
 134     (and allow to have several "actors" within the same unix process).
 135     For now, we mimick closely the RL even in SG. It was easier to do
 136       since the datadesc layer is unchanged, but it is not needed and
 137       hinders performance.
 138     gras_datadesc_cpy needs to provide the size of the corresponding messages, so
 139      that we can report it into the simulator.
 140   * Add a XML wire protocol alongside to the binary one (for SOAP/HTTP)
 141   * cbps:
 142     - Error handling
 143     - Regression tests
 144   * Inter-arch conversions
 145     - Port to ARM
 146     - Convert in the same buffer when size increase
 147     - Exchange (on net) structures in one shoot when possible.
 148     - Port to really exotic platforms (Cray is not IEEE ;)
 149   * datadesc_set_cste: give the value by default when receiving.
 150     - It's not transfered anymore, which is good for functions pointer.
 151   * Parsing macro
 152     - Cleanup the code (bison?)
 153     - Factorize code in union/struct field adding
 154     - Handle typedefs (needs love from DataDesc/)
 155     - Handle unions with annotate
 156     - Handle enum
 157     - Handle long long and long double
 158     - Forbid "char", allow "signed char" and "unsigned char", or user code won't be
 159       portable to ARM, at least.
 160     - Handle struct/union/enum embeeded within another container
 161       (needs modifications in DataDesc, too)
 162
 163     - Check short a, b;
 164     - Check short ***
 165     - Check struct { struct { int a } b; }
 166
 167   * gras_datadesc_import_nws?
 168
 169 [Messaging]
 170   * A proper RPC mecanism
 171     - gras_rpctype_declare_v (name,ver, payload_request, payload_answer)
 172       (or gras_msgtype_declare_rpc_v).
 173     - Attaching a cb works the same way.
 174     - gras_msg_rpc(peer, &request, &answer)
 175     - On the wire, a byte indicate the message type:
 176       - 0: one-way message (what we have for now)
 177       - 1: method call (answer expected; sessionID attached)
 178       - 2: successful return (usual datatype attached, with sessionID)
 179       - 3: error return (payload = exception)
 180       - other message types are possible (forwarding request, group
 181         communication)
 182   * Message priority
 183   * Message forwarding
 184   * Group communication
 185   * Message declarations in a tree manner (such as log channels)?
 186
 187 [GRASPE] (platform expender)
 188   * Tool to visualize/deploy and manage in RL
 189   * pull method of source diffusion in graspe-slave
 190
 191 [Actors] (parallelism in GRAS)
 192   * An actor is a user process.
 193     It has a highly sequential control flow from its birth until its death.
 194     The timers won't stop the current execution to branch elsewhere, they
 195     will be delayed until the actor is ready to listen. Likewise, no signal
 196     delivery. The goal is to KISS for users.
 197   * You can fork a new actor, even on remote hosts.
 198   * They are implemented as threads in RL, but this is still a distributed
 199     memory *model*. If you want to share data with another actor, send it
 200     using the message interface to explicit who's responsible of this data.
 201   * data exchange between actors placed within the same UNIX process is
 202     *implemented* by memcopy, but that's an implementation detail.
 203
 204 [Other, more general issues]
 205   * watchdog in RL (ie, while (1) { fork; exec the child, wait in father })
 206   * Allow [homogeneous] dico to be sent
 207   * Make GRAS thread safe by mutexing what needs to be
 208
 209 *
 210 * AMOK
 211 ******
 212
 213 [bandwidth]
 214   * finish this module (still missing the saturate part)
 215   * add a version guessing the appropriate datasizes automatically
 216 [other modules]
 217   * provide a way to retrieve the host load as in NWS
 218   * log control, management, dynamic token ring
 219   * a way using SSH to ask a remote host to open a socket back on me
 220