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? …

MK_RTEXT	rtHead

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

struct MkErrorPanicS	error_panic
	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	bud
	runtime local buffer (RLS) for misc tasks …

MK_PTR	threadData
	application specific thread data …

MK_RTEXT	mkrtext
	package specific runtime extension …

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 MkSuperTypeS	_MkObjectC_T

struct MkSuperTypeS	_MkBufferC_T

struct MkSuperTypeS	_MkBuffer64C_T

struct MkSuperTypeS	_MkBuffer256C_T

struct MkSuperTypeS	_MkBuffer1024C_T

struct MkSuperTypeS	_MkBufferStreamC_T

struct MkSuperTypeS	_MkBufferStream16384C_T

struct MkSuperTypeS	_MkBufferStream256C_T

struct MkSuperTypeS	_MkBufferStream64C_T

struct MkSuperTypeS	_MkBufferStream1024C_T

struct MkSuperTypeS	_MkBufferListC_T

struct MkSuperTypeS	_MkLogFileC_T

struct MkSuperTypeS	_MkErrorC_T

struct MkSuperTypeS	_MkErrorDefaultC_T

struct MkSuperTypeS	_MkErrorIgnoreC_T

struct MkSuperTypeS	_MkErrorPrintC_T

struct MkSuperTypeS	_MkErrorPanicC_T

struct MkSuperTypeS	_MkExtensionC_T

struct MkSuperTypeS	_MkErrExtC_T

struct MkSuperTypeS	_MkRtExtC_T

struct MkSuperTypeS	_MkRuntimeC_T

struct MkTypeS	_MkTypeC_TT

struct MkTypeS	_MkSuperTypeC_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)

FILE *	logFILE
	logging target… open MkRuntimeS::logfile (default: stderr)

MK_STR	logfile
	append to logfile, valid values are: stderr, stdout or a filename (default: stderr)

bool	logfileLOCK

Detailed Description

The MkRuntimeS provide a per-thread environment for LibMkKernel …

Definition at line 11214 of file LibMkKernel_mk.h.

Field Documentation

◆ _MkBuffer1024C_T

struct MkSuperTypeS MkRuntimeS::_MkBuffer1024C_T

Definition at line 11321 of file LibMkKernel_mk.h.

◆ _MkBuffer256C_T

struct MkSuperTypeS MkRuntimeS::_MkBuffer256C_T

Definition at line 11320 of file LibMkKernel_mk.h.

◆ _MkBuffer64C_T

struct MkSuperTypeS MkRuntimeS::_MkBuffer64C_T

Definition at line 11319 of file LibMkKernel_mk.h.

◆ _MkBufferC_T

struct MkSuperTypeS MkRuntimeS::_MkBufferC_T

Definition at line 11318 of file LibMkKernel_mk.h.

◆ _MkBufferListC_T

struct MkSuperTypeS MkRuntimeS::_MkBufferListC_T

Definition at line 11327 of file LibMkKernel_mk.h.

◆ _MkBufferStream1024C_T

struct MkSuperTypeS MkRuntimeS::_MkBufferStream1024C_T

Definition at line 11326 of file LibMkKernel_mk.h.

◆ _MkBufferStream16384C_T

struct MkSuperTypeS MkRuntimeS::_MkBufferStream16384C_T

Definition at line 11323 of file LibMkKernel_mk.h.

◆ _MkBufferStream256C_T

struct MkSuperTypeS MkRuntimeS::_MkBufferStream256C_T

Definition at line 11324 of file LibMkKernel_mk.h.

◆ _MkBufferStream64C_T

struct MkSuperTypeS MkRuntimeS::_MkBufferStream64C_T

Definition at line 11325 of file LibMkKernel_mk.h.

◆ _MkBufferStreamC_T

struct MkSuperTypeS MkRuntimeS::_MkBufferStreamC_T

Definition at line 11322 of file LibMkKernel_mk.h.

◆ _MkErrExtC_T

struct MkSuperTypeS MkRuntimeS::_MkErrExtC_T

Definition at line 11335 of file LibMkKernel_mk.h.

◆ _MkErrorC_T

struct MkSuperTypeS MkRuntimeS::_MkErrorC_T

