mirror of
https://github.com/Unidata/netcdf-c.git
synced 2024-12-27 08:49:16 +08:00
0b7a5382e7
The netcdf-c code has to deal with a variety of platforms: Windows, OSX, Linux, Cygwin, MSYS, etc. These platforms differ significantly in the kind of file paths that they accept. So in order to handle this, I have created a set of replacements for the most common file system operations such as _open_ or _fopen_ or _access_ to manage the file path differences correctly. A more limited version of this idea was already implemented via the ncwinpath.h and dwinpath.c code. So this can be viewed as a replacement for that code. And in path in many cases, the only change that was required was to replace '#include <ncwinpath.h>' with '#include <ncpathmgt.h>' and then replace file operation calls with the NCxxx equivalent from ncpathmgr.h Note that recently, the ncwinpath.h was renamed ncpathmgmt.h, so this pull request should not require dealing with winpath. The heart of the change is include/ncpathmgmt.h, which provides alternate operations such as NCfopen or NCaccess and which properly parse and rebuild path arguments to work for the platform on which the code is executing. This mostly matters for Windows because of the way that it uses backslash and drive letters, as compared to *nix*. One important feature is that the user can do string manipulations on a file path without having to worry too much about the platform because the path management code will properly handle most mixed cases. So one can for example concatenate a path suffix that uses forward slashes to a Windows path and have it work correctly. The conversion code is in libdispatch/dpathmgr.c, and the important function there is NCpathcvt which does the proper conversions to the local path format. As a rule, most code should just replace their file operations with the corresponding NCxxx ones defined in include/ncpathmgmt.h. These NCxxx functions all call NCpathcvt on their path arguments before executing the actual file operation. In some rare cases, the client may need to directly use NCpathcvt, but this should be avoided as much as possible. If there is a need for supporting a new file operation not already in ncpathmgmt.h, then use the code in dpathmgr.c as a template. Also please notify Unidata so we can include it as a formal part or our supported operations. Also, if you see an operation in the library that is not using the NCxxx form, then please submit an issue so we can fix it. Misc. Changes: * Clean up the utf8 testing code; it is impossible to get some tests to work under windows using shell scripts; the args do not pass as utf8 but as some other encoding. * Added an extra utf8 test case: test_unicode_path.sh * Add a true test for HDF5 1.10.6 or later because as noted in PR https://github.com/Unidata/netcdf-c/pull/1794, HDF5 changed its Windows file path handling.
141 lines
4.3 KiB
Makefile
141 lines
4.3 KiB
Makefile
## This is a automake file, part of Unidata's netCDF package.
|
|
# Copyright 2018, see the COPYRIGHT file for more information.
|
|
|
|
# This file builds and runs the nc_test program, which tests the
|
|
# netCDF-3 API for all formats.
|
|
|
|
# Ed Hartnett, Dennis Heimbigner, Ward Fisher
|
|
|
|
# Un comment to use a more verbose test driver
|
|
#SH_LOG_DRIVER = $(SHELL) $(top_srcdir)/test-driver-verbose
|
|
#sh_LOG_DRIVER = $(SHELL) $(top_srcdir)/test-driver-verbose
|
|
#LOG_DRIVER = $(SHELL) $(top_srcdir)/test-driver-verbose
|
|
#TESTS_ENVIRONMENT = export SETX=1;
|
|
|
|
# Put together AM_CPPFLAGS and AM_LDFLAGS.
|
|
include $(top_srcdir)/lib_flags.am
|
|
AM_CPPFLAGS += -I$(top_srcdir)/libsrc
|
|
AM_CPPFLAGS += -DTOPSRCDIR=${abs_top_srcdir}
|
|
AM_CPPFLAGS += -DTOPBINDIR=${abs_top_bindir}
|
|
LDADD = ${top_builddir}/liblib/libnetcdf.la
|
|
AM_CPPFLAGS += -I$(top_builddir)/liblib -I$(top_builddir)/include -I$(top_srcdir)/libsrc
|
|
|
|
TEST_EXTENSIONS = .sh
|
|
|
|
check_PROGRAMS =
|
|
|
|
# These are the tests which are always run.
|
|
TESTPROGRAMS = t_nc tst_small nc_test tst_misc tst_norm tst_names \
|
|
tst_nofill tst_nofill2 tst_nofill3 tst_atts3 tst_meta tst_inq_type \
|
|
tst_utf8_validate tst_utf8_phrases tst_global_fillval \
|
|
tst_max_var_dims tst_formats tst_def_var_fill tst_err_enddef \
|
|
tst_default_format
|
|
|
|
if USE_PNETCDF
|
|
check_PROGRAMS += tst_parallel2 tst_pnetcdf tst_addvar
|
|
TESTPROGRAMS += tst_formatx_pnetcdf tst_default_format_pnetcdf
|
|
endif
|
|
|
|
if TEST_PARALLEL4
|
|
if USE_PNETCDF
|
|
if ENABLE_CDF5
|
|
TESTPROGRAMS += tst_cdf5format
|
|
endif
|
|
endif
|
|
endif
|
|
|
|
# These are the source files for the main workhorse test program,
|
|
# nc_test. If you pass nc_test, you are doing well.
|
|
nc_test_SOURCES = nc_test.c error.c test_get.c test_put.c test_read.c \
|
|
test_write.c util.c error.h tests.h
|
|
|
|
# If the user asked for large file tests, then add them.
|
|
if LARGE_FILE_TESTS
|
|
TESTPROGRAMS += quick_large_files tst_big_var6 tst_big_var2 \
|
|
tst_big_rvar tst_big_var tst_large large_files
|
|
endif # LARGE_FILE_TESTS
|
|
|
|
if BUILD_BENCHMARKS
|
|
TESTPROGRAMS += testnc3perf
|
|
endif
|
|
|
|
if USE_HDF5
|
|
TESTPROGRAMS += tst_diskless6
|
|
endif
|
|
|
|
# Set up the tests.
|
|
check_PROGRAMS += $(TESTPROGRAMS)
|
|
|
|
# Build Diskless test helpers
|
|
check_PROGRAMS += tst_diskless tst_diskless3 tst_diskless4 \
|
|
tst_diskless5 tst_inmemory tst_open_mem
|
|
if USE_HDF5
|
|
check_PROGRAMS += tst_diskless2
|
|
endif
|
|
|
|
TESTS = $(TESTPROGRAMS)
|
|
|
|
if ENABLE_BYTERANGE
|
|
if BUILD_UTILITIES
|
|
tst_byterange_SOURCES = tst_byterange.c
|
|
check_PROGRAMS += tst_byterange
|
|
TESTS += test_byterange.sh
|
|
endif
|
|
endif
|
|
|
|
if BUILD_UTILITIES
|
|
TESTS += run_diskless.sh run_diskless5.sh run_inmemory.sh
|
|
if LARGE_FILE_TESTS
|
|
TESTS += run_diskless2.sh
|
|
endif
|
|
if BUILD_MMAP
|
|
TESTS += run_mmap.sh
|
|
run_mmap.log: run_diskless.log
|
|
endif
|
|
endif
|
|
|
|
if USE_PNETCDF
|
|
TESTS += run_pnetcdf_test.sh
|
|
endif
|
|
|
|
# The .c files that are generated with m4 are already distributed, but
|
|
# we also include the original m4 files, plus test scripts data.
|
|
EXTRA_DIST = test_get.m4 test_put.m4 run_diskless.sh run_diskless2.sh \
|
|
run_diskless5.sh run_mmap.sh run_pnetcdf_test.sh test_read.m4 \
|
|
test_write.m4 ref_tst_diskless2.cdl tst_diskless5.cdl \
|
|
ref_tst_diskless3_create.cdl ref_tst_diskless3_open.cdl \
|
|
run_inmemory.sh run_mmap.sh \
|
|
f03tst_open_mem.nc \
|
|
test_byterange.sh ref_tst_http_nc3.cdl \
|
|
ref_tst_http_nc4a.cdl ref_tst_http_nc4b.cdl ref_tst_http_nc4c.cdl \
|
|
CMakeLists.txt
|
|
|
|
# These files are created by the tests.
|
|
CLEANFILES = nc_test_*.nc tst_*.nc t_nc.nc large_files.nc \
|
|
quick_large_files.nc tst_diskless3_file.cdl \
|
|
tst_diskless4.cdl ref_tst_diskless4.cdl benchmark.nc \
|
|
tst_http_nc3.cdl tst_http_nc4?.cdl tmp*.cdl tmp*.nc
|
|
|
|
EXTRA_DIST += bad_cdf5_begin.nc run_cdf5.sh
|
|
if ENABLE_CDF5
|
|
# bad_cdf5_begin.nc is a corrupted CDF-5 file with bad variable starting
|
|
# file offsets. It is to be used by tst_open_cdf5.c to check if it can
|
|
# detect and report error code NC_ENOTNC.
|
|
TESTS += run_cdf5.sh
|
|
check_PROGRAMS += tst_open_cdf5
|
|
if LARGE_FILE_TESTS
|
|
TESTPROGRAMS += tst_large_cdf5 tst_cdf5_begin
|
|
endif
|
|
endif
|
|
|
|
# Only clean these on maintainer-clean, because they require m4 to
|
|
# regenerate.
|
|
MAINTAINERCLEANFILES = test_get.c test_put.c
|
|
|
|
# This rule tells make how to turn our .m4 files into .c files.
|
|
.m4.c:
|
|
m4 $(AM_M4FLAGS) $(M4FLAGS) $< >$@
|
|
|
|
# If valgrind is present, add valgrind targets.
|
|
@VALGRIND_CHECK_RULES@
|