MqContextC - create and manage a slave context … More...

Collaboration diagram for MqContextC_SlaveApi_Slave_C_API:

Functions
enum MkErrorE	MqSlaveWorker_RT (MK_RT mkrt, MQ_CTX const ctx, MQ_SLAVE_ID const id, MK_STRN fct, MK_BAC args)
	create a master/slave link using the image of the ctx object self. …

enum MkErrorE	MqSlaveCreate_RT (MK_RT mkrt, MQ_CTX const ctx, MQ_SLAVE_ID const id, MQ_CTX const slave)
	create a master/slave link between the master-parent-context and the slave-parent-context …

enum MkErrorE	MqSlaveDelete_RT (MK_RT mkrt, MQ_CTX const ctx, MQ_SLAVE_ID const id)
	Delete a slave object from a master/slave link identified by id. …

static bool	MqSlaveCheck (MQ_CTXN const ctx, MQ_SLAVE_ID const id)
	check if slave-id is valid

enum MkErrorE	MqSlaveGet_RT (MK_RT mkrt, MQ_CTX const ctx, MQ_SLAVE_ID const id, MQ_CTX *ctx_out)
	get the slave-context from a master-context …

enum MkErrorE	MqSlaveGetProxy_RT (MK_RT mkrt, MQ_CTX const ctx, MQ_SLAVE_ID const id, MQ_CTX *ctx_out)
	on slave return the master and on master return the slave identified by id.

enum MkErrorE	MqSlaveGetFilter_RT (MK_RT mkrt, MQ_CTX const ctx, MQ_CTX *ctx_out)
	get the filter-ctx or the master-ctx …

static MQ_CTX	MqSlaveGetMaster (MQ_CTX const ctx)
	opposite function of MqSlaveGetFilter

static bool	MqSlaveIs (MQ_CTXN const ctx)
	is the context a slave-context ? …

MqContextC - MqContextC_SlaveApi_Slave_C_API - function
MQ_CTX	MqSlaveGetMasterP (MQ_CTX const ctx)
	Non-inline replacement for MqSlaveGetMaster …

MK_BOOL	MqSlaveCheckP (MQ_CTXN const ctx, MQ_SLAVE_ID const id)
	Non-inline replacement for MqSlaveCheck …

MK_BOOL	MqSlaveIsP (MQ_CTXN const ctx)
	Non-inline replacement for MqSlaveIs …

MqContextC - MqContextC_SlaveApi_Slave_C_API - overload
#define	MqSlaveGet_NULL(...)

#define	MqSlaveGet(...)

#define	MqSlaveGet_E(...)

#define	MqSlaveGet_C(...)

#define	MqSlaveGet_e(...)

#define	MqSlaveGetFilter_NULL(...)

#define	MqSlaveGetFilter(...)

#define	MqSlaveGetFilter_E(...)

#define	MqSlaveGetFilter_C(...)

#define	MqSlaveGetFilter_e(...)

#define	MqSlaveGetProxy_NULL(...)

#define	MqSlaveGetProxy(...)

#define	MqSlaveGetProxy_E(...)

#define	MqSlaveGetProxy_C(...)

#define	MqSlaveGetProxy_e(...)

#define	MqSlaveCreate_NULL(...)

#define	MqSlaveCreate(...)

#define	MqSlaveCreate_E(...)

#define	MqSlaveCreate_C(...)

#define	MqSlaveDelete_NULL(...)

#define	MqSlaveDelete(...)

#define	MqSlaveDelete_E(...)

#define	MqSlaveDelete_C(...)

#define	MqSlaveWorker_NULL(...)

#define	MqSlaveWorker(...)

#define	MqSlaveWorker_3(ctx, id, fct)

#define	MqSlaveWorker_2(ctx, id)

#define	MqSlaveWorker_E(...)

#define	MqSlaveWorker_C(...)

Detailed Description

MqContextC - create and manage a slave context …

The master-slave-link is used to create a mesh of nodes defined by different parent-context. The master control the slave.

The master-slave-link is used to perform the following tasks:

report error messages from the slave-context to the master-context
to create a slave-child-context if a master-child-context is created
to delete a slave-context if a master-context is deleted

