Intel(R) Threading Building Blocks Doxygen Documentation
version 4.2.3
|
Go to the documentation of this file.
37 __TBB_ASSERT( v,
"thread did not activate a task_scheduler_init object?" );
38 #if __TBB_TASK_GROUP_CONTEXT
49 __TBB_ASSERT( v,
"thread does not have initialized task_scheduler_init object?" );
50 #if __TBB_TASK_GROUP_CONTEXT
56 #if __TBB_TASK_GROUP_CONTEXT
71 if (
s->master_outermost_level() )
87 __TBB_ASSERT( v,
"thread does not have initialized task_scheduler_init object?" );
107 ((
task*)
this)->prefix().parent = mytask.
parent();
150 const size_t X_FACTOR = 4;
186 __TBB_ASSERT(
p.ref_count==1 &&
p.state==allocated &&
self().parent()==
this
195 __TBB_ASSERT( k>=1,
"task's reference count underflowed" );
197 ITT_NOTIFY( sync_acquired, &prefix().ref_count );
222 "attempt to destroy child of running or corrupted parent?" );
225 parent->internal_decrement_ref_count();
239 s->local_wait_for_all( *
this, t );
248 #if __TBB_TASK_GROUP_CONTEXT
250 prefix().context = &ctx;
256 if (
s->master_outermost_level() )
task * parent() const
task on whose behalf this task is working, or NULL if this is a root.
virtual ~task()
Destructor.
tbb::task * next
"next" field for list of task
__itt_caller itt_caller
Used to set and maintain stack stitching point for Intel Performance Tools.
task_group_context * context
Shared context that is used to communicate asynchronous state changes.
void spawn_and_wait_for_all(task &child)
Similar to spawn followed by wait_for_all, but more efficient.
internal::affinity_id affinity_id
An id as used for specifying affinity.
Used to form groups of tasks.
task_group_context & my_context
#define __TBB_ASSERT(predicate, comment)
No-op version of __TBB_ASSERT.
void const char const char int ITT_FORMAT __itt_group_sync x void const char ITT_FORMAT __itt_group_sync s void ITT_FORMAT __itt_group_sync p void ITT_FORMAT p void ITT_FORMAT p no args __itt_suppress_mode_t unsigned int void size_t ITT_FORMAT d void ITT_FORMAT p void ITT_FORMAT p __itt_model_site __itt_model_site_instance ITT_FORMAT p __itt_model_task __itt_model_task_instance ITT_FORMAT p void ITT_FORMAT p void ITT_FORMAT p void size_t ITT_FORMAT d void ITT_FORMAT p const wchar_t ITT_FORMAT s const char ITT_FORMAT s const char ITT_FORMAT s const char ITT_FORMAT s no args void ITT_FORMAT p size_t count
#define ITT_NOTIFY(name, obj)
virtual void __TBB_EXPORTED_METHOD note_affinity(affinity_id id)
Invoked by scheduler to notify task that it ran on unexpected thread.
size_t my_size
Number of elements in my_array.
void increment_ref_count()
Atomically increment reference count.
void assert_task_pool_valid() const
void __TBB_EXPORTED_METHOD internal_set_ref_count(int count)
Set reference count.
Base class for user-defined tasks.
static void __TBB_EXPORTED_FUNC destroy(task &victim)
Destroy a task.
Work stealing task scheduler.
task &__TBB_EXPORTED_METHOD allocate(size_t size) const
__TBB_atomic kind_type my_kind
Flavor of this context: bound or isolated.
static task &__TBB_EXPORTED_FUNC self()
The innermost task being executed or destroyed by the current thread at the moment.
static generic_scheduler * local_scheduler_weak()
void const char const char int ITT_FORMAT __itt_group_sync x void const char ITT_FORMAT __itt_group_sync s void ITT_FORMAT __itt_group_sync p void ITT_FORMAT p void ITT_FORMAT p no args __itt_suppress_mode_t unsigned int void size_t size
internal::task_prefix & prefix(internal::version_tag *=NULL) const
Get reference to corresponding task_prefix.
void __TBB_EXPORTED_METHOD free(task &) const
void const char const char int ITT_FORMAT __itt_group_sync x void const char ITT_FORMAT __itt_group_sync s void ITT_FORMAT __itt_group_sync p void ITT_FORMAT p void ITT_FORMAT p no args __itt_suppress_mode_t unsigned int void size_t ITT_FORMAT d void ITT_FORMAT p void ITT_FORMAT p __itt_model_site __itt_model_site_instance ITT_FORMAT p __itt_model_task __itt_model_task_instance ITT_FORMAT p void ITT_FORMAT p void ITT_FORMAT p void size_t ITT_FORMAT d void ITT_FORMAT p const wchar_t ITT_FORMAT s const char ITT_FORMAT s const char ITT_FORMAT s const char ITT_FORMAT s no args void ITT_FORMAT p size_t ITT_FORMAT d no args const wchar_t const wchar_t ITT_FORMAT s __itt_heap_function void size_t int ITT_FORMAT d __itt_heap_function void ITT_FORMAT p __itt_heap_function void void size_t new_size
#define ITT_STACK_CREATE(obj)
void __TBB_store_relaxed(volatile T &location, V value)
@ es_ref_count_active
Set if ref_count might be changed by another thread. Used for debugging.
static void __TBB_EXPORTED_FUNC free(task &)
#define __TBB_FetchAndDecrementWrelease(P)
unsigned short affinity_id
An id as used for specifying affinity.
void bind_to(internal::generic_scheduler *local_sched)
Registers this context with the local scheduler and binds it to its parent context.
unsigned max_threads_in_arena()
Returns the concurrency limit of the current arena.
@ freed
task object is on free list, or is going to be put there, or was just taken off.
__TBB_atomic reference_count ref_count
Reference count used for synchronization.
void free_task(task &t)
Put task on free list.
void __TBB_EXPORTED_METHOD change_group(task_group_context &ctx)
Moves this task from its current group into another one.
void clear()
Clear the list.
task &__TBB_EXPORTED_METHOD allocate(size_t size) const
void const char const char int ITT_FORMAT __itt_group_sync x void const char ITT_FORMAT __itt_group_sync s void ITT_FORMAT __itt_group_sync p void ITT_FORMAT p void ITT_FORMAT p no args __itt_suppress_mode_t unsigned int void size_t ITT_FORMAT d void ITT_FORMAT p void ITT_FORMAT p __itt_model_site __itt_model_site_instance ITT_FORMAT p __itt_model_task __itt_model_task_instance ITT_FORMAT p void ITT_FORMAT p void ITT_FORMAT p void size_t ITT_FORMAT d void ITT_FORMAT p const wchar_t ITT_FORMAT s const char ITT_FORMAT s const char ITT_FORMAT s const char ITT_FORMAT s no args void ITT_FORMAT p size_t ITT_FORMAT d no args const wchar_t const wchar_t ITT_FORMAT s __itt_heap_function void size_t int ITT_FORMAT d __itt_heap_function void ITT_FORMAT p __itt_heap_function void void size_t int ITT_FORMAT d no args no args unsigned int ITT_FORMAT u const __itt_domain __itt_id ITT_FORMAT lu const __itt_domain __itt_id __itt_id parent
task * my_innermost_running_task
Innermost task whose task::execute() is running. A dummy task on the outermost level.
size_t __TBB_EXPORTED_FUNC get_initial_auto_partitioner_divisor()
task &__TBB_EXPORTED_METHOD allocate(size_t size) const
state_type state() const
Current execution state.
@ no_cache
Disable caching for a small task.
void const char const char int ITT_FORMAT __itt_group_sync s
affinity_id * my_array
Array that remembers affinities of tree positions to affinity_id.
void __TBB_EXPORTED_METHOD resize(unsigned factor)
Resize my_array.
void __TBB_EXPORTED_METHOD free(task &) const
void const char const char int ITT_FORMAT __itt_group_sync x void const char ITT_FORMAT __itt_group_sync s void ITT_FORMAT __itt_group_sync p void ITT_FORMAT p void ITT_FORMAT p no args __itt_suppress_mode_t unsigned int void size_t ITT_FORMAT d void ITT_FORMAT p void ITT_FORMAT p __itt_model_site __itt_model_site_instance ITT_FORMAT p __itt_model_task * task
static task &__TBB_EXPORTED_FUNC allocate(size_t size)
void __TBB_EXPORTED_METHOD free(task &) const
task & allocate_task(size_t number_of_bytes, __TBB_CONTEXT_ARG(task *parent, task_group_context *context))
Allocate task object, either from the heap or a free list.
@ local_task
Task is known to have been allocated by this scheduler.
@ ready
task is in ready pool, or is going to be put there, or was just taken off.
static generic_scheduler * local_scheduler()
Obtain the thread-local instance of the TBB scheduler.
intptr_t reference_count
A reference count.
internal::reference_count __TBB_EXPORTED_METHOD internal_decrement_ref_count()
Decrement reference count and return its new value.
void assert_task_valid(const task *)
void const char const char int ITT_FORMAT __itt_group_sync x void const char ITT_FORMAT __itt_group_sync s void ITT_FORMAT __itt_group_sync p void ITT_FORMAT p sync_releasing
Memory prefix to a task object.
Identifiers declared inside namespace internal should never be used directly by client code.
uintptr_t my_version_and_traits
Version for run-time checks and behavioral traits of the context.
void copy_fp_settings(const task_group_context &src)
Copies FPU control setting from another context.
void const char const char int ITT_FORMAT __itt_group_sync p
void __TBB_EXPORTED_FUNC NFS_Free(void *)
Free memory allocated by NFS_Allocate.
task &__TBB_EXPORTED_METHOD allocate(size_t size) const
tbb::task * parent
The task whose reference count includes me.
static const kind_type binding_required
bool __TBB_EXPORTED_METHOD is_owned_by_current_thread() const
Obsolete, and only retained for the sake of backward compatibility. Always returns true.
void *__TBB_EXPORTED_FUNC NFS_Allocate(size_t n_element, size_t element_size, void *hint)
Allocate memory on cache/sector line boundary.
@ allocated
task object is freshly allocated or recycled.
T __TBB_load_relaxed(const volatile T &location)
void __TBB_EXPORTED_METHOD free(task &) const
#define __TBB_CONTEXT_ARG(arg1, context)
Copyright © 2005-2020 Intel Corporation. All Rights Reserved.
Intel, Pentium, Intel Xeon, Itanium, Intel XScale and VTune are
registered trademarks or trademarks of Intel Corporation or its
subsidiaries in the United States and other countries.
* Other names and brands may be claimed as the property of others.