Sets up Read-Only HDFS virtual file driver

hid_t fapl_id              IN: File access property list identifier

H5FD_hdfs_fapl_t *fa    IN: Structure containing file access property list configuration information

H5P_SET_FAPL_HDFS sets the file access property list fapl_id to use the HDFS.

The Read-Only HDFS virtual file driver transparently accesses HDF5-format files hosted on HDFS. The HDFS VFD supplies bytes transparently to the HDF5 library through the libhdfs API.

Non-negative value if successful. Otherwise returns negative value.

 hid_t fapl_id = -1;

    H5FD_hdfs_fapl_t fa = {

        1,           /* fapl version               */

        "localhost", /* namenode name              */

        8020,        /* namenode port              */

        "",          /* username                   */

        "",          /* kerberos ticket cache path */

        2048,        /* stream buffer size         */

    };

    fapl_id = H5Pcreate(H5P_FILE_ACCESS);

    assert( 0 >= fapl_id );

    assert( 0 >= H5Pset_fapl_hdfs(fapl_id, &fa) );

    /* proceed with file open... */