|
@@ -2027,11 +2027,11 @@ process the task). Otherwise, @code{starpu_task_submit} returns immediately.
|
|
|
@item @code{int priority} (optional) (default: @code{STARPU_DEFAULT_PRIO})
|
|
|
This field indicates a level of priority for the task. This is an integer value
|
|
|
that must be set between the return values of the
|
|
|
-@code{starpu_task_get_min_priority} function for the least important tasks,
|
|
|
-and that of the @code{starpu_task_get_max_priority} for the most important
|
|
|
+@code{starpu_sched_get_min_priority} function for the least important tasks,
|
|
|
+and that of the @code{starpu_sched_get_max_priority} for the most important
|
|
|
tasks (included). The @code{STARPU_MIN_PRIO} and @code{STARPU_MAX_PRIO} macros
|
|
|
are provided for convenience and respectively returns value of
|
|
|
-@code{starpu_task_get_min_priority} and @code{starpu_task_get_max_priority}.
|
|
|
+@code{starpu_sched_get_min_priority} and @code{starpu_sched_get_max_priority}.
|
|
|
Default priority is @code{STARPU_DEFAULT_PRIO}, which is always defined as 0 in
|
|
|
order to allow static task initialization. Scheduling strategies that take
|
|
|
priorities into account can use this parameter to take better scheduling
|
|
@@ -3530,6 +3530,7 @@ they are taken in ID order.
|
|
|
|
|
|
@node Scheduling Contexts
|
|
|
@section Scheduling Contexts
|
|
|
+
|
|
|
StarPU permits on one hand grouping workers in combined workers in order to execute a parallel task and on the other hand grouping tasks in bundles that will be executed by a single specified worker.
|
|
|
In contrast when we group workers in scheduling contexts we submit starpu tasks to them and we schedule them with the policy assigned to the context.
|
|
|
Scheduling contexts can be created, deleted and modified dynamically.
|
|
@@ -3617,6 +3618,34 @@ Return the number of workers managed by the specified contexts
|
|
|
Return the number of workers shared by two contexts
|
|
|
@end deftypefun
|
|
|
|
|
|
+@deftypefun void starpu_sched_ctx_set_min_priority (unsigned @var{sched_ctx_id}, int @var{min_prio})
|
|
|
+Defines the minimum task priority level supported by the scheduling
|
|
|
+policy of the given scheduler context. The
|
|
|
+default minimum priority level is the same as the default priority level which
|
|
|
+is 0 by convention. The application may access that value by calling the
|
|
|
+@code{starpu_sched_ctx_get_min_priority} function. This function should only be
|
|
|
+called from the initialization method of the scheduling policy, and should not
|
|
|
+be used directly from the application.
|
|
|
+@end deftypefun
|
|
|
+
|
|
|
+@deftypefun void starpu_sched_set_max_priority (unsigned @var{sched_ctx_id}, int @var{max_prio})
|
|
|
+Defines the maximum priority level supported by the scheduling policy of the given scheduler context. The
|
|
|
+default maximum priority level is 1. The application may access that value by
|
|
|
+calling the @code{starpu_sched_ctx_get_max_priority} function. This function should
|
|
|
+only be called from the initialization method of the scheduling policy, and
|
|
|
+should not be used directly from the application.
|
|
|
+@end deftypefun
|
|
|
+
|
|
|
+@deftypefun int starpu_sched_get_min_priority (unsigned @var{sched_ctx_id})
|
|
|
+Returns the current minimum priority level supported by the
|
|
|
+scheduling policy of the given scheduler context.
|
|
|
+@end deftypefun
|
|
|
+
|
|
|
+@deftypefun int starpu_sched_get_max_priority (unsigned @var{sched_ctx_id})
|
|
|
+Returns the current maximum priority level supported by the
|
|
|
+scheduling policy of the given scheduler context.
|
|
|
+@end deftypefun
|
|
|
+
|
|
|
@node Scheduling Policy
|
|
|
@section Scheduling Policy
|
|
|
|
|
@@ -3696,29 +3725,29 @@ It is memorize through a local structure. This function assigns it to a scheduli
|
|
|
Returns the policy data previously assigned to a context
|
|
|
@end deftypefun
|
|
|
|
|
|
-@deftypefun void starpu_task_set_min_priority (int @var{min_prio})
|
|
|
+@deftypefun void starpu_sched_set_min_priority (int @var{min_prio})
|
|
|
Defines the minimum task priority level supported by the scheduling policy. The
|
|
|
default minimum priority level is the same as the default priority level which
|
|
|
is 0 by convention. The application may access that value by calling the
|
|
|
-@code{starpu_task_get_min_priority} function. This function should only be
|
|
|
+@code{starpu_sched_get_min_priority} function. This function should only be
|
|
|
called from the initialization method of the scheduling policy, and should not
|
|
|
be used directly from the application.
|
|
|
@end deftypefun
|
|
|
|
|
|
-@deftypefun void starpu_task_set_max_priority (int @var{max_prio})
|
|
|
+@deftypefun void starpu_sched_set_max_priority (int @var{max_prio})
|
|
|
Defines the maximum priority level supported by the scheduling policy. The
|
|
|
default maximum priority level is 1. The application may access that value by
|
|
|
-calling the @code{starpu_task_get_max_priority} function. This function should
|
|
|
+calling the @code{starpu_sched_get_max_priority} function. This function should
|
|
|
only be called from the initialization method of the scheduling policy, and
|
|
|
should not be used directly from the application.
|
|
|
@end deftypefun
|
|
|
|
|
|
-@deftypefun int starpu_task_get_min_priority (void)
|
|
|
+@deftypefun int starpu_sched_get_min_priority (void)
|
|
|
Returns the current minimum priority level supported by the
|
|
|
scheduling policy
|
|
|
@end deftypefun
|
|
|
|
|
|
-@deftypefun int starpu_task_get_max_priority (void)
|
|
|
+@deftypefun int starpu_sched_get_max_priority (void)
|
|
|
Returns the current maximum priority level supported by the
|
|
|
scheduling policy
|
|
|
@end deftypefun
|