dx::proxy::promoted< device_t, value_t > Class Template Reference

a value its driver serves as an IOCTL, mirrored: asked on its first access, a wish sent and the driver's answer committed - the driver is the authority -, and read back on every change the driver signals (the device's broadcast) - a kernel driver's through its proxy device, a service's through its connection (dx::service::connection) More...

#include <dx_proxy_promoted.h>

Inheritance diagram for dx::proxy::promoted< device_t, value_t >:

Collaboration diagram for dx::proxy::promoted< device_t, value_t >:

Public Types
typedef std::unique_lock<mutex_t>	lock_t
typedef std::mutex	mutex_t
typedef value_t	value_t

Public Member Functions
void	commit(lock_t&& lock, const value_t& value)
	the server's answer: the value stands, the transition ends and the listeners are told - outside the lock, so a listener may read the promoted back
	operator const value_t&()
promoted&	operator ++() noexcept
value_t	operator ++(int) noexcept
promoted&	operator +=(const value_t& value) noexcept
promoted&	operator --() noexcept
value_t	operator --(int) noexcept
promoted&	operator -=(const value_t& value) noexcept
const value_t&	operator ->()
bool	operator ==(const value_t& value)
bool	operator ==(promoted& promoted) noexcept
	promoted(device_t& device, uint32_t ioctl)

Public Attributes
bool	initialized
listen<std::function<void(const value_t &)>>	listen
std::function<void(lock_t &&, const value_t &, const value_t &)>	server
	\ indicate the value is in transition - does not have the new value yet
bool	transient
	\ indicate the value has been initialized

Protected Attributes
value_t	value

Detailed Description

template<typename device_t, typename value_t>
class dx::proxy::promoted< device_t, value_t >

a value its driver serves as an IOCTL, mirrored: asked on its first access, a wish sent and the driver's answer committed - the driver is the authority -, and read back on every change the driver signals (the device's broadcast) - a kernel driver's through its proxy device, a service's through its connection (dx::service::connection)

Member Typedef Documentation

lock_t

typedef std::unique_lock<mutex_t> dx::promoted<value_t>::lock_t

inherited

mutex_t

typedef std::mutex dx::promoted<value_t>::mutex_t

inherited

value_t

typedef value_t dx::promoted<value_t>::value_t

inherited

Constructor & Destructor Documentation

promoted()

template<typename device_t, typename value_t>

dx::proxy::promoted<device_t, value_t>::promoted(device_t& device, uint32_t ioctl)

inline

Here is the call graph for this function:

Member Function Documentation

commit()

void dx::promoted<value_t>::commit(lock_t&& lock, const value_t& value)

inlineinherited

the server's answer: the value stands, the transition ends and the listeners are told - outside the lock, so a listener may read the promoted back

Here is the caller graph for this function:

operator const value_t &()

dx::promoted<value_t>::operator const value_t&()

inlineinherited

operator ++() [1/2]

promoted& dx::promoted<value_t>::operator ++()

inlinenoexceptinherited

Here is the call graph for this function:

operator ++() [2/2]

value_t dx::promoted<value_t>::operator ++(int)

inlinenoexceptinherited

Here is the call graph for this function:

operator +=()

promoted& dx::promoted<value_t>::operator +=(const value_t& value)

inlinenoexceptinherited

Here is the call graph for this function:

operator --() [1/2]

promoted& dx::promoted<value_t>::operator --()

inlinenoexceptinherited

Here is the call graph for this function:

operator --() [2/2]

value_t dx::promoted<value_t>::operator --(int)

inlinenoexceptinherited

Here is the call graph for this function:

operator -=()

promoted& dx::promoted<value_t>::operator -=(const value_t& value)

inlinenoexceptinherited

Here is the call graph for this function:

operator ->()

const value_t& dx::promoted<value_t>::operator ->()

inlineinherited

operator ==() [1/2]

bool dx::promoted<value_t>::operator ==(const value_t& value)

inlineinherited

operator ==() [2/2]

bool dx::promoted<value_t>::operator ==(promoted<value_t>& promoted)

inlinenoexceptinherited

Here is the call graph for this function:

Member Data Documentation

initialized

bool dx::promoted<value_t>::initialized

inherited

listen

listen<std::function<void(const value_t&)>> dx::promoted<value_t>::listen

inherited

server

std::function<void(lock_t&&, const value_t&, const value_t&)> dx::promoted<value_t>::server

inherited

\ indicate the value is in transition - does not have the new value yet

server: handle synchronous and asynchronous value updates and initialization lock: lock promoted value from access during update value: new value (if in transition) current: current value to allow discarding update and reverting to current value if update is not permitted

it needs to handle these case: not initialized and not in transition: initialze and commit the value not initialized and in transition: if dependent on external settings initialize a temporary and compare it with the new value and update the external setting if required make sure to commit the new value so listeners get notified either synchronously or asynchronously by external notification initialized and in transition: update external settings if any and make sure to commit the new value so listeners get notified either synchronously or asynchronousl by external notification

server will not be called with this state: initialized and not in transation

for synchronous operation: move lock to commit for asynchronous operation: store lock and at asynchronous response restore and move lock to commit

transient

bool dx::promoted<value_t>::transient

inherited

\ indicate the value has been initialized

value

value_t dx::promoted<value_t>::value

protectedinherited

---

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

• dx_proxy_promoted.h