RTI Connext Modern C++ API  Version 6.0.1
 All Classes Namespaces Functions Variables Typedefs Enumerations Enumerator Friends Groups Pages
rti::core::policy::SystemResourceLimits Class Reference

<<extension>> Configures resources that RTI Connext uses More...

#include <rti/core/policy/CorePolicy.hpp>

Public Member Functions

 SystemResourceLimits ()
 Creates a SystemResourceLimits qos policy with default values.
 
 SystemResourceLimits (int32_t the_max_objects_per_thread)
 Creates a SystemResourceLimits qos policy with the provided max_objects_per_thread.
 
SystemResourceLimitsmax_objects_per_thread (int32_t the_max_objects_per_thread)
 Sets the maximum number of objects that can be stored per thread.
 
int32_t max_objects_per_thread () const
 Getter (see setter with the same name)
 

Detailed Description

<<extension>> Configures resources that RTI Connext uses

Entity:
DomainParticipantFactory
Properties:
RxO = N/A
Changeable = NO

Usage

Within a single process (or address space for some supported real-time operating systems), applications may create and use multiple dds::domain::DomainParticipant entities. This QoS policy sets a parameter that places an effective upper bound on the maximum number of dds::domain::DomainParticipant entities that can be created in a single process/address space.

Constructor & Destructor Documentation

rti::core::policy::SystemResourceLimits::SystemResourceLimits ( )
inline

Creates a SystemResourceLimits qos policy with default values.

rti::core::policy::SystemResourceLimits::SystemResourceLimits ( int32_t  the_max_objects_per_thread)
inline

Creates a SystemResourceLimits qos policy with the provided max_objects_per_thread.

Member Function Documentation

SystemResourceLimits& rti::core::policy::SystemResourceLimits::max_objects_per_thread ( int32_t  the_max_objects_per_thread)

Sets the maximum number of objects that can be stored per thread.

Before increasing this value to allow you to create more participants, carefully consider the application design that requires you to create so many participants. Remember: a dds::domain::DomainParticipant is a heavy-weight object. It spawns several threads and maintains its own discovery database (see DISCOVERY). Creating more participants than RTI Connext strictly requires – one per domain per process/address space – can adversely affect the performance and resource utilization of your application.

[default] 1024; this value allows you to create about 10 or 11 dds::domain::DomainParticipant entities.

[range] [1, 1 billion]

int32_t rti::core::policy::SystemResourceLimits::max_objects_per_thread ( ) const

Getter (see setter with the same name)


RTI Connext Modern C++ API Version 6.0.1 Copyright © Sat Nov 23 2019 Real-Time Innovations, Inc