RTEMS 4.7.99.2 On-Line Library

Partition Manager PARTITION_IDENT - Get ID of a partition

RTEMS Ada User's Guide

13.4.2: PARTITION_IDENT - Get ID of a partition

CALLING SEQUENCE:

procedure Partition_Ident (
   Name   : in     RTEMS.Name;
   Node   : in     RTEMS.Unsigned32;
   ID     :    out RTEMS.ID;
   Result :    out RTEMS.Status_Codes
);

DIRECTIVE STATUS CODES:

RTEMS.SUCCESSFUL - partition identified successfully
RTEMS.INVALID_ADDRESS - id is NULL
RTEMS.INVALID_NAME - partition name not found
RTEMS.INVALID_NODE - invalid node id

DESCRIPTION:

This directive obtains the partition id associated with the partition name. If the partition name is not unique, then the partition id will match one of the partitions with that name. However, this partition id is not guaranteed to correspond to the desired partition. The partition id is used with other partition related directives to access the partition.

NOTES:

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

If node is RTEMS.SEARCH_ALL_NODES, all nodes are searched with the local node being searched first. All other nodes are searched with the lowest numbered node searched first.

If node is a valid node number which does not represent the local node, then only the partitions exported by the designated node are searched.

This directive does not generate activity on remote nodes. It accesses only the local copy of the global object table.

RTEMS Ada User's Guide