event_machine_eo.c

/*
 *   Copyright (c) 2015-2025, Nokia Solutions and Networks
 *   All rights reserved.
 *
 *   Redistribution and use in source and binary forms, with or without
 *   modification, are permitted provided that the following conditions
 *   are met:
 *
 *     * Redistributions of source code must retain the above copyright
 *       notice, this list of conditions and the following disclaimer.
 *     * Redistributions in binary form must reproduce the above copyright
 *       notice, this list of conditions and the following disclaimer in the
 *       documentation and/or other materials provided with the distribution.
 *     * Neither the name of the copyright holder nor the names of its
 *       contributors may be used to endorse or promote products derived
 *       from this software without specific prior written permission.
 *
 *   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 *   "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 *   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 *   A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 *   OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 *   SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 *   LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 *   DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 *   THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 *   (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 *   OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */
 
#ifndef _GNU_SOURCE
#define _GNU_SOURCE
#endif
 
#ifdef HAVE_CONFIG_H
#include "config.h"
#endif
 
#include <stdbool.h>
#include <stdint.h>
#include <stdio.h>
#include <string.h>
 
#include <odp_api.h>
 
#include <event_machine.h>
#include <event_machine/platform/env/environment.h>
 
#include "em_eo.h"
#include "em_eo_types.h"
#include "em_error.h"
#include "em_event.h"
#include "em_event_inline.h"
#include "em_internal_event.h"
#include "em_internal_event_types.h"
#include "em_mem.h"
#include "em_queue.h"
#include "em_queue_inline.h"
#include "em_queue_types.h"
#include "misc/list.h"
#include "misc/objpool.h"
 
/* Per core (thread) state of em_eo_next() */
static ENV_LOCAL unsigned int _eo_tbl_iter_idx;
/* Per core (thread) state of em_eo_queue_next() */
static ENV_LOCAL unsigned int _eo_q_iter_idx;
static ENV_LOCAL em_eo_t _eo_q_iter_eo;
 
static em_status_t check_eo_create_params(const em_eo_param_t *param,
                                          em_escope_t escope)
{
        RETURN_ERROR_IF(!param || param->__internal_check != EM_CHECK_INIT_CALLED,
                        EM_ERR_NOT_INITIALIZED, escope,
                        "Invalid param ptr: Use em_eo_param_init() before create");
 
        RETURN_ERROR_IF(!param->start || !param->stop || !param->receive,
                        EM_ERR_BAD_POINTER, escope,
                        "Mandatory EO function pointer(s) NULL!");
 
        RETURN_ERROR_IF(param->local_start &&
                        (param->local_start_mode >= EM_EO_START_LOCAL_MODE_LAST ||
                         param->local_start_mode < EM_EO_START_LOCAL_MODE_CONFIG_FILE),
                         EM_ERR_BAD_STATE, escope,
                         "Invalid local_start_mode:%d", param->local_start_mode);
 
        RETURN_ERROR_IF(param->local_stop &&
                        (param->local_stop_mode >= EM_EO_STOP_LOCAL_MODE_LAST ||
                         param->local_stop_mode < EM_EO_STOP_LOCAL_MODE_CONFIG_FILE),
                        EM_ERR_BAD_STATE, escope,
                        "Invalid local_stop_mode:%d", param->local_stop_mode);
 
        return EM_OK;
}
 
static em_eo_t eo_create(const char *name, const em_eo_param_t *param,
                         em_escope_t escope)
{
        em_eo_t eo;
        eo_elem_t *eo_elem;
        em_status_t status;
 
        status = check_eo_create_params(param, escope);
        if (unlikely(status != EM_OK)) {
                /* Error reported by check_eo_create_params(), just return */
                return EM_EO_UNDEF;
        }
 
        eo = eo_alloc();
        if (unlikely(eo == EM_EO_UNDEF)) {
                INTERNAL_ERROR(EM_ERR_ALLOC_FAILED, escope, "EO alloc failed!");
                return EM_EO_UNDEF;
        }
 
        eo_elem = eo_elem_get(eo);
        if (unlikely(!eo_elem)) {
                /* Fatal since eo_alloc() returned 'ok', should never happen */
                INTERNAL_ERROR(EM_FATAL(EM_ERR_BAD_ID), escope,
                               "Invalid EO:%" PRI_EO "", eo);
                return EM_EO_UNDEF;
        }
 
        odp_ticketlock_lock(&eo_elem->lock);
 
        /* Store the name */
        if (name != NULL) {
                strncpy(eo_elem->name, name, sizeof(eo_elem->name) - 1);
                eo_elem->name[sizeof(eo_elem->name) - 1] = '\0';
        } else {
                eo_elem->name[0] = '\0';
        }
 
        /* EO's queue list init */
        list_init(&eo_elem->queue_list);
        /* EO start: event buffering init */
        eo_elem->stash = ODP_STASH_INVALID;
 
        eo_elem->state = EM_EO_STATE_CREATED;
        eo_elem->start_func = param->start;
        eo_elem->start_local_func = param->local_start;
        eo_elem->start_local_mode = param->local_start_mode;
 
        eo_elem->stop_func = param->stop;
        eo_elem->stop_local_func = param->local_stop;
        eo_elem->stop_local_mode = param->local_stop_mode;
 
        eo_elem->use_multi_rcv = EM_FALSE;
        eo_elem->max_events = 1;
        eo_elem->receive_func = param->receive;
        eo_elem->receive_multi_func = NULL;
 
        eo_elem->error_handler_func = NULL;
        eo_elem->eo_ctx = (void *)(uintptr_t)param->eo_ctx;
        eo_elem->eo = eo;
        odp_atomic_init_u32(&eo_elem->num_queues, 0);
 
        odp_ticketlock_unlock(&eo_elem->lock);
 
        return eo;
}
 
void em_eo_param_init(em_eo_param_t *param)
{
        if (unlikely(!param)) {
                INTERNAL_ERROR(EM_FATAL(EM_ERR_BAD_ARG),
                               EM_ESCOPE_EO_PARAM_INIT,
                               "Param pointer NULL!");
                return;
        }
        memset(param, 0, sizeof(em_eo_param_t));
        param->__internal_check = EM_CHECK_INIT_CALLED;
}
 
em_eo_t em_eo_create(const char *name,
                     em_start_func_t start, em_start_local_func_t local_start,
                     em_stop_func_t stop, em_stop_local_func_t local_stop,
                     em_receive_func_t receive, const void *eo_ctx)
{
        em_eo_param_t param;
 
        if (unlikely(start == NULL || stop == NULL || receive == NULL)) {
                INTERNAL_ERROR(EM_ERR_BAD_ARG, EM_ESCOPE_EO_CREATE,
                               "Mandatory EO function pointer(s) NULL!");
                return EM_EO_UNDEF;
        }
 
        em_eo_param_init(&param);
        param.start = start;
        param.local_start = local_start;
        param.stop = stop;
        param.local_stop = local_stop;
        param.receive = receive;
        param.eo_ctx = eo_ctx;
 
        return eo_create(name, &param, EM_ESCOPE_EO_CREATE);
}
 
