Last modified: 26 March 2014
Name: H5Fmount
Signature:
herr_t H5Fmount(hid_t loc_id, const char *name, hid_t child_id, hid_t fmpl_id )

Purpose:
Mounts a file.

Description:
H5Fmount mounts the file specified by child_id onto the group specified by loc_id and name using the mount properties fmpl_id.

loc_id can be either a file or group identifier; name is relative to loc_id.

Note:
To date, no file mount properties have been defined in HDF5. The proper value to pass for fmpl_id is H5P_DEFAULT, indicating the default file mount property list.

Parameters:
hid_t loc_id IN: Identifier for of file or group in which name is defined.
const char *name     IN: Name of the group onto which the file specified by child_id is to be mounted.
hid_t child_id IN: Identifier of the file to be mounted.
hid_t fmpl_id IN: File mount property list identifier.
Pass H5P_DEFAULT (see note above).

Returns:
Returns a non-negative value if successful; otherwise returns a negative value.

Fortran90 Interface: h5fmount_f
SUBROUTINE h5fmount_f(loc_id, name, child_id, hdferr)
  IMPLICIT NONE 
  INTEGER(HID_T), INTENT(IN)  :: loc_id      ! File or group identifier
  CHARACTER(LEN=*), INTENT(IN):: name        ! Group name at locationloc_id
  INTEGER(HID_T), INTENT(IN)  :: child_id    ! File(to be mounted) identifier
  INTEGER, INTENT(OUT)        :: hdferr      ! Error code 
                                             ! 0 on success and -1 on failure
END SUBROUTINE h5fmount_f