#include <Services.h>

Inheritance diagram for esi::services::HostMem:

Collaboration diagram for esi::services::HostMem:

Classes
struct	HostMemRegion
	RAII memory region for host memory. More...

struct	Options
	Options for allocating host memory. More...

Public Member Functions
virtual	~HostMem ()=default

virtual std::string	getServiceSymbol () const override

virtual std::unique_ptr< HostMemRegion >	allocate (std::size_t size, Options opts) const =0
	Allocate a region of host memory in accelerator accessible address space. More...

virtual bool	mapMemory (void *ptr, std::size_t size, Options opts) const
	Try to make a region of host memory accessible to the accelerator. More...

virtual void	unmapMemory (void *ptr) const
	Unmap memory which was previously mapped with 'mapMemory'. More...

Public Member Functions inherited from esi::services::Service
virtual	~Service ()=default

virtual Service *	getChildService (AcceleratorConnection *conn, Service::Type service, AppIDPath id={}, std::string implName={}, ServiceImplDetails details={}, HWClientDetails clients={})
	Create a "child" service of this service. More...

virtual ServicePort *	getPort (AppIDPath id, const BundleType *type, const std::map< std::string, ChannelPort & > &, AcceleratorConnection &) const
	Get specialized port for this service to attach to the given appid path. More...

Additional Inherited Members
Public Types inherited from esi::services::Service
using	Type = const std::type_info &

Detailed Description

Definition at line 194 of file Services.h.

Constructor & Destructor Documentation

◆ ~HostMem()

virtual esi::services::HostMem::~HostMem ( )

virtualdefault

Member Function Documentation

◆ allocate()

virtual std::unique_ptr<HostMemRegion> esi::services::HostMem::allocate	(	std::size_t	size,
		Options	opts
	)		const

pure virtual

Allocate a region of host memory in accelerator accessible address space.

Implemented in TraceHostMem.

Referenced by PYBIND11_MODULE().

◆ getServiceSymbol()

std::string HostMem::getServiceSymbol ( ) const

overridevirtual

Implements esi::services::Service.

Definition at line 166 of file Services.cpp.

◆ mapMemory()

virtual bool esi::services::HostMem::mapMemory	(	void *	ptr,
		std::size_t	size,
		Options	opts
	)		const

inlinevirtual

Try to make a region of host memory accessible to the accelerator.

Returns 'false' on failure. It is optional for an accelerator backend to implement this, so client code needs to have a fallback for when this returns 'false'. On success, it is the client's responsibility to ensure that the memory eventually gets unmapped.

Reimplemented in TraceHostMem.

Definition at line 223 of file Services.h.

◆ unmapMemory()

virtual void esi::services::HostMem::unmapMemory ( void * ptr ) const

inlinevirtual

Unmap memory which was previously mapped with 'mapMemory'.

Undefined behavior when called with a pointer which was not previously mapped.

Reimplemented in TraceHostMem.

Definition at line 228 of file Services.h.

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

/home/runner/work/circt-www/circt-www/circt_src/lib/Dialect/ESI/runtime/cpp/include/esi/Services.h
/home/runner/work/circt-www/circt-www/circt_src/lib/Dialect/ESI/runtime/cpp/lib/Services.cpp

Classes

Public Member Functions

Additional Inherited Members