em_eo_t em_eo_create_param(const char *name, const em_eo_param_t *param)
{
        return eo_create(name, param, EM_ESCOPE_EO_CREATE_PARAM);
}
 
void em_eo_multircv_param_init(em_eo_multircv_param_t *param)
{
        if (unlikely(!param)) {
                INTERNAL_ERROR(EM_FATAL(EM_ERR_BAD_ARG),
                               EM_ESCOPE_EO_MULTIRCV_PARAM_INIT,
                               "Param pointer NULL!");
                return;
        }
        memset(param, 0, sizeof(em_eo_multircv_param_t));
        param->max_events = EM_EO_MULTIRCV_MAX_EVENTS;
        param->__internal_check = EM_CHECK_INIT_CALLED;
}
 
em_eo_t
em_eo_create_multircv(const char *name, const em_eo_multircv_param_t *param)
{
        em_eo_t eo;
        eo_elem_t *eo_elem;
        int max_events;
 
        if (unlikely(!param ||
                     param->__internal_check != EM_CHECK_INIT_CALLED)) {
                INTERNAL_ERROR(EM_ERR_NOT_INITIALIZED, EM_ESCOPE_EO_CREATE_MULTIRCV,
                               "Invalid param ptr:\n"
                               "Use em_eo_multircv_param_init() before create");
                return EM_EO_UNDEF;
        }
 
        if (unlikely(!param->start || !param->stop || !param->receive_multi)) {
                INTERNAL_ERROR(EM_ERR_BAD_POINTER, EM_ESCOPE_EO_CREATE_MULTIRCV,
                               "Mandatory EO function pointer(s) NULL!");
                return EM_EO_UNDEF;
        }
 
        if (unlikely(param->max_events < 0)) {
                INTERNAL_ERROR(EM_ERR_TOO_SMALL, EM_ESCOPE_EO_CREATE_MULTIRCV,
                               "Max number of events too small:%d",
                               param->max_events);
                return EM_EO_UNDEF;
        }
        max_events = param->max_events;
        if (max_events == 0) /* user requests default value */
                max_events = EM_EO_MULTIRCV_MAX_EVENTS;
 
        eo = eo_alloc();
        if (unlikely(eo == EM_EO_UNDEF)) {
                INTERNAL_ERROR(EM_ERR_ALLOC_FAILED, EM_ESCOPE_EO_CREATE_MULTIRCV,
                               "EO alloc failed!");
                return EM_EO_UNDEF;
        }
 
        eo_elem = eo_elem_get(eo);
        if (unlikely(eo_elem == NULL)) {
                /* Fatal since eo_alloc() returned 'ok', should never happen */
                INTERNAL_ERROR(EM_FATAL(EM_ERR_BAD_ID),
                               EM_ESCOPE_EO_CREATE_MULTIRCV,
                               "Invalid EO:%" PRI_EO "", eo);
                return EM_EO_UNDEF;
        }
 
        odp_ticketlock_lock(&eo_elem->lock);
 
        /* Store the name */
        if (name) {
                strncpy(eo_elem->name, name, sizeof(eo_elem->name) - 1);
                eo_elem->name[sizeof(eo_elem->name) - 1] = '\0';
        } else {
                eo_elem->name[0] = '\0';
        }
 
        /* EO's queue list init */
        list_init(&eo_elem->queue_list);
        /* EO start: event buffering init */
        eo_elem->stash = ODP_STASH_INVALID;
 
        eo_elem->state = EM_EO_STATE_CREATED;
        eo_elem->start_func = param->start;
        eo_elem->start_local_func = param->local_start;
        eo_elem->start_local_mode = param->local_start_mode;
 
        eo_elem->stop_func = param->stop;
        eo_elem->stop_local_func = param->local_stop;
        eo_elem->stop_local_mode = param->local_stop_mode;
 
        eo_elem->use_multi_rcv = EM_TRUE;
        eo_elem->max_events = max_events;
        eo_elem->receive_func = NULL;
        eo_elem->receive_multi_func = param->receive_multi;
 
        eo_elem->error_handler_func = NULL;
        eo_elem->eo_ctx = (void *)(uintptr_t)param->eo_ctx;
        eo_elem->eo = eo;
        odp_atomic_init_u32(&eo_elem->num_queues, 0);
 
        odp_ticketlock_unlock(&eo_elem->lock);
 
        return eo;
}
 
em_status_t em_eo_delete(em_eo_t eo)
{
        eo_elem_t *const eo_elem = eo_elem_get(eo);
        em_status_t status;
 
        RETURN_ERROR_IF(eo_elem == NULL, EM_ERR_BAD_ARG, EM_ESCOPE_EO_DELETE,
                        "Invalid EO:%" PRI_EO "!", eo);
 
        RETURN_ERROR_IF(!eo_allocated(eo_elem),
                        EM_ERR_NOT_CREATED, EM_ESCOPE_EO_DELETE,
                        "EO not allocated:%" PRI_EO "", eo);
 
        RETURN_ERROR_IF(eo_elem->state != EM_EO_STATE_CREATED &&
                        eo_elem->state != EM_EO_STATE_ERROR,
                        EM_ERR_BAD_STATE, EM_ESCOPE_EO_DELETE,
                        "EO invalid state, cannot delete:%d", eo_elem->state);
 
        status = eo_delete_queue_all(eo_elem);
 
        RETURN_ERROR_IF(status != EM_OK, status, EM_ESCOPE_EO_DELETE,
                        "EO delete: delete queues failed!");
 
        /* Free EO back into the eo-pool and mark state=EO_STATE_UNDEF */
        status = eo_free(eo);
        RETURN_ERROR_IF(status != EM_OK, status, EM_ESCOPE_EO_DELETE,
                        "EO delete failed!");
 
        return status;
}
 
size_t em_eo_name(em_eo_t eo, char *name, size_t maxlen)
{
        const eo_elem_t *eo_elem = eo_elem_get(eo);
 
        if (name == NULL || maxlen == 0) {
                INTERNAL_ERROR(EM_ERR_BAD_ARG, EM_ESCOPE_EO_NAME,
                               "Invalid ptr or maxlen (name=0x%" PRIx64 ", maxlen=%zu)",
                               name, maxlen);
                return 0;
        }
 
        name[0] = '\0';
 
        if (unlikely(eo_elem == NULL)) {
                INTERNAL_ERROR(EM_ERR_BAD_ARG, EM_ESCOPE_EO_NAME,
                               "Invalid EO%" PRI_EO "", eo);
                return 0;
        }
 
        if (unlikely(!eo_allocated(eo_elem))) {
                INTERNAL_ERROR(EM_ERR_NOT_CREATED, EM_ESCOPE_EO_NAME,
                               "EO not created:%" PRI_EO "", eo);
                return 0;
        }
 
        return eo_name(eo_elem, name, maxlen);
}
 
