ec_message_enqueue

March 26, 2020 Contributors

Name

ec_message_enqueue — Enqueue a message

Synopsis

#include "message.h"

| int **ec_message_enqueue** ( | message, |   |
|   | now); |   |

ec_message * <var class="pdparam">message</var>;
struct timeval * <var class="pdparam">now</var>;

Description

Perform a message enqueue operation (either delayed OR active queue).

Parameters

message

A pointer to an ec_message struct. For documentation of this data structure see “ec_message”

now

A pointer to a timeval struct.

Return Values

This function returns an int. It returns 0 on success (which could mean the message has already been delivered) or -1 on error, but the error generally only happens if the recipient is invalid (which typically should not happen). The message MUST NOT be in any queue in the system otherwise the system will abort and shutdown.

Threading

It is legal to call this function in the Scheduler thread.

See Also

ec_mailq_insert_active