The MkRuntimeS provide a per-thread environment for libmkkernel … More...

#include <LibMkKernel_mk.h>

Collaboration diagram for MkRuntimeS:

Data Fields
union {

struct MkObjectS obj

}	super
	is the MkRuntimeS initialized? …

struct MkErrorS	error_mk
	default-system-error - default-error …

struct MkErrorPanicS	error_panic
	panic-system-error - panic on next error …

struct MkErrorPanicS	error_exit
	panic-system-error - panic on next error …

struct MkErrorIgnoreS	error_ignore
	ignore-system-error - ignore the next error …

struct MkErrorPrintS	error_print
	ignore-system-error - print the next error into MkLogFileC …

struct MkBuffer64S	tbuf
	runtime local buffer (RLS) for misc tasks …

MkThreadDataS	mkThreadData
	application specific thread data …

MK_RTEXT	mkRtExt
	package specific runtime extension …

MK_RTEXT	mkRtExtAry [MkExtension_size]
	package specific runtime extension - fast access by …

MkSelfIncrF	fSelfIncr
	"incr" Self pointer if pointer stored INTERNAL (MkObjectHandleGet)

MkSelfDecrF	fSelfDecr
	"decr" Self pointer if pointer stored INTERNAL (MkObjectHandleDelete)

bool	MkSelfIncrOnCacheB
	incr refCount on self at MkSelfNew …

struct MkTypeDefS	_MkObjectC_T

struct MkTypeDefS	_MkBufferC_T

struct MkTypeDefS	_MkBuffer64C_T

struct MkTypeDefS	_MkBuffer256C_T

struct MkTypeDefS	_MkBuffer1024C_T

struct MkTypeDefS	_MkBufferStreamC_T

struct MkTypeDefS	_MkBufferStream16384C_T

struct MkTypeDefS	_MkBufferStream256C_T

struct MkTypeDefS	_MkBufferStream64C_T

struct MkTypeDefS	_MkBufferStream1024C_T

struct MkTypeDefS	_MkBufferListC_T

struct MkTypeDefS	_MkLogFileC_T

struct MkTypeDefS	_MkErrorC_T

struct MkTypeDefS	_MkErrorDefaultC_T

struct MkTypeDefS	_MkErrorIgnoreC_T

struct MkTypeDefS	_MkErrorPrintC_T

struct MkTypeDefS	_MkErrorPanicC_T

struct MkTypeDefS	_MkErrorExitC_T

struct MkTypeDefS	_MkExtensionC_T

struct MkTypeDefS	_MkErrExtC_T

struct MkTypeDefS	_MkRtExtC_T

struct MkTypeDefS	_MkRuntimeC_T

struct MkTypeS	_MkTypeC_TT

struct MkTypeS	_MkTypeDefC_TT

MK_BINB	private_variables [12986]

runtime-configuration
This is the global per-thread-configuration data, the "pIoStartServer" will use this data for setup the `MqSysServerThreadMainS` for a new thread.
bool	isSilent
	write (`MK_NO`) or don't write (`MK_YES`) any message to MkLogFileC (default: stderr) (default: `MK_NO`) …

bool	noDeco
	do not use decoration to generate log messages (default: use decoration) …

MK_I32	debug
	set the debug-level of the context … Valid values are 0 <= debug-level <= 9 using 0 for no-debug and 9 for maximum-debug. (default: 0)

MkLogDataS	log
	struct to hold the mkrt-logging-data …

Detailed Description

The MkRuntimeS provide a per-thread environment for libmkkernel …

Definition at line 12039 of file LibMkKernel_mk.h.

Field Documentation

◆ _MkBuffer1024C_T

struct MkTypeDefS MkRuntimeS::_MkBuffer1024C_T

Definition at line 12144 of file LibMkKernel_mk.h.

◆ _MkBuffer256C_T

struct MkTypeDefS MkRuntimeS::_MkBuffer256C_T

Definition at line 12143 of file LibMkKernel_mk.h.

◆ _MkBuffer64C_T

struct MkTypeDefS MkRuntimeS::_MkBuffer64C_T

Definition at line 12142 of file LibMkKernel_mk.h.

◆ _MkBufferC_T

