summaryrefslogtreecommitdiffstats
path: root/spec/rtems/userext/if/task-restart.yml
diff options
context:
space:
mode:
Diffstat (limited to 'spec/rtems/userext/if/task-restart.yml')
-rw-r--r--spec/rtems/userext/if/task-restart.yml34
1 files changed, 29 insertions, 5 deletions
diff --git a/spec/rtems/userext/if/task-restart.yml b/spec/rtems/userext/if/task-restart.yml
index fa01e689..a8793259 100644
--- a/spec/rtems/userext/if/task-restart.yml
+++ b/spec/rtems/userext/if/task-restart.yml
@@ -1,8 +1,8 @@
SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
-brief: '%'
+brief: |
+ Task restart extensions are invoked when a task restarts.
copyrights:
-- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
-- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+- Copyright (C) 2009, 2021 embedded brains GmbH (http://www.embedded-brains.de)
definition:
default: ${/score/userext/if/thread-restart:/name} ${.:/name}
variants: []
@@ -15,8 +15,32 @@ links:
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: null
-params: []
+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