VortexCtx* vortex_ctx_new ( void  )

Creates a new vortex execution context.

This is mainly used by the main module (called from vortex_init_ctx) and finished from vortex_exit_ctx.

A context is required to make vortex library to work. This object stores a single execution context. Several execution context can be created inside the same process.

After calling to this function, a new VortexCtx is created and all configuration required previous to vortex_init_ctx can be done. Once prepared, a call to vortex_init_ctx starts vortex library.

Once you want to stop the library execution you must call to vortex_exit_ctx.

See http://lists.aspl.es/pipermail/vortex/2008-January/000343.html for more information.

Returns
A newly allocated reference to the VortexCtx. You must finish it with vortex_ctx_free. Reference returned must be checked to be not NULL (in which case, memory allocation have failed).

References VORTEX_CHECK_REF, VORTEX_CHECK_REF2, vortex_hash_new(), and vortex_mutex_create().