X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/7dc1f0e2c0b12206841e4acbe2b0f8e5bc6bbb86..e9d070ff4b259516963e10fde45bac591336f154:/include/gras/datadesc.h diff --git a/include/gras/datadesc.h b/include/gras/datadesc.h index a3c27d2698..842c4f3d21 100644 --- a/include/gras/datadesc.h +++ b/include/gras/datadesc.h @@ -10,8 +10,8 @@ #ifndef GRAS_DATADESC_H #define GRAS_DATADESC_H -#include "xbt/misc.h" /* SG_BEGIN_DECL */ -#include "xbt/dynar.h" /* void_f_pvoid_t */ +#include "xbt/misc.h" /* SG_BEGIN_DECL */ +#include "xbt/dynar.h" /* void_f_pvoid_t */ SG_BEGIN_DECL() @@ -36,7 +36,6 @@ SG_BEGIN_DECL() * - Section \ref GRAS_dd_cb_simple provides a simple interface to do so, allowing to share integers stored on a stack. * - Section \ref GRAS_dd_cb_full provides a full featured interface to do so, but it may reveal somehow difficult to use. **/ - /** @defgroup GRAS_dd_basic Basic operations on data descriptions * @ingroup GRAS_dd * \htmlonly \endhtmlonly @@ -54,16 +53,16 @@ SG_BEGIN_DECL() * */ /* @{ */ - /** @brief Opaque type describing a type description. */ -typedef struct s_gras_datadesc_type *gras_datadesc_type_t; + typedef struct s_gras_datadesc_type *gras_datadesc_type_t; /** \brief Search a type description from its name */ XBT_PUBLIC(gras_datadesc_type_t) gras_datadesc_by_name(const char *name); -XBT_PUBLIC(gras_datadesc_type_t) gras_datadesc_by_name_or_null(const char *name); +XBT_PUBLIC(gras_datadesc_type_t) gras_datadesc_by_name_or_null(const char + *name); /* @} */ - + /** @defgroup GRAS_dd_auto Automatic parsing of data descriptions * @ingroup GRAS_dd * \htmlonly \endhtmlonly @@ -220,14 +219,14 @@ int server(int argc, char *argv[]) { */ /** @{ */ - + /** @brief Automatically parse C code * @hideinitializer */ #define GRAS_DEFINE_TYPE(name,def) \ const char * _gras_this_type_symbol_does_not_exist__##name=#def; def -#ifndef DOXYGEN_SKIP /* doxygen don't like macro fun too much */ +#ifndef DOXYGEN_SKIP /* doxygen don't like macro fun too much */ # ifdef GRAS_DEFINE_TYPE_EXTERN # undef GRAS_DEFINE_TYPE # define GRAS_DEFINE_TYPE(name,def) def @@ -240,7 +239,7 @@ int server(int argc, char *argv[]) { */ #define GRAS_DEFINE_TYPE_EXTERN 1 /* leave the fun of declaring this to the user */ -#undef GRAS_DEFINE_TYPE_EXTERN +#undef GRAS_DEFINE_TYPE_EXTERN /** @brief Define a symbol to be automatically parsed, disregarding #GRAS_DEFINE_TYPE_EXTERN * @hideinitializer @@ -251,7 +250,7 @@ int server(int argc, char *argv[]) { */ #define GRAS_DEFINE_TYPE_LOCAL(name, def) \ const char * _gras_this_type_symbol_does_not_exist__##name=#def; def - + /** @brief Retrieve a datadesc which was previously parsed * @hideinitializer */ @@ -266,15 +265,15 @@ int server(int argc, char *argv[]) { * @brief Add an annotation to a type to be automatically parsed */ #define GRAS_ANNOTE(key,val) - + /** @brief Defines the value of a define to the datatype parsing infrastructure */ -XBT_PUBLIC(void) gras_datadesc_set_const(const char*name, int value); +XBT_PUBLIC(void) gras_datadesc_set_const(const char *name, int value); /* @} */ -XBT_PUBLIC(gras_datadesc_type_t) -gras_datadesc_parse(const char *name, const char *C_statement); +XBT_PUBLIC(gras_datadesc_type_t) + gras_datadesc_parse(const char *name, const char *C_statement); /** @defgroup GRAS_dd_manual Simple manual data description * @ingroup GRAS_dd @@ -315,15 +314,23 @@ gras_datadesc_parse(const char *name, const char *C_statement); /** \brief Opaque type describing a type description callback persistant state. */ -typedef struct s_gras_cbps *gras_cbps_t; + typedef struct s_gras_cbps *gras_cbps_t; /* callbacks prototypes */ /** \brief Prototype of type callbacks returning nothing. */ -typedef void (*gras_datadesc_type_cb_void_t)(gras_datadesc_type_t typedesc, gras_cbps_t vars, void *data); + typedef void (*gras_datadesc_type_cb_void_t) (gras_datadesc_type_t + typedesc, gras_cbps_t vars, + void *data); /** \brief Prototype of type callbacks returning an int. */ -typedef int (*gras_datadesc_type_cb_int_t)(gras_datadesc_type_t typedesc, gras_cbps_t vars, void *data); + typedef int (*gras_datadesc_type_cb_int_t) (gras_datadesc_type_t + typedesc, gras_cbps_t vars, + void *data); /** \brief Prototype of type callbacks selecting a type. */ -typedef gras_datadesc_type_t (*gras_datadesc_selector_t)(gras_datadesc_type_t typedesc, gras_cbps_t vars, void *data); + typedef + gras_datadesc_type_t(*gras_datadesc_selector_t) (gras_datadesc_type_t + typedesc, + gras_cbps_t vars, + void *data); /****************************************** @@ -331,47 +338,44 @@ typedef gras_datadesc_type_t (*gras_datadesc_selector_t)(gras_datadesc_type_t ty ******************************************/ XBT_PUBLIC(gras_datadesc_type_t) gras_datadesc_struct(const char *name); -XBT_PUBLIC(void) gras_datadesc_struct_append(gras_datadesc_type_t struct_type, - const char *name, - gras_datadesc_type_t field_type); -XBT_PUBLIC(void) gras_datadesc_struct_close(gras_datadesc_type_t struct_type); - - -XBT_PUBLIC(gras_datadesc_type_t) gras_datadesc_union(const char *name, - gras_datadesc_type_cb_int_t selector); -XBT_PUBLIC(void) gras_datadesc_union_append(gras_datadesc_type_t union_type, - const char *name, - gras_datadesc_type_t field_type); -XBT_PUBLIC(void) gras_datadesc_union_close(gras_datadesc_type_t union_type); - - -XBT_PUBLIC(gras_datadesc_type_t) - gras_datadesc_ref(const char *name, - gras_datadesc_type_t referenced_type); -XBT_PUBLIC(gras_datadesc_type_t) - gras_datadesc_copy(const char *name, - gras_datadesc_type_t copied_type); -XBT_PUBLIC(gras_datadesc_type_t) - gras_datadesc_ref_generic(const char *name, - gras_datadesc_selector_t selector); - -XBT_PUBLIC(gras_datadesc_type_t) - gras_datadesc_array_fixed(const char *name, - gras_datadesc_type_t element_type, - long int fixed_size); -XBT_PUBLIC(gras_datadesc_type_t) - gras_datadesc_array_dyn(const char *name, - gras_datadesc_type_t element_type, - gras_datadesc_type_cb_int_t dynamic_size); -XBT_PUBLIC(gras_datadesc_type_t) - gras_datadesc_ref_pop_arr(gras_datadesc_type_t element_type); - -XBT_PUBLIC(gras_datadesc_type_t) - gras_datadesc_dynar(gras_datadesc_type_t elm_t, - void_f_pvoid_t *free_func); +XBT_PUBLIC(void) gras_datadesc_struct_append(gras_datadesc_type_t struct_type, + const char *name, + gras_datadesc_type_t field_type); +XBT_PUBLIC(void) gras_datadesc_struct_close(gras_datadesc_type_t struct_type); + + +XBT_PUBLIC(gras_datadesc_type_t) gras_datadesc_union(const char *name, + gras_datadesc_type_cb_int_t + selector); +XBT_PUBLIC(void) gras_datadesc_union_append(gras_datadesc_type_t union_type, + const char *name, + gras_datadesc_type_t field_type); +XBT_PUBLIC(void) gras_datadesc_union_close(gras_datadesc_type_t union_type); + + XBT_PUBLIC(gras_datadesc_type_t) - gras_datadesc_matrix(gras_datadesc_type_t elm_t, - void_f_pvoid_t * const free_f); + gras_datadesc_ref(const char *name, gras_datadesc_type_t referenced_type); +XBT_PUBLIC(gras_datadesc_type_t) + gras_datadesc_copy(const char *name, gras_datadesc_type_t copied_type); +XBT_PUBLIC(gras_datadesc_type_t) + gras_datadesc_ref_generic(const char *name, + gras_datadesc_selector_t selector); + +XBT_PUBLIC(gras_datadesc_type_t) + gras_datadesc_array_fixed(const char *name, + gras_datadesc_type_t element_type, + long int fixed_size); +XBT_PUBLIC(gras_datadesc_type_t) + gras_datadesc_array_dyn(const char *name, + gras_datadesc_type_t element_type, + gras_datadesc_type_cb_int_t dynamic_size); +XBT_PUBLIC(gras_datadesc_type_t) + gras_datadesc_ref_pop_arr(gras_datadesc_type_t element_type); + +XBT_PUBLIC(gras_datadesc_type_t) + gras_datadesc_dynar(gras_datadesc_type_t elm_t, void_f_pvoid_t free_func); +XBT_PUBLIC(gras_datadesc_type_t) + gras_datadesc_matrix(gras_datadesc_type_t elm_t, void_f_pvoid_t const free_f); /********************************* * Change stuff within datadescs * @@ -382,25 +386,28 @@ XBT_PUBLIC(void) gras_datadesc_cycle_set(gras_datadesc_type_t type); /** \brief Specify that this type do not contain any cycles (default) */ XBT_PUBLIC(void) gras_datadesc_cycle_unset(gras_datadesc_type_t type); /** \brief Add a pre-send callback to this datadesc. */ -XBT_PUBLIC(void) gras_datadesc_cb_send (gras_datadesc_type_t type, - gras_datadesc_type_cb_void_t pre); +XBT_PUBLIC(void) gras_datadesc_cb_send(gras_datadesc_type_t type, + gras_datadesc_type_cb_void_t pre); /** \brief Add a post-receive callback to this datadesc.*/ -XBT_PUBLIC(void) gras_datadesc_cb_recv(gras_datadesc_type_t type, - gras_datadesc_type_cb_void_t post); +XBT_PUBLIC(void) gras_datadesc_cb_recv(gras_datadesc_type_t type, + gras_datadesc_type_cb_void_t post); /** \brief Add a pre-send callback to the given field of the datadesc */ -XBT_PUBLIC(void) gras_datadesc_cb_field_send (gras_datadesc_type_t type, - const char *field_name, - gras_datadesc_type_cb_void_t pre); +XBT_PUBLIC(void) gras_datadesc_cb_field_send(gras_datadesc_type_t type, + const char *field_name, + gras_datadesc_type_cb_void_t + pre); /** \brief Add a post-receive callback to the given field of the datadesc */ -XBT_PUBLIC(void) gras_datadesc_cb_field_recv(gras_datadesc_type_t type, - const char *field_name, - gras_datadesc_type_cb_void_t post); +XBT_PUBLIC(void) gras_datadesc_cb_field_recv(gras_datadesc_type_t type, + const char *field_name, + gras_datadesc_type_cb_void_t + post); /** \brief Add a pre-send callback to the given field resulting in its value to be pushed */ -XBT_PUBLIC(void) gras_datadesc_cb_field_push (gras_datadesc_type_t type, - const char *field_name); +XBT_PUBLIC(void) gras_datadesc_cb_field_push(gras_datadesc_type_t type, + const char *field_name); /** \brief Add a pre-send callback to the given field resulting in its value multiplied to any previously pushed value and then pushed back */ -XBT_PUBLIC(void) gras_datadesc_cb_field_push_multiplier (gras_datadesc_type_t type, - const char *field_name); +XBT_PUBLIC(void) gras_datadesc_cb_field_push_multiplier(gras_datadesc_type_t + type, const char + *field_name); /****************************** * Get stuff within datadescs * @@ -459,22 +466,32 @@ gras_datadesc_struct_close(my_type); */ /* @{ */ -XBT_PUBLIC(void) -gras_cbps_i_push(gras_cbps_t ps, int val); -XBT_PUBLIC(int) -gras_cbps_i_pop(gras_cbps_t ps); - -XBT_PUBLIC(int) gras_datadesc_cb_pop(gras_datadesc_type_t typedesc, gras_cbps_t vars, void *data); - -XBT_PUBLIC(void) gras_datadesc_cb_push_int(gras_datadesc_type_t typedesc, gras_cbps_t vars, void *data); -XBT_PUBLIC(void) gras_datadesc_cb_push_uint(gras_datadesc_type_t typedesc, gras_cbps_t vars, void *data); -XBT_PUBLIC(void) gras_datadesc_cb_push_lint(gras_datadesc_type_t typedesc, gras_cbps_t vars, void *data); -XBT_PUBLIC(void) gras_datadesc_cb_push_ulint(gras_datadesc_type_t typedesc, gras_cbps_t vars, void *data); - -XBT_PUBLIC(void) gras_datadesc_cb_push_int_mult(gras_datadesc_type_t typedesc, gras_cbps_t vars, void *data); -XBT_PUBLIC(void) gras_datadesc_cb_push_uint_mult(gras_datadesc_type_t typedesc, gras_cbps_t vars, void *data); -XBT_PUBLIC(void) gras_datadesc_cb_push_lint_mult(gras_datadesc_type_t typedesc, gras_cbps_t vars, void *data); -XBT_PUBLIC(void) gras_datadesc_cb_push_ulint_mult(gras_datadesc_type_t typedesc, gras_cbps_t vars, void *data); +XBT_PUBLIC(void) gras_cbps_i_push(gras_cbps_t ps, int val); +XBT_PUBLIC(int) gras_cbps_i_pop(gras_cbps_t ps); + +XBT_PUBLIC(int) gras_datadesc_cb_pop(gras_datadesc_type_t typedesc, + gras_cbps_t vars, void *data); + +XBT_PUBLIC(void) gras_datadesc_cb_push_int(gras_datadesc_type_t typedesc, + gras_cbps_t vars, void *data); +XBT_PUBLIC(void) gras_datadesc_cb_push_uint(gras_datadesc_type_t typedesc, + gras_cbps_t vars, void *data); +XBT_PUBLIC(void) gras_datadesc_cb_push_lint(gras_datadesc_type_t typedesc, + gras_cbps_t vars, void *data); +XBT_PUBLIC(void) gras_datadesc_cb_push_ulint(gras_datadesc_type_t typedesc, + gras_cbps_t vars, void *data); + +XBT_PUBLIC(void) gras_datadesc_cb_push_int_mult(gras_datadesc_type_t typedesc, + gras_cbps_t vars, void *data); +XBT_PUBLIC(void) gras_datadesc_cb_push_uint_mult(gras_datadesc_type_t + typedesc, gras_cbps_t vars, + void *data); +XBT_PUBLIC(void) gras_datadesc_cb_push_lint_mult(gras_datadesc_type_t + typedesc, gras_cbps_t vars, + void *data); +XBT_PUBLIC(void) gras_datadesc_cb_push_ulint_mult(gras_datadesc_type_t + typedesc, gras_cbps_t vars, + void *data); /* @} */ @@ -493,22 +510,18 @@ XBT_PUBLIC(void) gras_datadesc_cb_push_ulint_mult(gras_datadesc_type_t typedesc, /* @{ */ -XBT_PUBLIC(void) gras_cbps_v_pop (gras_cbps_t ps, - const char *name, - /* OUT */ gras_datadesc_type_t *ddt, - /* OUT */ void **res); -XBT_PUBLIC(void) gras_cbps_v_push(gras_cbps_t ps, - const char *name, - void *data, - gras_datadesc_type_t ddt); -XBT_PUBLIC(void) gras_cbps_v_set (gras_cbps_t ps, - const char *name, - void *data, - gras_datadesc_type_t ddt); - -XBT_PUBLIC(void*) gras_cbps_v_get (gras_cbps_t ps, - const char *name, - /* OUT */ gras_datadesc_type_t *ddt); +XBT_PUBLIC(void) gras_cbps_v_pop(gras_cbps_t ps, const char *name, + /* OUT */ gras_datadesc_type_t * ddt, + /* OUT */ void **res); +XBT_PUBLIC(void) gras_cbps_v_push(gras_cbps_t ps, + const char *name, + void *data, gras_datadesc_type_t ddt); +XBT_PUBLIC(void) gras_cbps_v_set(gras_cbps_t ps, + const char *name, + void *data, gras_datadesc_type_t ddt); + +XBT_PUBLIC(void *) gras_cbps_v_get(gras_cbps_t ps, const char *name, + /* OUT */ gras_datadesc_type_t * ddt); XBT_PUBLIC(void) gras_cbps_block_begin(gras_cbps_t ps); XBT_PUBLIC(void) gras_cbps_block_end(gras_cbps_t ps); @@ -530,10 +543,10 @@ XBT_PUBLIC(int) gras_arch_selfid(void); /* ID of this arch */ /** * Basic types we can embeed in DataDescriptors. */ -typedef enum - {CHAR_TYPE, DOUBLE_TYPE, FLOAT_TYPE, INT_TYPE, LONG_TYPE, SHORT_TYPE, - UNSIGNED_INT_TYPE, UNSIGNED_LONG_TYPE, UNSIGNED_SHORT_TYPE, STRUCT_TYPE} - DataTypes; + typedef enum + { CHAR_TYPE, DOUBLE_TYPE, FLOAT_TYPE, INT_TYPE, LONG_TYPE, SHORT_TYPE, + UNSIGNED_INT_TYPE, UNSIGNED_LONG_TYPE, UNSIGNED_SHORT_TYPE, STRUCT_TYPE + } DataTypes; #define SIMPLE_TYPE_COUNT 9 /** \brief Describe a collection of data. @@ -548,14 +561,14 @@ typedef enum ** padding bytes the compiler adds to the end of the structure. */ -typedef struct DataDescriptorStruct { - DataTypes type; - size_t repetitions; - size_t offset; - /*@null@*/ struct DataDescriptorStruct *members; - size_t length; - size_t tailPadding; -} DataDescriptor; + typedef struct DataDescriptorStruct { + DataTypes type; + size_t repetitions; + size_t offset; + /*@null@ */ struct DataDescriptorStruct *members; + size_t length; + size_t tailPadding; + } DataDescriptor; /** DataDescriptor for an array */ #define SIMPLE_DATA(type,repetitions) \ {type, repetitions, 0, NULL, 0, 0} @@ -568,11 +581,9 @@ typedef struct DataDescriptorStruct { sizeof(memberType) * repetitions XBT_PUBLIC(gras_datadesc_type_t) -gras_datadesc_import_nws(const char *name, - const DataDescriptor *desc, - unsigned long howmany); + gras_datadesc_import_nws(const char *name, + const DataDescriptor * desc, unsigned long howmany); SG_END_DECL() - #endif /* GRAS_DATADESC_H */