netcdf-c/docs
Dennis Heimbigner 4636584d5b Revert/Improve nc_create + NC_DISKLESS behavior
re: https://github.com/Unidata/netcdf-c/issues/1154

Inadvertently, the behavior of NC_DISKLESS with nc_create() was
changed in release 4.6.1. Previously, the NC_WRITE flag needed
to be explicitly used with NC_DISKLESS in order to cause the
created file to be persisted to disk.

Additional analyis indicated that the current NC_DISKLESS
implementation was seriously flawed.

This PR attempts to clean up and regularize the situation with
respect to NC_DISKLESS control. One important aspect of diskless
operation is that there are two different notions of write.

1. The file is read-write vs read-only when using the netcdf API.
2. The file is persisted or not to disk at nc_close().

Previously, these two were conflated. The rules now are
as follows.

1. NC_DISKLESS + NC_WRITE means that the file is read/write using the netcdf API
2. NC_DISKLESS + NC_PERSIST means that the file is persisted to a disk file at nc_close.
3. NC_DISKLESS + NC_PERSIST + NC_WRITE means both 1 and 2.

The NC_PERSIST flag is new and takes over the obsolete NC_MPIPOSIX flag.
NC_MPIPOSIX is still defined, but is now an alias for the NC_MPIIO flag.

It is also now the case that for netcdf-4, NC_DISKLESS is independent
of NC_INMEMORY and in fact it is an error to specify both flags
simultaneously.

Finally, the MMAP code was fixed to use NC_PERSIST as well.
Also marked MMAP as deprecated.

Also added a test case to test various combinations of NC_DISKLESS,
NC_PERSIST, and NC_WRITE.

This PR affects a number of files and especially test cases
that used NC_DISKLESS.

Misc. Unrelated fixes
1. fixed some warnings in ncdump/dumplib.c
2018-10-10 13:32:17 -06:00
..
images
obsolete Misc. source comment typos 2018-04-26 23:04:01 -04:00
old More replacement of "parallel-netcdf" with "PnetCDF". 2018-09-20 11:45:25 -05:00
static-pages Use PnetCDF instead of parallel-netcdf to avoid confusion with 2018-09-17 17:18:48 -05:00
.gitignore
all-error-codes.md introduce error code NC_EPNETCDF for errors at PnetCDF level 2018-07-29 15:33:08 -05:00
architecture.dox Use PnetCDF instead of parallel-netcdf to avoid confusion with 2018-09-17 17:18:48 -05:00
attribute_conventions.md There was a request to extend the provenance information 2018-08-25 21:44:41 -06:00
auth.html Misc. source comment typos 2018-04-26 23:04:01 -04:00
auth.md The pr does some cleanup on the internal documentation 2018-06-29 15:06:27 -06:00
bestpractices.md
building-with-cmake.md
cdl.dox Misc. source comment typos 2018-04-26 23:04:01 -04:00
CMakeLists.txt Modify DAP2 and DAP4 to optionally allow Fillvalue/Variable mismatch 2018-10-01 15:51:43 -06:00
COPYRIGHT.dox
credits.md
DAP2.dox Modify DAP2 and DAP4 to optionally allow Fillvalue/Variable mismatch 2018-10-01 15:51:43 -06:00
DAP4.dox
dispatch.dox
docmap.pdf
Doxyfile.developer Misc. source comment typos 2018-04-26 23:04:01 -04:00
Doxyfile.in Modify DAP2 and DAP4 to optionally allow Fillvalue/Variable mismatch 2018-10-01 15:51:43 -06:00
DoxygenLayout.xml
esg.md
FAQ.md add missing note about CDF-5 format 2018-07-05 22:54:41 -05:00
file_format_specifications.md Misc. source comment typos 2018-04-26 23:04:01 -04:00
filters.md Fix memory problems when using HDF5 version 1.10.x and later. 2018-10-04 11:37:21 -06:00
footer.html
groups.dox
guide.dox Use PnetCDF instead of parallel-netcdf to avoid confusion with 2018-09-17 17:18:48 -05:00
header.html
indexing.dox The pr does some cleanup on the internal documentation 2018-06-29 15:06:27 -06:00
inmeminternal.dox Fix the NC_INMEMORY code to work in all cases with HDF5 1.10. 2018-09-04 11:27:47 -06:00
inmemory.md Revert/Improve nc_create + NC_DISKLESS behavior 2018-10-10 13:32:17 -06:00
install-fortran.md
install.md Use PnetCDF instead of parallel-netcdf to avoid confusion with 2018-09-17 17:18:48 -05:00
internal.dox Use PnetCDF instead of parallel-netcdf to avoid confusion with 2018-09-17 17:18:48 -05:00
known_problems.md
mainpage.dox
Makefile.am Modify DAP2 and DAP4 to optionally allow Fillvalue/Variable mismatch 2018-10-01 15:51:43 -06:00
netcdf-50x50.png
netcdf.m4
notes.md
OPeNDAP.dox Modify DAP2 and DAP4 to optionally allow Fillvalue/Variable mismatch 2018-10-01 15:51:43 -06:00
release_header.html
release.css
tests.md
testserver.dox Doxygen is apparently buggy when trying to combine a markdown 2018-07-01 21:56:59 -06:00
tutorial.dox Merge branch 'master' into var_par_access 2018-07-26 01:35:39 -05:00
types.dox add missing note about CDF-5 format 2018-07-05 22:54:41 -05:00
unidata_logo_cmyk.png
user_defined_formats.md Add warning about user formats 2018-07-13 11:47:58 -06:00
windows-binaries.md