DDS_LoggingQosPolicy Struct Reference

Configures the RTI Connext logging facility. More...

Data Fields
NDDS_Config_LogVerbosity	verbosity
	The verbosities at which RTI Connext diagnostic information is logged.
NDDS_Config_LogCategory	category
	Categories of logged messages.
NDDS_Config_LogPrintFormat	print_format
	The format used to output RTI Connext diagnostic information.
char *	output_file
	Specifies the file to which log messages will be redirected to.
char *	output_file_suffix
	Sets the file suffix when logging to a set of files.
DDS_Long	max_bytes_per_file
	Specifies the maximum number of bytes a single file can contain.
DDS_Long	max_files
	Specifies the maximum number of files to create before overwritting the previous ones.

Detailed Description

Configures the RTI Connext logging facility.

All the properties associated with RTI Connext logging can be configured using this QoS policy. This allows you to configure logging using XML QoS Profiles. See the Troubleshooting chapter in the User's Manual for details.

Entity:

DDS_DomainParticipantFactory

Properties:

RxO = NO
Changeable = Changeable

Field Documentation

NDDS_Config_LogVerbosity DDS_LoggingQosPolicy::verbosity

The verbosities at which RTI Connext diagnostic information is logged.

[default] NDDS_CONFIG_LOG_VERBOSITY_ERROR

NDDS_Config_LogCategory DDS_LoggingQosPolicy::category

Categories of logged messages.

[default] Logging will be enabled for all the categories.

NDDS_Config_LogPrintFormat DDS_LoggingQosPolicy::print_format

The format used to output RTI Connext diagnostic information.

[default] NDDS_CONFIG_LOG_PRINT_FORMAT_DEFAULT.

char* DDS_LoggingQosPolicy::output_file

Specifies the file to which log messages will be redirected to.

If the value of ouput_file is set to NULL, log messages will sent to standard output.

If DDS_LoggingQosPolicy::max_bytes_per_file is not DDS_LENGTH_UNLIMITED, this is used as the file name preffix for a set of numbered files.

Important: This value must be an allocated string with DDS_String_alloc or DDS_String_dup. It should not be assigned to a string constant.

[default] NULL

See Also

NDDS_Config_Logger_set_output_file_name

NDDS_Config_Logger_set_output_file_set

char* DDS_LoggingQosPolicy::output_file_suffix

Sets the file suffix when logging to a set of files.

Note

This field only applies when idref_LoggingQosPolicy_max_bytes_per_file is different than DDS_LENGTH_UNLIMITED.

It specifies the suffix to use for the set of files used to redirect the logging output. The preffix is DDS_LoggingQosPolicy::output_file.

Important: This value must be an allocated string with DDS_String_alloc or DDS_String_dup. It should not be assigned to a string constant.

[default] NULL

[default] No suffix

See Also

NDDS_Config_Logger_set_output_file_set

DDS_Long DDS_LoggingQosPolicy::max_bytes_per_file

Specifies the maximum number of bytes a single file can contain.

When this field is different than DDS_LENGTH_UNLIMITED, it enables logging to separate files as they reach this size.

[default] DDS_LENGTH_UNLIMITED (a single file is used)

See Also

NDDS_Config_Logger_set_output_file_set

DDS_Long DDS_LoggingQosPolicy::max_files

Specifies the maximum number of files to create before overwritting the previous ones.

Note

This field only applies when idref_LoggingQosPolicy_max_bytes_per_file is differenet than DDS_LENGTH_UNLIMITED.

When this field is different than DDS_LENGTH_UNLIMITED, and the number of files reaches this number, future logging messages overwrite the previously created files.

[default] DDS_LENGTH_UNLIMITED (files aren't overwritten)

See Also

NDDS_Config_Logger_set_output_file_set