dxd::multichannel::stream< channel_t > Class Template Reference

generic kernel multichannel stream More...

#include <dxd_stream.h>

Inheritance diagram for dxd::multichannel::stream< channel_t >:

Collaboration diagram for dxd::multichannel::stream< channel_t >:

Classes
class	clock
class	in
	kernel stream mapped client reference counted in channel buffers More...
class	umap
	stream user mapping More...

Public Member Functions
os_result	attach (unsigned int iosize, channel_t **channel[2])
	attach user client owned out channels
os_result	attach (unsigned int iosize, const uint64_t *channel_map)
	create stream local in channels
void	detach (channel_t **channel[2])
void	detach (const uint64_t *channel_map)
template<typename return_t = os_result, typename exec_t >
return_t	each (exec_t exec)
void	free ()
	kernel map free
void	free ()
os_result	initialize (::IOMemoryDescriptor *iokit_memory_descriptor)
	IOKit memory initializer.
os_result	initialize (::IOMemoryDescriptor *iokit_memory_descriptor, size_t offset, size_t size)
	IOKit memory initializer.
os_result	initialize (::IOMemoryDescriptor *iokit_memory_descriptor, size_t offset=0)
	IOKit kernel map initializer.
os_result	initialize (const void *data, size_t size)
	IOKit memory initializer.
os_result	initialize (const::MDL *mdl)
os_result	initialize (const::MDL *mdl, size_t offset, size_t size)
os_result	initialize (size_t size, unsigned int limit=limit_t, unsigned int alignment=alignment_t, bool contigous=contigous_t)
	IOKit buffer initializer.
os_result	initialize (size_t size, unsigned int limit=limit_t, unsigned int alignment=alignment_t, bool contigous=contigous_t)
os_result	initialize (void *data, size_t size)
	IOKit memory initializer.
	operator const vm_t * () const
	operator const::IOMemoryDescriptor * () const
	IOKit IOMemoryDescriptor* implicit cast.
	operator const::IOMemoryMap * () const
	operator uint64_t () const
	IOKit physical address (only relevant for contigous memory)
	operator vm_t * () const
vm_t *	operator-> ()
const vm_t *	operator-> () const
	operator to use mapping like pointer
	operator::IOMemoryDescriptor * ()
	operator::IOMemoryMap * ()
	operator::MDL * () const
item_t *	pop ()
	pop item from head
item_t *	pop (item_t *item)
	pop item
list &	print ()
item_t *	push (item_t *item)
	push item to head
template<typename reference_t >
int	release (reference_t &reference)
void	retain ()
void	rx (int64_t timestamp)
os_result	signal ()
size_t	size () const
	IOKit memory size.
size_t	size () const
	kernel mapping size
virtual os_result	start (bool force=false)=0
virtual os_result	stop (bool force=false)=0
void	tx (int64_t timestamp)

Public Attributes
struct {
uint64_t   advance = 0
dxd::buffer< dx::user >   buffer {sizeof(dx::stream::channel::control)}
bool   in
unsigned int   iosize = 0
dxd::map< dx::kernel, dx::stream::channel::control >   map {buffer}
}	control
atomic< int >	references {}
os_result	status =not_initialized
	IOKit memory status.
os_result	status =not_initialized
	status of mapping object

Protected Member Functions
void	__lock ()
void	__lock ()
bool	__trylock ()
void	__unlock ()
void	__unlock ()
	operator const::KSPIN_LOCK & () const
	operator const::KSPIN_LOCK * () const
	operator::KSPIN_LOCK & ()
	operator::KSPIN_LOCK * ()
	~stream ()

Protected Attributes
vm_t *	_vm =nullptr
	kernel virtual address mapping
union {
channel_t **   in [2]
	in channel array [switch] [channels] More...
channel_t *const *const *volatile   out [2]
	client out channel array [switch] [client] -> umap out channels [channels] More...
}	cache
unsigned int	channels = 0
	stream channels
dxd::multichannel::stream::in *	in [2]
::IOMemoryMap *	iokit_memory_map =nullptr
atomic< int >	out = 0
	client outs atached
os_result	status =not_initialized

Detailed Description

template<typename channel_t = int>
class dxd::multichannel::stream< channel_t >

generic kernel multichannel stream

Constructor & Destructor Documentation

~stream()

template<typename channel_t = int>

dxd::multichannel::stream< channel_t >::~stream ( )

inlineprotectedvirtual

Reimplemented from dxd::stream.

Member Function Documentation

