Coordinates a graceful shutdown of NSPR.
Syntax
#include <prinit.h> PRStatus PR_Cleanup(void);
Returns
The function returns one of the following values:
- If NSPR has been shut down successfully,
PR_SUCCESS
. - If the calling thread of this function is not the primordial thread,
PR_FAILURE
.
Description
PR_Cleanup
must be called by the primordial thread near the end of the main
function.
PR_Cleanup
attempts to synchronize the natural termination of the process. It does so by blocking the caller, if and only if it is the primordial thread, until all user threads have terminated. When the primordial thread returns from main
, the process immediately and silently exits. That is, the process (if necessary) forcibly terminates any existing threads and exits without significant blocking and without error messages or core files.