diff options
Diffstat (limited to 'c-user/user-extensions/directives.rst')
-rw-r--r-- | c-user/user-extensions/directives.rst | 24 |
1 files changed, 14 insertions, 10 deletions
diff --git a/c-user/user-extensions/directives.rst b/c-user/user-extensions/directives.rst index 2dbac54..2c5648b 100644 --- a/c-user/user-extensions/directives.rst +++ b/c-user/user-extensions/directives.rst @@ -1,6 +1,6 @@ .. SPDX-License-Identifier: CC-BY-SA-4.0 -.. Copyright (C) 2020, 2021 embedded brains GmbH (http://www.embedded-brains.de) +.. Copyright (C) 2020, 2021 embedded brains GmbH & Co. KG .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR) .. This file is part of the RTEMS quality process and was automatically @@ -64,9 +64,9 @@ Creates an extension set. set. ``id`` - This parameter is the pointer to an :c:type:`rtems_id` object. When the - directive call is successful, the identifier of the created extension set - will be stored in this object. + This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When + the directive call is successful, the identifier of the created extension + set will be stored in this object. .. rubric:: DESCRIPTION: @@ -102,11 +102,15 @@ The extension set is initialized using the extension table specified in .. rubric:: NOTES: -The user-provided extension set table is not used after the return of the +The user-provided extension table is not used after the return of the directive. -Newly created extension sets are immediately installed and are invoked upon the -next system event supporting an extension. +Each extension of the extension table is optional and may be `NULL +<https://en.cppreference.com/w/c/types/NULL>`_. All extensions except the task +switch extension of the extension table are atomically and immediately +installed. A task switch extension is separately installed after the other +extensions. The extensions of the extension table are invoked upon the next +system event supporting an extension. An alternative to dynamically created extension sets are initial extensions, see :ref:`CONFIGURE_INITIAL_EXTENSIONS`. Initial extensions are recommended @@ -215,9 +219,9 @@ Identifies an extension set by the object name. This parameter is the object name to look up. ``id`` - This parameter is the pointer to an :c:type:`rtems_id` object. When the - directive call is successful, the object identifier of an object with the - specified name will be stored in this object. + This parameter is the pointer to an :ref:`InterfaceRtemsId` object. When + the directive call is successful, the object identifier of an object with + the specified name will be stored in this object. .. rubric:: DESCRIPTION: |