In difference to the client-server-link the master-slave-link connect two independent parent-context in the same process or thread (e.g. node). This leads to the restriction that only the master-context can be a server-context because only one server-context per node is possible.

   node-0   |           node-1/2        |   node-3/4/5
===================================================================

| <- client/server link -> | <- client/server link -> |

             | <-- master/slave link --> |

                           |- client1-0 -|- server3 ...
             |-  server1  -|
             |             |- client1-1 -|- server4 ...
  client0-0 -|
             |-  server2  -|- client1-2 -|- server5 ...

Definition of the "master-context"

the master-context is a parent-context without a child-context available.
the master-context is a client-context or a server-context.
the link between the master-context and the slave-context is done using MqSlaveWorker or MqSlaveCreate

Definition of the "slave-context"

the slave-context is a parent-context without a child-context available.
the slave-context is a client-context.
the slave-context lifetime is controlled by the master-context.
the slave-context report all error-messages to the master-context.
the slave-context is identified by a unique-slave-id starting with 0.
a special form of a slave-context is a worker-context

Definition of the "worker-context"

the worker-context is a slave-context using the image of the master-context self.
the master-context can be a server-context or a client-context.
the worker-context is created using MqSlaveWorker
the worker-context is identified by a unique-slave-id starting with 0.

Definition of the "slave-id"

the slave-id is defined at enum MqSlaveE
a slave is identified in his master-context by a slave-id
the slave-id work like a defined well-known-port-number in /etc/services
the slave-id is an integer value with valid values > 0
it is a good practice to plan the usage of your slave-id(s)

slave

slave-id	value	definition
MQ_SLAVE_MAX	1024	internal: the maximum slave-id … .
MQ_SLAVE_USER	10	internal: start of user-defined-slave-id .
MQ_SLAVE_LOOPBACK	0	internal: the loopback-slave-id, (call my own services) .
MQ_SLAVE_FILTER	1	internal: the filter-slave-id, (on a master get the filter-slave) .
MQ_SLAVE_MASTER	1	internal: the master-slave-id, (on a slave get the master) .
MQ_SLAVE_OTHER	1	internal: on the master-ctx get the slave-ctx and on the slave-ctx get the master-ctx .

range

range	definition
0 <= slave-id < MQ_SLAVE_MAX	range of valid slave-id's
0 <= slave-id < MQ_SLAVE_USER	internale usage
MQ_SLAVE_USER <= slave-id < MQ_SLAVE_MAX	external usage

Definition of the "LOOPBACK" (0) slave

   client   |           server            |
===========================================

| <--- client/server --->  | <-- loop --> |

            | <------ master/slave -----> |

  client -- | -- server -- | -- client -- #
                   ==             ==      #
                 server -- | -- client -- #

the loopback has always the slave-id = 0 .
the loopback has the same class as the parent, if reflection is not available the MqFactoryInitial is used.
the loopback is used to call a service on the same process or thread.
the loopback is a special filter without an additional process or thread to be started.
the loopback is only internal accessible
the service called by the loopback need the same attention as the service called by the filter, the context of the service is the loopback-context.
the loopback can call MqServiceCreate to create a new link between a service-token and a service-method, by default all services from the master-context (the owner of the loopback) are also accessible by the loopback.
in the service use MqSlaveGetMaster to get the master-context from the loopback-context.

Example from MyLoopServer.tcl → create a new loop-server

package require tclmqmsgque
namespace import tclmqmsgque::*

