Thread Handler Multiprocessing (MP) Support

This group contains the implementation to support the Thread Handler in multiprocessing (MP) configurations. More...

Files
file	threadmp.h
	This header file provides the interfaces of the Thread Handler Multiprocessing (MP) Support.
file	threadmp.c
	This source file contains the implementation of _Thread_MP_Handler_initialization(), _Thread_MP_Allocate_proxy(), _Thread_MP_Find_proxy(), _Thread_MP_Free_proxy().

Macros
#define	_Thread_MP_Is_receive(_the_thread)    ((_the_thread) == _MPCI_Receive_server_tcb)

Functions
void	_Thread_MP_Handler_initialization (uint32_t maximum_proxies)
	Initialize MP thread handler.
Thread_Control *	_Thread_MP_Allocate_proxy (States_Control the_state)
	Allocates a MP proxy control block from the inactive chain of free proxy control blocks.
Thread_Control *	_Thread_MP_Find_proxy (Objects_Id the_id)
	Removes the MP proxy control block for the specified id from the active chain of proxy control blocks.
void	_Thread_MP_Extract_proxy (Thread_Control *the_thread)
	Extracts the proxy of the thread if necessary.
void	_Thread_MP_Free_proxy (Thread_Control *the_thread)
	Trees a proxy control block to the inactive chain of free proxy control blocks.

Detailed Description

This group contains the implementation to support the Thread Handler in multiprocessing (MP) configurations.

This handler encapsulates functionality which is related to managing threads in a multiprocessor system configuration. This handler must manage proxies which represent remote threads blocking on local operations.

Macro Definition Documentation

_Thread_MP_Is_receive

#define _Thread_MP_Is_receive

(

_the_thread

)

((_the_thread) == _MPCI_Receive_server_tcb)

This function returns true if the thread in question is the multiprocessing receive thread.

Note

This is a macro to avoid needing a prototype for _MPCI_Receive_server_tcb until it is used.

Function Documentation

_Thread_MP_Allocate_proxy()

Thread_Control * _Thread_MP_Allocate_proxy

(

States_Control

the_state

)

Allocates a MP proxy control block from the inactive chain of free proxy control blocks.

This allocates a proxy control block from the inactive chain of free proxy control blocks.

Note

This function returns a thread control pointer because proxies are substitutes for remote threads.

• Parameters

  the_state

  The state for the allocated MP proxy control block.

_Thread_MP_Extract_proxy()

void _Thread_MP_Extract_proxy

(

Thread_Control *

the_thread

)

Extracts the proxy of the thread if necessary.

This routine ensures that if there is a proxy for this thread on another node, it is also dealt with. A proxy is a data that is on the thread queue on the remote node and acts as a proxy for the local thread. If the local thread was waiting on a remote operation, then the remote side of the operation must be cleaned up.

Parameters

[in,out]

the_thread

is the thread to determine the proxy.

_Thread_MP_Find_proxy()

Thread_Control * _Thread_MP_Find_proxy

(

Objects_Id

the_id

)

Removes the MP proxy control block for the specified id from the active chain of proxy control blocks.

This function removes the proxy control block for the specified id from the active red-black tree of proxy control blocks.

Parameters

the_id

The id of the proxy control block to remove.

Returns

The removed proxy control block.

_Thread_MP_Handler_initialization()

void _Thread_MP_Handler_initialization

(

uint32_t

maximum_proxies

)

Initialize MP thread handler.

This routine initializes the multiprocessing portion of the Thread Handler.

Parameters

maximum_proxies

The maximum number of proxies for the MP thread handler.