Definition at line 11329 of file LibMkKernel_mk.h.

◆ _MkErrorDefaultC_T

struct MkSuperTypeS MkRuntimeS::_MkErrorDefaultC_T

Definition at line 11330 of file LibMkKernel_mk.h.

◆ _MkErrorIgnoreC_T

struct MkSuperTypeS MkRuntimeS::_MkErrorIgnoreC_T

Definition at line 11331 of file LibMkKernel_mk.h.

◆ _MkErrorPanicC_T

struct MkSuperTypeS MkRuntimeS::_MkErrorPanicC_T

Definition at line 11333 of file LibMkKernel_mk.h.

◆ _MkErrorPrintC_T

struct MkSuperTypeS MkRuntimeS::_MkErrorPrintC_T

Definition at line 11332 of file LibMkKernel_mk.h.

◆ _MkExtensionC_T

struct MkSuperTypeS MkRuntimeS::_MkExtensionC_T

Definition at line 11334 of file LibMkKernel_mk.h.

◆ _MkLogFileC_T

struct MkSuperTypeS MkRuntimeS::_MkLogFileC_T

Definition at line 11328 of file LibMkKernel_mk.h.

◆ _MkObjectC_T

struct MkSuperTypeS MkRuntimeS::_MkObjectC_T

Definition at line 11317 of file LibMkKernel_mk.h.

◆ _MkRtExtC_T

struct MkSuperTypeS MkRuntimeS::_MkRtExtC_T

Definition at line 11336 of file LibMkKernel_mk.h.

◆ _MkRuntimeC_T

struct MkSuperTypeS MkRuntimeS::_MkRuntimeC_T

Definition at line 11337 of file LibMkKernel_mk.h.

◆ _MkSuperTypeC_TT

struct MkTypeS MkRuntimeS::_MkSuperTypeC_TT

Definition at line 11339 of file LibMkKernel_mk.h.

◆ _MkTypeC_TT

struct MkTypeS MkRuntimeS::_MkTypeC_TT

Definition at line 11338 of file LibMkKernel_mk.h.

◆ bud

struct MkBuffer64S MkRuntimeS::bud

runtime local buffer (RLS) for misc tasks …

Definition at line 11287 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 11275 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

Definition at line 11250 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

Definition at line 11244 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

Definition at line 11247 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

Definition at line 11253 of file LibMkKernel_mk.h.

◆ fSelfDecr

MkSelfDecrF MkRuntimeS::fSelfDecr

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

Definition at line 11299 of file LibMkKernel_mk.h.

◆ fSelfIncr

MkSelfIncrF MkRuntimeS::fSelfIncr

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

Definition at line 11296 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 11264 of file LibMkKernel_mk.h.

◆ logFILE

FILE* MkRuntimeS::logFILE

logging target… open MkRuntimeS::logfile (default: stderr)

Definition at line 11278 of file LibMkKernel_mk.h.

◆ logfile

MK_STR MkRuntimeS::logfile

append to logfile, valid values are: stderr, stdout or a filename (default: stderr)

Definition at line 11281 of file LibMkKernel_mk.h.

◆ logfileLOCK

bool MkRuntimeS::logfileLOCK

Definition at line 11282 of file LibMkKernel_mk.h.

◆ mkrtext

MK_RTEXT MkRuntimeS::mkrtext

package specific runtime extension …

Definition at line 11293 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 11310 of file LibMkKernel_mk.h.

◆ noDeco

bool MkRuntimeS::noDeco

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

Definition at line 11267 of file LibMkKernel_mk.h.

◆ obj

struct MkObjectS MkRuntimeS::obj

Definition at line 11235 of file LibMkKernel_mk.h.

◆ private_variables

MK_BINB MkRuntimeS::private_variables[12986]

Definition at line 11344 of file LibMkKernel_mk.h.

◆ rtHead

MK_RTEXT MkRuntimeS::rtHead

Definition at line 11241 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.

◆ threadData

MK_PTR MkRuntimeS::threadData

application specific thread data …

Definition at line 11290 of file LibMkKernel_mk.h.

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

LibMkKernel_mk.h

Data Fields