RTI Routing Service
Version 5.1.0
|
Routing Service can be deployed as a C library linked into your application in select architectures. More...
Data Structures | |
struct | RTI_RoutingServiceTransportConfig |
Association between a transport alias and its create function pointer. More... | |
struct | RTI_RoutingServiceProperty |
Configuration of RTI Routing Service. More... | |
Functions | |
struct RTI_RoutingService * | RTI_RoutingService_new (struct RTI_RoutingServiceProperty *property) |
Create a new RTI Routing Service instance. | |
void | RTI_RoutingService_delete (struct RTI_RoutingService *self) |
Stop and delete an RTI Routing Service instance. | |
DDS_Boolean | RTI_RoutingService_start (struct RTI_RoutingService *self) |
Start RTI Routing Service. | |
DDS_Boolean | RTI_RoutingService_stop (struct RTI_RoutingService *self) |
Stop RTI Routing Service. | |
DDS_Boolean | RTI_RoutingService_attach_adapter_plugin (struct RTI_RoutingService *self, void *adapter, const char *plugin_name) |
Attach an adapter to be used by routing service when it is started. | |
Variables | |
struct RTI_RoutingServiceProperty | RTI_RoutingServiceProperty_INITIALIZER |
The initial values for an RTI_RoutingServiceProperty instance. | |
const int | RTI_ROUTING_SERVICE_LOG_VERBOSITY_INFO |
Verbosity level: exceptions + warnings + info. | |
const int | RTI_ROUTING_SERVICE_LOG_VERBOSITY_WARNINGS |
Verbosity level: exceptions + warnings. | |
const int | RTI_ROUTING_SERVICE_LOG_VERBOSITY_EXCEPTIONS |
Verbosity level: exceptions. | |
const int | RTI_ROUTING_SERVICE_LOG_VERBOSITY_SILENT |
Verbosity level: silent. | |
Routing Service can be deployed as a C library linked into your application in select architectures.
This API allows you to create, configure and start RTI Routing Service instances from your application.
The following code shows the typical use of the API:
Instead of a file, you can use XML strings to configure RTI Routing Service. See RTI_RoutingServiceProperty for more information.
To build your application you need to link with the RTI Routing Service library in <RTI Routing Service home>/bin/<architecture>/
If you are using the C API on a Windows or INTEGRITY platform: See the example in <RTI Routing Service home>/example/wrapperApp
|
read |
Create a new RTI Routing Service instance.
property | The properties to configure RTI Routing Service. This parameter is copied internally, so the user is responsible for releasing any memory allocated inside this structure. |
void RTI_RoutingService_delete | ( | struct RTI_RoutingService * | self | ) |
Stop and delete an RTI Routing Service instance.
self | An RTI_RoutingService instance created with RTI_RoutingService_new |
DDS_Boolean RTI_RoutingService_start | ( | struct RTI_RoutingService * | self | ) |
Start RTI Routing Service.
This is a non-blocking operation. RTI Routing Service will create its own set of threads to perform its tasks.
self | An RTI_RoutingService instance created with RTI_RoutingService_new |
DDS_Boolean RTI_RoutingService_stop | ( | struct RTI_RoutingService * | self | ) |
Stop RTI Routing Service.
This functions won't return the execution control until the instance is fully stopped.
self | An RTI_RoutingService instance created with RTI_RoutingService_new |
DDS_Boolean RTI_RoutingService_attach_adapter_plugin | ( | struct RTI_RoutingService * | self, |
void * | adapter, | ||
const char * | plugin_name | ||
) |
Attach an adapter to be used by routing service when it is started.
By using this function an adapter can be statically compiled, created in your application and have routing service load it, instead of registering a shared library and a create function in the configuration. The name passed in this function is the name that has to be used in the configuration to instantiate connections from the plugin.
Example:
And our configuration would look like this:
This function can be called as many times as desired to attach several plugins.
Note: The RTI Routing Service Adapter SDK is required.
self | An RTI_RoutingService instance not started yet (or stopped) |
adapter | The adapter plugin to be attached |
plugin_name | The name used for this plugin in the <connection> tags in the configuration. |
struct RTI_RoutingServiceProperty RTI_RoutingServiceProperty_INITIALIZER |
The initial values for an RTI_RoutingServiceProperty instance.
const int RTI_ROUTING_SERVICE_LOG_VERBOSITY_INFO |
Verbosity level: exceptions + warnings + info.
const int RTI_ROUTING_SERVICE_LOG_VERBOSITY_WARNINGS |
Verbosity level: exceptions + warnings.
const int RTI_ROUTING_SERVICE_LOG_VERBOSITY_EXCEPTIONS |
Verbosity level: exceptions.
const int RTI_ROUTING_SERVICE_LOG_VERBOSITY_SILENT |
Verbosity level: silent.