struct MkTypeDefS MkRuntimeS::_MkBufferC_T

Definition at line 12141 of file LibMkKernel_mk.h.

◆ _MkBufferListC_T

struct MkTypeDefS MkRuntimeS::_MkBufferListC_T

Definition at line 12150 of file LibMkKernel_mk.h.

◆ _MkBufferStream1024C_T

struct MkTypeDefS MkRuntimeS::_MkBufferStream1024C_T

Definition at line 12149 of file LibMkKernel_mk.h.

◆ _MkBufferStream16384C_T

struct MkTypeDefS MkRuntimeS::_MkBufferStream16384C_T

Definition at line 12146 of file LibMkKernel_mk.h.

◆ _MkBufferStream256C_T

struct MkTypeDefS MkRuntimeS::_MkBufferStream256C_T

Definition at line 12147 of file LibMkKernel_mk.h.

◆ _MkBufferStream64C_T

struct MkTypeDefS MkRuntimeS::_MkBufferStream64C_T

Definition at line 12148 of file LibMkKernel_mk.h.

◆ _MkBufferStreamC_T

struct MkTypeDefS MkRuntimeS::_MkBufferStreamC_T

Definition at line 12145 of file LibMkKernel_mk.h.

◆ _MkErrExtC_T

struct MkTypeDefS MkRuntimeS::_MkErrExtC_T

Definition at line 12159 of file LibMkKernel_mk.h.

◆ _MkErrorC_T

struct MkTypeDefS MkRuntimeS::_MkErrorC_T

Definition at line 12152 of file LibMkKernel_mk.h.

◆ _MkErrorDefaultC_T

struct MkTypeDefS MkRuntimeS::_MkErrorDefaultC_T

Definition at line 12153 of file LibMkKernel_mk.h.

◆ _MkErrorExitC_T

struct MkTypeDefS MkRuntimeS::_MkErrorExitC_T

Definition at line 12157 of file LibMkKernel_mk.h.

◆ _MkErrorIgnoreC_T

struct MkTypeDefS MkRuntimeS::_MkErrorIgnoreC_T

Definition at line 12154 of file LibMkKernel_mk.h.

◆ _MkErrorPanicC_T

struct MkTypeDefS MkRuntimeS::_MkErrorPanicC_T

Definition at line 12156 of file LibMkKernel_mk.h.

◆ _MkErrorPrintC_T

struct MkTypeDefS MkRuntimeS::_MkErrorPrintC_T

Definition at line 12155 of file LibMkKernel_mk.h.

◆ _MkExtensionC_T

struct MkTypeDefS MkRuntimeS::_MkExtensionC_T

Definition at line 12158 of file LibMkKernel_mk.h.

◆ _MkLogFileC_T

struct MkTypeDefS MkRuntimeS::_MkLogFileC_T

Definition at line 12151 of file LibMkKernel_mk.h.

◆ _MkObjectC_T

struct MkTypeDefS MkRuntimeS::_MkObjectC_T

Definition at line 12140 of file LibMkKernel_mk.h.

◆ _MkRtExtC_T

struct MkTypeDefS MkRuntimeS::_MkRtExtC_T

Definition at line 12160 of file LibMkKernel_mk.h.

◆ _MkRuntimeC_T

struct MkTypeDefS MkRuntimeS::_MkRuntimeC_T

Definition at line 12161 of file LibMkKernel_mk.h.

◆ _MkTypeC_TT

struct MkTypeS MkRuntimeS::_MkTypeC_TT

Definition at line 12162 of file LibMkKernel_mk.h.

◆ _MkTypeDefC_TT

struct MkTypeS MkRuntimeS::_MkTypeDefC_TT

Definition at line 12163 of file LibMkKernel_mk.h.

◆ debug

MK_I32 MkRuntimeS::debug

set the debug-level of the context … Valid values are 0 <= debug-level <= 9 using 0 for no-debug and 9 for maximum-debug. (default: 0)

Definition at line 12100 of file LibMkKernel_mk.h.

◆ error_exit

struct MkErrorPanicS MkRuntimeS::error_exit

panic-system-error - panic on next error …

If the panic-system-error is used as the format-obj of an error-message, the text is formated as usual, but the default-error is not set, instead a MkPanicVL is called and the application terminates.

