[hdf5] 10/12: Imported Upstream version 1.10.0~pre2+docs
Gilles Filippini
pini at debian.org
Tue Mar 29 18:40:02 UTC 2016
This is an automated email from the git hooks/post-receive script.
pini pushed a commit to branch master-1.10
in repository hdf5.
commit 5c59b10eb7a83675420166385bc0edfc5228a4d9
Author: Gilles Filippini <pini at debian.org>
Date: Tue Mar 29 00:17:02 2016 +0200
Imported Upstream version 1.10.0~pre2+docs
---
ACKNOWLEDGMENTS | 3 +-
README.txt | 2 +-
autogen.sh | 8 +-
bin/h5vers | 18 +-
c++/src/Makefile.am | 2 +-
c++/src/Makefile.in | 23 +-
c++/src/cpp_doc_config | 2 +-
config/lt_vers.am | 30 +-
configure | 61 +-
configure.ac | 38 +-
fortran/src/Makefile.am | 2 +-
fortran/src/Makefile.in | 23 +-
hl/c++/src/Makefile.am | 2 +-
hl/c++/src/Makefile.in | 23 +-
hl/fortran/src/Makefile.am | 2 +-
hl/fortran/src/Makefile.in | 23 +-
hl/src/Makefile.am | 2 +-
hl/src/Makefile.in | 23 +-
html/ADGuide/Changes.html | 1373 +++++++++++++--
html/ADGuide/Changes_1_8_x.html | 271 ++-
html/HL/RM_H5PT_c++.html | 2702 +++++++++++++++++++++++++-----
html/RM/H5L/H5Literate_by_name.htm | 4 +-
java/examples/datasets/Makefile.am | 4 +-
java/examples/datasets/Makefile.in | 4 +-
java/examples/datasets/runExample.sh.in | 20 +-
java/examples/datatypes/Makefile.am | 4 +-
java/examples/datatypes/Makefile.in | 4 +-
java/examples/datatypes/runExample.sh.in | 20 +-
java/examples/groups/Makefile.am | 4 +-
java/examples/groups/Makefile.in | 4 +-
java/examples/groups/runExample.sh.in | 26 +-
java/examples/intro/Makefile.am | 4 +-
java/examples/intro/Makefile.in | 4 +-
java/examples/intro/runExample.sh.in | 20 +-
java/src/Makefile.am | 4 +-
java/src/Makefile.in | 4 +-
java/src/jni/Makefile.am | 2 +-
java/src/jni/Makefile.in | 23 +-
java/test/Makefile.am | 4 +-
java/test/Makefile.in | 4 +-
java/test/junit.sh.in | 12 +-
release_docs/INSTALL | 300 +++-
release_docs/RELEASE.txt | 561 ++++---
src/CMakeLists.txt | 1 -
src/H5Oprivate.h | 5 -
src/H5P.c | 2 +-
src/H5private.h | 17 +-
src/H5public.h | 4 +-
src/H5system.c | 4 +-
src/H5timer.c | 2 +-
src/H5win32defs.h | 4 +-
src/Makefile.in | 21 +
src/libhdf5.settings.in | 5 +-
tools/perform/sio_standalone.h | 12 +-
54 files changed, 4719 insertions(+), 1027 deletions(-)
diff --git a/ACKNOWLEDGMENTS b/ACKNOWLEDGMENTS
index eadbf08..59882ca 100644
--- a/ACKNOWLEDGMENTS
+++ b/ACKNOWLEDGMENTS
@@ -2,7 +2,7 @@ Acknowledgments
----------------
We would like to thank the following people who provided code contributions
-to the HDF5 1.10.0 and eralier eleases:
+to the HDF5 1.10.0 and earlier releases:
Steffen Kieß, for contributing code used to specify locations of the external
files included in the 1.10.0 release.
@@ -16,7 +16,6 @@ Threading library included in the 1.8.6 release.
John A. Biddiscombe, Mike Jackson, and Sean McBride for contributing and
testing CMake code included in the HDF5 1.8.5 distribution.
-
The HDF5 community for helping shape the development of HDF5 by contributing
bug reports and patches, joining in on forum discussions, and continually
supporting our software.
diff --git a/README.txt b/README.txt
index b98b49d..2f11a59 100644
--- a/README.txt
+++ b/README.txt
@@ -1,4 +1,4 @@
-HDF5 version 1.10.0-pre1 released on 2016-03-17
+HDF5 version 1.10.0-pre2 released on 2016-03-22
Please refer to the release_docs/INSTALL file for installation instructions.
------------------------------------------------------------------------------
diff --git a/autogen.sh b/autogen.sh
index 3c0ad7b..f3bd774 100755
--- a/autogen.sh
+++ b/autogen.sh
@@ -1,4 +1,4 @@
-#! /bin/bash
+#!/bin/sh
#
# Copyright by The HDF Group.
# All rights reserved.
@@ -110,8 +110,10 @@ while getopts "$optspec" optchar; do
verbose=true
;;
*)
- if [ "$OPTERR" != 1 ] || [ "${optspec:0:1}" = ":" ]; then
- echo "Non-option argument: '-${OPTARG}'" >&2
+ if [ "$OPTERR" != 1 ] || case $optspec in :*) ;; *) false; esac; then
+ echo "ERROR: non-option argument: '-${OPTARG}'" >&2
+ echo "Quitting"
+ exit 1
fi
;;
esac
diff --git a/bin/h5vers b/bin/h5vers
index 7e61dc8..e9df387 100755
--- a/bin/h5vers
+++ b/bin/h5vers
@@ -277,13 +277,17 @@ if ($LT_VERS && $version_increased) {
local($_) = $contentsy;
- my ($lt_revision) = /^LT_VERS_REVISION\s*=\s*(\d+)/m;
- my $new_lt_revision = $lt_revision+1;
- ($contentsy) =~ s/^(LT_VERS_REVISION\s*=\s*)\d+/$1$new_lt_revision/m;
-
- open FILE, ">$LT_VERS" or die "$LT_VERS: $!\n";
- print FILE $contentsy;
- close FILE;
+# As of the HDF5 v1.8.16 release, h5vers should not increment
+# the LT_VERS numbers, so the next 6 lines are commented out.
+# A future version may copy the numbers to H5public.h, so this
+# section is retained for future reference.
+# my ($lt_revision) = /^LT_VERS_REVISION\s*=\s*(\d+)/m;
+# my $new_lt_revision = $lt_revision+1;
+# ($contentsy) =~ s/^(LT_VERS_REVISION\s*=\s*)\d+/$1$new_lt_revision/m;
+
+# open FILE, ">$LT_VERS" or die "$LT_VERS: $!\n";
+# print FILE $contentsy;
+# close FILE;
}
# Update the README.txt file
diff --git a/c++/src/Makefile.am b/c++/src/Makefile.am
index 84af348..6cd4768 100644
--- a/c++/src/Makefile.am
+++ b/c++/src/Makefile.am
@@ -28,7 +28,7 @@ AM_CPPFLAGS+=-I$(top_srcdir)/src
lib_LTLIBRARIES=libhdf5_cpp.la
# Add libtool numbers to the HDF5 C++ library (from config/lt_vers.am)
-libhdf5_cpp_la_LDFLAGS= -version-info $(LT_VERS_INTERFACE):$(LT_VERS_REVISION):$(LT_VERS_AGE) $(AM_LDFLAGS)
+libhdf5_cpp_la_LDFLAGS= -version-info $(LT_CXX_VERS_INTERFACE):$(LT_CXX_VERS_REVISION):$(LT_CXX_VERS_AGE) $(AM_LDFLAGS)
bin_SCRIPTS=h5c++
diff --git a/c++/src/Makefile.in b/c++/src/Makefile.in
index 44780c1..4479889 100644
--- a/c++/src/Makefile.in
+++ b/c++/src/Makefile.in
@@ -748,12 +748,33 @@ CHECK_CLEANFILES = *.chkexe *.chklog *.clog *.clog2
LT_VERS_INTERFACE = 100
LT_VERS_REVISION = 0
LT_VERS_AGE = 0
+LT_CXX_VERS_INTERFACE = 100
+LT_CXX_VERS_REVISION = 0
+LT_CXX_VERS_AGE = 0
+LT_F_VERS_INTERFACE = 100
+LT_F_VERS_REVISION = 0
+LT_F_VERS_AGE = 0
+LT_HL_VERS_INTERFACE = 100
+LT_HL_VERS_REVISION = 0
+LT_HL_VERS_AGE = 0
+LT_HL_CXX_VERS_INTERFACE = 100
+LT_HL_CXX_VERS_REVISION = 0
+LT_HL_CXX_VERS_AGE = 0
+LT_HL_F_VERS_INTERFACE = 100
+LT_HL_F_VERS_REVISION = 0
+LT_HL_F_VERS_AGE = 0
+LT_JAVA_VERS_INTERFACE = 100
+LT_JAVA_VERS_REVISION = 0
+LT_JAVA_VERS_AGE = 0
+LT_TOOLS_VERS_INTERFACE = 100
+LT_TOOLS_VERS_REVISION = 0
+LT_TOOLS_VERS_AGE = 0
# This is our main target
lib_LTLIBRARIES = libhdf5_cpp.la
# Add libtool numbers to the HDF5 C++ library (from config/lt_vers.am)
-libhdf5_cpp_la_LDFLAGS = -version-info $(LT_VERS_INTERFACE):$(LT_VERS_REVISION):$(LT_VERS_AGE) $(AM_LDFLAGS)
+libhdf5_cpp_la_LDFLAGS = -version-info $(LT_CXX_VERS_INTERFACE):$(LT_CXX_VERS_REVISION):$(LT_CXX_VERS_AGE) $(AM_LDFLAGS)
bin_SCRIPTS = h5c++
# Source files for the library
diff --git a/c++/src/cpp_doc_config b/c++/src/cpp_doc_config
index ac68662..dfedd0a 100644
--- a/c++/src/cpp_doc_config
+++ b/c++/src/cpp_doc_config
@@ -38,7 +38,7 @@ PROJECT_NAME = "HDF5 C++ API"
# could be handy for archiving the generated documentation or if some version
# control system is used.
-PROJECT_NUMBER = "1.10.0-pre1 currently under development"
+PROJECT_NUMBER = "1.10.0-pre2 currently under development"
# Using the PROJECT_BRIEF tag one can provide an optional one line description
# for a project that appears at the top of each page and should give viewer a
diff --git a/config/lt_vers.am b/config/lt_vers.am
index 113c168..c6a5c03 100644
--- a/config/lt_vers.am
+++ b/config/lt_vers.am
@@ -40,10 +40,34 @@ LT_VERS_AGE = 0
## Note that this versioning system doesn't attempt to handle
## the effects of the H5_V1_x_COMPAT flag.
##
-## Since the revision number is automatically incremented by
-## bin/h5vers, don't move LT_VERS_REVISION from the fourth line
-## without also editing the script!
+## Version numbers for wrapper shared library files.
+LT_CXX_VERS_INTERFACE = 100
+LT_CXX_VERS_REVISION = 0
+LT_CXX_VERS_AGE = 0
+LT_F_VERS_INTERFACE = 100
+LT_F_VERS_REVISION = 0
+LT_F_VERS_AGE = 0
+
+LT_HL_VERS_INTERFACE = 100
+LT_HL_VERS_REVISION = 0
+LT_HL_VERS_AGE = 0
+
+LT_HL_CXX_VERS_INTERFACE = 100
+LT_HL_CXX_VERS_REVISION = 0
+LT_HL_CXX_VERS_AGE = 0
+
+LT_HL_F_VERS_INTERFACE = 100
+LT_HL_F_VERS_REVISION = 0
+LT_HL_F_VERS_AGE = 0
+
+LT_JAVA_VERS_INTERFACE = 100
+LT_JAVA_VERS_REVISION = 0
+LT_JAVA_VERS_AGE = 0
+
+LT_TOOLS_VERS_INTERFACE = 100
+LT_TOOLS_VERS_REVISION = 0
+LT_TOOLS_VERS_AGE = 0
# Copyright by The HDF Group.
# Copyright by the Board of Trustees of the University of Illinois.
diff --git a/configure b/configure
index 601d807..9e2effd 100755
--- a/configure
+++ b/configure
@@ -1,7 +1,7 @@
#! /bin/sh
# From configure.ac Id: configure.ac 22697 2012-08-19 14:35:47Z hdftest .
# Guess values for system-dependent variables and create Makefiles.
-# Generated by GNU Autoconf 2.69 for HDF5 1.10.0-pre1.
+# Generated by GNU Autoconf 2.69 for HDF5 1.10.0-pre2.
#
# Report bugs to <help at hdfgroup.org>.
#
@@ -591,8 +591,8 @@ MAKEFLAGS=
# Identity of this package.
PACKAGE_NAME='HDF5'
PACKAGE_TARNAME='hdf5'
-PACKAGE_VERSION='1.10.0-pre1'
-PACKAGE_STRING='HDF5 1.10.0-pre1'
+PACKAGE_VERSION='1.10.0-pre2'
+PACKAGE_STRING='HDF5 1.10.0-pre2'
PACKAGE_BUGREPORT='help at hdfgroup.org'
PACKAGE_URL=''
@@ -1522,7 +1522,7 @@ if test "$ac_init_help" = "long"; then
# Omit some internal or obsolete options to make the list less imposing.
# This message is too long to be a string in the A/UX 3.1 sh.
cat <<_ACEOF
-\`configure' configures HDF5 1.10.0-pre1 to adapt to many kinds of systems.
+\`configure' configures HDF5 1.10.0-pre2 to adapt to many kinds of systems.
Usage: $0 [OPTION]... [VAR=VALUE]...
@@ -1592,7 +1592,7 @@ fi
if test -n "$ac_init_help"; then
case $ac_init_help in
- short | recursive ) echo "Configuration of HDF5 1.10.0-pre1:";;
+ short | recursive ) echo "Configuration of HDF5 1.10.0-pre2:";;
esac
cat <<\_ACEOF
@@ -1613,7 +1613,7 @@ Optional Features:
Clean turns nothing on and disables optimization
(i.e.: a 'clean slate' configuration). All these
settings can be overridden by using specific
- configure flags. [default=debug]
+ configure flags. [default=production]
--enable-dependency-tracking
do not reject slow dependency extractors
--disable-dependency-tracking
@@ -1844,7 +1844,7 @@ fi
test -n "$ac_init_help" && exit $ac_status
if $ac_init_version; then
cat <<\_ACEOF
-HDF5 configure 1.10.0-pre1
+HDF5 configure 1.10.0-pre2
generated by GNU Autoconf 2.69
Copyright (C) 2012 Free Software Foundation, Inc.
@@ -2759,7 +2759,7 @@ cat >config.log <<_ACEOF
This file contains any messages produced by compilers while
running configure, to aid debugging if configure makes a mistake.
-It was created by HDF5 $as_me 1.10.0-pre1, which was
+It was created by HDF5 $as_me 1.10.0-pre2, which was
generated by GNU Autoconf 2.69. Invocation command line was
$ $0 $@
@@ -3631,7 +3631,7 @@ fi
# Define the identity of the package.
PACKAGE='hdf5'
- VERSION='1.10.0-pre1'
+ VERSION='1.10.0-pre2'
cat >>confdefs.h <<_ACEOF
@@ -4122,7 +4122,7 @@ fi
## Set the default
## Depends on branch, set via script at branch creation time
if test "X-$BUILD_MODE" = X- ; then
- BUILD_MODE=debug
+ BUILD_MODE=production
fi
## Allow this variable to be substituted in
@@ -9610,10 +9610,10 @@ esac
## Check if they would like the Java native interface (JNI) compiled
##
-## This needs to be exposed for the library info file even if JAVA is disabled.
+## This needs to be exposed for the library info file even if Java is disabled.
-## Default is no JAVA
+## Default is no Java
HDF_JAVA=no
H5_CLASSPATH=""
@@ -27754,7 +27754,7 @@ if test "${enable_threadsafe+set}" = set; then :
fi
-## The high-level, C++, and Fortran interfaces are not compatible
+## The high-level, C++, Fortran and Java interfaces are not compatible
## with the thread-safety option because the lock is not hoisted
## into the higher-level API calls.
@@ -27786,6 +27786,14 @@ if test "X${ALLOW_UNSUPPORTED}" != "Xyes"; then
fi
fi
+## --enable-threadsafe is also incompatible with --enable-java unless
+## --enable-unsupported has been specified on the configure line.
+if test "X${ALLOW_UNSUPPORTED}" != "Xyes"; then
+ if test "X${HDF_JAVA}" = "Xyes" -a "X${enable_threadsafe}" = "Xyes"; then
+ as_fn_error $? "--enable-java and --enable-threadsafe flags are incompatible. Use --enable-unsupported to override this error." "$LINENO" 5
+ fi
+fi
+
case "X-$THREADSAFE" in
X-|X-no)
@@ -29544,6 +29552,15 @@ if test "X${ALLOW_UNSUPPORTED}" != "Xyes"; then
fi
fi
+## The --enable-parallel flag is not compatible with --enable-java.
+## If the user tried to specify both flags, throw an error, unless
+## they also provided the --enable-unsupported flag.
+if test "X${ALLOW_UNSUPPORTED}" != "Xyes"; then
+ if test "X${HDF_JAVA}" = "Xyes" -a "X${enable_parallel}" = "Xyes"; then
+ as_fn_error $? "--enable-java and --enable-parallel flags are incompatible. Use --enable-unsupported to override this error." "$LINENO" 5
+ fi
+fi
+
## --enable-parallel is also incompatible with --enable-threadsafe, unless
## --enable-unsupported has been specified on the configure line.
if test "X${ALLOW_UNSUPPORTED}" != "Xyes"; then
@@ -30812,7 +30829,7 @@ fi
java_version_info=`$JAVA -version 2>&1 |\
grep 'version' | sed -e 's/version "//' | sed -e 's/"//'`
if test -n "$java_version_info"; then
- JAVA_VERSION="$JAVA_VERSION ( $java_version_info)"
+ JAVA_VERSION="$JAVA_VERSION ($java_version_info)"
fi
## ----------------------------------------------------------------------
@@ -31586,7 +31603,7 @@ Usage: $0 [OPTIONS]
Report bugs to <bug-libtool at gnu.org>."
lt_cl_version="\
-HDF5 config.lt 1.10.0-pre1
+HDF5 config.lt 1.10.0-pre2
configured by $0, generated by GNU Autoconf 2.69.
Copyright (C) 2011 Free Software Foundation, Inc.
@@ -33027,6 +33044,9 @@ fi
ac_config_files="$ac_config_files src/libhdf5.settings Makefile src/Makefile test/Makefile test/testcheck_version.sh test/testerror.sh test/testflushrefresh.sh test/H5srcdir_str.h test/testlibinfo.sh test/testlinks_env.sh test/testswmr.sh test/test_plugin.sh test/test_usecases.sh test/testvdsswmr.sh testpar/Makefile tools/Makefile tools/h5dump/Makefile tools/h5dump/testh5dump.sh tools/h5dump/testh5dumppbits.sh tools/h5dump/testh5dumpvds.sh tools/h5dump/testh5dumpxml.sh tools/h5ls/testh5l [...]
+ac_config_commands="$ac_config_commands .classes"
+
+
cat >confcache <<\_ACEOF
# This file is a shell script that caches the results of configure
# tests run on this system so they can be shared between configure
@@ -33610,7 +33630,7 @@ cat >>$CONFIG_STATUS <<\_ACEOF || ac_write_fail=1
# report actual input values of CONFIG_FILES etc. instead of their
# values after options handling.
ac_log="
-This file was extended by HDF5 $as_me 1.10.0-pre1, which was
+This file was extended by HDF5 $as_me 1.10.0-pre2, which was
generated by GNU Autoconf 2.69. Invocation command line was
CONFIG_FILES = $CONFIG_FILES
@@ -33676,7 +33696,7 @@ _ACEOF
cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1
ac_cs_config="`$as_echo "$ac_configure_args" | sed 's/^ //; s/[\\""\`\$]/\\\\&/g'`"
ac_cs_version="\\
-HDF5 config.status 1.10.0-pre1
+HDF5 config.status 1.10.0-pre2
configured by $0, generated by GNU Autoconf 2.69,
with options \\"\$ac_cs_config\\"
@@ -34264,6 +34284,12 @@ fi
ac_aux_dir='$ac_aux_dir'
+$MKDIR_P java/src/.classes;
+ $MKDIR_P java/test/.classes;
+ $MKDIR_P java/examples/intro/.classes;
+ $MKDIR_P java/examples/datasets/.classes;
+ $MKDIR_P java/examples/datatypes/.classes;
+ $MKDIR_P java/examples/groups/.classes
_ACEOF
@@ -34381,6 +34407,7 @@ do
"hl/fortran/test/Makefile") CONFIG_FILES="$CONFIG_FILES hl/fortran/test/Makefile" ;;
"hl/fortran/examples/Makefile") CONFIG_FILES="$CONFIG_FILES hl/fortran/examples/Makefile" ;;
"hl/fortran/examples/run-hlfortran-ex.sh") CONFIG_FILES="$CONFIG_FILES hl/fortran/examples/run-hlfortran-ex.sh" ;;
+ ".classes") CONFIG_COMMANDS="$CONFIG_COMMANDS .classes" ;;
*) as_fn_error $? "invalid argument: \`$ac_config_target'" "$LINENO" 5;;
esac
diff --git a/configure.ac b/configure.ac
index 21edef5..ee6e15b 100644
--- a/configure.ac
+++ b/configure.ac
@@ -26,7 +26,7 @@ AC_PREREQ([2.69])
## NOTE: Do not forget to change the version number here when we do a
## release!!!
##
-AC_INIT([HDF5], [1.10.0-pre1], [help at hdfgroup.org])
+AC_INIT([HDF5], [1.10.0-pre2], [help at hdfgroup.org])
AC_CONFIG_SRCDIR([src/H5.c])
AC_CONFIG_HEADERS([src/H5config.h])
@@ -301,14 +301,14 @@ AC_ARG_ENABLE([build-mode],
(i.e.: a 'clean slate' configuration).
All these settings can be overridden by using
specific configure flags.
- [default=debug]
+ [default=production]
])],
[BUILD_MODE=$enableval])
## Set the default
## Depends on branch, set via script at branch creation time
if test "X-$BUILD_MODE" = X- ; then
- BUILD_MODE=debug
+ BUILD_MODE=production
fi
## Allow this variable to be substituted in
@@ -858,10 +858,10 @@ esac
## Check if they would like the Java native interface (JNI) compiled
##
-## This needs to be exposed for the library info file even if JAVA is disabled.
+## This needs to be exposed for the library info file even if Java is disabled.
AC_SUBST([HDF_JAVA])
-## Default is no JAVA
+## Default is no Java
HDF_JAVA=no
AC_SUBST([H5_CLASSPATH]) H5_CLASSPATH=""
@@ -1578,7 +1578,7 @@ AC_ARG_ENABLE([threadsafe],
[default=no]])],
[THREADSAFE=$enableval])
-## The high-level, C++, and Fortran interfaces are not compatible
+## The high-level, C++, Fortran and Java interfaces are not compatible
## with the thread-safety option because the lock is not hoisted
## into the higher-level API calls.
@@ -1610,6 +1610,14 @@ if test "X${ALLOW_UNSUPPORTED}" != "Xyes"; then
fi
fi
+## --enable-threadsafe is also incompatible with --enable-java unless
+## --enable-unsupported has been specified on the configure line.
+if test "X${ALLOW_UNSUPPORTED}" != "Xyes"; then
+ if test "X${HDF_JAVA}" = "Xyes" -a "X${enable_threadsafe}" = "Xyes"; then
+ AC_MSG_ERROR([--enable-java and --enable-threadsafe flags are incompatible. Use --enable-unsupported to override this error.])
+ fi
+fi
+
case "X-$THREADSAFE" in
X-|X-no)
@@ -2432,6 +2440,15 @@ if test "X${ALLOW_UNSUPPORTED}" != "Xyes"; then
fi
fi
+## The --enable-parallel flag is not compatible with --enable-java.
+## If the user tried to specify both flags, throw an error, unless
+## they also provided the --enable-unsupported flag.
+if test "X${ALLOW_UNSUPPORTED}" != "Xyes"; then
+ if test "X${HDF_JAVA}" = "Xyes" -a "X${enable_parallel}" = "Xyes"; then
+ AC_MSG_ERROR([--enable-java and --enable-parallel flags are incompatible. Use --enable-unsupported to override this error.])
+ fi
+fi
+
## --enable-parallel is also incompatible with --enable-threadsafe, unless
## --enable-unsupported has been specified on the configure line.
if test "X${ALLOW_UNSUPPORTED}" != "Xyes"; then
@@ -3177,7 +3194,7 @@ fi
java_version_info=`$JAVA -version 2>&1 |\
grep 'version' | sed -e 's/version "//' | sed -e 's/"//'`
if test -n "$java_version_info"; then
- JAVA_VERSION="$JAVA_VERSION ( $java_version_info)"
+ JAVA_VERSION="$JAVA_VERSION ($java_version_info)"
fi
## ----------------------------------------------------------------------
@@ -3594,6 +3611,13 @@ AC_CONFIG_FILES([src/libhdf5.settings
hl/fortran/examples/Makefile
hl/fortran/examples/run-hlfortran-ex.sh])
+AC_CONFIG_COMMANDS([.classes], [], [$MKDIR_P java/src/.classes;
+ $MKDIR_P java/test/.classes;
+ $MKDIR_P java/examples/intro/.classes;
+ $MKDIR_P java/examples/datasets/.classes;
+ $MKDIR_P java/examples/datatypes/.classes;
+ $MKDIR_P java/examples/groups/.classes])
+
AC_OUTPUT
chmod 755 tools/misc/h5cc
diff --git a/fortran/src/Makefile.am b/fortran/src/Makefile.am
index f4d192b..a271666 100644
--- a/fortran/src/Makefile.am
+++ b/fortran/src/Makefile.am
@@ -32,7 +32,7 @@ AM_FCLIBS=$(LIBHDF5)
lib_LTLIBRARIES=libhdf5_fortran.la
# Add libtool numbers to the HDF5 Fortran library (from config/lt_vers.am)
-libhdf5_fortran_la_LDFLAGS= -version-info $(LT_VERS_INTERFACE):$(LT_VERS_REVISION):$(LT_VERS_AGE) $(AM_LDFLAGS)
+libhdf5_fortran_la_LDFLAGS= -version-info $(LT_F_VERS_INTERFACE):$(LT_F_VERS_REVISION):$(LT_F_VERS_AGE) $(AM_LDFLAGS)
# Some Fortran compilers can't build shared libraries, so sometimes we
# want to build a shared C library and a static Fortran library. If so,
diff --git a/fortran/src/Makefile.in b/fortran/src/Makefile.in
index 6d973d0..a4d2f9d 100644
--- a/fortran/src/Makefile.in
+++ b/fortran/src/Makefile.in
@@ -776,13 +776,34 @@ CHECK_CLEANFILES = *.chkexe *.chklog *.clog *.clog2
LT_VERS_INTERFACE = 100
LT_VERS_REVISION = 0
LT_VERS_AGE = 0
+LT_CXX_VERS_INTERFACE = 100
+LT_CXX_VERS_REVISION = 0
+LT_CXX_VERS_AGE = 0
+LT_F_VERS_INTERFACE = 100
+LT_F_VERS_REVISION = 0
+LT_F_VERS_AGE = 0
+LT_HL_VERS_INTERFACE = 100
+LT_HL_VERS_REVISION = 0
+LT_HL_VERS_AGE = 0
+LT_HL_CXX_VERS_INTERFACE = 100
+LT_HL_CXX_VERS_REVISION = 0
+LT_HL_CXX_VERS_AGE = 0
+LT_HL_F_VERS_INTERFACE = 100
+LT_HL_F_VERS_REVISION = 0
+LT_HL_F_VERS_AGE = 0
+LT_JAVA_VERS_INTERFACE = 100
+LT_JAVA_VERS_REVISION = 0
+LT_JAVA_VERS_AGE = 0
+LT_TOOLS_VERS_INTERFACE = 100
+LT_TOOLS_VERS_REVISION = 0
+LT_TOOLS_VERS_AGE = 0
AM_FCLIBS = $(LIBHDF5)
# This is our main target, the fortran library
lib_LTLIBRARIES = libhdf5_fortran.la
# Add libtool numbers to the HDF5 Fortran library (from config/lt_vers.am)
-libhdf5_fortran_la_LDFLAGS = -version-info $(LT_VERS_INTERFACE):$(LT_VERS_REVISION):$(LT_VERS_AGE) $(AM_LDFLAGS)
+libhdf5_fortran_la_LDFLAGS = -version-info $(LT_F_VERS_INTERFACE):$(LT_F_VERS_REVISION):$(LT_F_VERS_AGE) $(AM_LDFLAGS)
# Source files for the library.
libhdf5_fortran_la_SOURCES = H5f90global.F90 \
diff --git a/hl/c++/src/Makefile.am b/hl/c++/src/Makefile.am
index b268948..c78f5fa 100644
--- a/hl/c++/src/Makefile.am
+++ b/hl/c++/src/Makefile.am
@@ -28,7 +28,7 @@ AM_CPPFLAGS+=-I$(top_srcdir)/src -I$(top_srcdir)/hl/src
lib_LTLIBRARIES=libhdf5_hl_cpp.la
# Add libtool numbers to the HDF5 HL C++ library (from config/lt_vers.am)
-libhdf5_hl_cpp_la_LDFLAGS= -version-info $(LT_VERS_INTERFACE):$(LT_VERS_REVISION):$(LT_VERS_AGE) $(AM_LDFLAGS)
+libhdf5_hl_cpp_la_LDFLAGS= -version-info $(LT_HL_CXX_VERS_INTERFACE):$(LT_HL_CXX_VERS_REVISION):$(LT_HL_CXX_VERS_AGE) $(AM_LDFLAGS)
# Source files for the library
# At the moment, only the H5PT Packet Table has a C++ API.
diff --git a/hl/c++/src/Makefile.in b/hl/c++/src/Makefile.in
index b37a8cf..90694e2 100644
--- a/hl/c++/src/Makefile.in
+++ b/hl/c++/src/Makefile.in
@@ -738,12 +738,33 @@ CHECK_CLEANFILES = *.chkexe *.chklog *.clog *.clog2
LT_VERS_INTERFACE = 100
LT_VERS_REVISION = 0
LT_VERS_AGE = 0
+LT_CXX_VERS_INTERFACE = 100
+LT_CXX_VERS_REVISION = 0
+LT_CXX_VERS_AGE = 0
+LT_F_VERS_INTERFACE = 100
+LT_F_VERS_REVISION = 0
+LT_F_VERS_AGE = 0
+LT_HL_VERS_INTERFACE = 100
+LT_HL_VERS_REVISION = 0
+LT_HL_VERS_AGE = 0
+LT_HL_CXX_VERS_INTERFACE = 100
+LT_HL_CXX_VERS_REVISION = 0
+LT_HL_CXX_VERS_AGE = 0
+LT_HL_F_VERS_INTERFACE = 100
+LT_HL_F_VERS_REVISION = 0
+LT_HL_F_VERS_AGE = 0
+LT_JAVA_VERS_INTERFACE = 100
+LT_JAVA_VERS_REVISION = 0
+LT_JAVA_VERS_AGE = 0
+LT_TOOLS_VERS_INTERFACE = 100
+LT_TOOLS_VERS_REVISION = 0
+LT_TOOLS_VERS_AGE = 0
# This is our main target
lib_LTLIBRARIES = libhdf5_hl_cpp.la
# Add libtool numbers to the HDF5 HL C++ library (from config/lt_vers.am)
-libhdf5_hl_cpp_la_LDFLAGS = -version-info $(LT_VERS_INTERFACE):$(LT_VERS_REVISION):$(LT_VERS_AGE) $(AM_LDFLAGS)
+libhdf5_hl_cpp_la_LDFLAGS = -version-info $(LT_HL_CXX_VERS_INTERFACE):$(LT_HL_CXX_VERS_REVISION):$(LT_HL_CXX_VERS_AGE) $(AM_LDFLAGS)
# Source files for the library
# At the moment, only the H5PT Packet Table has a C++ API.
diff --git a/hl/fortran/src/Makefile.am b/hl/fortran/src/Makefile.am
index d190ed1..571ca45 100644
--- a/hl/fortran/src/Makefile.am
+++ b/hl/fortran/src/Makefile.am
@@ -30,7 +30,7 @@ AM_FCFLAGS+=-I$(top_builddir)/fortran/src $(F9XMODFLAG)$(top_builddir)/fortran/s
lib_LTLIBRARIES=libhdf5hl_fortran.la
# Add libtool numbers to the HDF5 HL Fortran library (from config/lt_vers.am)
-libhdf5hl_fortran_la_LDFLAGS= -version-info $(LT_VERS_INTERFACE):$(LT_VERS_REVISION):$(LT_VERS_AGE) $(AM_LDFLAGS)
+libhdf5hl_fortran_la_LDFLAGS= -version-info $(LT_HL_F_VERS_INTERFACE):$(LT_HL_F_VERS_REVISION):$(LT_HL_F_VERS_AGE) $(AM_LDFLAGS)
# Some Fortran compilers can't build shared libraries, so sometimes we
# want to build a shared C library and a static Fortran library. If so,
diff --git a/hl/fortran/src/Makefile.in b/hl/fortran/src/Makefile.in
index 90c8c17..f1f9555 100644
--- a/hl/fortran/src/Makefile.in
+++ b/hl/fortran/src/Makefile.in
@@ -766,12 +766,33 @@ CHECK_CLEANFILES = *.chkexe *.chklog *.clog *.clog2
LT_VERS_INTERFACE = 100
LT_VERS_REVISION = 0
LT_VERS_AGE = 0
+LT_CXX_VERS_INTERFACE = 100
+LT_CXX_VERS_REVISION = 0
+LT_CXX_VERS_AGE = 0
+LT_F_VERS_INTERFACE = 100
+LT_F_VERS_REVISION = 0
+LT_F_VERS_AGE = 0
+LT_HL_VERS_INTERFACE = 100
+LT_HL_VERS_REVISION = 0
+LT_HL_VERS_AGE = 0
+LT_HL_CXX_VERS_INTERFACE = 100
+LT_HL_CXX_VERS_REVISION = 0
+LT_HL_CXX_VERS_AGE = 0
+LT_HL_F_VERS_INTERFACE = 100
+LT_HL_F_VERS_REVISION = 0
+LT_HL_F_VERS_AGE = 0
+LT_JAVA_VERS_INTERFACE = 100
+LT_JAVA_VERS_REVISION = 0
+LT_JAVA_VERS_AGE = 0
+LT_TOOLS_VERS_INTERFACE = 100
+LT_TOOLS_VERS_REVISION = 0
+LT_TOOLS_VERS_AGE = 0
# Our main target, the high-level fortran library
lib_LTLIBRARIES = libhdf5hl_fortran.la
# Add libtool numbers to the HDF5 HL Fortran library (from config/lt_vers.am)
-libhdf5hl_fortran_la_LDFLAGS = -version-info $(LT_VERS_INTERFACE):$(LT_VERS_REVISION):$(LT_VERS_AGE) $(AM_LDFLAGS)
+libhdf5hl_fortran_la_LDFLAGS = -version-info $(LT_HL_F_VERS_INTERFACE):$(LT_HL_F_VERS_REVISION):$(LT_HL_F_VERS_AGE) $(AM_LDFLAGS)
# Source files for the library
#if BUILD_PARALLEL_CONDITIONAL
diff --git a/hl/src/Makefile.am b/hl/src/Makefile.am
index c1e6810..fef3450 100644
--- a/hl/src/Makefile.am
+++ b/hl/src/Makefile.am
@@ -28,7 +28,7 @@ AM_CPPFLAGS+=-I$(top_srcdir)/src
lib_LTLIBRARIES=libhdf5_hl.la
# Add libtool numbers to the HDF5 hl library (from config/lt_vers.am)
-libhdf5_hl_la_LDFLAGS= -version-info $(LT_VERS_INTERFACE):$(LT_VERS_REVISION):$(LT_VERS_AGE) $(AM_LDFLAGS)
+libhdf5_hl_la_LDFLAGS= -version-info $(LT_HL_VERS_INTERFACE):$(LT_HL_VERS_REVISION):$(LT_HL_VERS_AGE) $(AM_LDFLAGS)
# List sources to include in the HDF5 HL Library.
libhdf5_hl_la_SOURCES=H5DO.c H5DS.c H5IM.c H5LT.c H5LTanalyze.c H5LTparse.c H5PT.c H5TB.c H5LD.c
diff --git a/hl/src/Makefile.in b/hl/src/Makefile.in
index 8e59e34..c5d4642 100644
--- a/hl/src/Makefile.in
+++ b/hl/src/Makefile.in
@@ -737,12 +737,33 @@ CHECK_CLEANFILES = *.chkexe *.chklog *.clog *.clog2
LT_VERS_INTERFACE = 100
LT_VERS_REVISION = 0
LT_VERS_AGE = 0
+LT_CXX_VERS_INTERFACE = 100
+LT_CXX_VERS_REVISION = 0
+LT_CXX_VERS_AGE = 0
+LT_F_VERS_INTERFACE = 100
+LT_F_VERS_REVISION = 0
+LT_F_VERS_AGE = 0
+LT_HL_VERS_INTERFACE = 100
+LT_HL_VERS_REVISION = 0
+LT_HL_VERS_AGE = 0
+LT_HL_CXX_VERS_INTERFACE = 100
+LT_HL_CXX_VERS_REVISION = 0
+LT_HL_CXX_VERS_AGE = 0
+LT_HL_F_VERS_INTERFACE = 100
+LT_HL_F_VERS_REVISION = 0
+LT_HL_F_VERS_AGE = 0
+LT_JAVA_VERS_INTERFACE = 100
+LT_JAVA_VERS_REVISION = 0
+LT_JAVA_VERS_AGE = 0
+LT_TOOLS_VERS_INTERFACE = 100
+LT_TOOLS_VERS_REVISION = 0
+LT_TOOLS_VERS_AGE = 0
# This library is our main target.
lib_LTLIBRARIES = libhdf5_hl.la
# Add libtool numbers to the HDF5 hl library (from config/lt_vers.am)
-libhdf5_hl_la_LDFLAGS = -version-info $(LT_VERS_INTERFACE):$(LT_VERS_REVISION):$(LT_VERS_AGE) $(AM_LDFLAGS)
+libhdf5_hl_la_LDFLAGS = -version-info $(LT_HL_VERS_INTERFACE):$(LT_HL_VERS_REVISION):$(LT_HL_VERS_AGE) $(AM_LDFLAGS)
# List sources to include in the HDF5 HL Library.
libhdf5_hl_la_SOURCES = H5DO.c H5DS.c H5IM.c H5LT.c H5LTanalyze.c H5LTparse.c H5PT.c H5TB.c H5LD.c
diff --git a/html/ADGuide/Changes.html b/html/ADGuide/Changes.html
index b5179a3..1ea589a 100755
--- a/html/ADGuide/Changes.html
+++ b/html/ADGuide/Changes.html
@@ -72,13 +72,10 @@ a maintenance developer needs to be aware of:
</ul></p>
<p>Bugfixes and performance enhancements in the C library
-are automatically picked up by the C++ and Fortran libraries.
-The Java library will pick up the same bugfixes and enhancements
-at its next subsequent release as it is always built with
-the latest released version of the C library.
+are automatically picked up by the C++, Fortran, and Java libraries.
<p>The release notes also list changes made to the library, but these
-notes tend to be more at a more detail oriented level. The release
+notes tend to be more at a more detail-oriented level. The release
notes may include new features, bugs fixed, supported configuration
features, platforms on which the library has been tested, and known
problems. The release note files are listed below and can be found
@@ -98,7 +95,7 @@ directory of the distributed HDF5 source code.</p>
<tr><td style="padding-right:10px">
<a href="http://www.hdfgroup.org/ftp/HDF5/current/src/unpacked/release_docs/HISTORY-1_8.txt"
target="ExtWin"><code>HISTORY-1_8.txt</code></a></td>
- <td style="padding-right:10px">Technical notes for previous 1.8
+ <td style="padding-right:10px">Technical notes for 1.8.x
releases of the HDF5 Library by release
</td></tr>
@@ -115,17 +112,29 @@ directory of the distributed HDF5 source code.</p>
</dir>
<p><strong>Are you porting an existing application from
-HDF5 Release 1.6.x to HDF5 Release 1.8.x?</strong>
+HDF5 Release 1.8.x to HDF5 Release 1.10.x?</strong>
<br />
If you are porting an existing application
-from any HDF5 version in the Release 1.6.x series
-to any version in the Release 1.8.x series,
-refer to “<a href="../ADGuide/WhatsNew180.html">What's New in
-HDF5 1.8.0</a>”.
+from any HDF5 version in the Release 1.8.x series
+to any version in the Release 1.10.x series, refer to
+
+
+<font color="brown"><i><strong>
+< link TBD >
+</strong></i></font>
+
+<!-- “<a href="../ADGuide/WhatsNew180.html">What's New in
+ HDF5 1.8.0</a>”<-->
+
+.
This document, with the documents linked in its introduction,
provides a guide to the changes introduced in the transition
-from the 1.6.x series to HDF5 Release 1.8.0
-and discussions of various compatibility issues.</p>
+from the 1.8.x series to HDF5 Release 1.10.0
+and discussions of various compatibility issues.
+</p>
+<p>
+If you are porting an application from HDF5 Release 1.6.x, you should also see
+“<a href="../ADGuide/WhatsNew180.html">What's New in HDF5 1.8.0</a>”.
<br />
@@ -142,15 +151,15 @@ aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
-<!-- MATERIAL DELAYED FROM 18.15 TO 1.8.16
-<a name="1816">
-<h2>Release 1.8.16 of November 2015 (current release) versus Release 1.8.15</h2>
+<!-- MASKED ---- MATERIAL FOR 1.10.1--MATERIAL FOR 1.10.1--MATERIAL FOR 1.10.1
+<a name="11001">
+<h2>Release 1.10.1 of October(?) 2016 versus Release 1.10.0</h2>
</a>
<dir>
This section lists interface-level changes and
other user-visible changes in behavior
-in the transition from HDF5 Release 1.8.15 to Release 1.8.16.
+in the transition from HDF5 Release 1.10.0 to Release 1.10.1.
<h3>New and Changed Functions, Classes, Subroutines, Wrappers,
and Macros</h3>
@@ -181,15 +190,8 @@ in the transition from HDF5 Release 1.8.15 to Release 1.8.16.
</dl>
</dir>
</dir>
--->
-<!--
-<br />
-<br />
-<br />
-<br />
--->
@@ -233,52 +235,1226 @@ in the transition from HDF5 Release 1.8.15 to Release 1.8.16.
</font>
+ END MASK ---- MATERIAL FOR 1.10.1--MATERIAL FOR 1.10.1--MATERIAL FOR 1.10.1 -->
-<a name="1816">
-<h2>Release 1.8.16 of November 2015 (current release) versus Release 1.8.15</h2>
+<a name="11001">
+<h2>Release 1.10.0 of March 2016 (current release) versus Release 1.8.16</h2>
</a>
<dir>
This section lists interface-level changes and
other user-visible changes in behavior
-in the transition from HDF5 Release 1.8.15 to Release 1.8.16.
+in the transition from HDF5 Release 1.8.16 to Release 1.10.0.
+
+ <h3>New Features and Feature Sets</h3>
+ <dir>
+ <dl>
+ <dt>Several new features are introduced in HDF5 Relesase 1.10.0.
+ <dd>Single-Writer / Multiple-Reader or SWMR
+ </dd>
+ <dd>Collective Metadata I/O
+ </dd>
+ <dd>Fine-tuning the metadata cache
+ </dd>
+ <dd>File Space Management
+ </dd>
+ <dd>Virtual Datasets or VDS
+ </dd>
+ <dd>
+ </dd>
+ <dd>Partial Edge Chunk Options
+ </dd>
+ <dd>Relative Pathnames for External Links
+ </dd>
+ <dd>Property List Encoding and Decoding
+ </dd>
+ <dd>
+ </dd>
+ </dt>
+ <dt>More substantial lists follow, including new and modified
+ C functions and Fortran subroutines.
+ </dt>
+ </dl>
+ </dir>
+<!--
<h3>New and Changed Functions, Classes, Subroutines, Wrappers,
and Macros</h3>
<dir>
<dl>
<dt><strong>In the C Interface (main library)</strong>
+
</dt>
+ </dl>
+ </dir>
+-->
- <dt>New HDF5 Plugin Interface (H5PL)
+ <h3>New Features, including associated C Functions and Fortran Wrappers</h3>
+ <dir>
+ <dl>
+ <dt>The following features are described and documented in
+ <a href="/HDF5/docNewFeatures/">New Features in
+ HDF5 Release 1.10.0</a>.
+ On this page, we list each feature and its associated
+ C functions and Fortran wrappers.
</dt>
- <dd>A new HDF5 Plugin Interface (H5PL), enabling
- programmatic control of dynamically loaded plugins,
- was introduced at HDF5 Release 1.8.15.
- This interface was only partially documented at that time,
- but more complete documentation is now available:
- <ul>
- <li>“<a href="../Advanced/DynamicallyLoadedFilters/index.html">Dynamic
- Plugins in HDF5</a>”
- in <i>Advanced Topics in HDF5</i>
- </li>
- <li>“<a href="../RM/RM_H5PL.html">H5PL:
- Plugin Interface</a>”
- in the <i>HDF5 Reference Manual</i>
- </li>
- <ul>
- <li><a href="../RM/RM_H5PL.html#Plugin-SetLoadingState">
- <code>H5PLset_loading_state</code></a>
- </li>
- <li><a href="../RM/RM_H5PL.html#Plugin-GetLoadingState">
- <code>H5PLget_loading_state</code></a>
- </li>
- </ul>
- </ul>
+
+ <p />
+ <dt><a href="/HDF5/docNewFeatures/NewFeaturesSwmrDocs.html">Single-writer
+ / Multiple-reader</a>, commonly called
+ <a href="/HDF5/docNewFeatures/NewFeaturesSwmrDocs.html">SWMR</a>:
+ <br />
+
+ <dd>
+
+<!-- start nested table -->
+<table>
+
+
+<tr valign="top">
+ <td valign="top" width="25%">
+<!--<a href="SWMR/H5Fstart_swmr_write.htm">-->
+ <code>H5Fstart_swmr_write</code></a></td>
+ <td valign="top" width="75%">
+ Enables SWMR writing mode for a file.</td>
+</tr>
+
+
+<tr valign="top">
+ <td valign="top">
+<!--<a href="SWMR/H5DOappend.htm">-->
+ <code>H5DOappend</code></a></td>
+ <td valign="top">
+ Appends data to a dataset along a specified dimension.
+ <br />
+ <i>(This is a high-level API.)</i></td>
+</tr>
+
+
+<tr valign="top">
+ <td>
+<!--<a href="SWMR/H5Pget_append_flush.htm">-->
+ <code>H5Pget_append_flush</code></a>
+ </td>
+ <td>
+ Retrieves the values of the append property that is set up in the
+ dataset access property list.
+ </td>
+</tr>
+
+
+<tr valign="top">
+ <td>
+<!--<a href="SWMR/H5Pset_append_flush.htm">-->
+ <code>H5Pset_append_flush</code></a>
+ </td>
+ <td>
+ Sets two actions to perform when the size of a dataset’s
+ dimension being appended reaches a specified boundary.
+ </td>
+</tr>
+
+
+<tr valign="top">
+ <td>
+<!--<a href="SWMR/H5Pget_object_flush_cb.htm">-->
+ <code>H5Pget_object_flush_cb</code></a><code> </code>
+ </td>
+ <td>
+ Retrieves the object flush property values from the file access
+ property list.
+ </td>
+</tr>
+
+
+<tr valign="top">
+ <td>
+<!--<a href="SWMR/H5Pset_object_flush_cb.htm">-->
+ <code>H5Pset_object_flush_cb</code></a>
+ </td>
+ <td>
+ Sets a callback function to invoke when an object flush occurs in
+ the file.
+ </td>
+</tr>
+
+
+<tr valign="top">
+ <td>
+<!--<a href="SWMR/H5Odisable_mdc_flushes.htm">-->
+ <code>H5Odisable_mdc_flushes</code></a>
+ </td>
+ <td>
+ Prevents metadata entries for an HDF5 object from being flushed from
+ the metadata cache to storage.
+ </td>
+</tr>
+
+
+<tr valign="top">
+ <td>
+<!--<a href="SWMR/H5Oenable_mdc_flushes.htm">-->
+ <code>H5Oenable_mdc_flushes</code></a>
+ </td>
+ <td>
+ Returns the cache entries associated with an HDF5 object to the
+ default metadata flush and eviction algorithm.
+ </td>
+</tr>
+
+
+<tr valign="top">
+ <td colspan="2">
+<!--<a href="SWMR/H5Oare_mdc_flushes_disabled.htm">-->
+ <code>H5Oare_mdc_flushes_disabled</code></a>
+ </td>
+ <tr valign="top">
+ <td> </td>
+ <td>
+ Determines if an HDF5 object (dataset, group, committed
+ datatype) has had flushes of metadata entries disabled.
+ </td>
+</tr>
+
+
+<tr valign="top">
+ <td>
+<!--<a href="SWMR/H5Fdisable_mdc_flushes.htm">-->
+ <code>H5Fdisable_mdc_flushes</code></a>
+ </td>
+ <td>
+ Globally prevents dirty metadata entries from being flushed from
+ the metadata cache to storage.
+ </td>
+</tr>
+
+
+<tr valign="top">
+ <td>
+<!--<a href="SWMR/H5Fenable_mdc_flushes.htm">-->
+ <code>H5Fenable_mdc_flushes</code></a>
+ </td>
+ <td>
+ Returns a file’s metadata cache to the standard eviction and
+ flushing algorithm.
+ </td>
+</tr>
+
+
+<tr valign="top">
+ <td colspan="2">
+<!--<a href="SWMR/H5Fare_mdc_flushes_disabled.htm">-->
+ <code>H5Fare_mdc_flushes_disabled</code></a>
+ </td>
+ <tr valign="top">
+ <td> </td>
+ <td>
+ Determines if flushes have been globally disabled for a
+ file’s metadata cache.
+ </td>
+</tr>
+
+
+<tr valign="top">
+ <td colspan="2">
+<!--<a href="SWMR/H5Fget_mdc_flush_disabled_obj_ids.htm">-->
+ <code>H5Fget_mdc_flush_disabled_obj_ids</code></a>
+ </td>
+ <tr valign="top">
+ <td> </td>
+ <td>
+ Returns a list of all object identifiers for which flushes have
+ been disabled in a file’s metadata cache.
+ </td>
+</tr>
+
+
+
+<tr>
+ <td valign="top" colspan="2">
+ <br />
+ <u>Command-line Tools:</u>
+ </td>
+</tr>
+
+
+<tr>
+ <td valign="top">
+<!--<a href="SWMR/h5watch.htm">-->
+ <code>h5watch</code></a>
+ </td>
+ <td valign="top">
+ Allows users to output new records appended to a dataset under
+ SWMR access as it grows. The functionality is similar
+ to the Unix user command <code>tail</code> with the follow option,
+ which outputs appended data as the file grows.
+ </td>
+</tr>
+
+
+<tr>
+ <td valign="top">
+<!--<a href="SWMR/h5format_convert.htm">-->
+ <code>h5format_convert</code></a>
+ </td>
+ <td valign="top">
+ This tool allows users to convert the indexing
+ type of a chunked dataset made with a 1.10.x version of the HDF5
+ Library when the latest file format is used to
+ the 1.8.x version 1 B-tree indexing type.
+ For example, datasets created using SWMR access, can be
+ converted to be accessed by the HDF5 1.18 library and tools. The
+ tool does not rewrite raw data, but it does rewrite HDF5 metadata.
+ </td>
+</tr>
+
+<!-- <tr><td bgcolor="#FFFFFF" colspan="2"> </td></tr> -->
+</table>
+<!-- end nested table -->
+
+ </dd>
+ </dt>
+
+ <p />
+ <dt><a href="/HDF5/docNewFeatures/NewFeaturesCollectiveMetadataIoDocs.html">Collective
+ Metadata I/O</a>:
+ <br />
+ <dd>
+
+
+
+
+<!-- start nested table -->
+<table>
+
+
+<tr>
+ <td valign="top" width="25%">
+<!--<a href="CollMDataIO/H5Pset_coll_metadata_write.htm">-->
+ <code>H5Pset_coll_metadata_write</code></a>
+ <br />
+ <code>h5pset_coll_metadata_write_f</code></td>
+ <td valign="top" width="75%">
+ Establishes I/O mode property setting, collective or independent,
+ for metadata writes.</td>
+</tr>
+
+
+<tr>
+ <td valign="top" width="25%">
+<!--<a href="CollMDataIO/H5Pget_coll_metadata_write.htm">-->
+ <code>H5Pget_coll_metadata_write</code></a>
+ <br />
+ <code>h5pget_coll_metadata_write_f</code></td>
+ <td valign="top" width="75%">
+ Retrieves I/O mode property setting for metadata writes.</td>
+</tr
+
+
+<tr>
+ <td valign="top" width="25%">
+<!--<a href="CollMDataIO/H5Pset_all_coll_metadata_ops.htm">-->
+ <code>H5Pset_all_coll_metadata_ops</code></a><code> </code>
+ <br />
+ <code>h5pset_all_coll_metadata_ops_f</code></a><code> </code>
+ </td>
+ <td valign="top" width="75%">
+ Establishes I/O mode, collective or independent,
+ for metadata read operations.</td>
+ </td>
+</tr>
+
+
+<tr>
+ <td valign="top" width="25%">
+<!--<a href="CollMDataIO/H5Pget_all_coll_metadata_ops.htm">-->
+ <code>H5Pget_all_coll_metadata_ops</code></a>
+ <br />
+ <code>h5pget_all_coll_metadata_ops_f</code></td>
+ <td valign="top" width="75%">
+ Retrieves I/O mode for metadata read operations.</td>
+</tr>
+
+
+</table>
+<!-- end nested table -->
+
+ </dd>
+ </dt>
+
+
+ <p />
+ <dt><a href="/HDF5/docNewFeatures/NewFeaturesFineTuningMetadataCacheDocs.html">Fine-tuning
+ the Metadata Cache</a>:
+ <br />
+ <dd>
+
+
+
+<!-- start nested table -->
+
+<table width="100%">
+<tr align="left" valign="top">
+ <td width="20%" colspan="2">
+<!--<a href="FineTuneMDC/H5Fget_metadata_read_retries_info.htm">-->
+ <code>H5Fget_metadata_read_retries_info</code></a>
+ </td></tr>
+ <tr><td>
+ </td>
+ <td align="left" valign="top" width="80%">
+ Retrieves the collection of read retries for metadata items with checksum.
+ </td>
+</tr>
+
+
+<tr align="left" valign="top">
+ <td colspan="2">
+<!--<a href="FineTuneMDC/H5Pget_metadata_read_attempts.htm">-->
+ <code>H5Pget_metadata_read_attempts</code></a>
+ </td></tr>
+ <tr><td>
+ </td>
+ <td>
+ Retrieves the number of read attempts from a file access property list.
+ </td>
+</tr>
+
+
+<tr align="left" valign="top">
+ <td colspan="2">
+<!--<a href="FineTuneMDC/H5Pset_metadata_read_attempts.htm">-->
+ <code>H5Pset_metadata_read_attempts</code></a>
+ </td></tr>
+ <tr><td>
+ </td>
+ <td>
+ Sets the number of read attempts in a file access property list.
+ </td>
+</tr>
+
+
+<tr align="left" valign="top">
+ <td>
+<!--<a href="FineTuneMDC/H5Dflush.htm">-->
+ <code>H5Dflush</code></a>
+ </td>
+ <td>
+ Causes all buffers associated with a dataset to be immediately
+ written to disk without removing the data from the cache.
+ </td>
+</tr>
+
+
+<tr align="left" valign="top">
+ <td>
+<!--<a href="FineTuneMDC/H5Drefresh.htm">-->
+ <code>H5Drefresh</code></a>
+ </td>
+ <td>
+ Causes all buffers associated with a dataset to be
+ cleared and immediately re-loaded with updated contents from disk storage.
+ </td>
+</tr>
+
+
+<tr align="left" valign="top">
+ <td>
+<!--<a href="FineTuneMDC/H5Gflush.htm">-->
+ <code>H5Gflush</code></a>
+ </td>
+ <td>
+ Causes all buffers associated with a group to be immediately flushed
+ to disk without removing the data from the cache.
+ </td>
+</tr>
+
+
+<tr align="left" valign="top">
+ <td>
+<!--<a href="FineTuneMDC/H5Grefresh.htm">-->
+ <code>H5Grefresh</code></a>
+ </td>
+ <td>
+ Causes all buffers associated with a group to be cleared and
+ immediately re-loaded with updated contents from disk storage.
+ </td>
+</tr>
+
+
+<tr align="left" valign="top">
+ <td>
+<!--<a href="FineTuneMDC/H5Oflush.htm">-->
+ <code>H5Oflush</code></a>
+ </td>
+ <td>
+ Causes all buffers associated with an object to be immediately
+ flushed to disk without removing the data from the cache.
+ </td>
+</tr>
+
+
+<tr align="left" valign="top">
+ <td>
+<!--<a href="FineTuneMDC/H5Orefresh.htm">-->
+ <code>H5Orefresh</code></a>
+ </td>
+ <td>
+ Causes all buffers associated with an object to be cleared and
+ immediately re-loaded with updated contents from disk storage.
+ </td>
+</tr>
+
+
+<tr align="left" valign="top">
+ <td>
+<!--<a href="FineTuneMDC/H5Tflush.htm">-->
+ <code>H5Tflush</code></a>
+ </td>
+ <td>
+ Causes all buffers associated with a committed datatype to be
+ immediately flushed to disk without removing the data from the cache.
+ </td>
+</tr>
+
+
+<tr align="left" valign="top">
+ <td>
+<!--<a href="FineTuneMDC/H5Trefresh.htm">-->
+ <code>H5Trefresh</code></a>
+ </td>
+ <td>
+ Causes all buffers associated with a committed datatype to be
+ cleared and immediately re-loaded with updated contents from disk storage.
+ </td>
+</tr>
+
+
+<tr align="left" valign="top">
+ <td>
+<!--<a href="FineTuneMDC/H5Fget_intent.htm">-->
+ <code>H5Fget_intent</code></a>
+ </td>
+ <td>
+ Determines the read/write or read-only status of a file.
+ </td>
+</tr>
+
+
+
+
+<!-- logging APIs start -->
+
+
+<!-- <table> -->
+<tr><td valign="top" colspan="2">
+ <br />
+ <a name="LoggingApis"><u>
+ Logging APIs:</u></a>
+ </td>
+</tr>
+
+
+<tr align="left" valign="top">
+ <td>
+<!--<a href="FineTuneMDC/H5Pset_mdc_log_options.htm">-->
+ <code>H5Pset_mdc_log_options</code></a><code> </code>
+ </td>
+ <td align="left" valign="top" width="80%">
+ Sets metadata cache logging options.
+ </td>
+</tr>
+
+
+<tr align="left" valign="top">
+ <td>
+<!--<a href="FineTuneMDC/H5Pget_mdc_log_options.htm">-->
+ <code>H5Pget_mdc_log_options</code></a>
+ </td>
+ <td align="left" valign="top" >
+ Gets metadata cache logging options.
+ </td>
+</tr>
+
+
+<tr align="left" valign="top">
+ <td>
+<!--<a href="FineTuneMDC/H5Fstart_mdc_logging.htm">-->
+ <code>H5Fstart_mdc_logging</code></a>
+ </td>
+ <td align="left" valign="top" >
+ Starts logging metadata cache events if logging was previously enabled.
+ </td>
+</tr>
+
+
+<tr align="left" valign="top">
+ <td>
+<!--<a href="FineTuneMDC/H5Fstop_mdc_logging.htm">-->
+ <code>H5Fstop_mdc_logging</code></a>
+ </td>
+ <td align="left" valign="top" >
+ Stops logging metadata cache events if logging was previously
+ enabled and is currently ongoing.
+ </td>
+</tr>
+
+
+<tr align="left" valign="top">
+ <td colspan="2">
+<!--<a href="FineTuneMDC/H5Pget_mdc_logging_status.htm">-->
+ <code>H5Pget_mdc_logging_status</code></a>
+ </td></tr>
+ <tr><td>
+ </td>
+ <td align="left" valign="top" >
+ Gets the current metadata cache logging status.
+ </td>
+</tr>
+
+
+<!-- logging APIs end -->
+</table>
+<!-- end nested table -->
+
+
+ </dd>
+ </dt>
+
+
+ <p />
+ <dt><a href="/HDF5/docNewFeatures/NewFeaturesFileSpaceMgmtDocs.html">File
+ Space Management</a>:
+ <br />
+ <dd>
+
+
+<!-- start nested table -->
+
+<table>
+
+<tr>
+ <td valign="top" width="25%">
+<!--<a href="FileSpace/H5Fget_free_sections.htm">-->
+ <code>H5Fget_free_sections</code></a>
+ </td>
+ <td valign="top" width="3%">
+
+ </td>
+ <td valign="top" width="72%">
+ Retrieves free-space section information for a file.
+ </td>
+</tr>
+
+
+<tr>
+ <td valign="top">
+<!--<a href="FileSpace/H5Fget_freespace.htm">-->
+ <code>H5Fget_freespace</code></a>
+ </td>
+ <td valign="top">
+
+ </td>
+ <td valign="top">
+ Returns the amount of free space in a file.
+ </td>
+</tr>
+
+
+<tr>
+ <td>
+<!--<a href="FileSpace/H5Fget_info2.htm">-->
+ <code>H5Fget_info2</code></a>
+ </td>
+ <td valign="top">
+
+ </td>
+ <td>
+ Returns global information for a file.
+ </td>
+</tr>
+
+
+<tr>
+ <td valign="top">
+<!--<a href="FileSpace/H5Pset_file_space.htm">-->
+ <code>H5Pset_file_space</code></a>
+ </td>
+ <td valign="top">
+
+ </td>
+ <td valign="top">
+ Sets the file space management strategy and/or
+ the free-space section threshold for an HDF5 file.
+ </td>
+</tr>
+
+
+<tr>
+ <td valign="top">
+<!--<a href="FileSpace/H5Pget_file_space.htm">-->
+ <code>H5Pget_file_space</code></a>
+ </td>
+ <td valign="top">
+
+ </td>
+ <td valign="top">
+ Retrieves the file space management strategy and/or
+ the free-space section threshold for an HDF5 file.
+ </td>
+</tr>
+
+
+<tr><td bgcolor="#FFFFFF" colspan="2"> </td></tr>
+
+
+<!--
+<tr>
+<td bgcolor="#FFFFFF" align="left" valign="top" colspan="2">
+ <font size="5" color="#004488"><a name="Tools">Tool</a></font>
+ </td></tr>
+-->
+
+
+<tr>
+ <td align="left" valign="top" colspan="3">
+ The following tool has been modified to preserve or modify
+ file freepace information appropriately when processing files
+ employing the VDS feature:
+ </td></tr>
+
+
+<tr>
+ <td align="left" valign="top" colspan="2">
+<!--<a href="FileSpace/h5repack.htm">-->
+ <code>h5repack</code></a>
+ </td>
+ <td align="left" valign="top">
+ Repacks HDF5 files with various options, including the ability
+ to change the applied filters.
+ This version of <code>h5repack</code> understands the
+ file free space feature and handles the file and metadata
+ appropriately.
+ </td>
+</tr>
+</table>
+
+<!-- end nested table -->
+
+
+ </dd>
+ </dt>
+
+
+ <p />
+ <dt><a href="/HDF5/docNewFeatures/NewFeaturesVirtualDatasetDocs.html">Virtual
+ Dataset</a> or
+ <a href="/HDF5/docNewFeatures/NewFeaturesVirtualDatasetDocs.html">VDS</a>:
+ <br />
+ <dd>
+
+
+<!-- start nested table -->
+
+<table>
+
+
+<tr>
+ <td valign="top" width="25%">
+<!--<a href="VDS/H5Pset_virtual.htm">-->
+ <code>H5Pset_virtual</code></a>
+ <br />
+ <code>h5pset_virtual_f</code></td>
+ <td valign="top" width="75%">
+ Sets the mapping between virtual and source datasets.</td>
+</tr>
+
+
+<tr>
+ <td valign="top">
+<!--<a href="VDS/H5Pget_virtual_count.htm">-->
+ <code>H5Pget_virtual_count</code></a>
+ <br />
+ <code>h5pget_virtual_count_f</code></td>
+ <td valign="top">
+ Retrieves the number of mappings for the virtual dataset.</td>
+</tr>
+
+
+<tr>
+ <td valign="top">
+<!--<a href="VDS/H5Pget_virtual_vspace.htm">-->
+ <code>H5Pget_virtual_vspace</code></a>
+ <br />
+ <code>h5pget_virtual_vspace_f</code>
+ </td>
+ <td valign="top">
+ Retrieves a dataspace identifier for the selection
+ within the virtual dataset used in the mapping.
+ </td>
+</tr>
+
+
+<tr>
+ <td valign="top">
+<!--<a href="VDS/H5Pget_virtual_srcspace.htm">-->
+ <code>H5Pget_virtual_srcspace</code></a>
+ <br />
+ <code>h5pget_virtual_srcspace_f</code>
+ </td>
+ <td valign="top">
+ Retrieves a dataspace identifier for the selection
+ within the source dataset used in the mapping.
+ </td>
+</tr>
+
+
+<tr>
+ <td valign="top">
+<!--<a href="VDS/H5Pget_virtual_dsetname.htm">-->
+ <code>H5Pget_virtual_dsetname</code></a>
+ <br />
+ <code>h5pget_virtual_dsetname_f</code>
+ </td>
+ <td valign="top">
+ Retrieves the name of a source dataset used in the mapping.</td>
+</tr>
+
+
+<tr>
+ <td valign="top">
+<!--<a href="VDS/H5Pget_virtual_filename.htm">-->
+ <code>H5Pget_virtual_filename</code></a>
+ <br />
+ <code>h5pget_virtual_filename_f</code>
+ </td>
+ <td valign="top">
+ Retrieves the filename of a source dataset used in the mapping.
+ </td>
+</tr>
+
+
+<tr>
+ <td valign="top">
+<!--<a href="VDS/H5Pset_virtual_printf_gap.htm">-->
+ <code>H5Pset_virtual_printf_gap</code></a>
+ <br />
+ <code>h5pset_virtual_printf_gap_f</code>
+ </td>
+ <td valign="top">
+ Sets maximum number of missing source files and/or datasets with
+ printf-style names when getting the extent of an unlimited
+ virtual dataset.
+ </td>
+</tr>
+
+
+<tr>
+ <td valign="top">
+<!--<a href="VDS/H5Pget_virtual_printf_gap.htm">-->
+ <code>H5Pget_virtual_printf_gap</code></a>
+ <br />
+ <code>h5pget_virtual_printf_gap_f</code>
+ </td>
+ <td valign="top">
+ Returns maximum number of missing source files and/or datasets with
+ printf-style names when getting the extent for an unlimited
+ virtual dataset.
+ </td>
+</tr>
+
+
+<tr>
+ <td valign="top">
+<!--<a href="VDS/H5Pset_virtual_view.htm">-->
+ <code>H5Pset_virtual_view</code></a>
+ <br />
+ <code>h5pset_virtual_view_f</code>
+ </td>
+ <td valign="top">
+ Sets the view of the virtual dataset to include or exclude
+ missing mapped elements.
+ </td>
+</tr>
+
+
+<tr>
+ <td valign="top">
+<!--<a href="VDS/H5Pget_virtual_view.htm">-->
+ <code>H5Pget_virtual_view</code></a>
+ <br />
+ <code>h5pget_virtual_view_f</code>
+ </td>
+ <td valign="top">
+ Retrieves the view of a virtual dataset.
+ </td>
+</tr>
+
+
+<tr>
+ <td valign="top" colspan="2">
+ <br />
+ <u>Supporting Functions:</u>
+ </td>
+</tr>
+
+
+
+<tr>
+ <td valign="top">
+<!--<a href="VDS/H5Sis_regular_hyperslab.htm">-->
+ <code>H5Sis_regular_hyperslab</code></a>
+ <br />
+ <code>h5sis_regular_hyperslab_f</code>
+ </td>
+ <td valign="top">
+ Determines whether a hyperslab selection is regular.
+ </td>
+</tr>
+
+
+<tr>
+ <td valign="top">
+<!--<a href="VDS/H5Sget_regular_hyperslab.htm">-->
+ <code>H5Sget_regular_hyperslab</code></a><code> </code>
+ <br />
+ <code>h5sget_regular_hyperslab_f</code><code>
+ </td>
+ <td valign="top">
+ Retrieves a regular hyperslab selection.
+ </td>
+</tr>
+
+
+<tr>
+ <td valign="top" colspan="2">
+ <br />
+ <u>Modified Functions:</u>
+ <br />
+ The following pre-exising functions have been modified to understand
+ virtual datasets.
+ </td>
+</tr>
+
+
+
+<tr>
+ <td valign="top" width="25%">
+<!--<a href="VDS/H5Pset_layout.htm">-->
+ <code>H5Pset_layout</code></a>
+ <br />
+ <code>h5pset_layout_f</code></td>
+ <td valign="top" width="75%">
+ Specifies the layout to be used for a dataset.
+ <br />
+ Virtual dataset, <code>H5D_VIRTUAL</code>, has been added
+ to the list of layouts available through this function.</td>
+</tr>
+
+
+<tr>
+ <td valign="top" width="25%">
+<!--<a href="VDS/H5Pget_layout.htm">-->
+ <code>H5Pget_layout</code></a>
+ <br />
+ <code>h5pget_layout_f</code></td>
+ <td valign="top" width="75%">
+ Retrieves the layout in use for a dataset.
+ <br />
+ Virtual dataset, <code>H5D_VIRTUAL</code>, has been added
+ to the list of layouts.</td>
+</tr>
+
+
+
+</table>
+<!-- end nested table -->
+
+
+ </dd>
+ </dt>
+
+
+ <p />
+ <dt><a href="/HDF5/docNewFeatures/NewFeaturesPartialEdgeChunkDocs.html">Partial
+ Edge Chunks</a>:
+ <br />
+ <dd>
+
+
+<!-- start nested table -->
+<table>
+
+
+<tr>
+ <td valign="top" width="25%">
+<!--<a href="PartialEdgeChunks/H5Pset_chunk_opts.htm">-->
+ <code>H5Pset_chunk_opts</code></a> </td>
+ <td valign="top" width="75%">
+ Sets a partial edge chunk option in a dataset access property list.</td>
+</tr>
+
+
+<tr>
+ <td valign="top" width="25%">
+<!--<a href="PartialEdgeChunks/H5Pget_chunk_opts.htm">-->
+ <code>H5Pget_chunk_opts</code></a> </td>
+ <td valign="top" width="75%">
+ Retrieves partial edge chunk option setting
+ from a dataset access property list.</td>
+</tr>
+
+
+</table>
+<!-- end nested table -->
+
+
</dd>
+ </dt>
+
+
+ <p />
+ <dt>Relative Pathnames for External Links:
+<!--
+ <a href="/HDF5/docNewFeatures/NewFeaturesExternalLinkDocs.html">Relative
+ Pathnames for External Links</a>:
+-->
+ <br />
+ <dd>
+
+
+<!-- start nested table -->
+<table>
+
+
+<tr>
+ <td valign="top" width="25%">
+<!--<a href="ExternalLinkPrefix/H5Pset_elink_prefix.htm">-->
+ <code>H5Pset_elink_prefix</code></a> </td>
+ <td valign="top" width="75%" rowspan="2">
+ These functions enable the user to specify the locations of
+ external files.
+ <br />
+ <i>(These functions are not yet documented.)</i>
+ </td>
+</tr>
+
+
+<tr>
+ <td valign="top" width="25%">
+<!--<a href="ExternalLinkPrefix/H5Pget_elink_prefix.htm">-->
+ <code>H5Pget_elink_prefix</code></a> </td>
+<!--<td valign="top" width="75%">
+ </td> -->
+</tr>
+
+
+</table>
+<!-- end nested table -->
+
+
+ </dd>
+ </dt>
+
+
+ <p />
+ <dt>Property List Encoding and Decoding:
+<!--
+ <a href="/HDF5/docNewFeatures/NewFeaturesProperListEncodingDocs.html">Property
+ List Encoding and Decoding</a>:
+-->
+ <br />
+ <dd>
+
+
+<!-- start nested table -->
+<table>
+
+
+<tr>
+ <td valign="top" width="25%">
+<!--<a href="PListEncoding/H5Pencode.htm">-->
+ <code>H5Pencode</code></a> </td>
+ <td valign="top" width="75%">
+ </td>
+</tr>
+
+
+<tr>
+ <td valign="top" width="25%">
+<!--<a href="PListEncoding/H5Pdecode.htm">-->
+ <code>H5Pdecode</code></a> </td>
+ <td valign="top" width="75%">
+ </td>
+</tr>
+
+
+</table>
+<!-- end nested table -->
+
+
+ </dd>
+ </dt>
+
+
+<font color="brown">
+ <p />
+ <dt><a href="/HDF5/docNewFeatures/NewFeaturesAnotherFeatureDocs.html">Another
+ Feature?</a>:
+ <br />
+ <dd>
+ Placeholder for additional features.
+
+
+<!-- start nested table -->
+<!-- end nested table -->
+
+
+ </dd>
+ </dt>
+</font>
+
+
+ </dl>
+ </dir>
+
+
+ <h3>API Compatibility</h3>
+ <dir>
+ <dl>
+ <p />
+ <dt>See <a href="../RM/APICompatMacros.html">API Compatibility
+ Macros in HDF5</a> for details on the following.
+
+ <p />
+ <dt>New API Compatibility Flag
+ <dd>A new <code>v18</code> flag was added enabling the building
+ of HDF5 such that the default API is compatible with the
+ HDF5 Release 1.8.x API:
+ <br />
+ <code> --with-default-api-version=v18</code>
+ <br />
+
+ <p />
+ <dt>New versioned functions and associated compatibility macros
+ <dd>Two functions and a struct have been converted to
+ a versioned form in this release.
+ Compatibility macros have been created for each.
+ <p />
+ <dl><dt><code>H5Fget_info</code>
+ <dd>The original function is renamed to
+ <code>H5Fget_info1</code> and deprecated.
+ </dd>
+ <dd>A new version of the function,
+ <code>H5Fget_info2</code>, is introduced.
+ </dd>
+ <dd>The compatiblity macro <code>H5Fget_info</code>
+ is introduced.
+ </dt>
+ </dl>
+ <p />
+ <dl><dt><code>H5F_info_t</code>
+ <dd>This is the struct used by the
+ <code>H5Fget_info</code> functions and macro.
+ <dd>The original struct is renamed to
+ <code>H5F_info1_t</code> and deprecated.
+ </dd>
+ <dd>A new version of the struct,
+ <code>H5F_info2_t</code>, is introduced.
+ </dd>
+ <dd>The compatiblity macro <code>H5F_info_t</code>
+ is introduced.
+ </dt>
+ </dl>
+ <p />
+ <dl><dt><code>H5Rdereference</code>
+ <dd>The original function is renamed to
+ <code>H5Rdereference1</code> and deprecated.
+ </dd>
+ <dd>A new version of the function,
+ <code>H5Rdereference2</code>, is introduced.
+ </dd>
+ <dd>The compatiblity macro <code>H5Rdereference</code>
+ is introduced.
+ </dt>
+ </dl>
+ </dd>
+
+ </dt>
+
+ </dl>
+ </dir>
+
+
+ <h3>Autotools Configuration and Large File Support</h3>
+ <dir>
+ <dl>
+ <p />
+ <dt>Autotools configuration has been extensively reworked
+ and autotool’s handling of large file support
+ has been overhauled in this release.
+ <p />
+ See the following sections in <code>RELEASE.txt</code>:
+ <ul>
+ <li>“Autotools Configuration Has Been Extensively
+ Reworked”
+ <li>“LFS Changes”
+ </ul>
+ <p />
+ <code>RELEASE.txt</code> is found in the
+ <code>release_docs/</code> subdirectory at the root level
+ of the HDF5 code distribution.
+
+ </dl>
+ </dir>
+
+</dir>
+<dir>
+
+ <h3>Compatibility Report and Comments</h3>
+ <dir>
+ <dl>
+ <dt><strong>Compatibility report for Release 1.10.0 versus
+ Release 1.8.16</strong>
+ </dt>
+ <dd>
+ <a href="Compatibility_Report/CR_1.10.0.html">API
+ compatibility report for the HDF5 Library
+ between 1.10.0 and 1.8.16 versions on
+ x86</a>
+ </dd>
+
+ <p>
+ <dt><strong>Changed shared library interface version
+ number (<code>soname</code>)</strong>
+ </dt>
+ <dd>Comments, comments, comments.
+ <br>
+ These comments are inserted at the very end of release preparation;
+ comments from 1.8 follow as template and placeholder.
+ <p>
+ In the C++ interface, two overloaded methods
+ have been combined into a single method
+ and one constructor has been deprecated.
+ <p>
+ Due to these changes, the shared library interface version
+ number (<code>soname</code>) has been increased.
+ For a full list of the changed symbols, see the
+ interface compatibility report linked immediately above.
+ </dd>
+
+ </dl>
+ </dir>
+
+</dir>
+
+
+
+<!-- BLOCKING OFF TEMPLATE TEXT
+<hr />
+<hr />
<p />
<dt>The following new C function has been added:
@@ -438,56 +1614,8 @@ in the transition from HDF5 Release 1.8.15 to Release 1.8.16.
</dl>
</dir>
- <h3>Compatibility Report and Comments</h3>
- <dir>
- <dl>
- <dt><strong>Compatibility report for Release 1.8.16 versus
- Release 1.8.15</strong>
- </dt>
- <dd>
- <a href="Compatibility_Report/CR_1.8.16.html">API
- compatibility report for the HDF5 Library
- between 1.8.15 and 1.8.16 versions on
- x86</a>
- </dd>
-
-
-
-
- <p>
- <dt><strong>Changed shared library interface version
- number (<code>soname</code>)</strong>
- </dt>
- <dd>
-
- < More detailed description of changes >
- <p>
- Due to these changes, the shared library interface version
- number (<code>soname</code>) has been increased.
- For a full list of the changed symbols, see the
- interface compatibility report linked immediately above.
- </dd>
-
-
-<!--
- <p>
- <dt><strong>Changed shared library interface version
- number (<code>soname</code>)</strong>
- </dt>
- <dd>In the C++ interface, two overloaded methods
- have been combined into a single method
- and one constructor has been deprecated.
- <p>
- Due to these changes, the shared library interface version
- number (<code>soname</code>) has been increased.
- For a full list of the changed symbols, see the
- interface compatibility report linked immediately above.
- </dd>
--->
-
- </dl>
- </dir>
+<!-- END OF 1.8.16 SECTION -->
@@ -790,18 +1918,22 @@ H5O_TYPE_NTYPES_F </pre>
</dl>
</dir>
+-->
+<!-- END 1.8.15 MASK -->
+<!--
+<dir>
<h3>Compatibility Report and Comments</h3>
<dir>
<dl>
- <dt><strong>Compatibility report for Release 1.8.15 versus
- Release 1.8.14</strong>
+ <dt><strong>Compatibility report for Release 1.10.0 versus
+ Release 1.8.16</strong>
</dt>
<dd>
- <a href="Compatibility_Report/CR_1.8.15.html">API
+ <a href="Compatibility_Report/CR_1.10.0.html">API
compatibility report for the HDF5 Library
- between 1.8.14 and 1.8.15 versions on
+ between 1.10.0 and 1.8.16 versions on
x86</a>
</dd>
@@ -809,7 +1941,12 @@ H5O_TYPE_NTYPES_F </pre>
<dt><strong>Changed shared library interface version
number (<code>soname</code>)</strong>
</dt>
- <dd>In the C++ interface, two overloaded methods
+ <dd>Comments, comments, comments.
+ <br>
+ These comments are inserted at the very end of release preparation;
+ comments from 1.8 follow as template and placeholder.
+ <p>
+ In the C++ interface, two overloaded methods
have been combined into a single method
and one constructor has been deprecated.
<p>
@@ -824,16 +1961,34 @@ H5O_TYPE_NTYPES_F </pre>
</dir>
-->
-<!-- END 1.8.15 MASK -->
<br />
</dir>
+<hr>
+
+<!--
+<a name="110xx">
+<h2>Prior Releases in the 1.10.x Series</h2>
+</a>
+
+<dir>
+
+Change notes for HDF5 Release 1.10.0 to the release immediately
+preceding the current release are published in
+“<a href="Changes_1_10_x.html">HDF5 Software Changes from
+Release to Release for HDF5 Releases 1.10.x</a>”.
+
+</dir>
+<br />
+-->
+
+
<a name="18x">
-<h2>Prior Releases in the 1.8.x Series</h2>
+<h2>Releases in the 1.8.x Series</h2>
</a>
<dir>
@@ -848,7 +2003,7 @@ Release to Release for HDF5 Releases 1.8.x</a>”.
<a name="1610">
-<h2>Releases 1.6.x and 1.4.x</h2>
+<h2>Releases in the 1.6.x and 1.4.x Series</h2>
</a>
<dir>
@@ -921,7 +2076,7 @@ Release to Release for HDF5 Releases 1.4.0 through 1.6.10</a>”.
<!-- Created: Spring 1999 -->
<!-- hhmts start -->
<hr />
-Last modified: 4 November 2015
+Last modified: 25 March 2016
<!-- hhmts end -->
<br />
<br />
diff --git a/html/ADGuide/Changes_1_8_x.html b/html/ADGuide/Changes_1_8_x.html
index be49b55..49fd551 100644
--- a/html/ADGuide/Changes_1_8_x.html
+++ b/html/ADGuide/Changes_1_8_x.html
@@ -86,9 +86,278 @@ to Release for HDF5 Releases 1.4.0 through 1.6.10</a>” for:
</ul>
<p>
+<p><strong>Are you porting an existing application from
+HDF5 Release 1.6.x to HDF5 Release 1.8.x?</strong>
<br />
+If you are porting an existing application
+from any HDF5 version in the Release 1.6.x series
+to any version in the Release 1.8.x series, refer to
+“<a href="../ADGuide/WhatsNew180.html">What's New in
+HDF5 1.8.0</a>”.
+This document, with the documents linked in its introduction,
+provides a guide to the changes introduced in the transition
+from the 1.6.x series to HDF5 Release 1.8.0
+and discussions of various compatibility issues.
+<br />
+
+
+
+
+<a name="1816">
+<h2>Release 1.8.16 of November 2015 versus Release 1.8.15</h2>
+</a>
+<dir>
+
+
+This section lists interface-level changes and
+other user-visible changes in behavior
+in the transition from HDF5 Release 1.8.15 to Release 1.8.16.
+
+ <h3>New and Changed Functions, Classes, Subroutines, Wrappers,
+ and Macros</h3>
+ <dir>
+ <dl>
+ <dt><strong>In the C Interface (main library)</strong>
+ </dt>
+
+ <dt>New HDF5 Plugin Interface (H5PL)
+ </dt>
+ <dd>A new HDF5 Plugin Interface (H5PL), enabling
+ programmatic control of dynamically loaded plugins,
+ was introduced at HDF5 Release 1.8.15.
+ This interface was only partially documented at that time,
+ but more complete documentation is now available:
+ <ul>
+ <li>“<a href="../Advanced/DynamicallyLoadedFilters/index.html">Dynamic
+ Plugins in HDF5</a>”
+ in <i>Advanced Topics in HDF5</i>
+ </li>
+ <li>“<a href="../RM/RM_H5PL.html">H5PL:
+ Plugin Interface</a>”
+ in the <i>HDF5 Reference Manual</i>
+ </li>
+ <ul>
+ <li><a href="../RM/RM_H5PL.html#Plugin-SetLoadingState">
+ <code>H5PLset_loading_state</code></a>
+ </li>
+ <li><a href="../RM/RM_H5PL.html#Plugin-GetLoadingState">
+ <code>H5PLget_loading_state</code></a>
+ </li>
+ </ul>
+ </ul>
+ </dd>
+
+ <p />
+ <dt>The following new C function has been added:
+ </dt>
+ <dd>This function reports whether the linked
+ version of the HDF5 Library was built
+ with the thread-safety feature enabled.
+ <ul>
+ <li><a href="../RM/RM_H5.html#Library-IsLibraryThreadsafe">
+ <code>H5is_library_threadsafe</code></a>
+ </ul>
+ </dd>
+
+ <p />
+ <dt>The following flag has been removed:
+ </dt>
+ <dd><code>H5F_ACC_DEBUG</code> flag for
+ <code>H5Fopen/create</code>
+ <font size="1"><br /> <br /></font>
+ The flag <code>H5F_ACC_DEBUG</code> was used to provide
+ extra debugging information for HDF Library developers.
+ This flag and the underlying functionality have been
+ removed from the library due to disuse.
+ The symbol remains defined since it was visible in
+ <code>H5Fpublic.h</code>, but it has been set to
+ zero (<code>0</code>) and has no effect anywhere
+ in the library.
+ <ul>
+ <li><a href="../RM/RM_H5F.html#File-Open">
+ <code>H5Fopen</code></a>
+ </ul>
+ </dd>
+
+ <p>
+ <dt><strong>In the C++ Interface</strong>
+ </dt>
+
+ <dt>The following features have been added:
+ </dt>
+ <dd>
+ <li>New class <code>H5::ObjCreatPropList</code>
+ for the object creation property list class
+ <p />
+ The new class <code>H5::ObjCreatPropList</code>
+ is derived from <code>H5::PropList</code> and
+ is a baseclass of <code>H5::DSetCreatPropList</code>.
+ Additional property list classes will be added to
+ the library in future releases and some of those will
+ be derived from <code>H5::ObjCreatPropList</code>.
+ </li>
+ <li>New wrappers for the C functions
+ <code>H5P[s/g]et_attr_phase_change</code> and
+ <code>H5P[s/g]et_attr_creation_order</code>
+ <p />
+ The following wrappers were added to the class
+ <code>H5::ObjCreatPropList</code>
+ for the respective C functions:
+ <table>
+ <tr><td align="left"><u>C Function</u></th>
+ <td align="left"><u>C++ Wrapper</u></th>
+ </tr>
+ <tr>
+ <td><code>H5Pset_attr_phase_change</code></td>
+ <td><code>H5::ObjCreatPropList::setAttrPhaseChange
+ </code></td>
+ </tr>
+ <tr>
+ <td><code>H5Pget_attr_phase_change</code></td>
+ <td><code>H5::ObjCreatPropList::getAttrPhaseChange
+ </code></td>
+ </tr>
+ <tr>
+ <td><code>H5Pset_attr_creation_order</code></td>
+ <td><code>H5::ObjCreatPropList::setAttrCrtOrder
+ </code></td>
+ </tr>
+ <tr>
+ <td><code>H5Pget_attr_creation_order
+ </code></td>
+ <td><code>H5::ObjCreatPropList::getAttrCrtOrder
+ </code></td>
+ </tr>
+ </table>
+ </li>
+
+ </dd>
+
+ </dl>
+ </dir>
+
+
+ <h3>Library Configuration</h3>
+ <dir>
+ <dl>
+ <p />
+ <dt>Use of thread-safety with the HDF5 High-level Library
+ has been declared unsupported in the build tools:
+ Autotools and CMake.
+ <br />
+ </dt>
+ <dd>The global lock used by the thread-safety mechanism
+ is not raised to the high-level library level,
+ making it possible that the library state could change
+ if a context switch were to occur in a high-level library
+ call. Because of this, the combination of thread-safety
+ and the high-level library is officially unsupported by
+ The HDF Group.
+ <p>
+ Though this combination has never been supported in HDF5,
+ this was not enforced by the build systems.
+ With this release, the combination has been explicitly
+ flagged as unsupported in Autotools and CMake,
+ the build systems used with HDF5.
+ <p>
+ The new unsupported declaration will cause an Autotools
+ configure step to fail if <code>--enable-threadsafe</code>
+ and <code>--enable-hl</code> are combined unless
+ additional options are specified (see below).
+ Since the high-level library is built by default,
+ this means that these extra configuration options will
+ need to be used any time <code>--enable-threadsafe</code>
+ is selected.
+ <p>
+ To use Autotools to build an application with
+ <code>--enable-threadsafe</code>,
+ use one of the following approaches:
+ <ul>
+ <li>Use <code>--disable-hl</code> to disable the
+ high-level library.
+ <i>(Recommended)</i>
+ </li>
+ <li>Use <code>--enable-unsupported</code> to build the
+ high-level library with the thread-safety feature.
+ </li>
+ </ul>
+ <p>
+ To use CMake to build an application with
+ <code>HDF5_ENABLE_THREADSAFE=ON</code>,
+ use one of the following approaches:
+ <ul>
+ <li>Use <code>HDF5_BUILD_HL_LIB=OFF</code>
+ to disable the high-level library.
+ <i>(Recommended)</i>
+ </li>
+ <li>Use <code>HDF5_ALLOW_UNSUPPORTED=ON</code>
+ to build the high-level library with the
+ thread-safety feature.
+ </li>
+ </ul>
+ <p>
+ Since this combination is unsupported, applications
+ using it must be carefully tested for potential
+ thread-safety failures.
+ </dd>
+
+
+ </dl>
+ </dir>
+
+ <h3>Compatibility Report and Comments</h3>
+ <dir>
+ <dl>
+ <dt><strong>Compatibility report for Release 1.8.16 versus
+ Release 1.8.15</strong>
+ </dt>
+ <dd>
+ <a href="Compatibility_Report/CR_1.8.16.html">API
+ compatibility report for the HDF5 Library
+ between 1.8.15 and 1.8.16 versions on
+ x86</a>
+ </dd>
+
+
+
+
+ <p>
+ <dt><strong>Changed shared library interface version
+ number (<code>soname</code>)</strong>
+ </dt>
+ <dd>
+
+ < More detailed description of changes >
+
+ <p>
+ Due to these changes, the shared library interface version
+ number (<code>soname</code>) has been increased.
+ For a full list of the changed symbols, see the
+ interface compatibility report linked immediately above.
+ </dd>
+
+
+<!--
+ <p>
+ <dt><strong>Changed shared library interface version
+ number (<code>soname</code>)</strong>
+ </dt>
+ <dd>In the C++ interface, two overloaded methods
+ have been combined into a single method
+ and one constructor has been deprecated.
+ <p>
+ Due to these changes, the shared library interface version
+ number (<code>soname</code>) has been increased.
+ For a full list of the changed symbols, see the
+ interface compatibility report linked immediately above.
+ </dd>
+-->
+
+ </dl>
+ </dir>
+<!-- END OF 1.8.16 SECTION -->
@@ -8454,7 +8723,7 @@ Release to Release for HDF5 Releases 1.4.0 through 1.6.10</a>”.
<!-- Created: Spring 1999 -->
<!-- hhmts start -->
<hr />
-Last modified: 23 September 2015
+Last modified: 21 March 2016
<!-- hhmts end -->
<br />
<br />
diff --git a/html/HL/RM_H5PT_c++.html b/html/HL/RM_H5PT_c++.html
index ee726bc..8149dd0 100755
--- a/html/HL/RM_H5PT_c++.html
+++ b/html/HL/RM_H5PT_c++.html
@@ -1,454 +1,2266 @@
-<html>
-
-<head>
-<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
-<title> Packet Table C++ Wrapper Reference Manual </title>
-</head>
-
-<body bgcolor="#FFFFFF">
-
-
-<!--
- * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
- * Copyright by The HDF Group. *
- * Copyright by the Board of Trustees of the University of Illinois. *
- * All rights reserved. *
- * *
- * This file is part of HDF5. The full HDF5 copyright notice, including *
- * terms governing use, modification, and redistribution, is contained in *
- * the files COPYING and Copyright.html. COPYING can be found at the root *
- * of the source code distribution tree; Copyright.html can be found at the *
- * root level of an installed copy of the electronic HDF5 document set and *
- * is linked from the top-level documents page. It can also be found at *
- * http://hdfgroup.org/HDF5/doc/Copyright.html. If you do not have *
- * access to either file, you may request a copy from help at hdfgroup.org. *
- * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
- -->
-
-
-
-<!-- HEADER RIGHT " " -->
-<!-- HEADER RIGHT "Packet Table" -->
-
-<a name="TopofRM">
- </a><!-- #BeginLibraryItem "/ed_libs/NavBar_RMHL.lbi" -->
-<hr>
-<center>
-<table border=0 width=98%>
-<tr><td valign=top align=left>
-<a href="../index.html">HDF5 documents and links</a> <br>
-<a href="../H5.intro.html">Introduction to HDF5</a> <br>
-<a href="../UG/HDF5_Users_Guide-Responsive HTML5/index.html">HDF5 User's Guide</a> <br>
-<a href="index.html">Other High-level API documents</a>
-<!--
+<html xmlns:v="urn:schemas-microsoft-com:vml"
+xmlns:o="urn:schemas-microsoft-com:office:office"
+xmlns:w="urn:schemas-microsoft-com:office:word"
+xmlns:m="http://schemas.microsoft.com/office/2004/12/omml"
+xmlns="http://www.w3.org/TR/REC-html40">
+
+<head>
+<meta http-equiv=Content-Type content="text/html; charset=windows-1252">
+<meta name=ProgId content=Word.Document>
+<meta name=Generator content="Microsoft Word 15">
+<meta name=Originator content="Microsoft Word 15">
+<link rel=File-List href="RM_H5PT_c++_files/filelist.xml">
+<link rel=Edit-Time-Data href="RM_H5PT_c++_files/editdata.mso">
+<!--[if !mso]>
+<style>
+v\:* {behavior:url(#default#VML);}
+o\:* {behavior:url(#default#VML);}
+w\:* {behavior:url(#default#VML);}
+.shape {behavior:url(#default#VML);}
+</style>
+<![endif]-->
+<title> Packet Table C++ Wrapper Reference Manual </title>
+<!--[if gte mso 9]><xml>
+ <o:DocumentProperties>
+ <o:Author>bmribler</o:Author>
+ <o:Template>Normal</o:Template>
+ <o:LastAuthor>bmribler</o:LastAuthor>
+ <o:Revision>16</o:Revision>
+ <o:TotalTime>407</o:TotalTime>
+ <o:Created>2016-03-21T19:21:00Z</o:Created>
+ <o:LastSaved>2016-03-24T19:42:00Z</o:LastSaved>
+ <o:Pages>7</o:Pages>
+ <o:Words>1890</o:Words>
+ <o:Characters>10779</o:Characters>
+ <o:Company>Microsoft</o:Company>
+ <o:Lines>89</o:Lines>
+ <o:Paragraphs>25</o:Paragraphs>
+ <o:CharactersWithSpaces>12644</o:CharactersWithSpaces>
+ <o:Version>15.00</o:Version>
+ </o:DocumentProperties>
+ <o:OfficeDocumentSettings>
+ <o:AllowPNG/>
+ </o:OfficeDocumentSettings>
+</xml><![endif]-->
+<link rel=themeData href="RM_H5PT_c++_files/themedata.thmx">
+<link rel=colorSchemeMapping href="RM_H5PT_c++_files/colorschememapping.xml">
+<!--[if gte mso 9]><xml>
+ <w:WordDocument>
+ <w:View>Print</w:View>
+ <w:SpellingState>Clean</w:SpellingState>
+ <w:GrammarState>Clean</w:GrammarState>
+ <w:TrackMoves>false</w:TrackMoves>
+ <w:TrackFormatting/>
+ <w:ValidateAgainstSchemas/>
+ <w:SaveIfXMLInvalid>false</w:SaveIfXMLInvalid>
+ <w:IgnoreMixedContent>false</w:IgnoreMixedContent>
+ <w:AlwaysShowPlaceholderText>false</w:AlwaysShowPlaceholderText>
+ <w:DoNotPromoteQF/>
+ <w:LidThemeOther>EN-US</w:LidThemeOther>
+ <w:LidThemeAsian>X-NONE</w:LidThemeAsian>
+ <w:LidThemeComplexScript>X-NONE</w:LidThemeComplexScript>
+ <w:Compatibility>
+ <w:BreakWrappedTables/>
+ <w:SplitPgBreakAndParaMark/>
+ </w:Compatibility>
+ <w:BrowserLevel>MicrosoftInternetExplorer4</w:BrowserLevel>
+ <m:mathPr>
+ <m:mathFont m:val="Cambria Math"/>
+ <m:brkBin m:val="before"/>
+ <m:brkBinSub m:val="--"/>
+ <m:smallFrac m:val="off"/>
+ <m:dispDef/>
+ <m:lMargin m:val="0"/>
+ <m:rMargin m:val="0"/>
+ <m:defJc m:val="centerGroup"/>
+ <m:wrapIndent m:val="1440"/>
+ <m:intLim m:val="subSup"/>
+ <m:naryLim m:val="undOvr"/>
+ </m:mathPr></w:WordDocument>
+</xml><![endif]--><!--[if gte mso 9]><xml>
+ <w:LatentStyles DefLockedState="false" DefUnhideWhenUsed="false"
+ DefSemiHidden="false" DefQFormat="false" DefPriority="99"
+ LatentStyleCount="371">
+ <w:LsdException Locked="false" Priority="0" QFormat="true" Name="Normal"/>
+ <w:LsdException Locked="false" Priority="9" QFormat="true" Name="heading 1"/>
+ <w:LsdException Locked="false" Priority="9" SemiHidden="true"
+ UnhideWhenUsed="true" QFormat="true" Name="heading 2"/>
+ <w:LsdException Locked="false" Priority="9" SemiHidden="true"
+ UnhideWhenUsed="true" QFormat="true" Name="heading 3"/>
+ <w:LsdException Locked="false" Priority="9" SemiHidden="true"
+ UnhideWhenUsed="true" QFormat="true" Name="heading 4"/>
+ <w:LsdException Locked="false" Priority="9" SemiHidden="true"
+ UnhideWhenUsed="true" QFormat="true" Name="heading 5"/>
+ <w:LsdException Locked="false" Priority="9" SemiHidden="true"
+ UnhideWhenUsed="true" QFormat="true" Name="heading 6"/>
+ <w:LsdException Locked="false" Priority="9" SemiHidden="true"
+ UnhideWhenUsed="true" QFormat="true" Name="heading 7"/>
+ <w:LsdException Locked="false" Priority="9" SemiHidden="true"
+ UnhideWhenUsed="true" QFormat="true" Name="heading 8"/>
+ <w:LsdException Locked="false" Priority="9" SemiHidden="true"
+ UnhideWhenUsed="true" QFormat="true" Name="heading 9"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="index 1"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="index 2"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="index 3"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="index 4"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="index 5"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="index 6"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="index 7"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="index 8"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="index 9"/>
+ <w:LsdException Locked="false" Priority="39" SemiHidden="true"
+ UnhideWhenUsed="true" Name="toc 1"/>
+ <w:LsdException Locked="false" Priority="39" SemiHidden="true"
+ UnhideWhenUsed="true" Name="toc 2"/>
+ <w:LsdException Locked="false" Priority="39" SemiHidden="true"
+ UnhideWhenUsed="true" Name="toc 3"/>
+ <w:LsdException Locked="false" Priority="39" SemiHidden="true"
+ UnhideWhenUsed="true" Name="toc 4"/>
+ <w:LsdException Locked="false" Priority="39" SemiHidden="true"
+ UnhideWhenUsed="true" Name="toc 5"/>
+ <w:LsdException Locked="false" Priority="39" SemiHidden="true"
+ UnhideWhenUsed="true" Name="toc 6"/>
+ <w:LsdException Locked="false" Priority="39" SemiHidden="true"
+ UnhideWhenUsed="true" Name="toc 7"/>
+ <w:LsdException Locked="false" Priority="39" SemiHidden="true"
+ UnhideWhenUsed="true" Name="toc 8"/>
+ <w:LsdException Locked="false" Priority="39" SemiHidden="true"
+ UnhideWhenUsed="true" Name="toc 9"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Normal Indent"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="footnote text"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="annotation text"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="header"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="footer"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="index heading"/>
+ <w:LsdException Locked="false" Priority="35" SemiHidden="true"
+ UnhideWhenUsed="true" QFormat="true" Name="caption"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="table of figures"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="envelope address"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="envelope return"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="footnote reference"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="annotation reference"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="line number"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="page number"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="endnote reference"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="endnote text"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="table of authorities"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="macro"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="toa heading"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="List"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="List Bullet"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="List Number"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="List 2"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="List 3"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="List 4"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="List 5"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="List Bullet 2"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="List Bullet 3"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="List Bullet 4"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="List Bullet 5"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="List Number 2"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="List Number 3"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="List Number 4"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="List Number 5"/>
+ <w:LsdException Locked="false" Priority="10" QFormat="true" Name="Title"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Closing"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Signature"/>
+ <w:LsdException Locked="false" Priority="1" SemiHidden="true"
+ UnhideWhenUsed="true" Name="Default Paragraph Font"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Body Text"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Body Text Indent"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="List Continue"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="List Continue 2"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="List Continue 3"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="List Continue 4"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="List Continue 5"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Message Header"/>
+ <w:LsdException Locked="false" Priority="11" QFormat="true" Name="Subtitle"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Salutation"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Date"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Body Text First Indent"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Body Text First Indent 2"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Note Heading"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Body Text 2"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Body Text 3"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Body Text Indent 2"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Body Text Indent 3"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Block Text"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Hyperlink"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="FollowedHyperlink"/>
+ <w:LsdException Locked="false" Priority="22" QFormat="true" Name="Strong"/>
+ <w:LsdException Locked="false" Priority="20" QFormat="true" Name="Emphasis"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Document Map"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Plain Text"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="E-mail Signature"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="HTML Top of Form"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="HTML Bottom of Form"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Normal (Web)"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="HTML Acronym"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="HTML Address"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="HTML Cite"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="HTML Code"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="HTML Definition"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="HTML Keyboard"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="HTML Preformatted"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="HTML Sample"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="HTML Typewriter"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="HTML Variable"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Normal Table"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="annotation subject"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="No List"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Outline List 1"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Outline List 2"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Outline List 3"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Simple 1"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Simple 2"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Simple 3"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Classic 1"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Classic 2"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Classic 3"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Classic 4"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Colorful 1"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Colorful 2"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Colorful 3"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Columns 1"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Columns 2"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Columns 3"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Columns 4"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Columns 5"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Grid 1"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Grid 2"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Grid 3"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Grid 4"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Grid 5"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Grid 6"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Grid 7"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Grid 8"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table List 1"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table List 2"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table List 3"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table List 4"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table List 5"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table List 6"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table List 7"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table List 8"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table 3D effects 1"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table 3D effects 2"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table 3D effects 3"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Contemporary"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Elegant"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Professional"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Subtle 1"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Subtle 2"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Web 1"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Web 2"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Web 3"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Balloon Text"/>
+ <w:LsdException Locked="false" Priority="39" Name="Table Grid"/>
+ <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true"
+ Name="Table Theme"/>
+ <w:LsdException Locked="false" SemiHidden="true" Name="Placeholder Text"/>
+ <w:LsdException Locked="false" Priority="1" QFormat="true" Name="No Spacing"/>
+ <w:LsdException Locked="false" Priority="60" Name="Light Shading"/>
+ <w:LsdException Locked="false" Priority="61" Name="Light List"/>
+ <w:LsdException Locked="false" Priority="62" Name="Light Grid"/>
+ <w:LsdException Locked="false" Priority="63" Name="Medium Shading 1"/>
+ <w:LsdException Locked="false" Priority="64" Name="Medium Shading 2"/>
+ <w:LsdException Locked="false" Priority="65" Name="Medium List 1"/>
+ <w:LsdException Locked="false" Priority="66" Name="Medium List 2"/>
+ <w:LsdException Locked="false" Priority="67" Name="Medium Grid 1"/>
+ <w:LsdException Locked="false" Priority="68" Name="Medium Grid 2"/>
+ <w:LsdException Locked="false" Priority="69" Name="Medium Grid 3"/>
+ <w:LsdException Locked="false" Priority="70" Name="Dark List"/>
+ <w:LsdException Locked="false" Priority="71" Name="Colorful Shading"/>
+ <w:LsdException Locked="false" Priority="72" Name="Colorful List"/>
+ <w:LsdException Locked="false" Priority="73" Name="Colorful Grid"/>
+ <w:LsdException Locked="false" Priority="60" Name="Light Shading Accent 1"/>
+ <w:LsdException Locked="false" Priority="61" Name="Light List Accent 1"/>
+ <w:LsdException Locked="false" Priority="62" Name="Light Grid Accent 1"/>
+ <w:LsdException Locked="false" Priority="63" Name="Medium Shading 1 Accent 1"/>
+ <w:LsdException Locked="false" Priority="64" Name="Medium Shading 2 Accent 1"/>
+ <w:LsdException Locked="false" Priority="65" Name="Medium List 1 Accent 1"/>
+ <w:LsdException Locked="false" SemiHidden="true" Name="Revision"/>
+ <w:LsdException Locked="false" Priority="34" QFormat="true"
+ Name="List Paragraph"/>
+ <w:LsdException Locked="false" Priority="29" QFormat="true" Name="Quote"/>
+ <w:LsdException Locked="false" Priority="30" QFormat="true"
+ Name="Intense Quote"/>
+ <w:LsdException Locked="false" Priority="66" Name="Medium List 2 Accent 1"/>
+ <w:LsdException Locked="false" Priority="67" Name="Medium Grid 1 Accent 1"/>
+ <w:LsdException Locked="false" Priority="68" Name="Medium Grid 2 Accent 1"/>
+ <w:LsdException Locked="false" Priority="69" Name="Medium Grid 3 Accent 1"/>
+ <w:LsdException Locked="false" Priority="70" Name="Dark List Accent 1"/>
+ <w:LsdException Locked="false" Priority="71" Name="Colorful Shading Accent 1"/>
+ <w:LsdException Locked="false" Priority="72" Name="Colorful List Accent 1"/>
+ <w:LsdException Locked="false" Priority="73" Name="Colorful Grid Accent 1"/>
+ <w:LsdException Locked="false" Priority="60" Name="Light Shading Accent 2"/>
+ <w:LsdException Locked="false" Priority="61" Name="Light List Accent 2"/>
+ <w:LsdException Locked="false" Priority="62" Name="Light Grid Accent 2"/>
+ <w:LsdException Locked="false" Priority="63" Name="Medium Shading 1 Accent 2"/>
+ <w:LsdException Locked="false" Priority="64" Name="Medium Shading 2 Accent 2"/>
+ <w:LsdException Locked="false" Priority="65" Name="Medium List 1 Accent 2"/>
+ <w:LsdException Locked="false" Priority="66" Name="Medium List 2 Accent 2"/>
+ <w:LsdException Locked="false" Priority="67" Name="Medium Grid 1 Accent 2"/>
+ <w:LsdException Locked="false" Priority="68" Name="Medium Grid 2 Accent 2"/>
+ <w:LsdException Locked="false" Priority="69" Name="Medium Grid 3 Accent 2"/>
+ <w:LsdException Locked="false" Priority="70" Name="Dark List Accent 2"/>
+ <w:LsdException Locked="false" Priority="71" Name="Colorful Shading Accent 2"/>
+ <w:LsdException Locked="false" Priority="72" Name="Colorful List Accent 2"/>
+ <w:LsdException Locked="false" Priority="73" Name="Colorful Grid Accent 2"/>
+ <w:LsdException Locked="false" Priority="60" Name="Light Shading Accent 3"/>
+ <w:LsdException Locked="false" Priority="61" Name="Light List Accent 3"/>
+ <w:LsdException Locked="false" Priority="62" Name="Light Grid Accent 3"/>
+ <w:LsdException Locked="false" Priority="63" Name="Medium Shading 1 Accent 3"/>
+ <w:LsdException Locked="false" Priority="64" Name="Medium Shading 2 Accent 3"/>
+ <w:LsdException Locked="false" Priority="65" Name="Medium List 1 Accent 3"/>
+ <w:LsdException Locked="false" Priority="66" Name="Medium List 2 Accent 3"/>
+ <w:LsdException Locked="false" Priority="67" Name="Medium Grid 1 Accent 3"/>
+ <w:LsdException Locked="false" Priority="68" Name="Medium Grid 2 Accent 3"/>
+ <w:LsdException Locked="false" Priority="69" Name="Medium Grid 3 Accent 3"/>
+ <w:LsdException Locked="false" Priority="70" Name="Dark List Accent 3"/>
+ <w:LsdException Locked="false" Priority="71" Name="Colorful Shading Accent 3"/>
+ <w:LsdException Locked="false" Priority="72" Name="Colorful List Accent 3"/>
+ <w:LsdException Locked="false" Priority="73" Name="Colorful Grid Accent 3"/>
+ <w:LsdException Locked="false" Priority="60" Name="Light Shading Accent 4"/>
+ <w:LsdException Locked="false" Priority="61" Name="Light List Accent 4"/>
+ <w:LsdException Locked="false" Priority="62" Name="Light Grid Accent 4"/>
+ <w:LsdException Locked="false" Priority="63" Name="Medium Shading 1 Accent 4"/>
+ <w:LsdException Locked="false" Priority="64" Name="Medium Shading 2 Accent 4"/>
+ <w:LsdException Locked="false" Priority="65" Name="Medium List 1 Accent 4"/>
+ <w:LsdException Locked="false" Priority="66" Name="Medium List 2 Accent 4"/>
+ <w:LsdException Locked="false" Priority="67" Name="Medium Grid 1 Accent 4"/>
+ <w:LsdException Locked="false" Priority="68" Name="Medium Grid 2 Accent 4"/>
+ <w:LsdException Locked="false" Priority="69" Name="Medium Grid 3 Accent 4"/>
+ <w:LsdException Locked="false" Priority="70" Name="Dark List Accent 4"/>
+ <w:LsdException Locked="false" Priority="71" Name="Colorful Shading Accent 4"/>
+ <w:LsdException Locked="false" Priority="72" Name="Colorful List Accent 4"/>
+ <w:LsdException Locked="false" Priority="73" Name="Colorful Grid Accent 4"/>
+ <w:LsdException Locked="false" Priority="60" Name="Light Shading Accent 5"/>
+ <w:LsdException Locked="false" Priority="61" Name="Light List Accent 5"/>
+ <w:LsdException Locked="false" Priority="62" Name="Light Grid Accent 5"/>
+ <w:LsdException Locked="false" Priority="63" Name="Medium Shading 1 Accent 5"/>
+ <w:LsdException Locked="false" Priority="64" Name="Medium Shading 2 Accent 5"/>
+ <w:LsdException Locked="false" Priority="65" Name="Medium List 1 Accent 5"/>
+ <w:LsdException Locked="false" Priority="66" Name="Medium List 2 Accent 5"/>
+ <w:LsdException Locked="false" Priority="67" Name="Medium Grid 1 Accent 5"/>
+ <w:LsdException Locked="false" Priority="68" Name="Medium Grid 2 Accent 5"/>
+ <w:LsdException Locked="false" Priority="69" Name="Medium Grid 3 Accent 5"/>
+ <w:LsdException Locked="false" Priority="70" Name="Dark List Accent 5"/>
+ <w:LsdException Locked="false" Priority="71" Name="Colorful Shading Accent 5"/>
+ <w:LsdException Locked="false" Priority="72" Name="Colorful List Accent 5"/>
+ <w:LsdException Locked="false" Priority="73" Name="Colorful Grid Accent 5"/>
+ <w:LsdException Locked="false" Priority="60" Name="Light Shading Accent 6"/>
+ <w:LsdException Locked="false" Priority="61" Name="Light List Accent 6"/>
+ <w:LsdException Locked="false" Priority="62" Name="Light Grid Accent 6"/>
+ <w:LsdException Locked="false" Priority="63" Name="Medium Shading 1 Accent 6"/>
+ <w:LsdException Locked="false" Priority="64" Name="Medium Shading 2 Accent 6"/>
+ <w:LsdException Locked="false" Priority="65" Name="Medium List 1 Accent 6"/>
+ <w:LsdException Locked="false" Priority="66" Name="Medium List 2 Accent 6"/>
+ <w:LsdException Locked="false" Priority="67" Name="Medium Grid 1 Accent 6"/>
+ <w:LsdException Locked="false" Priority="68" Name="Medium Grid 2 Accent 6"/>
+ <w:LsdException Locked="false" Priority="69" Name="Medium Grid 3 Accent 6"/>
+ <w:LsdException Locked="false" Priority="70" Name="Dark List Accent 6"/>
+ <w:LsdException Locked="false" Priority="71" Name="Colorful Shading Accent 6"/>
+ <w:LsdException Locked="false" Priority="72" Name="Colorful List Accent 6"/>
+ <w:LsdException Locked="false" Priority="73" Name="Colorful Grid Accent 6"/>
+ <w:LsdException Locked="false" Priority="19" QFormat="true"
+ Name="Subtle Emphasis"/>
+ <w:LsdException Locked="false" Priority="21" QFormat="true"
+ Name="Intense Emphasis"/>
+ <w:LsdException Locked="false" Priority="31" QFormat="true"
+ Name="Subtle Reference"/>
+ <w:LsdException Locked="false" Priority="32" QFormat="true"
+ Name="Intense Reference"/>
+ <w:LsdException Locked="false" Priority="33" QFormat="true" Name="Book Title"/>
+ <w:LsdException Locked="false" Priority="37" SemiHidden="true"
+ UnhideWhenUsed="true" Name="Bibliography"/>
+ <w:LsdException Locked="false" Priority="39" SemiHidden="true"
+ UnhideWhenUsed="true" QFormat="true" Name="TOC Heading"/>
+ <w:LsdException Locked="false" Priority="41" Name="Plain Table 1"/>
+ <w:LsdException Locked="false" Priority="42" Name="Plain Table 2"/>
+ <w:LsdException Locked="false" Priority="43" Name="Plain Table 3"/>
+ <w:LsdException Locked="false" Priority="44" Name="Plain Table 4"/>
+ <w:LsdException Locked="false" Priority="45" Name="Plain Table 5"/>
+ <w:LsdException Locked="false" Priority="40" Name="Grid Table Light"/>
+ <w:LsdException Locked="false" Priority="46" Name="Grid Table 1 Light"/>
+ <w:LsdException Locked="false" Priority="47" Name="Grid Table 2"/>
+ <w:LsdException Locked="false" Priority="48" Name="Grid Table 3"/>
+ <w:LsdException Locked="false" Priority="49" Name="Grid Table 4"/>
+ <w:LsdException Locked="false" Priority="50" Name="Grid Table 5 Dark"/>
+ <w:LsdException Locked="false" Priority="51" Name="Grid Table 6 Colorful"/>
+ <w:LsdException Locked="false" Priority="52" Name="Grid Table 7 Colorful"/>
+ <w:LsdException Locked="false" Priority="46"
+ Name="Grid Table 1 Light Accent 1"/>
+ <w:LsdException Locked="false" Priority="47" Name="Grid Table 2 Accent 1"/>
+ <w:LsdException Locked="false" Priority="48" Name="Grid Table 3 Accent 1"/>
+ <w:LsdException Locked="false" Priority="49" Name="Grid Table 4 Accent 1"/>
+ <w:LsdException Locked="false" Priority="50" Name="Grid Table 5 Dark Accent 1"/>
+ <w:LsdException Locked="false" Priority="51"
+ Name="Grid Table 6 Colorful Accent 1"/>
+ <w:LsdException Locked="false" Priority="52"
+ Name="Grid Table 7 Colorful Accent 1"/>
+ <w:LsdException Locked="false" Priority="46"
+ Name="Grid Table 1 Light Accent 2"/>
+ <w:LsdException Locked="false" Priority="47" Name="Grid Table 2 Accent 2"/>
+ <w:LsdException Locked="false" Priority="48" Name="Grid Table 3 Accent 2"/>
+ <w:LsdException Locked="false" Priority="49" Name="Grid Table 4 Accent 2"/>
+ <w:LsdException Locked="false" Priority="50" Name="Grid Table 5 Dark Accent 2"/>
+ <w:LsdException Locked="false" Priority="51"
+ Name="Grid Table 6 Colorful Accent 2"/>
+ <w:LsdException Locked="false" Priority="52"
+ Name="Grid Table 7 Colorful Accent 2"/>
+ <w:LsdException Locked="false" Priority="46"
+ Name="Grid Table 1 Light Accent 3"/>
+ <w:LsdException Locked="false" Priority="47" Name="Grid Table 2 Accent 3"/>
+ <w:LsdException Locked="false" Priority="48" Name="Grid Table 3 Accent 3"/>
+ <w:LsdException Locked="false" Priority="49" Name="Grid Table 4 Accent 3"/>
+ <w:LsdException Locked="false" Priority="50" Name="Grid Table 5 Dark Accent 3"/>
+ <w:LsdException Locked="false" Priority="51"
+ Name="Grid Table 6 Colorful Accent 3"/>
+ <w:LsdException Locked="false" Priority="52"
+ Name="Grid Table 7 Colorful Accent 3"/>
+ <w:LsdException Locked="false" Priority="46"
+ Name="Grid Table 1 Light Accent 4"/>
+ <w:LsdException Locked="false" Priority="47" Name="Grid Table 2 Accent 4"/>
+ <w:LsdException Locked="false" Priority="48" Name="Grid Table 3 Accent 4"/>
+ <w:LsdException Locked="false" Priority="49" Name="Grid Table 4 Accent 4"/>
+ <w:LsdException Locked="false" Priority="50" Name="Grid Table 5 Dark Accent 4"/>
+ <w:LsdException Locked="false" Priority="51"
+ Name="Grid Table 6 Colorful Accent 4"/>
+ <w:LsdException Locked="false" Priority="52"
+ Name="Grid Table 7 Colorful Accent 4"/>
+ <w:LsdException Locked="false" Priority="46"
+ Name="Grid Table 1 Light Accent 5"/>
+ <w:LsdException Locked="false" Priority="47" Name="Grid Table 2 Accent 5"/>
+ <w:LsdException Locked="false" Priority="48" Name="Grid Table 3 Accent 5"/>
+ <w:LsdException Locked="false" Priority="49" Name="Grid Table 4 Accent 5"/>
+ <w:LsdException Locked="false" Priority="50" Name="Grid Table 5 Dark Accent 5"/>
+ <w:LsdException Locked="false" Priority="51"
+ Name="Grid Table 6 Colorful Accent 5"/>
+ <w:LsdException Locked="false" Priority="52"
+ Name="Grid Table 7 Colorful Accent 5"/>
+ <w:LsdException Locked="false" Priority="46"
+ Name="Grid Table 1 Light Accent 6"/>
+ <w:LsdException Locked="false" Priority="47" Name="Grid Table 2 Accent 6"/>
+ <w:LsdException Locked="false" Priority="48" Name="Grid Table 3 Accent 6"/>
+ <w:LsdException Locked="false" Priority="49" Name="Grid Table 4 Accent 6"/>
+ <w:LsdException Locked="false" Priority="50" Name="Grid Table 5 Dark Accent 6"/>
+ <w:LsdException Locked="false" Priority="51"
+ Name="Grid Table 6 Colorful Accent 6"/>
+ <w:LsdException Locked="false" Priority="52"
+ Name="Grid Table 7 Colorful Accent 6"/>
+ <w:LsdException Locked="false" Priority="46" Name="List Table 1 Light"/>
+ <w:LsdException Locked="false" Priority="47" Name="List Table 2"/>
+ <w:LsdException Locked="false" Priority="48" Name="List Table 3"/>
+ <w:LsdException Locked="false" Priority="49" Name="List Table 4"/>
+ <w:LsdException Locked="false" Priority="50" Name="List Table 5 Dark"/>
+ <w:LsdException Locked="false" Priority="51" Name="List Table 6 Colorful"/>
+ <w:LsdException Locked="false" Priority="52" Name="List Table 7 Colorful"/>
+ <w:LsdException Locked="false" Priority="46"
+ Name="List Table 1 Light Accent 1"/>
+ <w:LsdException Locked="false" Priority="47" Name="List Table 2 Accent 1"/>
+ <w:LsdException Locked="false" Priority="48" Name="List Table 3 Accent 1"/>
+ <w:LsdException Locked="false" Priority="49" Name="List Table 4 Accent 1"/>
+ <w:LsdException Locked="false" Priority="50" Name="List Table 5 Dark Accent 1"/>
+ <w:LsdException Locked="false" Priority="51"
+ Name="List Table 6 Colorful Accent 1"/>
+ <w:LsdException Locked="false" Priority="52"
+ Name="List Table 7 Colorful Accent 1"/>
+ <w:LsdException Locked="false" Priority="46"
+ Name="List Table 1 Light Accent 2"/>
+ <w:LsdException Locked="false" Priority="47" Name="List Table 2 Accent 2"/>
+ <w:LsdException Locked="false" Priority="48" Name="List Table 3 Accent 2"/>
+ <w:LsdException Locked="false" Priority="49" Name="List Table 4 Accent 2"/>
+ <w:LsdException Locked="false" Priority="50" Name="List Table 5 Dark Accent 2"/>
+ <w:LsdException Locked="false" Priority="51"
+ Name="List Table 6 Colorful Accent 2"/>
+ <w:LsdException Locked="false" Priority="52"
+ Name="List Table 7 Colorful Accent 2"/>
+ <w:LsdException Locked="false" Priority="46"
+ Name="List Table 1 Light Accent 3"/>
+ <w:LsdException Locked="false" Priority="47" Name="List Table 2 Accent 3"/>
+ <w:LsdException Locked="false" Priority="48" Name="List Table 3 Accent 3"/>
+ <w:LsdException Locked="false" Priority="49" Name="List Table 4 Accent 3"/>
+ <w:LsdException Locked="false" Priority="50" Name="List Table 5 Dark Accent 3"/>
+ <w:LsdException Locked="false" Priority="51"
+ Name="List Table 6 Colorful Accent 3"/>
+ <w:LsdException Locked="false" Priority="52"
+ Name="List Table 7 Colorful Accent 3"/>
+ <w:LsdException Locked="false" Priority="46"
+ Name="List Table 1 Light Accent 4"/>
+ <w:LsdException Locked="false" Priority="47" Name="List Table 2 Accent 4"/>
+ <w:LsdException Locked="false" Priority="48" Name="List Table 3 Accent 4"/>
+ <w:LsdException Locked="false" Priority="49" Name="List Table 4 Accent 4"/>
+ <w:LsdException Locked="false" Priority="50" Name="List Table 5 Dark Accent 4"/>
+ <w:LsdException Locked="false" Priority="51"
+ Name="List Table 6 Colorful Accent 4"/>
+ <w:LsdException Locked="false" Priority="52"
+ Name="List Table 7 Colorful Accent 4"/>
+ <w:LsdException Locked="false" Priority="46"
+ Name="List Table 1 Light Accent 5"/>
+ <w:LsdException Locked="false" Priority="47" Name="List Table 2 Accent 5"/>
+ <w:LsdException Locked="false" Priority="48" Name="List Table 3 Accent 5"/>
+ <w:LsdException Locked="false" Priority="49" Name="List Table 4 Accent 5"/>
+ <w:LsdException Locked="false" Priority="50" Name="List Table 5 Dark Accent 5"/>
+ <w:LsdException Locked="false" Priority="51"
+ Name="List Table 6 Colorful Accent 5"/>
+ <w:LsdException Locked="false" Priority="52"
+ Name="List Table 7 Colorful Accent 5"/>
+ <w:LsdException Locked="false" Priority="46"
+ Name="List Table 1 Light Accent 6"/>
+ <w:LsdException Locked="false" Priority="47" Name="List Table 2 Accent 6"/>
+ <w:LsdException Locked="false" Priority="48" Name="List Table 3 Accent 6"/>
+ <w:LsdException Locked="false" Priority="49" Name="List Table 4 Accent 6"/>
+ <w:LsdException Locked="false" Priority="50" Name="List Table 5 Dark Accent 6"/>
+ <w:LsdException Locked="false" Priority="51"
+ Name="List Table 6 Colorful Accent 6"/>
+ <w:LsdException Locked="false" Priority="52"
+ Name="List Table 7 Colorful Accent 6"/>
+ </w:LatentStyles>
+</xml><![endif]-->
+<style>
+<!--
+ /* Font Definitions */
+ @font-face
+ {font-family:Wingdings;
+ panose-1:5 0 0 0 0 0 0 0 0 0;
+ mso-font-charset:2;
+ mso-generic-font-family:auto;
+ mso-font-pitch:variable;
+ mso-font-signature:0 268435456 0 0 -2147483648 0;}
+ at font-face
+ {font-family:Wingdings;
+ panose-1:5 0 0 0 0 0 0 0 0 0;
+ mso-font-charset:2;
+ mso-generic-font-family:auto;
+ mso-font-pitch:variable;
+ mso-font-signature:0 268435456 0 0 -2147483648 0;}
+ /* Style Definitions */
+ p.MsoNormal, li.MsoNormal, div.MsoNormal
+ {mso-style-unhide:no;
+ mso-style-qformat:yes;
+ mso-style-parent:"";
+ margin:0in;
+ margin-bottom:.0001pt;
+ mso-pagination:widow-orphan;
+ font-size:12.0pt;
+ font-family:"Times New Roman",serif;
+ mso-fareast-font-family:"Times New Roman";
+ mso-fareast-theme-font:minor-fareast;}
+h1
+ {mso-style-priority:9;
+ mso-style-unhide:no;
+ mso-style-qformat:yes;
+ mso-style-link:"Heading 1 Char";
+ mso-margin-top-alt:auto;
+ margin-right:0in;
+ mso-margin-bottom-alt:auto;
+ margin-left:0in;
+ mso-pagination:widow-orphan;
+ mso-outline-level:1;
+ font-size:24.0pt;
+ font-family:"Times New Roman",serif;
+ mso-fareast-font-family:"Times New Roman";
+ mso-fareast-theme-font:minor-fareast;
+ font-weight:bold;}
+a:link, span.MsoHyperlink
+ {mso-style-noshow:yes;
+ mso-style-priority:99;
+ color:blue;
+ text-decoration:underline;
+ text-underline:single;}
+a:visited, span.MsoHyperlinkFollowed
+ {mso-style-noshow:yes;
+ mso-style-priority:99;
+ color:purple;
+ text-decoration:underline;
+ text-underline:single;}
+p
+ {mso-style-noshow:yes;
+ mso-style-priority:99;
+ mso-margin-top-alt:auto;
+ margin-right:0in;
+ mso-margin-bottom-alt:auto;
+ margin-left:0in;
+ mso-pagination:widow-orphan;
+ font-size:12.0pt;
+ font-family:"Times New Roman",serif;
+ mso-fareast-font-family:"Times New Roman";
+ mso-fareast-theme-font:minor-fareast;}
+code
+ {mso-style-noshow:yes;
+ mso-style-priority:99;
+ font-family:"Courier New";
+ mso-ascii-font-family:"Courier New";
+ mso-fareast-font-family:"Times New Roman";
+ mso-fareast-theme-font:minor-fareast;
+ mso-hansi-font-family:"Courier New";
+ mso-bidi-font-family:"Courier New";}
+p.MsoNoSpacing, li.MsoNoSpacing, div.MsoNoSpacing
+ {mso-style-noshow:yes;
+ mso-style-priority:1;
+ mso-style-unhide:no;
+ mso-style-qformat:yes;
+ mso-style-parent:"";
+ margin:0in;
+ margin-bottom:.0001pt;
+ mso-pagination:widow-orphan;
+ font-size:12.0pt;
+ font-family:"Times New Roman",serif;
+ mso-fareast-font-family:"Times New Roman";
+ mso-fareast-theme-font:minor-fareast;}
+span.Heading1Char
+ {mso-style-name:"Heading 1 Char";
+ mso-style-priority:9;
+ mso-style-unhide:no;
+ mso-style-locked:yes;
+ mso-style-link:"Heading 1";
+ mso-ansi-font-size:16.0pt;
+ mso-bidi-font-size:16.0pt;
+ font-family:"Calibri Light",sans-serif;
+ mso-ascii-font-family:"Calibri Light";
+ mso-ascii-theme-font:major-latin;
+ mso-fareast-font-family:"Times New Roman";
+ mso-fareast-theme-font:major-fareast;
+ mso-hansi-font-family:"Calibri Light";
+ mso-hansi-theme-font:major-latin;
+ mso-bidi-font-family:"Times New Roman";
+ mso-bidi-theme-font:major-bidi;
+ color:#2E74B5;
+ mso-themecolor:accent1;
+ mso-themeshade:191;}
+span.varconstfunc
+ {mso-style-name:var_const_func;
+ mso-style-priority:1;
+ mso-style-unhide:no;
+ mso-style-qformat:yes;
+ mso-ansi-font-size:10.0pt;
+ font-family:"Courier New";
+ mso-ascii-font-family:"Courier New";
+ mso-hansi-font-family:"Courier New";
+ mso-bidi-font-family:"Courier New";}
+span.SpellE
+ {mso-style-name:"";
+ mso-spl-e:yes;}
+span.GramE
+ {mso-style-name:"";
+ mso-gram-e:yes;}
+.MsoChpDefault
+ {mso-style-type:export-only;
+ mso-default-props:yes;
+ font-size:10.0pt;
+ mso-ansi-font-size:10.0pt;
+ mso-bidi-font-size:10.0pt;}
+ at page WordSection1
+ {size:8.5in 11.0in;
+ margin:1.0in 1.0in 1.0in 1.0in;
+ mso-header-margin:.5in;
+ mso-footer-margin:.5in;
+ mso-paper-source:0;}
+div.WordSection1
+ {page:WordSection1;}
+ /* List Definitions */
+ @list l0
+ {mso-list-id:196623608;
+ mso-list-template-ids:1196204752;}
+ at list l0:level1
+ {mso-level-number-format:bullet;
+ mso-level-text:\F0B7;
+ mso-level-tab-stop:.5in;
+ mso-level-number-position:left;
+ text-indent:-.25in;
+ mso-ansi-font-size:10.0pt;
+ font-family:Symbol;}
+ at list l0:level2
+ {mso-level-number-format:bullet;
+ mso-level-text:o;
+ mso-level-tab-stop:1.0in;
+ mso-level-number-position:left;
+ text-indent:-.25in;
+ mso-ansi-font-size:10.0pt;
+ font-family:"Courier New";
+ mso-bidi-font-family:"Times New Roman";}
+ at list l0:level3
+ {mso-level-number-format:bullet;
+ mso-level-text:\F0A7;
+ mso-level-tab-stop:1.5in;
+ mso-level-number-position:left;
+ text-indent:-.25in;
+ mso-ansi-font-size:10.0pt;
+ font-family:Wingdings;}
+ at list l0:level4
+ {mso-level-number-format:bullet;
+ mso-level-text:\F0A7;
+ mso-level-tab-stop:2.0in;
+ mso-level-number-position:left;
+ text-indent:-.25in;
+ mso-ansi-font-size:10.0pt;
+ font-family:Wingdings;}
+ at list l0:level5
+ {mso-level-number-format:bullet;
+ mso-level-text:\F0A7;
+ mso-level-tab-stop:2.5in;
+ mso-level-number-position:left;
+ text-indent:-.25in;
+ mso-ansi-font-size:10.0pt;
+ font-family:Wingdings;}
+ at list l0:level6
+ {mso-level-number-format:bullet;
+ mso-level-text:\F0A7;
+ mso-level-tab-stop:3.0in;
+ mso-level-number-position:left;
+ text-indent:-.25in;
+ mso-ansi-font-size:10.0pt;
+ font-family:Wingdings;}
+ at list l0:level7
+ {mso-level-number-format:bullet;
+ mso-level-text:\F0A7;
+ mso-level-tab-stop:3.5in;
+ mso-level-number-position:left;
+ text-indent:-.25in;
+ mso-ansi-font-size:10.0pt;
+ font-family:Wingdings;}
+ at list l0:level8
+ {mso-level-number-format:bullet;
+ mso-level-text:\F0A7;
+ mso-level-tab-stop:4.0in;
+ mso-level-number-position:left;
+ text-indent:-.25in;
+ mso-ansi-font-size:10.0pt;
+ font-family:Wingdings;}
+ at list l0:level9
+ {mso-level-number-format:bullet;
+ mso-level-text:\F0A7;
+ mso-level-tab-stop:4.5in;
+ mso-level-number-position:left;
+ text-indent:-.25in;
+ mso-ansi-font-size:10.0pt;
+ font-family:Wingdings;}
+ at list l1
+ {mso-list-id:1383558690;
+ mso-list-template-ids:-1773767842;}
+ at list l1:level1
+ {mso-level-number-format:bullet;
+ mso-level-text:\F0B7;
+ mso-level-tab-stop:.5in;
+ mso-level-number-position:left;
+ text-indent:-.25in;
+ mso-ansi-font-size:10.0pt;
+ font-family:Symbol;}
+ at list l1:level2
+ {mso-level-number-format:bullet;
+ mso-level-text:\F0B7;
+ mso-level-tab-stop:1.0in;
+ mso-level-number-position:left;
+ text-indent:-.25in;
+ mso-ansi-font-size:10.0pt;
+ font-family:Symbol;}
+ at list l1:level3
+ {mso-level-number-format:bullet;
+ mso-level-text:\F0B7;
+ mso-level-tab-stop:1.5in;
+ mso-level-number-position:left;
+ text-indent:-.25in;
+ mso-ansi-font-size:10.0pt;
+ font-family:Symbol;}
+ at list l1:level4
+ {mso-level-number-format:bullet;
+ mso-level-text:\F0B7;
+ mso-level-tab-stop:2.0in;
+ mso-level-number-position:left;
+ text-indent:-.25in;
+ mso-ansi-font-size:10.0pt;
+ font-family:Symbol;}
+ at list l1:level5
+ {mso-level-number-format:bullet;
+ mso-level-text:\F0B7;
+ mso-level-tab-stop:2.5in;
+ mso-level-number-position:left;
+ text-indent:-.25in;
+ mso-ansi-font-size:10.0pt;
+ font-family:Symbol;}
+ at list l1:level6
+ {mso-level-number-format:bullet;
+ mso-level-text:\F0B7;
+ mso-level-tab-stop:3.0in;
+ mso-level-number-position:left;
+ text-indent:-.25in;
+ mso-ansi-font-size:10.0pt;
+ font-family:Symbol;}
+ at list l1:level7
+ {mso-level-number-format:bullet;
+ mso-level-text:\F0B7;
+ mso-level-tab-stop:3.5in;
+ mso-level-number-position:left;
+ text-indent:-.25in;
+ mso-ansi-font-size:10.0pt;
+ font-family:Symbol;}
+ at list l1:level8
+ {mso-level-number-format:bullet;
+ mso-level-text:\F0B7;
+ mso-level-tab-stop:4.0in;
+ mso-level-number-position:left;
+ text-indent:-.25in;
+ mso-ansi-font-size:10.0pt;
+ font-family:Symbol;}
+ at list l1:level9
+ {mso-level-number-format:bullet;
+ mso-level-text:\F0B7;
+ mso-level-tab-stop:4.5in;
+ mso-level-number-position:left;
+ text-indent:-.25in;
+ mso-ansi-font-size:10.0pt;
+ font-family:Symbol;}
+ol
+ {margin-bottom:0in;}
+ul
+ {margin-bottom:0in;}
+-->
+</style>
+<!--[if gte mso 10]>
+<style>
+ /* Style Definitions */
+ table.MsoNormalTable
+ {mso-style-name:"Table Normal";
+ mso-tstyle-rowband-size:0;
+ mso-tstyle-colband-size:0;
+ mso-style-noshow:yes;
+ mso-style-priority:99;
+ mso-style-parent:"";
+ mso-padding-alt:0in 5.4pt 0in 5.4pt;
+ mso-para-margin:0in;
+ mso-para-margin-bottom:.0001pt;
+ mso-pagination:widow-orphan;
+ font-size:10.0pt;
+ font-family:"Times New Roman",serif;}
+</style>
+<![endif]--><!--[if gte mso 9]><xml>
+ <o:shapedefaults v:ext="edit" spidmax="1026"/>
+</xml><![endif]--><!--[if gte mso 9]><xml>
+ <o:shapelayout v:ext="edit">
+ <o:idmap v:ext="edit" data="1"/>
+ </o:shapelayout></xml><![endif]-->
+</head>
+
+<body bgcolor=white lang=EN-US link=blue vlink=purple style='tab-interval:.5in'>
+
+<div class=WordSection1>
+
+<p class=MsoNormal><a name=TopofRM><span style='mso-fareast-font-family:"Times New Roman"'> </span></a><span
+style='mso-fareast-font-family:"Times New Roman"'><!-- #BeginLibraryItem "/ed_libs/NavBar_RMHL.lbi" -->
+<o:p></o:p></span></p>
+
+<div class=MsoNormal align=center style='text-align:center'><span
+style='mso-fareast-font-family:"Times New Roman"'>
+
+<hr size=3 width="100%" align=center>
+
+</span></div>
+
+<div align=center>
+
+<table class=MsoNormalTable border=0 cellspacing=3 cellpadding=0 width="98%"
+ style='width:98.0%;mso-cellspacing:1.5pt;mso-yfti-tbllook:1184;mso-padding-alt:
+ 0in 5.4pt 0in 5.4pt'>
+ <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes'>
+ <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
+ <p class=MsoNormal><span style='mso-fareast-font-family:"Times New Roman"'><a
+ href="../index.html">HDF5 documents and links</a> <br>
+ <a href="../H5.intro.html">Introduction to HDF5</a> <br>
+ <a href="../UG/HDF5_Users_Guide-Responsive%20HTML5/index.html"><span
+ class=SpellE>HDF5</span> User's Guide</a> <br>
+ <a href="index.html">Other High-level API documents</a> <o:p></o:p></span></p>
+ </td>
+ <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
+ <p class=MsoNormal align=right style='text-align:right'><span
+ style='mso-fareast-font-family:"Times New Roman"'><!--
<a href="Glossary.html">Glossary</a><br>
--->
-</td>
-<td valign=top align=right>
-In the
-<a href="../RM/RM_H5Front.html">HDF5 Reference Manual</a>
-<font size=-1>
-<br>
-<a href="RM_H5DS.html">H5DS</a>
-<a href="RM_H5IM.html">H5IM</a>
-<a href="RM_H5LT.html">H5LT</a>
-<a href="RM_H5PT.html">H5PT</a>
-<a href="RM_H5TB.html">H5TB</a>
-<a href="RM_HDF5Optimized.html">Optimized</a>
-<br>
-<a href="../RM/RM_H5.html">H5</a>
-<a href="../RM/RM_H5A.html">H5A</a>
-<a href="../RM/RM_H5D.html">H5D</a>
-<a href="../RM/RM_H5E.html">H5E</a>
-<a href="../RM/RM_H5F.html">H5F</a>
-<a href="../RM/RM_H5G.html">H5G</a>
-<a href="../RM/RM_H5I.html">H5I</a>
-<br>
-<a href="../RM/RM_H5L.html">H5L</a>
-<a href="../RM/RM_H5O.html">H5O</a>
-<a href="../RM/RM_H5P.html">H5P</a>
-<a href="../RM/RM_H5R.html">H5R</a>
-<a href="../RM/RM_H5S.html">H5S</a>
-<a href="../RM/RM_H5T.html">H5T</a>
-<a href="../RM/RM_H5Z.html">H5Z</a>
-<br>
-<a href="../RM/Tools.html">Tools</a>
-<a href="../RM/PredefDTypes.html">Datatypes</a>
-<a href="../fortran/index.html">Fortran</a>
-</font>
-</td></tr>
-</table>
-</center>
-<hr>
-<!-- #EndLibraryItem --><h1 align="center">H5PT: HDF5 Packet Table<br>C++ Wrappers</h1>
-
-<!--
+-->In
+ the <a href="../RM/RM_H5Front.html">HDF5 Reference Manual</a> </span><span
+ style='font-size:10.0pt;mso-fareast-font-family:"Times New Roman"'><br>
+ <a href="RM_H5DS.html">H5DS</a> <a href="RM_H5IM.html">H5IM</a>
+ <a href="RM_H5LT.html">H5LT</a> <a href="RM_H5PT.html">H5PT</a>
+ <a href="RM_H5TB.html">H5TB</a> <a href="RM_HDF5Optimized.html">Optimized</a>
+ <br>
+ <a href="../RM/RM_H5.html">H5</a> <a href="../RM/RM_H5A.html">H5A</a>
+ <a href="../RM/RM_H5D.html">H5D</a> <a href="../RM/RM_H5E.html">H5E</a>
+ <a href="../RM/RM_H5F.html">H5F</a> <a href="../RM/RM_H5G.html">H5G</a>
+ <a href="../RM/RM_H5I.html">H5I</a> <br>
+ <a href="../RM/RM_H5L.html">H5L</a> <a href="../RM/RM_H5O.html">H5O</a>
+ <a href="../RM/RM_H5P.html">H5P</a> <a href="../RM/RM_H5R.html">H5R</a>
+ <a href="../RM/RM_H5S.html">H5S</a> <a href="../RM/RM_H5T.html">H5T</a>
+ <a href="../RM/RM_H5Z.html">H5Z</a> <br>
+ <a href="../RM/Tools.html">Tools</a> <a
+ href="../RM/PredefDTypes.html">Datatypes</a> <a
+ href="../fortran/index.html">Fortran</a> </span><span
+ style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+ </td>
+ </tr>
+</table>
+
+</div>
+
+<div class=MsoNormal align=center style='text-align:center'><span
+style='mso-fareast-font-family:"Times New Roman"'>
+
+<hr size=3 width="100%" align=center>
+
+</span></div>
+
+<h1 align=center style='text-align:center'><span style='mso-fareast-font-family:
+"Times New Roman"'><!-- #EndLibraryItem -->H5PT: HDF5 Packet Table<br>
+C++ Wrappers<o:p></o:p></span></h1>
+
+<p class=MsoNormal><span style='mso-fareast-font-family:"Times New Roman"'><br>
+<strong><!--
<h2>Draft</h2>
--->
-
-<br>
-<strong>Classes:</strong>
-
-<ul>
-<li><strong>PacketTable</strong> - functions shared by all packet tables
-<li><strong>FL_PacketTable</strong> - a packet table storing fixed-length packets
-</ul>
-
- <strong>Functions</strong> (none are static; all must be called on an object):
-
- <br><br> <hr><strong>Packet Table:</strong> <hr>
-
- <dl>
- <dt style="background-color: #CCCCFF"><strong>Name:</strong>
- Null Constructor
- <dt><strong>Signature:</strong></dt>
- <dd>PacketTable( )</dd>
- <dt><strong>Purpose:</strong></dt>
- <dd>Creates an invalid packet table object.</dd>
- <dt><strong>Description:</strong></dt>
- <dd>The object created with this call will return false if IsValid() is
- called on it. To create a valid packet table, use the
- FL_Packet_Table constructors.
- This function does not make any change to the underlying HDF5 file.
- </dd>
- </dl>
- <hr>
-
- <dl>
- <dt style="background-color: #CCCCFF"><strong>Name:</strong>
- "Open" Constructor
- <dt><strong>Signature:</strong></dt>
- <dd>PacketTable(hid_t fileID, char* name)</dd>
- <dt><strong>Purpose:</strong></dt>
- <dd>Opens an existing packet table.</dd>
- <dt><strong>Description:</strong></dt>
- <dd>Opens an existing packet table, which can contain either fixed-length
- or variable-length packets.</dd>
- <dt><strong>Parameters:</strong></dt>
- <dl>
- <dt>hid_t fileID</dt>
- <dd>IN: file or group in which the packet table is located</dd>
- <dt>char* name</dt>
- <dd>IN: the packet table's name</dd>
- </dl>
- </dl>
-
-<!-- NEW PAGE -->
- <hr>
- <dl>
- <dt style="background-color: #CCCCFF"><strong>Name:</strong>
- Destructor
- <dt><strong>Signature:</strong></dt>
- <dd>~PacketTable()</dd>
- <dt><strong>Description:</strong></dt>
- <dd>The destructor closes the packet table in the file, so a packet
- table created or opened with the C++ wrapper does not
- need to be closed manually.</dd>
- </dl>
- <hr>
-
- <dl>
- <dt style="background-color: #CCCCFF"><strong>Name:</strong> IsValid
- <dt><strong>Signature:</strong></dt>
- <dd>bool IsValid()</dd>
- <dt><strong>Purpose:</strong></dt>
- <dd>Determines if this is an valid packet table.</dd>
- <dt><strong>Description:</strong></dt>
- <dd>This function is used to ensure that a PacketTable object
- corresponds to an open packet table in the file. It should be
- called after the constructor to check that there were no errors
- creating or opening the packet table.</dd>
- <dt><strong>Returns:</strong></dt>
- <dd>Returns true if this is an open packet table, false otherwise.</dd>
- </dl>
- <hr>
-
- <dl>
- <dt style="background-color: #CCCCFF"><strong>Name:</strong> ResetIndex
- <dt><strong>Signature:</strong></dt>
- <dd>void ResetIndex()</dd>
- <dt><strong>Purpose:</strong></dt>
- <dd>Resets the packet table's index to point to the first packet.</dd>
- <dt><strong>Description:</strong></dt>
- <dd>A packet table keeps track of the user's current location in the table
- so that the user can iterate through packets. This function should be
- called before using GetNextPacket.</dd>
- </dl>
-
-<!-- NEW PAGE -->
- <hr>
- <dl>
- <dt style="background-color: #CCCCFF"><strong>Name:</strong> SetIndex
- <dt><strong>Signature:</strong></dt>
- <dd>int SetIndex(hsize_t index);</dd>
- <dt><strong>Purpose:</strong></dt>
- <dd>Sets a packet table's current index.</dd>
- <dt><strong>Description:</strong></dt>
- <dd>This function allows the user to begin iterating through packets
- starting from any arbitrary index. Packet tables are zero-indexed,
- so packet 0 is the first packet.</dd>
- <dt><strong>Parameters:</strong></dt>
- <dl>
- <dt>hsize_t index</dt>
- <dd>IN: The value to which the packet table's index should be set</dd>
- </dl>
- <dt><strong>Returns:</strong></dt>
- <dd>Returns non-negative on success, negative on error.</dd>
- </dl>
- <hr>
-
- <hr>
- <dl>
- <dt style="background-color: #CCCCFF"><strong>Name:</strong> GetIndex
- <dt><strong>Signature:</strong></dt>
- <dd>hsize_t GetIndex(int& error);</dd>
- <dt><strong>Purpose:</strong></dt>
- <dd>Returns the position of the current packet.</dd>
- <dt><strong>Description:</strong></dt>
- <dd>This function allows the user to determine the position
- of the current packet.
- <p>
- If <code>GetIndex</code> returns <code>0</code> (zero),
- you must then check the value of the parameter <code>error</code>.
- If <code>error</code> is negative, <code>GetIndex</code> has failed;
- if <code>error</code> is <code>0</code> (zero), the position of
- the current packet is <code>0</code> (zero).
- </dd>
- <dt><strong>Parameters:</strong></dt>
- <dl>
- <dt>int& error (optional)</dt>
- <dd>OUT: Non-negative if index was successfully retrieved,
- negative on failure.</dd>
- </dl>
- <dt><strong>Returns:</strong></dt>
- <dd>Returns the position of the current packet on success,
- 0 (zero) on error.</dd>
- </dl>
- <hr>
-
- <dl>
- <dt style="background-color: #CCCCFF"><strong>Name:</strong> GetPacketCount
- <dt><strong>Signatures:</strong></dt>
- <dd>hsize_t GetPacketCount()</dd>
- <dd>hsize_t GetPacketCount(int& error)</dd>
- <dt><strong>Purpose:</strong></dt>
- <dd>Retrieves the number of packets in the packet table.</dd>
- <dt><strong>Description:</strong></dt>
- <dd>This function is overloaded so that it can be called with or
- without returning an error value. If <code>error</code> is not
- supplied, any error value is ignored. Using this parameter allows
- the user to distinguish between an open packet table with 0
- packets and an invalid packet table.</dd>
- <dt><strong>Parameters:</strong></dt>
- <dl>
- <dt>int& error (optional)</dt>
- <dd>OUT: Non-negative if packet count was successfully retrieved,
- negative if packet table is invalid.</dd>
- </dl>
- <dt><strong>Returns:</strong></dt>
- <dd>Number of packets in packet table. Returns 0 if packet table
- contains zero packets or on error.</dd>
- </dl>
-
-<!-- NEW PAGE -->
-<!-- HEADER RIGHT "FL_Packet_Table" -->
- <hr>
-<strong>FL_Packet_Table:</strong><hr>
-
- <dl>
- <dt style="background-color: #CCCCFF"><strong>Name:</strong> "Create" Constructor
- <dt><strong>Signature:</strong></dt>
- <dd>FL_PacketTable(hid_t fileID, char* name, hid_t dtypeID, int chunkSize, int compression)</dd>
- <dt><strong>Purpose:</strong></dt>
- <dd>Creates a new packet table for storing fixed-length packets.</dd>
- <dt><strong>Description:</strong></dt>
- <dd>This constructor creates and opens a packet table in the file
- specified by <code>fileID</code> named <code>name</code>. Packets
- will be of the datatype specified by <code>dtypeID</code>.</dd>
- <dt><strong>Parameters:</strong></dt>
- <dl>
- <dt>hid_t fileID</dt>
- <dd>IN: Identifier of the file or group to create the table within.</dd>
- <dt>const char * dset_name</dt>
- <dd>IN: The name of the packet table to create.</dd>
- <dt>hid_t dtype_id</dt>
- <dd>IN: The datatype of a packet.</dd>
- <dt>hsize_t chunkSize</dt>
- <dd>IN: The packet table uses HDF5 chunked storage to allow it to grow.
- This value allows the user to set the size of a chunk.
- The chunk size affects performance.</dd>
- <dt>int compression</dt>
- <dd>IN: Desired compression level: <code>0</code> (zero) through
- <code>9,</code> or <code>-1</code> for no compression.</dd>
- </dl>
- </dl>
- <hr>
-
- <dl>
- <dt style="background-color: #CCCCFF"><strong>Name:</strong> "Open" Constructor
- <dt><strong>Signature:</strong></dt>
- <dd>FL_PacketTable(hid_t fileID, char* name)</dd>
- <dt><strong>Purpose:</strong></dt>
- <dd>Opens a fixed-length packet table.</dd>
- <dt><strong>Description:</strong></dt>
- <dd>This constructor opens an existing packet table named
- <code>name</code> in the location <code>fileID</code>. This packet
- table must be fixed-length.</dd>
- <dt><strong>Parameters:</strong></dt>
- <dl>
- <dt>hid_t fileID</dt>
- <dd>IN: Identifier of the file or group containing the packet table.</dd>
- <dt>const char * dset_name</dt>
- <dd>IN: The name of the packet table to open.</dd>
- </dl>
- </dl>
- <hr>
-
- <dl>
- <dt style="background-color: #CCCCFF"><strong>Name:</strong> AppendPacket /
- AppendPackets
- <dt><strong>Signature:</strong></dt>
- <dd>int AppendPacket(void * data)</dd>
- <dd>int AppendPackets(size_t numPackets, void *data)</dd>
- <dt><strong>Purpose:</strong></dt>
- <dd>Appends fixed-length packets to the packet table.</dd>
- <dt><strong>Description:</strong></dt>
- <dd>This function writes packets to the end of the packet table.
- If only one argument is given, it is assumed that only a single
- packet is being written.</dd>
-<!-- NEW PAGE -->
- <dt><strong>Parameters:</strong></dt>
- <dl>
- <dt>size_t numPackets (optional)</dt>
- <dd>IN: Number of packets to add. Default is one.</dd>
- <dt>void * data:</dt>
- <dd>IN: Data to write. Must be a buffer of packets of the packet
- table's datatype.</dd>
- </dl>
- <dt><strong>Returns:</strong></dt>
- <dd>Returns non-negative value on success, negative on error.</dd>
- </dl>
- <hr>
-
- <dl>
- <dt style="background-color: #CCCCFF"><strong>Name:</strong> GetPacket /
- GetPackets
- <dt><strong>Signatures:</strong></dt>
- <dd>int GetPacket(hsize_t index, void * data)</dd>
- <dd>int GetPackets(hsize_t startIndex, hsize_t endIndex, void * data)</dd>
- <dt><strong>Purpose:</strong></dt>
- <dd>Reads packets from the packet table.</dd>
- <dt><strong>Description:</strong></dt>
- <dd>This function fills a buffer, <code>data</code>, with fixed-length
- packets from the packet table. The one-argument function can be
- called to retrieve a single packet at the given index, or the
- two-argument function used to read a range of packets
- (zero-indexed, inclusive).</dd>
- <dt><strong>Parameters:</strong></dt>
- <dl>
- <dt>hsize_t index (single packet)</dt>
- <dd>IN: Index of the single packet to be read</dd>
- <dt>hsize_t startIndex (multiple packets)</dt>
- <dd>IN: Index at which to start reading packets</dd>
- <dt>hsize_t endIndex (multiple packets)</dt>
- <dd>IN: Index at which to stop reading packets</dd>
- <dt>void * data</dt>
- <dd>OUT: Buffer for packets being retrieved</dd>
- </dl>
- <dt><strong>Returns:</strong></dt>
- <dd>Returns non-negative on success, negative on error.</dd>
- </dl>
- <hr>
-
- <dl>
- <dt style="background-color: #CCCCFF"><strong>Name:</strong> GetNextPacket /
- Get Next Packets
- <dt><strong>Signatures:</strong></dt>
- <dd>int GetNextPacket(void * data)</dd>
- <dd>int GetNextPackets(size_t numPackets, void * data)</dd>
- <dt><strong>Purpose:</strong></dt>
- <dd>Iterates through packets from the packet table.</dd>
- <dt><strong>Description:</strong></dt>
- <dd>This function reads packets starting from the current index in the
- packet table and updates the index. It can be used with the ResetIndex
- and SetIndex functions to iterate through the packet table.
- There are versions of this function that can be called with or
- without the <code>numPackets</code> argument; if this argument is
- not supplied, it defaults to one.</dd>
- <dt><strong>Parameters:</strong></dt>
- <dl>
- <dt>size_t numPackets (optional)</dt>
- <dd>IN: How many packets to read. Defaults to one.</dd>
- <dt>void * data</dt>
- <dd>OUT: Buffer to hold packets being read.</dd>
- </dl>
- <dt><strong>Returns:</strong></dt>
- <dd>Returns non-negative on success, negative on error.</dd>
- </dl>
-
-
-<!-- #BeginLibraryItem "/ed_libs/NavBar_RMHL.lbi" -->
-<hr>
-<center>
-<table border=0 width=98%>
-<tr><td valign=top align=left>
-<a href="../index.html">HDF5 documents and links</a> <br>
-<a href="../H5.intro.html">Introduction to HDF5</a> <br>
-<a href="../UG/HDF5_Users_Guide-Responsive HTML5/index.html">HDF5 User's Guide</a> <br>
-<a href="index.html">Other High-level API documents</a>
-<!--
+-->Classes:</strong> <o:p></o:p></span></p>
+
+<ul type=disc>
+ <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
+ mso-list:l0 level1 lfo3;tab-stops:list .5in'><strong><span
+ style='mso-fareast-font-family:"Times New Roman"'>PacketTable</span></strong><span
+ style='mso-fareast-font-family:"Times New Roman"'> - functions shared by
+ all packet tables <o:p></o:p></span></li>
+ <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
+ mso-list:l0 level1 lfo3;tab-stops:list .5in'><strong><span
+ style='mso-fareast-font-family:"Times New Roman"'>FL_PacketTable</span></strong><span
+ style='mso-fareast-font-family:"Times New Roman"'> - a packet table
+ storing fixed-length and variable-length packets<o:p></o:p></span></li>
+</ul>
+
+<p class=MsoNormal style='margin-bottom:12.0pt'><strong><span style='mso-fareast-font-family:
+"Times New Roman"'>Functions</span></strong><span style='mso-fareast-font-family:
+"Times New Roman"'> (none are static; all must be called on an object):<o:p></o:p></span></p>
+
+<div class=MsoNormal align=center style='text-align:center'><span
+style='mso-fareast-font-family:"Times New Roman"'>
+
+<hr size=3 width="100%" align=center>
+
+</span></div>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Packet
+Table:</span></strong><span style='mso-fareast-font-family:"Times New Roman"'> <o:p></o:p></span></p>
+
+<div class=MsoNormal align=center style='text-align:center'><span
+style='mso-fareast-font-family:"Times New Roman"'>
+
+<hr size=3 width="100%" align=center>
+
+</span></div>
+
+<p class=MsoNormal style='background:#CCCCFF'><strong><span style='mso-fareast-font-family:
+"Times New Roman"'>Name:</span></strong><span style='mso-fareast-font-family:
+"Times New Roman"'> Null Constructor <o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Signature:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span class=GramE><span
+style='mso-fareast-font-family:"Times New Roman"'>PacketTable(</span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> )<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Purpose:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Creates an invalid packet table object.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Description:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>The object created with this call will return false if </span><span
+class=SpellE><span class=GramE><span class=varconstfunc><span style='font-size:
+10.0pt;mso-bidi-font-size:12.0pt;mso-bidi-font-family:"Times New Roman"'>IsValid</span></span></span></span><span
+class=GramE><span class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:
+12.0pt;mso-bidi-font-family:"Times New Roman"'>(</span></span></span><span
+class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:12.0pt;
+mso-bidi-font-family:"Times New Roman"'>)</span></span><span style='mso-fareast-font-family:
+"Times New Roman"'> is called on it. To create a valid packet table, use the </span><span
+class=SpellE><span class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:
+12.0pt;mso-bidi-font-family:"Times New Roman"'>FL_Packet_Table</span></span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> constructors. This function does
+not make any change to the underlying HDF5 file. <o:p></o:p></span></p>
+
+<div class=MsoNormal align=center style='text-align:center'><span
+style='mso-fareast-font-family:"Times New Roman"'>
+
+<hr size=3 width="100%" align=center>
+
+</span></div>
+
+<p class=MsoNormal style='background:#CCCCFF'><strong><span style='mso-fareast-font-family:
+"Times New Roman"'>Name:</span></strong><span style='mso-fareast-font-family:
+"Times New Roman"'> "Open" Constructor <o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Signature:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span class=GramE><span
+style='mso-fareast-font-family:"Times New Roman"'>PacketTable(</span></span><span
+class=SpellE><span style='mso-fareast-font-family:"Times New Roman"'>hid_t</span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> <span class=SpellE>fileID</span>,
+<span class=SpellE>const</span> char* <span class=SpellE>ptname</span>)<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Purpose:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Opens an existing packet table.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Description:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Opens an existing packet table, named </span><span
+class=SpellE><span class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:
+12.0pt;mso-bidi-font-family:"Times New Roman"'>ptname</span></span></span><span
+style='mso-fareast-font-family:"Times New Roman"'>, which can contain either
+fixed-length or variable-length packets.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Parameters:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal><span class=SpellE><span class=GramE><span style='mso-fareast-font-family:
+"Times New Roman"'>hid_t</span></span></span><span style='mso-fareast-font-family:
+"Times New Roman"'> <span class=SpellE>fileID</span><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>IN: file or group in which the packet table is located<o:p></o:p></span></p>
+
+<p class=MsoNormal><span class=SpellE><span class=GramE><span style='mso-fareast-font-family:
+"Times New Roman"'>const</span></span></span><span style='mso-fareast-font-family:
+"Times New Roman"'> char* <span class=SpellE>ptname</span><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>IN: the packet table's name<o:p></o:p></span></p>
+
+<p class=MsoNormal align=center style='text-align:center'><span
+style='mso-fareast-font-family:"Times New Roman"'><<span class=SpellE>hr<!-- NEW PAGE --></span>
+size=3 width="100%" align=center> </span></p>
+
+<p class=MsoNormal style='background:#CCCCFF'><strong><span style='mso-fareast-font-family:
+"Times New Roman"'>Name:</span></strong><span style='mso-fareast-font-family:
+"Times New Roman"'> Destructor <o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Signature:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>~<span class=GramE>PacketTable()</span><o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Description:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>The destructor closes the packet table in the file, so a
+packet table created or opened with the C++ wrapper does not need to be closed
+manually.<o:p></o:p></span></p>
+
+<div class=MsoNormal align=center style='text-align:center'><span
+style='mso-fareast-font-family:"Times New Roman"'>
+
+<hr size=3 width="100%" align=center>
+
+</span></div>
+
+<p class=MsoNormal style='background:#CCCCFF'><strong><span style='mso-fareast-font-family:
+"Times New Roman"'>Name:</span></strong><span style='mso-fareast-font-family:
+"Times New Roman"'> <span class=SpellE>IsValid</span> <o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Signature:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span class=GramE><span
+style='mso-fareast-font-family:"Times New Roman"'>bool</span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> <span class=SpellE>IsValid</span>()<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Purpose:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Determines if this is a valid packet table.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Description:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>This function is used to ensure that a PacketTable object
+corresponds to an open packet table in the file. It should be called after the
+constructor to check that there were no errors creating or opening the packet
+table.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Returns:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Returns true if this is an open packet table, false
+otherwise.<o:p></o:p></span></p>
+
+<div class=MsoNormal align=center style='text-align:center'><span
+style='mso-fareast-font-family:"Times New Roman"'>
+
+<hr size=3 width="100%" align=center>
+
+</span></div>
+
+<p class=MsoNormal style='background:#CCCCFF'><strong><span style='mso-fareast-font-family:
+"Times New Roman"'>Name:</span></strong><span style='mso-fareast-font-family:
+"Times New Roman"'> <span class=SpellE>IsVariableLength</span><o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Signature:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span class=SpellE><span
+class=GramE><span style='mso-fareast-font-family:"Times New Roman"'>int</span></span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> <span class=SpellE>IsVariableLength</span>
+()<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Purpose:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Determines if this is a valid packet table.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Description:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'>This function<span
+style='mso-fareast-font-family:"Times New Roman"'> returns </span><span
+class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:12.0pt;
+mso-bidi-font-family:"Times New Roman"'>1</span></span><span style='mso-fareast-font-family:
+"Times New Roman"'> if this packet table uses a variable-length datatype, </span><span
+class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:12.0pt;
+mso-bidi-font-family:"Times New Roman"'>0</span></span><span style='mso-fareast-font-family:
+"Times New Roman"'> if not, and </span><span class=varconstfunc><span
+style='font-size:10.0pt;mso-bidi-font-size:12.0pt;mso-bidi-font-family:"Times New Roman"'>FAIL</span></span><span
+style='font-size:8.0pt;mso-bidi-font-size:12.0pt;mso-fareast-font-family:"Times New Roman"'>
+</span><span style='mso-fareast-font-family:"Times New Roman"'>if failure
+occurs.</span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Returns:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Returns </span><span class=varconstfunc><span
+style='font-size:10.0pt;mso-bidi-font-size:12.0pt;mso-bidi-font-family:"Times New Roman"'>1</span></span><span
+style='mso-fareast-font-family:"Times New Roman"'>, </span><span
+class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:12.0pt;
+mso-bidi-font-family:"Times New Roman"'>0</span></span><span style='mso-fareast-font-family:
+"Times New Roman"'>, or </span><span class=varconstfunc><span style='font-size:
+10.0pt;mso-bidi-font-size:12.0pt;mso-bidi-font-family:"Times New Roman"'>FAIL</span></span><span
+style='mso-fareast-font-family:"Times New Roman"'>.<o:p></o:p></span></p>
+
+<div class=MsoNormal align=center style='text-align:center'><span
+style='mso-fareast-font-family:"Times New Roman"'>
+
+<hr size=3 width="100%" align=center>
+
+</span></div>
+
+<p class=MsoNormal style='background:#CCCCFF'><strong><span style='mso-fareast-font-family:
+"Times New Roman"'>Name:</span></strong><span style='mso-fareast-font-family:
+"Times New Roman"'> <span class=SpellE>ResetIndex</span> <o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Signature:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span class=GramE><span
+style='mso-fareast-font-family:"Times New Roman"'>void</span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> <span class=SpellE>ResetIndex</span>()<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Purpose:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Resets the packet table's index to point to the first
+packet.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Description:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>A packet table keeps track of the user's current location in
+the table so that the user can iterate through packets. This function should be
+called before using <span class=SpellE>GetNextPacket</span>.<o:p></o:p></span></p>
+
+<p class=MsoNormal align=center style='text-align:center'><span
+style='mso-fareast-font-family:"Times New Roman"'><<span class=SpellE>hr<!-- NEW PAGE --></span>
+size=3 width="100%" align=center> </span></p>
+
+<p class=MsoNormal style='background:#CCCCFF'><strong><span style='mso-fareast-font-family:
+"Times New Roman"'>Name:</span></strong><span style='mso-fareast-font-family:
+"Times New Roman"'> <span class=SpellE>SetIndex</span> <o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Signature:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span class=SpellE><span
+class=GramE><span style='mso-fareast-font-family:"Times New Roman"'>int</span></span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> <span class=SpellE>SetIndex</span>(<span
+class=SpellE>hsize_t</span> index);<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Purpose:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Sets a packet table's current index.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Description:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>This function allows the user to begin iterating through packets
+starting from any arbitrary index. Packet tables are zero-indexed, so packet 0
+is the first packet.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Parameters:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal><span class=SpellE><span class=GramE><span style='mso-fareast-font-family:
+"Times New Roman"'>hsize_t</span></span></span><span style='mso-fareast-font-family:
+"Times New Roman"'> index<o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>IN: The value to which the packet table's index should be
+set<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Returns:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Returns non-negative on success, negative on error.<o:p></o:p></span></p>
+
+<div class=MsoNormal align=center style='text-align:center'><span
+style='mso-fareast-font-family:"Times New Roman"'>
+
+<hr size=3 width="100%" align=center>
+
+</span></div>
+
+<div class=MsoNormal align=center style='text-align:center'><span
+style='mso-fareast-font-family:"Times New Roman"'>
+
+<hr size=3 width="100%" align=center>
+
+</span></div>
+
+<p class=MsoNormal style='background:#CCCCFF'><strong><span style='mso-fareast-font-family:
+"Times New Roman"'>Name:</span></strong><span style='mso-fareast-font-family:
+"Times New Roman"'> <span class=SpellE>GetIndex</span> <o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Signature:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span class=SpellE><span
+class=GramE><span style='mso-fareast-font-family:"Times New Roman"'>hsize_t</span></span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> <span class=SpellE>GetIndex</span>(<span
+class=SpellE>int</span>& error);<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Purpose:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Returns the position of the current packet.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Description:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>This function allows the user to determine the position of
+the current packet. <o:p></o:p></span></p>
+
+<p style='margin-left:.5in'>If <span class=SpellE><span class=varconstfunc><span
+style='font-size:10.0pt;mso-bidi-font-size:12.0pt;mso-bidi-font-family:"Times New Roman"'>GetIndex</span></span></span>
+returns <span class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:
+12.0pt;mso-bidi-font-family:"Times New Roman"'>0</span></span> (zero), you must
+then check the value of the parameter <span class=varconstfunc><span
+style='font-size:10.0pt;mso-bidi-font-size:12.0pt;mso-bidi-font-family:"Times New Roman"'>error</span></span>.
+If <span class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:
+12.0pt;mso-bidi-font-family:"Times New Roman"'>error</span></span> is negative,
+<span class=SpellE><span class=varconstfunc><span style='font-size:10.0pt;
+mso-bidi-font-size:12.0pt;mso-bidi-font-family:"Times New Roman"'>GetIndex</span></span></span>
+has failed; if <span class=varconstfunc><span style='font-size:10.0pt;
+mso-bidi-font-size:12.0pt;mso-bidi-font-family:"Times New Roman"'>error</span></span>
+is <span class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:
+12.0pt;mso-bidi-font-family:"Times New Roman"'>0</span></span> (zero), the
+position of the current packet is <span class=varconstfunc><span
+style='font-size:10.0pt;mso-bidi-font-size:12.0pt;mso-bidi-font-family:"Times New Roman"'>0</span></span>
+(zero). </p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Parameters:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal><span class=SpellE><span class=GramE><span style='mso-fareast-font-family:
+"Times New Roman"'>int</span></span></span><span style='mso-fareast-font-family:
+"Times New Roman"'>& error (optional)<o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>OUT: Non-negative if index was successfully retrieved,
+negative on failure.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Returns:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Returns the position of the current packet on success, </span><span
+class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:12.0pt;
+mso-bidi-font-family:"Times New Roman"'>0</span></span><span style='mso-fareast-font-family:
+"Times New Roman"'> (zero) on error.<o:p></o:p></span></p>
+
+<div class=MsoNormal align=center style='text-align:center'><span
+style='mso-fareast-font-family:"Times New Roman"'>
+
+<hr size=3 width="100%" align=center>
+
+</span></div>
+
+<p class=MsoNormal style='background:#CCCCFF'><strong><span style='mso-fareast-font-family:
+"Times New Roman"'>Name:</span></strong><span style='mso-fareast-font-family:
+"Times New Roman"'> <span class=SpellE>GetPacketCount</span> <o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Signatures:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span class=SpellE><span
+class=GramE><span style='mso-fareast-font-family:"Times New Roman"'>hsize_t</span></span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> <span class=SpellE>GetPacketCount</span>()<o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span class=SpellE><span
+class=GramE><span style='mso-fareast-font-family:"Times New Roman"'>hsize_t</span></span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> <span class=SpellE>GetPacketCount</span>(<span
+class=SpellE>int</span>& error)<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Purpose:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Retrieves the number of packets in the packet table.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Description:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>This function is overloaded so that it can be called with or
+without returning an error value. If </span><span class=varconstfunc><span
+style='font-size:10.0pt;mso-bidi-font-size:12.0pt;mso-bidi-font-family:"Times New Roman"'>error</span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> is not supplied, any error
+value is ignored. Using this parameter allows the user to distinguish between
+an open packet table with 0 packets and an invalid packet table.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Parameters:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal><span class=SpellE><span class=GramE><span style='mso-fareast-font-family:
+"Times New Roman"'>int</span></span></span><span style='mso-fareast-font-family:
+"Times New Roman"'>& error (optional)<o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>OUT: Non-negative if packet count was successfully
+retrieved, negative if packet table is invalid.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Returns:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Number of packets in packet table. Returns </span><span
+class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:12.0pt;
+mso-bidi-font-family:"Times New Roman"'>0</span></span><span style='mso-fareast-font-family:
+"Times New Roman"'> if packet table contains zero packets or on error.<o:p></o:p></span></p>
+
+<div class=MsoNormal align=center style='text-align:center'><span
+style='mso-fareast-font-family:"Times New Roman"'>
+
+<hr size=3 width="100%" align=center>
+
+</span></div>
+
+<p class=MsoNormal style='background:#CCCCFF'><strong><span style='mso-fareast-font-family:
+"Times New Roman"'>Name:</span></strong><span style='mso-fareast-font-family:
+"Times New Roman"'> <span class=SpellE>FreeBuff</span><o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Signatures:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span class=SpellE><span
+class=GramE><span style='mso-fareast-font-family:"Times New Roman"'>int</span></span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> <span class=SpellE>FreeBuff</span>
+()<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Purpose:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Frees the buffer created when accessing data in a variable-length
+packet table.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Description:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Takes the number of <span class=SpellE>hvl_t</span> <span
+class=SpellE>structs</span> to be freed and a pointer to their location in
+memory.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Parameters:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal><span class=SpellE><span class=GramE><span style='mso-fareast-font-family:
+"Times New Roman"'>size_t</span></span></span><span style='mso-fareast-font-family:
+"Times New Roman"'> <span class=SpellE>numStructs</span><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>IN: Number of <span class=SpellE>structs</span> to be free.<o:p></o:p></span></p>
+
+<p class=MsoNormal><span class=SpellE><span style='mso-fareast-font-family:
+"Times New Roman"'>hvl_t</span></span><span style='mso-fareast-font-family:
+"Times New Roman"'> *buffer<o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>IN: Pointer to location.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Returns:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Returns </span><span class=varconstfunc><span
+style='font-size:10.0pt;mso-bidi-font-size:12.0pt;mso-bidi-font-family:"Times New Roman"'>SUCCEED</span></span><span
+style='mso-fareast-font-family:"Times New Roman"'>, on success, and </span><span
+class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:12.0pt;
+mso-bidi-font-family:"Times New Roman"'>FAIL</span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> on error.<o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'><o:p> </o:p></span></p>
+
+<p class=MsoNormal align=center style='text-align:center'><span
+style='mso-fareast-font-family:"Times New Roman"'><<span class=SpellE>hr<!-- NEW PAGE --><!-- HEADER RIGHT "FL_Packet_Table" --></span>
+size=3 width="100%" align=center> </span></p>
+
+<p class=MsoNormal><span class=SpellE><strong><span style='mso-fareast-font-family:
+"Times New Roman"'>FL_Packet_Table</span></strong></span><strong><span
+style='mso-fareast-font-family:"Times New Roman"'>:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<div class=MsoNormal align=center style='text-align:center'><span
+style='mso-fareast-font-family:"Times New Roman"'>
+
+<hr size=3 width="100%" align=center>
+
+</span></div>
+
+<p class=MsoNormal style='background:#CCCCFF'><strong><span style='mso-fareast-font-family:
+"Times New Roman"'>Name:</span></strong><span style='mso-fareast-font-family:
+"Times New Roman"'> "Create" Constructor <o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Signature:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>FL_<span class=GramE>PacketTable(</span><span class=SpellE>hid_t</span>
+<span class=SpellE>fileID</span>, <span class=SpellE>hid_t</span> <span
+class=SpellE>plistID</span>, <span class=SpellE>const</span> char* <span
+class=SpellE>ptname</span>, <span class=SpellE>hid_t</span> <span class=SpellE>dtypeID</span>,
+<span class=SpellE>hsize_t</span> <span class=SpellE>chunkSize</span>)<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Purpose:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Creates a new packet table for storing fixed-length or
+variable-length packets.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Description:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>This constructor creates and opens a packet table</span><code><span
+style='font-size:10.0pt'>,</span></code><span style='mso-fareast-font-family:
+"Times New Roman"'> named </span><span class=SpellE><span class=varconstfunc><span
+style='font-size:10.0pt;mso-bidi-font-size:12.0pt;mso-bidi-font-family:"Times New Roman"'>ptname</span></span></span><span
+style='mso-fareast-font-family:"Times New Roman"'>, in the file specified by </span><span
+class=SpellE><span class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:
+12.0pt;mso-bidi-font-family:"Times New Roman"'>fileID</span></span></span><code><span
+style='font-size:10.0pt'>. </span></code><span style='mso-fareast-font-family:
+"Times New Roman"'>Packets will be of the datatype specified by </span><span
+class=SpellE><span class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:
+12.0pt;mso-bidi-font-family:"Times New Roman"'>dtypeID</span></span></span><span
+style='mso-fareast-font-family:"Times New Roman"'>.<span
+style='mso-spacerun:yes'>� </span>The packet table uses HDF5 chunked storage to
+allow it to grow.<span style='mso-spacerun:yes'>� </span>The chunk size can be
+specified by </span><span class=SpellE><span class=varconstfunc><span
+style='font-size:10.0pt;mso-bidi-font-size:12.0pt;mso-bidi-font-family:"Times New Roman"'>chunkSize</span></span></span><code><span
+style='font-size:10.0pt'>.</span></code><span style='mso-fareast-font-family:
+"Times New Roman"'> The chunk size affects performance, so it should be
+determined with care when performance is important.<span
+style='mso-spacerun:yes'>� </span>Compression can be set via the dataset create
+property list, specified by </span><span class=SpellE><span class=varconstfunc><span
+style='font-size:10.0pt;mso-bidi-font-size:12.0pt;mso-bidi-font-family:"Times New Roman"'>plistID</span></span></span><span
+style='mso-fareast-font-family:"Times New Roman"'>.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Parameters:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal><span class=SpellE><span class=GramE><span style='mso-fareast-font-family:
+"Times New Roman"'>hid_t</span></span></span><span style='mso-fareast-font-family:
+"Times New Roman"'> <span class=SpellE>fileID</span><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>IN: Identifier of the file or group to create the table
+within.<o:p></o:p></span></p>
+
+<p class=MsoNormal><span class=SpellE><span class=GramE><span style='mso-fareast-font-family:
+"Times New Roman"'>hid_t</span></span></span><span style='mso-fareast-font-family:
+"Times New Roman"'> <span class=SpellE>plistID</span><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>IN: Identifier of the creation property list.<o:p></o:p></span></p>
+
+<p class=MsoNormal><span class=SpellE><span class=GramE><span style='mso-fareast-font-family:
+"Times New Roman"'>const</span></span></span><span style='mso-fareast-font-family:
+"Times New Roman"'> char *<span class=SpellE>pt_name</span><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>IN: The name of the packet table to create.<o:p></o:p></span></p>
+
+<p class=MsoNormal><span class=SpellE><span class=GramE><span style='mso-fareast-font-family:
+"Times New Roman"'>hid_t</span></span></span><span style='mso-fareast-font-family:
+"Times New Roman"'> <span class=SpellE>dtypeID</span><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>IN: The datatype of a packet.<o:p></o:p></span></p>
+
+<p class=MsoNormal><span class=SpellE><span class=GramE><span style='mso-fareast-font-family:
+"Times New Roman"'>hsize_t</span></span></span><span style='mso-fareast-font-family:
+"Times New Roman"'> <span class=SpellE>chunkSize</span><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>IN: Desired chunk size.<o:p></o:p></span></p>
+
+<div class=MsoNormal align=center style='text-align:center;background:#CCCCFF'><span
+style='mso-fareast-font-family:"Times New Roman"'>
+
+<hr size=3 width="100%" align=center>
+
+</span></div>
+
+<p class=MsoNormal style='background:#CCCCFF'><strong><span style='mso-fareast-font-family:
+"Times New Roman"'>Name:</span></strong><span style='mso-fareast-font-family:
+"Times New Roman"'> "Create" Constructor (deprecated)<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Signature:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>FL_<span class=GramE>PacketTable(</span><span class=SpellE>hid_t</span>
+<span class=SpellE>fileID</span>, char* <span class=SpellE>ptname</span>, <span
+class=SpellE>hid_t</span> <span class=SpellE>dtypeID</span>, <span
+class=SpellE>hsize_t</span> <span class=SpellE>chunkSize</span>, <span
+class=SpellE>int</span> compression)<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Purpose:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Creates a new packet table for storing fixed-length packets.<span
+style='mso-spacerun:yes'>� </span><o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Description:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>This constructor will be deprecated in favor of the previous
+constructor, which provides flexibility in the compression method.<o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>This constructor creates and opens a packet table in the
+file specified by </span><span class=SpellE><span class=varconstfunc><span
+style='font-size:10.0pt;mso-bidi-font-size:12.0pt;mso-bidi-font-family:"Times New Roman"'>fileID</span></span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> named </span><span
+class=SpellE><span class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:
+12.0pt;mso-bidi-font-family:"Times New Roman"'>ptname</span></span></span><span
+style='mso-fareast-font-family:"Times New Roman"'>. Packets will be of the
+datatype specified by </span><span class=SpellE><span class=varconstfunc><span
+style='font-size:10.0pt;mso-bidi-font-size:12.0pt;mso-bidi-font-family:"Times New Roman"'>dtypeID</span></span></span><span
+style='mso-fareast-font-family:"Times New Roman"'>.<span
+style='mso-spacerun:yes'>� </span>The packet can be specified to contain data
+with deflate compression using the parameter </span><span class=varconstfunc><span
+style='font-size:10.0pt;mso-bidi-font-size:12.0pt;mso-bidi-font-family:"Times New Roman"'>compression</span></span><code><span
+style='font-size:10.0pt'>.</span></code><span style='mso-fareast-font-family:
+"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Parameters:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal><span class=SpellE><span class=GramE><span style='mso-fareast-font-family:
+"Times New Roman"'>hid_t</span></span></span><span style='mso-fareast-font-family:
+"Times New Roman"'> <span class=SpellE>fileID</span><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>IN: Identifier of the file or group to create the table
+within.<o:p></o:p></span></p>
+
+<p class=MsoNormal><span class=SpellE><span class=GramE><span style='mso-fareast-font-family:
+"Times New Roman"'>const</span></span></span><span style='mso-fareast-font-family:
+"Times New Roman"'> char *<span class=SpellE>ptname</span><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>IN: The name of the packet table to create.<o:p></o:p></span></p>
+
+<p class=MsoNormal><span class=SpellE><span class=GramE><span style='mso-fareast-font-family:
+"Times New Roman"'>hid_t</span></span></span><span style='mso-fareast-font-family:
+"Times New Roman"'> <span class=SpellE>dtypeID</span><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>IN: The datatype of a packet.<o:p></o:p></span></p>
+
+<p class=MsoNormal><span class=SpellE><span class=GramE><span style='mso-fareast-font-family:
+"Times New Roman"'>hsize_t</span></span></span><span style='mso-fareast-font-family:
+"Times New Roman"'> <span class=SpellE>chunkSize</span><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>IN: The packet table uses HDF5 chunked storage to allow it
+to grow. This value allows the user to set the size of a chunk. The chunk size
+affects performance.<o:p></o:p></span></p>
+
+<p class=MsoNormal><span class=SpellE><span class=GramE><span style='mso-fareast-font-family:
+"Times New Roman"'>int</span></span></span><span style='mso-fareast-font-family:
+"Times New Roman"'> compression<o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>IN: Desired compression level: </span><span
+class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:12.0pt;
+mso-bidi-font-family:"Times New Roman"'>0</span></span><span style='mso-fareast-font-family:
+"Times New Roman"'> (zero) through </span><span class=varconstfunc><span
+style='font-size:10.0pt;mso-bidi-font-size:12.0pt;mso-bidi-font-family:"Times New Roman"'>9</span></span><code><span
+style='font-size:10.0pt'>,</span></code><span style='mso-fareast-font-family:
+"Times New Roman"'> or </span><span class=varconstfunc><span style='font-size:
+10.0pt;mso-bidi-font-size:12.0pt;mso-bidi-font-family:"Times New Roman"'>-1</span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> for no compression.<o:p></o:p></span></p>
+
+<div class=MsoNormal align=center style='text-align:center'><span
+style='mso-fareast-font-family:"Times New Roman"'>
+
+<hr size=3 width="100%" align=center>
+
+</span></div>
+
+<p class=MsoNormal style='background:#CCCCFF'><strong><span style='mso-fareast-font-family:
+"Times New Roman"'>Name:</span></strong><span style='mso-fareast-font-family:
+"Times New Roman"'> "Open" Constructor <o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Signature:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>FL_<span class=GramE>PacketTable(</span><span class=SpellE>hid_t</span>
+<span class=SpellE>fileID</span>, <span class=SpellE>const</span> char* <span
+class=SpellE>ptname</span>)<o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>FL_<span class=GramE>PacketTable(</span><span class=SpellE>hid_t</span>
+<span class=SpellE>fileID</span>, char* <span class=SpellE>ptname</span>)
+(deprecated)<o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'><o:p> </o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Purpose:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Opens a fixed-length packet table.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Description:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>This constructor opens an existing packet table named </span><span
+class=SpellE><span class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:
+12.0pt;mso-bidi-font-family:"Times New Roman"'>ptname</span></span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> in the location </span><span
+class=SpellE><span class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:
+12.0pt;mso-bidi-font-family:"Times New Roman"'>fileID</span></span></span><span
+style='mso-fareast-font-family:"Times New Roman"'>. This packet table must be
+fixed-length.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Parameters:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal><span class=SpellE><span class=GramE><span style='mso-fareast-font-family:
+"Times New Roman"'>hid_t</span></span></span><span style='mso-fareast-font-family:
+"Times New Roman"'> <span class=SpellE>fileID</span><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>IN: Identifier of the file or group containing the packet
+table.<o:p></o:p></span></p>
+
+<p class=MsoNormal><span class=SpellE><span class=GramE><span style='mso-fareast-font-family:
+"Times New Roman"'>const</span></span></span><span style='mso-fareast-font-family:
+"Times New Roman"'> char *<span class=SpellE>ptname</span><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>IN: The name of the packet table to open.<o:p></o:p></span></p>
+
+<div class=MsoNormal align=center style='text-align:center'><span
+style='mso-fareast-font-family:"Times New Roman"'>
+
+<hr size=3 width="100%" align=center>
+
+</span></div>
+
+<p class=MsoNormal style='background:#CCCCFF'><strong><span style='mso-fareast-font-family:
+"Times New Roman"'>Name:</span></strong><span style='mso-fareast-font-family:
+"Times New Roman"'> <span class=SpellE>AppendPacket</span> / <span
+class=SpellE>AppendPackets</span> <o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Signature:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span class=SpellE><span
+class=GramE><span style='mso-fareast-font-family:"Times New Roman"'>int</span></span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> <span class=SpellE>AppendPacket</span>(void
+* data)<o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span class=SpellE><span
+class=GramE><span style='mso-fareast-font-family:"Times New Roman"'>int</span></span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> <span class=SpellE>AppendPackets</span>(<span
+class=SpellE>size_t</span> <span class=SpellE>numPackets</span>, void *data)<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Purpose:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Appends packet(s) to the packet table.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Description:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>These functions write packet(s) to the end of the packet
+table.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'><!-- NEW PAGE -->Parameters:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal><span class=SpellE><span class=GramE><span style='mso-fareast-font-family:
+"Times New Roman"'>size_t</span></span></span><span style='mso-fareast-font-family:
+"Times New Roman"'> <span class=SpellE>numPackets</span><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>IN: Number of packets to add.<o:p></o:p></span></p>
+
+<p class=MsoNormal><span class=GramE><span style='mso-fareast-font-family:"Times New Roman"'>void</span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> * data:<o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>IN: Data to write. Must be a buffer of packets of the packet
+table's datatype.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Returns:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Returns </span><span class=varconstfunc><span
+style='font-size:10.0pt;mso-bidi-font-size:12.0pt;mso-bidi-font-family:"Times New Roman"'>SUCCEED</span></span><span
+style='mso-fareast-font-family:"Times New Roman"'>, on success, and </span><span
+class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:12.0pt;
+mso-bidi-font-family:"Times New Roman"'>FAIL</span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> on error.<o:p></o:p></span></p>
+
+<div class=MsoNormal align=center style='text-align:center'><span
+style='mso-fareast-font-family:"Times New Roman"'>
+
+<hr size=3 width="100%" align=center>
+
+</span></div>
+
+<p class=MsoNormal style='background:#CCCCFF'><strong><span style='mso-fareast-font-family:
+"Times New Roman"'>Name:</span></strong><span style='mso-fareast-font-family:
+"Times New Roman"'> <span class=SpellE>GetPacket</span> / <span class=SpellE>GetPackets</span>
+<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Signatures:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span class=SpellE><span
+class=GramE><span style='mso-fareast-font-family:"Times New Roman"'>int</span></span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> <span class=SpellE>GetPacket</span>(<span
+class=SpellE>hsize_t</span> index, void * data)<o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span class=SpellE><span
+class=GramE><span style='mso-fareast-font-family:"Times New Roman"'>int</span></span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> <span class=SpellE>GetPackets</span>(<span
+class=SpellE>hsize_t</span> <span class=SpellE>startIndex</span>, <span
+class=SpellE>hsize_t</span> <span class=SpellE>endIndex</span>, void * data)<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Purpose:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Reads packets from the packet table.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Description:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>This function fills a buffer, </span><span
+class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:12.0pt;
+mso-bidi-font-family:"Times New Roman"'>data</span></span><span
+style='mso-fareast-font-family:"Times New Roman"'>, with fixed-length packets
+from the packet table. The one-argument function can be called to retrieve a
+single packet at the given index, or the two-argument function used to read a
+range of packets (zero-indexed, inclusive).<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Parameters:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal><span class=SpellE><span class=GramE><span style='mso-fareast-font-family:
+"Times New Roman"'>hsize_t</span></span></span><span style='mso-fareast-font-family:
+"Times New Roman"'> index (single packet)<o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>IN: Index of the single packet to be read<o:p></o:p></span></p>
+
+<p class=MsoNormal><span class=SpellE><span class=GramE><span style='mso-fareast-font-family:
+"Times New Roman"'>hsize_t</span></span></span><span style='mso-fareast-font-family:
+"Times New Roman"'> <span class=SpellE>startIndex</span> (multiple packets)<o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>IN: Index at which to start reading packets<o:p></o:p></span></p>
+
+<p class=MsoNormal><span class=SpellE><span class=GramE><span style='mso-fareast-font-family:
+"Times New Roman"'>hsize_t</span></span></span><span style='mso-fareast-font-family:
+"Times New Roman"'> <span class=SpellE>endIndex</span> (multiple packets)<o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>IN: Index at which to stop reading packets<o:p></o:p></span></p>
+
+<p class=MsoNormal><span class=GramE><span style='mso-fareast-font-family:"Times New Roman"'>void</span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> * data<o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>OUT: Buffer for packets being retrieved<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Returns:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Returns </span><span class=varconstfunc><span
+style='font-size:10.0pt;mso-bidi-font-size:12.0pt;mso-bidi-font-family:"Times New Roman"'>SUCCEED</span></span><span
+style='mso-fareast-font-family:"Times New Roman"'>, on success, and </span><span
+class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:12.0pt;
+mso-bidi-font-family:"Times New Roman"'>FAIL</span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> on error.<o:p></o:p></span></p>
+
+<div class=MsoNormal align=center style='text-align:center'><span
+style='mso-fareast-font-family:"Times New Roman"'>
+
+<hr size=3 width="100%" align=center>
+
+</span></div>
+
+<p class=MsoNormal style='background:#CCCCFF'><strong><span style='mso-fareast-font-family:
+"Times New Roman"'>Name:</span></strong><span style='mso-fareast-font-family:
+"Times New Roman"'> <span class=SpellE>GetNextPacket</span> / Get Next Packets <o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Signatures:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span class=SpellE><span
+class=GramE><span style='mso-fareast-font-family:"Times New Roman"'>int</span></span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> <span class=SpellE>GetNextPacket</span>(void
+* data)<o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span class=SpellE><span
+class=GramE><span style='mso-fareast-font-family:"Times New Roman"'>int</span></span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> <span class=SpellE>GetNextPackets</span>(<span
+class=SpellE>size_t</span> <span class=SpellE>numPackets</span>, void * data)<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Purpose:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Iterates through packets from the packet table.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Description:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>This function reads packets starting from the current index
+in the packet table and updates the index. It can be used with the </span><span
+class=SpellE><span class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:
+12.0pt;mso-bidi-font-family:"Times New Roman"'>ResetIndex</span></span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> and </span><span
+class=SpellE><span class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:
+12.0pt;mso-bidi-font-family:"Times New Roman"'>SetIndex</span></span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> functions to iterate through
+the packet table.<span style='mso-spacerun:yes'>� </span></span><span
+class=SpellE><span class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:
+12.0pt;mso-bidi-font-family:"Times New Roman"'>GetNextPacket</span></span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> reads a single packet and </span><span
+class=SpellE><span class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:
+12.0pt;mso-bidi-font-family:"Times New Roman"'>GetNextPackets</span></span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> read </span><span
+class=SpellE><span class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:
+12.0pt;mso-bidi-font-family:"Times New Roman"'>numPackets</span></span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> packets.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Parameters:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal><span class=SpellE><span class=GramE><span style='mso-fareast-font-family:
+"Times New Roman"'>size_t</span></span></span><span style='mso-fareast-font-family:
+"Times New Roman"'> <span class=SpellE>numPackets</span> (optional)<o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>IN: How many packets to read.<o:p></o:p></span></p>
+
+<p class=MsoNormal><span class=GramE><span style='mso-fareast-font-family:"Times New Roman"'>void</span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> * data<o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>OUT: Buffer to hold packets read.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Returns:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Returns </span><span class=varconstfunc><span
+style='font-size:10.0pt;mso-bidi-font-size:12.0pt;mso-bidi-font-family:"Times New Roman"'>SUCCEED</span></span><span
+style='mso-fareast-font-family:"Times New Roman"'>, on success, and </span><span
+class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:12.0pt;
+mso-bidi-font-family:"Times New Roman"'>FAIL</span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> on error.<o:p></o:p></span></p>
+
+<div class=MsoNormal align=center style='text-align:center'><span
+style='mso-fareast-font-family:"Times New Roman"'>
+
+<hr size=3 width="100%" align=center>
+
+</span></div>
+
+<p class=MsoNormal style='background:#CCCCFF'><strong><span style='mso-fareast-font-family:
+"Times New Roman"'>Name:</span></strong><span style='mso-fareast-font-family:
+"Times New Roman"'> <span class=SpellE>GetTableId</span> <o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Signature:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span class=SpellE><span
+class=GramE><span style='mso-fareast-font-family:"Times New Roman"'>hid_t</span></span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> <span class=SpellE>GetTableId</span>
+()<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Purpose:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Returns the identifier of the packet table.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Description:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>This function returns the packet table identifier.<span
+style='mso-spacerun:yes'>� </span>However, the identifier is usually not needed
+by applications.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'><!-- NEW PAGE -->Returns:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Returns a valid identifier on success, or </span><span
+class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:12.0pt;
+mso-bidi-font-family:"Times New Roman"'>H5I_INVALID_HID</span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> if the packet table is not
+valid.<o:p></o:p></span></p>
+
+<div class=MsoNormal align=center style='text-align:center'><span
+style='mso-fareast-font-family:"Times New Roman"'>
+
+<hr size=3 width="100%" align=center>
+
+</span></div>
+
+<p class=MsoNormal style='background:#CCCCFF'><strong><span style='mso-fareast-font-family:
+"Times New Roman"'>Name:</span></strong><span style='mso-fareast-font-family:
+"Times New Roman"'> <span class=SpellE>GetDatatype</span><o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Signature:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span class=SpellE><span
+class=GramE><span style='mso-fareast-font-family:"Times New Roman"'>hid_t</span></span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> <span class=SpellE>GetDatatype</span>
+()<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Purpose:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Returns the datatype of this packet table.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Description:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>This function returns the identifier of the datatype used by
+this packet table.<span style='mso-spacerun:yes'>� </span>However, it is better
+to avoid using this identifier in packet table applications, unless the desired
+functionality cannot be performed via the packet table ID.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'><!-- NEW PAGE -->Returns:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Returns a valid identifier on success, or </span><span
+class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:12.0pt;
+mso-bidi-font-family:"Times New Roman"'>H5I_INVALID_HID</span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> on error.<o:p></o:p></span></p>
+
+<div class=MsoNormal align=center style='text-align:center'><span
+style='mso-fareast-font-family:"Times New Roman"'>
+
+<hr size=3 width="100%" align=center>
+
+</span></div>
+
+<p class=MsoNormal style='background:#CCCCFF'><strong><span style='mso-fareast-font-family:
+"Times New Roman"'>Name:</span></strong><span style='mso-fareast-font-family:
+"Times New Roman"'> <span class=SpellE>GetDataset</span><o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Signature:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span class=SpellE><span
+class=GramE><span style='mso-fareast-font-family:"Times New Roman"'>hid_t</span></span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> <span class=SpellE>GetDataset</span>
+()<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Purpose:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Returns the dataset of this packet table.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'>Description:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>This function returns the identifier of the dataset of this
+packet table.<span style='mso-spacerun:yes'>� </span>However, it is better to
+avoid using this identifier in packet table applications, unless the desired
+functionality cannot be performed via the packet table ID.<o:p></o:p></span></p>
+
+<p class=MsoNormal><strong><span style='mso-fareast-font-family:"Times New Roman"'><!-- NEW PAGE -->Returns:</span></strong><span
+style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+
+<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
+"Times New Roman"'>Returns a valid identifier on success, or </span><span
+class=varconstfunc><span style='font-size:10.0pt;mso-bidi-font-size:12.0pt;
+mso-bidi-font-family:"Times New Roman"'>H5I_INVALID_HID</span></span><span
+style='mso-fareast-font-family:"Times New Roman"'> on error.<o:p></o:p></span></p>
+
+<p class=MsoNormal><span style='mso-fareast-font-family:"Times New Roman"'><o:p> </o:p></span></p>
+
+<p class=MsoNormal align=center style='text-align:center'><span
+style='mso-fareast-font-family:"Times New Roman"'><<span class=SpellE>hr<!-- #BeginLibraryItem "/ed_libs/NavBar_RMHL.lbi" --></span>
+size=3 width="100%" align=center> </span></p>
+
+<div align=center>
+
+<table class=MsoNormalTable border=0 cellspacing=3 cellpadding=0 width="98%"
+ style='width:98.0%;mso-cellspacing:1.5pt;mso-yfti-tbllook:1184;mso-padding-alt:
+ 0in 5.4pt 0in 5.4pt'>
+ <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes'>
+ <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
+ <p class=MsoNormal><span style='mso-fareast-font-family:"Times New Roman"'><a
+ href="../index.html">HDF5 documents and links</a> <br>
+ <a href="../H5.intro.html">Introduction to HDF5</a> <br>
+ <a href="../UG/HDF5_Users_Guide-Responsive%20HTML5/index.html"><span
+ class=SpellE>HDF5</span> User's Guide</a> <br>
+ <a href="index.html">Other High-level API documents</a> <o:p></o:p></span></p>
+ </td>
+ <td valign=top style='padding:.75pt .75pt .75pt .75pt'>
+ <p class=MsoNormal align=right style='text-align:right'><span
+ style='mso-fareast-font-family:"Times New Roman"'><!--
<a href="Glossary.html">Glossary</a><br>
--->
-</td>
-<td valign=top align=right>
-In the
-<a href="../RM/RM_H5Front.html">HDF5 Reference Manual</a>
-<font size=-1>
-<br>
-<a href="RM_H5DS.html">H5DS</a>
-<a href="RM_H5IM.html">H5IM</a>
-<a href="RM_H5LT.html">H5LT</a>
-<a href="RM_H5PT.html">H5PT</a>
-<a href="RM_H5TB.html">H5TB</a>
-<a href="RM_HDF5Optimized.html">Optimized</a>
-<br>
-<a href="../RM/RM_H5.html">H5</a>
-<a href="../RM/RM_H5A.html">H5A</a>
-<a href="../RM/RM_H5D.html">H5D</a>
-<a href="../RM/RM_H5E.html">H5E</a>
-<a href="../RM/RM_H5F.html">H5F</a>
-<a href="../RM/RM_H5G.html">H5G</a>
-<a href="../RM/RM_H5I.html">H5I</a>
-<br>
-<a href="../RM/RM_H5L.html">H5L</a>
-<a href="../RM/RM_H5O.html">H5O</a>
-<a href="../RM/RM_H5P.html">H5P</a>
-<a href="../RM/RM_H5R.html">H5R</a>
-<a href="../RM/RM_H5S.html">H5S</a>
-<a href="../RM/RM_H5T.html">H5T</a>
-<a href="../RM/RM_H5Z.html">H5Z</a>
-<br>
-<a href="../RM/Tools.html">Tools</a>
-<a href="../RM/PredefDTypes.html">Datatypes</a>
-<a href="../fortran/index.html">Fortran</a>
-</font>
-</td></tr>
-</table>
-</center>
-<hr>
-<!-- #EndLibraryItem -->
-
-<?php include("../ed_libs/Footer2.htm"); ?>
-
-<SCRIPT LANGUAGE="JAVASCRIPT">
+-->In
+ the <a href="../RM/RM_H5Front.html">HDF5 Reference Manual</a> </span><span
+ style='font-size:10.0pt;mso-fareast-font-family:"Times New Roman"'><br>
+ <a href="RM_H5DS.html">H5DS</a> <a href="RM_H5IM.html">H5IM</a>
+ <a href="RM_H5LT.html">H5LT</a> <a href="RM_H5PT.html">H5PT</a>
+ <a href="RM_H5TB.html">H5TB</a> <a href="RM_HDF5Optimized.html">Optimized</a>
+ <br>
+ <a href="../RM/RM_H5.html">H5</a> <a href="../RM/RM_H5A.html">H5A</a>
+ <a href="../RM/RM_H5D.html">H5D</a> <a href="../RM/RM_H5E.html">H5E</a>
+ <a href="../RM/RM_H5F.html">H5F</a> <a href="../RM/RM_H5G.html">H5G</a>
+ <a href="../RM/RM_H5I.html">H5I</a> <br>
+ <a href="../RM/RM_H5L.html">H5L</a> <a href="../RM/RM_H5O.html">H5O</a>
+ <a href="../RM/RM_H5P.html">H5P</a> <a href="../RM/RM_H5R.html">H5R</a>
+ <a href="../RM/RM_H5S.html">H5S</a> <a href="../RM/RM_H5T.html">H5T</a>
+ <a href="../RM/RM_H5Z.html">H5Z</a> <br>
+ <a href="../RM/Tools.html">Tools</a> <a
+ href="../RM/PredefDTypes.html">Datatypes</a> <a
+ href="../fortran/index.html">Fortran</a> </span><span
+ style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></p>
+ </td>
+ </tr>
+</table>
+
+</div>
+
+<div class=MsoNormal align=center style='text-align:center'><span
+style='mso-fareast-font-family:"Times New Roman"'>
+
+<hr size=3 width="100%" align=center>
+
+</span></div>
+
+<p class=MsoNormal><span style='mso-fareast-font-family:"Times New Roman"'><script language="JavaScript">
<!--
document.writeln(' \
<address> \
Last modified: 4 February 2010 <br> \
</address> \
');
--->
-</SCRIPT>
-
-</body>
- </html>
+-->
+</script><o:p> </o:p></span></p>
+
+<!-- #EndLibraryItem --><?php include("../ed_libs/Footer2.htm"); ?></div>
+
+</body>
+
+</html>
diff --git a/html/RM/H5L/H5Literate_by_name.htm b/html/RM/H5L/H5Literate_by_name.htm
index 8116936..31b4710 100644
--- a/html/RM/H5L/H5Literate_by_name.htm
+++ b/html/RM/H5L/H5Literate_by_name.htm
@@ -23,7 +23,7 @@
<hr>
<dl>
<dt><div align=right><font color=999999 size=-1><i>
- Last modified: 26 September 2014
+ Last modified: 28 March 2016
</i></font></div>
<dt><strong>Name:</strong> <a name="Link-IterateByName">H5Literate_by_name</a>
@@ -36,7 +36,7 @@
<em>hsize_t</em> *<code>idx</code>,
<em>H5L_iterate_t</em> <code>op</code>,
<em>void</em> *<code>op_data</code>,
- <em>hid_t</em> *<code>lapl_id</code>
+ <em>hid_t</em> <code>lapl_id</code>
)
<p>
<dt><strong>Purpose:</strong>
diff --git a/java/examples/datasets/Makefile.am b/java/examples/datasets/Makefile.am
index 49888a0..41ba6d1 100644
--- a/java/examples/datasets/Makefile.am
+++ b/java/examples/datasets/Makefile.am
@@ -26,7 +26,7 @@ JAVA_API=yes
JAVAROOT = .classes
classes:
- $(MKDIR_P) $(@D)/$(JAVAROOT)
+ test -d $(@D)/$(JAVAROOT) || $(MKDIR_P) $(@D)/$(JAVAROOT)
pkgpath = examples/datasets
hdfjarfile = jar$(PACKAGE_TARNAME)-$(PACKAGE_VERSION).jar
@@ -71,7 +71,7 @@ TEST_SCRIPT = $(check_SCRIPTS)
CLEANFILES = classnoinst.stamp $(jarfile) $(JAVAROOT)/$(pkgpath)/*.class runExample.sh
clean:
- rm -rf $(JAVAROOT)
+ rm -rf $(JAVAROOT)/*
rm -f $(jarfile)
rm -f classnoinst.stamp
diff --git a/java/examples/datasets/Makefile.in b/java/examples/datasets/Makefile.in
index f33198b..52210af 100644
--- a/java/examples/datasets/Makefile.in
+++ b/java/examples/datasets/Makefile.in
@@ -1097,7 +1097,7 @@ help:
@$(top_srcdir)/bin/makehelp
classes:
- $(MKDIR_P) $(@D)/$(JAVAROOT)
+ test -d $(@D)/$(JAVAROOT) || $(MKDIR_P) $(@D)/$(JAVAROOT)
$(jarfile): classnoinst.stamp classes
$(JAR) cvf $@ -C $(JAVAROOT)/ $(pkgpath)
@@ -1105,7 +1105,7 @@ $(jarfile): classnoinst.stamp classes
.PHONY: classes
clean:
- rm -rf $(JAVAROOT)
+ rm -rf $(JAVAROOT)/*
rm -f $(jarfile)
rm -f classnoinst.stamp
diff --git a/java/examples/datasets/runExample.sh.in b/java/examples/datasets/runExample.sh.in
index 8ac28a7..83b06ec 100644
--- a/java/examples/datasets/runExample.sh.in
+++ b/java/examples/datasets/runExample.sh.in
@@ -100,7 +100,7 @@ COPY_LIBFILES_TO_BLDLIBDIR()
# make cp fail
SDIR=`$DIRNAME $tstfile`
INODE_SDIR=`$LS -i -d $SDIR | $AWK -F' ' '{print $1}'`
- INODE_DDIR=`$LS -i -d $TESTDIR | $AWK -F' ' '{print $1}'`
+ INODE_DDIR=`$LS -i -d $BLDLIBDIR | $AWK -F' ' '{print $1}'`
if [ "$INODE_SDIR" != "$INODE_DDIR" ]; then
$CP -f $tstfile $BLDLIBDIR
if [ $? -ne 0 ]; then
@@ -119,9 +119,9 @@ CLEAN_LIBFILES_AND_BLDLIBDIR()
# skip rm if srcdir is same as destdir
# this occurs when build/test performed in source dir and
# make cp fail
- SDIR=`$DIRNAME $tstfile`
+ SDIR=`$DIRNAME $HDFLIB_HOME/slf4j-api-1.7.5.jar`
INODE_SDIR=`$LS -i -d $SDIR | $AWK -F' ' '{print $1}'`
- INODE_DDIR=`$LS -i -d $TESTDIR | $AWK -F' ' '{print $1}'`
+ INODE_DDIR=`$LS -i -d $BLDLIBDIR | $AWK -F' ' '{print $1}'`
if [ "$INODE_SDIR" != "$INODE_DDIR" ]; then
$RM $BLDLIBDIR
fi
@@ -143,7 +143,7 @@ COPY_DATAFILES_TO_BLDDIR()
# make cp fail
SDIR=`$DIRNAME $tstfile`
INODE_SDIR=`$LS -i -d $SDIR | $AWK -F' ' '{print $1}'`
- INODE_DDIR=`$LS -i -d $TESTDIR | $AWK -F' ' '{print $1}'`
+ INODE_DDIR=`$LS -i -d $BLDDIR | $AWK -F' ' '{print $1}'`
if [ "$INODE_SDIR" != "$INODE_DDIR" ]; then
$CP -f $tstfile $BLDDIR
if [ $? -ne 0 ]; then
@@ -159,16 +159,8 @@ COPY_DATAFILES_TO_BLDDIR()
CLEAN_DATAFILES_AND_BLDDIR()
{
- # skip rm if srcdir is same as destdir
- # this occurs when build/test performed in source dir and
- # make cp fail
- SDIR=`$DIRNAME $tstfile`
- INODE_SDIR=`$LS -i -d $SDIR | $AWK -F' ' '{print $1}'`
- INODE_DDIR=`$LS -i -d $TESTDIR | $AWK -F' ' '{print $1}'`
- if [ "$INODE_SDIR" != "$INODE_DDIR" ]; then
- $RM $BLDDIR/*.txt
- $RM $BLDDIR/*.out
- fi
+ $RM $BLDDIR/examples.datasets.H5Ex_D_*.txt
+ $RM $BLDDIR/H5Ex_D_*.out
}
# Print a line-line message left justified in a field of 70 characters
diff --git a/java/examples/datatypes/Makefile.am b/java/examples/datatypes/Makefile.am
index de2ea9d..7d95a56 100644
--- a/java/examples/datatypes/Makefile.am
+++ b/java/examples/datatypes/Makefile.am
@@ -26,7 +26,7 @@ JAVA_API=yes
JAVAROOT = .classes
classes:
- $(MKDIR_P) $(@D)/$(JAVAROOT)
+ test -d $(@D)/$(JAVAROOT) || $(MKDIR_P) $(@D)/$(JAVAROOT)
pkgpath = examples/datatypes
hdfjarfile = jar$(PACKAGE_TARNAME)-$(PACKAGE_VERSION).jar
@@ -71,7 +71,7 @@ TEST_SCRIPT = $(check_SCRIPTS)
CLEANFILES = classnoinst.stamp $(jarfile) $(JAVAROOT)/$(pkgpath)/*.class runExample.sh
clean:
- rm -rf $(JAVAROOT)
+ rm -rf $(JAVAROOT)/*
rm -f $(jarfile)
rm -f classnoinst.stamp
diff --git a/java/examples/datatypes/Makefile.in b/java/examples/datatypes/Makefile.in
index efeaa02..c8a1bd3 100644
--- a/java/examples/datatypes/Makefile.in
+++ b/java/examples/datatypes/Makefile.in
@@ -1097,7 +1097,7 @@ help:
@$(top_srcdir)/bin/makehelp
classes:
- $(MKDIR_P) $(@D)/$(JAVAROOT)
+ test -d $(@D)/$(JAVAROOT) || $(MKDIR_P) $(@D)/$(JAVAROOT)
$(jarfile): classnoinst.stamp classes
$(JAR) cvf $@ -C $(JAVAROOT)/ $(pkgpath)
@@ -1105,7 +1105,7 @@ $(jarfile): classnoinst.stamp classes
.PHONY: classes
clean:
- rm -rf $(JAVAROOT)
+ rm -rf $(JAVAROOT)/*
rm -f $(jarfile)
rm -f classnoinst.stamp
diff --git a/java/examples/datatypes/runExample.sh.in b/java/examples/datatypes/runExample.sh.in
index 9ed3954..f80450e 100644
--- a/java/examples/datatypes/runExample.sh.in
+++ b/java/examples/datatypes/runExample.sh.in
@@ -97,7 +97,7 @@ COPY_LIBFILES_TO_BLDLIBDIR()
# make cp fail
SDIR=`$DIRNAME $tstfile`
INODE_SDIR=`$LS -i -d $SDIR | $AWK -F' ' '{print $1}'`
- INODE_DDIR=`$LS -i -d $TESTDIR | $AWK -F' ' '{print $1}'`
+ INODE_DDIR=`$LS -i -d $BLDLIBDIR | $AWK -F' ' '{print $1}'`
if [ "$INODE_SDIR" != "$INODE_DDIR" ]; then
$CP -f $tstfile $BLDLIBDIR
if [ $? -ne 0 ]; then
@@ -116,9 +116,9 @@ CLEAN_LIBFILES_AND_BLDLIBDIR()
# skip rm if srcdir is same as destdir
# this occurs when build/test performed in source dir and
# make cp fail
- SDIR=`$DIRNAME $tstfile`
+ SDIR=`$DIRNAME $HDFLIB_HOME/slf4j-api-1.7.5.jar`
INODE_SDIR=`$LS -i -d $SDIR | $AWK -F' ' '{print $1}'`
- INODE_DDIR=`$LS -i -d $TESTDIR | $AWK -F' ' '{print $1}'`
+ INODE_DDIR=`$LS -i -d $BLDLIBDIR | $AWK -F' ' '{print $1}'`
if [ "$INODE_SDIR" != "$INODE_DDIR" ]; then
$RM $BLDLIBDIR
fi
@@ -140,7 +140,7 @@ COPY_DATAFILES_TO_BLDDIR()
# make cp fail
SDIR=`$DIRNAME $tstfile`
INODE_SDIR=`$LS -i -d $SDIR | $AWK -F' ' '{print $1}'`
- INODE_DDIR=`$LS -i -d $TESTDIR | $AWK -F' ' '{print $1}'`
+ INODE_DDIR=`$LS -i -d $BLDDIR | $AWK -F' ' '{print $1}'`
if [ "$INODE_SDIR" != "$INODE_DDIR" ]; then
$CP -f $tstfile $BLDDIR
if [ $? -ne 0 ]; then
@@ -156,16 +156,8 @@ COPY_DATAFILES_TO_BLDDIR()
CLEAN_DATAFILES_AND_BLDDIR()
{
- # skip rm if srcdir is same as destdir
- # this occurs when build/test performed in source dir and
- # make cp fail
- SDIR=`$DIRNAME $tstfile`
- INODE_SDIR=`$LS -i -d $SDIR | $AWK -F' ' '{print $1}'`
- INODE_DDIR=`$LS -i -d $TESTDIR | $AWK -F' ' '{print $1}'`
- if [ "$INODE_SDIR" != "$INODE_DDIR" ]; then
- $RM $BLDDIR/*.txt
- $RM $BLDDIR/*.out
- fi
+ $RM $BLDDIR/examples.datatypes.H5Ex_T_*.txt
+ $RM $BLDDIR/H5Ex_T_*.out
}
# Print a line-line message left justified in a field of 70 characters
diff --git a/java/examples/groups/Makefile.am b/java/examples/groups/Makefile.am
index 802e2b0..be15b42 100644
--- a/java/examples/groups/Makefile.am
+++ b/java/examples/groups/Makefile.am
@@ -26,7 +26,7 @@ JAVA_API=yes
JAVAROOT = .classes
classes:
- $(MKDIR_P) $(@D)/$(JAVAROOT)
+ test -d $(@D)/$(JAVAROOT) || $(MKDIR_P) $(@D)/$(JAVAROOT)
pkgpath = examples/groups
hdfjarfile = jar$(PACKAGE_TARNAME)-$(PACKAGE_VERSION).jar
@@ -61,7 +61,7 @@ TEST_SCRIPT = $(check_SCRIPTS)
CLEANFILES = classnoinst.stamp $(jarfile) $(JAVAROOT)/$(pkgpath)/*.class runExample.sh
clean:
- rm -rf $(JAVAROOT)
+ rm -rf $(JAVAROOT)/*
rm -f $(jarfile)
rm -f classnoinst.stamp
diff --git a/java/examples/groups/Makefile.in b/java/examples/groups/Makefile.in
index 9e3308a..575e562 100644
--- a/java/examples/groups/Makefile.in
+++ b/java/examples/groups/Makefile.in
@@ -1086,7 +1086,7 @@ help:
@$(top_srcdir)/bin/makehelp
classes:
- $(MKDIR_P) $(@D)/$(JAVAROOT)
+ test -d $(@D)/$(JAVAROOT) || $(MKDIR_P) $(@D)/$(JAVAROOT)
$(jarfile): classnoinst.stamp classes
$(JAR) cvf $@ -C $(JAVAROOT)/ $(pkgpath)
@@ -1094,7 +1094,7 @@ $(jarfile): classnoinst.stamp classes
.PHONY: classes
clean:
- rm -rf $(JAVAROOT)
+ rm -rf $(JAVAROOT)/*
rm -f $(jarfile)
rm -f classnoinst.stamp
diff --git a/java/examples/groups/runExample.sh.in b/java/examples/groups/runExample.sh.in
index a59a894..7dddc6d 100644
--- a/java/examples/groups/runExample.sh.in
+++ b/java/examples/groups/runExample.sh.in
@@ -92,7 +92,7 @@ COPY_LIBFILES_TO_BLDLIBDIR()
# make cp fail
SDIR=`$DIRNAME $tstfile`
INODE_SDIR=`$LS -i -d $SDIR | $AWK -F' ' '{print $1}'`
- INODE_DDIR=`$LS -i -d $TESTDIR | $AWK -F' ' '{print $1}'`
+ INODE_DDIR=`$LS -i -d $BLDLIBDIR | $AWK -F' ' '{print $1}'`
if [ "$INODE_SDIR" != "$INODE_DDIR" ]; then
$CP -f $tstfile $BLDLIBDIR
if [ $? -ne 0 ]; then
@@ -111,9 +111,9 @@ CLEAN_LIBFILES_AND_BLDLIBDIR()
# skip rm if srcdir is same as destdir
# this occurs when build/test performed in source dir and
# make cp fail
- SDIR=`$DIRNAME $tstfile`
+ SDIR=`$DIRNAME $HDFLIB_HOME/slf4j-api-1.7.5.jar`
INODE_SDIR=`$LS -i -d $SDIR | $AWK -F' ' '{print $1}'`
- INODE_DDIR=`$LS -i -d $TESTDIR | $AWK -F' ' '{print $1}'`
+ INODE_DDIR=`$LS -i -d $BLDLIBDIR | $AWK -F' ' '{print $1}'`
if [ "$INODE_SDIR" != "$INODE_DDIR" ]; then
$RM $BLDLIBDIR
fi
@@ -135,7 +135,7 @@ COPY_DATAFILES_TO_BLDDIR()
# make cp fail
SDIR=`$DIRNAME $tstfile`
INODE_SDIR=`$LS -i -d $SDIR | $AWK -F' ' '{print $1}'`
- INODE_DDIR=`$LS -i -d $TESTDIR | $AWK -F' ' '{print $1}'`
+ INODE_DDIR=`$LS -i -d $BLDDIR | $AWK -F' ' '{print $1}'`
if [ "$INODE_SDIR" != "$INODE_DDIR" ]; then
$CP -f $tstfile $BLDDIR
if [ $? -ne 0 ]; then
@@ -151,16 +151,8 @@ COPY_DATAFILES_TO_BLDDIR()
CLEAN_DATAFILES_AND_BLDDIR()
{
- # skip rm if srcdir is same as destdir
- # this occurs when build/test performed in source dir and
- # make cp fail
- SDIR=`$DIRNAME $tstfile`
- INODE_SDIR=`$LS -i -d $SDIR | $AWK -F' ' '{print $1}'`
- INODE_DDIR=`$LS -i -d $TESTDIR | $AWK -F' ' '{print $1}'`
- if [ "$INODE_SDIR" != "$INODE_DDIR" ]; then
- $RM $BLDDIR/*.txt
- $RM $BLDDIR/*.out
- fi
+ $RM $BLDDIR/examples.groups.H5Ex_G_*.txt
+ $RM $BLDDIR/H5Ex_G_*.out
}
COPY_REFFILES="$LIST_REF_FILES"
@@ -179,7 +171,7 @@ COPY_REFFILES_TO_BLDREFDIR()
# make cp fail
SDIR=`$DIRNAME $tstfile`
INODE_SDIR=`$LS -i -d $SDIR | $AWK -F' ' '{print $1}'`
- INODE_DDIR=`$LS -i -d $TESTDIR | $AWK -F' ' '{print $1}'`
+ INODE_DDIR=`$LS -i -d $BLDREFDIR | $AWK -F' ' '{print $1}'`
if [ "$INODE_SDIR" != "$INODE_DDIR" ]; then
$CP -f $tstfile $BLDREFDIR
if [ $? -ne 0 ]; then
@@ -198,9 +190,9 @@ CLEAN_REFFILES_AND_BLDREFDIR()
# skip rm if srcdir is same as destdir
# this occurs when build/test performed in source dir and
# make cp fail
- SDIR=`$DIRNAME $tstfile`
+ SDIR=`$DIRNAME $HDFTEST_HOME/h5ex_g_iterate.h5`
INODE_SDIR=`$LS -i -d $SDIR | $AWK -F' ' '{print $1}'`
- INODE_DDIR=`$LS -i -d $TESTDIR | $AWK -F' ' '{print $1}'`
+ INODE_DDIR=`$LS -i -d $BLDREFDIR | $AWK -F' ' '{print $1}'`
if [ "$INODE_SDIR" != "$INODE_DDIR" ]; then
$RM $BLDREFDIR
fi
diff --git a/java/examples/intro/Makefile.am b/java/examples/intro/Makefile.am
index fef33d2..3d5757a 100644
--- a/java/examples/intro/Makefile.am
+++ b/java/examples/intro/Makefile.am
@@ -26,7 +26,7 @@ JAVA_API=yes
JAVAROOT = .classes
classes:
- $(MKDIR_P) $(@D)/$(JAVAROOT)
+ test -d $(@D)/$(JAVAROOT) || $(MKDIR_P) $(@D)/$(JAVAROOT)
pkgpath = examples/intro
hdfjarfile = jar$(PACKAGE_TARNAME)-$(PACKAGE_VERSION).jar
@@ -60,7 +60,7 @@ TEST_SCRIPT = $(check_SCRIPTS)
CLEANFILES = classnoinst.stamp $(jarfile) $(JAVAROOT)/$(pkgpath)/*.class runExample.sh
clean:
- rm -rf $(JAVAROOT)
+ rm -rf $(JAVAROOT)/*
rm -f $(jarfile)
rm -f classnoinst.stamp
diff --git a/java/examples/intro/Makefile.in b/java/examples/intro/Makefile.in
index da3b27d..e1cc51a 100644
--- a/java/examples/intro/Makefile.in
+++ b/java/examples/intro/Makefile.in
@@ -1086,7 +1086,7 @@ help:
@$(top_srcdir)/bin/makehelp
classes:
- $(MKDIR_P) $(@D)/$(JAVAROOT)
+ test -d $(@D)/$(JAVAROOT) || $(MKDIR_P) $(@D)/$(JAVAROOT)
$(jarfile): classnoinst.stamp classes
$(JAR) cvf $@ -C $(JAVAROOT)/ $(pkgpath)
@@ -1094,7 +1094,7 @@ $(jarfile): classnoinst.stamp classes
.PHONY: classes
clean:
- rm -rf $(JAVAROOT)
+ rm -rf $(JAVAROOT)/*
rm -f $(jarfile)
rm -f classnoinst.stamp
diff --git a/java/examples/intro/runExample.sh.in b/java/examples/intro/runExample.sh.in
index ecc51ca..60ea765 100644
--- a/java/examples/intro/runExample.sh.in
+++ b/java/examples/intro/runExample.sh.in
@@ -86,7 +86,7 @@ COPY_LIBFILES_TO_BLDLIBDIR()
# make cp fail
SDIR=`$DIRNAME $tstfile`
INODE_SDIR=`$LS -i -d $SDIR | $AWK -F' ' '{print $1}'`
- INODE_DDIR=`$LS -i -d $TESTDIR | $AWK -F' ' '{print $1}'`
+ INODE_DDIR=`$LS -i -d $BLDLIBDIR | $AWK -F' ' '{print $1}'`
if [ "$INODE_SDIR" != "$INODE_DDIR" ]; then
$CP -f $tstfile $BLDLIBDIR
if [ $? -ne 0 ]; then
@@ -105,9 +105,9 @@ CLEAN_LIBFILES_AND_BLDLIBDIR()
# skip rm if srcdir is same as destdir
# this occurs when build/test performed in source dir and
# make cp fail
- SDIR=`$DIRNAME $tstfile`
+ SDIR=`$DIRNAME $HDFLIB_HOME/slf4j-api-1.7.5.jar`
INODE_SDIR=`$LS -i -d $SDIR | $AWK -F' ' '{print $1}'`
- INODE_DDIR=`$LS -i -d $TESTDIR | $AWK -F' ' '{print $1}'`
+ INODE_DDIR=`$LS -i -d $BLDLIBDIR | $AWK -F' ' '{print $1}'`
if [ "$INODE_SDIR" != "$INODE_DDIR" ]; then
$RM $BLDLIBDIR
fi
@@ -129,7 +129,7 @@ COPY_DATAFILES_TO_BLDDIR()
# make cp fail
SDIR=`$DIRNAME $tstfile`
INODE_SDIR=`$LS -i -d $SDIR | $AWK -F' ' '{print $1}'`
- INODE_DDIR=`$LS -i -d $TESTDIR | $AWK -F' ' '{print $1}'`
+ INODE_DDIR=`$LS -i -d $BLDDIR | $AWK -F' ' '{print $1}'`
if [ "$INODE_SDIR" != "$INODE_DDIR" ]; then
$CP -f $tstfile $BLDDIR
if [ $? -ne 0 ]; then
@@ -145,16 +145,8 @@ COPY_DATAFILES_TO_BLDDIR()
CLEAN_DATAFILES_AND_BLDDIR()
{
- # skip rm if srcdir is same as destdir
- # this occurs when build/test performed in source dir and
- # make cp fail
- SDIR=`$DIRNAME $tstfile`
- INODE_SDIR=`$LS -i -d $SDIR | $AWK -F' ' '{print $1}'`
- INODE_DDIR=`$LS -i -d $TESTDIR | $AWK -F' ' '{print $1}'`
- if [ "$INODE_SDIR" != "$INODE_DDIR" ]; then
- $RM $BLDDIR/*.txt
- $RM $BLDDIR/*.out
- fi
+ $RM $BLDDIR/examples.intro.H5_*.txt
+ $RM $BLDDIR/H5_*.out
}
# Print a line-line message left justified in a field of 70 characters
diff --git a/java/src/Makefile.am b/java/src/Makefile.am
index ff8b01a..21aa5ec 100644
--- a/java/src/Makefile.am
+++ b/java/src/Makefile.am
@@ -33,7 +33,7 @@ SUBDIRS=jni
JAVAROOT = .classes
classes:
- $(MKDIR_P) $(@D)/$(JAVAROOT)
+ test -d $(@D)/$(JAVAROOT) || $(MKDIR_P) $(@D)/$(JAVAROOT)
jarfile = jar$(PACKAGE_TARNAME)-$(PACKAGE_VERSION).jar
hdf5_javadir = $(libdir)
@@ -128,7 +128,7 @@ docs:
CLEANFILES = classhdf5_java.stamp $(jarfile) $(JAVAROOT)/$(pkgpath)/callbacks/*.class $(JAVAROOT)/$(pkgpath)/exceptions/*.class $(JAVAROOT)/$(pkgpath)/structs/*.class $(JAVAROOT)/$(pkgpath)/*.class
clean:
- rm -rf $(JAVAROOT)
+ rm -rf $(JAVAROOT)/*
rm -f $(jarfile)
rm -f classhdf5_java.stamp
diff --git a/java/src/Makefile.in b/java/src/Makefile.in
index 5d7667d..59ad7e3 100644
--- a/java/src/Makefile.in
+++ b/java/src/Makefile.in
@@ -1025,7 +1025,7 @@ help:
@$(top_srcdir)/bin/makehelp
classes:
- $(MKDIR_P) $(@D)/$(JAVAROOT)
+ test -d $(@D)/$(JAVAROOT) || $(MKDIR_P) $(@D)/$(JAVAROOT)
$(jarfile): classhdf5_java.stamp classes docs
$(JAR) cvf $@ -C $(JAVAROOT)/ $(pkgpath)
@@ -1036,7 +1036,7 @@ docs:
$(JAVADOC) -sourcepath $(srcdir) -d javadoc -use -splitIndex -windowtitle $(WINDOWTITLE) -doctitle $(DOCTITLE) -J-Xmx180m -verbose -overview $(top_srcdir)/java/src/hdf/overview.html -classpath $(CLASSPATH_ENV) hdf.hdf5lib
clean:
- rm -rf $(JAVAROOT)
+ rm -rf $(JAVAROOT)/*
rm -f $(jarfile)
rm -f classhdf5_java.stamp
diff --git a/java/src/jni/Makefile.am b/java/src/jni/Makefile.am
index 764fcdb..4667407 100644
--- a/java/src/jni/Makefile.am
+++ b/java/src/jni/Makefile.am
@@ -31,7 +31,7 @@ AM_CPPFLAGS+=-I$(top_srcdir)/src -I$(top_srcdir)/java/src/jni $(JNIFLAGS)
lib_LTLIBRARIES=libhdf5_java.la
# Add libtool numbers to the HDF5 Java (JNI) library (from config/lt_vers.am)
-libhdf5_java_la_LDFLAGS= -version-info $(LT_VERS_INTERFACE):$(LT_VERS_REVISION):$(LT_VERS_AGE) $(AM_LDFLAGS)
+libhdf5_java_la_LDFLAGS= -version-info $(LT_JAVA_VERS_INTERFACE):$(LT_JAVA_VERS_REVISION):$(LT_JAVA_VERS_AGE) $(AM_LDFLAGS)
# Source files for the library
libhdf5_java_la_SOURCES=exceptionImp.c h5Constants.c nativeData.c h5util.c h5Imp.c \
diff --git a/java/src/jni/Makefile.in b/java/src/jni/Makefile.in
index a94d4b9..39879e0 100644
--- a/java/src/jni/Makefile.in
+++ b/java/src/jni/Makefile.in
@@ -738,6 +738,27 @@ CHECK_CLEANFILES = *.chkexe *.chklog *.clog *.clog2
LT_VERS_INTERFACE = 100
LT_VERS_REVISION = 0
LT_VERS_AGE = 0
+LT_CXX_VERS_INTERFACE = 100
+LT_CXX_VERS_REVISION = 0
+LT_CXX_VERS_AGE = 0
+LT_F_VERS_INTERFACE = 100
+LT_F_VERS_REVISION = 0
+LT_F_VERS_AGE = 0
+LT_HL_VERS_INTERFACE = 100
+LT_HL_VERS_REVISION = 0
+LT_HL_VERS_AGE = 0
+LT_HL_CXX_VERS_INTERFACE = 100
+LT_HL_CXX_VERS_REVISION = 0
+LT_HL_CXX_VERS_AGE = 0
+LT_HL_F_VERS_INTERFACE = 100
+LT_HL_F_VERS_REVISION = 0
+LT_HL_F_VERS_AGE = 0
+LT_JAVA_VERS_INTERFACE = 100
+LT_JAVA_VERS_REVISION = 0
+LT_JAVA_VERS_AGE = 0
+LT_TOOLS_VERS_INTERFACE = 100
+LT_TOOLS_VERS_REVISION = 0
+LT_TOOLS_VERS_AGE = 0
# Mark this directory as part of the JNI API
JAVA_API = yes
@@ -746,7 +767,7 @@ JAVA_API = yes
lib_LTLIBRARIES = libhdf5_java.la
# Add libtool numbers to the HDF5 Java (JNI) library (from config/lt_vers.am)
-libhdf5_java_la_LDFLAGS = -version-info $(LT_VERS_INTERFACE):$(LT_VERS_REVISION):$(LT_VERS_AGE) $(AM_LDFLAGS)
+libhdf5_java_la_LDFLAGS = -version-info $(LT_JAVA_VERS_INTERFACE):$(LT_JAVA_VERS_REVISION):$(LT_JAVA_VERS_AGE) $(AM_LDFLAGS)
# Source files for the library
libhdf5_java_la_SOURCES = exceptionImp.c h5Constants.c nativeData.c h5util.c h5Imp.c \
diff --git a/java/test/Makefile.am b/java/test/Makefile.am
index 2c960ee..92ac12d 100644
--- a/java/test/Makefile.am
+++ b/java/test/Makefile.am
@@ -26,7 +26,7 @@ JAVA_API=yes
JAVAROOT = .classes
classes:
- $(MKDIR_P) $(@D)/$(JAVAROOT)
+ test -d $(@D)/$(JAVAROOT) || $(MKDIR_P) $(@D)/$(JAVAROOT)
pkgpath = test
hdfjarfile = jar$(PACKAGE_TARNAME)-$(PACKAGE_VERSION).jar
@@ -97,7 +97,7 @@ AllJunitTests :
chmod +x $@
clean:
- rm -rf $(JAVAROOT)
+ rm -rf $(JAVAROOT)/*
rm -f $(jarfile)
rm -f classnoinst.stamp
diff --git a/java/test/Makefile.in b/java/test/Makefile.in
index 384f000..bbc6322 100644
--- a/java/test/Makefile.in
+++ b/java/test/Makefile.in
@@ -1118,7 +1118,7 @@ help:
@$(top_srcdir)/bin/makehelp
classes:
- $(MKDIR_P) $(@D)/$(JAVAROOT)
+ test -d $(@D)/$(JAVAROOT) || $(MKDIR_P) $(@D)/$(JAVAROOT)
$(jarfile): classnoinst.stamp classes
$(JAR) cvf $@ -C $(JAVAROOT)/ $(pkgpath)
@@ -1132,7 +1132,7 @@ AllJunitTests :
chmod +x $@
clean:
- rm -rf $(JAVAROOT)
+ rm -rf $(JAVAROOT)/*
rm -f $(jarfile)
rm -f classnoinst.stamp
diff --git a/java/test/junit.sh.in b/java/test/junit.sh.in
index 94b3415..8de07e3 100644
--- a/java/test/junit.sh.in
+++ b/java/test/junit.sh.in
@@ -89,7 +89,7 @@ COPY_LIBFILES_TO_BLDLIBDIR()
# make cp fail
SDIR=`$DIRNAME $tstfile`
INODE_SDIR=`$LS -i -d $SDIR | $AWK -F' ' '{print $1}'`
- INODE_DDIR=`$LS -i -d $TESTDIR | $AWK -F' ' '{print $1}'`
+ INODE_DDIR=`$LS -i -d $BLDLIBDIR | $AWK -F' ' '{print $1}'`
if [ "$INODE_SDIR" != "$INODE_DDIR" ]; then
$CP -f $tstfile $BLDLIBDIR
if [ $? -ne 0 ]; then
@@ -108,9 +108,9 @@ CLEAN_LIBFILES_AND_BLDLIBDIR()
# skip rm if srcdir is same as destdir
# this occurs when build/test performed in source dir and
# make cp fail
- SDIR=`$DIRNAME $tstfile`
+ SDIR=`$DIRNAME $HDFLIB_HOME/junit.jar`
INODE_SDIR=`$LS -i -d $SDIR | $AWK -F' ' '{print $1}'`
- INODE_DDIR=`$LS -i -d $TESTDIR | $AWK -F' ' '{print $1}'`
+ INODE_DDIR=`$LS -i -d $BLDLIBDIR | $AWK -F' ' '{print $1}'`
if [ "$INODE_SDIR" != "$INODE_DDIR" ]; then
$RM $BLDLIBDIR
fi
@@ -132,7 +132,7 @@ COPY_DATAFILES_TO_BLDDIR()
# make cp fail
SDIR=`$DIRNAME $tstfile`
INODE_SDIR=`$LS -i -d $SDIR | $AWK -F' ' '{print $1}'`
- INODE_DDIR=`$LS -i -d $TESTDIR | $AWK -F' ' '{print $1}'`
+ INODE_DDIR=`$LS -i -d $BLDDIR | $AWK -F' ' '{print $1}'`
if [ "$INODE_SDIR" != "$INODE_DDIR" ]; then
$CP -f $tstfile $BLDDIR
if [ $? -ne 0 ]; then
@@ -151,9 +151,9 @@ CLEAN_DATAFILES_AND_BLDDIR()
# skip rm if srcdir is same as destdir
# this occurs when build/test performed in source dir and
# make cp fail
- SDIR=`$DIRNAME $tstfile`
+ SDIR=`$DIRNAME $HDFTEST_HOME/h5ex_g_iterate.hdf`
INODE_SDIR=`$LS -i -d $SDIR | $AWK -F' ' '{print $1}'`
- INODE_DDIR=`$LS -i -d $TESTDIR | $AWK -F' ' '{print $1}'`
+ INODE_DDIR=`$LS -i -d $BLDDIR | $AWK -F' ' '{print $1}'`
if [ "$INODE_SDIR" != "$INODE_DDIR" ]; then
$RM $BLDDIR/*.hdf
$RM $BLDDIR/*.out
diff --git a/release_docs/INSTALL b/release_docs/INSTALL
index d09aaa9..edd2c93 100644
--- a/release_docs/INSTALL
+++ b/release_docs/INSTALL
@@ -275,7 +275,47 @@ CONTENTS
$ CC=/usr/local/mpi/bin/mpicc ./configure
-4.3.3. Configuring for 64-bit support
+4.3.3. Debug vs. production builds
+
+ The HDF5 library can be built in either debug or production mode.
+ The primary difference between these in HDF5 1.10.0 is that each
+ mode specifies different default values for other configure options
+ such as --enable-symbols.
+
+ To build in debug mode:
+
+ $ ./configure --enable-build-mode=debug
+
+ To build in production mode:
+
+ $ ./configure --enable-build-mode=production
+
+ To build in clean mode:
+
+ $ ./configure --enable-build-mode=clean
+
+ "Clean mode" is a minimalist configuration. e.g., no symbols, no
+ optimization, etc.
+
+ Previously, --enable-debug and --enable-production were used to
+ configure the build mode. Since the new options have somewhat
+ different semantics from these original options, these older
+ options have been deprecated and will cause the configuration
+ step to abort if used.
+
+ Release branches and distributions (e.g, HDF5 1.10.0) are set to
+ build in production mode by default. All other branches and
+ distributions (e.g., trunk, snapshots, HDF5 1.10 development branch)
+ will build in debug mode by default.
+
+ Assertions and other low-overhead sanity checks are controlled
+ separately via the --enable-asserts option (which itself primarily
+ controls the NDEBUG setting). This is enabled by default in debug
+ builds but can be configured independently of the build type.
+
+ $ ./configure --enable-asserts
+
+4.3.4. Configuring for 64-bit support
Several machine architectures support 32-bit or 64-bit binaries.
The options below describe how to enable support for different options.
@@ -299,38 +339,72 @@ CONTENTS
$ CFLAGS=-q64 FCFLAGS=-q64 AR='ar -X 64'\
./configure --enable-fortran
-4.3.4. Additional compilation flags
+ Configure should automatically enable large file system (LFS) support
+ for autotools builds regardless of platform and architecture. If
+ this is not true for a platform, please contact the HDF Group
+ help desk at help at hdfgroup.org.
+
+4.3.5. Additional compilation flags
If addtional flags must be passed to the compilation commands,
specify those flags with the CFLAGS variable. For instance,
- to enable symbolic debugging of a production version of HDF5, one
- might say:
+ to use pipes instead of temporary files when compiling, you
+ can enter:
- $ CFLAGS=-g ./configure --enable-production
+ $ CFLAGS=-pipe ./configure
-4.3.5. Compiling HDF5 wrapper libraries
- One can optionally build the Fortran and/or C++ interfaces to the
- HDF5 C library. By default, both options are disabled. To build
- them, specify `--enable-fortran' and `--enable-cxx', respectively.
+4.3.6. Compiling HDF5 wrapper libraries
+ One can optionally build the Fortran, C++, and/or Java JNI interfaces
+ to the HDF5 C library. By default, all of these options are disabled.
+ To build them, specify --enable-fortran, --enable-cxx, and/or
+ --enable-java, respectively.
$ ./configure --enable-fortran
$ ./configure --enable-cxx
+ $ ./configure --enable-java
- Configuration will halt if a working Fortran 90 or 95 compiler or
- C++ compiler is not found. Currently, the Fortran configure tests
- for these compilers in order: f90, pgf90, f95. To use an
- alternate compiler specify it with the FC variable:
+ Configuration will halt if a working Fortran 2003, C++, or
+ Java compiler is not found. To use an alternate Fortran compiler,
+ specify it with the FC variable:
$ FC=/usr/local/bin/g95 ./configure --enable-fortran
- Note: The Fortran and C++ interfaces are not supported on all the
+ CXX can similarly be used to specify an alternative C++ compiler.
+
+ The libraries are compiled with flags and settings that are
+ distinct from the HDF5 library. These settings are specified in
+ platform- and compiler-specific configuration files in the config/
+ directory in the source tree. An exception to this is when a custom
+ string is used to specify profiling, symbols, and/or optimization
+ options. These flags will be used everywhere.
+
+ Note: The Fortran, C++, and Java interfaces are not supported on all
platforms the main HDF5 Library supports. Also, the Fortran
- interface supports parallel HDF5 while the C++ interface does
- not.
+ interface supports parallel HDF5 while the C++ and Java
+ interfaces do not. None of the interfaces supports
+ thread-safety.
Note: See sections 4.7 and 4.8 for building the Fortran library with
- Intel or PGI compilers.
+ Intel or PGI compilers.
+
+ A high-level wrapper library that contains some convenience and
+ special-purpose functions and tools can also be built with the
+ library. By default, this library is normally built along with
+ the C library. The high-level library is not supported when the
+ thread-safe HDF5 library is built, however, and will either have
+ to be explicitly disabled or the --enable-unsupported configure
+ option will have to be used.
+
+ $ ./configure --enable-threadsafe --disable-hl
+
+ OR
-4.3.6. Specifying other programs
+ $ ./configure --enable-threadsafe --enable-unsupported
+
+ This is admittedly a little awkward but it avoids the more common
+ case of users having to specify --enable-hl for all builds if we
+ disabled building the high-level library by default.
+
+4.3.7. Specifying other programs
The build system has been tuned for use with GNU make but also
works with other versions of make. If the `make' command runs a
non-GNU version but a GNU version is available under a different
@@ -364,7 +438,7 @@ CONTENTS
because the HDF5 makefiles also use the install program to
change file ownership and/or access permissions.
-4.3.7. Specifying other libraries and headers
+4.3.8. Specifying other libraries and headers
Configure searches the standard places (those places known by the
systems compiler) for include files and header files. However,
additional directories can be specified by using the CPPFLAGS
@@ -394,7 +468,7 @@ CONTENTS
$ ./configure --with-szlib=/Szip_Install_Directory
-4.3.8. Static versus shared linking
+4.3.9. Static versus shared linking
The build process will create static libraries on all systems and
shared libraries on systems that support dynamic linking to a
sufficient degree. Either form of the library may be suppressed by
@@ -410,62 +484,168 @@ CONTENTS
$ ./configure --enable-static-exec
-4.3.9. Optimization versus symbolic debugging
+4.3.10. Symbolic debugging and profiling
The library can be compiled to provide symbolic debugging support
- so it can be debugged with gdb, dbx, ddd, etc., or it can be
- compiled with various optimizations. To compile for symbolic
- debugging (the default for snapshots), say `--disable-production';
- to compile with optimizations (the default for supported public
- releases), say `--enable-production'. On some systems the library
- can also be compiled for profiling with gprof by saying
- `--enable-production=profile'.
-
- $ ./configure --disable-production #symbolic debugging
- $ ./configure --enable-production #optimized code
- $ ./configure --enable-production=profile #for use with gprof
+ so it can be debugged with gdb, dbx, ddd, etc. To compile for
+ symbolic, use --enable-symbols:
+
+ $ ./configure --enable-symbols
+
+ The --enable-symbols option can optionally take a flags string
+ which the library will use to build the library and wrappers.
+ This can be used to enable special settings like -ggdb to be
+ used:
+
+ $ ./configure --enable-symbols=-ggdb
+
+ In most cases, when symbols are not enabled the option to
+ strip all symbols (e.g., -s w/ gcc) will be added to the
+ compiler/linker flags.
Regardless of whether support for symbolic debugging is enabled,
the library can also perform runtime debugging of certain packages
(such as type conversion execution times and extensive invariant
- condition checking). To enable this debugging, supply a
- comma-separated list of package names to to the `--enable-debug'
- switch. See "Debugging HDF5 Applications" for a list of package
- names:
-
- http://www.hdfgroup.org/HDF5/doc/H5.user/Debugging.html
-
- Debugging can be disabled by saying `--disable-debug'.
- The default debugging level for snapshots is a subset of the
- available packages; the default for supported releases is no
- debugging (debugging can incur a significant runtime penalty).
-
- $ ./configure --enable-debug=s,t #debug only H5S and H5T
- $ ./configure --enable-debug #debug normal packages
- $ ./configure --enable-debug=all #debug all packages
- $ ./configure --disable-debug #no debugging
-
- HDF5 can also print a trace of all API function calls, their
- arguments, and the return values. To enable or disable the
- ability to trace the API say `--enable-trace' (the default for
- snapthots) or `--disable-trace' (the default for public releases).
+ condition checking). These checks are generally more intensive
+ than the simple asserts and low-overhead checks enabled by
+ --enable-asserts. Note that some of these checks can significantly
+ slow down the library.
+
+ To enable this debugging, supply a comma-separated list of package
+ names to to the --enable-internal-debug option.
+
+ Current packages that can perform extra checks:
+
+ AC,B,B2,D,F,FA,FL,FS,HL,I,O,S,ST,T,Z
+
+ Any subset can be specified:
+
+ $ ./configure --enable-internal-debug="B,B2,EA,FA"
+
+ Not all packages will generate special debug checks. Configure
+ simply defines an H5<pkg>_DEBUG symbol for each package in the
+ list so there is no harm in specifying arbitrary packages. The
+ string "all" can be used to specify "all reasonable" packages,
+ though even this excludes a few packages (e.g.: B) that have
+ severe run-time penalties.
+
+ In general, the internal debug option is intended for HDF Group
+ use and, outside of the default settings, will not be of
+ interest the the average user.
+
+ The HDF5 library can also print a trace of all API function calls,
+ their arguments, and the return values. To enable or disable the
+ ability to trace the API use --enable-trace (the default for
+ debug mode) or --disable-trace (the default for production mode).
The tracing must also be enabled at runtime to see any output
(see "Debugging HDF5 Applications," reference above).
-4.3.10. Parallel versus serial library
+ Profiling can be enabled with --enable-profiling. This will set
+ appropriate flags for a common profiler for the platform (usually
+ gprof). Other flags can be specified via a custom string passed
+ to the option:
+
+ $ ./configure --enable-profiling # default profiler
+ $ ./configure --enable-profiling=-p # use prof w/ gcc
+
+ The profiling option is independent of the build mode. In particular,
+ note that enabling profiling will NOT automatically enable debugging
+ since it can be useful to profile a production library, even
+ if the output will be limited.
+
+ The custom strings can be more complicated than a single
+ argument:
+
+ $ ./configure --enable-profiling="-pg --coverage"
+
+ Do note that when a custom string is specified, it will *replace*
+ the flags that would normally be set for that option. It is NOT
+ concatenated. This is true of all configure options that can
+ accept a custom string.
+
+ If using Valgrind or some other memory sanity checker, you will
+ want to build the library with --enable-using-memchecker. This
+ will disable a feature of the HDF5 library that recycles
+ certain memory blocks without a trip to the system's allocator.
+ This can confuse memory checkers and hide problems.
+
+ $ ./configure --enable-using-memchecker
+
+ The library also includes its own memory sanity checker. It is not
+ as involved as Valgrind and is mainly for library developers
+ but may be of some use to users trying to track down memory leaks.
+ It can be enabled with --enable-memory-alloc-sanity-check and
+ is separate from --enable-using-memchecker.
+
+ $ ./configure --enable-memory-alloc-sanity-check
+
+ Both of these options can slow down the library and cause
+ increased memory usage.
+
+4.3.11 Optimization
+ Various levels of compiler optimization can be specified at
+ compile time using --enable-optimization. This option can
+ take several strings:
+
+ high Aggressive optimization (-O3, etc.)
+
+ debug Optimizations that do not detract significantly
+ from the debugging experience (-Og, etc.)
+
+ none No optimizations (typically -O0)
+
+ Example:
+
+ $ ./configure --enable-optimization=high
+
+ The exact options used will vary with compiler and platform and can
+ be seen in the library settings file created during the configure
+ step.
+
+ Additionally, a custom string can be provided, such as "-Ofast":
+
+ $ ./configure --enable-optimization=-Ofast
+
+
+ Setting the optimization level to be high, debug, or none will
+ set appropriate options for the language wrappers as well if they
+ are being built (due to compiler quirks, these may be different
+ than those used for the main library). If a custom string string
+ has been provided, however, it will be used for both the HDF5
+ library and the language wrappers.
+
+4.3.12. Parallel versus serial library
The HDF5 Library can be configured to use MPI and MPI-IO for
parallelism on a distributed multi-processor system. Read the
file INSTALL_parallel for detailed explanations.
-4.3.11. Threadsafe capability
- The HDF5 Library can be configured to be thread-safe (on a very
- large scale) with the `--enable-threadsafe' flag to the configure
- script. Some platforms may also require the '-with-pthread=INC,LIB'
- (or '--with-pthread=DIR') flag to the configure script.
+4.3.13. Threadsafe capability
+ The HDF5 Library can be configured to be thread-safe with the
+ `--enable-threadsafe' flag to the configure script. Some platforms
+ may also require the '-with-pthread=INC,LIB' (or
+ '--with-pthread=DIR') flag to the configure script, though this
+ is normally not necessary.
+
+ In HDF5 1.10.0, the thread-safety code uses pthreads on POSIX systems
+ and Win32 threads on Windows systems.
+
+ Thread-safety is currently implemented via a global library mutex,
+ effectively serializing library access. Please be aware of the
+ potential performance implications. The library is currently NOT
+ threaded internally though we do use thread-local storage to keep
+ track of things like per-thread function stacks for debugging.
+
+ Note that building the thread-safe library with the high-level
+ library and/or language wrappers (Fortran, etc.) is not officially
+ supported since we've never investigated the thread-safety of
+ these high-level or wrapper libraries and there is no testing.
+ However, this can be enabled with --enable-unsupported if you
+ are willing to take the risk of using it.
+
For further details, see "HDF5 Thread Safe Library":
http://www.hdfgroup.org/HDF5/doc/TechNotes/ThreadSafeLibrary.html
-4.3.12. Backward compatibility
+4.3.14. Backward compatibility
The 1.10 version of the HDF5 Library can be configured to operate
identically to the v1.6 library with the
--with-default-api-version=v16
diff --git a/release_docs/RELEASE.txt b/release_docs/RELEASE.txt
index b30f0cf..1e74b77 100644
--- a/release_docs/RELEASE.txt
+++ b/release_docs/RELEASE.txt
@@ -1,28 +1,34 @@
-HDF5 version 1.10.0-pre1 released on 2016-03-17
+HDF5 version 1.10.0-pre2 released on 2016-03-22
================================================================================
+
INTRODUCTION
This document describes the differences between HDF5-1.8.* and
HDF5 1.10.0 release, and contains information on the platforms
tested.
-
Links to HDF5 1.10.0 source code can be found on The HDF Group's
development FTP server at the following location:
- http://www.hdfgroup.org/HDF5/release/obtain5110.html
+
+ http://www.hdfgroup.org/HDF5/release/obtain5110.html
+
User documentation be accessed directly at this location:
- http://www.hdfgroup.org/HDF5/docNewFeatures/
+
+ http://www.hdfgroup.org/HDF5/docNewFeatures/
+
For more information, see the HDF5 home page:
http://www.hdfgroup.org/HDF5/
-If you have any questions or comments, please send them to the HDF Help Desk:
+If you have any questions or comments, please send them to the HDF
+Help Desk:
help at hdfgroup.org
+
CONTENTS
- New Features
@@ -32,311 +38,348 @@ CONTENTS
- Known Problems
+
New Features
============
This release supports the following features:
Configuration
-------------
- - API compatibility with HDF5 1.8 flag was added
-
- The 1.10 version of the HDF5 Library can be configured to operate identically
- to the v1.8 library with the --with-default-api-version=v18 configure flag.
- This allows existing code to be compiled with the v1.10 library without
- requiring immediate changes to the application source code. For addtional
- configuration options and other details, see "API Compatibility Macros in HDF5":
- http://www.hdfgroup.org/HDF5/doc/RM/APICompatMacros.html
+ - API Compatibility with HDF5 1.8 Flag Was Added
+
+ The 1.10 version of the HDF5 Library can be configured to operate
+ identically to the 1.8 library with the --with-default-api-version=v18
+ configure flag. This allows existing code to be compiled with the 1.10
+ library without requiring immediate changes to the application source
+ code. For addtional configuration options and other details, see
+ "API Compatibility Macros in HDF5" at
+ http://www.hdfgroup.org/HDF5/doc/RM/APICompatMacros.html.
- - Autotools configuration has been extensively reworked
+ - Autotools Configuration Has Been Extensively Reworked
- The autotools configuration options have been updated to allow more fine-
- grained control of the build options and to correct some bugs. See
- configure --help for comprehensive information on each option.
+ The autotools configuration options have been updated to allow more
+ fine-grained control of the build options and to correct some bugs.
+ See configure --help for comprehensive information on each option.
- Specific changes:
+ Specific changes:
- * --enable-debug and --enable-production are no longer accepted. Use
- --enable-build-mode=(debug | production) instead. These set appropriate
- defaults for the other configuration options (symbols, optimization,
- etc.). These defaults can be overridden by the user.
+ * --enable-debug and --enable-production are no longer accepted.
+ Use --enable-build-mode=(debug | production) instead. These set
+ appropriate defaults for symbols, optimizations, and other
+ configuration options. These defaults can be overridden by the
+ user.
- * Extra debug output messages are no longer enabled with
- --enable-debug=<package list>. Use --enable-internal-debug=<pkg list>
- instead.
+ * Extra debug output messages are no longer enabled with
+ --enable-debug=<package list>. Use --enable-internal-debug=<pkg list>
+ instead.
- * A new --enable-symbols option allows symbols to be generated
- independently of the build mode. --disable-symbols can be used to strip
- symbols from the binary.
+ * A new --enable-symbols option allows symbols to be generated
+ independently of the build mode. --disable-symbols can be used
+ to strip symbols from the binary.
- * A new --enable-asserts option sets/unsets NDEBUG. This is independent of
- the build mode. This also enables some extra low-overhead debug checks
- in the library.
+ * A new --enable-asserts option sets/unsets NDEBUG. This is
+ independent of the build mode. This also enables some extra
+ low-overhead debug checks in the library.
- * A new --enable-profiling option sets profiling flags. This is
- independent of the build mode.
+ * A new --enable-profiling option sets profiling flags. This is
+ independent of the build mode.
- * A new --enable-optimization option sets the optimization level. This is
- independent of the build mode.
+ * A new --enable-optimization option sets the optimization level.
+ This is independent of the build mode.
- * Many of these options can take a flags string that will be used to
- build the library. This can be useful for specifying custom optimization
- flags (e.g., -Os, -Ofast), etc.
+ * Many of these options can take a flags string that will be used
+ to build the library. This can be useful for specifying custom
+ optimization flags such as -Os and -Ofast.
- * gnu C++ and Fortran use configure sub-files that update the build flags
- and turn on warnings. The increase in warnings when building these
- wrapper libraries is due to these flag changes, not a decrease in code
- quality.
+ * gnu C++ and Fortran use configure sub-files that update the
+ build flags and turn on warnings. The increase in warnings when
+ building these wrapper libraries is due to these flag changes
+ and not to a decrease in code quality.
- * The option to clear file buffers has been removed. Any buffer that will
- eventually be written to disk will now always be memset to zero. This
- prevents the previous contents of the buffer from being written to the
- disk if the buffer contents are not completely overwritten, which has
- security implications.
+ * The option to clear file buffers has been removed. Any buffer that
+ will eventually be written to disk will now always be memset
+ to zero. This prevents the previous contents of the buffer from
+ being written to the disk if the buffer contents are not
+ completely overwritten, which has security implications.
- - LFS changes
+ - LFS Changes
- The way the autotools handle large file support (LFS) has been overhauled
- in this release.
+ The way the autotools handle large file support (LFS) has been
+ overhauled in this release.
- * We assume ftello and fseeko exist
+ * We assume ftello and fseeko exist
- * We no longer explicitly use the *64 I/O functions. Instead we rely on a
- mapping provided by _FILE_OFFSET_BITS or its equivalent.
+ * We no longer explicitly use the *64 I/O functions. Instead, we
+ rely on a mapping provided by _FILE_OFFSET_BITS or its equivalent.
- * _LARGEFILE(64)_SOURCE is no longer exported via AM_CPPFLAGS.
+ * _LARGEFILE(64)_SOURCE is no longer exported via AM_CPPFLAGS.
- Parallel Library:
+
+
+ Parallel Library
-----------------
- Collective Metadata I/O
-
- Calls for HDF5 metadata can result in many small reads and writes. On metadata
- reads, collective metadata I/O can improve performance by allowing the library
- to perform optimizations when reading the metadata, by having one rank read the
- data and broadcasting it to all other ranks.
-
- Collective metadata I/O improves metadata write performance through the
- construction of an MPI derived datatype that is then written collectively
- in a single call. For more information see
- https://www.hdfgroup.org/HDF5/docNewFeatures/NewFeaturesCollectiveMetadataIoDocs.html
-
- Library:
+
+ Calls for HDF5 metadata can result in many small reads and writes.
+ On metadata reads, collective metadata I/O can improve performance
+ by allowing the library to perform optimizations when reading the
+ metadata by having one rank read the data and broadcasting it to
+ all other ranks.
+
+ Collective metadata I/O improves metadata write performance through
+ the construction of an MPI derived datatype that is then written
+ collectively in a single call. For more information, see
+ https://www.hdfgroup.org/HDF5/docNewFeatures/NewFeaturesCollectiveMetadataIoDocs.html.
+
+
+
+ Library
--------
- - Concurrent access to HDF5 file - Single Writer/ Multple Reader (SWMR)
+ - Concurrent Access to HDF5 Files - Single Writer/ Multple Reader (SWMR)
- The Single Writer/ Multiple Reader or SWMR feature enables users to read
- data concurrently while writing it. Communications between the processes
- and file locking are not required. The processes can run on the same or
- on different platforms, as long as they share a common file system that
- is POSIX compliant.
- For more information, see the Single-Writer/Multiple-Reader (SWMR)
- Documentation at
- https://www.hdfgroup.org/HDF5/docNewFeatures/NewFeaturesSwmrDocs.html
+ The Single Writer/ Multiple Reader or SWMR feature enables users to
+ read data concurrently while writing it. Communications between the
+ processes and file locking are not required. The processes can run
+ on the same or on different platforms as long as they share a common
+ file system that is POSIX compliant. For more information, see the
+ Single-Writer/Multiple-Reader (SWMR) documentation at
+ https://www.hdfgroup.org/HDF5/docNewFeatures/NewFeaturesSwmrDocs.html.
- Virtual Dataset (VDS)
- The VDS feature enables data to be accessed across HDF5 files using standard
- HDF5 objects such as groups and datasets without rewriting or rearranging
- the data. An HDF5 virtual dataset (VDS) is an HDF5 dataset that is composed of
- source HDF5 datasets in a predefined mapping. VDS can be used with the SWMR
- feature. For documentation check
- https://www.hdfgroup.org/HDF5/docNewFeatures/NewFeaturesVirtualDatasetDocs.html
+ The VDS feature enables data to be accessed across HDF5 files
+ using standard HDF5 objects such as groups and datasets without
+ rewriting or rearranging the data. An HDF5 virtual dataset (VDS)
+ is an HDF5 dataset that is composed of source HDF5 datasets in
+ a predefined mapping. VDS can be used with the SWMR feature. For
+ documentation, check
+ https://www.hdfgroup.org/HDF5/docNewFeatures/NewFeaturesVirtualDatasetDocs.html.
- Persistent Free File Space Tracking
- Usage patterns when working with an HDF5 file sometimes result in wasted space
- within the file. This can also impair access times when working with the
- resulting files. The new file space management feature provides strategies
- for managing space in a file to improve performance in both of these areas.
- For more information see
- http://www.hdfgroup.org/HDF5/docNewFeatures/NewFeaturesFileSpaceMgmtDocs.html
+ Usage patterns when working with an HDF5 file sometimes result in
+ wasted space within the file. This can also impair access times
+ when working with the resulting files. The new file space management
+ feature provides strategies for managing space in a file to improve
+ performance in both of these areas. For more information, see
+ http://www.hdfgroup.org/HDF5/docNewFeatures/NewFeaturesFileSpaceMgmtDocs.html.
+
- C++ Library:
+ C++ Library
------------
- - New member function added to H5::ArrayType
+ - New Member Function Added to H5::ArrayType
- The assignment operator ArrayType::operator= is added because ArrayType
- has pointer data members.
+ The assignment operator ArrayType::operator= was added because
+ ArrayType has pointers to data members.
- (BMR, 2016/03/07, HDFFV-9562)
+ (BMR - 2016/03/07, HDFFV-9562)
- Tools:
+
+ Tools
------
- - h5watch
-
- Allows users to output new records appended to a dataset iunder SWMR access
- as it grows. The functionality is similar to the Unix user command "tail"
- with the follow option, which outputs appended data as the file grows.
- For more information see
- http://www.hdfgroup.org/HDF5/docNewFeatures/NewFeaturesSwmrDocs.html#Tools
+ - h5watch
+
+ The h5watch tool allows users to output new records appended to
+ a dataset under SWMR access as it grows. The functionality is
+ similar to the Unix user command "tail" with the follow option,
+ which outputs appended data as the file grows. For more
+ information, see
+ http://www.hdfgroup.org/HDF5/docNewFeatures/NewFeaturesSwmrDocs.html#Tools.
- h5format_convert
-
- The tool allows users to convert the indexing type of a chunked dataset made
- with a 1.10.x version of the HDF5 library when the latest file format is used
- to the 1.8.x version 1 B-tree indexing type. For example, datasets created
- using SWMR access, can be converted to be accessed by the HDF5 1.18 library
- and tools. The tools doesn't rewrite raw data, but HDF5 metadata only.
+ The h5format_convert tool allows users to convert the indexing
+ type of a chunked dataset made with a 1.10.x version of the HDF5
+ Library when the latest file format is used to the 1.8.x version 1 B-tree indexing
+ type. For example, datasets created using SWMR access, can be
+ converted to be accessed by the HDF5 1.18 library and tools. The
+ tool does not rewrite raw data, but it does rewrite HDF5 metadata.
- High-Level APIs:
+
+ High-Level APIs
----------------
- H5DOappend
- The function appends data to a dataset along a specified dimension.
-
+ The function appends data to a dataset along a specified dimension.
- C Packet Table API
- ------------------
- - Replacement of a public function
- The existing function H5PTcreate_fl limits applications to deflate
- compression only. The public function H5PTcreate is added to replace
- H5PTcreate_fl. H5PTcreate takes a property list ID to provide
- flexibility on creation properties.
+ C Packet Table API
+ ------------------
+ - Replacement of a Public Function with H5PTcreate
- hid_t H5PTcreate(hid_t loc_id, const char *dset_name,
- hid_t dtype_id, hsize_t chunk_size, hid_t plist_id);
+ The existing function H5PTcreate_fl limits applications so they
+ can use the deflate compression only. The public function
+ H5PTcreate has been added to replace H5PTcreate_fl. H5PTcreate
+ takes a property list identifier to provide flexibility on
+ creation properties.
- (BMR, 2016/03/04, HDFFV-8623)
+ (BMR - 2016/03/04, HDFFV-8623)
- - New public functions
+ - New Public Functions: H5PTget_dataset and H5PTget_type
- Two accessor functions were added per HDFFV-8623/patch 003.
- /* Returns the ID of the dataset associated with the packet table */
- hid_t H5PTget_dataset(hid_t table_id);
-
- /* Returns the ID of the datatype the packet table uses */
- hid_t H5PTget_type(hid_t table_id);
+ Two accessor functions have been added. H5PTget_dataset returns
+ the identifier of the dataset associated a packet table, and
+ H5PTget_type returns the identifier of the datatype used by
+ a packet table.
(BMR, 2016/03/04, HDFFV-8623)
- - Regarding #ifdef VLPT_REMOVED
-
- The #ifdef VLPT_REMOVED blocks are removed from the PT library source
- except the following cases:
- + H5PTis_varlen() is made available again.
- + H5PTfree_vlen_readbuff() now became H5PTfree_vlen_buff()
+ - Regarding #ifdef VLPT_REMOVED
- (BMR, 2016/03/04, HDFFV-442)
+ The #ifdef VLPT_REMOVED blocks have been removed from the packet
+ table (PT) library source except for the following functions:
+ + H5PTis_varlen() has been made available again
+ + H5PTfree_vlen_readbuff() is now H5PTfree_vlen_buff()
- C++ Packet Table API
- --------------------
- - New constructor
+ (BMR - 2016/03/04, HDFFV-442)
- An overloaded constructor is added to FL_PacketTable and takes a property
- list ID to provide flexibility on creation properties.
+ C++ Packet Table API
+ --------------------
+ - New Constructor Added to FL_PacketTable
- FL_PacketTable(hid_t fileID, hid_t plist_id, const char* name, hid_t dtypeID, hsize_t chunkSize);
+ An overloaded constructor has been added to FL_PacketTable and
+ takes a property list identifier to provide flexibility on
+ creation properties.
- (BMR, 2016/03/08, HDFFV-8623)
+ (BMR - 2016/03/08, HDFFV-8623)
- - New public functions
+ - New Public Functions
- Two accessor wrappers to class PacketTable, per HDFFV-8623/patch 004.
- /* Returns the ID of the dataset associated with the packet table */
- hid_t PacketTable::GetDataset()
+ Two accessor wrappers are added to class PacketTable.
+ PacketTable::GetDataset() returns the identifier of the dataset
+ associated with the packet table, and PacketTable::GetDatatype()
+ returns the identifier of the datatype that the packet table uses.
- /* Returns the ID of the datatype the packet table uses */
- hid_t PacketTable::GetDataset()
+ (BMR - 2016/03/04, HDFFV-8623)
- (BMR, 2016/03/04, HDFFV-8623)
+ - Member Functions with "char*" as an Argument
- - Member functions having "char*" as an argument
+ Overloaded functions were added to provide the "const char*"
+ argument; the existing version will be deprecated in future
+ releases.
- Overloaded functions were added to provide "const char*" argument, the
- existing version will be deprecated.
+ (BMR - 2016/03/04, HDFFV-8623)
- (BMR, 2016/03/04)
+ - Regarding #ifdef VLPT_REMOVED
- - Regarding #ifdef VLPT_REMOVED
+ The #ifdef VLPT_REMOVED blocks have been removed from the packet
+ table library source code except for the following functions:
+ + VL_PacketTable::IsVariableLength() was moved to PacketTable
+ + VL_PacketTable::FreeReadBuff() is now PacketTable::FreeBuff()
- The #ifdef VLPT_REMOVED blocks are removed from the PT library source
- except the following cases:
- + VL_PacketTable::IsVariableLength() is moved to PacketTable
- + VL_PacketTable::FreeReadBuff() now became PacketTable::FreeBuff()
+ (BMR - 2016/03/04, HDFFV-442)
- (BMR, 2016/03/04, HDFFV-442)
- Java wrapper library
+ Java Wrapper Library
--------------------
- Java HDF5 JNI library has been integrated into the HDF5 repo, the configure
- option is "--enable-java" and the CMake option is HDF5_BUILD_JAVA:BOOL=ON.
- The package hierarchy has changed from the HDF5 1.8 JNI, which was
- "ncsa.hdf.hdflib.hdf5", to HDF5 1.10, "hdf.hdflib.hdf5".
+ The Java HDF5 JNI library has been integrated into the HDF5 repository.
+ The configure option is "--enable-java", and the CMake option is
+ HDF5_BUILD_JAVA:BOOL=ON. The package hierarchy has changed from the
+ HDF5 1.8 JNI, which was "ncsa.hdf.hdflib.hdf5", to HDF5 1.10,
+ "hdf.hdflib.hdf5".
+
+ A number of new APIs were added including some for VDS and SWMR.
- Also there are a number of new APIs added, including those for VDS and SWMR.
- Other important changes:
+
+ Other Important Changes
-----------------------
- hid_t type was changed from 32-bit to a 64-bit value.
-
- Documentation
- -------------
- See http://www.hdfgroup.org/HDF5/docNewFeatures/NewFeaturesSwmrDocs.html#Tools
+ The hid_t type was changed from 32-bit to a 64-bit value.
-Issues Addressed in this Release since alpha1
+
+Issues Addressed in this Release Since alpha1
=============================================
- - Wrong settings returned for a dataset access property list.
-
- One couldn't get the correct access property setting with the following functions calls
- H5Pget_virtual_printf_gap
- H5Pget_virtual_view
- H5Pget_efile_prefix
-
- when a dataset access property list was obtained from H5Dget_access_plist(). Fixed.
- (DER and NAF 2016-03-14 HDFFV-9716)
-
- - h5dump segfaulted when provided with invalid arguments or when optional aruments are last option
- on command line.
-
- When h5dump was provided with the name of a non existing file or when optional arguments were the
- last option on the command line, h5dump failed. Fixed.
- (ADB 2016-02-28 HDFFV-9639, HDFFV-9684)
-
- - HDF5 library segfaults on a corrupted file.
-
- The HDF5 library didn't propagate an error when encounting a corruped metadata in an HDF5 file.
- The issue was fixed for a specific filei porvided by a user. If you still see the problem,
- please contact help at hdfgroup.org
- (MC 2016-02-18 HDFFV-9670)
-
- - When the latest file format is used, and when a chunked dataset is created with a datatype with the size
- bigger than a chunk size, the data cannot be read back.
-
- The issue was reported for the chunked datasets with a string datatype, and was confirmed for other i
- datatypes with the sizes bigger than the chunk size in bytes. Fixed.
- (JM 2016-02-13 HDFFV-9672)
-
- - Control over the location of the external files
-
- New API H5Pset_efile_prefix was added to specify locations of the external files.
- (DER 2016-02-04 HDFFV-8740)
-
-
-
-
-Issues Addressed in this Release since alpha0
+ - H5Pget_virtual_printf_gap, H5Pget_virtual_view, H5Pget_efile_prefix
+
+ The correct access property list settings from the
+ H5Pget_virtual_printf_gap, H5Pget_virtual_view, and
+ H5Pget_efile_prefix function calls could not be retrieved
+ using H5Dget_access_plist().
+
+ Fixed.
+
+ (DER and NAF - 2016/03/14, HDFFV-9716)
+
+ - h5dump
+
+ When h5dump was provided with the name of a non-existing file or
+ when optional arguments were the last option on the command line,
+ h5dump would segfault.
+
+ Fixed.
+
+ (ADB 2016/02/28 HDFFV-9639, HDFFV-9684)
+
+ - No Error Message for Corrupt Metadata
+
+ The HDF5 Library did not propagate an error when it encountered
+ corrupt metadata in an HDF5 file. The issue was fixed for a
+ specific file provided by a user. If you still see the problem,
+ please contact help at hdfgroup.org
+
+ Fixed.
+
+ (MC - 2016/02/18, HDFFV-9670)
+
+ - Problem Reading Chunked Datasets with a String Datatype Larger
+ Than the Chunk Size in Bytes
+
+ When the latest file format was used and when a chunked dataset
+ was created with a datatype with the size bigger than a chunk
+ size, the data could not be read back. The issue was reported
+ for chunked datasets with a string datatype and was confirmed
+ for other datatypes with the sizes bigger than the chunk size in
+ bytes.
+
+ Fixed.
+
+ (JM - 2016/02/13, HDFFV-9672)
+
+ - Control over the Location of External Files
+
+ Users were unable to specify the locations of external files.
+
+ Two APIs - H5Pget_efile_prefix and H5Pset_efile_prefix - were
+ added so that users could specify the locations of external files.
+
+ (DER - 2016/02/04, HDFFV-8740)
+
+
+
+Issues Addressed in this Release Since alpha0
=============================================
- - h5format_convert tool didn't downgrade version of the superblock. Fixed.
- (EIP 2016-01-11)
-
- - It was reported that alpha0 crashed when used with multiple threads.
- The issue exists in the HDF5 library versions 1.8 and 1.9.
- The problem is related to a shared file pointer used in the misc. data
- structures. The thread-safe library exposed paths in the library where
- file pointer became invalid. Alpha1 release contains the fixes for the specific
- use case as decribed in HDFFV-9643.
- We will keep working on identifying other paths in the library with similar problem
- and fixing the issue.
- (EIP 2016-01-15)
+ - h5format_convert
+
+ The h5format_convert tool did not downgrade the version of the
+ superblock.
+
+ Fixed. The tool now will downgrade the version of the superblock.
+
+ (EIP 2016/01/11)
+
+ - Crashes with multiple threads: invalid pointers
+
+ It was reported that alpha0 crashed when used with multiple
+ threads. The issue exists in the HDF5 Library versions 1.8 and
+ 1.9. The problem is related to a shared file pointer used in some
+ miscellaneous data structures. The thread-safe library exposed
+ paths in the library where a file pointer became invalid.
+
+ The alpha1 release contains the fixes for the specific use case
+ as described in HDFFV-9643. We will keep working on identifying
+ and fixing other paths in the library with similar problems.
+
+ (EIP - 2016/01/15, HDFFV-9643)
+
+
Supported Platforms
===================
@@ -395,22 +438,23 @@ They are built with the configure process unless specified otherwise.
Visual Studio 2013 w/ Intel Fortran 15 (cmake)
Mac OS X Mt. Lion 10.8.5 Apple clang/clang++ version 5.1 from Xcode 5.1
- 64-bit gfortran GNU Fortran (GCC) 4.8.2
+ 64-bit gfortran GNU Fortran (GCC) 4.8.2
(swallow/kite) Intel icc/icpc/ifort version 15.0.3
Mac OS X Mavericks 10.9.5 Apple clang/clang++ version 6.0 from Xcode 6.2.0
- 64-bit gfortran GNU Fortran (GCC) 4.9.2
+ 64-bit gfortran GNU Fortran (GCC) 4.9.2
(wren/quail) Intel icc/icpc/ifort version 15.0.3
Mac OS X Yosemite 10.10.5 Apple clang/clang++ version 6.0 from Xcode 7.0.0
- 64-bit gfortran GNU Fortran (GCC) 4.9.2
+ 64-bit gfortran GNU Fortran (GCC) 4.9.2
(osx1010dev/osx1010test) Intel icc/icpc/ifort version 15.0.3
Mac OS X El Capitan 10.11.3 Apple clang/clang++ version 7.0.2 from Xcode 7.0.2
- 64-bit gfortran GNU Fortran (GCC) 5.2.0
+ 64-bit gfortran GNU Fortran (GCC) 5.2.0
(osx1010dev/osx1010test) Intel icc/icpc/ifort version 15.0.3
+
Tested Configuration Features Summary
=====================================
@@ -468,6 +512,7 @@ Compiler versions for each platform are listed in the preceding
"Supported Platforms" table.
+
More Tested Platforms
=====================
The following platforms are not supported but have been tested for this release.
@@ -512,15 +557,55 @@ The following platforms are not supported but have been tested for this release.
g++ (GCC) 4.9.2 20141030 (Cray Inc.)
-Known Problems
-==============
-The problems reported for alpha releases were adressed in the HDF5 1.10.0-pre1 release.
-
-There are no known problems for the newly released features listed in the "New Features"
-section of this document.
-
-We didn't verify that the known problems listed in the RELEASE.txt version HDF5 1.8.16 are
-still valid. This section will be updated for the final release of HDF5 1.10.0.
-
-
+Known Problems and Limitations
+==============================
+This section contains the list of known problems and limitations introduced
+in this release of HDF5.
+
+Note: this list is not exhaustive of all known issues discovered in HDF5
+software to date. For a list of significant problems and known workarounds
+identified in past releases, please refer to:
+
+https://www.hdfgroup.org/HDF5/release/known_problems/
+
+The HDF Group also maintains a JIRA issue-tracking database which is used to
+capture all known issues which are too numerous to reasonably list in this
+document. The HDF Group is taking steps to make our JIRA issue database
+open to the public, and this section will refer to that database in a future
+release. In the meantime, please contact help at hdfgroup.org if you come across
+an issue not listed here or at the link above, and we will provide any
+information about known workarounds that we have or add it to our list of
+known issues if it is a new issue.
+
+ - The JUnit-interface test may fail on Solaris platforms. The result of
+ a test for verifying the content of the error stack to stdout is
+ in a different order on Solaris then other platforms. Use make -i option
+ to test beyond the java/test folder.
+ (ADB - 2016/03/22 - HDFFV-9734)
+
+ - The flush/refresh test occasionally fails on OS X platforms. This is
+ being investigated and may be a problem with SWMR on HFS+.
+ (DER - 2016/03/22 - HDFFV-9731)
+
+ - The VDS/SWMR test will fail with a segmentation fault if the library
+ is built with --enable-using-memchecker.
+ (DER - 2016/03/21 - HDFFV-9732)
+
+ - SWMR feature
+ The SWMR feature will only work if an HDF5 file under SWMR access resides
+ on a file system that obeys POSIX write() ordering semantics. Because of
+ this, SWMR will not work on network file systems (e.g., NFS, SMB/Windows
+ file shares), since those systems do not guarantee write odering. SWMR
+ regression tests are likely to fail if run on a network file system. SWMR
+ is currently not tested on Windows though it can be tested manually
+ (some of the SWMR test programs are built by CMake) and there are no
+ obvious reasons for it to not work on NTFS or GPFS.
+ (EIP - 2016/03/20 - HDFFV-9733)
+
+ - VDS feature
+ Currently, the path to a VDS source file is interpreted as relative to the
+ directory where the executable program runs and not to the HDF5 file with
+ the VDS dataset unless a full path to the source file is specified during
+ the mapping.
+ (EIP - 2016/03/20 - HDFFV-9724)
diff --git a/src/CMakeLists.txt b/src/CMakeLists.txt
index 03c2773..d93612b 100644
--- a/src/CMakeLists.txt
+++ b/src/CMakeLists.txt
@@ -792,7 +792,6 @@ set (H5_GENERATED_HEADERS
)
option (HDF5_GENERATE_HEADERS "Rebuild Generated Files" OFF)
-mark_as_advanced (HDF5_GENERATE_HEADERS)
if (HDF5_GENERATE_HEADERS)
set_source_files_properties(${H5_GENERATED_HEADERS} PROPERTIES GENERATED TRUE)
find_package (Perl)
diff --git a/src/H5Oprivate.h b/src/H5Oprivate.h
index 834bf1f..956c00d 100644
--- a/src/H5Oprivate.h
+++ b/src/H5Oprivate.h
@@ -791,11 +791,6 @@ typedef struct H5O_fsinfo_t {
typedef herr_t (*H5O_operator_t)(const void *mesg/*in*/, unsigned idx,
void *operator_data/*in,out*/);
-#ifdef OUT
-/* Typedef for "internal library" iteration operations */
-typedef herr_t (*H5O_lib_operator_t)(H5O_t *oh, H5O_mesg_t *mesg/*in,out*/,
- unsigned sequence, hbool_t *oh_modified/*out*/, void *operator_data/*in,out*/);
-#endif
/* Typedef for "internal library" iteration operations */
typedef herr_t (*H5O_lib_operator_t)(H5O_t *oh, H5O_mesg_t *mesg/*in,out*/,
unsigned sequence, unsigned *oh_modified/*out*/, void *operator_data/*in,out*/);
diff --git a/src/H5P.c b/src/H5P.c
index 3d09231..f075b92 100644
--- a/src/H5P.c
+++ b/src/H5P.c
@@ -639,7 +639,7 @@ done:
PURPOSE
Routine to set a property's value in a property list.
USAGE
- herr_t H5P_set(plist_id, name, value)
+ herr_t H5Pset(plist_id, name, value)
hid_t plist_id; IN: Property list to find property in
const char *name; IN: Name of property to set
void *value; IN: Pointer to the value for the property
diff --git a/src/H5private.h b/src/H5private.h
index fa5a114..e0ed6ef 100644
--- a/src/H5private.h
+++ b/src/H5private.h
@@ -538,20 +538,21 @@
* It's the developer's responsibility not to pass in the value 0, which
* may cause the equation to fail.
*/
-#define H5_FLT_ABS_EQUAL(X,Y) (HDfabsf(X-Y) < FLT_EPSILON)
-#define H5_DBL_ABS_EQUAL(X,Y) (HDfabs (X-Y) < DBL_EPSILON)
-#define H5_LDBL_ABS_EQUAL(X,Y) (HDfabsl(X-Y) < LDBL_EPSILON)
+#define H5_FLT_ABS_EQUAL(X,Y) (HDfabsf((X)-(Y)) < FLT_EPSILON)
+#define H5_DBL_ABS_EQUAL(X,Y) (HDfabs ((X)-(Y)) < DBL_EPSILON)
+#define H5_LDBL_ABS_EQUAL(X,Y) (HDfabsl((X)-(Y)) < LDBL_EPSILON)
-#define H5_FLT_REL_EQUAL(X,Y,M) (HDfabsf((Y-X) / X) < M)
-#define H5_DBL_REL_EQUAL(X,Y,M) (HDfabs ((Y-X) / X) < M)
-#define H5_LDBL_REL_EQUAL(X,Y,M) (HDfabsl((Y-X) / X) < M)
+#define H5_FLT_REL_EQUAL(X,Y,M) (HDfabsf(((Y)-(X)) / (X)) < (M))
+#define H5_DBL_REL_EQUAL(X,Y,M) (HDfabs (((Y)-(X)) / (X)) < (M))
+#define H5_LDBL_REL_EQUAL(X,Y,M) (HDfabsl(((Y)-(X)) / (X)) < (M))
-/* KiB, MiB, GiB, TiB, EiB - Used in profiling and timing code */
+/* KiB, MiB, GiB, TiB, PiB, EiB - Used in profiling and timing code */
#define H5_KB (1024.0F)
#define H5_MB (1024.0F * 1024.0F)
#define H5_GB (1024.0F * 1024.0F * 1024.0F)
#define H5_TB (1024.0F * 1024.0F * 1024.0F * 1024.0F)
-#define H5_EB (1024.0F * 1024.0F * 1024.0F * 1024.0F * 1024.0F)
+#define H5_PB (1024.0F * 1024.0F * 1024.0F * 1024.0F * 1024.0F)
+#define H5_EB (1024.0F * 1024.0F * 1024.0F * 1024.0F * 1024.0F * 1024.0F)
#ifndef H5_HAVE_FLOCK
/* flock() operations. Used in the source so we have to define them when
diff --git a/src/H5public.h b/src/H5public.h
index ae89e2a..f2a5bb0 100644
--- a/src/H5public.h
+++ b/src/H5public.h
@@ -95,9 +95,9 @@ extern "C" {
#define H5_VERS_MAJOR 1 /* For major interface/format changes */
#define H5_VERS_MINOR 10 /* For minor interface/format changes */
#define H5_VERS_RELEASE 0 /* For tweaks, bug-fixes, or development */
-#define H5_VERS_SUBRELEASE "pre1" /* For pre-releases like snap0 */
+#define H5_VERS_SUBRELEASE "pre2" /* For pre-releases like snap0 */
/* Empty string for real releases. */
-#define H5_VERS_INFO "HDF5 library version: 1.10.0-pre1" /* Full version string */
+#define H5_VERS_INFO "HDF5 library version: 1.10.0-pre2" /* Full version string */
#define H5check() H5check_version(H5_VERS_MAJOR,H5_VERS_MINOR, \
H5_VERS_RELEASE)
diff --git a/src/H5system.c b/src/H5system.c
index eb09b15..e6ca5d4 100644
--- a/src/H5system.c
+++ b/src/H5system.c
@@ -728,7 +728,7 @@ done:
FUNC_LEAVE_NOAPI(ret_value)
} /* end H5_make_time() */
-#ifdef H5_HAVE_VISUAL_STUDIO
+#ifdef H5_HAVE_WIN32_API
/* Offset between 1/1/1601 and 1/1/1970 in 100 nanosecond units */
#define _W32_FT_OFFSET (116444736000000000ULL)
@@ -912,7 +912,7 @@ Wflock(int fd, int operation) {
return 0;
} /* end Wflock() */
-#endif /* H5_HAVE_VISUAL_STUDIO */
+#endif /* H5_HAVE_WIN32_API */
/*-------------------------------------------------------------------------
diff --git a/src/H5timer.c b/src/H5timer.c
index 94f2883..d9be6bb 100644
--- a/src/H5timer.c
+++ b/src/H5timer.c
@@ -228,7 +228,7 @@ H5_bandwidth(char *buf/*out*/, double nbytes, double nseconds)
} else if(bw < H5_TB) {
sprintf(buf, "%05.4f", bw / H5_GB);
HDstrcpy(buf+5, " GB/s");
- } else if(bw < H5_EB) {
+ } else if(bw < H5_PB) {
sprintf(buf, "%05.4f", bw / H5_TB);
HDstrcpy(buf+5, " TB/s");
} else {
diff --git a/src/H5win32defs.h b/src/H5win32defs.h
index 2a0f22d..a757832 100644
--- a/src/H5win32defs.h
+++ b/src/H5win32defs.h
@@ -65,6 +65,8 @@ typedef __int64 h5_stat_size_t;
*/
#define HDmemset(X,C,Z) memset((void*)(X),C,Z)
+#endif /* H5_HAVE_VISUAL_STUDIO */
+
struct timezone {
int tz_minuteswest;
int tz_dsttime;
@@ -90,8 +92,6 @@ extern "C" {
#define HDsnprintf c99_snprintf /*varargs*/
#define HDvsnprintf c99_vsnprintf /*varargs*/
-#endif /* H5_HAVE_VISUAL_STUDIO */
-
/* Non-POSIX functions */
/* Don't use actual pthread_self on Windows because the return
diff --git a/src/Makefile.in b/src/Makefile.in
index 1811cff..1ab9f9f 100644
--- a/src/Makefile.in
+++ b/src/Makefile.in
@@ -863,6 +863,27 @@ CHECK_CLEANFILES = *.chkexe *.chklog *.clog *.clog2
LT_VERS_INTERFACE = 100
LT_VERS_REVISION = 0
LT_VERS_AGE = 0
+LT_CXX_VERS_INTERFACE = 100
+LT_CXX_VERS_REVISION = 0
+LT_CXX_VERS_AGE = 0
+LT_F_VERS_INTERFACE = 100
+LT_F_VERS_REVISION = 0
+LT_F_VERS_AGE = 0
+LT_HL_VERS_INTERFACE = 100
+LT_HL_VERS_REVISION = 0
+LT_HL_VERS_AGE = 0
+LT_HL_CXX_VERS_INTERFACE = 100
+LT_HL_CXX_VERS_REVISION = 0
+LT_HL_CXX_VERS_AGE = 0
+LT_HL_F_VERS_INTERFACE = 100
+LT_HL_F_VERS_REVISION = 0
+LT_HL_F_VERS_AGE = 0
+LT_JAVA_VERS_INTERFACE = 100
+LT_JAVA_VERS_REVISION = 0
+LT_JAVA_VERS_AGE = 0
+LT_TOOLS_VERS_INTERFACE = 100
+LT_TOOLS_VERS_REVISION = 0
+LT_TOOLS_VERS_AGE = 0
# Our main target, the HDF5 library
lib_LTLIBRARIES = libhdf5.la
diff --git a/src/libhdf5.settings.in b/src/libhdf5.settings.in
index b54257f..8017594 100644
--- a/src/libhdf5.settings.in
+++ b/src/libhdf5.settings.in
@@ -60,8 +60,9 @@ Languages:
@BUILD_CXX_CONDITIONAL_TRUE@ Shared C++ Library: @enable_shared@
@BUILD_CXX_CONDITIONAL_TRUE@ Static C++ Library: @enable_static@
- JAVA: @HDF_JAVA@
- at BUILD_JAVA_CONDITIONAL_TRUE@ JAVA Compiler: @JAVA_VERSION@
+ Java: @HDF_JAVA@
+ at BUILD_JAVA_CONDITIONAL_TRUE@ Java Compiler: @JAVA_VERSION@
+
Features:
---------
diff --git a/tools/perform/sio_standalone.h b/tools/perform/sio_standalone.h
index 547a9ee..258eafb 100644
--- a/tools/perform/sio_standalone.h
+++ b/tools/perform/sio_standalone.h
@@ -210,11 +210,11 @@ H5_DLL int HDfprintf (FILE *stream, const char *fmt, ...);
#define HDgetgrgid(G) getgrgid(G)
#define HDgetgrnam(S) getgrnam(S)
#define HDgetgroups(Z,G) getgroups(Z,G)
-#ifdef H5_HAVE_VISUAL_STUDIO
+#ifdef H5_HAVE_WIN32_API
#define HDgetlogin() Wgetlogin()
-#else /* H5_HAVE_VISUAL_STUDIO */
+#else /* H5_HAVE_WIN32_API */
#define HDgetlogin() getlogin()
-#endif /* H5_HAVE_VISUAL_STUDIO */
+#endif /* H5_HAVE_WIN32_API */
#define HDgetpgrp() getpgrp()
#define HDgetpid() getpid()
#define HDgetppid() getppid()
@@ -222,12 +222,12 @@ H5_DLL int HDfprintf (FILE *stream, const char *fmt, ...);
#define HDgetpwuid(U) getpwuid(U)
#define HDgetrusage(X,S) getrusage(X,S)
#define HDgets(S) gets(S)
-#ifdef H5_HAVE_VISUAL_STUDIO
+#ifdef H5_HAVE_WIN32_API
H5_DLL int Wgettimeofday(struct timeval *tv, struct timezone *tz);
#define HDgettimeofday(V,Z) Wgettimeofday(V,Z)
-#else /* H5_HAVE_VISUAL_STUDIO */
+#else /* H5_HAVE_WIN32_API */
#define HDgettimeofday(S,P) gettimeofday(S,P)
-#endif /* H5_HAVE_VISUAL_STUDIO */
+#endif /* H5_HAVE_WIN32_API */
#define HDgetuid() getuid()
#define HDgmtime(T) gmtime(T)
#define HDisalnum(C) isalnum((int)(C)) /*cast for solaris warning*/
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-grass/hdf5.git
More information about the Pkg-grass-devel
mailing list