em_eo_t em_eo_find(const char *name)
{
        if (name && *name) {
                for (int i = 0; i < EM_MAX_EOS; i++) {
                        const eo_elem_t *eo_elem = &em_shm->eo_tbl.eo_elem[i];
 
                        if (eo_elem->state != EM_EO_STATE_UNDEF &&
                            !strncmp(name, eo_elem->name, EM_EO_NAME_LEN - 1))
                                return eo_elem->eo;
                }
        }
        return EM_EO_UNDEF;
}
 
/**
 * @brief Helper for em_eo_add_queue/_sync()
 */
static em_status_t
eo_add_queue_escope(em_eo_t eo, em_queue_t queue,
                    int num_notif, const em_notif_t notif_tbl[],
                    em_escope_t escope)
{       eo_elem_t *const eo_elem = eo_elem_get(eo);
        queue_elem_t *const q_elem = queue_elem_get(queue);
        em_queue_type_t q_type;
        em_status_t err;
        int valid;
 
        RETURN_ERROR_IF(eo_elem == NULL || q_elem == NULL,
                        EM_ERR_BAD_ARG, escope,
                        "Invalid args: EO:%" PRI_EO " Q:%" PRI_QUEUE "",
                        eo, queue);
        RETURN_ERROR_IF(!eo_allocated(eo_elem) || !queue_allocated(q_elem),
                        EM_ERR_NOT_CREATED, escope,
                        "Not created: EO:%" PRI_EO " Q:%" PRI_QUEUE "",
                        eo, queue);
 
        q_type = em_queue_type(queue);
        valid = q_type == EM_QUEUE_TYPE_ATOMIC ||
                q_type == EM_QUEUE_TYPE_PARALLEL ||
                q_type == EM_QUEUE_TYPE_ORDERED ||
                q_type == EM_QUEUE_TYPE_LOCAL;
        RETURN_ERROR_IF(!valid, EM_ERR_BAD_TYPE, escope,
                        "Invalid queue type: %" PRI_QTYPE "", q_type);
 
        if (num_notif > 0) {
                err = check_notif_tbl(num_notif, notif_tbl);
                RETURN_ERROR_IF(err != EM_OK, err, escope,
                                "Invalid notif cfg given!");
        }
 
        err = eo_add_queue(eo_elem, q_elem);
        RETURN_ERROR_IF(err != EM_OK, err, escope,
                        "eo_add_queue(Q:%" PRI_QUEUE ") fails", queue);
 
        if (eo_elem->state == EM_EO_STATE_RUNNING) {
                err = queue_enable(q_elem); /* otherwise enabled in eo-start */
                RETURN_ERROR_IF(err != EM_OK, err, escope,
                                "queue_enable(Q:%" PRI_QUEUE ") fails", queue);
        }
 
        if (num_notif > 0) {
                /* Send notifications if requested */
                err = send_notifs(num_notif, notif_tbl);
                RETURN_ERROR_IF(err != EM_OK, err, escope,
                                "EO:%" PRI_EO " send notif fails", eo);
        }
 
        return EM_OK;
}
 
em_status_t
em_eo_add_queue(em_eo_t eo, em_queue_t queue,
                int num_notif, const em_notif_t notif_tbl[])
{
        return eo_add_queue_escope(eo, queue, num_notif, notif_tbl,
                                   EM_ESCOPE_EO_ADD_QUEUE);
}
 
em_status_t
em_eo_add_queue_sync(em_eo_t eo, em_queue_t queue)
{
        /* No sync blocking needed when adding a queue to an EO */
        return eo_add_queue_escope(eo, queue, 0, NULL,
                                   EM_ESCOPE_EO_ADD_QUEUE_SYNC);
}
 
em_status_t
em_eo_remove_queue(em_eo_t eo, em_queue_t queue,
                   int num_notif, const em_notif_t notif_tbl[])
{
        eo_elem_t *const eo_elem = eo_elem_get(eo);
        queue_elem_t *const q_elem = queue_elem_get(queue);
        em_queue_type_t q_type;
        em_status_t ret;
        int valid;
 
        RETURN_ERROR_IF(eo_elem == NULL || q_elem == NULL,
                        EM_ERR_BAD_ARG, EM_ESCOPE_EO_REMOVE_QUEUE,
                        "Invalid args: EO:%" PRI_EO " Q:%" PRI_QUEUE "",
                        eo, queue);
        RETURN_ERROR_IF(!eo_allocated(eo_elem) || !queue_allocated(q_elem),
                        EM_ERR_NOT_CREATED, EM_ESCOPE_EO_REMOVE_QUEUE,
                        "Not created: EO:%" PRI_EO " Q:%" PRI_QUEUE "",
                        eo, queue);
 
        q_type = em_queue_type(queue);
        valid = q_type == EM_QUEUE_TYPE_ATOMIC ||
                q_type == EM_QUEUE_TYPE_PARALLEL ||
                q_type == EM_QUEUE_TYPE_ORDERED ||
                q_type == EM_QUEUE_TYPE_LOCAL;
        RETURN_ERROR_IF(!valid, EM_ERR_BAD_TYPE, EM_ESCOPE_EO_REMOVE_QUEUE,
                        "Invalid queue type: %" PRI_QTYPE "", q_type);
 
        ret = check_notif_tbl(num_notif, notif_tbl);
        RETURN_ERROR_IF(ret != EM_OK, ret, EM_ESCOPE_EO_REMOVE_QUEUE,
                        "Invalid notif cfg given!");
        RETURN_ERROR_IF(eo_elem != q_elem->eo_elem,
                        EM_ERR_BAD_POINTER, EM_ESCOPE_EO_REMOVE_QUEUE,
                        "Can't remove Q:%" PRI_QUEUE ", not added to this EO",
                        queue);
 
        /*
         * Disable the queue if not already done, dispatcher will drop any
         * further events. Need to handle events from the queue being processed
         * in an EO receive function properly still.
         */
        if (q_elem->state == EM_QUEUE_STATE_READY) {
                ret = queue_disable(q_elem);
 
                RETURN_ERROR_IF(ret != EM_OK, ret, EM_ESCOPE_EO_REMOVE_QUEUE,
                                "queue_disable(Q:%" PRI_QUEUE ") fails",
                                queue);
        }
 
        /*
         * Request each core to run locally the eo_remove_queue_local() function
         * and when all are done call eo_remove_queue_done_callback().
         * The callback will finally remove the queue from the EO when it's
         * known that no core is anymore processing events from that EO/queue.
         */
        int reqs_sent = eo_remove_queue_local_req(eo_elem, q_elem, num_notif, notif_tbl);
 
        RETURN_ERROR_IF(reqs_sent < 0, EM_ERR_OPERATION_FAILED, EM_ESCOPE_EO_REMOVE_QUEUE,
                        "EO:%" PRI_EO " eo_remove_queue_local_req():%d", eo, reqs_sent);
 
        if (reqs_sent == 0) {
                /*
                 * No cores to process the request, e.g. all EM-cores (worker or
                 * control) have been terminated and tear down is done by an
                 * EM external thread/process. Remove the queue from the EO.
                 */
                ret = eo_rem_queue(eo_elem, q_elem);
                RETURN_ERROR_IF(ret != EM_OK, ret, EM_ESCOPE_EO_REMOVE_QUEUE_DONE_CB,
                                "EO:%" PRI_EO " remove Q:%" PRI_QUEUE " failed",
                                eo, queue);
        }
 
        return EM_OK;
}
 