::oo::class create MyLoopServer {
  superclass MqContextC
  export variable

  # factory startup
  constructor {{tmpl ""}} {
    my variable mydata;
    next $tmpl
    my ConfigSetServerSetup ServerSetup
    # set the "mydata" attribute to the master-context
    set mydata  "Hello World";
  }

  # service to serve all EXTERNAL requests for token "HLWO"
  method HLWO_srv {} {
    # get the "loopback" context
    set loop  [my SlaveGet LOOPBACK]
    # call the LOOP service on the SAME server
    $loop Send "W" "LOOP"
    # answer HLWO with string-return from LOOP
    my Send "R" "C" [$loop ReadSTR]
  }

  # service to serve all INTERNAL requests for token "LOOP"
  method LOOP_srv {} {
    # get the "master" context
    set master  [my SlaveGetMaster]
    # answer LOOP with data from MASTER->mydata attribute
    $master variable mydata
    my Send "R" "C" $mydata
  }

  # setup a server-context - called for every new server-context
  method ServerSetup {} {
    # EXTERNAL: link the "HLWO" service with "HLWO_srv"
    my ServiceCreate "HLWO" HLWO_srv
    # INTERNAL: link the "LOOP" service with "LOOP_srv"
    [my SlaveGet MQ_SLAVE_LOOPBACK] ServiceCreate "LOOP" LOOP_srv
  }
}

tclmqmsgque::Main {

  # create "MyLoopServer" factory... and the instance
  set srv   [[MqFactoryC Add MyLoopServer] New]

  try {
    $srv LinkCreate $argv
    $srv ProcessEvent MQ_WAIT_FOREVER
  } on error {} {
    $srv ErrorCatch
  } finally {
    $srv Exit
  }
}

Performance analyse

The performance-test is created with:

pipe
- Nhi1Exec perfclient.c --parent --wrk ? @ perfserver.c
spawn, fork, thread
- Nhi1Exec -r=uds perfserver.c --spawn|fork|thread
- Nhi1Exec -r=uds perfclient.c --parent --wrk ?
the number of workers are set with the –wrk option
the cpu is a xeon with 4/8
the performance is calculated as worker-context-created / time-in-sec with a ~2sec (default) measurement period.

performance-test code:

The test-setup is done as:

  perfclient                                worker                            perfserver
  ==========                                ======                            ==========
  |
  |- loop --wrk x
    |- MqSlaveWorker(...)               ->  worker[1] 
    |- MqSend(worker[1],"E","STR0..")   ->  PerfWorker_I160(...)
                                            |- loop endless
                                              |- MqContextCreate(...)
                                              |- MqLinkCreate(...)      <->   MqContextCreate(...)
                                              |- MqContextDelete(...)   <->   MqContextDelete(...)
  |- sleep x sec
  |- loop --wrk x
    |- MqSend(worker[1],"C"..,"END0")   ->  PerfWorker_END0(...)
    |                                       |- stop loop
    |- "callback" - add number to all   <-  |- return #context

Using the worker-code:
// asynchronous call

static enum MkErrorE PerfWorker_STR0( MQ_SERVICE_CALL_ARGS ) {

MK_BFL largv = NULL;

MK_BFL pargv = NULL;

MK_I32 num = MqReadI32_e(mqctx);

pargv = MkBufferListDup(MqReadBFL_e(mqctx));

enum MkErrorE ret = MK_OK;

if (num == -1) num = 999999; // endless

// start test until "doNext" is "false" or "num" exceeds

for (int i=0; doNext && i<num; i++) {

// CREATE the context

MQ_CTX ctx = MqContextCreate(NULL, mqctx);

largv = MkBufferListDup(pargv);

MqLinkCreate_C (ctx, largv) {

MqContextErrorMove(mqctx,ctx);

MqContextDelete(ctx);

goto error;

}

//MqSend(ctx,"E","MARK:C","start");

MkBufferListDelete(largv);

// DELETE the context

MqContextDelete(ctx);

// count the loops

worker_count++;

// give PerfWorker_END0 time to update "doNext"

MqProcessEvent(mqctx, MQ_WAIT_NO, MK_TIMEOUT_DEFAULT);

}

end:

//printV("ret=%i, Delete=%p\n", ret, largv)

MkBufferListDelete(largv);

MkBufferListDelete(pargv);

if (doNext == true) {

// finish the test WITHOUT "END0" -> test on --num, answer required.

MqSend_E(mqctx, "R", "I", worker_count);

}

return ret;

error:

if (doNext == true) {

ret = MkErrorStack_1X(mqctx);

} else {

ret = MkErrorReset_1X(mqctx);

}

goto end;

}

performance-test results:

results generated using the debug environment

