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:
- ss_file_flush: 11.11: Write pending data to file
- ss_file_open: 11.1: Open or create a file
- ss_file_synchronize: 11.9: Synchronize all scopes of a file
- Files: Introduction for current chapter