em_status_t
em_eo_remove_queue_sync(em_eo_t eo, em_queue_t queue)
{
        em_locm_t *const locm = &em_locm;
        eo_elem_t *const eo_elem = eo_elem_get(eo);
        queue_elem_t *const q_elem = queue_elem_get(queue);
        em_queue_type_t q_type;
        em_status_t ret;
        int valid;
 
        RETURN_ERROR_IF(eo_elem == NULL || q_elem == NULL,
                        EM_ERR_BAD_ARG, EM_ESCOPE_EO_REMOVE_QUEUE_SYNC,
                        "Invalid args: EO:%" PRI_EO " Q:%" PRI_QUEUE "",
                        eo, queue);
        RETURN_ERROR_IF(!eo_allocated(eo_elem) || !queue_allocated(q_elem),
                        EM_ERR_NOT_CREATED, EM_ESCOPE_EO_REMOVE_QUEUE_SYNC,
                        "Not created: EO:%" PRI_EO " Q:%" PRI_QUEUE "",
                        eo, queue);
 
        q_type = em_queue_type(queue);
        valid = q_type == EM_QUEUE_TYPE_ATOMIC ||
                q_type == EM_QUEUE_TYPE_PARALLEL ||
                q_type == EM_QUEUE_TYPE_ORDERED ||
                q_type == EM_QUEUE_TYPE_LOCAL;
        RETURN_ERROR_IF(!valid, EM_ERR_BAD_TYPE,
                        EM_ESCOPE_EO_REMOVE_QUEUE_SYNC,
                        "Invalid queue type: %" PRI_QTYPE "", q_type);
 
        RETURN_ERROR_IF(eo_elem != q_elem->eo_elem,
                        EM_ERR_BAD_POINTER, EM_ESCOPE_EO_REMOVE_QUEUE_SYNC,
                        "Can't remove Q:%" PRI_QUEUE ", not added to this EO",
                        queue);
 
        /* Mark that a sync-API call is in progress */
        locm->sync_api.in_progress = true;
 
        /*
         * Disable the queue if not already done, dispatcher will drop any
         * further events. Need to handle events from the queue being processed
         * in an EO receive function properly still.
         */
        if (q_elem->state == EM_QUEUE_STATE_READY) {
                ret = queue_disable(q_elem);
 
                if (unlikely(ret != EM_OK)) {
                        ret = INTERNAL_ERROR(ret, EM_ESCOPE_EO_REMOVE_QUEUE_SYNC,
                                             "queue_disable(Q:%" PRI_QUEUE ") failed", queue);
                        goto eo_remove_queue_sync_error;
                }
        }
 
        /*
         * Request each core to run locally the eo_remove_queue_sync_local() function
         * and when all are done call eo_remove_queue_sync_done_callback().
         * The callback will finally remove the queue from the EO when it's
         * known that no core is anymore processing events from that EO/queue.
         */
        int reqs_sent = eo_remove_queue_sync_local_req(eo_elem, q_elem);
 
        if (unlikely(reqs_sent < 0)) {
                ret = INTERNAL_ERROR(EM_ERR_OPERATION_FAILED, EM_ESCOPE_EO_REMOVE_QUEUE,
                                     "EO:%" PRI_EO " eo_remove_queue_sync_local_req():%d",
                                     eo, reqs_sent);
                goto eo_remove_queue_sync_error;
        }
 
        if (likely(reqs_sent > 0)) {
                /*
                 * Poll the core-local unscheduled control-queue for events.
                 * These events request the core to do a core-local operation (or nop).
                 * Poll and handle events until 'locm->sync_api.in_progress == false'
                 * indicating that this sync-API is 'done' on all concerned cores.
                 */
                while (locm->sync_api.in_progress)
                        poll_unsched_ctrl_queue();
        } else if (reqs_sent == 0) {
                /*
                 * No cores to process the request, e.g. all EM-cores (worker or
                 * control) have been terminated and tear down is done by an
                 * EM external thread/process. Remove the queue from the EO.
                 */
                ret = eo_rem_queue(eo_elem, q_elem);
 
                if (unlikely(ret != EM_OK)) {
                        ret = INTERNAL_ERROR(ret, EM_ESCOPE_EO_REMOVE_QUEUE,
                                             "EO:%" PRI_EO " Q:%" PRI_QUEUE " eo_rem_queue() fails",
                                             eo, queue);
                        goto eo_remove_queue_sync_error;
                }
        }
 
        return EM_OK;
 
eo_remove_queue_sync_error:
        locm->sync_api.in_progress = false;
 
        return ret;
}
 
em_status_t
em_eo_remove_queue_all(em_eo_t eo, int delete_queues,
                       int num_notif, const em_notif_t notif_tbl[])
{
        eo_elem_t *const eo_elem = eo_elem_get(eo);
        em_status_t ret;
 
        RETURN_ERROR_IF(eo_elem == NULL, EM_ERR_BAD_ARG,
                        EM_ESCOPE_EO_REMOVE_QUEUE_ALL,
                        "Invalid EO:%" PRI_EO "", eo);
        RETURN_ERROR_IF(!eo_allocated(eo_elem), EM_ERR_NOT_CREATED,
                        EM_ESCOPE_EO_REMOVE_QUEUE_ALL,
                        "EO:%" PRI_EO " not created", eo);
        ret = check_notif_tbl(num_notif, notif_tbl);
        RETURN_ERROR_IF(ret != EM_OK, ret, EM_ESCOPE_EO_REMOVE_QUEUE_ALL,
                        "Invalid notif cfg given!");
 
        ret = queue_disable_all(eo_elem);
        RETURN_ERROR_IF(ret != EM_OK, ret, EM_ESCOPE_EO_REMOVE_QUEUE_ALL,
                        "queue_disable_all() failed!");
 
        /*
         * Request each core to run locally the eo_remove_queue_all_local() function
         * and when all are done call eo_remove_queue_all_done_callback().
         * The callback will finally remove the queue from the EO when it's
         * known that no core is anymore processing events from that EO/queue.
         */
        int reqs_sent = eo_remove_queue_all_local_req(eo_elem, delete_queues,
                                                      num_notif, notif_tbl);
        RETURN_ERROR_IF(reqs_sent < 0, EM_ERR_OPERATION_FAILED,
                        EM_ESCOPE_EO_REMOVE_QUEUE_ALL,
                        "EO:%" PRI_EO " eo_remove_queue_all_local_req():%d",
                        eo, reqs_sent);
 
        if (reqs_sent == 0) {
                /*
                 * No cores to process the request, e.g. all EM-cores (worker or
                 * control) have been terminated and tear down is done by an
                 * EM external thread/process.
                 * Remove or delete all the EO's queues.
                 */
                if (delete_queues)
                        ret = eo_delete_queue_all(eo_elem);
                else
                        ret = eo_rem_queue_all(eo_elem);
 
                RETURN_ERROR_IF(ret != EM_OK, ret, EM_ESCOPE_EO_REMOVE_QUEUE_ALL,
                                "EO:%" PRI_EO " remove all queues failed", eo);
        }
 
        return EM_OK;
}
 
