dds_c_domain.h File Reference

DDS Domain Module definitions. More...

#include "dds_c/dds_c_dll.h"
#include "reda/reda_string.h"
#include "reda/reda_mempool.h"
#include "rt/rt_rt.h"
#include "dds_c/dds_c_infrastructure.h"
#include "dds_c_sequence.h"
#include "dds_c/dds_c_topic.h"
#include "dds_c/dds_c_publication.h"
#include "dds_c/dds_c_subscription.h"
#include "dds_c/dds_c_discovery.h"
#include "dds_c/dds_c_trust_plugin.h"
#include "dds_c/dds_c_flowcontroller.h"
#include <reda/reda_sequence_decl.h>

Data Structures
struct	NDDS_Discovery_Property
	Specifies internal information used to store discovery information about a DDS_DomainParticipant in the registry. More...
struct	DDS_DiscoveryComponent
	Specifies the discovery plugin the DDS_DomainParticipant should use. More...
struct	DDS_DiscoveryQosPolicy
	<<cert>> Specifies the attributes required to discover participants in the domain. More...
struct	DDS_UserTrafficQosPolicy
	A QosPolicy to configure properties of network traffic caused by the exchange of user data. More...
struct	DDS_DomainParticipantListener
	<<interface>> <<cert>> Listener for participant status. More...
struct	DDS_DomainParticipantQos
	<<cert>> QoS policies supported by a DDS_DomainParticipant entity. More...
struct	DDS_DomainParticipantFactoryQos
	<<cert>> QoS policies supported by a DDS_DomainParticipantFactory. More...

Macros
#define	DDS_DiscoveryComponent_INITIALIZER
	Initializer for new DDS_DiscoveryComponent instances.
#define	DDS_DomainParticipantListener_INITIALIZER
	<<cert>> Initializer for new DDS_DomainParticipantListener.
#define	DDS_DomainParticipantQos_INITIALIZER
	<<cert>> Initializer for new QoS instances.
#define	DDS_DomainParticipantFactoryQos_INITIALIZER
	<<cert>> Initializer for new QoS instances.
#define	DDS_TheParticipantFactory   DDS_DomainParticipantFactory_get_instance()
	Can be used as an alias for the singleton factory returned by the operation DDS_DomainParticipantFactory_get_instance().

Typedefs
typedef struct DDS_DomainParticipantFactoryImpl	DDS_DomainParticipantFactory
	<<singleton>> <<interface>> <<cert>> Allows creation and destruction of DDS_DomainParticipant objects.

Functions
DDS_ReturnCode_t	DDS_DomainParticipantQos_initialize (struct DDS_DomainParticipantQos *self)
	Initializer for new QoS instances.
DDS_ReturnCode_t	DDS_DomainParticipantQos_copy (struct DDS_DomainParticipantQos *self, const struct DDS_DomainParticipantQos *source)
	Copy the contents of the given QoS into this QoS.
DDS_ReturnCode_t	DDS_DomainParticipantQos_finalize (struct DDS_DomainParticipantQos *self)
	Free any dynamic memory allocated by the policies in this DDS_DomainParticipantQos.
DDS_Entity *	DDS_DomainParticipant_as_entity (DDS_DomainParticipant *domain)
	<<cert>> Access a DDS_DomainParticipant's supertype instance.
DDS_ReturnCode_t	DDS_DomainParticipant_get_default_publisher_qos (DDS_DomainParticipant *self, struct DDS_PublisherQos *qos)
	Copy the default DDS_PublisherQos values into the provided DDS_PublisherQos instance.
DDS_ReturnCode_t	DDS_DomainParticipant_set_default_publisher_qos (DDS_DomainParticipant *self, const struct DDS_PublisherQos *qos)
	Set the default DDS_PublisherQos values for this domain participant.
DDS_ReturnCode_t	DDS_DomainParticipant_get_default_subscriber_qos (DDS_DomainParticipant *self, struct DDS_SubscriberQos *qos)
	Copy the default DDS_SubscriberQos values into the provided DDS_SubscriberQos instance.
DDS_ReturnCode_t	DDS_DomainParticipant_set_default_subscriber_qos (DDS_DomainParticipant *self, const struct DDS_SubscriberQos *qos)
	Set the default DDS_SubscriberQos values for this domain participant.
DDS_ReturnCode_t	DDS_DomainParticipant_get_default_topic_qos (DDS_DomainParticipant *self, struct DDS_TopicQos *qos)
	Copies the default DDS_TopicQos values for this domain participant into the given DDS_TopicQos instance.
DDS_ReturnCode_t	DDS_DomainParticipant_set_default_topic_qos (DDS_DomainParticipant *self, const struct DDS_TopicQos *qos)
	Set the default DDS_TopicQos values for this domain participant.
DDS_Publisher *	DDS_DomainParticipant_create_publisher (DDS_DomainParticipant *self, const struct DDS_PublisherQos *qos, const struct DDS_PublisherListener *listener, DDS_StatusMask mask)
	<<cert>> Creates a DDS_Publisher with the desired QoS policies and attaches to it the specified DDS_PublisherListener.
