RTEMS 4.0.0 On-Line Library

RTEMS C User's Guide

21.9: Multiprocessor Communications Interface Table

The format of this table is defined in the following C structure:

typedef struct {
  rtems_unsigned32                 default_timeout; /* in ticks */
  rtems_unsigned32                 maximum_packet_size;
  rtems_mpci_initialization_entry initialization;
  rtems_mpci_get_packet_entry     get_packet;
  rtems_mpci_return_packet_entry  return_packet;
  rtems_mpci_send_entry           send;
  rtems_mpci_receive_entry        receive;
} rtems_mpci_table;

default_timeout

is the default maximum length of time a task should block waiting for a response to a directive which results in communication with a remote node. The maximum length of time is a function the user supplied multiprocessor communications layer and the media used. This timeout only applies to directives which would not block if the operation were performed locally.

maximum_packet_size

is the size in bytes of the longest packet which the MPCI layer is capable of sending. This value should represent the total number of bytes available for a RTEMS interprocessor messages.

initialization

is the address of the entry point for the initialization procedure of the user supplied multiprocessor communications layer.

get_packet

is the address of the entry point for the procedure called by RTEMS to obtain a packet from the user supplied multiprocessor communications layer.

return_packet

is the address of the entry point for the procedure called by RTEMS to return a packet to the user supplied multiprocessor communications layer.

send

is the address of the entry point for the procedure called by RTEMS to send an envelope to another node. This procedure is part of the user supplied multiprocessor communications layer.

receive

is the address of the entry point for the procedure called by RTEMS to retrieve an envelope containing a message from another node. This procedure is part of the user supplied multiprocessor communications layer.

More information regarding the required functionality of these entry points is provided in the Multiprocessor chapter.

RTEMS C User's Guide

Copyright © 1988-1998 OAR Corporation