Helpers for libtrap

Macros
#define	TRAP_RECEIVE(ifc_num, data, data_size, tmplt)   TRAP_CTX_RECEIVE(trap_get_global_ctx(), ifc_num, data, data_size, tmplt);
	Receive data from interface Receive data with specified template from libtrap interface. If the receiving template is subset of sending template, it will define new fields and expand receiving template. More...
#define	TRAP_CTX_RECEIVE(ctx, ifc_num, data, data_size, tmplt)
	Receive data from interface with given context Receive data with specified template from libtrap interface with specified context. If the receiving template is subset of sending template, it will define new fields and expand receiving template. More...

Detailed Description

This module defines useful macros for handling data receive. When data format is changed, these macros create new UniRec template.

Macro Definition Documentation

TRAP_CTX_RECEIVE

#define TRAP_CTX_RECEIVE	(		ctx,
			ifc_num,
			data,
			data_size,
			tmplt
	)

Value:

__extension__ \
({\
   int ret = trap_ctx_recv(ctx, ifc_num, &data, &data_size);\
   if (ret == TRAP_E_FORMAT_CHANGED) {\
      const char *spec = NULL;\
      uint8_t data_fmt;\
      if (trap_ctx_get_data_fmt(ctx, TRAPIFC_INPUT, ifc_num, &data_fmt, &spec) != TRAP_E_OK) {\
         fprintf(stderr, "Data format was not loaded.\n");\
      } else {\
         tmplt = ur_define_fields_and_update_template(spec, tmplt);\
         if (tmplt == NULL) {\
            fprintf(stderr, "Template could not be edited.\n");\
         } else {\
            if (tmplt->direction == UR_TMPLT_DIRECTION_BI) {\
               char * spec_cpy = ur_cpy_string(spec);\
               if (spec_cpy == NULL) {\
                  fprintf(stderr, "Memory allocation problem.\n");\
               } else {\
                  trap_ctx_set_data_fmt(ctx, tmplt->ifc_out, TRAP_FMT_UNIREC, spec_cpy);\
               }\
            }\
         }\
      }\
   }\
   ret;\
})

Receive data from interface with given context Receive data with specified template from libtrap interface with specified context. If the receiving template is subset of sending template, it will define new fields and expand receiving template.

Parameters

[in]	ctx	context
[in]	ifc_num	index of libtrap interface
[in]	data	pointer to memory where the data will be stored
[in]	data_size	size of allocated space for data
[in]	tmplt	pointer to input template

Returns

return value of trap_ctx_recv

Definition at line 233 of file unirec.h.

TRAP_RECEIVE

#define TRAP_RECEIVE	(		ifc_num,
			data,
			data_size,
			tmplt
	)		TRAP_CTX_RECEIVE(trap_get_global_ctx(), ifc_num, data, data_size, tmplt);

Receive data from interface Receive data with specified template from libtrap interface. If the receiving template is subset of sending template, it will define new fields and expand receiving template.

Parameters

[in]	ifc_num	index of libtrap interface
[in]	data	pointer to memory where the data will be stored
[in]	data_size	size of allocated space for data
[in]	tmplt	pointer to input template

Returns

return value of trap_recv

Definition at line 219 of file unirec.h.