esi::services::HostMem Class Reference

#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 void	start ()
	In cases where necessary, enable host memory services.
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.
virtual bool	mapMemory (void *ptr, std::size_t size, Options opts) const
	Try to make a region of host memory accessible to the accelerator.
virtual void	unmapMemory (void *ptr) const
	Unmap memory which was previously mapped with 'mapMemory'.
	Service (AcceleratorConnection &conn)
Public Member Functions inherited from esi::services::Service
	Service (AcceleratorConnection &conn)
virtual	~Service ()=default
virtual Service *	getChildService (Service::Type service, AppIDPath id={}, std::string implName={}, ServiceImplDetails details={}, HWClientDetails clients={})
	Create a "child" service of this service.
virtual BundlePort *	getPort (AppIDPath id, const BundleType *type) const
	Get specialized port for this service to attach to the given appid path.
AcceleratorConnection &	getConnection () const

Static Public Attributes
static constexpr std::string_view	StdName = "esi.service.std.hostmem"

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

Detailed Description

Definition at line 210 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 173 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 255 of file Services.h.

Referenced by PYBIND11_MODULE().

Service()

esi::services::Service::Service ( AcceleratorConnection &  conn )

inline

Definition at line 60 of file Services.h.

start()

virtual void esi::services::HostMem::start ( )

inlinevirtual

In cases where necessary, enable host memory services.

Definition at line 244 of file Services.h.

Referenced by aggregateHostmemBandwidthTest(), hostmemBandwidthTest(), and hostmemTest().

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 260 of file Services.h.

Referenced by PYBIND11_MODULE().

Member Data Documentation

StdName

constexpr std::string_view esi::services::HostMem::StdName = "esi.service.std.hostmem"

staticconstexpr

Definition at line 212 of file Services.h.

Referenced by esi::services::ServiceRegistry::lookupServiceType().

---

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