summaryrefslogtreecommitdiffstats
path: root/spec/rtems/userext/if/task-restart.yml
blob: 2d0fafa17713576a44e6137035e441be01714f4f (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
brief: |
  Task restart extensions are invoked when a task restarts.
copyrights:
- Copyright (C) 2009, 2021 embedded brains GmbH & Co. KG
definition:
  default: ${/score/userext/if/thread-restart:/name} ${.:/name}
  variants: []
description: null
enabled-by: true
index-entries: []
interface-type: typedef
links:
- role: interface-placement
  uid: header
- role: interface-ingroup
  uid: group
- role: constraint
  uid: /constraint/thread-dispatching-enabled
- role: constraint
  uid: /constraint/thread-life-protected
- role: constraint
  uid: /constraint/object-allocator-not-owner
name: rtems_task_restart_extension
notes: |
  The task restart extensions are invoked in
  ${/glossary/extension-forward-order:/term}.

  The task restart extensions are invoked in the context of the restarted
  thread right before the execution context is reloaded.  The thread stack
  reflects the previous execution context.

  Thread restart and delete requests issued by restart extensions lead to
  recursion.
params:
- description: |
    is the ${/glossary/tcb:/term} of the executing thread.
  dir: null
  name: executing
- description: |
    is the ${/glossary/tcb:/term} of the executing thread.  Yes, the executing
    thread.
  dir: null
  name: restarted
return: null
type: interface