RTEMS 4.8.0 On-Line Library

Barrier Manager BARRIER_IDENT - Get ID of a barrier

RTEMS C User's Guide

20.4.2: BARRIER_IDENT - Get ID of a barrier

CALLING SEQUENCE:

rtems_status_code rtems_barrier_ident(
  rtems_name        name,
  rtems_id         *id
);

DIRECTIVE STATUS CODES:

RTEMS_SUCCESSFUL - barrier identified successfully
RTEMS_INVALID_NAME - barrier name not found
RTEMS_INVALID_NODE - invalid node id

DESCRIPTION:

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

NOTES:

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

RTEMS C User's Guide