F.2. para_core_shutdown

Uninitialises the library.

Synopsis. 

#include <parabellym/api.h>

int para_core_shutdown(int flags);

Arguments. 

flags

One of the following values:

  • PUC_NORMAL – attempt to shut down immediately. If modules are loaded, reports an error.

  • PUC_WAIT – wait until all modules unload, then shut down the library. This function is normally called after all modules are loaded. This function is expected to always succeed.

  • PUC_EMERGENCY – unload all modules, then shut down the library. With this option all modules receive a PSIG_UNLOAD signal which tells them to gracefully unload. Otherwise this mode is similar to PUC_WAIT.

Access. 

Restricted to the loader.

Description. 

This function lets the system loader to gracefully unload modules and shut the system down.

Return value. 

PEC_SUCCESS
The library was shut down.
PEC_HAVE_MODULES
There are active modules (returned when flags is PUC_NORMAL).