mirror of
https://github.com/Unidata/netcdf-c.git
synced 2025-01-06 15:34:44 +08:00
6b69b9c52c
## S3 Related Fixes * Add comprehensive support for specifying AWS profiles to provide access credentials. * Parse the files "~/.aws/config" and "~/.aws/credentials to provide credentials for the HDF5 ROS3 driver and to locate default region. * Add a function to obtain the currently active S3 credentials. The search rules are defined in docs/nczarr.md. * Provide documentation for the new features. * Modify the struct NCauth (in include/ncauth.h) to replace specific S3 credentials with a profile name. * Add a unit test to test the operation of profile and credentials management. * Add support for URLS of the form "s3://<bucket>/<key>"; this requires obtaining a default region. * Allows the specification of profile and/or region in a URL of the form "#mode=nczarr,...&aws.region=...&aws.profile=..." ## Misc. Fixes * Move the ezxml code to libdispatch so that it can be used both by DAP4 and nczarr. * Modify nclist to provide a deep clone operation. * Modify ncuri to provide a deep clone operation. * Modify the .rc file format to allow the specification of a path to be tested when looking for an entry in the .rc file. * Ensure that the NC_rcload function is called. * Modify nchttp to support setting request headers.
91 lines
4.0 KiB
C
91 lines
4.0 KiB
C
/*********************************************************************
|
|
* Copyright 2018, UCAR/Unidata
|
|
* See netcdf/COPYRIGHT file for copying and redistribution conditions.
|
|
*********************************************************************/
|
|
|
|
/**
|
|
* Provide the zarr specific code to implement the netcdf-4 code.
|
|
*
|
|
* @author Dennis Heimbigner
|
|
*/
|
|
|
|
#ifndef ZARR_H
|
|
#define ZARR_H
|
|
|
|
typedef struct ZS3INFO {
|
|
char* host; /* non-null if other*/
|
|
char* region; /* region */
|
|
char* bucket; /* bucket name */
|
|
char* rootkey;
|
|
char* profile;
|
|
} ZS3INFO;
|
|
|
|
struct ChunkKey;
|
|
struct S3credentials;
|
|
|
|
/* zarr.c */
|
|
extern int ncz_create_dataset(NC_FILE_INFO_T*, NC_GRP_INFO_T*, const char** controls);
|
|
extern int ncz_open_dataset(NC_FILE_INFO_T*, const char** controls);
|
|
extern int ncz_del_attr(NC_FILE_INFO_T* file, NC_OBJ* container, const char* name);
|
|
|
|
/* HDF5 Mimics */
|
|
extern int NCZ_isnetcdf4(struct NC_FILE_INFO*);
|
|
extern int NCZ_get_libversion(unsigned long* majorp, unsigned long* minorp,unsigned long* releasep);
|
|
extern int NCZ_get_superblock(NC_FILE_INFO_T* file, int* superblockp);
|
|
|
|
extern int ncz_unload_jatts(NCZ_FILE_INFO_T*, NC_OBJ* container, NCjson* jattrs, NCjson* jtypes);
|
|
|
|
/* zclose.c */
|
|
extern int ncz_close_file(NC_FILE_INFO_T* file, int abort);
|
|
|
|
/* zcvt.c */
|
|
extern int NCZ_convert1(NCjson* jsrc, nc_type, unsigned char* memory0);
|
|
extern int NCZ_stringconvert1(nc_type typid, size_t len, char* src, NCjson* jvalue);
|
|
extern int NCZ_stringconvert(nc_type typid, size_t len, void* data0, NCjson** jdatap);
|
|
|
|
/* zsync.c */
|
|
extern int ncz_sync_file(NC_FILE_INFO_T* file, int isclose);
|
|
extern int ncz_sync_grp(NC_FILE_INFO_T* file, NC_GRP_INFO_T* grp, int isclose);
|
|
extern int ncz_sync_atts(NC_FILE_INFO_T*, NC_OBJ* container, NCindex* attlist, int isclose);
|
|
extern int ncz_read_grp(NC_FILE_INFO_T* file, NC_GRP_INFO_T* grp);
|
|
extern int ncz_read_atts(NC_FILE_INFO_T* file, NC_OBJ* container);
|
|
extern int ncz_read_vars(NC_FILE_INFO_T* file, NC_GRP_INFO_T* grp);
|
|
extern int ncz_read_file(NC_FILE_INFO_T* file);
|
|
extern int ncz_write_var(NC_VAR_INFO_T* var);
|
|
extern int ncz_read_superblock(NC_FILE_INFO_T* zinfo, char** nczarrvp, char** zarrfp);
|
|
|
|
/* zutil.c */
|
|
extern int NCZ_grpkey(const NC_GRP_INFO_T* grp, char** pathp);
|
|
extern int NCZ_varkey(const NC_VAR_INFO_T* var, char** pathp);
|
|
extern int NCZ_dimkey(const NC_DIM_INFO_T* dim, char** pathp);
|
|
extern int ncz_splitkey(const char* path, NClist* segments);
|
|
extern int NCZ_readdict(NCZMAP* zmap, const char* key, NCjson** jsonp);
|
|
extern int NCZ_readarray(NCZMAP* zmap, const char* key, NCjson** jsonp);
|
|
extern int ncz_zarr_type_name(nc_type nctype, int little, const char** znamep);
|
|
extern int ncz_nctype2typeinfo(const char* snctype, nc_type* nctypep);
|
|
extern int ncz_dtype2typeinfo(const char* dtype, nc_type* nctypep, int* endianness);
|
|
extern int ncz_fill_value_sort(nc_type nctype, int*);
|
|
extern int NCZ_createobject(NCZMAP* zmap, const char* key, size64_t size);
|
|
extern int NCZ_uploadjson(NCZMAP* zmap, const char* key, NCjson* json);
|
|
extern int NCZ_downloadjson(NCZMAP* zmap, const char* key, NCjson** jsonp);
|
|
extern int NCZ_isLittleEndian(void);
|
|
extern int NCZ_subobjects(NCZMAP* map, const char* prefix, const char* tag, char dimsep, NClist* objlist);
|
|
extern int NCZ_grpname_full(int gid, char** pathp);
|
|
extern int ncz_get_var_meta(NC_FILE_INFO_T* file, NC_VAR_INFO_T* var);
|
|
extern int NCZ_comma_parse(const char* s, NClist* list);
|
|
extern int NCZ_swapatomicdata(size_t datalen, void* data, int typesize);
|
|
extern char** NCZ_clonestringvec(size_t len, const char** vec);
|
|
extern void NCZ_freestringvec(size_t len, char** vec);
|
|
extern int NCZ_create_fill_chunk(size64_t chunksize, size_t typesize, const void* fill, void** fillchunkp);
|
|
extern int NCZ_s3clear(ZS3INFO* s3map);
|
|
extern int NCZ_ischunkname(const char* name,char dimsep);
|
|
extern char* NCZ_chunkpath(struct ChunkKey key);
|
|
|
|
/* Export */
|
|
EXTERNL int NCZ_s3urlprocess(NCURI* url, ZS3INFO* s3);
|
|
|
|
/* zwalk.c */
|
|
EXTERNL int NCZ_read_chunk(int ncid, int varid, size64_t* zindices, void* chunkdata);
|
|
|
|
#endif /*ZARR_H*/
|