DDS_ReturnCode_t	DDS_DomainParticipant_delete_publisher (DDS_DomainParticipant *self, DDS_Publisher *p)
	Deletes an existing DDS_Publisher.
DDS_Subscriber *	DDS_DomainParticipant_create_subscriber (DDS_DomainParticipant *self, const struct DDS_SubscriberQos *qos, const struct DDS_SubscriberListener *listener, DDS_StatusMask mask)
	<<cert>> Creates a DDS_Subscriber with the desired QoS policies and attaches to it the specified DDS_SubscriberListener.
DDS_ReturnCode_t	DDS_DomainParticipant_delete_subscriber (DDS_DomainParticipant *self, DDS_Subscriber *s)
	Deletes an existing DDS_Subscriber.
DDS_Topic *	DDS_DomainParticipant_create_topic (DDS_DomainParticipant *self, const char *topic_name, const char *type_name, const struct DDS_TopicQos *qos, const struct DDS_TopicListener *listener, DDS_StatusMask mask)
	<<cert>> Creates a DDS_Topic with the desired QoS policies
DDS_ReturnCode_t	DDS_DomainParticipant_delete_topic (DDS_DomainParticipant *self, DDS_Topic *topic)
	Deletes a DDS_Topic.
DDS_Topic *	DDS_DomainParticipant_find_topic (DDS_DomainParticipant *self, const char *topic_name, const struct DDS_Duration_t *timeout)
	Finds an existing (or ready to exist) DDS_Topic, based on its name.
DDS_TopicDescription *	DDS_DomainParticipant_lookup_topicdescription (DDS_DomainParticipant *self, const char *topic_name)
	<<cert>> Lookup an existing locally-created DDS_TopicDescription, based on its name.
DDS_Publisher *	DDS_DomainParticipant_lookup_publisher_by_name (DDS_DomainParticipant *self, const char *publisher_name)
	<<cert>> Retrieves a DDS_Publisher by its entity name within this DDS_DomainParticipant
DDS_Subscriber *	DDS_DomainParticipant_lookup_subscriber_by_name (DDS_DomainParticipant *self, const char *subscriber_name)
	<<cert>> Retrieves a DDS_Subscriber by its entity name within this DDS_DomainParticipant
DDS_DataWriter *	DDS_DomainParticipant_lookup_datawriter_by_name (DDS_DomainParticipant *self, const char *datawriter_full_name)
	<<cert>> Retrieves a DDS_DataWriter by its entity name within this DDS_DomainParticipant
DDS_DataReader *	DDS_DomainParticipant_lookup_datareader_by_name (DDS_DomainParticipant *self, const char *datareader_full_name)
	<<cert>> Retrieves a DDS_DataReader by its entity name within this DDS_DomainParticipant
DDS_ReturnCode_t	DDS_DomainParticipant_add_peer (DDS_DomainParticipant *self, const char *peer)
	<<eXtension>> <<cert>> Attempt to contact one or more additional peer participants.
DDS_DomainId_t	DDS_DomainParticipant_get_domain_id (DDS_DomainParticipant *self)
	<<cert>> Get the unique domain identifier.
DDS_ReturnCode_t	DDS_DomainParticipant_assert_liveliness (DDS_DomainParticipant *self)
	Manually asserts the liveliness of this DDS_DomainParticipant.
DDS_ReturnCode_t	DDS_DomainParticipant_delete_contained_entities (DDS_DomainParticipant *self)
	Delete all the entities that were created by means of the "create" operations on the DDS_DomainParticipant.
DDS_ReturnCode_t	DDS_DomainParticipant_get_current_time (DDS_DomainParticipant *self, struct DDS_Time_t *current_time)
	<<cert>> Returns the current value of the time.
DDS_ReturnCode_t	DDS_DomainParticipant_get_discovered_participants (DDS_DomainParticipant *self, struct DDS_InstanceHandleSeq *participant_handles)
	Returns a sequence containing DDS_InstanceHandle_t for all the remote DDS_DomainParticipant that have been discovered by the DDS_DomainParticipant.
DDS_ReturnCode_t	DDS_DomainParticipant_get_discovered_participant_data (DDS_DomainParticipant *self, struct DDS_ParticipantBuiltinTopicData *participant_data, const DDS_InstanceHandle_t *participant_handle)
	Returns information about a remote DDS_DomainParticipant that has been discovered by the DDS_DomainParticipant.
DDS_ReturnCode_t	DDS_DomainParticipant_set_qos (DDS_DomainParticipant *self, const struct DDS_DomainParticipantQos *qos)
	Change the QoS of this domain participant.
DDS_ReturnCode_t	DDS_DomainParticipant_get_qos (DDS_DomainParticipant *self, struct DDS_DomainParticipantQos *qos)
	Get the participant QoS.
