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() )
@ allocated
task object is freshly allocated or recycled.
void __TBB_EXPORTED_METHOD change_group(task_group_context &ctx)
Moves this task from its current group into another one.
void bind_to(internal::generic_scheduler *local_sched)
Registers this context with the local scheduler and binds it to its parent context.
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.
void __TBB_EXPORTED_METHOD free(task &) const
__TBB_atomic reference_count ref_count
Reference count used for synchronization.
size_t my_size
Number of elements in my_array.
#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
internal::affinity_id affinity_id
An id as used for specifying affinity.
#define ITT_NOTIFY(name, obj)
task &__TBB_EXPORTED_METHOD allocate(size_t size) const
Memory prefix to a task object.
task_group_context & my_context
unsigned max_threads_in_arena()
Returns the concurrency limit of the current arena.
static void __TBB_EXPORTED_FUNC free(task &)
void spawn_and_wait_for_all(task &child)
Similar to spawn followed by wait_for_all, but more efficient.
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 size
void __TBB_EXPORTED_METHOD free(task &) const
uintptr_t my_version_and_traits
Version for run-time checks and behavioral traits of the context.
task &__TBB_EXPORTED_METHOD allocate(size_t size) const
void copy_fp_settings(const task_group_context &src)
Copies FPU control setting from another context.
__itt_caller itt_caller
Used to set and maintain stack stitching point for Intel Performance Tools.
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
Used to form groups of tasks.
tbb::task * parent
The task whose reference count includes me.
affinity_id * my_array
Array that remembers affinities of tree positions to affinity_id.
#define ITT_STACK_CREATE(obj)
void __TBB_EXPORTED_METHOD free(task &) const
static const kind_type binding_required
Work stealing task scheduler.
void __TBB_store_relaxed(volatile T &location, V value)
static task &__TBB_EXPORTED_FUNC allocate(size_t size)
@ es_ref_count_active
Set if ref_count might be changed by another thread. Used for debugging.
@ freed
task object is on free list, or is going to be put there, or was just taken off.
#define __TBB_FetchAndDecrementWrelease(P)
unsigned short affinity_id
An id as used for specifying affinity.
void __TBB_EXPORTED_METHOD free(task &) const
Base class for user-defined tasks.
tbb::task * next
"next" field for list of task
task &__TBB_EXPORTED_METHOD allocate(size_t size) const
static task &__TBB_EXPORTED_FUNC self()
The innermost task being executed or destroyed by the current thread at the moment.
task_group_context * context
Shared context that is used to communicate asynchronous state changes.
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 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
void free_task(task &t)
Put task on free list.
size_t __TBB_EXPORTED_FUNC get_initial_auto_partitioner_divisor()
@ no_cache
Disable caching for a small task.
void const char const char int ITT_FORMAT __itt_group_sync s
void increment_ref_count()
Atomically increment reference count.
static generic_scheduler * local_scheduler()
Obtain the thread-local instance of the TBB scheduler.
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
__TBB_atomic kind_type my_kind
Flavor of this context: bound or isolated.
@ local_task
Task is known to have been allocated by this scheduler.
state_type state() const
Current execution state.
intptr_t reference_count
A reference count.
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
void assert_task_pool_valid() const
Identifiers declared inside namespace internal should never be used directly by client code.
bool __TBB_EXPORTED_METHOD is_owned_by_current_thread() const
Obsolete, and only retained for the sake of backward compatibility. Always returns true.
virtual void __TBB_EXPORTED_METHOD note_affinity(affinity_id id)
Invoked by scheduler to notify task that it ran on unexpected thread.
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.
internal::reference_count __TBB_EXPORTED_METHOD internal_decrement_ref_count()
Decrement reference count and return its new value.
internal::task_prefix & prefix(internal::version_tag *=NULL) const
Get reference to corresponding task_prefix.
static void __TBB_EXPORTED_FUNC destroy(task &victim)
Destroy a task.
@ ready
task is in ready pool, or is going to be put there, or was just taken off.
virtual ~task()
Destructor.
void clear()
Clear the list.
void __TBB_EXPORTED_METHOD internal_set_ref_count(int count)
Set reference count.
void *__TBB_EXPORTED_FUNC NFS_Allocate(size_t n_element, size_t element_size, void *hint)
Allocate memory on cache/sector line boundary.
void __TBB_EXPORTED_METHOD resize(unsigned factor)
Resize my_array.
task * parent() const
task on whose behalf this task is working, or NULL if this is a root.
T __TBB_load_relaxed(const volatile T &location)
task * my_innermost_running_task
Innermost task whose task::execute() is running. A dummy task on the outermost level.
#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.