X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/6b76ba4acd263f00d310287d7f891abfcda1c2f9..4afde5a12341a68569e8c15d06a799d3b26338e9:/src/simix/simcalls.in

diff --git a/src/simix/simcalls.in b/src/simix/simcalls.in
index a2d871116e..154c162cbd 100644
--- a/src/simix/simcalls.in
+++ b/src/simix/simcalls.in
@@ -6,12 +6,38 @@
 # CallType handler? name (resulttype,resultcast) (arg0name,arg0type,arg0cast) (arg1name,arg1type,arg1cast)
 
 # CallType must be one of the three:
-#  - Func: returning a value immediately
-#  - Blck: Blocking call that does not return in the same scheduling round
+#
+#  - Func: returning a value immediately (within the same scheduling round)
+#    examples: all getters that only retrieve informations with no side effect
+#
 #  - Proc: not returning any value (but doing so immediately) 
+#    examples: all setters, *_cancel 
+#
+#  - Blck: Blocking call that does not return in the same scheduling round.
+#    The answer requires some interaction with SURF, even if this can
+#    still occure at the same timestamp under some circonstances (eg
+#    if the surf_action cannot start because of resources that are down)
+#    examples: things that last some time (communicate, execute, mutex_lock)
+#
+#    In a perfect world, these answers would also be handled by the
+#    script, but we are not there yet. Instead, the answer is manually
+#    generated in one of the SIMIX_post_*() functions, that are called
+#    when we unpack the done and failed actions returned by surf after
+#    a surf simulation round. Weird things happen if you forget to
+#    answer a given simcall in there...
+
+
 
 # Handler? is either "H" if we need to generate a handler or "-" if we should go without handlers
 
+# I wish we could completely remove the handlers as their only use is
+# to adapt the interface between the exported symbol that is visible
+# by the user applications and the internal symbol that is implemented 
+# by the kernel. 
+# The only remaining use of that mechanism is to add the caller
+# identity as a parameter of internal call, but that could be
+# automatized too (eg by having a special parameter type called "self")
+
 Func - host_get_by_name (void*, smx_host_t) (name, const char*)
 Func - host_get_name (const char*) (host, void*, smx_host_t)
 Proc - host_on (void) (host, void*, smx_host_t)
@@ -28,8 +54,8 @@ Func - host_get_nb_pstates (int) (host, void*, smx_host_t)
 Proc - host_set_power_peak_at (void) (host, void*, smx_host_t) (pstate_index, int)
 Func - host_get_consumed_energy (double) (host, void*, smx_host_t)
 
-Func - host_execute (void*, smx_synchro_t) (name, const char*) (host, void*, smx_host_t) (computation_amount, double) (priority, double) (bound, double) (affinity_mask, unsigned long)
-Func - host_parallel_execute (void*, smx_synchro_t) (name, const char*) (host_nb, int) (host_list, void*, smx_host_t*) (computation_amount, void*, double*) (communication_amount, void*, double*) (amount, double) (rate, double)
+Func - host_execute (void*, smx_synchro_t) (name, const char*) (host, void*, smx_host_t) (flops_amount, double) (priority, double) (bound, double) (affinity_mask, unsigned long)
+Func - host_parallel_execute (void*, smx_synchro_t) (name, const char*) (host_nb, int) (host_list, void*, smx_host_t*) (flops_amount, void*, double*) (bytes_amount, void*, double*) (amount, double) (rate, double)
 Proc - host_execution_destroy (void) (execution, void*, smx_synchro_t)
 Proc - host_execution_cancel (void) (execution, void*, smx_synchro_t)
 Func - host_execution_get_remains (double) (execution, void*, smx_synchro_t)
@@ -133,10 +159,9 @@ Func - storage_get_properties (void*, xbt_dict_t) (storage, void*, smx_storage_t
 Func - storage_get_content (void*, xbt_dict_t) (storage, void*, smx_storage_t)
 Func H asr_get_properties (void*, xbt_dict_t) (name, const char*)
 Func H mc_random (int) (min, int) (max, int)
+Proc - set_category (void) (synchro, void*, smx_synchro_t) (category, const char*)
 ## HAVE_LATENCY_BOUND_TRACKING
 Func - comm_is_latency_bounded (int) (comm, void*, smx_synchro_t)
-## HAVE_TRACING
-Proc - set_category (void) (synchro, void*, smx_synchro_t) (category, const char*)
 ## HAVE_MC
 Func H mc_snapshot (void*, mc_snapshot_t)
 Func H mc_compare_snapshots (int) (s1, void*, mc_snapshot_t) (s2, void*, mc_snapshot_t)