setup	–wrk	# worker-context	performance	info
pipe	1	2500	1000	the pipe start a new worker-context with spawn
spawn	1	2500	<1000	same as pipe but use network-protocoll
fork	1	3800	4000	the fork is faster than spawn
thread	1	16500	9000	the thread is faster than fork
pipe	4	8000	4500	the worker scale linear up to number of processors
spawn	4	7600	<4500	-
fork	4	23200	11500	-
thread	4	55500	27500	-
pipe	8	10000	5500	the additional scaling up to the max hyper-threading does not really help
spawn	8	9100	<5500	-
fork	8	23200	11500	-
thread	8	55500	27500	-

Macro Definition Documentation

◆ MqSlaveCreate

#define MqSlaveCreate ( ... )

Value:

MqSlaveCreate_RT(MK_RT_CALL __VA_ARGS__)

MK_RT_CALL

#define MK_RT_CALL

MqSlaveCreate_RT

enum MkErrorE MqSlaveCreate_RT(MK_RT mkrt, MQ_CTX const ctx, MQ_SLAVE_ID const id, MQ_CTX const slave)

create a master/slave link between the master-parent-context and the slave-parent-context …

Definition at line 771 of file msgque_overload_mq.h.

◆ MqSlaveCreate_C

#define MqSlaveCreate_C ( ... )

Value:

if (MkErrorCheckI(MqSlaveCreate(__VA_ARGS__)))

MqSlaveCreate

#define MqSlaveCreate(...)

Definition msgque_overload_mq.h:771

Definition at line 773 of file msgque_overload_mq.h.

◆ MqSlaveCreate_E

#define MqSlaveCreate_E ( ... )

Value:

MkErrorCheck(MqSlaveCreate(__VA_ARGS__))

MkErrorCheck

MkErrorCheck(MqSendSTART(mqctx))

Definition at line 772 of file msgque_overload_mq.h.

◆ MqSlaveCreate_NULL

#define MqSlaveCreate_NULL ( ... )

Value:

MqSlaveCreate_RT(MK_RT_CALL_NULL __VA_ARGS__)

MK_RT_CALL_NULL

#define MK_RT_CALL_NULL

Definition at line 770 of file msgque_overload_mq.h.

◆ MqSlaveDelete

#define MqSlaveDelete ( ... )

Value:

MqSlaveDelete_RT(MK_RT_CALL __VA_ARGS__)

MqSlaveDelete_RT

enum MkErrorE MqSlaveDelete_RT(MK_RT mkrt, MQ_CTX const ctx, MQ_SLAVE_ID const id)

Delete a slave object from a master/slave link identified by id. …

Definition at line 775 of file msgque_overload_mq.h.

◆ MqSlaveDelete_C

#define MqSlaveDelete_C ( ... )

Value:

if (MkErrorCheckI(MqSlaveDelete(__VA_ARGS__)))

MqSlaveDelete

#define MqSlaveDelete(...)

Definition msgque_overload_mq.h:775

Definition at line 777 of file msgque_overload_mq.h.

◆ MqSlaveDelete_E

#define MqSlaveDelete_E ( ... )

Value:

MkErrorCheck(MqSlaveDelete(__VA_ARGS__))

Definition at line 776 of file msgque_overload_mq.h.

◆ MqSlaveDelete_NULL

#define MqSlaveDelete_NULL ( ... )

Value:

MqSlaveDelete_RT(MK_RT_CALL_NULL __VA_ARGS__)

Definition at line 774 of file msgque_overload_mq.h.

◆ MqSlaveGet

#define MqSlaveGet ( ... )

Value:

MqSlaveGet_RT(MK_RT_CALL __VA_ARGS__)

MqSlaveGet_RT

enum MkErrorE MqSlaveGet_RT(MK_RT mkrt, MQ_CTX const ctx, MQ_SLAVE_ID const id, MQ_CTX *ctx_out)

get the slave-context from a master-context …

Definition at line 754 of file msgque_overload_mq.h.

◆ MqSlaveGet_C

#define MqSlaveGet_C ( ... )

Value:

if (MkErrorCheckI(MqSlaveGet(__VA_ARGS__)))

MqSlaveGet

#define MqSlaveGet(...)

Definition msgque_overload_mq.h:754

