--- /dev/null
+/* $Id$ */
+
+/* datadesc - data description in order to send/recv it in GRAS */
+
+/* Authors: Olivier Aumage, Martin Quinson */
+/* Copyright (C) 2003, 2004 the GRAS posse. */
+
+/* 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. */
+
+#include "DataDesc/datadesc_private.h"
+
+GRAS_LOG_NEW_DEFAULT_SUBCATEGORY(DataDesc,GRAS);
+gras_set_t *gras_datadesc_set_local=NULL;
+
+/**
+ * gras_datadesc_init:
+ *
+ * Initialize the datadesc module
+ **/
+void
+gras_datadesc_init(void) {
+ gras_error_t errcode;
+
+ VERB0("Initializing DataDesc");
+ errcode = gras_set_new(&gras_datadesc_set_local);
+ gras_assert0(errcode==no_error,
+ "Impossible to create the data set containg locally known types");
+}
+
+/**
+ * gras_datadesc_exit:
+ *
+ * Finalize the datadesc module
+ **/
+void
+gras_datadesc_exit(void) {
+ VERB0("Exiting DataDesc");
+ gras_set_free(&gras_datadesc_set_local);
+}
+
+/***
+ *** CREATION FUNCTIONS: private to this file
+ ***/
+static gras_error_t
+gras_ddt_new(const char *name,
+ gras_datadesc_type_t **dst) {
+
+ gras_datadesc_type_t *res=malloc(sizeof(gras_datadesc_type_t));
+ if (!res)
+ RAISE_MALLOC;
+
+ memset(res, 0, sizeof(res));
+ res->name = strdup(name);
+
+ *dst=res;
+ return no_error;
+}
+
+/**
+ * gras_ddt_new_scalar:
+ *
+ * Create a new scalar and give a pointer to it
+ */
+gras_error_t
+gras_ddt_new_scalar(const char *name,
+ long int size,
+ enum e_gras_dd_scalar_encoding encoding,
+ gras_datadesc_type_cb_void_t cb,
+ gras_datadesc_type_t **dst) {
+
+ gras_error_t errcode;
+ gras_datadesc_type_t *res;
+
+ TRY(gras_ddt_new(name,dst));
+ res=*dst;
+
+ res->size = size>0 ? size : 0;
+
+ if (size>0) { /* Black magic from Oli FIXME: documentation ;)*/
+ long int sz = size;
+ long int mask = sz;
+
+ while ((sz >>= 1)) {
+ mask |= sz;
+ }
+
+ if (size & (mask >> 1)) {
+ res->alignment = (size & ~(mask >> 1)) << 1;
+ gras_assert0(res->alignment != 0,
+ "scalar type too large");
+
+ res->aligned_size = aligned(size, res->alignment);
+ gras_assert0 (res->aligned_size >= 0,
+ "scalar type too large");
+
+ } else {
+ res->alignment = size & ~(mask >> 1);;
+ res->aligned_size = aligned(size, res->alignment);
+ }
+
+ } else {
+ res->alignment = 0;
+ res->aligned_size = 0;
+ }
+
+ res->category_code = e_gras_datadesc_type_cat_scalar;
+ res->category.scalar_data.encoding = encoding;
+
+ res->pre = cb;
+ return no_error;
+}
+
+
+/**
+ * gras_dd_cat_field_free:
+ *
+ * Frees one struct or union field
+ */
+void gras_dd_cat_field_free(void *f) {
+ gras_dd_cat_field_t *field = (gras_dd_cat_field_t *)f;
+ if (field) {
+ if (field->name)
+ free(field->name);
+ free(field);
+ }
+}
+
+/**
+ * gras_ddt_new_struct:
+ *
+ * Create a new struct and give a pointer to it
+ */
+gras_error_t
+gras_ddt_new_struct(const char *name,
+ gras_datadesc_type_cb_void_t pre,
+ gras_datadesc_type_cb_void_t post,
+ gras_datadesc_type_t **dst) {
+
+ gras_error_t errcode;
+ gras_datadesc_type_t *res;
+
+ TRY(gras_ddt_new(name,dst));
+ res=*dst;
+
+ res->size = 0;
+ res->alignment = 0;
+ res->aligned_size = 0;
+ res->category_code = e_gras_datadesc_type_cat_struct;
+ TRY(gras_dynar_new(&(res->category.struct_data.fields),
+ sizeof(gras_dd_cat_field_t*),
+ &gras_dd_cat_field_free));
+ res->pre = pre;
+ res->post = post;
+
+ return no_error;
+}
+
+/**
+ * gras_ddt_new_struct_append:
+ *
+ * Append a field to the struct
+ */
+gras_error_t
+gras_ddt_new_struct_append(gras_datadesc_type_t *struct_type,
+ const char *name,
+ gras_datadesc_type_t *field_type,
+ gras_datadesc_type_cb_void_t pre,
+ gras_datadesc_type_cb_void_t post) {
+
+ gras_error_t errcode;
+ gras_dd_cat_field_t *field;
+
+ gras_assert0(field_type->size >= 0,
+ "Cannot add a dynamically sized field in a structure");
+
+ field=malloc(sizeof(gras_dd_cat_field_t));
+ if (!field)
+ RAISE_MALLOC;
+
+ field->name = strdup(name);
+ field->offset = aligned(struct_type->size, field_type->alignment);
+ field->code = field_type->code;
+ field->pre = pre;
+ field->post = post;
+
+ TRY(gras_dynar_push(struct_type->category.struct_data.fields, field));
+
+ struct_type->size = field->offset + field_type->size;
+ struct_type->alignment = max(struct_type->alignment, field_type->alignment);
+ struct_type->aligned_size = aligned(struct_type->size, struct_type->alignment);
+
+ return no_error;
+}
+
+/**
+ * gras_ddt_new_union:
+ *
+ * Create a new union and give a pointer to it
+ */
+gras_error_t
+gras_ddt_new_union(const char *name,
+ gras_datadesc_type_cb_int_t field_count,
+ gras_datadesc_type_cb_void_t post,
+ gras_datadesc_type_t **dst) {
+
+ gras_error_t errcode;
+ gras_datadesc_type_t *res;
+
+ gras_assert0(field_count,
+ "Attempt to creat an union without field_count function");
+
+ TRY(gras_ddt_new(name,dst));
+ res=*dst;
+
+ res->size = 0;
+ res->alignment = 0;
+ res->aligned_size = 0;
+ res->category_code = e_gras_datadesc_type_cat_union;
+ TRY(gras_dynar_new(&(res->category.union_data.fields),
+ sizeof(gras_dd_cat_field_t*),
+ &gras_dd_cat_field_free));
+ res->category.union_data.field_count = field_count;
+ res->pre = NULL;
+ res->post = post;
+
+ return no_error;
+}
+
+/**
+ * gras_ddt_new_union_append:
+ *
+ * Append a field to the union
+ */
+gras_error_t
+gras_ddt_new_union_append(gras_datadesc_type_t *union_type,
+ const char *name,
+ gras_datadesc_type_t *field_type,
+ gras_datadesc_type_cb_void_t pre,
+ gras_datadesc_type_cb_void_t post) {
+
+ gras_error_t errcode;
+ gras_dd_cat_field_t *field;
+
+ gras_assert0(field_type->size >= 0,
+ "Cannot add a dynamically sized field in an union");
+
+ field=malloc(sizeof(gras_dd_cat_field_t));
+ if (!field)
+ RAISE_MALLOC;
+
+ field->name = strdup(name);
+ field->offset = 0; /* that's the purpose of union ;) */
+ field->code = field_type->code;
+ field->pre = pre;
+ field->post = post;
+
+ TRY(gras_dynar_push(union_type->category.union_data.fields, field));
+
+ union_type->size = max(union_type->size, field_type->size);
+ union_type->alignment = max(union_type->alignment, field_type->alignment);
+ union_type->aligned_size = aligned(union_type->size, union_type->alignment);
+
+ return no_error;
+}
+
+/**
+ * gras_ddt_new_ref:
+ *
+ * Create a new ref and give a pointer to it
+ */
+gras_error_t
+gras_ddt_new_ref(const char *name,
+ gras_datadesc_type_t *referenced_type,
+ gras_datadesc_type_cb_int_t discriminant,
+ gras_datadesc_type_cb_void_t post,
+ gras_datadesc_type_t **dst) {
+
+ gras_error_t errcode;
+ gras_datadesc_type_t *res;
+
+ gras_assert0(discriminant || referenced_type,
+ "Attempt to create a generic reference without discriminant");
+
+ TRY(gras_ddt_new(name,dst));
+ res=*dst;
+
+ /* FIXME: Size from bootstraping */
+ res->size = 0;
+ res->alignment = 0;
+ res->aligned_size = 0;
+ res->category_code = e_gras_datadesc_type_cat_ref;
+
+ res->category.ref_data.code = referenced_type ? referenced_type->code : -1;
+ res->category.ref_data.discriminant = discriminant;
+ res->pre = NULL;
+ res->post = post;
+
+ return no_error;
+}
+
+/**
+ * gras_ddt_new_array:
+ *
+ * Create a new array and give a pointer to it
+ */
+gras_error_t
+gras_ddt_new_array(const char *name,
+ gras_datadesc_type_t *element_type,
+ long int fixed_size,
+ gras_datadesc_type_cb_int_t dynamic_size,
+ gras_datadesc_type_cb_void_t post,
+ gras_datadesc_type_t **dst) {
+
+ gras_error_t errcode;
+ gras_datadesc_type_t *res;
+
+ gras_assert0(dynamic_size || fixed_size>0,
+ "Attempt to create a dynamic array without size discriminant");
+
+ TRY(gras_ddt_new(name,dst));
+ res=*dst;
+
+ if (fixed_size <= 0) {
+ res->size = fixed_size;
+ } else {
+ res->size = fixed_size * element_type->aligned_size;
+ }
+ res->alignment = element_type->alignment;
+ res->aligned_size = fixed_size; /*FIXME: That was so in GS, but looks stupid*/
+ res->category_code = e_gras_datadesc_type_cat_array;
+
+ res->category.array_data.code = element_type->code;
+ res->category.array_data.fixed_size = fixed_size;
+ res->category.array_data.dynamic_size = dynamic_size;
+
+ res->pre = NULL;
+ res->post = post;
+
+ return no_error;
+}
+
+/***
+ *** BOOTSTRAPING FUNCTIONS: known within GRAS only
+ ***/
+
+/***
+ *** DECLARATION FUNCTIONS: public functions
+ ***/
+gras_error_t
+gras_datadesc_declare_struct_cb(const char *name,
+ gras_datadesc_type_cb_void_t pre,
+ gras_datadesc_type_cb_void_t post,
+ long int *code) {
+ gras_error_t errcode;
+ gras_datadesc_type_t *type;
+ TRY(gras_ddt_new_struct(name, pre, post, &type));
+ TRY(gras_ddt_register(gras_datadesc_set_local, type));
+ *code = type->code;
+ return no_error;
+}
+
+gras_error_t
+gras_datadesc_declare_struct_add_name_cb(long int struct_code,
+ const char *field_name,
+ const char *field_type_name,
+ gras_datadesc_type_cb_void_t pre_cb,
+ gras_datadesc_type_cb_void_t post_cb) {
+
+ gras_error_t errcode;
+ gras_datadesc_type_t *struct_type;
+ gras_datadesc_type_t *field_type;
+
+ TRY(gras_set_get_by_id(gras_datadesc_set_local,struct_code,
+ (gras_set_elm_t**)struct_type));
+ TRY(gras_set_get_by_name(gras_datadesc_set_local,field_type_name,
+ (gras_set_elm_t**)field_type));
+
+ TRY(gras_ddt_new_struct_append(struct_type,
+ field_name, field_type,
+ pre_cb, post_cb));
+
+ return no_error;
+}
+gras_error_t
+gras_datadesc_declare_struct_add_code_cb(long int struct_code,
+ const char *field_name,
+ long int field_code,
+ gras_datadesc_type_cb_void_t pre_cb,
+ gras_datadesc_type_cb_void_t post_cb) {
+ gras_error_t errcode;
+ gras_datadesc_type_t *struct_type;
+ gras_datadesc_type_t *field_type;
+
+ TRY(gras_set_get_by_id(gras_datadesc_set_local,struct_code,
+ (gras_set_elm_t**)struct_type));
+ TRY(gras_set_get_by_id(gras_datadesc_set_local,field_code,
+ (gras_set_elm_t**)field_type));
+
+ TRY(gras_ddt_new_struct_append(struct_type,
+ field_name, field_type,
+ pre_cb, post_cb));
+
+ return no_error;
+}
+
+gras_error_t
+gras_datadesc_declare_union_cb(const char *name,
+ gras_datadesc_type_cb_int_t field_count,
+ gras_datadesc_type_cb_void_t post,
+ long int *code) {
+ gras_error_t errcode;
+ gras_datadesc_type_t *type;
+ TRY(gras_ddt_new_union(name, field_count, post, &type));
+ TRY(gras_ddt_register(gras_datadesc_set_local, type));
+ *code = type->code;
+ return no_error;
+}
+
+gras_error_t
+gras_datadesc_declare_union_add_name_cb(long int union_code,
+ const char *field_name,
+ const char *field_type_name,
+ gras_datadesc_type_cb_void_t pre_cb,
+ gras_datadesc_type_cb_void_t post_cb) {
+ gras_error_t errcode;
+ gras_datadesc_type_t *union_type;
+ gras_datadesc_type_t *field_type;
+
+ TRY(gras_set_get_by_id(gras_datadesc_set_local,union_code,
+ (gras_set_elm_t**)union_type));
+ TRY(gras_set_get_by_name(gras_datadesc_set_local,field_type_name,
+ (gras_set_elm_t**)field_type));
+
+ TRY(gras_ddt_new_union_append(union_type,
+ field_name, field_type,
+ pre_cb, post_cb));
+
+ return no_error;
+}
+gras_error_t
+gras_datadesc_declare_union_add_code_cb(long int union_code,
+ const char *field_name,
+ long int field_code,
+ gras_datadesc_type_cb_void_t pre_cb,
+ gras_datadesc_type_cb_void_t post_cb) {
+ gras_error_t errcode;
+ gras_datadesc_type_t *union_type;
+ gras_datadesc_type_t *field_type;
+
+ TRY(gras_set_get_by_id(gras_datadesc_set_local,union_code,
+ (gras_set_elm_t**)union_type));
+ TRY(gras_set_get_by_id(gras_datadesc_set_local,field_code,
+ (gras_set_elm_t**)field_type));
+
+ TRY(gras_ddt_new_union_append(union_type,
+ field_name, field_type,
+ pre_cb, post_cb));
+
+ return no_error;
+}
+
+gras_error_t
+gras_datadesc_declare_ref_cb(const char *name,
+ gras_datadesc_type_t *referenced_type,
+ gras_datadesc_type_cb_int_t discriminant,
+ gras_datadesc_type_cb_void_t post,
+ long int *code){
+ gras_error_t errcode;
+ gras_datadesc_type_t *type;
+ TRY(gras_ddt_new_ref(name, referenced_type,discriminant,post, &type));
+ TRY(gras_ddt_register(gras_datadesc_set_local, type));
+ *code = type->code;
+ return no_error;
+}
+
+gras_error_t
+gras_datadesc_declare_array_cb(const char *name,
+ gras_datadesc_type_t *element_type,
+ long int fixed_size,
+ gras_datadesc_type_cb_int_t dynamic_size,
+ gras_datadesc_type_cb_void_t post,
+ long int *code){
+ gras_error_t errcode;
+ gras_datadesc_type_t *type;
+ TRY(gras_ddt_new_array(name, element_type, fixed_size, dynamic_size, post, &type));
+ TRY(gras_ddt_register(gras_datadesc_set_local, type));
+ *code = type->code;
+ return no_error;
+}
--- /dev/null
+/* $Id$ */
+
+/* datadesc_private - declarations visible only from within datadesc */
+
+/* Authors: Olivier Aumage, Martin Quinson */
+/* Copyright (C) 2003, 2004 the GRAS posse. */
+
+/* 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. */
+
+#ifndef GRAS_DATADESC_PRIVATE_H
+#define GRAS_DATADESC_PRIVATE_H
+
+#include "gras_private.h"
+#include "DataDesc/datadesc_interface.h"
+
+#define aligned(v, a) (((v) + (a - 1)) & ~(a - 1))
+
+
+
+/**********************************************************/
+/* Actual definitions of the stuff in the type descriptor */
+/**********************************************************/
+
+/**
+ * e_gras_datadesc_type_category:
+ *
+ * Defines all possible type categories
+ */
+typedef enum e_gras_datadesc_type_category {
+ e_gras_datadesc_type_cat_undefined = 0,
+
+ e_gras_datadesc_type_cat_scalar,
+ e_gras_datadesc_type_cat_struct,
+ e_gras_datadesc_type_cat_union,
+ e_gras_datadesc_type_cat_ref, /* ref to an uniq element */
+ e_gras_datadesc_type_cat_array,
+ e_gras_datadesc_type_cat_ignored,
+
+ e_gras_datadesc_type_cat_invalid
+} gras_datadesc_type_category_t;
+
+
+/*------------------------------------------------*/
+/* definitions of specific data for each category */
+/*------------------------------------------------*/
+/**
+ * s_gras_dd_cat_field:
+ *
+ * Fields of struct and union
+ */
+typedef struct s_gras_dd_cat_field {
+
+ char *name;
+ long int offset; /* only for struct */
+ int code;
+
+ gras_datadesc_type_cb_void_t pre;
+ gras_datadesc_type_cb_void_t post;
+
+} gras_dd_cat_field_t;
+void gras_dd_cat_field_free(void *f);
+
+/**
+ * gras_dd_cat_scalar_t:
+ *
+ * Specific fields of a scalar
+ */
+enum e_gras_dd_scalar_encoding {
+ e_gras_dd_scalar_encoding_undefined = 0,
+
+ e_gras_dd_scalar_encoding_uint,
+ e_gras_dd_scalar_encoding_sint,
+ e_gras_dd_scalar_encoding_float,
+
+ e_gras_dd_scalar_encoding_invalid
+};
+typedef struct s_gras_dd_cat_scalar {
+ enum e_gras_dd_scalar_encoding encoding;
+} gras_dd_cat_scalar_t;
+
+/**
+ * gras_dd_cat_struct_t:
+ *
+ * Specific fields of a struct
+ */
+typedef struct s_gras_dd_cat_struct {
+ gras_dynar_t *fields; /* elm type = gras_dd_cat_struct_field_t */
+} gras_dd_cat_struct_t;
+
+/**
+ * gras_dd_cat_union_t:
+ *
+ * Specific fields of a union
+ */
+typedef struct s_gras_dd_cat_union {
+ gras_datadesc_type_cb_int_t field_count;
+ gras_dynar_t *fields; /* elm type = gras_dd_cat_union_field_t */
+} gras_dd_cat_union_t;
+
+/**
+ * gras_dd_cat_ref_t:
+ *
+ * Specific fields of a reference
+ */
+typedef struct s_gras_dd_cat_ref {
+ int code;
+
+ /* callback used to return the referenced type number */
+ gras_datadesc_type_cb_int_t discriminant;
+} gras_dd_cat_ref_t;
+
+
+/**
+ * gras_dd_cat_array_t:
+ *
+ * Specific fields of an array
+ */
+typedef struct s_gras_dd_cat_array {
+ int code;
+
+ /* element_count < 0 means dynamically defined */
+ long int fixed_size;
+
+ /* callback used to return the dynamic length */
+ gras_datadesc_type_cb_int_t dynamic_size;
+} gras_dd_cat_array_t;
+
+/**
+ * gras_dd_cat_ignored_t:
+ *
+ * Specific fields of an ignored field
+ */
+typedef struct s_gras_dd_cat_ignored {
+ void *default_value;
+} gras_dd_cat_ignored_t;
+
+
+/**
+ * u_gras_datadesc_category:
+ *
+ * Specific data to each possible category
+ */
+union u_gras_datadesc_category {
+ void *undefined_data;
+ gras_dd_cat_scalar_t scalar_data;
+ gras_dd_cat_struct_t struct_data;
+ gras_dd_cat_union_t union_data;
+ gras_dd_cat_ref_t ref_data;
+ gras_dd_cat_array_t array_data;
+ gras_dd_cat_ignored_t ignored_data;
+};
+
+
+/****************************************/
+/* The holy grail: type descriptor type */
+/****************************************/
+/**
+ * s_gras_datadesc_type:
+ *
+ * Type descriptor.
+ */
+struct s_gras_datadesc_type {
+ /* headers for the data set */
+ unsigned int code;
+ char *name;
+ unsigned int name_len;
+
+ /* payload */
+ long int size;
+
+ long int alignment;
+ long int aligned_size;
+
+ enum e_gras_datadesc_type_category category_code;
+ union u_gras_datadesc_category category;
+
+ gras_datadesc_type_cb_void_t pre;
+ gras_datadesc_type_cb_void_t post;
+};
+
+/***************************
+ * Type creation functions *
+ ***************************/
+gras_error_t
+gras_ddt_new_scalar(const char *name,
+ long int size,
+ enum e_gras_dd_scalar_encoding encoding,
+ gras_datadesc_type_cb_void_t cb,
+ gras_datadesc_type_t **dst);
+gras_error_t
+gras_ddt_new_struct(const char *name,
+ gras_datadesc_type_cb_void_t pre,
+ gras_datadesc_type_cb_void_t post,
+ gras_datadesc_type_t **dst);
+gras_error_t
+gras_ddt_new_struct_append(gras_datadesc_type_t *struct_type,
+ const char *name,
+ gras_datadesc_type_t *field_type,
+ gras_datadesc_type_cb_void_t pre,
+ gras_datadesc_type_cb_void_t post);
+gras_error_t
+gras_ddt_new_union(const char *name,
+ gras_datadesc_type_cb_int_t field_count,
+ gras_datadesc_type_cb_void_t post,
+ gras_datadesc_type_t **dst);
+gras_error_t
+gras_ddt_new_union_append(gras_datadesc_type_t *union_type,
+ const char *name,
+ gras_datadesc_type_t *field_type,
+ gras_datadesc_type_cb_void_t pre,
+ gras_datadesc_type_cb_void_t post);
+gras_error_t
+gras_ddt_new_ref(const char *name,
+ gras_datadesc_type_t *referenced_type,
+ gras_datadesc_type_cb_int_t discriminant,
+ gras_datadesc_type_cb_void_t post,
+ gras_datadesc_type_t **dst);
+gras_error_t
+gras_ddt_new_array(const char *name,
+ gras_datadesc_type_t *element_type,
+ long int fixed_size,
+ gras_datadesc_type_cb_int_t dynamic_size,
+ gras_datadesc_type_cb_void_t post,
+ gras_datadesc_type_t **dst);
+
+
+
+#endif /* GRAS_DATADESC_PRIVATE_H */
