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;
136 if (dispatch_table->dispatch_version != NC_DISPATCH_VERSION)
144 UDF0_dispatch_table = dispatch_table;
149 UDF1_dispatch_table = dispatch_table;
185 *dispatch_table = UDF0_dispatch_table;
191 *dispatch_table = UDF1_dispatch_table;
467 size_t *chunksizehintp,
int *ncidp)
469 return NC_create(path, cmode, initialsz, 0,
470 chunksizehintp, 0, NULL, ncidp);
516 return NC_create(path, mode, initialsize, 0, NULL, 0, NULL, ncidp);
539 nc__create_mp(
const char *path,
int cmode,
size_t initialsz,
540 int basepe,
size_t *chunksizehintp,
int *ncidp)
542 return NC_create(path, cmode, initialsz, basepe,
543 chunksizehintp, 0, NULL, ncidp);
660 nc_open(
const char *path,
int omode,
int *ncidp)
662 return NC_open(path, omode, 0, NULL, 0, NULL, ncidp);
718 size_t *chunksizehintp,
int *ncidp)
723 return NC_open(path, omode, 0, chunksizehintp, 0, NULL, ncidp);
772 nc_open_mem(
const char* path,
int omode,
size_t size,
void* memory,
int* ncidp)
777 if(memory == NULL || size < MAGIC_NUMBER_LEN || path == NULL)
783 meminfo.memory = memory;
784 meminfo.flags = NC_MEMIO_LOCKED;
785 return NC_open(path, omode, 0, NULL, 0, &meminfo, ncidp);
840 if(path == NULL || params == NULL)
842 if(params->memory == NULL || params->size < MAGIC_NUMBER_LEN)
848 return NC_open(path, omode, 0, NULL, 0, params, ncidp);
870 nc__open_mp(
const char *path,
int omode,
int basepe,
871 size_t *chunksizehintp,
int *ncidp)
873 return NC_open(path, omode, basepe, chunksizehintp, 0, NULL, ncidp);
898 if ((stat = NC_check_id(ncid, &ncp)))
900 if(ncp->path == NULL) {
901 if(pathlen) *pathlen = 0;
902 if(path) path[0] =
'\0';
904 if (pathlen) *pathlen = strlen(ncp->path);
905 if (path) strcpy(path, ncp->path);
962 int stat = NC_check_id(ncid, &ncp);
964 return ncp->dispatch->redef(ncid);
1027 status = NC_check_id(ncid, &ncp);
1028 if(status !=
NC_NOERR)
return status;
1029 return ncp->dispatch->_enddef(ncid,0,1,0,1);
1114 nc__enddef(
int ncid,
size_t h_minfree,
size_t v_align,
size_t v_minfree,
1118 int stat = NC_check_id(ncid, &ncp);
1120 return ncp->dispatch->_enddef(ncid,h_minfree,v_align,v_minfree,r_align);
1194 int stat = NC_check_id(ncid, &ncp);
1196 return ncp->dispatch->sync(ncid);
1246 int stat = NC_check_id(ncid, &ncp);
1249 stat = ncp->dispatch->abort(ncid);
1250 del_from_NCList(ncp);
1299 int stat = NC_check_id(ncid, &ncp);
1302 stat = ncp->dispatch->close(ncid,NULL);
1306 del_from_NCList(ncp);
1358 int stat = NC_check_id(ncid, &ncp);
1361 stat = ncp->dispatch->close(ncid,memio);
1365 del_from_NCList(ncp);
1473 int stat = NC_check_id(ncid, &ncp);
1475 return ncp->dispatch->set_fill(ncid,fillmode,old_modep);
1493 nc_inq_base_pe(
int ncid,
int *pe)
1496 int stat = NC_check_id(ncid, &ncp);
1517 nc_set_base_pe(
int ncid,
int pe)
1520 int stat = NC_check_id(ncid, &ncp);
1546 int stat = NC_check_id(ncid, &ncp);
1548 return ncp->dispatch->inq_format(ncid,formatp);
1581 int stat = NC_check_id(ncid, &ncp);
1583 return ncp->dispatch->inq_format_extended(ncid,formatp,modep);
1631 nc_inq(
int ncid,
int *ndimsp,
int *nvarsp,
int *nattsp,
int *unlimdimidp)
1634 int stat = NC_check_id(ncid, &ncp);
1636 return ncp->dispatch->inq(ncid,ndimsp,nvarsp,nattsp,unlimdimidp);
1653 int stat = NC_check_id(ncid, &ncp);
1655 return ncp->dispatch->inq(ncid, NULL, nvarsp, NULL, NULL);
1733 if(xtype <= ATOMICTYPEMAX4) {
1734 if(name) strncpy(name,NC_atomictypename(xtype),
NC_MAX_NAME);
1735 if(size) *size = NC_atomictypelen(xtype);
1740 stat = NC_check_id(ncid, &ncp);
1744 return ncp->dispatch->inq_type(ncid,xtype,name,size);
1775 if (mode_format && (mode_format & (mode_format - 1)))
1829 NC_create(
const char *path0,
int cmode,
size_t initialsz,
1830 int basepe,
size_t *chunksizehintp,
int useparallel,
1831 void* parameters,
int *ncidp)
1835 const NC_Dispatch* dispatcher = NULL;
1838 char* newpath = NULL;
1853 if ((stat = nc_initialize()))
1859 const unsigned char* p;
1860 for(p=(
const unsigned char*)path0;*p;p++) {
if(*p >
' ')
break;}
1861 path = nulldup((
const char*)p);
1864 memset(&model,0,
sizeof(model));
1866 if((stat = NC_infermodel(path,&cmode,1,useparallel,NULL,&model,&newpath))) {
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;
1967 NC_open(
const char *path0,
int omode,
int basepe,
size_t *chunksizehintp,
1968 int useparallel,
void* parameters,
int *ncidp)
1972 const NC_Dispatch* dispatcher = NULL;
1978 char* newpath = NULL;
1982 stat = nc_initialize();
1983 if(stat)
return stat;
1996 if(diskless && inmemory) {stat =
NC_EDISKLESS;
goto done;}
2011 for(p=(
const char*)path0;*p;p++) {
if(*p < 0 || *p >
' ')
break;}
2015 memset(&model,0,
sizeof(model));
2017 if((stat = NC_infermodel(path,&omode,0,useparallel,parameters,&model,&newpath)))
2026 if(model.impl == 0) {
2028 fprintf(stderr,
"implementation == 0\n");
2042 int nczarrbuilt = 0;
2052 #ifdef ENABLE_NCZARR
2055 if(UDF0_dispatch_table != NULL)
2057 if(UDF1_dispatch_table != NULL)
2083 #ifdef ENABLE_NCZARR
2096 if(UDF0_dispatch_table != NULL)
2098 if(UDF1_dispatch_table != NULL)
2101 if((built & (1 << model.impl)) == 0)
2112 switch (model.impl) {
2115 dispatcher = NCD2_dispatch_table;
2120 dispatcher = NCD4_dispatch_table;
2123 #ifdef ENABLE_NCZARR
2125 dispatcher = NCZ_dispatch_table;
2130 dispatcher = NCP_dispatch_table;
2135 dispatcher = HDF5_dispatch_table;
2140 dispatcher = HDF4_dispatch_table;
2145 dispatcher = UDF0_dispatch_table;
2148 dispatcher = UDF1_dispatch_table;
2152 dispatcher = NC3_dispatch_table;
2162 if (!dispatcher) {stat =
NC_ENOTNC;
goto done;}
2165 if((stat = new_NC(dispatcher,path,omode,&ncp)))
goto done;
2171 stat = dispatcher->open(ncp->path, omode, basepe, chunksizehintp,
2172 parameters, dispatcher, ncp->ext_ncid);
2174 if(ncidp) *ncidp = ncp->ext_ncid;
2176 del_from_NCList(ncp);
2191 static int pseudofd = 0;
2204 #ifdef HAVE_GETRLIMIT
2207 if(getrlimit(RLIMIT_NOFILE,&rl) == 0) {
2208 if(rl.rlim_max != RLIM_INFINITY)
2209 maxfd = (int)rl.rlim_max;
2210 if(rl.rlim_cur != RLIM_INFINITY)
2211 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_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.