c-user: Clarify partition manager documentation

This commit is contained in:
Sebastian Huber 2021-02-09 10:35:37 +01:00
parent 775380c557
commit 45d3811480

View File

@ -76,9 +76,9 @@ Creates a partition.
This parameter is the attribute set of the partition. This parameter is the attribute set of the partition.
``id`` ``id``
This parameter is the pointer to an object identifier variable. The This parameter is the pointer to an object identifier variable. When the
identifier of the created partition will be stored in this variable, in directive call is successful, the identifier of the created partition will
case of a successful operation. be stored in this variable.
.. rubric:: DESCRIPTION: .. rubric:: DESCRIPTION:
@ -191,6 +191,9 @@ The following constraints apply to this directive:
* The directive may obtain and release the object allocator mutex. This may * The directive may obtain and release the object allocator mutex. This may
cause the calling task to be preempted. cause the calling task to be preempted.
* When the directive operates on a global object, the directive sends a message
to remote nodes. This may preempt the calling task.
* The number of partitions available to the application is configured through * The number of partitions available to the application is configured through
the :ref:`CONFIGURE_MAXIMUM_PARTITIONS` application configuration option. the :ref:`CONFIGURE_MAXIMUM_PARTITIONS` application configuration option.
@ -238,9 +241,9 @@ Identifies a partition by the object name.
This parameter is the node or node set to search for a matching object. This parameter is the node or node set to search for a matching object.
``id`` ``id``
This parameter is the pointer to an object identifier variable. The object This parameter is the pointer to an object identifier variable. When the
identifier of an object with the specified name will be stored in this directive call is successful, the object identifier of an object with the
variable, in case of a successful operation. specified name will be stored in this variable.
.. rubric:: DESCRIPTION: .. rubric:: DESCRIPTION:
@ -374,6 +377,9 @@ The following constraints apply to this directive:
* The directive may obtain and release the object allocator mutex. This may * The directive may obtain and release the object allocator mutex. This may
cause the calling task to be preempted. cause the calling task to be preempted.
* When the directive operates on a global object, the directive sends a message
to remote nodes. This may preempt the calling task.
* The calling task does not have to be the task that created the object. Any * The calling task does not have to be the task that created the object. Any
local task that knows the object identifier can delete the object. local task that knows the object identifier can delete the object.
@ -409,9 +415,9 @@ Tries to get a buffer from the partition.
This parameter is the partition identifier. This parameter is the partition identifier.
``buffer`` ``buffer``
This parameter is the pointer to a buffer pointer variable. The pointer to This parameter is the pointer to a buffer pointer variable. When the
the allocated buffer will be stored in this variable, in case of a directive call is successful, the pointer to the allocated buffer will be
successful operation. stored in this variable.
.. rubric:: DESCRIPTION: .. rubric:: DESCRIPTION: