contur::SharedMemory Class Reference

Named shared-memory IPC channel. More...

#include <shared_memory.h>

Inheritance diagram for contur::SharedMemory:

Collaboration diagram for contur::SharedMemory:

Public Member Functions
	SharedMemory (std::string name, std::size_t bytes)
	Creates a named shared-memory region.
	~SharedMemory () override
	SharedMemory (const SharedMemory &)=delete
SharedMemory &	operator= (const SharedMemory &)=delete
	SharedMemory (SharedMemory &&) noexcept
SharedMemory &	operator= (SharedMemory &&) noexcept
Result< std::size_t >	write (std::span< const std::byte > data) override
	Writes bytes into the beginning of the shared region.
Result< std::size_t >	read (std::span< std::byte > buffer) override
	Reads bytes from the beginning of the shared region.
void	close () override
	Closes the region, clears attachments, and resets data.
bool	isOpen () const noexcept override
	Returns whether the region is open.
std::string_view	name () const noexcept override
	Region name.
Result< void >	attach (ProcessId pid)
	Attaches a process to this region.
Result< void >	detach (ProcessId pid)
	Detaches a process from this region.
bool	isAttached (ProcessId pid) const noexcept
	Returns true if process is attached.
std::size_t	attachedCount () const noexcept
	Number of attached processes.
std::size_t	size () const noexcept
	Region size in bytes.
Public Member Functions inherited from contur::IIpcChannel
virtual	~IIpcChannel ()=default

Private Attributes
std::unique_ptr< Impl >	impl_

Detailed Description

Named shared-memory IPC channel.

SharedMemory exposes a fixed-size byte region that can be attached by multiple processes. Attach/detach tracking is managed internally.

Definition at line 19 of file shared_memory.h.

Constructor & Destructor Documentation

SharedMemory() [1/3]

contur::SharedMemory::SharedMemory ( std::string name, std::size_t bytes )

explicit

Creates a named shared-memory region.

Parameters

name	Channel name.
bytes	Size of memory region in bytes.

~SharedMemory()

contur::SharedMemory::~SharedMemory ( )

override

SharedMemory() [2/3]

contur::SharedMemory::SharedMemory ( const SharedMemory & )

delete

SharedMemory() [3/3]

contur::SharedMemory::SharedMemory ( SharedMemory && )

noexcept

Member Function Documentation

attach()

Result< void > contur::SharedMemory::attach ( ProcessId pid )

nodiscard

Attaches a process to this region.

Parameters

pid	Process ID.

Returns

Ok on success, or InvalidPid/InvalidState.

attachedCount()

std::size_t contur::SharedMemory::attachedCount ( ) const

nodiscardnoexcept

Number of attached processes.

close()

void contur::SharedMemory::close ( )

overridevirtual

Closes the region, clears attachments, and resets data.

Implements contur::IIpcChannel.

detach()

Result< void > contur::SharedMemory::detach ( ProcessId pid )

nodiscard

Detaches a process from this region.

Parameters

pid	Process ID.

Returns

Ok on success, or InvalidPid/NotFound.

isAttached()

bool contur::SharedMemory::isAttached ( ProcessId pid ) const

nodiscardnoexcept

Returns true if process is attached.

isOpen()

bool contur::SharedMemory::isOpen ( ) const

nodiscardoverridevirtualnoexcept

Returns whether the region is open.

Implements contur::IIpcChannel.

name()

std::string_view contur::SharedMemory::name ( ) const

nodiscardoverridevirtualnoexcept

Region name.

Implements contur::IIpcChannel.

operator=() [1/2]

SharedMemory & contur::SharedMemory::operator= ( const SharedMemory & )

delete

operator=() [2/2]

SharedMemory & contur::SharedMemory::operator= ( SharedMemory && )

noexcept

read()

Result< std::size_t > contur::SharedMemory::read ( std::span< std::byte > buffer )

nodiscardoverridevirtual

Reads bytes from the beginning of the shared region.

Returns

Number of bytes read (can be partial), or error.

Implements contur::IIpcChannel.

size()

std::size_t contur::SharedMemory::size ( ) const

nodiscardnoexcept

Region size in bytes.

write()

Result< std::size_t > contur::SharedMemory::write ( std::span< const std::byte > data )

nodiscardoverridevirtual

Writes bytes into the beginning of the shared region.

Returns

Number of bytes written (can be partial), or error.

Implements contur::IIpcChannel.

Member Data Documentation

impl_

std::unique_ptr<Impl> contur::SharedMemory::impl_

private

Definition at line 71 of file shared_memory.h.

---

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

• include/contur/ipc/shared_memory.h