From 35cbb42a42f7c9f7d1a08dc165584b24782aad60 Mon Sep 17 00:00:00 2001 From: Sebastian Huber Date: Tue, 27 Apr 2021 13:09:27 +0200 Subject: c-user: Generate region manager documentation The documentation is a consolidation of the comments in Doxygen markup and the documentation sources in Sphinx markup. The documentation was transfered to interface specification items. The documentation source files were generated from the items by a script. Update #3993. --- c-user/region/introduction.rst | 58 +++++++++++++++++++++++++++++++++--------- 1 file changed, 46 insertions(+), 12 deletions(-) (limited to 'c-user/region/introduction.rst') diff --git a/c-user/region/introduction.rst b/c-user/region/introduction.rst index 418e397..8075a84 100644 --- a/c-user/region/introduction.rst +++ b/c-user/region/introduction.rst @@ -1,29 +1,63 @@ .. SPDX-License-Identifier: CC-BY-SA-4.0 +.. Copyright (C) 2020, 2021 embedded brains GmbH (http://www.embedded-brains.de) .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR) +.. This file is part of the RTEMS quality process and was automatically +.. generated. If you find something that needs to be fixed or +.. worded better please post a report or patch to an RTEMS mailing list +.. or raise a bug report: +.. +.. https://www.rtems.org/bugs.html +.. +.. For information on updating and regenerating please refer to the How-To +.. section in the Software Requirements Engineering chapter of the +.. RTEMS Software Engineering manual. The manual is provided as a part of +.. a release. For development sources please refer to the online +.. documentation at: +.. +.. https://docs.rtems.org + +.. Generated from spec:/rtems/region/if/group + +.. _RegionManagerIntroduction: + Introduction ============ -The region manager provides facilities to dynamically allocate memory in -variable sized units. The directives provided by the region manager are: +.. The following list was generated from: +.. spec:/rtems/region/if/create +.. spec:/rtems/region/if/ident +.. spec:/rtems/region/if/delete +.. spec:/rtems/region/if/extend +.. spec:/rtems/region/if/get-segment +.. spec:/rtems/region/if/return-segment +.. spec:/rtems/region/if/resize-segment +.. spec:/rtems/region/if/get-information +.. spec:/rtems/region/if/get-free-information +.. spec:/rtems/region/if/get-segment-size + +The Region Manager provides facilities to dynamically allocate memory in +variable sized units. The directives provided by the Region Manager are: -- :ref:`rtems_region_create` +* :ref:`InterfaceRtemsRegionCreate` - Creates a region. -- :ref:`rtems_region_ident` +* :ref:`InterfaceRtemsRegionIdent` - Identifies a region by the object name. -- :ref:`rtems_region_delete` +* :ref:`InterfaceRtemsRegionDelete` - Deletes the region. -- :ref:`rtems_region_extend` +* :ref:`InterfaceRtemsRegionExtend` - Extends the region. -- :ref:`rtems_region_get_segment` +* :ref:`InterfaceRtemsRegionGetSegment` - Gets a segment from the region. -- :ref:`rtems_region_return_segment` +* :ref:`InterfaceRtemsRegionReturnSegment` - Returns the segment to the region. -- :ref:`rtems_region_get_segment_size` +* :ref:`InterfaceRtemsRegionResizeSegment` - Changes the size of the segment. -- :ref:`rtems_region_resize_segment` +* :ref:`InterfaceRtemsRegionGetInformation` - Gets the region information. -- :ref:`rtems_region_get_information` +* :ref:`InterfaceRtemsRegionGetFreeInformation` - Gets the region free + information. -- :ref:`rtems_region_get_free_information` +* :ref:`InterfaceRtemsRegionGetSegmentSize` - Gets the size of the region + segment. -- cgit v1.2.3