[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