rtems/rtems-docs
1
0
Fork 0
mirror of https://git.rtems.org/rtems-docs/ synced 2025-06-06 23:16:04 +08:00
Code Issues Packages Projects Releases Wiki Activity

c-user: Update rtems_task_set_scheduler()

Browse Source
This commit is contained in:
Sebastian Huber 2017-03-07 10:36:43 +01:00
parent ff9d55501f
commit 9260c986ce
1 changed files with 34 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

60
c-user/task_manager.rst
View File

@ -1435,8 +1435,9 @@ CALLING SEQUENCE:
.. code-block:: c .. code-block:: c
rtems_status_code rtems_task_set_scheduler( rtems_status_code rtems_task_set_scheduler(
rtems_id task_id, rtems_id task_id,
rtems_id scheduler_id rtems_id scheduler_id,
rtems_task_priority priority
); );
DIRECTIVE STATUS CODES: DIRECTIVE STATUS CODES:
@ -1447,13 +1448,20 @@ DIRECTIVE STATUS CODES:
- successful operation - successful operation
* - ``RTEMS_INVALID_ID`` * - ``RTEMS_INVALID_ID``
- invalid task or scheduler id - invalid task or scheduler id
* - ``RTEMS_INCORRECT_STATE`` * - ``RTEMS_INVALID_PRIORITY``
- invalid task priority
* - ``RTEMS_RESOURCE_IN_USE``
- the task is in the wrong state to perform a scheduler change - the task is in the wrong state to perform a scheduler change
* - ``RTEMS_UNSATISFIED``
- the processor set of the scheduler is empty
* - ``RTEMS_ILLEGAL_ON_REMOTE_OBJECT``
- not supported on remote tasks
DESCRIPTION: DESCRIPTION:
Sets the scheduler of a task identified by ``task_id`` to the scheduler Sets the scheduler of a task identified by ``task_id`` to the scheduler
identified by ``scheduler_id``. The scheduler of a task is initialized to identified by ``scheduler_id``. The scheduler of a task is initialized to
the scheduler of the task that created it. the scheduler of the task that created it. The priority of the task is set
to ``priority``.
NOTES: NOTES:
None. None.
@ -1465,35 +1473,35 @@ EXAMPLE:
#include <rtems.h> #include <rtems.h>
#include <assert.h> #include <assert.h>
void task(rtems_task_argument arg); void task( rtems_task_argument arg );
void example(void) void example( void )
{ {
rtems_status_code sc; rtems_status_code sc;
rtems_id task_id; rtems_id task_id;
rtems_id scheduler_id; rtems_id scheduler_id;
rtems_name scheduler_name; rtems_name scheduler_name;
scheduler_name = rtems_build_name('W', 'O', 'R', 'K'); scheduler_name = rtems_build_name( 'W', 'O', 'R', 'K' );
sc = rtems_scheduler_ident(scheduler_name, &scheduler_id); sc = rtems_scheduler_ident( scheduler_name, &scheduler_id );
assert(sc == RTEMS_SUCCESSFUL); assert( sc == RTEMS_SUCCESSFUL );
sc = rtems_task_create( sc = rtems_task_create(
rtems_build_name('T', 'A', 'S', 'K'), rtems_build_name( 'T', 'A', 'S', 'K' ),
1, 1,
RTEMS_MINIMUM_STACK_SIZE, RTEMS_MINIMUM_STACK_SIZE,
RTEMS_DEFAULT_MODES, RTEMS_DEFAULT_MODES,
RTEMS_DEFAULT_ATTRIBUTES, RTEMS_DEFAULT_ATTRIBUTES,
&task_id &task_id
); );
assert(sc == RTEMS_SUCCESSFUL); assert( sc == RTEMS_SUCCESSFUL );
sc = rtems_task_set_scheduler(task_id, scheduler_id); sc = rtems_task_set_scheduler( task_id, scheduler_id, 2 );
assert(sc == RTEMS_SUCCESSFUL); assert( sc == RTEMS_SUCCESSFUL );
sc = rtems_task_start(task_id, task, 0); sc = rtems_task_start( task_id, task, 0 );
assert(sc == RTEMS_SUCCESSFUL); assert( sc == RTEMS_SUCCESSFUL );
} }
.. raw:: latex .. raw:: latex