dacs_mailbox_write

NAME

dacs_mailbox_write - Send a single variable to another process.

SYNOPSIS

DACS_ERR_T dacs_mailbox_write ( uint32_t *msg, de_id_t dst_de, dacs_process_id_t dst_pid)

Call parameters  
*msg A pointer to the message to write.
dst_de The message destination DE.
dst_pid The destination process id.

DESCRIPTION

The dacs_mailbox_write service writes a single 32-bit unsigned integer to the specified target mailbox. There are an number of mailbox slots for each process; this number is defined by the implementation. If the destination has an empty mailbox slot this service returns immediately. Otherwise this service blocks until a slot becomes available.

RETURN VALUE

The dacs_mailbox_write 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: this operation is not allowed for the target process.

SEE ALSO

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