RTEMS 4.10.2 On-Line Library

Partition Manager PARTITION_RETURN_BUFFER - Return buffer to a partition

RTEMS C User's Guide

13.4.5: PARTITION_RETURN_BUFFER - Return buffer to a partition

CALLING SEQUENCE:

rtems_status_code rtems_partition_return_buffer(
  rtems_id  id,
  void     *buffer
);

DIRECTIVE STATUS CODES:

RTEMS_SUCCESSFUL - buffer returned successfully
RTEMS_INVALID_ADDRESS - buffer is NULL
RTEMS_INVALID_ID - invalid partition id
RTEMS_INVALID_ADDRESS - buffer address not in partition

DESCRIPTION:

This directive returns the buffer specified by buffer to the partition specified by id.

NOTES:

This directive will not cause the running task to be preempted.

Returning a buffer to a global partition which does not reside on the local node will generate a request telling the remote node to return the buffer to the specified partition.

Returning a buffer multiple times is an error. It will corrupt the internal state of the partition.

RTEMS C User's Guide