__lock() [1/2]

void dxd::spinlock::__lock ( )

inlineprotectedinherited

__lock() [2/2]

void dxd::spinlock::__lock ( )

inlineprotectedinherited

__trylock()

bool dxd::spinlock::__trylock ( )

inlineprotectedinherited

__unlock() [1/2]

void dxd::spinlock::__unlock ( )

inlineprotectedinherited

__unlock() [2/2]

void dxd::spinlock::__unlock ( )

inlineprotectedinherited

attach() [1/2]

template<typename channel_t = int>

os_result dxd::multichannel::stream< channel_t >::attach ( unsigned int iosize, channel_t ** channel[2] )

inline

attach user client owned out channels

attach() [2/2]

template<typename channel_t = int>

os_result dxd::multichannel::stream< channel_t >::attach ( unsigned int iosize, const uint64_t * channel_map )

inline

create stream local in channels

Here is the caller graph for this function:

detach() [1/2]

template<typename channel_t = int>

void dxd::multichannel::stream< channel_t >::detach ( channel_t ** channel[2] )

inline

detach() [2/2]

template<typename channel_t = int>

void dxd::multichannel::stream< channel_t >::detach ( const uint64_t * channel_map )

inline

Here is the caller graph for this function:

each()

template<typename item_t = link>

template<typename return_t = os_result, typename exec_t >

return_t dxd::linked::list< item_t >::each ( exec_t exec )

inlineinherited

free() [1/2]

template<dx::scope scope_t = dx::kernel, typename vm_t = unsigned int>

void dxd::map< scope_t, vm_t >::free ( )

inlineinherited

kernel map free

Checks if kernel mapping already exists and

does not call unmap(): IOMemoryMap instances will unmap themselves upon free, ie. when the last client with a reference calls release. unmap() forces the IOMemoryMap to destroy the mapping it represents, regardless of the number of clients. releases the map object.

free() [2/2]

template<dx::scope scope_t = dx::kernel, unsigned int limit_t = 64, unsigned int alignment_t = 0, bool contigous_t = false>

void dxd::buffer< scope_t, limit_t, alignment_t, contigous_t >::free ( )

inlineinherited

initialize() [1/9]

template<dx::scope scope_t = dx::kernel>

os_result dxd::memory< scope_t >::initialize ( ::IOMemoryDescriptor * iokit_memory_descriptor )

inlineinherited

IOKit memory initializer.

Here is the call graph for this function:

initialize() [2/9]

template<dx::scope scope_t = dx::kernel>

os_result dxd::memory< scope_t >::initialize ( ::IOMemoryDescriptor * iokit_memory_descriptor, size_t offset, size_t size )

inlineinherited

IOKit memory initializer.

Here is the call graph for this function:

initialize() [3/9]

template<dx::scope scope_t = dx::kernel, typename vm_t = unsigned int>

os_result dxd::map< scope_t, vm_t >::initialize ( ::IOMemoryDescriptor * iokit_memory_descriptor, size_t offset = 0 )

inlineinherited

IOKit kernel map initializer.

map<kernel> maps an IOMemoryDescriptor (typically cast of a dxd::memory or buffer class) into the kernel address space.

https://developer.apple.com/library/content/qa/qa1197/_index.html

Allows re-initialization.

Checks buffer object,

maps the buffer into the kernel (will fail if offset is given)

and obtains a kernel virtual address (apply offset here instead).

Parameters

iokit_memory_descriptor	IOMemoryDescriptor to be mapped into the kernel address space
offset	offset into memory descriptor to create mapping

Here is the call graph for this function:

initialize() [4/9]

template<dx::scope scope_t = dx::kernel>

os_result dxd::memory< scope_t >::initialize ( const void * data, size_t size )

inherited

IOKit memory initializer.

Parameters

data	virtual base address of range to create memory descriptor from
size	size of range to create memory descriptor from

initialize() [5/9]

template<dx::scope scope_t = dx::kernel>

os_result dxd::memory< scope_t >::initialize ( const::MDL * mdl )

inlineinherited

in contrast to an IOKit MemoryDescriptor MDLs do not support reference counting. take care when creating a dxd::memory from a dxd::buffer: although the dxd::memory holds an MDL to the buffer the buffer itself is not retained after the dxd::buffer is released!

Here is the call graph for this function:

initialize() [6/9]

template<dx::scope scope_t = dx::kernel>

os_result dxd::memory< scope_t >::initialize ( const::MDL * mdl, size_t offset, size_t size )

inlineinherited

Here is the call graph for this function:

initialize() [7/9]

template<dx::scope scope_t = dx::kernel, unsigned int limit_t = 64, unsigned int alignment_t = 0, bool contigous_t = false>

os_result dxd::buffer< scope_t, limit_t, alignment_t, contigous_t >::initialize ( size_t size, unsigned int limit = limit_t, unsigned int alignment = alignment_t, bool contigous = contigous_t )

inlineinherited

IOKit buffer initializer.

Allows re-initialization.

Creates a buffer and associated memory descriptor.

Wires down the backing store memory.

Parameters

size	size to be alloced by buffer object
limit	limit physical memory address space
alignment	enforce physical memory alignment
contigous	enforce contiguos physical memory

Here is the call graph for this function:

initialize() [8/9]

template<dx::scope scope_t = dx::kernel, unsigned int limit_t = 64, unsigned int alignment_t = 0, bool contigous_t = false>

os_result dxd::buffer< scope_t, limit_t, alignment_t, contigous_t >::initialize ( size_t size, unsigned int limit = limit_t, unsigned int alignment = alignment_t, bool contigous = contigous_t )

inlineinherited

Allows re-initialization

Parameters

size	size to be alloced by buffer object
limit	limit physical memory address space
alignment	enforce physical memory alignment
contigous	enforce contiguos physical memory

Here is the call graph for this function:

initialize() [9/9]

template<dx::scope scope_t = dx::kernel>

os_result dxd::memory< scope_t >::initialize ( void * data, size_t size )

inherited

IOKit memory initializer.

Parameters

data	virtual base address of range to create memory descriptor from
size	size of range to create memory descriptor from

operator const vm_t *()

template<dx::scope scope_t = dx::kernel, typename vm_t = unsigned int>

dxd::map< scope_t, vm_t >::operator const vm_t * ( ) const

inlineinherited

operator const::IOMemoryDescriptor *()

template<dx::scope scope_t = dx::kernel>

dxd::memory< scope_t >::operator const::IOMemoryDescriptor * ( ) const

inlineinherited

IOKit IOMemoryDescriptor* implicit cast.

operator const::IOMemoryMap *()

template<dx::scope scope_t = dx::kernel, typename vm_t = unsigned int>

dxd::map< scope_t, vm_t >::operator const::IOMemoryMap * ( ) const

inlineinherited

operator const::KSPIN_LOCK &()

dxd::spinlock::operator const::KSPIN_LOCK & ( ) const

inlineinherited

operator const::KSPIN_LOCK *()

dxd::spinlock::operator const::KSPIN_LOCK * ( ) const

inlineinherited

operator uint64_t()

template<dx::scope scope_t = dx::kernel>

dxd::memory< scope_t >::operator uint64_t ( ) const

inlineinherited

IOKit physical address (only relevant for contigous memory)

operator vm_t *()

template<dx::scope scope_t = dx::kernel, typename vm_t = unsigned int>

dxd::map< scope_t, vm_t >::operator vm_t * ( ) const

inlineinherited

operator->() [1/2]

template<dx::scope scope_t = dx::kernel, typename vm_t = unsigned int>

vm_t * dxd::map< scope_t, vm_t >::operator-> ( )

inlineinherited

operator->() [2/2]

template<dx::scope scope_t = dx::kernel, typename vm_t = unsigned int>

const vm_t * dxd::map< scope_t, vm_t >::operator-> ( ) const

inlineinherited

operator to use mapping like pointer

operator::IOMemoryDescriptor *()

template<dx::scope scope_t = dx::kernel>

dxd::memory< scope_t >::operator::IOMemoryDescriptor * ( )

inlineinherited

operator::IOMemoryMap *()

template<dx::scope scope_t = dx::kernel, typename vm_t = unsigned int>

dxd::map< scope_t, vm_t >::operator::IOMemoryMap * ( )

inlineinherited

operator::KSPIN_LOCK &()

dxd::spinlock::operator::KSPIN_LOCK & ( )

inlineinherited

operator::KSPIN_LOCK *()

dxd::spinlock::operator::KSPIN_LOCK * ( )

inlineinherited

operator::MDL *()

template<dx::scope scope_t = dx::kernel>

dxd::memory< scope_t >::operator::MDL * ( ) const

inlineinherited

pop() [1/2]

template<typename item_t = link>

item_t * dxd::linked::list< item_t >::pop ( )

inlineinherited

pop item from head

Here is the caller graph for this function:

pop() [2/2]

template<typename item_t >

item_t * dxd::doubly::linked::list< item_t >::pop ( item_t * item )

inlineinherited

pop item

Here is the caller graph for this function:

print()

template<typename item_t >

list & dxd::doubly::linked::list< item_t >::print ( )

inlineinherited

Here is the call graph for this function:

push()

template<typename item_t >

item_t * dxd::doubly::linked::list< item_t >::push ( item_t * item )

inlineinherited

push item to head

Here is the caller graph for this function:

release()

template<typename reference_t >

int dxd::referenced::release ( reference_t & reference )

inlineinherited

retain()

void dxd::referenced::retain ( )

inlineinherited

Here is the caller graph for this function:

rx()

template<typename channel_t = int>

void dxd::multichannel::stream< channel_t >::rx ( int64_t timestamp )

inline

Here is the call graph for this function:

signal()

os_result dxd::broadcast::signal ( )

inlineinherited

Here is the call graph for this function:

size() [1/2]

template<dx::scope scope_t = dx::kernel>

size_t dxd::memory< scope_t >::size ( ) const

inlineinherited

IOKit memory size.

size() [2/2]

template<dx::scope scope_t = dx::kernel, typename vm_t = unsigned int>

size_t dxd::map< scope_t, vm_t >::size ( ) const

inlineinherited

kernel mapping size

start()

virtual os_result dxd::stream::start ( bool force = false )

pure virtualinherited

Implemented in dxd::usb_stream_device::stream.

Here is the caller graph for this function:

stop()

virtual os_result dxd::stream::stop ( bool force = false )

pure virtualinherited

Implemented in dxd::usb_stream_device::stream.

Here is the caller graph for this function:

tx()

template<typename channel_t = int>

void dxd::multichannel::stream< channel_t >::tx ( int64_t timestamp )

inline

Here is the call graph for this function:

Member Data Documentation

_vm

template<dx::scope scope_t = dx::kernel, typename vm_t = unsigned int>

vm_t* dxd::map< scope_t, vm_t >::_vm =nullptr

protectedinherited

kernel virtual address mapping

advance

template<typename channel_t = int>

uint64_t dxd::multichannel::stream< channel_t >::advance = 0

buffer

template<typename channel_t = int>

dxd::buffer<dx::user> dxd::multichannel::stream< channel_t >::buffer {sizeof(dx::stream::channel::control)}

[union]

union { ... } dxd::multichannel::stream< channel_t >::cache

channels

template<typename channel_t = int>

unsigned int dxd::multichannel::stream< channel_t >::channels = 0

protected

stream channels

[struct]

struct { ... } dxd::multichannel::stream< channel_t >::control

in [1/3]

template<typename channel_t = int>

dxd::multichannel::stream::in* dxd::multichannel::stream< channel_t >::in[2]

protected

in [2/3]

template<typename channel_t = int>

channel_t** dxd::multichannel::stream< channel_t >::in[2]

in channel array [switch] [channels]

in [3/3]

template<typename channel_t = int>

bool dxd::multichannel::stream< channel_t >::in

iokit_memory_map

template<dx::scope scope_t = dx::kernel, typename vm_t = unsigned int>

::IOMemoryMap* dxd::map< scope_t, vm_t >::iokit_memory_map =nullptr

protectedinherited

iosize

template<typename channel_t = int>

unsigned int dxd::multichannel::stream< channel_t >::iosize = 0

map

template<typename channel_t = int>

dxd::map<dx::kernel, dx::stream::channel::control> dxd::multichannel::stream< channel_t >::map {buffer}

out [1/2]

template<typename channel_t = int>

atomic<int> dxd::multichannel::stream< channel_t >::out = 0

protected

client outs atached

out [2/2]

template<typename channel_t = int>

channel_t* const* const* volatile dxd::multichannel::stream< channel_t >::out[2]

client out channel array [switch] [client] -> umap out channels [channels]

references

atomic<int> dxd::referenced::references {}

inherited

status [1/3]

template<dx::scope scope_t = dx::kernel>

os_result memory::status =not_initialized

inherited

IOKit memory status.

status of memory object

status [2/3]

template<dx::scope scope_t = dx::kernel, typename vm_t = unsigned int>

os_result dxd::map< scope_t, vm_t >::status =not_initialized

inherited

status of mapping object

status [3/3]

os_result dxd::spinlock::status =not_initialized

inherited

---

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

• dxd_stream.h