msgbus.h

Go to the documentation of this file.

// Copyright (c) 2019 Intel Corporation.
//
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to
// deal in the Software without restriction, including without limitation the
// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
// sell copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in
// all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
// FROM,OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
// IN THE SOFTWARE.
 
#ifndef _EII_MESSAGE_BUS_H
#define _EII_MESSAGE_BUS_H
 
#include <stdbool.h>
#include <stdint.h>
#include <time.h>
#include <eii/utils/config.h>
#include <eii/msgbus/msg_envelope.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef struct {
    void* data;
    void (*free)(void* data);
} user_data_t;
 
typedef struct {
    void* ctx;
    user_data_t* user_data;
} recv_ctx_t;
 
typedef struct {
    int size;
    int max_size;
    bool* tbl_ready;
    recv_ctx_t** tbl_ctxs;
} recv_ctx_set_t;
 
typedef void* publisher_ctx_t;
 
void* msgbus_initialize(config_t* config);
 
void msgbus_destroy(void* ctx);
 
msgbus_ret_t msgbus_publisher_new(
        void* ctx, const char* topic, publisher_ctx_t** pub_ctx);
 
msgbus_ret_t msgbus_publisher_publish(
        void* ctx, publisher_ctx_t* pub_ctx, msg_envelope_t* message);
 
void msgbus_publisher_destroy(void* ctx, publisher_ctx_t* pub_ctx);
 
msgbus_ret_t msgbus_subscriber_new(
        void* ctx, const char* topic, user_data_t* user_data,
        recv_ctx_t** subscriber);
 
void msgbus_recv_ctx_destroy(void* ctx, recv_ctx_t* recv_ctx);
 
msgbus_ret_t msgbus_request(
        void* ctx, recv_ctx_t* service_ctx, msg_envelope_t* message);
 
msgbus_ret_t msgbus_response(
        void* ctx, recv_ctx_t* service_ctx, msg_envelope_t* message);
 
msgbus_ret_t msgbus_service_get(
        void* ctx, const char* service_name, void* user_data,
        recv_ctx_t** service_ctx);
 
msgbus_ret_t msgbus_service_new(
        void* ctx, const char* service_name, void* user_data,
        recv_ctx_t** service_ctx);
 
msgbus_ret_t msgbus_recv_wait(
        void* ctx, recv_ctx_t* recv_ctx, msg_envelope_t** message);
 
msgbus_ret_t msgbus_recv_timedwait(
        void* ctx, recv_ctx_t* recv_ctx, int timeout,
        msg_envelope_t** message);
 
msgbus_ret_t msgbus_recv_nowait(
        void* ctx, recv_ctx_t* recv_ctx, msg_envelope_t** message);
 
#ifdef __cplusplus
} // extern "C"
#endif // __cpluspplus
 
#endif // _EII_MESSAGE_BUS_H