em_status_t
em_eo_remove_queue_all_sync(em_eo_t eo, int delete_queues)
{
        em_locm_t *const locm = &em_locm;
        eo_elem_t *const eo_elem = eo_elem_get(eo);
        em_status_t ret;
 
        RETURN_ERROR_IF(eo_elem == NULL, EM_ERR_BAD_ARG,
                        EM_ESCOPE_EO_REMOVE_QUEUE_ALL_SYNC,
                        "Invalid EO:%" PRI_EO "", eo);
        RETURN_ERROR_IF(!eo_allocated(eo_elem), EM_ERR_NOT_CREATED,
                        EM_ESCOPE_EO_REMOVE_QUEUE_ALL_SYNC,
                        "EO:%" PRI_EO " not created", eo);
 
        /* Mark that a sync-API call is in progress */
        locm->sync_api.in_progress = true;
 
        ret = queue_disable_all(eo_elem);
        if (unlikely(ret != EM_OK)) {
                ret = INTERNAL_ERROR(ret, EM_ESCOPE_EO_REMOVE_QUEUE_ALL_SYNC,
                                     "queue_disable_all() failed!");
                goto eo_remove_queue_all_sync_error;
        }
 
        /*
         * Request each core to run locally the eo_remove_queue_all_sync_local() function
         * and when all are done call eo_remove_queue_all_sync_done_callback().
         * The callback will finally remove the queue from the EO when it's
         * known that no core is anymore processing events from that EO/queue.
         */
        int reqs_sent = eo_remove_queue_all_sync_local_req(eo_elem, delete_queues);
 
        if (unlikely(reqs_sent < 0)) {
                ret = INTERNAL_ERROR(EM_ERR_OPERATION_FAILED, EM_ESCOPE_EO_REMOVE_QUEUE_ALL_SYNC,
                                     "EO:%" PRI_EO " eo_remove_queue_all_sync_local_req():%d",
                                     eo, reqs_sent);
                goto eo_remove_queue_all_sync_error;
        }
 
        if (likely(reqs_sent > 0)) {
                /*
                 * Poll the core-local unscheduled control-queue for events.
                 * These events request the core to do a core-local operation (or nop).
                 * Poll and handle events until 'locm->sync_api.in_progress == false'
                 * indicating that this sync-API is 'done' on all concerned cores.
                 */
                while (locm->sync_api.in_progress)
                        poll_unsched_ctrl_queue();
        } else if (reqs_sent == 0) {
                /*
                 * No cores to process the request, e.g. all EM-cores (worker or
                 * control) have been terminated and tear down is done by an
                 * EM external thread/process.
                 * Remove or delete all the EO's queues.
                 */
                if (delete_queues)
                        ret = eo_delete_queue_all(eo_elem);
                else
                        ret = eo_rem_queue_all(eo_elem);
 
                if (unlikely(ret != EM_OK)) {
                        ret = INTERNAL_ERROR(ret, EM_ESCOPE_EO_REMOVE_QUEUE_ALL_SYNC_DONE_CB,
                                             "EO:%" PRI_EO " removing all queues failed", eo);
                        goto eo_remove_queue_all_sync_error;
                }
        }
 
        return EM_OK;
 
eo_remove_queue_all_sync_error:
        locm->sync_api.in_progress = false;
 
        return ret;
}
 
em_status_t
em_eo_register_error_handler(em_eo_t eo, em_error_handler_t handler)
{
        eo_elem_t *const eo_elem = eo_elem_get(eo);
 
        RETURN_ERROR_IF(eo_elem == NULL || handler == NULL,
                        EM_ERR_BAD_ARG, EM_ESCOPE_EO_REGISTER_ERROR_HANDLER,
                        "Invalid args: EO:%" PRI_EO " handler:%p", eo, handler);
        RETURN_ERROR_IF(!eo_allocated(eo_elem),
                        EM_ERR_NOT_CREATED, EM_ESCOPE_EO_REGISTER_ERROR_HANDLER,
                        "EO:%" PRI_EO " not created", eo);
 
        odp_ticketlock_lock(&eo_elem->lock);
        eo_elem->error_handler_func = handler;
        odp_ticketlock_unlock(&eo_elem->lock);
 
        return EM_OK;
}
 
em_status_t
em_eo_unregister_error_handler(em_eo_t eo)
{
        eo_elem_t *const eo_elem = eo_elem_get(eo);
 
        RETURN_ERROR_IF(eo_elem == NULL, EM_ERR_BAD_ARG,
                        EM_ESCOPE_EO_UNREGISTER_ERROR_HANDLER,
                        "Invalid EO id %" PRI_EO "", eo);
        RETURN_ERROR_IF(!eo_allocated(eo_elem), EM_ERR_NOT_CREATED,
                        EM_ESCOPE_EO_UNREGISTER_ERROR_HANDLER,
                        "EO not created:%" PRI_EO "", eo);
 
        odp_ticketlock_lock(&eo_elem->lock);
        eo_elem->error_handler_func = NULL;
        odp_ticketlock_unlock(&eo_elem->lock);
 
        return EM_OK;
}
 
