netcdf-c/include/nc_provenance.h
Dennis Heimbigner 2eb1a8d8cf For some reason, the code for this was incorrect.
Anyway, I repaired it as follows:
1. Created NC4_write_provenance as parallel to NC4_read_provenance
2. Modified hdf5file.c to use NC4_write_provenance
3. Modified hdf5open.c to use NC4_read_provenance (was NC4_read_ncproperties).
4. The creation of the _NCProperties string was seriously hosed:
   was using all the wrong fields.
2019-04-18 14:23:20 -06:00

83 lines
2.5 KiB
C

/* Copyright 2018-2018 University Corporation for Atmospheric
Research/Unidata. */
/**
* @file
* @internal Contains information for creating provenance
* info and/or displaying provenance info.
*
* It has come to pass that we can't guarantee that this information is
* contained only within netcdf4 files. As a result, we need
* to make printing these hidden attributes available to
* netcdf3 as well.
*
*
* For netcdf4 files, capture state information about the following:
* - Global: netcdf library version
* - Global: hdf5 library version
* - Global: any parameters specified by the --with-ncproperties option for ./configure
* - Per file: superblock version
* - Per File: was it created by netcdf-4?
* - Per file: _NCProperties attribute
*
* @author Dennis Heimbigner, Ward Fisher
*/
#ifndef _NCPROVENANCE_
#define _NCPROVENANCE_
#define NCPROPS "_NCProperties"
#define NCPVERSION "version" /* Of the properties format */
#define NCPHDF5LIB1 "hdf5libversion"
#define NCPNCLIB1 "netcdflibversion"
#define NCPHDF5LIB2 "hdf5"
#define NCPNCLIB2 "netcdf"
#define NCPROPS_VERSION (2)
/* Version 2 changes this because '|' was causing bash problems */
#define NCPROPSSEP1 '|'
#define NCPROPSSEP2 ','
/* Other hidden attributes */
#define ISNETCDF4ATT "_IsNetcdf4"
#define SUPERBLOCKATT "_SuperblockVersion"
/* Forward */
struct NC_FILE_INFO;
/**************************************************/
/**
For netcdf4 files, capture state information about the following:
1. Global: netcdf library version
2. Global: hdf5 library version
3. Per file: superblock version
4. Per File: was it created by netcdf-4?
5. Per file: _NCProperties attribute
*/
typedef struct NC4_Provenance {
char* ncproperties; /* raw value of _NCProperties; NULL => does not exist */
int version;
int superblockversion;
} NC4_Provenance;
/* Provenance Management (moved from nc4internal.h) */
/* Initialize the provenance global state */
extern int NC4_provenance_init(void);
/* Finalize the provenance global state */
extern int NC4_provenance_finalize(void);
/* Read and store the provenance from an existing file */
extern int NC4_read_provenance(struct NC_FILE_INFO* file);
/* Write the provenance into a newly created file */
extern int NC4_write_provenance(struct NC_FILE_INFO* file);
/* Create the provenance for a newly created file */
extern int NC4_new_provenance(struct NC_FILE_INFO* file);
/* Clean up the provenance info in a file */
extern int NC4_clear_provenance(NC4_Provenance* prov);
#endif /* _NCPROVENANCE_ */