Definition at line 756 of file msgque_overload_mq.h.

◆ MqSlaveGet_E

#define MqSlaveGet_E ( ... )

Value:

MkErrorCheck(MqSlaveGet(__VA_ARGS__))

Definition at line 755 of file msgque_overload_mq.h.

◆ MqSlaveGet_e

#define MqSlaveGet_e ( ... )

Value:

MK_EMBEDDED(MQ_CTX,MqSlaveGet,__VA_ARGS__)

MqContextS

PUBLIC data structure for the tclmqmsgque-specific-data

Definition LibMqMsgque_mq.h:4110

Definition at line 757 of file msgque_overload_mq.h.

◆ MqSlaveGet_NULL

#define MqSlaveGet_NULL ( ... )

Value:

MqSlaveGet_RT(MK_RT_CALL_NULL __VA_ARGS__)

Definition at line 753 of file msgque_overload_mq.h.

◆ MqSlaveGetFilter

#define MqSlaveGetFilter ( ... )

Value:

MqSlaveGetFilter_RT(MK_RT_CALL __VA_ARGS__)

MqSlaveGetFilter_RT

enum MkErrorE MqSlaveGetFilter_RT(MK_RT mkrt, MQ_CTX const ctx, MQ_CTX *ctx_out)

get the filter-ctx or the master-ctx …

Definition at line 759 of file msgque_overload_mq.h.

◆ MqSlaveGetFilter_C

#define MqSlaveGetFilter_C ( ... )

Value:

if (MkErrorCheckI(MqSlaveGetFilter(__VA_ARGS__)))

MqSlaveGetFilter

#define MqSlaveGetFilter(...)

Definition msgque_overload_mq.h:759

Definition at line 761 of file msgque_overload_mq.h.

◆ MqSlaveGetFilter_E

#define MqSlaveGetFilter_E ( ... )

Value:

MkErrorCheck(MqSlaveGetFilter(__VA_ARGS__))

Definition at line 760 of file msgque_overload_mq.h.

◆ MqSlaveGetFilter_e

#define MqSlaveGetFilter_e ( ... )

Value:

MK_EMBEDDED(MQ_CTX,MqSlaveGetFilter,__VA_ARGS__)

Definition at line 762 of file msgque_overload_mq.h.

◆ MqSlaveGetFilter_NULL

#define MqSlaveGetFilter_NULL ( ... )

Value:

MqSlaveGetFilter_RT(MK_RT_CALL_NULL __VA_ARGS__)

Definition at line 758 of file msgque_overload_mq.h.

◆ MqSlaveGetProxy

#define MqSlaveGetProxy ( ... )

Value:

MqSlaveGetProxy_RT(MK_RT_CALL __VA_ARGS__)

MqSlaveGetProxy_RT

enum MkErrorE MqSlaveGetProxy_RT(MK_RT mkrt, MQ_CTX const ctx, MQ_SLAVE_ID const id, MQ_CTX *ctx_out)

on slave return the master and on master return the slave identified by id.

Definition at line 764 of file msgque_overload_mq.h.

◆ MqSlaveGetProxy_C

#define MqSlaveGetProxy_C ( ... )

Value:

if (MkErrorCheckI(MqSlaveGetProxy(__VA_ARGS__)))

MqSlaveGetProxy

#define MqSlaveGetProxy(...)

Definition msgque_overload_mq.h:764

Definition at line 766 of file msgque_overload_mq.h.

◆ MqSlaveGetProxy_E

#define MqSlaveGetProxy_E ( ... )

Value:

MkErrorCheck(MqSlaveGetProxy(__VA_ARGS__))

Definition at line 765 of file msgque_overload_mq.h.

◆ MqSlaveGetProxy_e

#define MqSlaveGetProxy_e ( ... )

Value:

MK_EMBEDDED(MQ_CTX,MqSlaveGetProxy,__VA_ARGS__)

Definition at line 767 of file msgque_overload_mq.h.

◆ MqSlaveGetProxy_NULL

#define MqSlaveGetProxy_NULL ( ... )

Value:

MqSlaveGetProxy_RT(MK_RT_CALL_NULL __VA_ARGS__)

