Terminate the library

ss_finalize is a function defined in sslib.c.

Synopsis:

herr_t ss_finalize(void)

Description: A call to this function will flush all pending data to the layers below SSlib, and then release as many resources as possible. This function is a no-op if called after a previous successful call or before the library is initialized (explicitly or implicitly). Obviously this function does not implicitly initialize the library.

Calling this function near the end of execution is strongly encouraged though not strictly necessary if all files have been explicitly flushed and/or closed. This function is suitable for registration with atexit provided care is taken to ensure that layers below SSlib are not finalized first.

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

Parallel Notes: Collective across the library’s communicator.

See Also:

• Library: Introduction for current chapter