|
| 1 | +Appendix C. NetCDF Error Code Listing {#nc-error-codes} |
| 2 | +================== |
| 3 | + |
| 4 | +\tableofcontents |
| 5 | + |
| 6 | +# NetCDF-3 Error Codes {#nc3-error-codes} |
| 7 | + |
| 8 | +~~~~ |
| 9 | +#define NC_NOERR 0 // No Error |
| 10 | +#define NC_EBADID (-33) // Not a netcdf id |
| 11 | +#define NC_ENFILE (-34) // Too many netcdfs open |
| 12 | +#define NC_EEXIST (-35) // netcdf file exists && NC_NOCLOBBER |
| 13 | +#define NC_EINVAL (-36) // Invalid Argument |
| 14 | +#define NC_EPERM (-37) // Write to read only |
| 15 | +#define NC_ENOTINDEFINE (-38) // Operation not allowed in data mode |
| 16 | +#define NC_EINDEFINE (-39) // Operation not allowed in define mode |
| 17 | +#define NC_EINVALCOORDS (-40) // Index exceeds dimension bound |
| 18 | +#define NC_EMAXDIMS (-41) // NC_MAX_DIMS exceeded [not enforced after 4.5.0] |
| 19 | +#define NC_ENAMEINUSE (-42) // String match to name in use |
| 20 | +#define NC_ENOTATT (-43) // Attribute not found |
| 21 | +#define NC_EMAXATTS (-44) // NC_MAX_ATTRS exceeded [not enforced after 4.5.0] |
| 22 | +#define NC_EBADTYPE (-45) // Not a netcdf data type |
| 23 | +#define NC_EBADDIM (-46) // Invalid dimension id or name |
| 24 | +#define NC_EUNLIMPOS (-47) // NC_UNLIMITED in the wrong index |
| 25 | +#define NC_EMAXVARS (-48) // NC_MAX_VARS exceeded [not enforced after 4.5.0] |
| 26 | +#define NC_ENOTVAR (-49) // Variable not found |
| 27 | +#define NC_EGLOBAL (-50) // Action prohibited on NC_GLOBAL varid |
| 28 | +#define NC_ENOTNC (-51) // Not a netcdf file |
| 29 | +#define NC_ESTS (-52) // In Fortran, string too short |
| 30 | +#define NC_EMAXNAME (-53) // NC_MAX_NAME exceeded |
| 31 | +#define NC_EUNLIMIT (-54) // NC_UNLIMITED size already in use |
| 32 | +#define NC_ENORECVARS (-55) // nc_rec op when there are no record vars |
| 33 | +#define NC_ECHAR (-56) // Attempt to convert between text & numbers |
| 34 | +#define NC_EEDGE (-57) // Edge+start exceeds dimension bound |
| 35 | +#define NC_ESTRIDE (-58) // Illegal stride |
| 36 | +#define NC_EBADNAME (-59) // Attribute or variable name contains illegal characters |
| 37 | +
|
| 38 | +// N.B. following must match value in ncx.h |
| 39 | +
|
| 40 | +#define NC_ERANGE (-60) // Math result not representable |
| 41 | +#define NC_ENOMEM (-61) // Memory allocation (malloc) failure |
| 42 | +#define NC_EVARSIZE (-62) // One or more variable sizes violate format constraints |
| 43 | +#define NC_EDIMSIZE (-63) // Invalid dimension size |
| 44 | +#define NC_ETRUNC (-64) // File likely truncated or possibly corrupted |
| 45 | +#define NC_EAXISTYPE (-65) // Unknown axis type |
| 46 | +~~~~ |
| 47 | + |
| 48 | +# DAP Error Codes {#dap-error-codes} |
| 49 | + |
| 50 | +If the DAP client is enabled, then the following additional error codes |
| 51 | +may occur. |
| 52 | + |
| 53 | +~~~~ |
| 54 | +#define NC_EDAP (-66) // Generic DAP error |
| 55 | +#define NC_ECURL (-67) // Generic libcurl error |
| 56 | +#define NC_EIO (-68) // Generic IO error |
| 57 | +#define NC_ENODATA (-69) // Attempt to access variable with no data |
| 58 | +#define NC_EDAPSVC (-70) // DAP Server side error |
| 59 | +#define NC_EDAS (-71) // Malformed or inaccessible DAS |
| 60 | +#define NC_EDDS (-72) // Malformed or inaccessible DDS |
| 61 | +#define NC_EDATADDS (-73) // Malformed or inaccessible DATADDS |
| 62 | +#define NC_EDAPURL (-74) // Malformed DAP URL |
| 63 | +#define NC_EDAPCONSTRAINT (-75) // Malformed DAP Constraint |
| 64 | +#define NC_ETRANSLATION (-76) // Untranslatable construct |
| 65 | +#define NC_EACCESS (-77) // Access Failure |
| 66 | +#define NC_EAUTH (-78) // Authorization Failure |
| 67 | +~~~~ |
| 68 | + |
| 69 | +# Misc. additional errors |
| 70 | +~~~~ |
| 71 | +#define NC_ENOTFOUND (-90) // No such file |
| 72 | +#define NC_ECANTREMOVE (-91) // Cannot remove file |
| 73 | +#define NC_EINTERNAL (-92) // NetCDF Library Internal Error |
| 74 | +#define NC_EPNETCDF (-93) // Error at PnetCDF layer |
| 75 | +~~~~ |
| 76 | + |
| 77 | +# NetCDF-4 Error Codes {#nc4-error-codes} |
| 78 | + |
| 79 | +NetCDF-4 uses all error codes from NetCDF-3 (see section [NetCDF-3 Error |
| 80 | +Codes](#NetCDF_002d3-Error-Codes)). The following additional error codes |
| 81 | +were added for new errors unique to netCDF-4. |
| 82 | + |
| 83 | +~~~~ |
| 84 | +#define NC_EHDFERR (-101) // Error at HDF5 layer. |
| 85 | +#define NC_ECANTREAD (-102) // Cannot read. |
| 86 | +#define NC_ECANTWRITE (-103) // Cannot write. |
| 87 | +#define NC_ECANTCREATE (-104) // Cannot create. |
| 88 | +#define NC_EFILEMETA (-105) // Problem with file metadata. |
| 89 | +#define NC_EDIMMETA (-106) // Problem with dimension metadata. |
| 90 | +#define NC_EATTMETA (-107) // Problem with attribute metadata. |
| 91 | +#define NC_EVARMETA (-108) // Problem with variable metadata. |
| 92 | +#define NC_ENOCOMPOUND (-109) // Not a compound type. |
| 93 | +#define NC_EATTEXISTS (-110) // Attribute already exists. |
| 94 | +#define NC_ENOTNC4 (-111) // Attempting netcdf-4 operation on netcdf-3 file. |
| 95 | +#define NC_ESTRICTNC3 (-112) // Attempting netcdf-4 operation on strict nc3 netcdf-4 file. |
| 96 | +#define NC_ENOTNC3 (-113) // Attempting netcdf-3 operation on netcdf-4 file. |
| 97 | +#define NC_ENOPAR (-114) // Parallel operation on file opened for non-parallel access. |
| 98 | +#define NC_EPARINIT (-115) // Error initializing for parallel access. |
| 99 | +#define NC_EBADGRPID (-116) // Bad group ID. |
| 100 | +#define NC_EBADTYPID (-117) // Bad type ID. |
| 101 | +#define NC_ETYPDEFINED (-118) // Type has already been defined and may not be edited. |
| 102 | +#define NC_EBADFIELD (-119) // Bad field ID. |
| 103 | +#define NC_EBADCLASS (-120) // Bad class. |
| 104 | +#define NC_EMAPTYPE (-121) // Mapped access for atomic types only. |
| 105 | +#define NC_ELATEFILL (-122) // Attempt to define fill value when data already exists. |
| 106 | +#define NC_ELATEDEF (-123) // Attempt to define var properties, like deflate, after enddef. |
| 107 | +#define NC_EDIMSCALE (-124) // Problem with HDF5 dimscales. |
| 108 | +#define NC_ENOGRP (-125) // No group found. |
| 109 | +#define NC_ESTORAGE (-126) // Cannot specify both contiguous and chunking. |
| 110 | +#define NC_EBADCHUNK (-127) // Bad chunksize. |
| 111 | +#define NC_ENOTBUILT (-128) // Attempt to use feature that was not turned on when netCDF was built. |
| 112 | +#define NC_EDISKLESS (-129) // Error in using diskless access. |
| 113 | +#define NC_ECANTEXTEND (-130) // Attempt to extend dataset during ind. I/O operation. |
| 114 | +#define NC_EMPI (-131) // MPI operation failed. |
| 115 | +#define NC_EFILTER (-132) // Filter operation failed. |
| 116 | +#define NC_ERCFILE (-133) // RC file failure |
| 117 | +#define NC_ENULLPAD (-134) // Header Bytes not Null-Byte padded |
| 118 | +#define NC_EINMEMORY (-135) // In-memory file error |
| 119 | +~~~~ |
| 120 | + |
| 121 | +# PnetCDF Error Codes {#pnetcdf-error-codes} |
| 122 | + |
| 123 | +~~~~ |
| 124 | +#define NC_ESMALL (-201) // size of MPI_Offset too small for format |
| 125 | +#define NC_ENOTINDEP (-202) // Operation not allowed in collective data mode |
| 126 | +#define NC_EINDEP (-203) // Operation not allowed in independent data mode |
| 127 | +#define NC_EFILE (-204) // Unknown error in file operation |
| 128 | +#define NC_EREAD (-205) // Unknown error in reading file |
| 129 | +#define NC_EWRITE (-206) // Unknown error in writing to file |
| 130 | +#define NC_EOFILE (-207) // file open/creation failed |
| 131 | +#define NC_EMULTITYPES (-208) // Multiple etypes used in MPI datatype |
| 132 | +#define NC_EIOMISMATCH (-209) // Input/Output data amount mismatch |
| 133 | +#define NC_ENEGATIVECNT (-210) // Negative count is specified |
| 134 | +#define NC_EUNSPTETYPE (-211) // Unsupported etype in memory MPI datatype |
| 135 | +#define NC_EINVAL_REQUEST (-212) // invalid nonblocking request ID |
| 136 | +#define NC_EAINT_TOO_SMALL (-213) // MPI_Aint not large enough to hold requested value |
| 137 | +#define NC_ENOTSUPPORT (-214) // feature is not yet supported |
| 138 | +#define NC_ENULLBUF (-215) // trying to attach a NULL buffer |
| 139 | +#define NC_EPREVATTACHBUF (-216) // previous attached buffer is found |
| 140 | +#define NC_ENULLABUF (-217) // no attached buffer is found |
| 141 | +#define NC_EPENDINGBPUT (-218) // pending bput is found, cannot detach buffer |
| 142 | +#define NC_EINSUFFBUF (-219) // attached buffer is too small |
| 143 | +#define NC_ENOENT (-220) // File does not exist |
| 144 | +#define NC_EINTOVERFLOW (-221) // Overflow when type cast to 4-byte integer |
| 145 | +#define NC_ENOTENABLED (-222) // feature is not enabled |
| 146 | +#define NC_EBAD_FILE (-223) // Invalid file name (e.g., path name too long) |
| 147 | +#define NC_ENO_SPACE (-224) // Not enough space |
| 148 | +#define NC_EQUOTA (-225) // Quota exceeded |
| 149 | +#define NC_ENULLSTART (-226) // argument start is a NULL pointer |
| 150 | +#define NC_ENULLCOUNT (-227) // argument count is a NULL pointer |
| 151 | +#define NC_EINVAL_CMODE (-228) // Invalid file create mode |
| 152 | +#define NC_ETYPESIZE (-229) // MPI derived data type size error (bigger than the variable size) |
| 153 | +#define NC_ETYPE_MISMATCH (-230) // element type of the MPI derived data type mismatches the variable type |
| 154 | +#define NC_ETYPESIZE_MISMATCH (-231) // file type size mismatches buffer type size |
| 155 | +#define NC_ESTRICTCDF2 (-232) // Attempting CDF-5 operation on CDF-2 file |
| 156 | +#define NC_ENOTRECVAR (-233) // Attempting operation only for record variables |
| 157 | +#define NC_ENOTFILL (-234) // Attempting to fill a variable when its fill mode is off |
| 158 | +#define NC_EINVAL_OMODE (-235) // Invalid file open mode |
| 159 | +#define NC_EPENDING (-236) // Pending nonblocking request is found at file close |
| 160 | +#define NC_EMAX_REQ (-237) // Size of I/O request exceeds INT_MAX |
| 161 | +#define NC_EBADLOG (-238) // Unrecognized log file format |
| 162 | +#define NC_EFLUSHED (-239) // Nonblocking request has already been flushed to the PFS. It is too late to cancel |
| 163 | +#define NC_EMULTIDEFINE (-250) // NC definitions inconsistent among processes |
| 164 | +#define NC_EMULTIDEFINE_OMODE (-251) // inconsistent file open modes among processes |
| 165 | +#define NC_EMULTIDEFINE_DIM_NUM (-252) // inconsistent number of dimensions |
| 166 | +#define NC_EMULTIDEFINE_DIM_SIZE (-253) // inconsistent size of dimension |
| 167 | +#define NC_EMULTIDEFINE_DIM_NAME (-254) // inconsistent dimension names |
| 168 | +#define NC_EMULTIDEFINE_VAR_NUM (-255) // inconsistent number of variables |
| 169 | +#define NC_EMULTIDEFINE_VAR_NAME (-256) // inconsistent variable name |
| 170 | +#define NC_EMULTIDEFINE_VAR_NDIMS (-257) // inconsistent variable number of dimensions |
| 171 | +#define NC_EMULTIDEFINE_VAR_DIMIDS (-258) // inconsistent variable dimension IDs |
| 172 | +#define NC_EMULTIDEFINE_VAR_TYPE (-259) // inconsistent variable data type |
| 173 | +#define NC_EMULTIDEFINE_VAR_LEN (-260) // inconsistent variable size |
| 174 | +#define NC_EMULTIDEFINE_NUMRECS (-261) // inconsistent number of records |
| 175 | +#define NC_EMULTIDEFINE_VAR_BEGIN (-262) // inconsistent variable file begin offset (internal use) |
| 176 | +#define NC_EMULTIDEFINE_ATTR_NUM (-263) // inconsistent number of attributes |
| 177 | +#define NC_EMULTIDEFINE_ATTR_SIZE (-264) // inconsistent memory space used by attribute (internal use) |
| 178 | +#define NC_EMULTIDEFINE_ATTR_NAME (-265) // inconsistent attribute name |
| 179 | +#define NC_EMULTIDEFINE_ATTR_TYPE (-266) // inconsistent attribute type |
| 180 | +#define NC_EMULTIDEFINE_ATTR_LEN (-267) // inconsistent attribute length |
| 181 | +#define NC_EMULTIDEFINE_ATTR_VAL (-268) // inconsistent attribute value |
| 182 | +#define NC_EMULTIDEFINE_FNC_ARGS (-269) // inconsistent function arguments used in collective API |
| 183 | +#define NC_EMULTIDEFINE_FILL_MODE (-270) // inconsistent dataset fill mode |
| 184 | +#define NC_EMULTIDEFINE_VAR_FILL_MODE (-271) // inconsistent variable fill mode |
| 185 | +#define NC_EMULTIDEFINE_VAR_FILL_VALUE (-272) // inconsistent variable fill value |
| 186 | +#define NC_EMULTIDEFINE_CMODE (-273) // inconsistent file create modes among processes |
| 187 | +~~~~ |
| 188 | + |
0 commit comments