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