mirror of
https://git.rtems.org/rtems-docs/
synced 2025-05-16 17:16:36 +08:00
c-user: Update rtems_region_create()
This commit is contained in:
parent
ecd9d18fc9
commit
b5d29c996b
@ -255,17 +255,22 @@ DIRECTIVE STATUS CODES:
|
|||||||
- ``id`` is NULL
|
- ``id`` is NULL
|
||||||
* - ``RTEMS_INVALID_ADDRESS``
|
* - ``RTEMS_INVALID_ADDRESS``
|
||||||
- ``starting_address`` is NULL
|
- ``starting_address`` is NULL
|
||||||
* - ``RTEMS_INVALID_ADDRESS``
|
|
||||||
- address not on four byte boundary
|
|
||||||
* - ``RTEMS_TOO_MANY``
|
* - ``RTEMS_TOO_MANY``
|
||||||
- too many regions created
|
- too many regions created
|
||||||
* - ``RTEMS_INVALID_SIZE``
|
* - ``RTEMS_INVALID_SIZE``
|
||||||
- invalid page size
|
- invalid page size
|
||||||
|
* - ``RTEMS_INVALID_SIZE``
|
||||||
|
- the memory area defined by the starting address and the length
|
||||||
|
parameters is too small
|
||||||
|
|
||||||
DESCRIPTION:
|
DESCRIPTION:
|
||||||
This directive creates a region from a physically contiguous memory space
|
This directive creates a region from a contiguous memory area
|
||||||
which starts at starting_address and is length bytes long. Segments
|
which starts at starting_address and is length bytes long. The memory area
|
||||||
allocated from the region will be a multiple of page_size bytes in length.
|
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
|
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.
|
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``
|
``RTEMS_FIFO`` in attribute_set or selecting ``RTEMS_DEFAULT_ATTRIBUTES``
|
||||||
will cause waiting tasks to be serviced in First In-First Out order.
|
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:
|
NOTES:
|
||||||
This directive will obtain the allocator mutex and may cause the calling
|
This directive will obtain the allocator mutex and may cause the calling
|
||||||
task to be preempted.
|
task to be preempted.
|
||||||
|
Loading…
x
Reference in New Issue
Block a user