Home / Autodocs / exec.library
NAME
- PutMsg
-
put a message to a message port
SYNOPSIS
PutMsg(port, message)
void PutMsg(struct MsgPort *, struct Message *);
A0 A1
FUNCTION
This function attaches a message to the end of a given message port. It provides a fast, non-copying message sending mechanism.
Messages can be attached to only one port at a time. The message body can be of any size or form. Because messages are not copied, cooperating Tasks share the same message memory. The sender Task must not recycle the message until it has been replied by the receiver. Of course this depends on the message handling conventions setup by the involved Tasks. If the Message->mn_ReplyPort field is non-zero, when the message is replied by the receiver through ReplyMsg(), it will be sent to that port.
Any one of the following actions can be set to occur when a message is put:
This function is safe to call from interrupts.
IMPLEMENTATION
Messages can be attached to only one port at a time. The message body can be of any size or form. Because messages are not copied, cooperating Tasks share the same message memory. The sender Task must not recycle the message until it has been replied by the receiver. Of course this depends on the message handling conventions setup by the involved Tasks. If the Message->mn_ReplyPort field is non-zero, when the message is replied by the receiver through ReplyMsg(), it will be sent to that port.
Any one of the following actions can be set to occur when a message is put:
1. no special action
2. signal a given Task (specified by MP_SIGTASK)
3. cause a software interrupt (specified by MP_SIGTASK)
The action is selected depending on the value found in the MP_FLAGS member of the destination port.
2. signal a given Task (specified by MP_SIGTASK)
3. cause a software interrupt (specified by MP_SIGTASK)
This function is safe to call from interrupts.
IMPLEMENTATION
1. Sets the mn_Node.ln_Type field of the message to "NT_MESSAGE".
2. Attaches the message to the destination port.
3. Performs the specified arrival action at the destination.
2. Attaches the message to the destination port.
3. Performs the specified arrival action at the destination.
INPUTS
- port
-
pointer to a message port
- message
-
pointer to a message