em_status_t
em_eo_start(em_eo_t eo, em_status_t *result, const em_eo_conf_t *conf,
            int num_notif, const em_notif_t notif_tbl[])
{
        em_locm_t *const locm = &em_locm;
        eo_elem_t *const eo_elem = eo_elem_get(eo);
        queue_elem_t *const save_q_elem = locm->current.q_elem;
        queue_elem_t tmp_q_elem;
        em_status_t ret;
 
        RETURN_ERROR_IF(eo_elem == NULL, EM_ERR_BAD_ARG, EM_ESCOPE_EO_START,
                        "Invalid EO id %" PRI_EO "", eo);
        RETURN_ERROR_IF(!eo_allocated(eo_elem),
                        EM_ERR_NOT_CREATED, EM_ESCOPE_EO_START,
                        "EO not created:%" PRI_EO "", eo);
        RETURN_ERROR_IF(eo_elem->state != EM_EO_STATE_CREATED,
                        EM_ERR_BAD_STATE, EM_ESCOPE_EO_START,
                        "EO invalid state, cannot start:%d", eo_elem->state);
        ret = check_notif_tbl(num_notif, notif_tbl);
        RETURN_ERROR_IF(ret != EM_OK, ret, EM_ESCOPE_EO_START,
                        "Invalid notif cfg given!");
 
        eo_elem->state = EM_EO_STATE_STARTING;
 
        /* Create a stash to buffer events sent during EO-start */
        eo_elem->stash = eo_start_stash_create();
        if (unlikely(eo_elem->stash == ODP_STASH_INVALID)) {
                ret = INTERNAL_ERROR(EM_ERR_LIB_FAILED, EM_ESCOPE_EO_START,
                                     "EO:%" PRI_EO " start stash creation fails", eo);
                goto eo_start_error;
        }
        /* This core is in the EO start function: buffer all sent events */
        locm->start_eo_elem = eo_elem;
        /*
         * Use a tmp q_elem as the 'current q_elem' to enable calling
         * em_eo_current() from the EO start functions.
         * Before returning, restore the original 'current q_elem' from
         * 'save_q_elem'.
         */
        memset(&tmp_q_elem, 0, sizeof(tmp_q_elem));
        tmp_q_elem.eo = (uint16_t)(uintptr_t)eo;
 
        locm->current.q_elem = &tmp_q_elem;
        /* Call the global EO start function */
        ret = eo_elem->start_func(eo_elem->eo_ctx, eo, conf);
        /* Restore the original 'current q_elem' */
        locm->current.q_elem = save_q_elem;
        locm->start_eo_elem = NULL;
 
        /* Store the return value of the actual EO global start function */
        if (result != NULL)
                *result = ret;
 
        if (unlikely(ret != EM_OK)) {
                ret = INTERNAL_ERROR(EM_ERR, EM_ESCOPE_EO_START,
                                     "EO:%" PRI_EO " start func failed:%" PRIxSTAT "",
                                     eo, ret);
                /* user error handler might change error from own eo-start */
                if (ret != EM_OK)
                        goto eo_start_error;
        }
 
        if (eo_elem->start_local_func != NULL) {
                /*
                 * Notifications sent when the local start functions
                 * have completed.
                 */
                int reqs_sent = eo_start_local_req(eo_elem, num_notif, notif_tbl);
 
                if (unlikely(reqs_sent < 0)) {
                        ret = EM_ERR_OPERATION_FAILED;
                        INTERNAL_ERROR(ret, EM_ESCOPE_EO_START,
                                       "EO:%" PRI_EO " eo_start_local_req():%d",
                                       eo, reqs_sent);
                        /* Can't allow user err handler to change error here */
                        goto eo_start_error;
                }
 
                /*
                 * Note: Return here, queues will be enabled after the local
                 * start funcs complete.
                 * EO state changed to 'EM_EO_STATE_RUNNING' after successful
                 * completion of EO local starts on all cores.
                 */
                if (reqs_sent > 0)
                        return EM_OK;
                /*
                 * If req_sent == 0, then no EM-cores (worker or control) were
                 * yet running, e.g. an EM external thread started the EO.
                 */
        }
 
        /*
         * Enable all the EO's queues.
         * Note: if local start functions are given then enable can be done only
         *       after they have been run on each core.
         */
        ret = queue_enable_all(eo_elem);
        if (unlikely(ret != EM_OK)) {
                ret = INTERNAL_ERROR(ret, EM_ESCOPE_EO_START,
                                     "EO:%" PRI_EO " queue_enable_all() failed", eo);
                goto eo_start_error;
        }
 
        eo_elem->state = EM_EO_STATE_RUNNING;
 
        /* Send events buffered during the EO-start/local-start functions */
        eo_start_send_buffered_events(eo_elem);
 
        if (num_notif > 0) {
                /* Send notifications if requested */
                ret = send_notifs(num_notif, notif_tbl);
 
                if (unlikely(ret != EM_OK)) {
                        ret = INTERNAL_ERROR(ret, EM_ESCOPE_EO_START,
                                             "EO:%" PRI_EO " send notif fails", eo);
                        /* user error handler might change error */
                        if (ret != EM_OK)
                                goto eo_start_error;
                }
        }
 
        return EM_OK;
 
eo_start_error:
        /* roll back state to allow EO delete */
        eo_elem->state = EM_EO_STATE_ERROR;
        return ret;
}
 
em_status_t
em_eo_start_sync(em_eo_t eo, em_status_t *result, const em_eo_conf_t *conf)
{
        em_locm_t *const locm = &em_locm;
        eo_elem_t *const eo_elem = eo_elem_get(eo);
        queue_elem_t *const save_q_elem = locm->current.q_elem;
        queue_elem_t tmp_q_elem;
        em_status_t ret;
 
        RETURN_ERROR_IF(eo_elem == NULL, EM_ERR_BAD_ARG, EM_ESCOPE_EO_START_SYNC,
                        "Invalid EO id %" PRI_EO "", eo);
        RETURN_ERROR_IF(!eo_allocated(eo_elem),
                        EM_ERR_NOT_CREATED, EM_ESCOPE_EO_START_SYNC,
                        "EO not created:%" PRI_EO "", eo);
        RETURN_ERROR_IF(eo_elem->state != EM_EO_STATE_CREATED,
                        EM_ERR_BAD_STATE, EM_ESCOPE_EO_START_SYNC,
                        "EO invalid state, cannot start:%d", eo_elem->state);
 
        eo_elem->state = EM_EO_STATE_STARTING;
 
        /* Create a stash to buffer events sent during EO-start */
        eo_elem->stash = eo_start_stash_create();
        if (unlikely(eo_elem->stash == ODP_STASH_INVALID)) {
                ret = INTERNAL_ERROR(EM_ERR_LIB_FAILED, EM_ESCOPE_EO_START_SYNC,
                                     "EO:%" PRI_EO " start stash creation fails", eo);
                /* roll back state to allow EO delete */
                eo_elem->state = EM_EO_STATE_ERROR;
                return ret;
        }
        /* This core is in the EO start function: buffer all sent events */
        locm->start_eo_elem = eo_elem;
        /*
         * Use a tmp q_elem as the 'current q_elem' to enable calling
         * em_eo_current() from the EO start functions.
         * Before returning, restore the original 'current q_elem' from
         * 'save_q_elem'.
         */
        memset(&tmp_q_elem, 0, sizeof(tmp_q_elem));
        tmp_q_elem.eo = (uint16_t)(uintptr_t)eo;
        locm->current.q_elem = &tmp_q_elem;
        /* Call the global EO start function */
        ret = eo_elem->start_func(eo_elem->eo_ctx, eo, conf);
        /* Restore the original 'current q_elem' */
        locm->current.q_elem = save_q_elem;
        locm->start_eo_elem = NULL;
 
        /* Store the return value of the actual EO global start function */
        if (result != NULL)
                *result = ret;
 
        if (unlikely(ret != EM_OK)) {
                ret = INTERNAL_ERROR(EM_ERR, EM_ESCOPE_EO_START_SYNC,
                                     "EO:%" PRI_EO " start func failed:%" PRIxSTAT "",
                                     eo, ret);
                /* user error handler might change error from own eo-start */
                if (ret != EM_OK) {
                        /* roll back state to allow EO delete */
                        eo_elem->state = EM_EO_STATE_ERROR;
                        return ret;
                }
        }
 
        if (eo_elem->start_local_func) {
                int reqs_sent = eo_start_sync_local_req(eo_elem);
 
                if (unlikely(reqs_sent < 0)) {
                        ret = INTERNAL_ERROR(EM_ERR_OPERATION_FAILED, EM_ESCOPE_EO_START_SYNC,
                                             "EO:%" PRI_EO " eo_start_sync_local_req():%d",
                                             eo, reqs_sent);
                        /* Can't allow user err handler to change error here */
                        goto eo_start_sync_error;
                }
 
                if (reqs_sent > 0) {
                        /* Mark that a sync-API call is in progress */
                        locm->sync_api.in_progress = true;
                        /*
                         * Poll the core-local unscheduled control-queue for events.
                         * These events request the core to do a core-local operation (or nop).
                         * Poll and handle events until 'locm->sync_api.in_progress == false'
                         * indicating that this sync-API is 'done' on all concerned cores.
                         */
                        while (locm->sync_api.in_progress)
                                poll_unsched_ctrl_queue();
 
                        /* Send events buffered during the EO-start/local-start funcs */
                        eo_start_send_buffered_events(eo_elem);
                        /*
                         * EO state changed to 'EO_STATE_RUNNING' after successful
                         * completion of EO local starts on all cores.
                         */
                        return EM_OK;
                }
                /*
                 * If req_sent == 0, then no EM-cores (worker or control) were
                 * yet running, e.g. an EM external thread started the EO.
                 */
        }
 
        /*
         * Enable all the EO's queues.
         * Note: if local start functions are given then enable can be done only
         *       after they have been run on each core.
         */
        ret = queue_enable_all(eo_elem);
        if (unlikely(ret != EM_OK)) {
                ret = INTERNAL_ERROR(ret, EM_ESCOPE_EO_START_SYNC,
                                     "EO:%" PRI_EO " queue_enable_all() failed", eo);
                goto eo_start_sync_error;
        }
 
        eo_elem->state = EM_EO_STATE_RUNNING;
 
        /* Send events buffered during the EO-start/local-start functions */
        eo_start_send_buffered_events(eo_elem);
        return EM_OK;
 
eo_start_sync_error:
        locm->sync_api.in_progress = false;
        /* roll back state to allow EO delete */
        eo_elem->state = EM_EO_STATE_ERROR;
        return ret;
}
 
