dacs_mailbox_read

NAME

dacs_mailbox_read - Receive a single variable from another process.

SYNOPSIS

DACS_ERR_T dacs_mailbox_read ( uint32_t *msg, de_id_t src_de, dacs_process_id_t src_pid)

Call parameters  
src_de The message source DE.
src_pid The message source process.
Return parameter  
*msg A pointer to the message received.

DESCRIPTION

The dacs_mailbox_read service reads a single 32-bit unsigned integer from the specified source mailbox. There are a number of mailbox slots for each process; this number is defined by the implementation. If the source does not have any pending mailbox messages this service call blocks until one arrives.

RETURN VALUE

The dacs_mailbox_read service returns an error indicator defined as:
  • DACS_SUCCESS: normal return.
  • DACS_ERR_INVALID_ADDR: the pointer is invalid.
  • DACS_ERR_INVALID_DE: the specified DE is either invalid or not reserved.
  • DACS_ERR_INVALID_PID: the specified PID does not refer to an active process.
  • DACS_ERR_INVALID_TARGET: operation not allowed for the target process.

SEE ALSO

dacs_mailbox_write(3), dacs_mailbox_test(3)
Parent topic: Mailboxes