Library API

RTI Cloud Discovery Service can be deployed as a native library linked into your application in select architectures. More...

Data Structures
class	rti::cds::Service
	The RTI Cloud Discovery Service. More...
class	rti::cds::DomainListProperty
	Specifies the list of domain IDs to allow or deny. Overrides XML configuration if specified. More...
class	rti::cds::TransportUnicastProperty
	Specifies the alias name of the transport to be used by RTI Cloud Discovery Service for sending or receiving announcements. It also indicates the port where incoming participant announcements are received. Overrides XML configuration if specified. More...
class	rti::cds::ServiceProperty
	Configuration properties for a RTI Cloud Discovery Service object. More...

Detailed Description

RTI Cloud Discovery Service can be deployed as a native library linked into your application in select architectures.

This API allows you to create, configure and start RTI Cloud Discovery Service instances from your application.

The following code shows the typical use of the API:

int main ()
{
    rti::cds::Service service(
            rti::cds::ServiceProperty()
            .cfg_file("MyCloudDiscoveryService.xml")
            .service_name("MyCloudDiscoveryService"));
    ...
 
    service.start();
 
    while (keep_running) {
        sleep();
        ...
    }
 
    return 0;
}

Instead of a file, you can use XML strings to configure RTI Cloud Discovery Service. See ServiceProperty for more information.

To build your application you need to link with the RTI Cloud Discovery Service native library in <RTI Connext home>/bin/<architecture>/ .

An example is provided at https://github.com/rticommunity/rticonnextdds-examples/tree/release/7.3.0/examples/cloud_discovery_service/library_api.

Development Requirements

	Linux Systems	Windows Systems
Link Libraries (Compile Time)	librticlouddiscoveryservice.so	rticlouddiscoveryservice.dll
Shared Libraries (Run Time)	librtiroutingservice.so	rtiroutingservice.dll
	librtidlc.so	rtidlc.dll
	librticonnextmsgc.so	rticonnextmsgc.dll
	libnddsmetp.so	nddsmetp.dll
	librtiapputilsc.so	rtiapputilsc.dll
	librtixml2.so	rtixml2.dll
	libnddsc2.so	nddsc2.dll
	libnddsc.so	nddsc.dll
	libnddscore.so	nddscore.dll
Static Libraries	librticlouddiscoveryservicez.a	rticlouddiscoveryservicez.lib
	librtiroutingservicez.a	rtiroutingservicez.lib
	librtidlcz.a	rtidlcz.lib
	librticonnextmsgcz.a	rticonnextmsgcz.lib
	libnddsmetpz.a	nddsmetpz.lib
	librtiapputilscz.a	rtiapputilscz.lib
	librtixml2z.a	rtixml2z.lib
	libnddsc2z.a	nddsc2z.lib
	libnddscz.a	nddscz.lib
	libnddscorez.a	nddscorez.lib
Headers	rti/cds/CloudDiscoveryService.hpp

NOTE: If you are using debug libraries, remember to add the 'd' suffix to the library name. For shared libraries on macOS systems, the library name is the same as that for Linux except the extension is '.dylib' instead of '.so'.