MSOP_XPOST(D2psm)

MSOP_XPOST -- post events to another CPU

Synopsis

   void pfxxpost(ms_cpu_t cpu, ms_event_t events)

Description

MSOP_XPOST posts, if possible, the events specified by ms_event_t to the CPUs specified by ms_cput_t, which never include the current CPU. ms_cpu_t may be a specific CPU or MS_CPU_ALL_BUT_ME. ms_event_t contains a bitmask or one or more operating-system specific event flags (MS_EVENT_OS_1 through MS_EVENT_OS_4). See data_types(D4psm).

As a result of a request from MSOP_XPOST, the PSM must call os_post_events(D3psm) from a delivery function on the specified CPUs, passing the logical OR of any events that have occurred since the last call to os_post_events. The delivery function must return os_intr_dist_nop or some attached ms_intr_dist_t which has the MSI_EVENTS flag set. The PSM achieves this by sending a cross-processor interrupt to the target CPUs.

MSOP_XPOST returns as soon as it has sent notification of the event to the target CPUs. It does not need to wait for the targets to notice the event.

Interrupts are disabled on the CPU when MSOP_XPOST is called.

Arguments

cpu: the number of the CPU
events: a bitmask of events to send to the CPU

Return values

None.

Usage

Hardware applicability

All.

Version applicability

psm: 2

References

os_post_events(D3psm), data_types(D4psm)