Definition at line 763 of file msgque_overload_mq.h.

◆ MqSlaveWorker

#define MqSlaveWorker ( ... )

Value:

MqSlaveWorker_RT(MK_RT_CALL __VA_ARGS__)

MqSlaveWorker_RT

enum MkErrorE MqSlaveWorker_RT(MK_RT mkrt, MQ_CTX const ctx, MQ_SLAVE_ID const id, MK_STRN fct, MK_BAC args)

create a master/slave link using the image of the ctx object self. …

Definition at line 779 of file msgque_overload_mq.h.

◆ MqSlaveWorker_2

#define MqSlaveWorker_2	(		ctx,
			id )

Value:

MqSlaveWorker(ctx,id,"WORKER",NULL)

MqSlaveWorker

#define MqSlaveWorker(...)

Definition msgque_overload_mq.h:779

Definition at line 781 of file msgque_overload_mq.h.

◆ MqSlaveWorker_3

#define MqSlaveWorker_3	(	ctx,
		id,
		fct )

Value:

MqSlaveWorker(ctx,id,fct,NULL)

Definition at line 780 of file msgque_overload_mq.h.

◆ MqSlaveWorker_C

#define MqSlaveWorker_C ( ... )

Value:

if (MkErrorCheckI(MqSlaveWorker(__VA_ARGS__)))

Definition at line 783 of file msgque_overload_mq.h.

◆ MqSlaveWorker_E

#define MqSlaveWorker_E ( ... )

Value:

MkErrorCheck(MqSlaveWorker(__VA_ARGS__))

Definition at line 782 of file msgque_overload_mq.h.

◆ MqSlaveWorker_NULL

#define MqSlaveWorker_NULL ( ... )

Value:

MqSlaveWorker_RT(MK_RT_CALL_NULL __VA_ARGS__)

Definition at line 778 of file msgque_overload_mq.h.

Function Documentation

◆ MqSlaveCheck()

static bool MqSlaveCheck	(	MQ_CTXN const	ctx,
		MQ_SLAVE_ID const	id )

inlinestatic

check if slave-id is valid

Parameters

[in]	ctx	the master-context as PARENT or CHILD
[in]	id	the SlaveId to unique identify the master/slave link, the id < MQ_SLAVE_USER is internal.

Returns: boolean true = valid or false = invalid

Definition at line 7832 of file LibMqMsgque_mq.h.

{
  return ctx ? id >= 0 && id < ctx->link.slave.used && ctx->link.slave.slaves[id] != NULL : false;
} 

Here is the caller graph for this function:

◆ MqSlaveCheckP()

MK_BOOL MqSlaveCheckP	(	MQ_CTXN const	ctx,
		MQ_SLAVE_ID const	id )

Non-inline replacement for MqSlaveCheck …

◆ MqSlaveCreate_RT()

enum MkErrorE MqSlaveCreate_RT	(	MK_RT	mkrt,
		MQ_CTX const	ctx,
		MQ_SLAVE_ID const	id,
		MQ_CTX const	slave )

create a master/slave link between the master-parent-context and the slave-parent-context …

The slave-context have to be a sub-class of MqContextC and is owned by the master-context. Owned mean that no other external references should be used.
The slave-context will be deleted if the master-context is deleted and the slave-context will create a child-context if the master-context create a child context.

Example from server.tcl → without reflection-support ... the factory is required :

        set c [[MqFactoryC Get "client"] New]
        $c createParent [my ConfigGetStartAs]
        my SlaveCreate $id $c

Example from server.tcl → the factory is created at startup :

MqFactoryC Add Client "client"

With reflection-support ... just the instance-constructor is required to create an instance:

Language with reflection-support : Tcl, Python, Ruby, Perl, PHP, Java, C#, GO, VB.NET

Parameters

[in]	mkrt	the MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only)
[in]	ctx	the master context object as PARENT without a CHILD
[in]	id	the SlaveId to unique identify the master/slave link, the id < MQ_SLAVE_USER is internal.
[in]	slave	the slave context object as CLIENT-PARENT without a CHILD

Exceptions

MkExceptionC → The default-exception from the Programming-Language-Micro-Kernel (PLMK)