em_status_t
em_eo_stop(em_eo_t eo, int num_notif, const em_notif_t notif_tbl[])
{
        eo_elem_t *const eo_elem = eo_elem_get(eo);
        em_status_t ret;
 
        RETURN_ERROR_IF(eo_elem == NULL || !eo_allocated(eo_elem),
                        EM_ERR_BAD_ARG, EM_ESCOPE_EO_STOP,
                        "Invalid EO:%" PRI_EO "", eo);
        RETURN_ERROR_IF(eo_elem->state != EM_EO_STATE_RUNNING,
                        EM_ERR_BAD_STATE, EM_ESCOPE_EO_STOP,
                        "EO invalid state, cannot stop:%d", eo_elem->state);
        ret = check_notif_tbl(num_notif, notif_tbl);
        RETURN_ERROR_IF(ret != EM_OK, ret, EM_ESCOPE_EO_STOP,
                        "Invalid notif cfg given!");
 
        eo_elem->state = EM_EO_STATE_STOPPING;
 
        /*
         * Disable all queues.
         * It doesn't matter if some of the queues are already disabled.
         */
        queue_disable_all(eo_elem);
 
        /*
         * Notifications sent when the local stop functions
         * have completed. EO global stop called when all local stops have
         * been completed. EO state changed to 'stopped' only after completing
         * the EO global stop function.
         */
        int reqs_sent = eo_stop_local_req(eo_elem, num_notif, notif_tbl);
 
        if (unlikely(reqs_sent < 0)) {
                eo_elem->state = EM_EO_STATE_ERROR;
                ret = INTERNAL_ERROR(EM_ERR_OPERATION_FAILED, EM_ESCOPE_EO_STOP,
                                     "EO:%" PRI_EO " eo_stop_local_req():%d",
                                     eo, reqs_sent);
                /* Can't allow user err handler to change error here */
                return ret;
        } else if (unlikely(reqs_sent == 0)) {
                /*
                 * If req_sent == 0, then no EM-cores (worker or control) were
                 * running, e.g. an EM external thread stopped the EO after all EM-cores
                 * were removed. Run the EO global stop function and change state.
                 */
                ret = eo_stop_done(eo_elem);
 
                /*
                 * Note: the EO might not be available after this if the EO global stop
                 * called em_eo_delete()!
                 */
                RETURN_ERROR_IF(ret != EM_OK, EM_ERR, EM_ESCOPE_EO_STOP,
                                "EO:%" PRI_EO " stop-func failed:%" PRI_STAT "", eo, ret);
        }
 
        return EM_OK;
}
 
em_status_t
em_eo_stop_sync(em_eo_t eo)
{
        em_locm_t *const locm = &em_locm;
        eo_elem_t *const eo_elem = eo_elem_get(eo);
        em_status_t ret;
 
        RETURN_ERROR_IF(eo_elem == NULL || !eo_allocated(eo_elem),
                        EM_ERR_BAD_ARG, EM_ESCOPE_EO_STOP_SYNC,
                        "Invalid EO:%" PRI_EO "", eo);
        RETURN_ERROR_IF(eo_elem->state != EM_EO_STATE_RUNNING,
                        EM_ERR_BAD_STATE, EM_ESCOPE_EO_STOP_SYNC,
                        "EO invalid state, cannot stop:%d", eo_elem->state);
 
        /* Mark that a sync-API call is in progress */
        locm->sync_api.in_progress = true;
 
        eo_elem->state = EM_EO_STATE_STOPPING;
 
        /*
         * Disable all queues.
         * It doesn't matter if some of the queues are already disabled.
         */
        ret = queue_disable_all(eo_elem);
        if (unlikely(ret != EM_OK))
                goto eo_stop_sync_error;
 
        /*
         * Notifications sent when the local stop functions have completed.
         * EO global stop called when all local stops have been completed.
         * EO state changed to 'stopped' only after completing the EO global
         * stop function.
         */
        int reqs_sent = eo_stop_sync_local_req(eo_elem);
 
        if (unlikely(reqs_sent < 0)) {
                eo_elem->state = EM_EO_STATE_ERROR;
                ret = INTERNAL_ERROR(EM_ERR_OPERATION_FAILED, EM_ESCOPE_EO_STOP_SYNC,
                                     "EO:%" PRI_EO " eo_stop_sync_local_req():%d",
                                     eo, reqs_sent);
                /* Can't allow user err handler to change error here */
                goto eo_stop_sync_error;
        }
 
        if (reqs_sent > 0) {
                /*
                 * Poll the core-local unscheduled control-queue for events.
                 * These events request the core to do a core-local operation (or nop).
                 * Poll and handle events until 'locm->sync_api.in_progress == false'
                 * indicating that this sync-API is 'done' on all concerned cores.
                 */
                while (locm->sync_api.in_progress)
                        poll_unsched_ctrl_queue();
        }
 
        /*
         * If req_sent == 0, then no EM-cores (worker or control) were
         * running, e.g. an EM external thread stopped the EO after all EM-cores
         * were removed. Run the EO global stop function and change state.
         */
        ret = eo_stop_done(eo_elem);
 
        RETURN_ERROR_IF(ret != EM_OK, ret, EM_ESCOPE_EO_STOP_SYNC,
                        "EO:%" PRI_EO " stop-func failed", eo);
        /*
         * Note: the EO might not be available after this if the EO global stop
         * called em_eo_delete()!
         */
        return EM_OK;
 
eo_stop_sync_error:
        locm->sync_api.in_progress = false;
        return INTERNAL_ERROR(ret, EM_ESCOPE_EO_STOP_SYNC,
                              "Failure: EO:%" PRI_EO "", eo);
}
 
