RTEMS 4.9.2 On-Line Library

Dual-Ported Memory Manager PORT_IDENT - Get ID of a port

RTEMS C User's Guide

15.4.2: PORT_IDENT - Get ID of a port

CALLING SEQUENCE:

rtems_status_code rtems_port_ident(
  rtems_name  name,
  rtems_id   *id
);

DIRECTIVE STATUS CODES:

RTEMS_SUCCESSFUL - port identified successfully
RTEMS_INVALID_ADDRESS - id is NULL
RTEMS_INVALID_NAME - port name not found

DESCRIPTION:

This directive obtains the port id associated with the specified name to be acquired. If the port name is not unique, then the port id will match one of the DPMAs with that name. However, this port id is not guaranteed to correspond to the desired DPMA. The port id is used to access this DPMA in other dual-ported memory area related directives.

NOTES:

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

RTEMS C User's Guide