MainContext

int unittest_context_maincontext( void )

Test initialization process succeeds and global variables are set correctly.

int initstart_maincontext( const  maincontext_startparam_t  * startparam )

Calls platform_t.init_platform, maincontext_t.init_maincontext and runs main_thread.  This is a convenience function so you do not have to remember the process initialization sequence pattern.

int init_maincontext( const  maincontext_e  context_type, int  argc, const  char  ** argv )

Initializes global program context.  Must be called as first function from the main thread.  The main thread must be initialized with platform_t.init_platform before calling this function.  EALREADY is returned if it is called more than once.  The only service which works without calling this function is logging.

Background

This function calls init_processcontext and init_threadcontext which call every initonce_NAME and initthread_NAME functions in the same order as defined in “C-kern/resource/config/initprocess” and “C-kern/resource/config/initthread”.  This init database files are checked against the whole project with “C-kern/test/static/check_textdb.sh”.  So that no entry is forgotten.

int free_maincontext( void )

Frees global context.  Must be called as last function from the main thread of the whole system.

Ensures that after return the basic logging functionality is working.

Background

This function calls free_threadcontext and then free_processcontext which call every freethread_NAME and freeonce_NAME functions in the reverse order as defined in “C-kern/resource/config/initthread” and “C-kern/resource/config/initprocess”.  This init database files are checked against the whole project with “C-kern/test/static/check_textdb.sh”.  So that no entry is forgotten.

void abort_maincontext( int  err )

Exits the whole process in a controlled manner.  Tries to free as many external resources as possible and aborts all transactions. i Before exit TRACE_NOARG_ERRLOG(PROGRAM_ABORT, err) is called.

void assertfail_maincontext( const  char  * condition, const  char  * file, int  line, const  char  * funcname )

Exits the whole process in a controlled manner. writes »Assertion failed« to log and calls abort_maincontext.

Do not call assertfail_maincontext directly use the assert macro instead.

maincontext_t * self_maincontext( void )

Returns maincontext_t of the current process.

processcontext_t * pcontext_maincontext( void )

Returns processcontext_t of the current process.

threadcontext_t * tcontext_maincontext( void )

Returns threadcontext_t of the current thread.

maincontext_e type_maincontext( void )

Returns type <context_e> of current maincontext_t.

const char * progname_maincontext( void )

Returns the program name of the running process.  The returned value is the argv[0] delivered as parameter in <initmain_maincontext> without any leading path.

size_t threadid_maincontext( void )

Returns the thread id of the calling thread.

struct pagecache_blockmap_t * blockmap_maincontext( void )

Returns shared blockmap used by pagecache_impl_t (see <pagecache_blockmap_t >).

Returns error string table (see errorcontext_t).

Returns log service log_t (see logwriter_t).  This function can only be implemented as a macro.  C99 does not support references.

Returns interfaceable object mm_t for access of memory manager.

Returns interfaceable object objectcache_t for access of cached singleton objects.

Returns object interface pagecache_t to access functionality of pagecache_impl_t.

struct syncrun_t * syncrun_maincontext( void )

Returns syncrun_t of current maincontext_t.  It is used to store and run all syncthread_t of the current thread.

Returns <sysusercontext_t> of current maincontext_t.  It is used in implementation of module SystemUser.

struct valuecache_t * valuecache_maincontext( void )

Returns valuecache_t holding precomputed values.  Every value is cached as a single copy for the whole process.

void * allocstatic_maincontext( uint8_t  size )

Allocates size bytes of memory and returns the start address.  Used by modules during execution of their initonce_ functions.  This memory lives as long maincontext_t lives.  Must be called in reverse order of calls to allocstatic_maincontext.

int freestatic_maincontext( uint8_t  size )

Frees size bytes of last allocated memory.  Must be called in reverse order of calls to allocstatic_maincontext.  It is possible to free x calls to allocstatic_maincontext with one call to freestatic_maincontext where all sizes are summed up.

uint16_t sizestatic_maincontext( void )

Returns size in bytes of allocated static memory.