mirror of
https://git.rtems.org/rtems-docs/
synced 2025-05-16 06:37:23 +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
|
||||
* - ``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.
|
||||
|
Loading…
x
Reference in New Issue
Block a user