Close a file

ss_file_close is a function defined in ssfile.c.

Synopsis:

herr_t ss_file_close(ss_file_t *file)

Formal Arguments:

  • file: The file to be closed

Description: Closes a file and all scopes belonging to that file. All scopes belonging to the file are synchronized and flushed to the file first, and then all such scopes are closed. If the file contains scopes that were serving as registries for other files, those scopes will be removed from those files’ registry stacks.

Return Value: Returns non-negative on success; negative on failure.

Parallel Notes: Collective across the file’s communicator (see ss_file_open).

Issues: Closing a file simply causes the cur_open reference counter to be decremented in the GFile array. When this counter reaches zero the file is considered to be closed and we call H5Fclose, but we don’t entirely reset the GFile array entry to zero just in case there are still things pointing into this file.

See Also: