Important Mutexes - Revision history

Monica at 11:46, 4 November 2013

2013-11-04T11:46:59Z

Dana: /* MessageDispatcher (hidden) */

2012-11-20T11:01:51Z

‎MessageDispatcher (hidden)

Dana: /* RefObject::refMutex() (singleton, public) */

2012-11-19T12:48:09Z

‎RefObject::refMutex() (singleton, public)

Dana: Created page with " In the code of Yate there are some noteworthy mutexes that have program-wide implications. === RefObject::refMutex() (singleton, public)=== This is '''the''' most important..."

2012-11-19T12:47:13Z

Created page with " In the code of Yate there are some noteworthy mutexes that have program-wide implications. === RefObject::refMutex() (singleton, public)=== This is '''the''' most important..."

New page

In the code of Yate there are some noteworthy mutexes that have program-wide implications.

=== RefObject::refMutex() (singleton, public)===

This is '''the''' most important mutex in Yate, it locks '''RefObject''' derived objects while their reference counter is modified. It is acquired and released billions of times in any Yate run. The code executed with this mutex acquired is strictly limited and the actual object destruction (when the reference counter dropped to zero) is performed with this mutex released.

=== DataEndpoint::commonMutex() (singleton, public)===

This mutex protects data endpoint while their source and consumers are connected or disconnected. This makes sure that operations changing the data sources or consumers of data endpoints occur atomically.

=== CallEndpoint::commonMutex() (singleton, public)===

Call endpoint connect and disconnect operations are protected by this mutex.

Please note that during the connect() or disconnect() methods usually there will be one or more calls that will need to acquire the '''DataEndpoint''' mutex.

=== Module (itself, public) ===

The module (and derived '''Driver''') class is derived from several classes including '''Mutex'''. Each module uses itself to perform atomic update operations.

=== DataSource::mutex() (public)===

Each DataSource has a mutex that is acquired while accessing its Consumer list.

=== DataTranslator (singleton, hidden)===

This mutex protects the list of translator factories while it's used or updated.

=== MessageDispatcher (hidden)===

The list holding the installed message handlers is protected against changes by this mutex while it's being iterated. Usually the only instance of dispatcher is the derived '''Engine''' singleton object.

'''See also'''

*[[Mutexes and locking]]
*[[Locking Issues]]

← Older revision		Revision as of 11:46, 4 November 2013
Line 37:		Line 37:
	*[[Mutexes and locking]]		*[[Mutexes and locking]]
	*[[Locking Issues]]		*[[Locking Issues]]
		+
		+	[[Category:Programmers]] [[Category:Mutexes]]

← Older revision		Revision as of 11:01, 20 November 2012
Line 31:		Line 31:

	The list holding the installed message handlers is protected against changes by this mutex while it's being iterated. Usually the only instance of dispatcher is the derived '''Engine''' singleton object.		The list holding the installed message handlers is protected against changes by this mutex while it's being iterated. Usually the only instance of dispatcher is the derived '''Engine''' singleton object.
		+

	'''See also'''		'''See also'''

@@ Line 4: / Line 4: @@
 === RefObject::refMutex() (singleton, public)===
-This is '''the''' most important mutex in Yate, it locks '''RefObject''' derived objects while their reference counter is modified. It is acquired and released billions of times in any Yate run. The code executed with this mutex acquired is strictly limited and the actual object destruction (when the reference counter dropped to zero) is performed with this mutex released.
+This is the most important mutex in Yate, it locks '''RefObject''' derived objects while their reference counter is modified. It is acquired and released billions of times in any Yate run. The code executed with this mutex acquired is strictly limited and the actual object destruction (when the reference counter dropped to zero) is performed with this mutex released.
 === DataEndpoint::commonMutex() (singleton, public)===