MkErrorPANIC - usage

Set the MkErrorS::format_of_error attribute to PANIC. The next error-message will be formated as usual and than be reported using MkPanicVL. With MkPanicVL the error will be printed to MkLogFileC (default: stderr) and the application will abort.

Returns: the default-error with MkErrorS::format_of_error attribute set

See also: ErrorDEFAULT, ErrorPRINT, ErrorIGNORE, MkErrorPANIC, RMkNsRT{ErrorEXIT}

Definition at line 12072 of file LibMkKernel_mk.h.

◆ error_ignore

struct MkErrorIgnoreS MkRuntimeS::error_ignore

ignore-system-error - ignore the next error …

The next error will be ignored, no formatting will be performed and the the default-error will not be modified.

MkErrorIGNORE - usage

There are two functions to suppress an error: MkErrorIGNORE and MkErrorNoRaise.

MkErrorIGNORE: Set the MkErrorS::format_of_error attribute to IGNORE. The next error will be ignored, no formatting will be performed and the the default-error will not be modified.
MkErrorNoRaise: Set the MkErrorS::noRaise attribute to TRUE. The next error will be set as usual but not raised. This is usefull to set an error and later append additional information to the error. Final the error have to be raised with MkErrorRaise.

Returns: the default-error with MkErrorS::format_of_error attribute set

See also: ErrorDEFAULT, ErrorPRINT, ErrorIGNORE, MkErrorPANIC, RMkNsRT{ErrorEXIT}

Definition at line 12075 of file LibMkKernel_mk.h.

◆ error_mk

struct MkErrorS MkRuntimeS::error_mk

default-system-error - default-error …

The default-error is defined once per runtime and is used as only-valid-source of an MkErrorC in a thread or process.

See also: ErrorFORMAT, ErrorPRINT, ErrorIGNORE, MkErrorPANIC, RMkNsRT{ErrorEXIT}

Definition at line 12066 of file LibMkKernel_mk.h.

◆ error_panic

struct MkErrorPanicS MkRuntimeS::error_panic

panic-system-error - panic on next error …

If the panic-system-error is used as the format-obj of an error-message, the text is formated as usual, but the default-error is not set, instead a MkPanicVL is called and the application terminates.

MkErrorPANIC - usage

Set the MkErrorS::format_of_error attribute to PANIC. The next error-message will be formated as usual and than be reported using MkPanicVL. With MkPanicVL the error will be printed to MkLogFileC (default: stderr) and the application will abort.

Returns: the default-error with MkErrorS::format_of_error attribute set

See also: ErrorDEFAULT, ErrorPRINT, ErrorIGNORE, MkErrorPANIC, RMkNsRT{ErrorEXIT}

Definition at line 12069 of file LibMkKernel_mk.h.

◆ error_print

struct MkErrorPrintS MkRuntimeS::error_print

ignore-system-error - print the next error into MkLogFileC …

The next error-message will be formated as usual and than be reported using MkLogVL. The default-error will not be modified.

MkErrorPRINT - usage

Set the MkErrorS::format_of_error attribute to PRINT.

Returns: the default-error with MkErrorS::format_of_error attribute set

See also: ErrorDEFAULT, ErrorPRINT, ErrorIGNORE, MkErrorPANIC, RMkNsRT{ErrorEXIT}

Definition at line 12078 of file LibMkKernel_mk.h.

◆ fSelfDecr

MkSelfDecrF MkRuntimeS::fSelfDecr

"decr" Self pointer if pointer stored INTERNAL (MkObjectHandleDelete)

Definition at line 12122 of file LibMkKernel_mk.h.

◆ fSelfIncr

MkSelfIncrF MkRuntimeS::fSelfIncr

"incr" Self pointer if pointer stored INTERNAL (MkObjectHandleGet)

Definition at line 12119 of file LibMkKernel_mk.h.

◆ isSilent

bool MkRuntimeS::isSilent

write (MK_NO) or don't write (MK_YES) any message to MkLogFileC (default: stderr) (default: MK_NO) …

Definition at line 12089 of file LibMkKernel_mk.h.

◆ log

MkLogDataS MkRuntimeS::log