DDS_ReturnCode_t	DDS_DomainParticipant_set_listener (DDS_DomainParticipant *self, const struct DDS_DomainParticipantListener *listener, DDS_StatusMask mask)
	Sets the participant listener.
struct DDS_DomainParticipantListener	DDS_DomainParticipant_get_listener (DDS_DomainParticipant *self)
	Get the participant listener.
DDS_ReturnCode_t	DDS_DomainParticipant_register_type (DDS_DomainParticipant *participant, const char *type_name, struct DDS_TypePluginI *plugin)
	<<eXtension>> <<cert>> Allows an application to communicate to RTI Connext DDS Micro the existence of a data type.
struct DDS_TypePluginI *	DDS_DomainParticipant_unregister_type (DDS_DomainParticipant *participant, const char *type_name)
	Allows an application to unregister a data type from RTI Connext DDS Micro. After calling unregister_type, no further communication using that type is possible.
DDS_DomainParticipantFactory *	DDS_DomainParticipantFactory_get_instance (void)
	<<cert>> Gets the singleton instance of this class.
DDS_ReturnCode_t	DDS_DomainParticipantFactory_finalize_instance (void)
	<<eXtension>> Destroys the singleton instance of this class.
DDS_ReturnCode_t	DDS_DomainParticipantFactory_set_default_participant_qos (DDS_DomainParticipantFactory *self, const struct DDS_DomainParticipantQos *qos)
	Sets the default DDS_DomainParticipantQos values for this domain participant factory.
DDS_ReturnCode_t	DDS_DomainParticipantFactory_get_default_participant_qos (DDS_DomainParticipantFactory *self, struct DDS_DomainParticipantQos *qos)
	Initializes the DDS_DomainParticipantQos instance with default values.
DDS_DomainParticipant *	DDS_DomainParticipantFactory_create_participant (DDS_DomainParticipantFactory *self, DDS_DomainId_t domainId, const struct DDS_DomainParticipantQos *qos, const struct DDS_DomainParticipantListener *listener, DDS_StatusMask mask)
	<<cert>> Creates a new DDS_DomainParticipant object.
DDS_ReturnCode_t	DDS_DomainParticipantFactory_delete_participant (DDS_DomainParticipantFactory *self, DDS_DomainParticipant *a_participant)
	Deletes an existing DDS_DomainParticipant.
DDS_DomainParticipant *	DDS_DomainParticipantFactory_lookup_participant (DDS_DomainParticipantFactory *self, DDS_DomainId_t domainId)
	<<cert>> Locates an existing DDS_DomainParticipant.
DDS_DomainParticipant *	DDS_DomainParticipantFactory_lookup_participant_by_name (DDS_DomainParticipantFactory *self, const char *participant_name)
	<<cert>> Retrieves a DDS_DomainParticipant by its entity name in the within the DDS_DomainParticipantFactory
DDS_ReturnCode_t	DDS_DomainParticipantFactory_get_qos (DDS_DomainParticipantFactory *self, struct DDS_DomainParticipantFactoryQos *qos)
	<<cert>> Gets the value for participant factory QoS.
DDS_ReturnCode_t	DDS_DomainParticipantFactory_set_qos (DDS_DomainParticipantFactory *self, const struct DDS_DomainParticipantFactoryQos *qos)
	<<cert>> Sets the value for a participant factory QoS.
RT_Registry_T *	DDS_DomainParticipantFactory_get_registry (DDS_DomainParticipantFactory *self)
	<<cert>> Retrieves the singleton registry instance associated with the factory.

Variables
const char *const	DDS_DISCOVERY_QOS_POLICY_NAME
	Stringified human-readable name for DDS_DiscoveryQosPolicy.
struct DDS_TopicQos	DDS_TOPIC_QOS_DEFAULT
	<<cert>> Special value for creating a DDS_Topic with default QoS. Note that this is the only supported parameter in RTI Connext DDS Micro when creating a topic.
struct DDS_PublisherQos	DDS_PUBLISHER_QOS_DEFAULT
	<<cert>> Special value for creating a DDS_Publisher with default QoS.
struct DDS_SubscriberQos	DDS_SUBSCRIBER_QOS_DEFAULT
	<<cert>> Special value for creating a DDS_Subscriber with default QoS.
struct DDS_DomainParticipantFactoryQos	DDS_PARTICIPANT_FACTORY_QOS_DEFAULT
	<<cert>> Special value for creating domain participant with default QoS.
struct DDS_DomainParticipantQos	DDS_PARTICIPANT_QOS_DEFAULT
	<<cert>> Special value for creating domain participant with default QoS.

---

Detailed Description

DDS Domain Module definitions.

---

Macro Definition Documentation

#define DDS_DiscoveryComponent_INITIALIZER

Value:

{\
  RT_ComponentFactoryId_INITIALIZER,\
  NDDS_Discovery_Property_INITIALIZER\
}

Initializer for new DDS_DiscoveryComponent instances.