Name: H5Pset_obj_track_times
Signature:
herr_t H5Pset_obj_track_times( hid_t ocpl_id, hbool_t track_times )

Purpose:
Sets the recording of times associated with an object.

Description:
H5Pset_obj_track_times sets a property in the object creation property list, ocpl_id, that governs the recording of times associated with an object.

If track_times is TRUE, the following times will be recorded:
Birth time The time the object was created
Access time The last time that metadata or raw data was read from the object
Modification time     The last time data for this object was changed
(by writing raw data to a dataset or inserting, modifying, or deleting a link in a group)
Change time The last time metadata for this object was written
(by adding, modifying, or deleting an attribute on an object; extending the size of a dataset; et cetera)

If track_times is FALSE, time data will not be recorded.

Time data can be retrieved with H5Oget_info, which will return it in the H5O_info_t struct.

If times are not tracked, they will be reported as follows when queried:
    12:00 AM UDT, Jan. 1, 1970
That date and time are commonly used to represent the beginning of the UNIX epoch.

Parameters:

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

Fortran90 Interface: h5pset_obj_track_times_f
SUBROUTINE h5pset_obj_track_times_f(plist_id, flag, hdferr) 
  IMPLICIT NONE
  INTEGER(HID_T), INTENT(IN) :: plist_id 
                                 ! Dataset creation property 
                                 ! list identifier 
  LOGICAL, INTENT(IN) :: flag    ! Object timestamp setting
  INTEGER, INTENT(OUT) :: hdferr ! Error code
                                 ! 0 on success and -1 on failure
END SUBROUTINE h5pset_obj_track_times_f
	

History:
Release     C
1.8.0 Function introduced in this release.