mirror of
https://github.com/HDFGroup/hdf5.git
synced 2025-01-18 15:15:56 +08:00
cdeeb5553a
./src/Makefile.in
Added H5Ffamily.c and H5Fsplit.c
./src/H5B.c
./src/H5Bprivate.h
./src/H5Gnode.c
Added `const' to sublass arguments.
./src/H5F.c
./src/H5Flow.c
./src/H5Fsec2.c
Make sure file buffers get flushed during a call to
H5Fflush(). Check for overflow in address encoding and decoding.
./src/H5Ffam.c
./src/H5Fprivate.c
./test/istore.c
Implementation of file families so 32-bit machines can access
64-bit files.
./src/H5Oprivate.h
Removed H5O_NO_ADDR constant.
./config/freebsd2.2.1
./config/linux
Added -DH5G_DEBUG and -DH5F_DEBUG to the list of debugging flags.
./html/H5.format.html
Changed some <offset>-sized things to <length>-sized things.
./src/H5AC.c
./src/H5ACprivate.h
./src/H5B.c
./src/H5Bprivate.h
./src/H5C.c
./src/H5D.c
./src/H5F.c
./src/H5Fcore.c
./src/H5Fistore.c
./src/H5Flow.c
./src/H5Fprivate.h
./src/H5Fsec2.c
./src/H5Fstdio.c
./src/H5G.c
./src/H5Gent.c
./src/H5Gnode.c
./src/H5Gpkg.h
./src/H5Gprivate.h
./src/H5Gshad.c
./src/H5Gstab.c
./src/H5H.c
./src/H5Hprivate.h
./src/H5MF.c
./src/H5MFprivate.h
./src/H5O.c
./src/H5Ocont.c
./src/H5Oistore.c
./src/H5Oprivate.h
./src/H5Ostab.c
./src/H5Ostdst.c
./src/H5pivate.h
./src/debug.c
./test/istore.c
./test/theap.c
./test/tohdr.c
./test/tstab.c
Lots of changes caused by generalizing addresses. The haddr_t
is now a struct, so you can no longer perform arithmetic on
it. But since it's small, simple, and often used, storage is
allocated like with an integer. But we always pass them
around by reference. That is, when using an address in
another struct, allocate space:
struct my_struct {
char *name;
haddr_t address;
} x;
But when passing it to a function, pass by reference:
H5F_addr_print (stderr, &(x.address));
Addresses should be initialized with
H5F_addr_undef (&(x.address));
Functions for operating on addresses are in H5Flow.c and begin
with H5F_addr_... Functions never return haddr_t or haddr_t*;
they always pass them through arguments instead. A function
that returns an address through an argument does so with its
last argument and it is marked with `/*out*/'. Calls to such
functions also mark output-only arguments with `/*out*/'
./src/H5Fsplit.c (new)
A two-member family where all meta data goes in the first
member and all raw data goes in the second member.
./src/H5B.c
./src/H5D.c
./src/H5F.c
./src/H5Ffamily.c
./src/H5Fistore.c
./src/H5Flow.c
./src/H5Fprivate.h
./src/H5Fsec2.c
./src/H5Fstdio.c
./src/H5Gnode.c
./src/H5H.c
./src/H5MF.c
./src/H5MFprivate.h
./src/H5O.c
Differentiate between meta data storage and raw data
storage. Provide a mechanism so that the file driver can
extend the file to allocate more memory.
./src/H5E.c
./src/H5Epublic.c
Added the error H5E_TRUNCATED to be reported when the file is
shorter than the length recorded in the boot block.
./src/H5F.c
Added H5F_locate_signature() so we only do it in one place
now.
./INSTALL
./INSTALL_MAINT
Just a couple clarifications.
./html/ExternalFiles.html
./html/storage.html
Documents how external files work.
./test/hyperslab.c
./test/istore.c
Fixed printf's on 64-bit machines.
./test/istore.c
Added ifdef's to test the split file driver.
78 lines
2.7 KiB
Plaintext
78 lines
2.7 KiB
Plaintext
Information for HDF5 maintainers:
|
|
|
|
* You can run make from any directory. However, running in a
|
|
subdirectory only knows how to build things in that directory and
|
|
below. However, all makefiles know when their target depends on
|
|
something outside the local directory tree:
|
|
|
|
$ cd test
|
|
$ make
|
|
make: *** No rule to make target ../src/libhdf5.a
|
|
|
|
* All Makefiles understand the following targets:
|
|
|
|
all -- build locally.
|
|
install -- install libs, headers, progs.
|
|
uninstall -- removed installed files.
|
|
mostlyclean -- remove temp files (eg, *.o but not *.a).
|
|
clean -- mostlyclean plus libs and progs.
|
|
distclean -- all non-distributed files.
|
|
maintainer-clean -- all derived files but H5config.h.in and configure.
|
|
|
|
* Most Makefiles also understand:
|
|
|
|
TAGS -- build a tags table
|
|
dep, depend -- recalculate source dependencies
|
|
lib -- build just the libraries w/o programs
|
|
|
|
* If you have personal preferences for which make, compiler, compiler
|
|
flags, preprocessor flags, etc., that you use and you don't want to
|
|
set environment variables, then use a site configuration file.
|
|
|
|
When configure starts, it looks in the config directory for files
|
|
whose name is some combination of the CPU name, vendor, and
|
|
operating system in this order:
|
|
|
|
CPU-VENDOR-OS
|
|
VENDOR-OS
|
|
OS
|
|
|
|
The first file which is found is sourced and can therefore affect
|
|
the behavior of the rest of configure. For example, the linux
|
|
configuration file might contain:
|
|
|
|
# Site configuration -- do not distribute this file.
|
|
if test "X$CFLAGS" = "X"; then
|
|
CFLAGS="-g -Wall"
|
|
fi
|
|
|
|
Site configuration files are for personal preferences and should
|
|
not be distributed.
|
|
|
|
|
|
* If you use GNU make along with gcc the Makefile will contain targets
|
|
that automatically maintain a list of source interdependencies; you
|
|
seldom have to say `make clean'. I say `seldom' because if you
|
|
change how one `*.h' file includes other `*.h' files you'll have
|
|
to force an update.
|
|
|
|
To force an update of all dependency information remove the
|
|
`.depend' file from each directory and type `make depend'. For
|
|
instance:
|
|
|
|
$ cd $HDF5_HOME
|
|
$ find . -name .depend -exec rm {} \;
|
|
$ make depend
|
|
|
|
* Object files stay in the directory and are added to the library as a
|
|
final step instead of placing the file in the library immediately
|
|
and removing it from the directory. The reason is two-fold:
|
|
|
|
1. Most versions of make don't allow `$(LIB)($(SRC:.c=.o))'
|
|
which makes it necessary to have two lists of files, one
|
|
that ends with `.c' and the other that has the library
|
|
name wrapped around each `.o' file.
|
|
|
|
2. Some versions of make/ar have problems with modification
|
|
times of archive members.
|