gd_endianness(3) [debian man page]

gd_endianness(3)						      GETDATA							  gd_endianness(3)

NAME

       gd_endianness -- report the byte sex of fields in a dirfile

SYNOPSIS

       #include <getdata.h>

       unsigned long gd_endianness(DIRFILE *dirfile, int fragment_index);

DESCRIPTION

       The  gd_endianness() function queries a dirfile(5) database specified by dirfile and returns the byte sex for the fragment indexed by frag-
       ment_index.  The byte sex of a fragment indicate the endianness of data stored in binary files associated with RAW fields  defined  in  the
       specified fragment.  The endianness of a fragment containing no RAW fields is not meaningful.

       The dirfile argument must point to a valid DIRFILE object previously created by a call to gd_open(3).

RETURN VALUE

       Upon  successful  completion, gd_endianness() returns the byte sex of the specified fragment, which will be either GD_BIG_ENDIAN or GD_LIT-
       TLE_ENDIAN, bitwise-or'd with either GD_ARM_ENDIAN or GD_NOT_ARM_ENDIAN, indicating whether double-precision floating point  data  in  this
       fragment  are  stored in the old ARM middle-endian format.  On error, it returns zero and sets the dirfile error to a non-zero error value.
       Possible error values are:

       GD_E_BAD_DIRFILE
	       The supplied dirfile was invalid.

       GD_E_BAD_INDEX
	       The supplied index was out of range.

       The dirfile error may be retrieved by calling gd_error(3).  A descriptive error string for the last error encountered can be obtained  from
       a call to gd_error_string(3).

SEE ALSO

       gd_alter_endianness(3), gd_getdata(3), gd_error(3), gd_error_string(3), gd_open(3), dirfile(5), dirfile-format(5)

Version 0.7.0							   17 July 2010 						  gd_endianness(3)

gd_reference(3) 						      GETDATA							   gd_reference(3)

NAME

       gd_reference -- retrieve or set the reference field for a dirfile

SYNOPSIS

       #include <getdata.h>

       const char *gd_reference(DIRFILE *dirfile, const char *field_code);

DESCRIPTION

       The  gd_reference()  function  sets or retrieves the reference field (see dirfile(5)) associated with the dirfile specified by dirfile.	If
       the field_code argument is non-NULL, the reference field for the dirfile will be set to the field specified.  If field_code  is	NULL,  the
       reference field is not modified.  The field code should refer to a RAW field, and may not contain a representation suffix.

RETURN VALUE

       On  success,  gd_reference()  returns the field code of the dirfile's reference field, which will be field_code, if field_code is non-NULL.
       If no RAW fields are defined in the dirfile, this function will return NULL, without raising an error.  On error, NULL is returned and  the
       dirfile error is set to a non-zero error value.	Possible error values are:

       GD_E_ACCMODE
	       The specified dirfile was opened read-only.

       GD_E_ALLOC
	       The library was unable to allocate memory.

       GD_E_BAD_CODE
	       The field specified by field_code was not found.

       GD_E_BAD_DIRFILE
	       The supplied dirfile was invalid.

       GD_E_BAD_FIELD_TYPE
	       The field specified by field_code was not a RAW field.

       GD_E_PROTECTED
	       The  metadata of the primary format specification fragment (the file named format in the root dirfile directory) was protected from
	       change.

       The dirfile error may be retrieved by calling gd_error(3).  A descriptive error string for the last error encountered can be obtained  from
       a call to gd_error_string(3).

SEE ALSO

       gd_metaflush(3), gd_open(3), gd_error(3), gd_error_string(3), dirfile(5), dirfile-format(5)

Version 0.7.0							   20 July 2010 						   gd_reference(3)