[svn-r1568] Changes since 19990730

----------------------

This extensive change is the virtual file layer implementation. I've
ported and tested the sec2, family, and core drivers and only ported
the mpio driver (Albert will test it).  So if you need MPIO I would
recommend sticking with the previous version for a while.

You will get a few compile warnings about split and stdio drivers not
being implemented and possibly tracing information not inserted in
some of the drivers. You can safely ignore them but I plan to fix
them.

I'm still working on the split driver because I just realized that it
needs a part of the VFL that isn't written yet.

Documentation is being updated also because there were some minor
changes (mostly just name changes). It should be available on my web
site later this week.

./MANIFEST
./src/Makefile.in
./src/hdf5.h
./src/H5Flow.c			[REMOVED]
./src/H5Fstdio.c		[REMOVED]
./src/H5Fsec2.c			[REMOVED]
./src/H5Fsplit.c		[REMOVED]
./src/H5Fmpio.c			[REMOVED]
./src/H5Ffamily.c		[REMOVED]
./src/H5Fcore.c			[REMOVED]
./src/H5MFpublic.h		[REMOVED]
./src/H5FD.c			[NEW]
./src/H5FDcore.c		[NEW]
./src/H5FDcore.h		[NEW]
./src/H5FDfamily.c		[NEW]
./src/H5FDfamily.h		[NEW]
./src/H5FDmpio.c		[NEW]
./src/H5FDmpio.h		[NEW]
./src/H5FDprivate.h		[NEW]
./src/H5FDpublic.h		[NEW]
./src/H5FDsec2.c		[NEW]
./src/H5FDsec2.h		[NEW]
	Removed/added files for virtual file layer.

./bin/trace
./src/H5.c
	Removed unused public datatypes and added new VFL public
	datatypes.

	Changed an error message.

./config/BlankForm
./config/dec-flags
./config/gnu-flags
./config/hpux10.20
./config/hpux9.03
./config/irix5.x
./config/irix6.x
./config/solaris2.x
./config/unicosmk
	Removed the H5F_OPT_SEEK and H5F_LOW_DFLT constants from the
	configuration since they're no longer applicable. The default
	file driver is always the sec2 driver and it always optimizes
	calls to lseek() or lseek64().

./config/depend.in
	C preprocessor errors generated during automatic dependency
	building are sent to /dev/null to prevent them from appearing
	twice in the make output.

./src/H5AC.c
./src/H5B.c
./src/H5D.c
./src/H5F.c
./src/H5G.c
./src/H5Gent.c
./src/H5Gnode.c
./src/H5HG.c
./src/H5HL.c
./src/H5O.c
./src/H5Oattr.c
./src/H5Odtype.c
./src/H5Oefl.c
./src/H5Oshared.c
./src/H5T.c
./src/H5detect.c
./test/ohdr.c
	Changed H5F_ADDR_UNDEF to HADDR_UNDEF to be more consistent
	with the `haddr_t' datatype which is now a public type.

./src/H5D.c
./src/H5P.c
./src/H5Ppublic.h
./src/H5Tconv.c
./test/cmpd_dset.c
./test/dsets.c
./test/overhead.c
./test/tselect.c
./test/tvltypes.c
	The H5P_DATASET_XFER constant was changed to H5P_DATA_XFER
	because the properties apply to all types of I/O operations,
	not just datasets.

./src/H5B.c
./src/H5Bprivate.h
./src/H5D.c
./src/H5Dpublic.h
./src/H5F.c
./src/H5Farray.c
./src/H5Fistore.c
./src/H5Fprivate.h
./src/H5Fpublic.h
./src/H5Gnode.c
./src/H5Gpkg.h
./src/H5HG.c
./src/H5HL.c
./src/H5O.c
./src/H5R.c
./src/H5Sall.c
./src/H5Shyper.c
./src/H5Smpio.c
./src/H5Spoint.c
./src/H5Sprivate.h
./test/big.c
./test/h5test.c
./test/istore.c
./testpar/t_dset.c
./testpar/t_file.c
./tools/h5debug.c
./tools/h5ls.c
	Modified to work with the virtual file layer by calling H5FD_*
	functions instead of H5F_low_* functions and by passing file
	access and data transfer properties by object ID instead of
	pointer.

	Changed H5D_transfer_t to H5FD_mpio_xfer_t since the
	COLLECTIVE vs. INDEPENDENT transfer mode is specific to the
	MPIO file driver.

	Moved MPIO-specific stuff into the MPIO driver.

./src/H5B.c
./src/H5D.c
./src/H5Fprivate.h
	The H5F_mpio_* private functions were renamed and placed in
	the H5FDmpio driver except those which appeared in H5Smpio.c.

./src/H5E.c
./src/H5Epublic.h
	Added major error number H5E_VFL for virtual file layer
	related errors.

./src/H5F.c
./src/H5Fprivate.h
	Changed the logic that controls whether the boot block is
	written. Instead of assuming that the first call to write the
	boot block is only to allocate space, I've added a function
	argument which makes this explicit.

	Changed the way files are compared so that a driver-defined
	comparison function can be called.  Files which belong to
	different drivers are always considered different.

	Removed H5F_driver_t since file drivers are now identified by
	object ID instead of a special non-user-extendible datatype.

	Removed all the hard-coded low-level file properties which
	have been replaced by the various file drivers.

./src/H5I.c
./src/H5Iprivate.h
	Added the H5I_inc_ref() which was removed a few months ago
	since we finally have a use for it.

./src/H5Ipublic.h
	Added the H5I_VFL object ID type to identify file drivers in
	the virtual file layer.

./src/H5MF.c
./src/H5MFprivate.h
	Moved all the allocation/deallocation code into the virtual
	file layer which allows file drivers to override much of it.

./src/H5P.c
./src/H5Ppublic.h
	Moved file driver-specific code into the various file driver
	files.

	The H5Pcopy() and H5Pclose() functions make calls into the
	virtual file driver to manage the memory for driver-specific
	file access and data transfer properties.

./src/H5private.h
./src/H5public.h
	The `haddr_t' type is now public.

