[lng-odp] odp_queue_enq semantics

[Joe Savage]

Hey,

I just wanted to clarify something about the expected behaviour of
odp_queue_enq. In the following code snippet, is it acceptable for the assert
to fire? (i.e. for a dequeue after a successful enqueue to fail, with only a
single thread of execution)

        odp_queue_t queue;
        odp_event_t ev1, ev2;
        /* ... */
        if (odp_queue_enq(queue, ev1) == 0) {
                ev2 = odp_queue_deq(queue);
                assert(ev2 != ODP_EVENT_INVALID);
        }

That is, can the "success" status code from odp_queue_enq be used to indicate
a delayed enqueue ("This event will be added to the queue at some point
soon-ish"), or should it only be used to communicate an immediate successful
addition to the queue? The documentation seems unclear on this point while
the validation tests suggest the latter, but I thought it worth checking up
on.

Thanks,

Joe