See also: MqSlaveGet

◆ MqSlaveDelete_RT()

enum MkErrorE MqSlaveDelete_RT	(	MK_RT	mkrt,
		MQ_CTX const	ctx,
		MQ_SLAVE_ID const	id )

Delete a slave object from a master/slave link identified by id. …

By default the slave-context object will be deleted if the master-context is deleted. Use this function to delete the parent-slave-context explicit and brake the master/slave link. If id is invalid nothing will happen. It is an error to delete a child-slave-context.

Parameters

[in]	mkrt	the MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only)
[in]	ctx	the master context object as PARENT without a CHILD
[in]	id	the SlaveId to unique identify the master/slave link, the id < MQ_SLAVE_USER is internal.

Exceptions

MkExceptionC → The default-exception from the Programming-Language-Micro-Kernel (PLMK)

Attention: it is still possible to delete a child-slave-context using MqLinkDelete but this will break the internal master/slave order.

◆ MqSlaveGet_RT()

enum MkErrorE MqSlaveGet_RT	(	MK_RT	mkrt,
		MQ_CTX const	ctx,
		MQ_SLAVE_ID const	id,
		MQ_CTX *	ctx_out )

get the slave-context from a master-context …

Parameters

[in]	mkrt	the MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only)
[in]	ctx	the master-context as PARENT or CHILD
[in]	id	the SlaveId to unique identify the master/slave link, the id < MQ_SLAVE_USER is internal.
[out]	ctx_out	the slave-context or `"MK_NULL"` on error

Exceptions

MkExceptionC → The default-exception from the Programming-Language-Micro-Kernel (PLMK)

Attention: an error is raised if id is not valid or ctx is not a master-context.

◆ MqSlaveGetFilter_RT()

enum MkErrorE MqSlaveGetFilter_RT	(	MK_RT	mkrt,
		MQ_CTX const	ctx,
		MQ_CTX *	ctx_out )

get the filter-ctx or the master-ctx …

The functions MqSlaveGetFilter, MqSlaveGetMaster and MqSlaveGetProxy have the same purpose. A filter-pipeline has two ctx, one on the left and one on the right. The left-ctx is linked with the master-ctx and the right-ctx is linked to the slave-ctx. This function return the ctx wanted or an error if NOT available. The search is done using the following order:

return ctx if ctx is the wanted ctx
return master-ctx or filter-ctx
return a "context not available" error

Parameters

[in]	mkrt	the MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only)
[in]	ctx	the MqContextS instance to work on
[out]	ctx_out	the ctx or `"MK_NULL"` on error

Exceptions

MkExceptionC → The default-exception from the Programming-Language-Micro-Kernel (PLMK)

◆ MqSlaveGetMaster()

static MQ_CTX MqSlaveGetMaster ( MQ_CTX const ctx )

inlinestatic

opposite function of MqSlaveGetFilter

Attention: if no master is available, a "MK_NULL" is returned

Definition at line 7896 of file LibMqMsgque_mq.h.

{
  return ctx ? (MQ_IS_MASTER(ctx) ? ctx : ctx->config.master) : NULL;
} 

Here is the caller graph for this function:

◆ MqSlaveGetMasterP()

MQ_CTX MqSlaveGetMasterP ( MQ_CTX const ctx )

Non-inline replacement for MqSlaveGetMaster …

◆ MqSlaveGetProxy_RT()

enum MkErrorE MqSlaveGetProxy_RT	(	MK_RT	mkrt,
		MQ_CTX const	ctx,
		MQ_SLAVE_ID const	id,
		MQ_CTX *	ctx_out )

on slave return the master and on master return the slave identified by id.

Parameters

[in]	mkrt	the MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only)
[in]	ctx	the master or slave-context as PARENT or CHILD
[in]	id	the SlaveId to unique identify the master/slave link, the id < MQ_SLAVE_USER is internal.
[out]	ctx_out	the other-context or `"MK_NULL"` on error

Exceptions

MkExceptionC → The default-exception from the Programming-Language-Micro-Kernel (PLMK)

Attention: an error is raised if id is not valid

◆ MqSlaveIs()