./test/tfile.c
	Added a few more comments.

1 files changed, 0 insertions, 626 deletions

diff --git a/src/H5Ffamily.c b/src/H5Ffamily.c
deleted file mode 100644
index ac50541..0000000
--- a/src/H5Ffamily.c
+++ /dev/null
@@ -1,626 +0,0 @@
-/*
- * Copyright (C) 1997 Spizella Software
- *		      All rights reserved.
- *
- * Programmer: Robb Matzke <matzke@llnl.gov>
- *	       Monday, November 10, 1997
- *
- * Purpose:	Implements a family of files that acts as a single hdf5
- *		file.  The purpose is to be able to split a huge file on a
- *		64-bit platform, transfer all the <2GB members to a 32-bit
- *		platform, and then access the entire huge file on the 32-bit
- *		platform.
- *
- *		All family members are logically the same size although their
- *		physical sizes may vary.  The logical member size is
- *		determined by looking at the physical size of the first
- *		member and rounding that up to the next power of two.  When
- *		creating a file family, the first member is created with a
- *		predefined physical size (actually, this happens when the
- *		file family is flushed, and can be quite time consuming on
- *		file systems that don't implement holes, like nfs).
- *		
- */
-#include <H5private.h>
-#include <H5Eprivate.h>
-#include <H5Fprivate.h>
-#include <H5MMprivate.h>
-
-#define PABLO_MASK H5Ffamily_mask
-static intn		interface_initialize_g = 0;
-#define INTERFACE_INIT NULL
-
-#define H5F_FAM_OFFSET(LF,ADDR)	((off_t)((ADDR) % (LF)->u.fam.memb_size))
-#define H5F_FAM_MEMBNO(LF,ADDR)	((intn)((ADDR) / (LF)->u.fam.memb_size))
-
-static htri_t H5F_fam_access(const char *name,
-			     const H5F_access_t *access_parms, int mode,
-			     H5F_search_t *key/*out*/);
-static H5F_low_t *H5F_fam_open(const char *name,
-			       const H5F_access_t *access_parms, uintn flags,
-			       H5F_search_t *key/*out*/);
-static herr_t H5F_fam_close(H5F_low_t *lf, const H5F_access_t *access_parms);
-static herr_t H5F_fam_read(H5F_low_t *lf, const H5F_access_t *access_parms,
-			   const H5F_xfer_t *xfer_parms, haddr_t addr,
-			   size_t size, uint8_t *buf);
-static herr_t H5F_fam_write(H5F_low_t *lf, const H5F_access_t *access_parms,
-			    const H5F_xfer_t *xfer_parms, haddr_t addr,
-			    size_t size, const uint8_t *buf);
-static herr_t H5F_fam_flush(H5F_low_t *lf, const H5F_access_t *access_parms);
-
-const H5F_low_class_t H5F_LOW_FAMILY_g[1] = {{
-    H5F_fam_access,		/*access method				*/
-    H5F_fam_open,		/*open method				*/
-    H5F_fam_close,		/*close method				*/
-    H5F_fam_read,		/*read method				*/
-    H5F_fam_write,		/*write method				*/
-    H5F_fam_flush,		/*flush method				*/
-    NULL,			/*extend method				*/
-    NULL,			/*alloc method				*/
-}};
-
-
-/*-------------------------------------------------------------------------
- * Function:	H5F_fam_open
- *
- * Purpose:	Opens a file family with the specified base name.  The name
- *		should contain a printf-style "%d" field which will be
- *		expanded with a zero-origin family member number.
- *
- * Bugs:	We don't check for overflow on the name, so keep it under
- *		4kb, please.  Also, we don't actually check for the `%d'
- *		field because we assume that the caller already did.  Who
- *		knows what happens when all the family member names are the
- *		same!
- *
- * Return:	Success:	Low-level file pointer
- *
- *		Failure:	NULL
- *
- * Programmer:	Robb Matzke
- *		Monday, November 10, 1997
- *
- * Modifications:
- *
- *-------------------------------------------------------------------------
- */
-static H5F_low_t *
-H5F_fam_open(const char *name, const H5F_access_t *access_parms,
-	     uintn flags, H5F_search_t *key/*out*/)
-{
-    H5F_low_t	*ret_value = NULL;
-    H5F_low_t	*lf = NULL;
-    H5F_low_t	*member = NULL;		/*a family member		*/
-    char	member_name[4096];	/*name of family member		*/
-    intn	membno;			/*member number (zero-origin)	*/
-    haddr_t	tmp_addr;		/*temporary address		*/
-    const H5F_low_class_t *memb_type;	/*type of family member		*/
-
-    FUNC_ENTER(H5F_fam_open, NULL);
-
-    assert (access_parms);
-    assert (H5F_LOW_FAMILY==access_parms->driver);
-    assert (access_parms->u.fam.memb_access);
-    memb_type = H5F_low_class (access_parms->u.fam.memb_access->driver);
-
-    /*
-     * If we're truncating the file then delete all but the first family
-     * member.
-     */
-    if ((flags & H5F_ACC_RDWR) && (flags & H5F_ACC_TRUNC)) {
-	for (membno=1; /*void*/; membno++) {
-	    sprintf(member_name, name, membno);
-	    if (!H5F_low_access(memb_type, member_name,
-				access_parms->u.fam.memb_access,
-				F_OK, NULL)) {
-		break;
-	    } else if (HDunlink(member_name) < 0) {
-		HGOTO_ERROR(H5E_IO, H5E_CANTINIT, NULL, "can't delete member");
-	    }
-	}
-    }
-
-    /* Create the file descriptor */
-    if (NULL==(lf = H5MM_calloc(sizeof(H5F_low_t))) ||
-	NULL==(lf->u.fam.name = H5MM_strdup(name))) {
-	HGOTO_ERROR (H5E_RESOURCE, H5E_NOSPACE, NULL,
-		     "memory allocation failed");
-    }
-    lf->u.fam.flags = (flags & ~H5F_ACC_CREAT);
-
-    /* Open all existing members */
-    for (membno = 0; /*void*/; membno++) {
-	sprintf(member_name, name, membno);
-
-	/*
-	 * Open the family member.  After the first member is opened or
-	 * created, turn off the creation flag so we don't create a zillion
-	 * family members.
-	 */
-	member = H5F_low_open(memb_type, member_name,
-			      access_parms->u.fam.memb_access, flags,
-			      0 == membno ? key : NULL);
-	if (!member) {
-	    if (0 == membno) {
-		HGOTO_ERROR(H5E_IO, H5E_CANTOPENFILE, NULL,
-			    "can't open first family member");
-	    }
-	    break;
-	}
-	flags &= ~H5F_ACC_CREAT;
-
-	/* Add the member to the family */
-	if (lf->u.fam.nmemb >= lf->u.fam.nalloc) {
-	    size_t na = MAX (100, 2*lf->u.fam.nalloc);
-	    H5F_low_t **x = H5MM_realloc (lf->u.fam.memb,
-					  na*sizeof(H5F_low_t*));
-	    if (NULL==x) {
-		HGOTO_ERROR (H5E_RESOURCE, H5E_NOSPACE, NULL,
-			     "memory allocation failed");
-	    }
-	    lf->u.fam.nalloc = (intn)na;
-	    lf->u.fam.memb = x;
-	}
-	lf->u.fam.memb[lf->u.fam.nmemb++] = member;
-	member = NULL;
-    }
-
-    H5F_low_size (lf->u.fam.memb[0], &tmp_addr/*out*/);
-    if (1==lf->u.fam.nmemb &&
-	H5F_addr_gt (tmp_addr, access_parms->u.fam.memb_size)) {
-	/*
-	 * If there's only one member and the member is larger than the
-	 * specified member size, then adjust the specified member size to be
-	 * the same as the actual member size, but at least 1kB
-	 */
-#ifdef H5F_DEBUG
-	if (H5DEBUG(F)) {
-	    HDfprintf (H5DEBUG(F), "H5F: family member size has been "
-		       "increased from %a to %a\n",
-		       access_parms->u.fam.memb_size, tmp_addr);
-	}
-#endif
-	if (tmp_addr<1024) tmp_addr = 1024;
-	lf->u.fam.memb_size = tmp_addr;
-	
-    } else if (1==lf->u.fam.nmemb) {
-	/*
-	 * If there's just one member then use the specified size for the
-	 * family members.
-	 */
-	lf->u.fam.memb_size = access_parms->u.fam.memb_size;
-	
-    } else if (lf->u.fam.nmemb>1 &&
-	       H5F_addr_ne(tmp_addr, access_parms->u.fam.memb_size)) {
-	/*
-	 * If there are more than one member then use the size of the first
-	 * member as the member size.
-	 */
-#ifdef H5F_DEBUG
-	if (H5DEBUG(F)) {
-	    HDfprintf (H5DEBUG(F), "H5F: family member size adjusted from "
-		       "%a to %a\n", access_parms->u.fam.memb_size, tmp_addr);
-	}
-#endif
-	lf->u.fam.memb_size = tmp_addr;
-	for (membno=1; membno<lf->u.fam.nmemb; membno++) {
-	    H5F_low_size(lf->u.fam.memb[membno], &tmp_addr/*out*/);
-	    if (H5F_addr_gt(tmp_addr, lf->u.fam.memb_size)) {
-		HGOTO_ERROR (H5E_IO, H5E_CANTINIT, NULL, "family contains "
-			     "member(s) larger than first member");
-	    }
-	}
-	    
-    } else {
-	/* The family member size is the size of the first family member */
-	lf->u.fam.memb_size = tmp_addr;
-    }
-    
-#ifdef H5F_DEBUG
-    /*
-     * Check for funny member sizes.  One common mistake is to use 2^32 as the
-     * member size but on a 32-bit machine this isn't possible.  The largest
-     * file on a 32-bit machine is 2^32-1.
-     */
-    if (H5DEBUG(F) &&
-	lf->u.fam.memb_size == ((size_t)1<<(sizeof(off_t)-1))) {
-	HDfprintf(H5DEBUG(F), "H5F: family member size may be too large: %a\n",
-		  lf->u.fam.memb_size);
-    }
-#endif
-	
-    /*
-     * Get the total family size and store it in the max_addr field.
-     */
-    assert(lf->u.fam.nmemb >= 1);
-    lf->eof = lf->u.fam.memb_size;
-    lf->eof *= (lf->u.fam.nmemb-1);
-    lf->eof += lf->u.fam.memb[lf->u.fam.nmemb-1]->eof;
-
-    HRETURN(lf);
-
-  done:
-    if (!ret_value) {
-	if (lf) {
-	    H5F_fam_close(lf, access_parms);
-	    H5MM_xfree(lf);
-	}
-    }
-    FUNC_LEAVE(ret_value);
-}
-
-
-/*-------------------------------------------------------------------------
- * Function:	H5F_fam_close
- *
- * Purpose:	Closes all members of a file family and releases resources
- *		used by the file descriptor.
- *
- * Return:	Non-negative on success/Negative on failure
- *
- * Programmer:	Robb Matzke
- *		Monday, November 10, 1997
- *
- * Modifications:
- *
- *-------------------------------------------------------------------------
- */
-static herr_t
-H5F_fam_close(H5F_low_t *lf, const H5F_access_t *access_parms)
-{
-    intn		    membno;
-
-    FUNC_ENTER(H5F_fam_close, FAIL);
-
-    assert(lf);
-
-    for (membno = 0; membno < lf->u.fam.nmemb; membno++) {
-	lf->u.fam.memb[membno] = H5F_low_close(lf->u.fam.memb[membno],
-					      access_parms->u.fam.memb_access);
-    }
-    H5MM_xfree(lf->u.fam.memb);
-    H5MM_xfree(lf->u.fam.name);
-
-    FUNC_LEAVE(SUCCEED);
-}
-
-/*-------------------------------------------------------------------------
- * Function:	H5F_fam_read
- *
- * Purpose:	Reads a chunk of contiguous data from the file family.
- *		Reading past the physical end of a file returns zeros instead
- *		of failing. We must insure that if the logical end of file is
- *		before the physical end of file that we will read zeros there
- *		also (the only time this can happen is if we create a family
- *		and then close it before the first member is filled, since
- *		flushing the file causes the first member to be physically
- *		extended to it's maximum size).
- *
- * Return:	Non-negative on success/Negative on failure
- *
- * Programmer:	Robb Matzke
- *		Monday, November 10, 1997
- *
- * Modifications:
- *		Albert Cheng, 1998-06-02
- *		Added XFER_MODE argument.
- *
- * 		Robb Matzke, 1999-07-28
- *		The ADDR argument is passed by value.
- *-------------------------------------------------------------------------
- */
-static herr_t
-H5F_fam_read(H5F_low_t *lf, const H5F_access_t *access_parms,
-	     const H5F_xfer_t *xfer_parms, haddr_t addr, size_t size,
-	     uint8_t *buf)
-{
-    size_t		nbytes;
-    haddr_t		cur_addr;
-    haddr_t		offset, member_size;
-    intn		membno;
-
-    FUNC_ENTER(H5F_fam_read, FAIL);
-
-    assert(lf);
-    assert(H5F_addr_defined(addr));
-    assert(buf);
-
-    member_size = lf->u.fam.memb_size;
-    membno = H5F_FAM_MEMBNO(lf, addr);
-    offset = H5F_FAM_OFFSET(lf, addr);
-    cur_addr = addr;
-
-    while (size > 0) {
-	if (membno >= lf->u.fam.nmemb) {
-	    HDmemset(buf, 0, size);
-	    break;
-	} else {
-	    nbytes = MIN(size, member_size-offset);
-	    cur_addr = offset;
-	    if (H5F_low_read(lf->u.fam.memb[membno],
-			     access_parms->u.fam.memb_access, xfer_parms,
-			     cur_addr, nbytes, buf) < 0) {
-		HRETURN_ERROR(H5E_IO, H5E_READERROR, FAIL,
-			      "can't read from family member");
-	    }
-	    buf += nbytes;
-	    size -= nbytes;
-	    membno++;
-	    offset = 0;
-	}
-    }
-
-    FUNC_LEAVE(SUCCEED);
-}
-
-
-/*-------------------------------------------------------------------------
- * Function:	H5F_fam_write
- *
- * Purpose:	Writes BUF to the family of files.  The superclass has
- *		already insured that we aren't writing past the logical end
- *		of file, so this function will extend the physical file to
- *		accommodate the new data if necessary.
- *
- * Return:	Non-negative on success/Negative on failure
- *
- * Programmer:	Robb Matzke
- *		Monday, November 10, 1997
- *
- * Modifications:
- *		Albert Cheng, 1998-06-02
- *		Added XFER_MODE argument.
- *
- * 		Robb Matzke, 1999-07-28
- *		The ADDR argument is passed by value.
- *-------------------------------------------------------------------------
- */
-static herr_t
-H5F_fam_write(H5F_low_t *lf, const H5F_access_t *access_parms,
-	      const H5F_xfer_t *xfer_parms, haddr_t addr, size_t size,
-	      const uint8_t *buf)
-{
-    size_t		   	nbytes;
-    haddr_t		    	cur_addr, max_addr;
-    intn		    	membno;
-    haddr_t			offset, member_size;
-    H5F_low_t		   	*member = NULL;
-    char		    	member_name[4096];
-    intn		    	i;
-    const H5F_low_class_t	*memb_type = NULL;
-    
-    FUNC_ENTER(H5F_fam_write, FAIL);
-
-    /* Check args */
-    assert(lf);
-    assert(H5F_addr_defined(addr));
-    assert(buf);
-    assert (access_parms);
-    assert (H5F_LOW_FAMILY==access_parms->driver);
-    assert (access_parms->u.fam.memb_access);
-
-    /* Get the member driver */
-    memb_type = H5F_low_class (access_parms->u.fam.memb_access->driver);
-    member_size = lf->u.fam.memb_size;
-    membno = H5F_FAM_MEMBNO(lf, addr);
-    offset = H5F_FAM_OFFSET(lf, addr);
-    cur_addr = addr;
-
-    while (size > 0) {
-	nbytes = MIN(size, member_size-offset);
-	cur_addr = offset;
-
-	if (membno >= lf->u.fam.nmemb) {
-	    /*
-	     * We're writing past the end of the last family member--create the
-	     * new family member(s)
-	     */
-	    if (membno >= lf->u.fam.nalloc) {
-		size_t na = (membno+1)*2;
-		H5F_low_t **x = H5MM_realloc (lf->u.fam.memb,
-					      na*sizeof(H5F_low_t*));
-		if (NULL==x) {
-		    HRETURN_ERROR (H5E_RESOURCE, H5E_NOSPACE, FAIL,
-				   "memory allocation failed");
-		}
-		lf->u.fam.nalloc = (intn)na;
-		lf->u.fam.memb = x;
-	    }
-	    for (i = lf->u.fam.nmemb; i <= membno; i++) {
-		sprintf(member_name, lf->u.fam.name, i);
-		member = H5F_low_open(memb_type, member_name,
-				      access_parms->u.fam.memb_access, 
-				      lf->u.fam.flags | H5F_ACC_CREAT,
-				      NULL);
-		if (!member) {
-		    HRETURN_ERROR(H5E_IO, H5E_CANTOPENFILE, FAIL,
-				  "can't create a new member");
-		}
-		
-		/*
-		 * For members in the middle, set their logical eof to the
-		 * maximum possible value.
-		 */
-		if (i < membno) {
-		    max_addr = member_size;
-		    H5F_low_seteof(member, max_addr);
-		}
-		lf->u.fam.memb[lf->u.fam.nmemb++] = member;
-	    }
-	}
-	
-	/*
-	 * Make sure the logical eof is large enough to handle the request.
-	 * Do not decrease the EOF
-	 */
-	max_addr = cur_addr + (hsize_t)nbytes;
-	if (H5F_addr_gt(max_addr, lf->u.fam.memb[membno]->eof)) {
-	    H5F_low_seteof(lf->u.fam.memb[membno], max_addr);
-	}
-	
-	/* Write the data to the member */
-	if (H5F_low_write(lf->u.fam.memb[membno],
-			  access_parms->u.fam.memb_access, xfer_parms,
-			  cur_addr, nbytes, buf) < 0) {
-	    HRETURN_ERROR(H5E_IO, H5E_WRITEERROR, FAIL,
-			  "can't write to family member");
-	}
-	buf += nbytes;
-	size -= nbytes;
-	membno++;
-	offset = 0;
-    }
-
-    FUNC_LEAVE(SUCCEED);
-}
-
-
-/*-------------------------------------------------------------------------
- * Function:	H5F_fam_flush
- *
- * Purpose:	Flushes all data to disk and makes sure that the first member
- *		is as large as a member can be so we can accurately detect
- *		the member size if we open this file for read access at a
- *		later date.
- *
- * Return:	Non-negative on success/Negative on failure
- *
- * Programmer:	Robb Matzke
- *		Monday, November 10, 1997
- *
- * Modifications:
- *
- *-------------------------------------------------------------------------
- */
-static herr_t
-H5F_fam_flush(H5F_low_t *lf, const H5F_access_t *access_parms)
-{
-    int			    membno, nerrors = 0;
-    uint8_t		    buf[1];
-    haddr_t		    addr1, addr2, addr3;
-    hsize_t		    max_offset;
-
-    FUNC_ENTER(H5F_fam_flush, FAIL);
-
-    /*
-     * Make sure that the first family member is the maximum size because
-     * H5F_fam_open() looks at the size of the first member to determine the
-     * size of each family member.  We do this by reading the last possible
-     * byte from the member (which defaults to zero if we're reading past the
-     * end of the member) and then writing it back.
-     */
-    max_offset = lf->u.fam.memb_size - 1;
-    addr1 = max_offset;
-    H5F_low_size(lf->u.fam.memb[0], &addr2/*out*/);/*remember logical eof */
-    addr3 = addr1 + 1;
-    H5F_low_seteof(lf->u.fam.memb[0], addr3);	/*prevent a warning */
-    if (H5F_low_read(lf->u.fam.memb[0], access_parms->u.fam.memb_access,
-		     &H5F_xfer_dflt, addr1, 1, buf) < 0) {
-	HRETURN_ERROR(H5E_IO, H5E_READERROR, FAIL,
-		      "can't read from first family member");
-    }
-    if (H5F_low_write(lf->u.fam.memb[0], access_parms->u.fam.memb_access,
-		      &H5F_xfer_dflt, addr1, 1, buf) < 0) {
-	HRETURN_ERROR(H5E_IO, H5E_WRITEERROR, FAIL,
-		      "can't write to first family member");
-    }
-    H5F_low_seteof(lf->u.fam.memb[0], addr2);	/*reset old eof */
-
-    /*
-     * Flush each member file.	Don't return an error status until we've
-     * flushed as much as possible.
-     */
-    for (membno = 0; membno < lf->u.fam.nmemb; membno++) {
-	if (H5F_low_flush(lf->u.fam.memb[membno],
-			  access_parms->u.fam.memb_access) < 0) {
-	    nerrors++;
-	}
-    }
-    if (nerrors) {
-	HRETURN_ERROR(H5E_IO, H5E_WRITEERROR, FAIL,
-		      "can't flush family member");
-    }
-    FUNC_LEAVE(SUCCEED);
-}
-
-
-/*-------------------------------------------------------------------------
- * Function:	H5F_fam_access
- *
- * Purpose:	Determines if all members of the file family can be accessed
- *		and returns the key for the first member of the family.
- *
- * Return:	Success:	TRUE or FALSE
- *
- *		Failure:	FAIL
- *
- * Programmer:	Robb Matzke
- *		Monday, November 10, 1997
- *
- * Modifications:
- *
- *-------------------------------------------------------------------------
- */
-static htri_t
-H5F_fam_access(const char *name, const H5F_access_t *access_parms,
-	       int mode, H5F_search_t *key/*out*/)
-{
-    intn			membno;
-    char			member_name[4096];
-    htri_t			status;
-    htri_t			ret_value = FALSE;
-    const H5F_low_class_t	*memb_type = NULL;
-
-    FUNC_ENTER(H5F_fam_access, FAIL);
-
-    /* Check args */
-    assert (name && *name);
-    assert (access_parms);
-    assert (H5F_LOW_FAMILY==access_parms->driver);
-    assert (access_parms->u.fam.memb_access);
-
-    /* Get the driver for the family members */
-    memb_type = H5F_low_class (access_parms->u.fam.memb_access->driver);
-
-    /* Access the members */
-    for (membno=0; /*void*/; membno++) {
-	sprintf(member_name, name, membno);
-	status = H5F_low_access(memb_type, member_name, NULL, mode,
-				0 == membno ? key : NULL);
-
-	if (!status) {
-	    if (F_OK == mode) {
-		/*
-		 * If we didn't find a member then we must have gotten to the
-		 * end of the family.  As long as we found the first
-		 * member(s) the family exists.
-		 */
-		ret_value = membno > 0 ? TRUE : FALSE;
-		break;
-		
-	    } else if (H5F_low_access(memb_type, member_name,
-				      access_parms->u.fam.memb_access,
-				      F_OK, NULL)) {
-		/*
-		 * The file exists but didn't have the write access permissions.
-		 */
-		ret_value = FALSE;
-		break;
-		
-	    } else {
-		/*
-		 * The file doesn't exist because we got to the end of the
-		 * family.
-		 */
-		ret_value = TRUE;
-		break;
-	    }
-	}
-	if (status < 0) {
-	    HRETURN_ERROR(H5E_IO, H5E_CANTOPENFILE, FAIL,
-			  "access method failed for a member file");
-	}
-    }
-
-    FUNC_LEAVE(ret_value);
-}