em_eo_t em_eo_current(void)
{
        return eo_current();
}
 
void *em_eo_context(em_eo_t eo)
{
        const eo_elem_t *eo_elem = eo_elem_get(eo);
        em_eo_state_t eo_state;
 
        if (unlikely(EM_CHECK_LEVEL > 0 && eo_elem == NULL)) {
                INTERNAL_ERROR(EM_ERR_BAD_ARG, EM_ESCOPE_EO_CONTEXT,
                               "Invalid EO:%" PRI_EO "", eo);
                return NULL;
        }
 
        if (unlikely(EM_CHECK_LEVEL >= 2 && !eo_allocated(eo_elem))) {
                INTERNAL_ERROR(EM_ERR_NOT_CREATED, EM_ESCOPE_EO_CONTEXT,
                               "EO:%" PRI_EO " not created!", eo);
                return NULL;
        }
 
        eo_state = eo_elem->state;
        if (unlikely(EM_CHECK_LEVEL > 0 && eo_state < EM_EO_STATE_CREATED)) {
                INTERNAL_ERROR(EM_ERR_BAD_STATE, EM_ESCOPE_EO_CONTEXT,
                               "Invalid EO state: EO:%" PRI_EO " state:%d",
                                eo, eo_state);
                return NULL;
        }
 
        return eo_elem->eo_ctx;
}
 
em_eo_state_t em_eo_state(em_eo_t eo)
{
        const eo_elem_t *eo_elem = eo_elem_get(eo);
 
        if (unlikely(EM_CHECK_LEVEL > 0 && eo_elem == NULL)) {
                INTERNAL_ERROR(EM_ERR_BAD_ARG, EM_ESCOPE_EO_STATE,
                               "Invalid EO:%" PRI_EO "", eo);
                return EM_EO_STATE_UNDEF;
        }
 
        if (unlikely(EM_CHECK_LEVEL >= 2 && !eo_allocated(eo_elem))) {
                INTERNAL_ERROR(EM_ERR_NOT_CREATED, EM_ESCOPE_EO_STATE,
                               "EO:%" PRI_EO " not created", eo);
                return EM_EO_STATE_UNDEF;
        }
 
        return eo_elem->state;
}
 
em_eo_t em_eo_first(unsigned int *num)
{
        _eo_tbl_iter_idx = 0; /* reset iteration */
        const unsigned int eo_cnt = eo_count();
 
        if (num)
                *num = eo_cnt;
 
        if (eo_cnt == 0) {
                _eo_tbl_iter_idx = EM_MAX_EOS; /* UNDEF = _next() */
                return EM_EO_UNDEF;
        }
 
        /* find first */
        while (!eo_allocated(&em_shm->eo_tbl.eo_elem[_eo_tbl_iter_idx])) {
                _eo_tbl_iter_idx++;
                if (_eo_tbl_iter_idx >= EM_MAX_EOS)
                        return EM_EO_UNDEF;
        }
 
        return eo_idx2hdl(_eo_tbl_iter_idx);
}
 
em_eo_t em_eo_next(void)
{
        if (_eo_tbl_iter_idx >= EM_MAX_EOS - 1)
                return EM_EO_UNDEF;
 
        _eo_tbl_iter_idx++;
 
        /* find next */
        while (!eo_allocated(&em_shm->eo_tbl.eo_elem[_eo_tbl_iter_idx])) {
                _eo_tbl_iter_idx++;
                if (_eo_tbl_iter_idx >= EM_MAX_EOS)
                        return EM_EO_UNDEF;
        }
 
        return eo_idx2hdl(_eo_tbl_iter_idx);
}
 
em_queue_t em_eo_queue_first(unsigned int *num, em_eo_t eo)
{
        eo_elem_t *eo_elem = eo_elem_get(eo);
        const unsigned int max_queues = em_shm->queue_tbl.max_queue_num;
 
        if (unlikely(eo_elem == NULL || !eo_allocated(eo_elem))) {
                INTERNAL_ERROR(EM_ERR_BAD_ARG, EM_ESCOPE_EO_QUEUE_FIRST,
                               "Invalid EO:%" PRI_EO "", eo);
                if (num)
                        *num = 0;
                return EM_QUEUE_UNDEF;
        }
 
        const unsigned int num_queues = odp_atomic_load_u32(&eo_elem->num_queues);
 
        if (num)
                *num = num_queues;
 
        if (num_queues == 0) {
                _eo_q_iter_idx = max_queues; /* UNDEF = _next() */
                return EM_QUEUE_UNDEF;
        }
 
        /*
         * An 'eo_elem' contains a linked list with all it's queues. That list
         * might be modified while processing this iteration, so instead we just
         * go through the whole queue table.
         * This is potentially a slow implementation and perhaps worth
         * re-thinking?
         */
        const queue_tbl_t *const queue_tbl = &em_shm->queue_tbl;
 
        _eo_q_iter_idx = 0; /* reset list */
        _eo_q_iter_eo = eo;
 
        /* find first */
        while (!queue_allocated(&queue_tbl->queue_elem[_eo_q_iter_idx]) ||
               queue_tbl->queue_elem[_eo_q_iter_idx].eo != (uint16_t)(uintptr_t)_eo_q_iter_eo) {
                _eo_q_iter_idx++;
                if (_eo_q_iter_idx >= max_queues)
                        return EM_QUEUE_UNDEF;
        }
 
        return queue_idx2hdl(_eo_q_iter_idx);
}
 
em_queue_t em_eo_queue_next(void)
{
        const unsigned int max_queues = em_shm->queue_tbl.max_queue_num;
 
        if (_eo_q_iter_idx >= max_queues - 1)
                return EM_QUEUE_UNDEF;
 
        _eo_q_iter_idx++;
 
        const queue_tbl_t *const queue_tbl = &em_shm->queue_tbl;
 
        /* find next */
        while (!queue_allocated(&queue_tbl->queue_elem[_eo_q_iter_idx]) ||
               queue_tbl->queue_elem[_eo_q_iter_idx].eo != (uint16_t)(uintptr_t)_eo_q_iter_eo) {
                _eo_q_iter_idx++;
                if (_eo_q_iter_idx >= max_queues)
                        return EM_QUEUE_UNDEF;
        }
 
        return queue_idx2hdl(_eo_q_iter_idx);
}
 
uint64_t em_eo_to_u64(em_eo_t eo)
{
        return (uint64_t)eo;
}