contur::IKernel Class Reference

Top-level kernel facade. More...

#include <i_kernel.h>

Inheritance diagram for contur::IKernel:

Public Member Functions
virtual	~IKernel ()=default
	Virtual destructor for interface-safe polymorphic cleanup.
virtual Result< ProcessId >	createProcess (const ProcessConfig &config)=0
	Creates and admits a process.
virtual Result< void >	terminateProcess (ProcessId pid)=0
	Terminates a process immediately.
virtual Result< void >	tick (std::size_t tickBudget=0)=0
	Executes one dispatch cycle.
virtual Result< void >	runForTicks (std::size_t cycles, std::size_t tickBudget=0)=0
	Executes multiple dispatch cycles.
virtual Result< RegisterValue >	syscall (ProcessId pid, SyscallId id, std::span< const RegisterValue > args)=0
	Dispatches a syscall on behalf of a process.
virtual Result< void >	registerSyscallHandler (SyscallId id, SyscallHandlerFn handler)=0
	Registers or replaces syscall handler.
virtual Result< void >	registerSyncPrimitive (const std::string &name, std::unique_ptr< ISyncPrimitive > primitive)=0
	Registers a named synchronization primitive.
virtual Result< void >	enterCritical (ProcessId pid, std::string_view primitiveName)=0
	Acquires a named synchronization primitive.
virtual Result< void >	leaveCritical (ProcessId pid, std::string_view primitiveName)=0
	Releases a named synchronization primitive.
virtual KernelSnapshot	snapshot () const =0
	Returns a snapshot of current kernel state.
virtual Tick	now () const noexcept=0
	Returns current simulation time.
virtual bool	hasProcess (ProcessId pid) const noexcept=0
	Returns true when process exists in dispatcher.
virtual std::size_t	processCount () const noexcept=0
	Returns total managed process count.

Detailed Description

Top-level kernel facade.

Definition at line 144 of file i_kernel.h.

Constructor & Destructor Documentation

~IKernel()

virtual contur::IKernel::~IKernel ( )

virtualdefault

Virtual destructor for interface-safe polymorphic cleanup.

Member Function Documentation

createProcess()

virtual Result< ProcessId > contur::IKernel::createProcess ( const ProcessConfig & config )

nodiscardpure virtual

Creates and admits a process.

Parameters

config

Process configuration payload.

Returns

Created process ID or error.

Implemented in contur::Kernel.

Referenced by spawnDemoProcesses().

enterCritical()

virtual Result< void > contur::IKernel::enterCritical ( ProcessId pid, std::string_view primitiveName )

nodiscardpure virtual

Acquires a named synchronization primitive.

Implemented in contur::Kernel.

hasProcess()

virtual bool contur::IKernel::hasProcess ( ProcessId pid ) const

nodiscardpure virtualnoexcept

Returns true when process exists in dispatcher.

Implemented in contur::Kernel.

References hasProcess().

Referenced by hasProcess().

leaveCritical()

virtual Result< void > contur::IKernel::leaveCritical ( ProcessId pid, std::string_view primitiveName )

nodiscardpure virtual

Releases a named synchronization primitive.

Implemented in contur::Kernel.

now()

virtual Tick contur::IKernel::now ( ) const

nodiscardpure virtualnoexcept

Returns current simulation time.

Implemented in contur::Kernel.

processCount()

virtual std::size_t contur::IKernel::processCount ( ) const

nodiscardpure virtualnoexcept

Returns total managed process count.

Implemented in contur::Kernel.

References processCount().

Referenced by processCount().

registerSyncPrimitive()

virtual Result< void > contur::IKernel::registerSyncPrimitive ( const std::string & name, std::unique_ptr< ISyncPrimitive > primitive )

nodiscardpure virtual

Registers a named synchronization primitive.

Parameters

name	Primitive name.
primitive	Primitive instance.

Returns

Ok on success or AlreadyExists/InvalidArgument.

Implemented in contur::Kernel.

registerSyscallHandler()

virtual Result< void > contur::IKernel::registerSyscallHandler ( SyscallId id, SyscallHandlerFn handler )

nodiscardpure virtual

Registers or replaces syscall handler.

Parameters

id	Syscall identifier.
handler	Handler function.

Returns

Ok on success or InvalidArgument.

Implemented in contur::Kernel.

runForTicks()

virtual Result< void > contur::IKernel::runForTicks ( std::size_t cycles, std::size_t tickBudget = 0 )

nodiscardpure virtual

Executes multiple dispatch cycles.

Parameters

cycles	Number of cycles to run.
tickBudget	Optional budget per cycle. 0 means kernel default.

Returns

Ok on success or the first non-recoverable error.

Implemented in contur::Kernel.

snapshot()

virtual KernelSnapshot contur::IKernel::snapshot ( ) const

nodiscardpure virtual

Returns a snapshot of current kernel state.

Implemented in contur::Kernel.

syscall()

virtual Result< RegisterValue > contur::IKernel::syscall ( ProcessId pid, SyscallId id, std::span< const RegisterValue > args )

nodiscardpure virtual

Dispatches a syscall on behalf of a process.

Parameters

pid	Calling process identifier.
id	Syscall identifier.
args	Syscall arguments.

Returns

Register-compatible syscall return value.

Implemented in contur::Kernel.

terminateProcess()

virtual Result< void > contur::IKernel::terminateProcess ( ProcessId pid )

nodiscardpure virtual

Terminates a process immediately.

Parameters

pid	Process identifier.

Returns

Ok on success or error if process is unknown.

Implemented in contur::Kernel.

tick()

virtual Result< void > contur::IKernel::tick ( std::size_t tickBudget = 0 )

nodiscardpure virtual

Executes one dispatch cycle.

Parameters

tickBudget

Optional tick budget. 0 means kernel default.

Returns

Ok on success or error.

Implemented in contur::Kernel.

---

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

• include/contur/kernel/i_kernel.h