18 #ifdef HAVE_SYS_RESOURCE_H
19 #include <sys/resource.h>
21 #ifdef HAVE_SYS_TYPES_H
22 #include <sys/types.h>
24 #ifdef HAVE_SYS_STAT_H
36 #include "ncdispatch.h"
38 #include "ncpathmgr.h"
44 #define nulldup(s) ((s)?strdup(s):NULL)
51 NC_Dispatch *UDF0_dispatch_table = NULL;
53 NC_Dispatch *UDF1_dispatch_table = NULL;
134 if (dispatch_table->dispatch_version != NC_DISPATCH_VERSION)
146 UDF0_dispatch_table = dispatch_table;
150 else if(fIsSet(mode_flag,
NC_UDF1))
152 UDF1_dispatch_table = dispatch_table;
187 *dispatch_table = UDF0_dispatch_table;
191 else if(fIsSet(mode_flag,
NC_UDF1))
194 *dispatch_table = UDF1_dispatch_table;
473 size_t *chunksizehintp,
int *ncidp)
475 return NC_create(path, cmode, initialsz, 0,
476 chunksizehintp, 0, NULL, ncidp);
522 return NC_create(path, mode, initialsize, 0, NULL, 0, NULL, ncidp);
545 nc__create_mp(
const char *path,
int cmode,
size_t initialsz,
546 int basepe,
size_t *chunksizehintp,
int *ncidp)
548 return NC_create(path, cmode, initialsz, basepe,
549 chunksizehintp, 0, NULL, ncidp);
666 nc_open(
const char *path,
int omode,
int *ncidp)
668 return NC_open(path, omode, 0, NULL, 0, NULL, ncidp);
724 size_t *chunksizehintp,
int *ncidp)
729 return NC_open(path, omode, 0, chunksizehintp, 0, NULL, ncidp);
778 nc_open_mem(
const char* path,
int omode,
size_t size,
void* memory,
int* ncidp)
783 if(memory == NULL || size < MAGIC_NUMBER_LEN || path == NULL)
789 meminfo.memory = memory;
790 meminfo.flags = NC_MEMIO_LOCKED;
791 return NC_open(path, omode, 0, NULL, 0, &meminfo, ncidp);
846 if(path == NULL || params == NULL)
848 if(params->memory == NULL || params->size < MAGIC_NUMBER_LEN)
854 return NC_open(path, omode, 0, NULL, 0, params, ncidp);
876 nc__open_mp(
const char *path,
int omode,
int basepe,
877 size_t *chunksizehintp,
int *ncidp)
879 return NC_open(path, omode, basepe, chunksizehintp, 0, NULL, ncidp);
904 if ((stat = NC_check_id(ncid, &ncp)))
906 if(ncp->path == NULL) {
907 if(pathlen) *pathlen = 0;
908 if(path) path[0] =
'\0';
910 if (pathlen) *pathlen = strlen(ncp->path);
911 if (path) strcpy(path, ncp->path);
968 int stat = NC_check_id(ncid, &ncp);
970 return ncp->dispatch->redef(ncid);
1033 status = NC_check_id(ncid, &ncp);
1034 if(status !=
NC_NOERR)
return status;
1035 return ncp->dispatch->_enddef(ncid,0,1,0,1);
1120 nc__enddef(
int ncid,
size_t h_minfree,
size_t v_align,
size_t v_minfree,
1124 int stat = NC_check_id(ncid, &ncp);
1126 return ncp->dispatch->_enddef(ncid,h_minfree,v_align,v_minfree,r_align);
1200 int stat = NC_check_id(ncid, &ncp);
1202 return ncp->dispatch->sync(ncid);
1252 int stat = NC_check_id(ncid, &ncp);
1255 stat = ncp->dispatch->abort(ncid);
1256 del_from_NCList(ncp);
1305 int stat = NC_check_id(ncid, &ncp);
1308 stat = ncp->dispatch->close(ncid,NULL);
1312 del_from_NCList(ncp);
1364 int stat = NC_check_id(ncid, &ncp);
1367 stat = ncp->dispatch->close(ncid,memio);
1371 del_from_NCList(ncp);
1479 int stat = NC_check_id(ncid, &ncp);
1481 return ncp->dispatch->set_fill(ncid,fillmode,old_modep);
1499 nc_inq_base_pe(
int ncid,
int *pe)
1502 int stat = NC_check_id(ncid, &ncp);
1523 nc_set_base_pe(
int ncid,
int pe)
1526 int stat = NC_check_id(ncid, &ncp);
1552 int stat = NC_check_id(ncid, &ncp);
1554 return ncp->dispatch->inq_format(ncid,formatp);
1587 int stat = NC_check_id(ncid, &ncp);
1589 return ncp->dispatch->inq_format_extended(ncid,formatp,modep);
1637 nc_inq(
int ncid,
int *ndimsp,
int *nvarsp,
int *nattsp,
int *unlimdimidp)
1640 int stat = NC_check_id(ncid, &ncp);
1642 return ncp->dispatch->inq(ncid,ndimsp,nvarsp,nattsp,unlimdimidp);
1659 int stat = NC_check_id(ncid, &ncp);
1661 return ncp->dispatch->inq(ncid, NULL, nvarsp, NULL, NULL);
1739 if(xtype <= ATOMICTYPEMAX4) {
1740 if(name) strncpy(name,NC_atomictypename(xtype),
NC_MAX_NAME);
1741 if(size) *size = NC_atomictypelen(xtype);
1746 stat = NC_check_id(ncid, &ncp);
1750 return ncp->dispatch->inq_type(ncid,xtype,name,size);
1781 if (mode_format && (mode_format & (mode_format - 1)))
1835 NC_create(
const char *path0,
int cmode,
size_t initialsz,
1836 int basepe,
size_t *chunksizehintp,
int useparallel,
1837 void* parameters,
int *ncidp)
1841 const NC_Dispatch* dispatcher = NULL;
1844 char* newpath = NULL;
1857 if ((stat = nc_initialize()))
goto done;
1862 const unsigned char* p;
1863 for(p=(
const unsigned char*)path0;*p;p++) {
if(*p >
' ')
break;}
1864 path = nulldup((
const char*)p);
1867 memset(&model,0,
sizeof(model));
1869 if((stat = NC_infermodel(path,&cmode,1,useparallel,NULL,&model,&newpath)))
goto done;
1876 assert(model.format != 0 && model.impl != 0);
1893 switch (model.impl) {
1896 dispatcher = HDF5_dispatch_table;
1901 dispatcher = NCP_dispatch_table;
1906 dispatcher = UDF0_dispatch_table;
1909 dispatcher = UDF1_dispatch_table;
1912 #ifdef ENABLE_NCZARR
1914 dispatcher = NCZ_dispatch_table;
1918 dispatcher = NC3_dispatch_table;
1925 if((stat = new_NC(dispatcher,path,cmode,&ncp)))
goto done;
1931 if ((stat = dispatcher->create(ncp->path, cmode, initialsz, basepe, chunksizehintp,
1932 parameters, dispatcher, ncp->ext_ncid))) {
1933 del_from_NCList(ncp);
1936 if(ncidp)*ncidp = ncp->ext_ncid;
1968 NC_open(
const char *path0,
int omode,
int basepe,
size_t *chunksizehintp,
1969 int useparallel,
void* parameters,
int *ncidp)
1973 const NC_Dispatch* dispatcher = NULL;
1979 char* newpath = NULL;
1983 stat = nc_initialize();
1997 if(diskless && inmemory) {stat =
NC_EDISKLESS;
goto done;}
2012 for(p=(
const char*)path0;*p;p++) {
if(*p < 0 || *p >
' ')
break;}
2016 memset(&model,0,
sizeof(model));
2018 if((stat = NC_infermodel(path,&omode,0,useparallel,parameters,&model,&newpath)))
2027 if(model.impl == 0) {
2029 fprintf(stderr,
"implementation == 0\n");
2043 int nczarrbuilt = 0;
2053 #ifdef ENABLE_NCZARR
2056 if(UDF0_dispatch_table != NULL)
2058 if(UDF1_dispatch_table != NULL)
2084 #ifdef ENABLE_NCZARR
2097 if(UDF0_dispatch_table != NULL)
2099 if(UDF1_dispatch_table != NULL)
2102 if((built & (1 << model.impl)) == 0)
2113 switch (model.impl) {
2116 dispatcher = NCD2_dispatch_table;
2121 dispatcher = NCD4_dispatch_table;
2124 #ifdef ENABLE_NCZARR
2126 dispatcher = NCZ_dispatch_table;
2131 dispatcher = NCP_dispatch_table;
2136 dispatcher = HDF5_dispatch_table;
2141 dispatcher = HDF4_dispatch_table;
2146 dispatcher = UDF0_dispatch_table;
2149 dispatcher = UDF1_dispatch_table;
2153 dispatcher = NC3_dispatch_table;
2163 if (!dispatcher) {stat =
NC_ENOTNC;
goto done;}
2166 if((stat = new_NC(dispatcher,path,omode,&ncp)))
goto done;
2172 stat = dispatcher->open(ncp->path, omode, basepe, chunksizehintp,
2173 parameters, dispatcher, ncp->ext_ncid);
2175 if(ncidp) *ncidp = ncp->ext_ncid;
2177 del_from_NCList(ncp);
2192 static int pseudofd = 0;
2205 #ifdef HAVE_GETRLIMIT
2208 if(getrlimit(RLIMIT_NOFILE,&rl) == 0) {
2209 if(rl.rlim_max != RLIM_INFINITY)
2210 maxfd = (int)rl.rlim_max;
2211 if(rl.rlim_cur != RLIM_INFINITY)
2212 maxfd = (int)rl.rlim_cur;
int nc_inq_nvars(int ncid, int *nvarsp)
Learn the number of variables in a file or group.
int NC_initialized
True when dispatch table is initialized.
static int check_create_mode(int mode)
Check the create mode parameter for sanity.
int nc_inq_user_format(int mode_flag, NC_Dispatch **dispatch_table, char *magic_number)
Inquire about user-defined format.
int nc__create(const char *path, int cmode, size_t initialsz, size_t *chunksizehintp, int *ncidp)
Create a netCDF file with some extra parameters controlling classic file caching.
int nc_close(int ncid)
Close an open netCDF dataset.
int nc_abort(int ncid)
No longer necessary for user to invoke manually.
int nc_create(const char *path, int cmode, int *ncidp)
Create a new netCDF file.
int nc_inq(int ncid, int *ndimsp, int *nvarsp, int *nattsp, int *unlimdimidp)
Inquire about a file or group.
int nc_inq_format_extended(int ncid, int *formatp, int *modep)
Obtain more detailed (vis-a-vis nc_inq_format) format information about an open dataset.
int nc_close_memio(int ncid, NC_memio *memio)
Do a normal close (see nc_close()) on an in-memory dataset, then return a copy of the final memory co...
int nc__enddef(int ncid, size_t h_minfree, size_t v_align, size_t v_minfree, size_t r_align)
Leave define mode with performance tuning.
int nc_set_fill(int ncid, int fillmode, int *old_modep)
Change the fill-value mode to improve write performance.
int nc_create_mem(const char *path, int mode, size_t initialsize, int *ncidp)
Create a netCDF file with the contents stored in memory.
int nc__open(const char *path, int omode, size_t *chunksizehintp, int *ncidp)
Open a netCDF file with extra performance parameters for the classic library.
int nc_inq_path(int ncid, size_t *pathlen, char *path)
Get the file pathname (or the opendap URL) which was used to open/create the ncid's file.
int nc_open_mem(const char *path, int omode, size_t size, void *memory, int *ncidp)
Open a netCDF file with the contents taken from a block of memory.
int nc_def_user_format(int mode_flag, NC_Dispatch *dispatch_table, char *magic_number)
Add handling of user-defined format.
int nc_inq_type(int ncid, nc_type xtype, char *name, size_t *size)
Inquire about a type.
int nc_enddef(int ncid)
Leave define mode.
int nc_redef(int ncid)
Put open netcdf dataset into define mode.
int nc_open(const char *path, int omode, int *ncidp)
Open an existing netCDF file.
int nc_open_memio(const char *path, int omode, NC_memio *params, int *ncidp)
Open a netCDF file with the contents taken from a block of memory.
int nc_inq_format(int ncid, int *formatp)
Inquire about the binary format of a netCDF file as presented by the API.
int nc_sync(int ncid)
Synchronize an open netcdf dataset to disk.
#define NC_MAX_MAGIC_NUMBER_LEN
Max len of user-defined format magic number.
#define NC_NETCDF4
Use netCDF-4/HDF5 format.
#define NC_UDF0
User-defined format 0.
#define NC_EDISKLESS
Error in using diskless access.
#define NC_SIZEHINT_DEFAULT
Let nc__create() or nc__open() figure out a suitable buffer size.
#define NC_EBADTYPE
Not a netcdf data type.
#define NC_INMEMORY
Read from memory.
#define NC_CDF5
Alias NC_CDF5 to NC_64BIT_DATA.
#define NC_FORMATX_NC3
Extended format specifier returned by nc_inq_format_extended() Added in version 4....
#define NC_FORMATX_NCZARR
Extended format specifier returned by nc_inq_format_extended() Added in version 4....
#define NC_ENOTNC
Not a netcdf file.
#define NC_NAT
Not A Type.
#define NC_64BIT_OFFSET
Use large (64-bit) file offsets.
#define NC_EINMEMORY
In-memory file error.
#define NC_FORMATX_UDF1
Extended format specifier returned by nc_inq_format_extended() Added in version 4....
#define NC_FORMATX_PNETCDF
Extended format specifier returned by nc_inq_format_extended() Added in version 4....
#define NC_FORMAT_CDF5
Format specifier for nc_set_default_format() and returned by nc_inq_format.
#define NC_FORMATX_NC_HDF4
netCDF-4 subset of HDF4
#define NC_WRITE
Set read-write access for nc_open().
#define NC_FORMATX_NC_HDF5
netCDF-4 subset of HDF5
#define NC_FORMATX_DAP4
Extended format specifier returned by nc_inq_format_extended() Added in version 4....
#define NC_FORMATX_UDF0
Extended format specifier returned by nc_inq_format_extended() Added in version 4....
#define NC_DISKLESS
Use diskless file.
#define NC_FORMATX_DAP2
Extended format specifier returned by nc_inq_format_extended() Added in version 4....
#define NC_EINVAL
Invalid Argument.
#define NC_CLASSIC_MODEL
Enforce classic model on netCDF-4.
#define NC_MAX_NAME
Maximum for classic library.
#define NC_NOERR
No Error.
#define NC_64BIT_DATA
CDF-5 format: classic model but 64 bit dimensions and sizes.
#define NC_ENOTBUILT
Attempt to use feature that was not turned on when netCDF was built.
#define NC_UDF1
User-defined format 1.
int nc_type
The nc_type type is just an int.
#define NC_FORMATX_NC4
alias
Main header file for in-memory (diskless) functionality.