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