[PATCH v2] c-user: Fix rtems_region_create() return status

Sebastian Huber sebastian.huber at embedded-brains.de
Fri Jun 1 04:38:30 UTC 2018


---
 c-user/region_manager.rst | 19 ++++++++++---------
 1 file changed, 10 insertions(+), 9 deletions(-)

diff --git a/c-user/region_manager.rst b/c-user/region_manager.rst
index 1bebd8a..6a894d7 100644
--- a/c-user/region_manager.rst
+++ b/c-user/region_manager.rst
@@ -255,17 +255,22 @@ DIRECTIVE STATUS CODES:
        - ``id`` is NULL
      * - ``RTEMS_INVALID_ADDRESS``
        - ``starting_address`` is NULL
-     * - ``RTEMS_INVALID_ADDRESS``
-       - address not on four byte boundary
      * - ``RTEMS_TOO_MANY``
        - too many regions created
      * - ``RTEMS_INVALID_SIZE``
        - invalid page size
+     * - ``RTEMS_INVALID_SIZE``
+       - the memory area defined by the starting address and the length
+         parameters is too small
 
 DESCRIPTION:
-    This directive creates a region from a physically contiguous memory space
-    which starts at starting_address and is length bytes long.  Segments
-    allocated from the region will be a multiple of page_size bytes in length.
+    This directive creates a region from a contiguous memory area
+    which starts at starting_address and is length bytes long.  The memory area
+    must be large enough to contain some internal region administration data.
+    Segments allocated from the region will be a multiple of page_size bytes in
+    length.  The specified page size will be aligned to an
+    architecture-specific minimum alignment if necessary.
+
     The assigned region id is returned in id.  This region id is used as an
     argument to other region related directives to access the region.
 
@@ -279,10 +284,6 @@ DESCRIPTION:
     ``RTEMS_FIFO`` in attribute_set or selecting ``RTEMS_DEFAULT_ATTRIBUTES``
     will cause waiting tasks to be serviced in First In-First Out order.
 
-    The ``starting_address`` parameter must be aligned on a four byte boundary.
-    The ``page_size`` parameter must be a multiple of four greater than or
-    equal to eight.
-
 NOTES:
     This directive will obtain the allocator mutex and may cause the calling
     task to be preempted.
-- 
2.13.6



More information about the devel mailing list