mco_iot_comm_listen

Create a socket and start listening on the specified IP address.

For an overview see page ARF Applications in C

Prototype

    MCO_RET mco_iot_comm_listen(mco_iot_comm_h comm,
                    const char *address,
                    mco_sock_params_t *params);

Arguments

comm
The communicator object.
address
The IP address ("iface:port" or "port") to listen on.
params
The socket parameters defined for network communication.

Description

This function creates a socket to listen on the specified IP address. The socket parameters params can be NULL in which case the sock_domain and ssl_params elements are taken from the communicator. Note that it is possible to create and listen on any number of sockets within a single communicator.

Return Codes

MCO_S_OK
Socket successfully created and listening started.
MCO_E_IOT_INVALID_HANDLE
The communicator handle comm is invalid.
MCO_E_NOMEM
Unable to allocate memory for internal structures.
MCO_E_NW_*
Network error: unable to parse the address, create the socket, bind the socket or listen on the socket.

Example

The code snippet below initializes the ARF (IoT) runtime, opens and connects the database, creates the communicator and replicator, then starts listening on port 15000:

    int main(int argc, char *argv[])
    {
        mco_db_params_t db_params;
        mco_device_t dev;
        mco_db_h db;
        mco_iot_replicator_params_t repl_params;
        mco_iot_comm_params_t comm_params;
        mco_iot_replicator_h repl;
        mco_iot_comm_h comm;
        const char *conn_string = (argc > 1) ? argv[1] : "127.0.0.1:15000";
        ...

        /* Initialize eXtremeDB and IoT runtimes */
        mco_error_set_handler(&sample_errhandler);
        mco_runtime_start();
        mco_iot_init();

        /* Create database */
        dev.type       = MCO_MEMORY_CONV;
        dev.assignment = MCO_MEMORY_ASSIGN_DATABASE;
        dev.size       = DEVICE_DATABASE_SIZE;
        dev.dev.conv.ptr = (void*)malloc(dev.size);
        mco_db_params_init(&db_params);
        db_params.db_max_connections = 5;

        if (argc > 2) {
            db_params.iot_agent_id = atoi(argv[2]); /* Override the agent_id in the schema */
        }
        CHECK(mco_db_open_dev(db_name, iotdevice_get_dictionary(), &dev, 1, &db_params));
        CHECK(mco_db_connect(db_name, &db));
        mco_iot_comm_params_init(&comm_params);
        CHECK(mco_iot_comm_create(&comm_params, &comm));
        mco_iot_replicator_params_init(&repl_params);
        CHECK(mco_iot_replicator_create(db, comm, &repl_params, &repl));
        ...
        CHECK(mco_iot_comm_listen(comm, "15000", 0));
        ...
    }

Files

Header file:
mcoiot.h
Source file:
mcoiotcomm.c
Library:
libmcoiotcomm.a