static bool MqSlaveIs ( MQ_CTXN const ctx )

inlinestatic

is the context a slave-context ? …

Parameters

[in] ctx the MqContextS instance to work on

Returns: a boolean value, true or false

Definition at line 7906 of file LibMqMsgque_mq.h.

{
  return ctx ? (ctx->config.master != NULL) : false;
} 

Here is the caller graph for this function:

◆ MqSlaveIsP()

MK_BOOL MqSlaveIsP ( MQ_CTXN const ctx )

Non-inline replacement for MqSlaveIs …

◆ MqSlaveWorker_RT()

enum MkErrorE MqSlaveWorker_RT	(	MK_RT	mkrt,
		MQ_CTX const	ctx,
		MQ_SLAVE_ID const	id,
		MK_STRN	fct,
		MK_BAC	args )

create a master/slave link using the image of the ctx object self. …

The slave-context is started as an independent process or thread based on the StartAs argument.

The start of a "worker" can be done at:

context-creation in the Factory or the class-constructor
link-creation in the MqServerSetupIF method
service-call in the client-service-request (starting worker one-the-fly)

Example from server.tcl → create a worker in a service-callback reading arguments from the service

# start worker with arguments from the service-call using the current executable

my SlaveWorker $id "WORKER" {*}[my ReadLIST] --name wk-cl-$id @ --name wk-sv-$id

Parameters

[in]	mkrt	the MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only)
[in]	ctx	the master context object as PARENT without a CHILD
[in]	id	the SlaveId to unique identify the master/slave link, the id < MQ_SLAVE_USER is internal.
[in]	fct	the MqFactoryS::originalIdent or `"MK_NULL"` or `'\0'` or `"WORKER"`. if ident is `"MK_NULL"` or `'\0'` or `WORKER` the factory of ctx will be used if ident is MqFactoryS::originalIdent the factory defined will be used
[in]	args	command-line arguments passed to the worker-client or the worker-server. all arguments prior the first @ token are added to the worker-client and the other arguments to the worker-server. example: `--debug 5 --name hello @ --name myserver`

Exceptions

MkExceptionC → The default-exception from the Programming-Language-Micro-Kernel (PLMK)

Attention

- A slave-worker can only be created in a parent-context.

The args MkBufferListC is comsumed by the MqSlaveWorker and is EPMTY afterwords.

Functions

MqContextC - MqContextC_SlaveApi_Slave_C_API - function

MqContextC - MqContextC_SlaveApi_Slave_C_API - overload

Detailed Description

Macro Definition Documentation

◆ MqSlaveCreate

◆ MqSlaveCreate_C

◆ MqSlaveCreate_E

◆ MqSlaveCreate_NULL

◆ MqSlaveDelete

◆ MqSlaveDelete_C

◆ MqSlaveDelete_E

◆ MqSlaveDelete_NULL

◆ MqSlaveGet

◆ MqSlaveGet_C

◆ MqSlaveGet_E

◆ MqSlaveGet_e

◆ MqSlaveGet_NULL

◆ MqSlaveGetFilter

◆ MqSlaveGetFilter_C

◆ MqSlaveGetFilter_E

◆ MqSlaveGetFilter_e

◆ MqSlaveGetFilter_NULL

◆ MqSlaveGetProxy

◆ MqSlaveGetProxy_C

◆ MqSlaveGetProxy_E

◆ MqSlaveGetProxy_e

◆ MqSlaveGetProxy_NULL

◆ MqSlaveWorker

◆ MqSlaveWorker_2

◆ MqSlaveWorker_3

◆ MqSlaveWorker_C

◆ MqSlaveWorker_E

◆ MqSlaveWorker_NULL

Function Documentation

◆ MqSlaveCheck()

◆ MqSlaveCheckP()

◆ MqSlaveCreate_RT()

◆ MqSlaveDelete_RT()

◆ MqSlaveGet_RT()

◆ MqSlaveGetFilter_RT()

◆ MqSlaveGetMaster()

◆ MqSlaveGetMasterP()

◆ MqSlaveGetProxy_RT()

◆ MqSlaveIs()

◆ MqSlaveIsP()

◆ MqSlaveWorker_RT()