struct to hold the mkrt-logging-data …

Definition at line 12103 of file LibMkKernel_mk.h.

◆ mkRtExt

MK_RTEXT MkRuntimeS::mkRtExt

package specific runtime extension …

Definition at line 12114 of file LibMkKernel_mk.h.

◆ mkRtExtAry

MK_RTEXT MkRuntimeS::mkRtExtAry[MkExtension_size]

package specific runtime extension - fast access by …

Definition at line 12116 of file LibMkKernel_mk.h.

◆ MkSelfIncrOnCacheB

bool MkRuntimeS::MkSelfIncrOnCacheB

incr refCount on self at MkSelfNew …

Some Target-Programming-Language (TPL) (e.g. Python) return a new instance with refCount=1, which causes problems in MkSelfNew.

MkSelfNew uses MkSelfGet and MkSelfCreate if MkSelfGet returns NULL.

Now there is a discrepancy in the refCount between the self of MkSelfGet and the self of MkSelfCreate.

With MkSelfIncrOnNewSet(true), MkSelfNew adds a refCount to the self of MkSelfGet.

Note: The MkRuntimeS::fSelfIncr must be set for this.

Definition at line 12133 of file LibMkKernel_mk.h.

◆ mkThreadData

MkThreadDataS MkRuntimeS::mkThreadData

application specific thread data …

Definition at line 12111 of file LibMkKernel_mk.h.

◆ noDeco

bool MkRuntimeS::noDeco

do not use decoration to generate log messages (default: use decoration) …

Definition at line 12092 of file LibMkKernel_mk.h.

◆ obj

struct MkObjectS MkRuntimeS::obj

Definition at line 12060 of file LibMkKernel_mk.h.

◆ private_variables

MK_BINB MkRuntimeS::private_variables[12986]

Definition at line 12168 of file LibMkKernel_mk.h.

◆ [union]

union { ... } MkRuntimeS::super

is the MkRuntimeS initialized? …

On "smart" systems like "csharp"… threads are created "on-the-fly" not only on user-demand… The problem is the "cleanup" code from the garbage-collection is controlled by "csharp" and sometimes "csharp" choose a new thread for this task. a "new" thread start with an empty MkRuntimeS… we need to handle this.

By default the MkSetup will initialize the MkRuntimeS but in addition the MkRtSetup_NULL_RT macro will use the MkRT macro to perform the initialization.

◆ tbuf

struct MkBuffer64S MkRuntimeS::tbuf

runtime local buffer (RLS) for misc tasks …

Definition at line 12108 of file LibMkKernel_mk.h.

The documentation for this struct was generated from the following file:

LibMkKernel_mk.h

Data Fields

Detailed Description

Field Documentation

◆ _MkBuffer1024C_T

◆ _MkBuffer256C_T

◆ _MkBuffer64C_T

◆ _MkBufferC_T

◆ _MkBufferListC_T

◆ _MkBufferStream1024C_T

◆ _MkBufferStream16384C_T

◆ _MkBufferStream256C_T

◆ _MkBufferStream64C_T

◆ _MkBufferStreamC_T

◆ _MkErrExtC_T

◆ _MkErrorC_T

◆ _MkErrorDefaultC_T

◆ _MkErrorExitC_T

◆ _MkErrorIgnoreC_T

◆ _MkErrorPanicC_T

◆ _MkErrorPrintC_T

◆ _MkExtensionC_T

◆ _MkLogFileC_T

◆ _MkObjectC_T

◆ _MkRtExtC_T

◆ _MkRuntimeC_T

◆ _MkTypeC_TT

◆ _MkTypeDefC_TT

◆ debug

◆ error_exit

MkErrorPANIC - usage

◆ error_ignore

MkErrorIGNORE - usage

◆ error_mk

◆ error_panic

MkErrorPANIC - usage

◆ error_print

MkErrorPRINT - usage

◆ fSelfDecr

◆ fSelfIncr

◆ isSilent

◆ log

◆ mkRtExt

◆ mkRtExtAry

◆ MkSelfIncrOnCacheB

◆ mkThreadData

◆ noDeco

◆ obj

◆ private_variables

◆ [union]

◆ tbuf